Upgrading Cloud Director 10.4.1 to 10.5
| 2 minutes
VMware Cloud Director VCD VCD 10.4.1 VCD 10.5 Upgrade

With the release of VMware Cloud Director 10.5 to VMware Cloud Providers, I wanted to jump on it early and get a blog post about the upgrade process and new features. Except, I’ve been battling a small issue getting the upgrade through in my lab! Enjoy the read.

My environment consists of:

  • Cloud Director 10.4.1 (single cell)
  • Container Service Extension 4.0.3
  • App LaunchPad 2.1.2

For this post, I’ll only be upgrading Cloud Director to 10.5. The rest of the extensions will come in future posts. All steps from the Cloud Director 10.5 Upgrade Procedure (Online) were followed for this post.

Note: This is a single cell deployment.

  1. SSH to your VCD cell with the root account.

  2. Shut down VMware Cloud Director by running the following command:
    /opt/vmware/vcloud-director/bin/cell-management-tool -u <admin_username> cell --shutdown
    Note: The “<admin_username>” is the System Administrator user for your Cloud Director instance. You’ll see this message: Cell successfully deactivated and all tasks cleared in preparation for shutdown

  3. Make sure your update repository is pointing to the online VMware source:
    vamicli update --repo ""

  4. Check the online repo for updates:
    vamicli update --check

    The vamicli will report a new update available
  5. Log into the VCD cell’s VAMI and create a backup.

    Create a new backup in the VAMI

    The backup can take some time depending on your DB size

  6. Once the backup is complete, go back to your SSH session and install the available upgrade.
    vamicli update --install latest
    This will take a little while. The bundle is around 1GB in download size, then it will be installed.

  7. In your active SSH session, run the VCD DB upgrade utility.

  8. You may see active cells reported. Make sure all cells in your Server Group have been shutdown (see step 1).

    I rolled the dice and continued with the upgrade even though I shutdown the VCD services.

  9. When prompted to start the service, enter N and restart the cell manually:
    shutdown -r now

  10. Once the services have restarted, log into your VCD Provider portal and confirm the version:

I mentioned at the beginning that I hit a small issue. The above is what happens during a normal, perfect upgrade experience. But that’s not always the case: https://www.funkycloudmedina.com/2023/07/unable-to-upgrade-the-database-org.postgresql.util.psqlexception-error-could-not-open-shared-memory-segment-no-such-file-or-directory/


About Stellios Williams
Senior Cloud Solutions Architect - Service Providers VMware
This is my personal tech related blog for anything private and public cloud - including homelabs! My postings are my own and don’t necessarily represent VMware’s positions, strategies or opinions. Any technical guidance or advice is given without warranty or consideration for your unique issues or circumstances.
comments powered by Disqus