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.

About this task

When you recover a VMware Integrated OpenStack node, it returns to the state of a newly deployed node. To recover a database node, you must recover to a backup file. See Back Up the VMware Integrated OpenStack Deployment.

Procedure

  1. Using SSH, log in to the VMware Integrated OpenStack manager.
  2. Switch to root user. 
    sudo su -
  3. Switch to verbose mode. 
    viocli recover <-v | -verbose>
  4. View the help options. 
    viocli recover <-h | -help>
  5. Recover the OpenStack nodes by node or role.
    1. To recover a database node: 
      viocli recover <[-r ROLE -dn BACKUP_NAME]|[-n NODE -dn BACKUP_NAME]> -nfs NFS_VOLUME

      Option

      Description

      -n NODE

      Recovers the database nodes specified by VM name recover by node name. You can specify multiple nodes in one command.

      Use the VM name as it appears in the VMware Integrated OpenStack manager (VMware Integrated OpenStack > OpenStack Deployments > [Deployment Name]).

      For example, 

      viocli recover –n VIO-DB-0 VIO-DB-1 VIO-DB-2 –dn vio_os_db_20150830215406 -nfs 10.146.29.123:/backups

      recovers from the specified NFS backup file all the named database nodes: VIO-DB-0, VIO-DB-1, and VIO-DB-2.

      -r ROLE

      Recovers all the database nodes in the specified group name. You can specify multiple roles in one command.

      Use the group name as it appears in the VMware Integrated OpenStack manager (VMware Integrated OpenStack > OpenStack Deployments > [Deployment Name]).

      For example, 

      viocli recover -r DB -dn vio_os_db_20150830215406 -nfs 10.146.29.123:/backups

      recovers from the specified NFS backup file all the nodes in the DB node group.

      -dn BACKUP_NAME

      Indicates the timestamp label of the backup file to be used to restore the database.

      -nfs NFS_VOLUME

      Indicates the NFS host where the backup file is located.
    2. To recover any non-database node: 
      viocli recover <[-r ROLE]|[-n NODE]>

      Option

      Description

      -n NODE

      Recovers the nodes specified by VM name. You can specify multiple nodes in one command.

      Use the VM name as it appears in the VMware Integrated OpenStack manager (VMware Integrated OpenStack > OpenStack Deployments > [Deployment Name]).

      For example, 

      viocli recover -n VIO-Controller01

      recovers the VIO-Controller01 node.

      -r ROLE

      Recovers all the nodes in the specified group name. You can specify multiple roles in one command.

      Use the group name as it appears in the VMware Integrated OpenStack manager (VMware Integrated OpenStack > OpenStack Deployments > [Deployment Name]).

      For example, 

      viocli recover -r VIO-Controller01

      recovers all nodes in the VIO-Controller01 node group.

      Tip:

      You can use the viocli show command to list all the nodes and their roles in your VMware Integrated OpenStack deployment.

  6. Verify the node is running by checking its status in the VMware Integrated OpenStack manager: VMware Integrated OpenStack > OpenStack Deployments > [Deployment Name].

    Depending on your deployment, the recovery process might take a few minutes.