Bug ID 1711105: The presence of a /var/docker/config/platform.override.yml file causes the upgrade to hang/fail from versions earlier than F5OS 1.8.0

Last Modified: Jun 23, 2025

Affected Product(s):
F5OS F5OS-A, F5OS-C, Install/Upgrade, Velos(all modules)

Known Affected Versions:
F5OS-C 1.8.0, F5OS-C 1.8.1

Opened: Oct 30, 2024

Severity: 3-Major

Symptoms

If a platform.override.yml file exists from a version of F5OS prior to 1.8.0, platform-services will fail to start when the new software version boots. This file is not part of the software distribution, and will only exist if an administrator created it after installation.

Impact

Platform-services fails to start after reboot.

Conditions

Platform.override.yml exists with a version that is not '2.2'.

Workaround

Prior to attempting to install F5OS 1.8.0 or later on an older version, make sure that there is no /var/docker/config/platform.override.yml file on either controller, any blade or the appliance filesystem. If the issue is encountered and platform-services does not start, remove the platform.override.yml and issue the command: systemctl restart platform-services-deployment.service

Fix Information

None

Behavior Change

Guides & references

K10134038: F5 Bug Tracker Filter Names and Tips