Bug ID 701703: BIG-IQ upgrade from 5.3.0 to 5.4.0 may fail when Access groups are configured

Last Modified: Nov 20, 2025

Affected Product(s):
BIG-IQ Platform(all modules)

Known Affected Versions:
5.4.0

Fixed In:
5.4.0 HF1

Opened: Jan 12, 2018

Severity: 3-Major

Related Article: K14550300

Symptoms

Upgrade fails and tokuupgrade.log contains the following messages: Error: [SNAPU] Found invalid generation undefined when making generation link for https://localhost/mgmt/cm/access/working-config ... at throwSnapuError (./020-platform-snapshots.js:1215:15) at makeGenLink (./020-platform-snapshots.js:1114:13) at sanityCheckLiveDocuments (./020-platform-snapshots.js:1489:68) at runSanityChecks (./020-platform-snapshots.js:1267:18) at ScriptEntry.upgrade [as upgradeFunc] (./020-platform-snapshots.js:158:5) at upgradeToVersionDir (/var/config/rest/tokuupgrade/src/upgradeversions.js:252:21) at upgradeToVersion (/var/config/rest/tokuupgrade/src/upgradeversions.js:155:5) at /var/config/rest/tokuupgrade/src/tokuupgrade.js:113:13 Note: Error messages may vary but can generally be identified by the upgrade script 020-platform-snapshots.js and a link starting with https://localhost/mgmt/cm/access.

Impact

Upgrade from 5.3.0 to 5.4.0 will fail.

Conditions

-- BIG-IQ manages multiple Access Policy Manager (APM) devices. -- BIG-IQ is configured to use Access Groups. -- An APM device is removed from one device group and added to another device group. -- An Access Group snapshot was created while the APM device belonged to the initial device group. -- BIG-IQ is upgraded before a new / updated Access Group snapshot is created.

Workaround

1) To work around this issue, reboot to the previous BIG-IQ version. 2) Delete all Access snapshots before upgrading again: Deployment :: Access :: Snapshots 3) Perform the upgrade again. For more information, see K14550300: BIG-IQ system upgrades from 5.3.0 to 5.4.0 may fail when Access Groups are configured https://support.f5.com/csp/article/K14550300.

Fix Information

BIG-IQ now correctly transforms Access snapshots during the storage upgrade step of the BIG-IQ version 5.4.0 upgrade procedure.

Behavior Change

Guides & references

K10134038: F5 Bug Tracker Filter Names and Tips