VxRail 8.0.x to 8.0.y: Skipped VxRail cluster upgrade required patch binary: #####_VxRail-#.#.####- Composite-Upgrade-Slim-Package-for-8.0.x.zip is not available
Article ID: 323978
Updated On:
Products
Issue/Introduction
VCF on VxRail Manager upgrade from 8.0.x to 8.0.y fails with the following error message in the task panel:
”Skipped VxRail cluster upgrade required patch binary: #####_VxRail-#.#.####- Composite-Upgrade-Slim-Package-for-8.0.x.zip is not available. File /nfs/vmware/vcf/nfs-mount/bundle/#####_VxRail-#.#.####- Composite-Upgrade-Slim-Package-for-8.0.x.zip does not exist.”
Environment
VMware Cloud Foundation 5.x.x
Cause
VCF on VxRail 5.x BOM releases are bundled with VxRail upgrade bundles that support upgrades from VCF 4.x (VxRail 7.0.x) to 5.x (VxRail 8.0.x). Because of this limitation, customers already on VxRail 8.0.x who need to upgrade to any of the following versions, 8.0.200, 8.0.210, 8.0.300, 8.0.310, or 8.0.361, they must use a different upgrade procedure. The steps below outline the required process to enable the VxRail upgrade for these scenarios.
Resolution
Workaround:
1. Ensure the default target VxRail bundle for VCF 5.1.x/5.2.x BoM is already downloaded or uploaded to the SDDC Manager. This fix must be applied in addition to downloading the target VxRail bundle from the SDDC Depot.
2. Download the new upgrade bundle manually onto a machine with internet access from the Dell website
VCF 5.1 VxRail-8.0.200-Composite-Upgrade-Slim-Package-for-8.0.x.zip
VCF 5.1.1 VxRail-8.0.210-Composite-Upgrade-Slim-Package-for-8.0.x.zip
VCF 5.2 VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip
VCF 5.2.1 VxRail-8.0.310-Composite-Upgrade-Slim-Package-for-8.0.x.zip
VCF 5.2.2 VxRail-8.0.361-Composite-Upgrade-Slim-Package-for-8.0.x.zip
3. Download the script "fix_vxrail_bundle_####.py" attached to this KB and upload to the /home/vcf/ directory on the SDDC Manager Appliance.
4. Copy the VxRail bundle to the SDDC Manager Appliance.
5. Run the fix_vxrail_bundle_####.py script as root.
Example:
python fix_vxrail_bundle_####.py
Select the downloaded upgrade bundle file name:
1. VXRAIL_COMPOSITE-SLIM-8.0.200-28314729_for_8.0.x.zip
2. VXRAIL_COMPOSITE-SLIM-8.0.210-28476225_for_8.0.x.zip
3. VXRAIL_COMPOSITE-SLIM-8.0.300-28709350_for_8.0.x.zip
4. VXRAIL_COMPOSITE-SLIM-8.0.310-28809519_for_8.0.x.zip
5. VXRAIL_COMPOSITE-SLIM-8.0.361-29253789_for_8.0.x.zip
Enter the number of the file name you want to use: 5
Enter the full path of the manually downloaded VxRail bundle file:
Example: /home/vcf/VXRAIL_COMPOSITE-SLIM-8.0.361-29253789_for_8.0.x.zip
> /home/vcf/VXRAIL_COMPOSITE-SLIM-8.0.361-29253789_for_8.0.x.zip
Creating bundle checksum file:
-----------------------------------
Checksum file created at /nfs/vmware/vcf/nfs-mount/bundle/29GJN_VxRail-8.0.361-Composite-Upgrade-Slim-Package-for-8.0.x.zip.checksum
Renaming and moving bundle:
-----------------------------------
Moving and renaming /home/vcf/VXRAIL_COMPOSITE-SLIM-8.0.361-29253789_for_8.0.x.zip to /nfs/vmware/vcf/nfs-mount/bundle/29GJN_VxRail-8.0.361-Composite-Upgrade-Slim-Package-for-8.0.x.zip...
Successfully moved and renamed file to /nfs/vmware/vcf/nfs-mount/bundle/29GJN_VxRail-8.0.361-Composite-Upgrade-Slim-Package-for-8.0.x.zip
Setting Bundle and Checksum Permissions:
-----------------------------------
Setting permissions for /nfs/vmware/vcf/nfs-mount/bundle/29GJN_VxRail-8.0.361-Composite-Upgrade-Slim-Package-for-8.0.x.zip to 755...
Successfully set permissions for /nfs/vmware/vcf/nfs-mount/bundle/29GJN_VxRail-8.0.361-Composite-Upgrade-Slim-Package-for-8.0.x.zip to 755
Setting ownership for /nfs/vmware/vcf/nfs-mount/bundle/29GJN_VxRail-8.0.361-Composite-Upgrade-Slim-Package-for-8.0.x.zip to vcf_lcm:vcf...
Successfully set ownership for /nfs/vmware/vcf/nfs-mount/bundle/29GJN_VxRail-8.0.361-Composite-Upgrade-Slim-Package-for-8.0.x.zip to vcf_lcm:vcf
Setting Bundle and Checksum Permissions:
-----------------------------------
Setting permissions for /nfs/vmware/vcf/nfs-mount/bundle/29GJN_VxRail-8.0.361-Composite-Upgrade-Slim-Package-for-8.0.x.zip.checksum to 755...
Successfully set permissions for /nfs/vmware/vcf/nfs-mount/bundle/29GJN_VxRail-8.0.361-Composite-Upgrade-Slim-Package-for-8.0.x.zip.checksum to 755
Setting ownership for /nfs/vmware/vcf/nfs-mount/bundle/29GJN_VxRail-8.0.361-Composite-Upgrade-Slim-Package-for-8.0.x.zip.checksum to vcf_lcm:vcf...
Successfully set ownership for /nfs/vmware/vcf/nfs-mount/bundle/29GJN_VxRail-8.0.361-Composite-Upgrade-Slim-Package-for-8.0.x.zip.checksum to vcf_lcm:vcf
6. Log into the SDDC Manager UI to trigger the VxRail Manager upgrade.
Note: For VCF 5.1.1 vLCM based cluster upgrade will show precheck failure for this specific VxRail bundle. This can be safely ignored and upgrade can be continued.
Additional Information
Expected File Name : Use the following value as per the table for VCF 5.x.x
| Target VCF release |
Expected File Name (--expected-file-name) |
| VCF 5.1 | D1JM1_VxRail-8.0.200-Composite-Upgrade-Slim-Package-for-8.0.x.zip |
| VCF 5.1.1 | HJ6NG_VxRail-8.0.210-Composite-Upgrade-Slim-Package-for-8.0.x.zip |
| VCF 5.2 | VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip |
| VCF 5.2.1 | R1F8P_VxRail-8.0.310-Composite-Upgrade-Slim-Package-for-8.0.x.zip |
| VCF 5.2.2 | 29GJN_VxRail-8.0.361-Composite-Upgrade-Slim-Package-for-8.0.x.zip |
Attachments
Feedback
