You can create backups that you can use to restore your VMware Cloud Director environment after a failure.

Back Up the Embedded Database of Your VMware Cloud Director Appliance

You can use the VMware Cloud Director appliance management user interface to back up your primary appliance.

On the Backup tab of the VMware Cloud Director appliance management UI, you can find details about all existing backups.

Prerequisites

Verify that the cluster health is with status HEALTHY or DEGRADED. See View Your VMware Cloud Director Appliance Cluster Health and Failover Mode.

Procedure

  1. Log in as root to the appliance management UI of the primary, standby, or application cell at https://cell_eth0_ip_address:5480.
  2. In the left panel, click the Backup tab.
    On the Backup page you can see a list of previous backups.
  3. Click Backup Now.
  4. To confirm the backup, click Backup.
    VMware Cloud Director appliance creates the backup files in the /opt/vmware/vcloud-director/data/transfer/backups directory. The backups for the earlier VMware Cloud Director versions are located in the /opt/vmware/vcloud-director/data/transfer/pgdb-backup directory. However, earlier version backups are incompatible with VMware Cloud Director 10.3.1 and later.
  5. When the backup finishes, click Close.

Results

The newly created file appears in the list of backups. The backup name is in the format backup-date-time-format.tgz. For VMware Cloud Director appliance 10.3.2 and later, the backup name is in the format backup-date-time-format.zip.

What to do next

  • If you do not expect to restore the system to version 10.3 or earlier, you can delete the backups in the /opt/vmware/vcloud-director/data/transfer/pgdb-backup directory.
  • If you do not expect to restore the system to version 10.3.1, you can delete the backups in the /opt/vmware/vcloud-director/data/transfer/backups directory.
  • Starting with VMware Cloud Director 10.3.2, you can delete any unnecessary 10.3.2 and later backups by using the VMware Cloud Director appliance management user interface or the VMware Cloud Director appliance API. For information on how to use the VMware Cloud Director appliance API, see the VMware Cloud Director Appliance API Reference.

Restore Your Primary VMware Cloud Director Appliance

To restore your primary appliance, you can use the VMware Cloud Director appliance management UI. If an HA cluster fails, for example, during a failed upgrade, you can use a backup to restore the primary, instead of using a VM snapshot.

Note: To restore your cluster, you must redeploy all standby appliances.

Prerequisites

Procedure

  1. Log in as root to the appliance management UI of the newly deployed primary cell at https://FQDN_of_the_primary_appliance:5480.
  2. In the left panel, click the Restore from Backup tab.
  3. Enter the path that contains the backups directory, for example, remote_target:/data/transfer.
    The NFS mount and the share containing the backups directory must have 750 permission and vcloud.vcloud ownership.
  4. When the validator confirms the NFS share, click Next.
  5. Select the backup that you want to use to restore the primary appliance, and click Next.
    By default, only the backups with a compatible version appear. You can sort the backups by date, or filter the backups by the appliance version.
  6. (Optional) Select which certificates you want to restore from the backup.
    For the restored appliance, you can reuse the HTTP certificate and the PostgreSQL database and appliance management UI endpoint certificate.
    Note:

    Starting with VMware Cloud Director 10.4, the VMware Cloud Director service uses one certificate for HTTPS and console proxy communications.

  7. Enter the path to the transfer share for the restored primary appliance.
    You can use the same NFS share, or enter a new share for the restored appliance.
  8. When the validator confirms the NFS share, click Restore.
  9. When the restore operation completes successfully, click Close.

What to do next

  1. If there are untrusted certificates, verify the certificate information and confirm that you trust the necessary certificates.
  2. Redeploy the standby cells and any application cells from the original cluster topology.
  3. If the failover mode before the restore was Automatic, you must set it again to Automatic by using the VMware Cloud Director appliance API.
  4. If the VMware Cloud Director appliance FIPS mode was on before the restore, you must set it again by using the VMware Cloud Director appliance API.

    The cell FIPS mode restores automatically.