Troubleshooting an Unable to Unpack Upgrade File Error (KBA10782)
KBA
KBA#Applicable Delphix Versions
- Click here to view the versions of the Delphix engine to which this article applies
-
Date Release Jan 25, 2024 19.0.0.0 Dec 20, 2023 | Jan 10, 2024 18.0.0.0 | 18.0.0.1 Nov 21, 2023 17.0.0.0 Oct 18,2023 16.0.0.0 Sep 21, 2023 15.0.0.0 Aug 24, 2023 14.0.0.0 Jul 24, 2023 13.0.0.0 Jun 21, 2023 12.0.0.0 May 25, 2023 11.0.0.0 Apr 13, 2023 10.0.0.0 Mar 13, 2023 | Mar 20, 2023 9.0.0.0 | 9.0.0.1 Feb 13, 2023 8.0.0.0 Jan 12, 2023 7.0.0.0 Releases Prior to 2023 Major Release All Sub Releases 6.0 6.0.0.0, 6.0.1.0, 6.0.1.1, 6.0.2.0, 6.0.2.1, 6.0.3.0, 6.0.3.1, 6.0.4.0, 6.0.4.1, 6.0.4.2, 6.0.5.0, 6.0.6.0, 6.0.6.1, 6.0.7.0, 6.0.8.0, 6.0.8.1, 6.0.9.0, 6.0.10.0, 6.0.10.1, 6.0.11.0, 6.0.12.0, 6.0.12.1, 6.0.13.0, 6.0.13.1, 6.0.14.0, 6.0.15.0, 6.0.16.0, 6.0.17.0, 6.0.17.1, 6.0.17.2 5.3
5.3.0.0, 5.3.0.1, 5.3.0.2, 5.3.0.3, 5.3.1.0, 5.3.1.1, 5.3.1.2, 5.3.2.0, 5.3.3.0, 5.3.3.1, 5.3.4.0, 5.3.5.0, 5.3.6.0, 5.3.7.0, 5.3.7.1, 5.3.8.0, 5.3.8.1, 5.3.9.0 5.2
5.2.2.0, 5.2.2.1, 5.2.3.0, 5.2.4.0, 5.2.5.0, 5.2.5.1, 5.2.6.0, 5.2.6.1
5.1
5.1.0.0, 5.1.1.0, 5.1.2.0, 5.1.3.0, 5.1.4.0, 5.1.5.0, 5.1.5.1, 5.1.6.0, 5.1.7.0, 5.1.8.0, 5.1.8.1, 5.1.9.0, 5.1.10.0
5.0
5.0.1.0, 5.0.1.1, 5.0.2.0, 5.0.2.1, 5.0.2.2, 5.0.2.3, 5.0.3.0, 5.0.3.1, 5.0.4.0, 5.0.4.1, 5.0.5.0, 5.0.5.1, 5.0.5.2, 5.0.5.3, 5.0.5.4
Troubleshooting an Unable to Unpack Upgrade File Error
When uploading an upgrade image to a Delphix Engine, you may face an Unable to unpack upgrade file error in the actions list
If you click on the Details link, you will see the following the Command Output section:
Unable to read version info from image. Failed to extract upgrade image. Check if the Delphix Engine root pool is out of space.
This article provides some steps to troubleshoot this error.
To resolve an Unable to Unpack Upgrade File Error
The Unable to unpack upgrade file error may be triggered by a number of conditions. Below is a non-exhaustive list with steps to remediate.
Incorrect Upgrade Image
Confirm that the file is a standard upgrade file, this will usually end with the string _Standard_Upgrade.tar
If any other file is uploaded (for example a .ova installation image), you will likely receive this error.
Previously Uploaded Upgrade Images
Check whether any other upgrade images are already uploaded to the engine, but not installed (previously installed images do not use up capacity).
If another image is already uploaded and unpacked, this may not leave enough room to upload and unpack the latest upgrade image.
Resolution
Remove any other uploaded upgrade images.
Incorrect Upgrade Version
Confirm that the upgrade version you are attempting to upload is compatible with the currently running version.
Generally speaking you can upgrade directly to any version released within 12 months of the currently running version.
Confirm whether the version you are attempting to upgrade to is compatible, you can do so via the Upgrade Matrix in the Delphix Documentation.
Resolution
Remove the incompatible version and upload the correct version.
Internal Storage Pool Out of Space
The available capacity of the internal storage pool (rpool) may be nearly exhausted, possibly due to crash dumps/cores created by the Delphix Engine.
A Delphix Support Engineer will need to review data from the engine to diagnose/troubleshoot this.
Resolution
Raise a case with Delphix Support and upload a support bundle from the engine (see Creating and Uploading a Support Bundle to Delphix (KBA1459)).