VxRail Upgrade Fails Due to Checksum Mismatch After Bundle Modification.
search cancel

VxRail Upgrade Fails Due to Checksum Mismatch After Bundle Modification.

book

Article ID: 392936

calendar_today

Updated On:

Products

VMware SDDC Manager

Issue/Introduction

During an upgrade attempt using a modified VxRail 8.0.322 composite bundle (intended to remove the vxrail-port-lldp VIB), the SDDC Manager failed to recognize the bundle due to a checksum mismatch.

You may observe the upgrade attempt result with the following Error:

"#### - patch file 1MFHV_VxRail-8.0.322-Composite-Upgrade-Slim-Package-for-8.0.x.zip checksum <alphanumeric checksum value> does NOT match with the element checksum <alphanumeric checksum value>." 

Note: The alphanumeric checksum value will be different for each VCF instance/environment.

This issue occurred after the bundle was modified to avoid applying the vxrail-port-lldp VIB, which may cause network connectivity issues with Cisco switches.

Environment

VCF on VxRail 5.x

Cause

The root cause was a cached checksum from the original VxRail 8.0.322 bundle persisting within the SDDC Manager’s database, conflicting with the checksum of the modified bundle. The standard upgrade process did not properly clear this cached reference.

Resolution

The following steps are required to resolve the checksum mismatch and allow the SDDC Manager to accept the modified bundle:

1. Clean Up Existing Bundle Data: Execute the bundle_cleanup.py script to remove the cached checksum information for the older 8.0.322 bundle from the SDDC Manager’s database: 
 

python /opt/vmware/vcf/lcm/lcm-app/bin/bundle_cleanup.py VXRAIL8-0-322-290209901MFHV_VxRail-8-0-322-Composite-Upgrade-Slim-Package-for-8-0-x-zip

2. Modify verify_bundle_signature.py:  Modify the /etc/vmware-marvin/scripts/lcm/scripts/verify_bundle_signature.py file on each VxRail Manager to bypass checksum verification for the modified bundle. This involves: 

  •      Locating the script within the archive: VXRAIL_COMPOSTIE-SLIM-8.0.322-29020990_for_8.0.x\bundles\surrogate.war\WEB-INF\lcm-scripts.zip\lcm\scripts\verify_bundle_signature.py
  •      Changing the last line of the script from exit(main()) to exit(0).
  •      Restarting the vmware-marvin service: sudo systemctl restart vmware-marvin.service
         

3. Bundle Manifest Modification: 

  •      Locate the LCM bundle on your laptop, the above URL downloads the file as VXRAIL_COMPOSTIE-SLIM-8.0.322-29020990_for_8.0.x. Do Not unzip the file.
  •      Use 7-Zip to Open archive
  •      Edit manifest.xml
  •      Remove 2 package sections for portlldpd
  •      Remove vxrail-port-lldp.zip
  •      Remove bundles/vxrail-port-lldp_8.0.322-29020990.zip
         

 

4. Update Bundle Data: 

  •      Copy the modified bundle to the SDDC Manager: /nfs/vmware/vcf/nfs-mount/bundle/1MFHV_VxRail-8.0.322-Composite-Upgrade-Slim-Package-for-8.0.x.zip
  •      Verify the checksum of the bundle: 
    • sha256sum /nfs/vmware/vcf/nfs-mount/bundle/1MFHV_VxRail-8.0.322-Composite-Upgrade-Slim-Package-for-8.0.x.zip
  •      Update the checksum in /nfs/vmware/vcf/nfs-mount/bundle/vxrailPartnerBundleMetadata.json.
  •      Push the PBM to the SDDC Manager’s database: 
    • - cp -p /nfs/vmware/vcf/nfs-mount/bundle/vxrailPartnerBundleMetadata.json /nfs/vmware/vcf/nfs-mount/bundle/depot/local/

- chmod -R 777 /nfs/vmware/vcf/nfs-mount/bundle/depot/local/

- curl -X PUT http://localhost/lcm/bundle/upload/partnerBundleMetadata -H "Content-Type: application/json"

5. Verify Bundle Information: Confirm the updated checksum is reflected in the database:

psql -U postgres -h localhost -d lcm -c "select metadata_json from partner_bundle_metadata where bundle_id='VXRAIL8-0-322-290209901MFHV_VxRail-8-0-322-Composite-Upgrade-Slim-Package-for-8-0-x-zip';"

6. Upload Bundle to Depot:

- cp -p /nfs/vmware/vcf/nfs-mount/bundle/1MFHV_VxRail-8.0.322-Composite-Upgrade-Slim-Package-for-8.0.x.zip /nfs/vmware/vcf/nfs-mount/bundle/depot/local/bundles/

- chmod -R 777 /nfs/vmware/vcf/nfs-mount/bundle/depot/local/

- chown -R vcf_lcm:vcf /nfs/vmware/vcf/nfs-mount/bundle/depot/local/

- curl -X PUT http://localhost/lcm/bundle/upload/partnerBundle/VXRAIL8-0-322-290209901MFHV_VxRail-8-0-322-Composite-Upgrade-Slim-Package-for-8-0-x-zip -H "Content-Type:application/json"

 

Additional Information

  •      Ensure all steps are performed on each VxRail Manager.
  •      After completing these steps, attempt to plan and execute the upgrade through the SDDC Manager.
  •      The checksum value for the modified bundle will vary depending on the specific modifications made.  Verify the checksum after applying the changes.
    •      Hostname: host1.example.com
    •      IP Address: 10.x.x.x
    •      Email Address: [email protected] 
           
Powered by Wolken Software