Command-Line Upgrade by Using an ISO Image

From the cloud appliances 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.

You must perform this procedure multiple times, to upgrade each VMware Cloud Director Availability appliance. Follow the updated command-line procedure bellow when upgrading from VMware Cloud Director Availability 4.0. If you are upgrading from version 3.x to 4.0, follow the legacy Command-Line Upgrade by Using an ISO Image procedure.

Prerequisites

• Follow a strict order when upgrading the VMware Cloud Director Availability appliances. For more information, see Upgrade Sequence.

• 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 in a VMware Cloud Director Availability 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 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 VMware Cloud Director Availability virtual machine and select the Connected option.
   Repeat this step to mount the .iso file in all remaining VMware Cloud Director Availability appliances.
3. Upgrade a VMware Cloud Director Availability appliance.
   1. Connect to the appliance console either by using a Secure Shell (SSH) client or by using the vSphere Client and log in as the root user.
   2. Mount the .iso file inside the guest operating system.

      mount /mnt/cdrom

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

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

   4. 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.
   5. After the upgrade completes, restart the appliance.

      reboot

   Repeat this step to upgrade all remaining VMware Cloud Director Availability appliances.

What to do next

After you upgrade all the VMware Cloud Director Availability appliances, finish the upgrade with a post-upgrade configuration. For more information, see Post-Upgrade Configuration in the Cloud.