In the event of a disk failure or another critical issue, you can recover the individual nodes in your VMware Integrated OpenStack deployment using the CLI.

When you recover a VMware Integrated OpenStack node, it returns to the state of a newly deployed node.

Prerequisites

  • If you want to recover all database nodes, you must have a backup of the OpenStack database. See Back Up Your Deployment.

  • Ensure that the datastore has sufficient free space to contain the original and recovered nodes at the same time. The recovery process will delete the original node, but space for both nodes is temporarily required. To avoid this issue, you can power off and delete the existing node before recovering it.

Procedure

  1. Log in to the OpenStack Management Server.
  2. Recover OpenStack nodes by node or role.
    1. To recover a non-database node:
      sudo viocli recover {-n node... | -r role... [-n node...]} 

      Option

      Description

      -n

      Recovers one or more specified nodes by name.

      To display the nodes in your deployment, use the viocli show command. The values shown in the VM Name column can be used as arguments for this parameter.

      -r

      Recovers all nodes in one or more roles. You can specify -n in addition to this parameter to recover single nodes outside of the specified role.

      To display the roles in your deployment, use the viocli show command. The values shown in the Role column can be used as arguments for this parameter.

    2. To recover a database node:
      sudo viocli recover {-n node-name | -r role-name} -dn backup-name -nfs nfs-host:/backup-folder

      Option

      Description

      -n

      Recovers a single database node. You can specify VIO-DB-0, VIO-DB-1, or VIO-DB-2 for HA deployments or VIO-ControlPlane-0 for compact or tiny deployments.

      -r

      Recovers all database nodes. Specify DB for HA deployments or ControlPlane for compact or tiny deployments.

      -dn

      Enter the folder containing the OpenStack database backup.

      OpenStack database backup folders are in vio_os_db_yyyymmddhhmmss format.

      -nfs

      Specify the NFS host and directory where the backup is located in the format remote-host:/remote-dir.

Results

The recovery process may take several minutes. You can check the status of your node by viewing your OpenStack deployment in the vSphere Web Client.