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

Last Modified: Nov 22, 2021

Bug Tracker

Affected Product:  See more info
BIG-IQ Config Mgmt Infrastructure(all modules)

Known Affected Versions:
5.4.0, 5.4.0 HF1, 5.4.0 HF2

Fixed In:

Opened: May 10, 2018
Severity: 3-Major


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.


Upgrade fails.


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


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