Bug ID 719499: BIG-IQ upgrade to 5.4 or later fails with "Error: [SNAPU] Sanity check failed"

Last Modified: Sep 13, 2023

Affected Product(s):
BIG-IQ Config Mgmt Infrastructure(all modules)

Known Affected Versions:
5.4.0

Fixed In:
6.0.1

Opened: May 10, 2018

Severity: 3-Major

Symptoms

BIG-IQ upgrade from a version before 5.4 fails with the following error: Error: [SNAPU] Sanity check failed. See logs for more The upgrade log includes a large number of warnings that objects are found in old snapshots but not in the converted global snapshots.

Impact

Upgrade fails.

Conditions

BIG-IQ has failed snapshots that contain incomplete references of the objects in the snapshot.

Workaround

1) To work around this issue, reboot to the previous BIG-IQ version. 2) Delete all failed snapshots from all modules before upgrading again: Deployment :: <Module Name> :: Snapshots 3) Delete all orphaned snapshots that don't have the snapshot tasks that created them. This step has to be done through APIs. 4) Perform the upgrade again.

Fix Information

BIG-IQ upgrade script now deletes the failed and orphaned snapshots before it converts the old snapshots to global snapshots.

Behavior Change

Guides & references

K10134038: F5 Bug Tracker Filter Names and Tips