Use the viocli recover command to recover one node or a group of nodes. Because most OpenStack nodes are stateless, you can recover them without a backup. For OpenStack database nodes, you must have a backup file. An NFS path is required. Use the viocli show command to view a detailed list of OpenStack nodes in your deployment.

The viocli recover command uses the following syntax. 

viocli recover [-d [NAME]] <-r ROLE1,ROLE2... | -n NODE1,NODE2...> \
               [-dn BACKUP_NAME] [-nfs NFS_VOLUME] [-h] [-v]

Parameter

Mandatory or Optional

Description

-d, --deployment NAME

Automatic

Name of the deployment containing the nodes to be recovered.

Applied automatically. The default value is the name of the current deployment.

-r, --role ROLE

Mandatory unless NODE is specified

Recovers all the nodes assigned to a given role. You can specify multiple roles in one command. You can also specify -n, --node to the same command to recover additional nodes that are not assigned to that role.

Use the group name as it appears in the VMware Integrated OpenStack manager. To view the group name, select VMware Integrated OpenStack > OpenStack Deployments > [Deployment Name].

The valid role names are: ComputeDriver, Controller, DB, LoadBalancer.

For example, the following command recovers the nodes in the DB node group from the specified NFS backup file.

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

-n, --node NODE

Mandatory unless ROLE is specified

Recovers a specified node. You can specify multiple nodes in one command.

Use the VM name as it appears in the VMware Integrated OpenStack manager. To view the name, select VMware Integrated OpenStack > OpenStack Deployments > [Deployment Name].

For example, the following command recovers the specified database nodes (VIO-DB-0, VIO-DB-1, and VIO-DB-2) from the specified NFS backup file.

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

-dn, --dir-name BACKUP_NAME

Mandatory for OpenStack database recovery

Indicates the time stamp label of the backup file to use to restore the database.

For database recovery, use one of the following positional arguments

  • DIR_NAME

  • NFS_VOLUME

Mandatory for OpenStack database recovery

DIR_NAME

Name of the NFS directory containing the database backup file.

NFS_VOLUME

Name or IP address of the target NFS volume and directory containing the database backup.

Use the following format: remote_host:remote_dir. For example: 192.168.1.77:/backups.

-h, --help

Optional

Show the use and arguments for this command.

-v, --verbose

Optional

Enter verbose mode.