Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

system database restore

 

Syntax

Release Information

The factory-default and remote options were introduced prior to release 2.1.1.

Starting with release 2.1.1, the local option is supported for the BTI7801.

Starting with release 4.2, the retain-ip option is supported.

Starting with release 4.2, you are allowed to restore the database from a file with any filename.

Starting with release 4.2, you can restore the database from any backup as long as the backup is for a chassis of the same type (BTI7801 to BTI7801, BTI7802 to BTI7802, BTI7814 to BTI7814).

Description

This command restores the system to a backed-up database or to the factory-default database.

Options

Parameter

Description

Range

Default Value

factory-default

This restores the factory-default database.

local

This restores the backed-up database from local chassis storage.

This option is only available for the BTI7801 chassis.

remote protocol:url

This restores the backed-up database found at the specified location.

Starting with release 4.2, you are allowed to restore the database from a backed-up database file whose filename has been changed from the original filename assigned by the system during the backup operation. In earlier releases, you can only restore the database from a file whose filename is unchanged from the filename assigned by the system during the backup operation.

Starting with release 4.2, you can restore from any backup as long as the backup configuration is for a chassis of the same chassis type. In earlier releases, you can only restore the database to the same chassis from which the database was backed up.

sftp|ftp://
[username@]host
[:port]/filename

username is the username to use on the remote server.

host is the host name or IP address of the remote server.

port is the protocol port number to use.

filename is the filepath and name of the configuration database file that you want to restore.

If username is not specified, the current CLI session’s login name is used.

If port is not specified, the standard default FTP or SFTP port is used.

password password

The password associated with the specified username.

If a password is not specified, the system prompts you for a password.

Note: The password must contain alphanumeric characters only.

A character string

None

retain-ip true | false

Specify whether you want to retain the following existing settings when restoring a database from a different chassis: system name, system mgmt-address, system gateway-address, system controller-1 static-address, system controller-2 static-address.

true: retain existing settings

false: overwrite settings

false

Additional Information

This procedure is service-affecting. The system performs an automatic cold reload of all modules immediately after restoring the database.

Software-based features on service modules (such as PM collection, APSD, APR, FSPD) are disabled temporarily as part of this procedure.

Required Privilege Level

Sample Output

bti7800# system database restore factory-default
bti7800# system database restore remote sftp://user@10.1.1.1/backups/10.75.0.5_BTI7800v2.0.0_22508_20160217_175219.tar.gz