Troubleshooting: Resolve VxRail Upgrade Failure when upgrading from VCF on VxRail 5.X to 5.Y
Article ID: 323978
Updated On:
Products
Issue/Introduction
This article exists to guide users through the manual steps required for upgrading from VCF on VxRail 5.0.x to 5.1.x/5.2.x (or 5.1.x to 5.2.x) Users are advised to follow the steps outlined in this KB article before initiating the upgrade process to ensure a smooth transition from VCF on VxRail 5.0.x to 5.1.x/5.2.x (or 5.1.x to 5.2.x), and to avoid encountering the described error. Since the necessary steps are not available via the User Interface (UI) or API, this document serves as an essential resource to external users for minimizing downtime, avoiding potential conflicts, and ensuring that the upgrade is successful.
Symptoms:
VCF on VxRail Manager upgrade from 8.0.1xx to 8.0.2xx/8.0.3xx (or 8.0.2xx to 8.0.3xx) fails with the following error message on the task panel: Note: Log excerpts are examples of 8.0.100 to 8.0.200, bundle id may change for different target versions, proceed with caution:
”Skipped VxRail cluster upgrade required patch binary:D1JM1_VxRail-8.0.200- Composite-Upgrade-Slim-Package-for-8.0.x.zip is not available. File /nfs/vmware/vcf/nfs-mount/bundle/D1JM1_VxRail-8.0.200-Composite-Upgrade-Slim Package-for-8.0.x.zip does not exist.”
The remediation message provided for this error recommends users to follow this KB to successfully upgrade their VxRail Manager Cluster from 8.0.100 to 8.0.2xx.
Environment
VMware Cloud Foundation 5.1
VMware Cloud Foundation 5.1.1
VMware Cloud Foundation 5.2
VMware Cloud Foundation 5.2.1
Cause
The reason this issue occurred is that the VxRail 8.0.100 to 8.0.2xx or 8.0.3xx upgrade requires an upgrade bundle that is not supported by VCF 5.1.x/VCF 5.2.x. The script and manual steps are intended to bridge this compatibility gap.
Resolution
Currently there is no resolution to the issue.
Workaround:
While the full automation of the upgrade process is being developed, the issue can be resolved by manually downloading the required bundle and checksum and executing the provided scripts to copy the artifacts onto the SDDC Manager. After that, on the SDDC Manager, modify the bundle and checksum permissions/owners by executing the script with another option.
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 on top of an already downloaded VxRail bundle; it is not a standalone patch.
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
3. Download the corresponding checksum attached to this KB.
4. Download the script "fix_vxrail_bundle.py" attached to this KB and upload to the /home/vcf/ directory on the SDDC Manager Appliance.
5. Copy the VxRail bundle and checksum file to the the SDDC Manager Appliance.
6. Run the fix_vxrail_bundle.py script. python fix_vxrail_bundle.py
[ /home/vcf ]# python fix_vxrail_bundle.pySelect the expected file name:1. D1JM1_VxRail-8.0.200-Composite-Upgrade-Slim-Package-for-8.0.x.zip2. HJ6NG_VxRail-8.0.210-Composite-Upgrade-Slim-Package-for-8.0.x.zip3. VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zipEnter the number of the file name you want to use: 3Enter the full path of the VxRail bundle file: /home/vcf/VXRAIL_COMPOSITE-SLIM-8.0.300-28709350_for_8.0.x.zipEnter the full path of the checksum file: /home/vcf/VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip.checksumCopying /home/vcf/VXRAIL_COMPOSITE-SLIM-8.0.300-28709350_for_8.0.x.zip to /nfs/vmware/vcf/nfs-mount/bundle/VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip...File successfully copied to /nfs/vmware/vcf/nfs-mount/bundle/VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zipCopying /home/vcf/VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip.checksum to /nfs/vmware/vcf/nfs-mount/bundle/VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip.checksum...Checksum file successfully copied to /nfs/vmware/vcf/nfs-mount/bundle/VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip.checksumSetting permissions for /nfs/vmware/vcf/nfs-mount/bundle/VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip to 755...Successfully set permissions for /nfs/vmware/vcf/nfs-mount/bundle/VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip to 755Setting ownership for /nfs/vmware/vcf/nfs-mount/bundle/VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip to vcf_lcm:vcf...Successfully set ownership for /nfs/vmware/vcf/nfs-mount/bundle/VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip to vcf_lcm:vcfSetting permissions for /nfs/vmware/vcf/nfs-mount/bundle/VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip.checksum to 755...Successfully set permissions for /nfs/vmware/vcf/nfs-mount/bundle/VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip.checksum to 755Setting ownership for /nfs/vmware/vcf/nfs-mount/bundle/VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip.checksum to vcf_lcm:vcf...Successfully set ownership for /nfs/vmware/vcf/nfs-mount/bundle/VPTWN_VxRail-8.0.300-Composite-Upgrade-Slim-Package-for-8.0.x.zip.checksum to vcf_lcm:vcf7. Log into the SDDC Manager UI to trigger the 5.1.x/5.2.x 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.1, VCF 5.1.1 and VCF 5.2
| 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 |
Attachments
Feedback
