Restoring the database from a backup file using the CLI

Use the commands in this section to restore the database from a backup file.

To restore the database from a backup file:

Go to CLI configuration mode.

hostname > enable
hostname # configure terminal

Locate the backup FEBKP file you want to restore.
- To display a list of the backup files on the USB drive:
```
hostname (config) # show backup available on-usb
```
- To display a list of the backup files:
```
hostname (config) # show backup available local
```

Specify the configuration database profile:

hostname (config) # restore profile config

Specify the location of the backup file.
- To restore the backup from the local destination on the Central Management System appliance:
```
hostname (config) # restore profile config from local
```
- To restore the backup from a remote server:
```
hostname (config) # restore profile config from <url>
```
  where <url> specifies remote server Administrator credentials (<username> and <password>), the remote server (<hostname>), and the full path of the backup file (<filepath>) in the following format:
```
{scp|sftp}://<username>[:<password>]@<hostname>/<filepath>
```
  Note
  If you do not specify the remote host administrator password in the restore profilecommand (where the password would be visible as clear text), the CLI prompts for the password and obfuscates the keyboard input as you type it.
- To restore the backup from a USB drive on your local machine:
```
hostname (config) # restore profile config from usb
```

Enter the name of the backup file.

hostname (config) # restore profile config from <backupLocation> backup <name>

(Optional) Restore the network settings from the relevant backup:
```
hostname (config) # restore profile config from <backupLocation> backup <name> include-network-config
```
Caution
Do not restore the current network settings while the CMS appliance is performing a restore operation from a remote server.
(Optional) Monitor the progress of the restore operation. Progress tracking is enabled by default.
- To disable progress tracking for the restore operation:
```
hostname (config) # restore profile config from <backupLocation> backup <name> progress no-track
```
- To enable progress tracking for the restore operation:
```
hostname (config) # restore profile config from <backupLocation> backup <name> progress track
```
  You can cancel progress tracking by using Ctrl+C. The restore operation still happens in the background. Use the show restore status command to find the status of the restore operation.

Example

The following example shows how to restore a configuration database backup from local on an appliance.

hostname (config) # restore profile config from local backup vx-Config-7.9.0-vx-2-20160802-239500.febkp
Password (if required): ********
Step 1 of 4:  Performing Sanity checks
 100.0%  [##################################################################]
Step 2 of 4:  Extracting backup package
 100.0%  [##################################################################]
Step 3 of 4:  Restoring config db
 100.0%  [##################################################################]
Step 4 of 4:  Restart system services
 100.0%  [##################################################################]

Note

This example is from a Intelligent Virtual Execution - Server appliance, but it is representative of CMS appliances as well.