If the computer on which you install the skip-level upgrade tool does not have access to SDDC Manager, depot.vmware.com, and the Dell EMC depot, you can perform an offline skip-level upgrade to update SDDC Manager and its services to the correct version for the target VMware Cloud Foundation on Dell EMC VxRail release.

In an offline skip-level upgrade, you first download the bundles to a computer that can access depot.vmware.com and download.emc.com. Next, copy the bundles to a computer that can access SDDC Manager and then run the upgrade. This multi-step process downloads the bundles required to upgrade SDDC Manager and its services and applies those bundles to achieve the target version. It downloads, but does not apply, the bundles required to upgrade VxRail Manager and the other VMware Cloud Foundation components. It also downloads, copies, and uploads install bundles for the target release that are required for new workload domain creation. You can apply those bundles from the SDDC Manager UI after SDDC Manager and its services are upgraded.
Note: The Skip-Level Upgrade Tool does not download bundles for the vRealize suite components. To download bundles for the vRealize Suite components, use the Bundle Transfer Utility. See Download Bundles for VMware Cloud Foundation on Dell EMC VxRail with the Bundle Transfer Utility.
Note: The Bundle Transfer Utility & Skip Level Upgrade Tool is the only supported method for downloading bundles. Do not use third-party tools or other methods to download bundles.

For information about which versions of VMware Cloud Foundation support skip-level upgrades, see VMware Cloud Foundation on VxRail Skip-Level Upgrade.

For complete usage information for the VMware Cloud Foundation SDDC Skip-Level Upgrade Tool command line interface (CLI), see Skip-Level Upgrade Tool CLI.

You should always use the latest version of the skip-level tool to ensure that you can take advantage of all of its features. When you use any of the following options, the skip-level tool checks to see if you are using the latest version:
  • -c,--copy-bundles
  • -d,--download-bundles
  • --dm, --download-manifest
  • -e,--enable-cumulative-upgrades
  • -u,--upgrade
  • --up,--upgrade-precheck
  • --vb,--verify-bundles

Prerequisites

The SDDC Manager Skip-Level Upgrade Tool is a CLI-based tool with support for both Windows and Linux platforms. You must have a Windows or Linux computer that meets the following requirements:
  • Java 8 runtime environment.
  • Connectivity to depot.vmware.com over HTTPS for offline bundle download.
  • Connectivity to download.emc.com over HTTPS for offline VxRail bundle download.
  • Connectivity to SDDC Manager over SSH and HTTPS for offline bundle upload.
  • SDDC Manager and the computer on which you run the skip-level upgrade tool should be in the same timezone and have the same NTP server configured.
  • Minimum free space of 180 GB.
  • 36 GB of free space in the user’s home directory.

You must have a computer that can access depot.vmware.com and download.emc.com to download the manifest and upgrade bundles. Once you download the manifest and upgrade bundles, you copy them to a computer that can access SDDC Manager.

Additional prerequisites:
  • The /nfs/vmware/vcf/nfs-mount/bundle/ directory on the SDDC Manager VM must have a minimum free space of 180 GB.
  • Take a snapshot of the management VMs.
  • Do not run any domain operations while an upgrade is in progress. Domain operations are creating a new VI workload domain, adding hosts to a cluster or adding a cluster to a workload domain, and removing clusters or hosts from a workload domain.
  • Ensure that there are no failed workflows in your system and none of the Cloud Foundation resources are in activating or error state. If any of these conditions are true, resolve the issue before starting the upgrade.
  • Confirm that the passwords for all Cloud Foundation components are valid. Keep a record of the passwords in a secure location.
  • If you are upgrading from VMware Cloud Foundation 3.7.x or 3.8.0, you must configure dual authentication.
  • Run an upgrade precheck from SDDC Manager and resolve any issues before performing a skip-level upgrade.
    1. On the SDDC Manager Dashboard, click Inventory > Workload Domains.
    2. Click a workload domain and then click the Updates/Patches tab.
    3. Click Precheck.
    You can also run a precheck on the management domain using the skip-level upgrade tool. See Skip-Level Upgrade Tool CLI.

Procedure

  1. Download the Bundle Transfer Utility & Skip Level Upgrade Tool from My VMware to a Windows or Linux computer that can access depot.vmware.com and download.emc.com.
  2. Extract the file lcm-tools-3x-<build_number>.tar.gz.
  3. (Optional) To use a proxy server with the skip-level upgrade tool:
    Note: The skip-level upgrade tool only supports proxy servers that do not require authentication.
    1. Open the /conf/application-skiplevelupgrade.properties file.
    2. Modify the Depot proxy properties section: 
      lcm.depot.adapter.proxyEnabled=true
lcm.depot.adapter.proxyHost=<proxy IP address or FQDN>
lcm.depot.adapter.proxyPort=<proxy port>
  4. Open a command line utility, change to the bin directory that contains the executables, and execute the following command to download the manifest and upgrade bundles: 
    ./sddcmanager-skip-level-upgrade -d
  5. Enter the following information:
    • Current version of SDDC Manager. For example: 3.9.0.0.
    • Enter yes for VMware Cloud Foundation on VxRail.
    • Target version of SDDC Manager. Enter latest to upgrade to the latest version supported by the tool.
    • VMware Depot (My VMware) user name.
    • VMware Depot (My VMware) password.
    • Path to the directory for downloading the manifest and upgrade bundles.
    • Bundles to download. Enter all to download all bundles. Enter install to download all install bundles. Enter upgrade to download all upgrade bundles. Enter specific bundle names to download specific bundles, for example bundle-38371, bundle-38378.
    • Dell EMC Depot (Dell EMC Support account) user name.
    • Dell EMC Depot (Dell EMC Support account) password.
    Note: Once the bundles are downloaded, do not change any of the file names. The downloaded manifest file is required for future skip-level upgrade operations; do not delete it. In cases where the manifest is missing, it can be downloaded again using the ./sddcmanager-skip-level-upgrade -dm command.
  6. After you have downloaded all the bundles, copy the complete download directory, along with the skip-level upgrade binaries (lcm-tools-3x-<build_number>), to a system that can access SDDC Manager.
  7. Open a command line utility, change to the bin directory in lcm-tools-3x-<build_number>, and run the following command to copy the manifest and bundles to SDDC Manager: 
    ./sddcmanager-skip-level-upgrade -c
  8. Enter the following information:
    • Fully-qualified domain name (FQDN) of the SDDC Manager VM.
    • SDDC Manager super user name (primary user), for example: vcf.
    • SDDC Manager REST API user name (basic auth user), for example: admin.
    • Password for the primary user.
    • Password for the root user.
    • Password for the basic auth user.
    • Path to the directory containing the bundles and manifests.
  9. After the bundles are successfully copied to SDDC Manager, run the following command to verify the bundles: 
    ./sddcmanager-skip-level-upgrade --vb
  10. Enter the following information:
    • Fully-qualified domain name (FQDN) of the SDDC Manager VM.
    • SDDC Manager super user name (primary user), for example: vcf.
    • SDDC Manager REST API user name (basic auth user), for example: admin.
    • Password for the primary user.
    • Password for the root user.
    • Password for the basic auth user.
    • Local directory used for copying bundles.
    The skip level upgrade tool verifies the bundles and lists any missing bundles that you need to download before you start the upgrade. It also lists any missing install bundles required for the target release. You can download missing bundles using the ./sddcmanager-skip-level-upgrade -d command.
  11. Run the following command to start the upgrade: 
    ./sddcmanager-skip-level-upgrade -u
  12. Enter the following information:
    • Fully-qualified domain name (FQDN) of the SDDC Manager VM.
    • SDDC Manager super user name (primary user), for example: vcf.
    • SDDC Manager REST API user name (basic auth user), for example: admin.
    • Password for the primary user.
    • Password for the root user.
    • Password for the basic auth user.
    • Local directory used for copying bundles.
    • Temporary IP Address of the target SDDC Manager VM. This may not be required depending on the version of VMware Cloud Foundation from which you are upgrading.
    • Subnet mask of the target SDDC Manager VM. This may not be required depending on the version of VMware Cloud Foundation from which you are upgrading.
    • Network gateway of the target SDDC Manager VM. This may not be required depending on the version of VMware Cloud Foundation from which you are upgrading.
    • Password of the primary user on the target SDDC Manager VM. This may not be required depending on the version of VMware Cloud Foundation from which you are upgrading.
    • Root password on the target SDDC Manager VM. This may not be required depending on the version of VMware Cloud Foundation from which you are upgrading.
    • Basic authentication password on the target SDDC Manager VM. This may not be required depending on the version of VMware Cloud Foundation from which you are upgrading.
    You can monitor upgrade progress in the SDDC Manager Dashboard.
    When the upgrade is complete, you will see a message similar to following: 
    2021-03-08 07:57:31.360-0800 INFO  SDDC Manager Skip Level Upgrade completed with success
2021-03-08 07:57:31.360-0800 INFO  Archiving Skip Level Upgrade tool data and logs

What to do next

From the SDDC Manager UI, upgrade the VMware Cloud Foundation components required for the target VMware Cloud Foundation release. The components that you need to upgrade and the order in which you upgrade them will vary based on the version of VMware Cloud Foundation from which you are upgrading.

  • vCenter Server and Platform Services Controllers
  • NSX Data Center for vSphere
  • NSX-T Data Center
  • vRealize Suite components

See Upgrade VMware Cloud Foundation on Dell EMC VxRail.