Enable upgrade of VxRail 8.x releases from 8.0.214 onwards to an 8.y patch release using FlexBOM
search cancel

Enable upgrade of VxRail 8.x releases from 8.0.214 onwards to an 8.y patch release using FlexBOM

book

Article ID: 404285

calendar_today

Updated On:

Products

VMware Cloud Foundation

Issue/Introduction

To apply VxRail patch, from source VxRail version, upgrade should also be available to "Supported VCF Version" (BOM) for the target VxRail version as mentioned in KB 88287. For VxRail 8.x versions from 8.0.214 onwards, the earliest upgrade path on 8.x is 8.0.330, which is a patch on top of VCF 5.2.1.2. VCF 5.2.1.2 is a SDCC Manager patch release and not a VCF release (BOM). As there is no upgrade path to a VCF release (BOM) from VxRail 8.x versions from 8.0.214 onwards, upgrade path to VxRail 8.y releases doesn't show up.

Environment

VxRail on VMware Cloud Foundation 5.2.x

Cause

To apply a VxRail patch, upgrade to a VCF release first and then apply a VxRail patch on top of it. For VxRail builds on 8.x versions from 8.0.214 onwards, the earliest upgrade path on 8.x is 8.0.330, which is a patch on top of VCF 5.2.1.2. As there is no VCF release that can be upgraded to before applying a VxRail patch, there will be no forward upgrade shown for VxRail 8.x versions from 8.0.214 onwards.

Resolution

Currently there is no resolution to the issue.

As a workaround, proceed with the steps below:

Note: All the commands must be run from SDDC Manager

  1. Upgrade SDDC Manager to 5.2.1.0
  2. Online Customers (Connected to depot): Download all the needed bundles mentioned below from SDDC Manager UI

    Offline Customers (Not connected to depot): Download and upload all the needed bundles mentioned below using OBTU. Also, download and upload the needed metadata files. Refer to Offline Download of VMware Cloud Foundation 5.2.x Upgrade Bundles

      • SDDC Manager bundle as mentioned in column "Minimum SDDC Manager version needed" of table for the target VxRail version
      • NSX-T 4.2.1.0 or above bundle as needed
      • vCenter bundle as mentioned in column "Minimum vCenter Server Version" of table for the target VxRail version
      • Target VxRail bundle (See table to know the possible target VxRail versions for a given source VxRail version)

  3. Disconnect all depots.

    Note: Do not upload partnerBundleMetadata.json or vxrailPartnerBundleMetadata.json and VxrailCompatibilityData.json by any means (OBTU, offline upload etc), till all the below operations up to "post upgrade steps" are completed.

    Note: The below commands makes upgrade path to 8.0.310 available, but is not a supported upgrade path from DELL. So, it is advised not to attempt the upgrade to 8.0.310. Post upgrade steps removes upgrade path to 8.0.310, It is enabled only temporarily to enable upgrade to target VxRail version. However, if 8.0.310 upgrade is attempted, then it fails at precheck as shown below due to unsupported upgrade path to 8.0.310 from DELL. In the below screenshot, upgrade is attempted from 7.0.480 to 8.0.310, which is unsupported from DELL and hence the failure.



  4. Cleanup 8.0.310 bundle using below command. This should be run as "root" user 

    Bundle cleanup for 8.0.310
    python /opt/vmware/vcf/lcm/lcm-app/bin/bundle_cleanup.py VXRAIL8-0-310-28809519R1F8P_VxRail-8-0-310-Composite-Upgrade-Slim-Package-for-7-0-x-zip


  5. Download and upload bundle of target VxRail release using OBTU (Offline Bundle Transfer Utility). You can download OBTU from the Broadcom customer support portal. Below are the commands,

    In the below commands, replace below place holders with correct values

    <out_dirpath> is the output directory path for OBTU. Point to a directory which has sufficient space to accomodate VxRail bundle being downloaded, for example, /nfs/vmware/vcf/nfs-mount NOTE: "/nfs/vmware/vcf/nfs-mount/bundle/depot/bundle" should not be used.

    <dell_user> is the username for DELL depot

    <custom_PBM_Path> is the path of the custom partnerBundleMetadata.json in SDDC Manager which is taken from the table below

    <vxrail_version> is "VxRail version identifier" from the table below

    <vmware_user> is the username for Broadcom depot

    <bundle_name> is "Bundle Name" from the table below

    OBTU command to download VxRail bundle as per custom PBM
    ./lcm-bundle-transfer-util --download "downloadPartnerBundle" --outputDirectory <out_dirpath> --partnerDepotUser <dell_user> --userPBM <custom_PBM_Path> --bundle <vxrail_version>  --depotUser <vmware_user>

    If the above command is not run on SDDC Manager, copy the contents of <out_dirpath> to SDDC Manager and run below commands as "root" user on SDDC Manager. Note: In this case <out_dirpath> in below commands should point to the copied directory on SDDC Manger

    OBTU commands to upload custom PBM and downloaded VxRail bundle
    cp <out_dirpath>/bundles/<bundle_name> /nfs/vmware/vcf/nfs-mount/bundle/depot/local/bundles/
     
    cp <out_dirpath>/partnerBundleMetadata.json /nfs/vmware/vcf/nfs-mount/bundle/depot/local
     
    cp <out_dirpath>/vxrailPartnerBundleMetadata.json /nfs/vmware/vcf/nfs-mount/bundle/depot/local
     
    chown vcf_lcm:vcf /nfs/vmware/vcf/nfs-mount/bundle/depot/local/bundles/<bundle_name>
    chown vcf_lcm:vcf /nfs/vmware/vcf/nfs-mount/bundle/depot/local/partnerBundleMetadata.json
    chown vcf_lcm:vcf /nfs/vmware/vcf/nfs-mount/bundle/depot/local/vxrailPartnerBundleMetadata.json
     
    chmod 644 /nfs/vmware/vcf/nfs-mount/bundle/depot/local/bundles/<bundle_name>
    chmod 644 /nfs/vmware/vcf/nfs-mount/bundle/depot/local/partnerBundleMetadata.json
    chmod 644 /nfs/vmware/vcf/nfs-mount/bundle/depot/local/vxrailPartnerBundleMetadata.json
     
    ./lcm-bundle-transfer-util --upload "uploadPartnerBundle" --bundleDirectory <out_dirpath> --bundle <vxrail_version>

    Example:

     
    Example OBTU command to download VxRail bundle as per custom PBM
    ./lcm-bundle-transfer-util --download "downloadPartnerBundle" --outputDirectory /nfs/vmware/vcf/nfs-mount/obtu_bundle --partnerDepotUser <dell_user> --userPBM /home/vcf/partnerBundleMetadata_8_0_330_29081604.json --bundle "8.0.330-29081604"  --depotUser <vmware_user>

    If the above command is not run on SDDC Manager, copy the contents of "/nfs/vmware/vcf/nfs-mount/obtu_bundle" to SDDC Manager and run below commands as "root" user on SDDC Manager. Note: In this case "/nfs/vmware/vcf/nfs-mount/obtu_bundle" in below commands should be replaced with the path of the copied directory on SDDC Manger

    Example OBTU commands to upload custom PBM and downloaded VxRail bundle
    cp /nfs/vmware/vcf/nfs-mount/obtu_bundle/bundles/7F20G_VxRail-8.0.330-Composite-Upgrade-Slim-Package-for-8.0.x.zip /nfs/vmware/vcf/nfs-mount/bundle/depot/local/bundles/
     
    cp /nfs/vmware/vcf/nfs-mount/obtu_bundle/partnerBundleMetadata.json /nfs/vmware/vcf/nfs-mount/bundle/depot/local
     
    cp /nfs/vmware/vcf/nfs-mount/obtu_bundle/vxrailPartnerBundleMetadata.json /nfs/vmware/vcf/nfs-mount/bundle/depot/local
     
    chown vcf_lcm:vcf /nfs/vmware/vcf/nfs-mount/bundle/depot/local/bundles/7F20G_VxRail-8.0.330-Composite-Upgrade-Slim-Package-for-8.0.x.zip
    chown vcf_lcm:vcf /nfs/vmware/vcf/nfs-mount/bundle/depot/local/partnerBundleMetadata.json
    chown vcf_lcm:vcf /nfs/vmware/vcf/nfs-mount/bundle/depot/local/vxrailPartnerBundleMetadata.json
     
    chmod 644 /nfs/vmware/vcf/nfs-mount/bundle/depot/local/bundles/7F20G_VxRail-8.0.330-Composite-Upgrade-Slim-Package-for-8.0.x.zip
    chmod 644 /nfs/vmware/vcf/nfs-mount/bundle/depot/local/partnerBundleMetadata.json
    chmod 644 /nfs/vmware/vcf/nfs-mount/bundle/depot/local/vxrailPartnerBundleMetadata.json
     
    ./lcm-bundle-transfer-util --upload "uploadPartnerBundle" --bundleDirectory /nfs/vmware/vcf/nfs-mount/obtu_bundle --bundle "8.0.330-29081604"


  6. Upload the VxRail VVS (VxrailCompatibilityData.json) attached to SDDC Manager using "API Explorer" from SDDC Manager UI as shown below



  7. From SDDC Manager UI, replan the upgrade, select VCF 5.2.1 as target release and, customize the target version for

    • VxRail to an 8.y patch which can be upgraded from the source VxRail version (See table to see target versions supported from a source version)
    • SDDC Manager to a version as mentioned in column "Minimum SDDC Manager version needed" of table for the target VxRail version or higher
    • vCenter Server to the minimum vCenter version mentioned in the table for the target VxRail patch release or higher
    • NSX-T to 4.2.1.0 or higher


  8. Plan the upgrade

Post Upgrade Steps (Note: These steps must be performed only after all the VxRail clusters that needs to be upgraded to target version is complete)

After upgrade of all VxRail clusters are completed, perform below steps. Note that, these steps must be performed after all VxRail cluster upgrades to target version are done.

  1. Cleanup 8.0.310 bundle using below command. This should be run as "root" user.

    Bundle cleanup for 8.0.310
    python /opt/vmware/vcf/lcm/lcm-app/bin/bundle_cleanup.py VXRAIL8-0-310-28809519R1F8P_VxRail-8-0-310-Composite-Upgrade-Slim-Package-for-7-0-x-zip


  2. You may now connect to the depots. After depots are connected, in about a day custom VxRail VVS uploaded above will be replaced with the VxRail VVS published in DELL depot. If you are not going to connect to the depots, then proceed to upload the latest VxRail VVS to replace the custom VxRail VVS uploaded above. You can use OBTU to do the same. Below are the commands,

In the below commands, replace below place holders with correct values

<dirpath> is the output directory path for OBTU.

<dell_user> is the username for DELL depot

<vmware_user> is the username for Broadcom depot

<sddc_mgr_fqdn> is the FQDN of SDDC Manager

<sddc_sso_user> is the SSO user for SDDC Manager

OBTU command to download vmware and vxrail compatibility files
./lcm-bundle-transfer-util --download --compatibilityMatrix --outputDirectory <dirpath> --partnerDepotUser <dell_user> -depotUser <vmware_user>

 

 





If the machine on which the above command is run doesn't have access to SDDC Manager, copy the contents of <dirpath> to SDDC Manager. Note: In this case <dirpath> in the below command should point to the copied directory on SDDC Manger.

OBTU command to upload vmware and vxrail compatibility files
./lcm-bundle-transfer-util --update --compatibilityMatrix --bundleDirectory <dirpath> --sddcMgrFqdn <sddc_mgr_fqdn> --sddcMgrUser <sddc_sso_user>

 

 

 

 

Example:

Example OBTU command to download vmware and vxrail compatibility files
./lcm-bundle-transfer-util --download --compatibilityMatrix --outputDirectory /nfs/vmware/vcf/nfs-mount/obtu_bundle --partnerDepotUser <dell_user> -depotUser <vmware_user>

 

 

 

 

 

If the machine on which the above command is run doesn't have access to SDDC Manager, copy the contents of "/nfs/vmware/vcf/nfs-mount/obtu_bundle" to SDDC Manager. In this case "/nfs/vmware/vcf/nfs-mount/obtu_bundle" in the below command should be replaced with the path of the copied directory on SDDC Manger.

Example OBTU command to upload vmware and vxrail compatibility files

./lcm-bundle-transfer-util --update --compatibilityMatrix --bundleDirectory /nfs/vmware/vcf/nfs-mount/obtu_bundle --sddcMgrFqdn sddc-manager.vrack.example.com --sddcMgrUser [email protected]

Table of information for target VxRail versions

Target VxRail 8.x version Bundle Name partnerBundleMetadata.json VxRail version identifier Minimum vCenter Version Source VxRail 8.x versions Minimum SDDC Manager version needed
8.0.330 7F20G_VxRail-8.0.330-Composite-Upgrade-Slim-Package-for-8.0.x.zip partnerBundleMetadata_8_0_330_29081604.json  8.0.330-29081604 VC 8.0 Update 3e 8.0.214 5.2.1.2


Note: Same steps can be followed for upgrade done through API's.

Attachments

VxrailCompatibilityData.json get_app
partnerBundleMetadata_8_0_330_29081604.json get_app
Powered by Wolken Software