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

• 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

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

• Run the VMware Cloud Director database upgrade utility.
  
  /opt/vmware/vcloud-director/bin/upgrade
  
  
• 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

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