Use the viocli recover command to recover nodes or groups of nodes.

Because most OpenStack nodes are stateless, you can recover them without a backup file. However, a backup file is necessary to recover OpenStack database nodes.

The viocli recover command uses the following syntax.

viocli recover [-d NAME] {-n NODE1... | -r ROLE1... [-n NODE1...]} [-dn BACKUP] [-nfs NFS-VOLUME] [--verbose]

Parameter

Mandatory or Optional

Description

-d NAME or --deployment NAME

Optional

Name of the deployment to use.

If you do not enter a value, the default deployment is used.

-n, --node NODE

Mandatory unless -r is used.

Recovers one or more nodes. You can specify multiple nodes separated with commas.

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 command.

For example, the following command recovers two nodes from the specified NFS backup file.

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

-r ROLE or --role ROLE

Mandatory unless -n is used.

Recovers all nodes assigned to the specified role. You can specify multiple roles separated with commas. You can also specify -n or --node in the same command to recover additional nodes that are not assigned to that role.

To display the roles in your deployment, use the viocli show command. The supported role names differ by deployment type.

For a deployment in HA mode, the following values are supported:

  • ComputeDriver

  • Controller

  • DB

  • LoadBalancer

For a deployment in compact mode, the following values are supported:

  • ControlPlane

  • Compute

For a deployment in tiny mode, the following value is supported:

  • ControlPlane

For example, the following command recovers the nodes assigned to the DB role from the specified NFS backup file.

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

-dn BACKUP or --dir-name BACKUP

Mandatory for OpenStack database recovery

Folder containing the OpenStack database backup file. OpenStack database backups are in vio_os_db_yyyymmddhhmmss format.

-nfs NFS-VOLUME

Mandatory for certain configurations

Name or IP address of the target NFS volume and directory in the format remote-host:remote-dir.

For example: 192.168.1.77:/backups

This parameter is mandatory when recovering the following items:

  • For an HA deployment: the DB role or all three database nodes (VIO-DB-0, VIO-DB-1, and VIO-DB-2)

  • For a compact or tiny deployment: the ControlPlane role or the VIO-ControlPanel-0 node

--verbose

Optional

Displays output in verbose mode.

You can also run viocli recover -h or viocli recover --help to display the parameters for the command.