Command-Line Upgrade On-Premises by Using an ISO Image

From the VMware Cloud Director Availability On-Premises Appliance command-line interface, you can upgrade from VMware Cloud Director Availability 4.0 to the latest version by using an .iso file containing the upgrade binaries that you mount to the CD-ROM drive of the virtual appliance.

Follow the correct command-line upgrade procedure for the version of VMware Cloud Director Availability. To upgrade to the latest version, follow the updated procedure bellow. If you are upgrading to VMware Cloud Director Availability 4.0 or earlier, follow the legacy Command-Line Upgrade On-Premises by Using an ISO Image procedure.

Prerequisites

• Download the VMware-Cloud-Director-Availability-release.number.xxxxxxx-build_sha.iso file, that contains the VMware Cloud Director Availability release.number Upgrade Disk Image.

Procedure

1. Copy the .iso file to a datastore that is accessible from the vCenter Server instance that you use with VMware Cloud Director Availability.
2. Mount the .iso file to the VMware Cloud Director Availability On-Premises Appliance.
   1. Log in to the vSphere Client in the site where you want to upgrade VMware Cloud Director Availability.
   2. On the Home page, click Hosts and Clusters.
   3. Right-click the virtual machine that hosts the VMware Cloud Director Availability On-Premises Appliance and select Edit Settings.
   4. On the Virtual Hardware tab, select CD/DVD Drive > Datastore ISO File.
   5. Follow the prompts and add the CD/DVD drive to the virtual machine and select the Connected option.
3. Connect to the VMware Cloud Director Availability appliance by using a Secure Shell (SSH) client.
   1. Open an SSH connection to Appliance-IP-Address.
   2. Authenticate as the root user.
4. Upgrade the VMware Cloud Director Availability On-Premises Appliance.
   1. Mount the .iso file inside the guest operating system.

      mount /mnt/cdrom

   2. Review the end-user license agreement (EULA) and if you accept the EULA, press q.

      python3 /mnt/cdrom/update/iso-upgrade.py eula | less

   3. Install the upgrade.

      python3 /mnt/cdrom/update/iso-upgrade.py

      In the /var/log/upgrade.log file, you can verify that the upgrade is successful.
   4. After the upgrade completes, restart the appliance.

      reboot

What to do next

After you upgrade the VMware Cloud Director Availability On-Premises Appliance, complete the upgrade with a post-upgrade configuration. For more information, see Post-Upgrade Configuration On-Premises.