Bug ID 1273445: Downgrade/upgrade issues are seen because ISO has special characters in the file name

Last Modified: Dec 07, 2023

Affected Product(s):
F5OS Install/Upgrade(all modules)

Fixed In:
F5OS-A 1.5.0

Opened: Mar 20, 2023

Severity: 1-Blocking


If a F5OS-A ISO with a filename containing 'special characters' ('+ , * , ? , ^ , $ , ( , ) , [ , ] , { , } , | , \') is imported onto the device, and the system is downgraded/upgraded with this ISO, it can result in the upgrade/downgrade failing.


Upgrade/downgrade will fail, requiring manual intervention to recover the system.


1. Download and import an ISO with a 'special character' in its name (for example,F5OS-A-1.5.0-*.iso. 2. Attempt an upgrade /downgrade. 3. Upgrade/downgrade will fail.


1. Before performing a platform software upgrade, compare versions referenced by the "show system image" ConfD CLI command with the names of files present in the "/var/import/staging” directory. If the ISO is not present in /var/import/staging but it is shown in "show system image" command output, then import again to "/var/import/staging”. 2. If there is any ISO file with a name containing a special character present in "/var/import/staging”, remove that version of platform software and re-import it by re-downloading the file with a name that does not include special characters. You may then attempt upgrade. 3. In order to remove that ISO file with a name containing a special characters use the below command. appliance-1(config)# system image remove iso <iso version> 4. In scenarios where the above command fails or where it is not possible to use above command, please follow the below procedure to delete the image. * login to the device using root * chattr -i "/var/import/staging/<iso with special characters>” * rm -rf "/var/import/staging/<iso with special characters>” In case downgrade or upgrade failure has already occurred due to this issue, follow these steps to recover the system: 1. Download another copy of the ISO with a proper name to /var/import/staging. 2. Wait for five minutes for it to import. If ConfD is unavailable, you can check the logs in /var/log/sw-mgmt.debug for import status. 3. Once the import is complete, reboot the system. This should recover the system.

Fix Information

The fix is to delete the ISO with the special characters when it is being imported.

Behavior Change

Guides & references

K10134038: F5 Bug Tracker Filter Names and Tips