Bug ID 716473: Unable to upgrade APM Desktop Clients on BIG-IP Virtual Edition

Last Modified: Jul 12, 2023

Affected Product(s):
BIG-IP APM(all modules)

Known Affected Versions:
13.1.0, 13.1.0.1, 13.1.0.2, 13.1.0.3, 13.1.0.4, 13.1.0.5, 13.1.0.6, 13.1.0.7, 13.1.0.8, 13.1.1, 13.1.1.2, 13.1.1.3, 13.1.1.4, 13.1.1.5, 13.1.3, 13.1.3.1, 13.1.3.2, 13.1.3.3, 13.1.3.4, 13.1.3.5, 13.1.3.6, 13.1.4, 13.1.4.1, 13.1.5, 13.1.5.1

Fixed In:
14.1.0

Opened: Apr 23, 2018

Severity: 3-Major

Symptoms

Upgrading the APM client images (a.k.a. Desktop Client) may fail on some BIG-IP Virtual Edition (VE) systems running v13.1.0 software versions, as a result of insufficient space in /var.

Impact

Cannot upgrade Desktop Client 7.1.6.1. When this occurs: -- In the GUI, the system posts the following error message: Image File Error: call tmsh to install image failed. -- In tmsh, the system posts the following error message: Data Input Error: File operation failed on "/var/apm/images/apmclients-7160.2018.417.2013-4204.0.iso".

Conditions

/var does not have sufficient free disk space for the APM client image ISO file (slightly less than ~300 MB). Reasons for a lack of space might include: -- UCS archives and SCF files, which default to being stored in /var. -- Other modules that store data in /var, e.g. APM, ASM, or AFM.

Workaround

Before installing, increase the size of /var. For example, from the command line of a BIG-IP system, /var can be expanded by 1 GB by running the following and then rebooting the system for the changes to take effect: NEW_SIZE=$(($(df -P /var | tail -1 | awk '{print $2}') + 1*1024*1024)); echo "Resizing /var to $NEW_SIZE (unit: 1K blocks); changes should take effect after a reboot"; tmsh modify sys disk directory /var new-size $NEW_SIZE; tmsh save sys config Note: This workaround only applies to a single device, and will not persist across upgrades. For more information about apmclients-7160.2018.417.2013-4204.0.iso, see Release Notes: APM Desktop Client 7.1.6.1 https://support.f5.com/kb/en-us/products/BIG-IP_apm/releasenotes/related/relnote-desktop-client-7-1-6-1.html. For information about installing BIG-IP Edge Client, see K52547540: Updating BIG-IP Edge Client for the BIG-IP APM system :: https://support.f5.com/csp/article/K52547540.

Fix Information

Can now upgrade APM Desktop Clients on BIG-IP Virtual Edition.

Behavior Change

Guides & references

K10134038: F5 Bug Tracker Filter Names and Tips