VxRail upgrade bundle 7.0.400 will not show up as available for upgrade

Products

• VMware Cloud Foundation

Issue/Introduction

If the user tries to upgrade VxRail 7.0.400 from VxRail 7.0.372, VxRail 7.0.400 will not be available for upgrade due to an issue with partnerBundleMetadata.json.
This workaround will help users to unblock and make the bundle available.

Symptoms:
VxRail upgrade bundle 7.0.400 will not show up as available for upgrade to the VCF Customers on VxRail 7.0.372

Environment

VMware Cloud Foundation 4.4.0
VMware Cloud Foundation 4.4.x
VMware Cloud Foundation 4.4.1

Cause

partnerBundleMetadata.json pushed in the prod location, It doesn't have the required version 7.0.372 to enable the bundle for upgrade.

Resolution

PartnerBundleMetadata.json is updated with 7.0.372 to the prod location already.

Workaround:

Even though the fix is already pushed, This is the workaround for users who downloaded & updated the PartnerBundleMetadata.json in the SDDC inventory.

Online Customers:

1. Login SDDC manager UI. Navigate to Repository settings, disconnect VMware depot and Dell EMC Depot.
 

2. Connect to SDDC Manager via SSH. Execute the below command to cleanup the 7.0.400 bundle and metadata.

/usr/bin/python /opt/vmware/vcf/lcm/lcm-app/bin/bundle_cleanup.py VXRAIL7-0-400-27701512DLD3273_VxRail-7-0-400-Composite-Upgrade-Slim-Package-for-7-0-x-zip

   Note: Above command will cleanup VxRail 7.0.400 bundle from the inventory if downloaded already. The bundle can be redownloaded once cleanup is done.

3. Login SDDC manager UI. Navigate to Repository settings, re-connect VMware depot and Dell EMC Depot.
 

4. VxRail 7.0.400 Bundle should now be available for upgrade.

Offline Customers:

1. Connect to SDDC Manager via SSH. Execute the below command to cleanup the 7.0.400 bundle and metadata

/usr/bin/python /opt/vmware/vcf/lcm/lcm-app/bin/bundle_cleanup.py VXRAIL7-0-400-27701512DLD3273_VxRail-7-0-400-Composite-Upgrade-Slim-Package-for-7-0-x-zip

    Note: Above command will cleanup VxRail 7.0.400 bundle from the inventory if downloaded already.

2. Download and setup OBTU tool.

a. Connect to myvmware
https://customerconnect.vmware.com/downloads/details?downloadGroup=VCF4XSUPP_TOOLS&productId=1252  
and download the lcm-tools-prod.tar.gz tool to the computer with internet access.
b. Create directory lcm-tools-prod.
c. Extract content of lcm-tools-prod.tar.gz in to lcm-tools-prod directory.
d. Navigate to the lcm-tools-prod directory and ensure to have execute permission for sub-directory.                    

3. Navigate to bin directory and execute the below command to download the
    latest PartnerBundleMetadata.json with 7.0.400 bundle.

   Windows: .\lcm-bundle-transfer-util.bat -download downloadPartnerBundle -outputDirectory DOWNLOAD_DIRECTORY -depotUser DEPOT_USER --partnerDepotUser VXRAIL_DEPOT_USER -b 7.0.400-27701512

    Linux: ./lcm-bundle-transfer-util -download downloadPartnerBundle -outputDirectory DOWNLOAD_DIRECTORY -depotUser DEPOT_USER --partnerDepotUser VXRAIL_DEPOT_USER -b 7.0.400-27701512

4. Copy the tool and artifacts to SDDC manager using scp/winscp

a. Create directory and update permissions on the SDDC Manager appliance

• SSH in to the SDDC Manager appliance using the vcf user account.
• Enter su to switch to the root user.
• Create the lcm-tools directory.
• mkdir /opt/vmware/vcf/lcm/lcm-tools                                           
• chown vcf:vcf -R /opt/vmware/vcf/lcm/lcm-tools
• Copy the bundle transfer utility folder lcm-tools-prod to /opt/vmware/vcf/lcm/lcm-tools directory.

b. Copy the DOWNLOAD_DIRECTORY to the /nfs/vmware/vcf/nfs-mount/ location on the SDDC Manager appliance.     

Note: Update the permission for /nfs/vmware/vcf/nfs-mount/bundle/depot/local/
 chown vcf:vcf -R /nfs/vmware/vcf/nfs-mount/bundle/depot/local/

c. Copy the partnerBundleMetadata.json to the /nfs/vmware/vcf/nfs-mount/bundle/depot/local location on the SDDC Manager appliance.

d. Copy softwareCompatibilitySets.json to the /nfs/vmware/vcf/nfs-mount/bundle/depot/local location on the SDDC Manager appliance.
 

e. Copy the partner bundle to the /nfs/vmware/vcf/nfs-mount/bundle/depot/local/bundles directory on the SDDC Manager appliance.

5. Update Permissions for the tool and artifacts.

  chown -R vcf_lcm:vcf /opt/vmware/vcf/lcm/lcm-tools/lcm-tools-prod
  chmod -R 777 /opt/vmware/vcf/lcm/lcm-tools/lcm-tools-prod
  chown -R vcf_lcm:vcf /nfs/vmware/vcf/nfs-mount/<DOWNLOAD_DIRECTORY>
  chmod -R 755 /nfs/vmware/vcf/nfs-mount/<DOWNLOAD_DIRECTORY>

6. Upload the latest PartnerBundleMetadata.json with 7.0.400 bundle.

   cd /opt/vmware/vcf/lcm/lcm-tools-prod/bin
    ./lcm-bundle-transfer-util --upload uploadPartnerBundle --bundleDirectory /nfs/vmware/vcf/nfs-mount/<DOWNLOAD_DIRECTORY> --bundle 7.0.400-27701512

7. Login to SDDC ui and perform upgrade.