This VMware Cloud Foundation Lifecycle Management document describes how to manage the lifecycle of a VMware Cloud Foundation environment. The information includes prerequisites, step-by-step configuration instructions, and suggested best practices.

Note:

Review the VMware Interoperability Matrix to verify compatibility and upgradability before planning and starting an upgrade.

You can perform a sequential or skip-level upgrade to VMware Cloud Foundation 5.0 from VMware Cloud Foundation 4.3 or later. If your environment is at a version earlier than 4.3, you must upgrade the management domain and all VI workload domains to VMware Cloud Foundation 4.3 or later before you can upgrade to VMware Cloud Foundation 5.0.

Caution:

vSphere with Tanzu enabled clusters, may require a specific upgrade sequence. See KB 88962 for more information.

The first step is to download the bundles for each VMware Cloud Foundation component that requires an upgrade. After all of the bundles are available in SDDC Manager, upgrade the management domain and then your VI workload domains.

VMware Cloud Foundation 5.0 supports VMware Cloud Foundation+. To add your on-premises deployment to a VMware Cloud Foundation+ subscription, you must upgrade at least the management domain to VMware Cloud Foundation 5.0 and VI workload domains to VCF 4.5. See the VMware Cloud Foundation+ Guide for more information.

SDDC Manager Functionality During Upgrade to VMware Cloud Foundation 5.0

During the upgrade to VMware Cloud Foundation 5.0, some SDDC Manager functionality may be limited during each phase of the upgrade. Prior to initiating the upgrade determine if you will need to perform any of these tasks.

Upgrade States

  • Source BOM - Prior to initiating the upgrade all components are at VMware Cloud Foundation 4.x

  • Split BOM - Management domain or VI Workload Domain is only partially updated to VMware Cloud Foundation 5.0.

  • Mixed BOM - Some workload domains (Management or VI) have been completely upgraded to VMware Cloud Foundation 5.0 and at least one VI Workload Domain is at the Source BOM version.

  • Target BOM - All components are at VMware Cloud Foundation 5.0

When a VMware Cloud Foundation instance is in Source BOM or Target BOM, the features available within SDDC Manager are as expected for that given release. However when in a Mixed BOM the operations available vary per workload domain depending on which state the domain itself is in.

The following table indicates the functions available within SDDC Manager during the upgrade from VMware Cloud Foundation 4.x to VMware Cloud Foundation 5.x.

Table 1. SDDC Manager Functionality During Upgrade

Category

Feature

Mixed BOM

Backup / Restore

Configure and perform Backup / Restore

Y

CEIP

Activate / Deactivate CEIP

Y

Certificate Management

View/Generate/Upload/Install

Y

Composability

Compose / Decompose Server

N

Add / Remove Storage to Composed Server

N

NSX Edge Cluster

Expand edge cluster

Y

DNS / NTP configuration

Validate / Configure DNS

Y

Validate / Configure NTP

Y

Hosts

Commission / Decommission Host

Y

Licensing

Update License Key Information

Y

Add License Key

Y

Relicensing

Y

License check

Y

Get/Update Licensing info- (Subscription)

Y

LCM

Connect to VMware or Dell Depot / Download Bundles

Y

LCM Pre checks

Y

Schedule Bundle Download

Y

Networking

Create / Edit / Delete Network Pool

Y

Password Management

Rotate/Update/Retry/Cancel

Y

User Operations

Add / Remove User / Group

Y

Workload Domain

Add/Remove ESXi Host

Y

Add/Remove vSphere Cluster

Y

Add 4.x Workload Domain

N

Add 5.x Workload Domain in ELM mode

N

Add 5.x Isolated Workload Domain

Y

Remove 4.x Workload Domain

N

Remove 5.0 Workload Domain

N

Table 2. VI Workload Domain Feature Availability Across VMware Cloud Foundation 4.x Upgrade States

Category

Features

Split BOM

Domain Operations

Add Host

N

Remove Host

N

Add / Remove vSphere Cluster

N

Remove Workload Domain

N

Stretch a vSphere Cluster

N

Unstretch a vSphere Cluster

N

Expand a Stretched vSphere Cluster

N

Shrink a Stretched vSphere Cluster

N

Lifecycle Operations

Install vCenter Patch

N

Install ESXi Patch

N

Password Management

Rotate / Update / Retry / Cancel

N

Certificate Management

View / Generate / Upload / Install Certificates

N

vSphere UI Client Plug-ins

Identify all vSphere UI client plug-ins prior to the upgrade. 

It may be possible to upgrade some vSphere UI client plug-ins before upgrading to vSphere 8.0.  Contact your 3rd Party vendor to determine the best upgrade path.

Supported Topologies for VMware Cloud Foundation

The following topologies are supported for the VMware Cloud Foundation 5.x upgrade.

Table 3. Supported Topologies for Upgrade

Topology

Supported

Standard

Yes

Stretched Cluster

Yes

Consolidated

Yes

Multi-instance

Yes

Monitor VMware Cloud Foundation Updates

You can monitor in-progress updates for VMware Cloud Foundation components.

Procedure

  1. In the In-Progress Updates section, click View Status to view the high-level update progress and the number of components to be updated.
  2. Details of the component being updated is shown below that. The image below is an example and may not reflect the actual versions.
    Image showing the details of component being updated in the In-Progress Updates section.
  3. Click the arrow to see a list of tasks being performed to update the component. As the task is completed, it shows a green check mark.
    Image showing a list of tasks being performed to update the component. Completed tasks show a green check mark.
  4. When all tasks to update a component have been completed, the update status for the component is displayed as Updated.
  5. If a component fails to be updated, the status is displayed as Failed. The reason for the failure as well as remediation steps are displayed. The image below is an example and may not reflect the actual versions in your environment.
    Image showing a scenario where a component fails to get updated.
  6. After you resolve the issues, you can retry the update.

View VMware Cloud Foundation Update History

The Update History page displays all updates applied to a workload domain.

Procedure

  1. In the navigation pane, click Inventory > Workload Domains.
  2. Click the name of a workload domain and then click the Update History tab.
    All updates applied to this workload domain are displayed. If an update bundle was applied more than once, click View Past Attempts to see more information.

Access VMware Cloud Foundation Upgrade Log Files

You can check the log files for failed upgrades to help troubleshoot and resolve issues.

  1. SSH in to the SDDC Manager appliance with the vcf user name and enter the password.
  2. To access upgrade logs, navigate to the /var/log/vmware/vcf/lcm directory.
    • lcm-debug log file contains debug level logging information.
    • lcm.log contains information level logging.
  3. To create an sos bundle for support, see Supportability and Serviceability (SoS) Utility in the VMware Cloud Foundation Administration Guide.