If the computer on which you install the skip level upgrade tool has access to depot.vmware.com, you can perform an online skip-level upgrade to update SDDC Manager and its services to the correct version for VMware Cloud Foundation 4.1.

The skip-level upgrade tool 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 the other VMware Cloud Foundation components. You can apply those bundles from the SDDC Manager UI once SDDC Manager and its services are upgraded.
Note: The skip-level upgrade tool does not download bundles for the vRealize suite components.

For information about which versions of VMware Cloud Foundation support skip-level upgrades, see 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.

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, update 261 or later.
  • Connectivity to depot.vmware.com.
  • Connectivity to SDDC Manager over SSH and HTTPS.
  • Free Space of 100 GB.
Additional prerequisites:
  • Take a snapshot of the SDDC Manager VM. The skip-level upgrade tool takes this snapshot by default, unless you choose to skip it.
  • 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 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, contact VMware Support 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.

Procedure

  1. Download the Bundle Transfer Utility for VMware Cloud Foundation 4.1 from My VMware to the Windows or Linux computer.
  2. Extract the file lcm-tools-prod.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:
    For Windows:
    sddcmanager-skip-level-upgrade.bat -d –u 
    
    For Linux:
    ./sddcmanager-skip-level-upgrade -d –u 
    
  5. 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.
    • VMware Depot (My VMware) username.
    • VMware Depot (My VMware) password.
    • Local directory for downloaded bundles.
    • SDDC Manager VM Temporary IP (with gateway and subnet). This may not be required depending on the version of VMware Cloud Foundation from which you are upgrading.
    • Super user (primary user) name and password for new SDDC Manager VM (target VM). This may not be required depending on the version of VMware Cloud Foundation from which you are upgrading.
    • Root user password for the new SDDC Manager VM (target VM). This may not be required depending on the version of VMware Cloud Foundation from which you are upgrading.
    • REST API user (basic auth user) password for new SDDC Manager VM. This may not be required depending on the version of VMware Cloud Foundation from which you are upgrading.
    When the upgrade is complete, you will see a message similar to the following:
    2020-05-15 23:11:58.561-0800 INFO Successfully applied all required bundles
    2020-05-15 23:11:58.561-800 INFO Enable VMWARE_SOFTWARE cumulative upgrade to VCF 4.1
    2020-05-15 23:13:14.742-0800 INFO SDDC Manager skip level upgrade completed with success

What to do next

Upgrade the other VMware Cloud Foundation components required for VMware Cloud Foundation 4.1. 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
  • ESXi
  • NSX-T Data Center
  • vRealize Suite components
Note: The skip-level upgrade tool does not download bundles for the vRealize suite components. To upgrade vRealize Suite components, see Upgrade vRealize Suite Lifecycle Manager and vRealize Suite Products.