Restoring the database from a backup file using the CLI

Prev Next

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

To restore the database from a backup file:
  1. Go to CLI configuration mode.

    hostname > enable
    hostname # configure terminal
  2. 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
  3. Specify a backup profile.

    • To set the profile for the configuration database:

      hostname (config) # restore profile config
    • To set the profile for the appliance database:

      hostname (config) # restore profile fedb
    • To set the profile for both the configuration database and the appliance database:

      hostname (config) # restore profile config+fedb
    • To set the profile for the configuration database, appliance database, and detected data (malware, alerts, reports, and so on):

      hostname (config) # restore profile full
  4. Specify the location of the backup file.

    • To restore the backup from the local destination on the AX appliance:

      hostname (config) # restore profile <profile> from local 
    • To restore the backup from a remote server:

      hostname (config) # restore profile <profile> 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 profile command (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 <profile> from usb
  5. 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
  6. Enter the name of the backup file.

    hostname (config) # restore profile <profile> from <backupLocation> backup <name>
  7. (Optional) Restore the network settings from the relevant backup:

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

    Caution

    Do not restore the current network settings while the AX appliance is performing a restore operation from a remote server.

  8. (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 <profile> from <backupLocation> backup <name> progress no-track
    • To enable progress tracking for the restore operation:

      hostname (config) # restore profile <profile> 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 AX appliances as well.