db-restore — restores the Brightmail databases to an appliance from previously created backups on the appliance or from remote locations with FTP and SCP
db-restore [--force --list --help] file
The db-restore command restores Brightmail databases to an appliance from a single, previously created backup. These are the backups that you have previously generated and saved on the appliance or from remote locations with FTP and SCP. If you attempt to run more than one instance of db-restore at a time, an error results. If any part of the operation fails, db-restore fails, and an explanatory message appears on the command line. You must be on the Control Center host to use the db-restore command.
Restoring an appliance immediately after resetting the appliance to its factory default might leave the appliance in an unusable state. Therefore, you must complete the site setup before restoring an appliance that is reset to its factory default.
When you restore a database backup on a different appliance than it was created, keep in mind the following considerations:
If you restore the appliance from a backup that was taken on a different appliance, the restored appliance does not affect the configuration settings on the new host. However, the virtual IP addresses are not created during the configuration. Virtual IPs defined in the old Control Center host are mapped by default to an interface on the new Control Center host. You can avoid the mapping of virtual IPs from the old Control Center host to the interface on the new Control Center host by completing the site setup. Alternatively, you can create the virtual IPs on the new Control Center host after the restore.
If you attempt to restore a backup to an appliance other than the one on which it was created, you must restart the appliance.
Stop the Control Center while this operation runs. Restart it when the restore has completed.
Force a restore even when the version of appliance software in the backup file differs from the software that is currently on the appliance.
List the backup files that are stored on the appliance.
Display this message.
Specify file with one of the following formats. If the file is stored on a remote computer, specify the directory path to the file.
Type the file name without the FTP or SCP prefix to specify a backup that is stored locally.
Copy files from their remote location with FTP.
Logon is attempted with the user name and password credentials that you provide on the command line. If special characters are included in the password, enclose the password in single quotes ('). If the special characters in a password include a single quote, you can use the double quote instead ("). If no credentials are specified, anonymous logon is used. Error checking ensures that the copies are complete.
Copy the backup file from its remote location with SCP. A complete path, file name, and user name are required when you specify a backup file through SCP. You are prompted for a password for the user name that you specify. Return codes are checked to ensure that the entire backup file is copied from the remote host. The script exits with non-zero status on failure. If the script fails, an error message appears. Error checking ensures that the copies are complete.