ERROR: "The database schema version is not compatible with this version." when attempting to start the vmware-vcd service on a recently upgraded Cloud Director Appliance.

Products

• VMware Cloud Director

Issue/Introduction

• When trying to access the VCD Provider Admin Portal in the browser, the page does not load and instead shows the message: “This page isn’t working right now – <VCD FQDN> didn’t send any data.”
• Recently upgraded Cloud Director Appliance will not start the vmware-vcd service
• Errors seen in the /opt/vmware/vcloud-director/logs/cell.log file during startup :"The database schema version is not compatible with this version."

Environment

VMware Cloud Director 10.6.1

Cause

The database schema has not been upgraded after applying an update to the VMware Cloud Director Appliance. The VMware Cloud Director database upgrade utility must be run on one cell before attempting to start the vmware-vcd service on any of the cells.

Resolution

1. Run the VMware Cloud Director database upgrade utility : /opt/vmware/vcloud-director/bin/upgrade
2. Reboot each VCD cell  : shutdown -r now
3. Review the database upgrade utility log file for any errors. /opt/vmware/vcloud-director/logs/upgrade-YYYY-MM-DD-HH-MM-SS.log

Additional Information

Follow the process outlined in the documentation: Upgrade Your VMware Cloud Director Appliance by Using an Update Package