Loader

System Restore

 

System Backup Attributes 

Action

Value

Comment

Restore Run

 

Restore a database to the OLT.  The existing database will be destructively overwritten.

Inputs

 

Action Input Parameters

Confirm

Yes | No

Due to its destructive nature, the user is required to confirm that the restore should be performed.

Filename

<string>

The name of the file to be restored.  It is assumed to be in /usr/bob/sftp/restore.  The path can be explicitly stated if desired or just the filename and the path will be added automatically.

Mode

replace

Replace is the only allowed option.   

Password

<string>

The password to use when authenticating to a remote destination to retrieve a restore file to be restored to the OLT.

Scope

all | db | os-auth

all - Restore all olt information including db, and auth.
db - Restore just the database without other OS files.
os-auth - Restore just the user database to the OLT.

Source 

<string> When remote restore is utilized, it is used to specify the URL to use for retrieval of the restore file.  When a local restore is being performed, it can be used to specify a path if a path other than the default is needed.

Username

<string> The username to use to authenticate when pulling the restore file from a remote location.
Output <string> Result of the reboot action.
 

 

  • Command Path – tolt>system >restore>run>
  • Module – tolt
  • Container – system
  • Action – restore run
  • Container – input
  • Types – 
    • Confirm 
      • string
        • yes - Perform Restore action.
          no - Do not perform Restore action.
    • Filename – The filename on the target to name the backup.
      • string
        • No extension - Defaults to tgz and includes all data.
          filename.cli – Output backup in the CLI format.
          filename.xml – Output backup in XML format.
          filename.json – Output backup of JSON format.
    • *Mode – The path on the target for the backup file, .
      • replace
        • replace all targeted data in the database, 
    • Password – The password to use when authenticating to the remote server to download the restore file.
      • String
    • Source – The URL to use to pull the restore file from the remote location to the OLT.  Any valid URL string can be used for pulling this information to the OLT.
      • String - Any valid curl string.
    • Username – The username to use when doing remote backups to an sftp or http destination.
      • String

Tolt System restore list-local-files

The following example will demonstrate a restore from the local sftp directory on the OLT.  

  • Command Path – tolt>system >restore>list-local-files>
  • Module – tolt
  • Container system
  • Container restore
  • Action list-local-files
  • Types – Example Parameters
    • N/A

Local Backup

  1. Go to the MDS1-ESUA# command line, input tolt system restore list-local-files, and press Enter. Output similar to the following is displayed.  Each resulting entry gives a file name.  The files are shown on the default path of /usr/bob/sftp/backups
 
MDS1-ESUA# tolt system restore list-local-files <enter>
result backup-4-10-26.tgz
result test1.xml
action-success true
MDS1-ESUA# _ 

 

Tolt System Restore Run

The following example will demonstrate a restore from the local sftp directory on the OLT.  

  • Command Path – tolt>system >restore>run>
  • Module – tolt
  • Container system
  • Container restore
  • Action run
  • Types – Example Parameters
    • filename backup-4-10-26.tgz confirm yes

System Restore Run

  1. Go to the MDS1-ESUA# command line, input tolt system restore run filename backup-4-10-26.tgz, and press Enter. Output similar to the following is displayed.
 
MDS1-ESUA# tolt system restore run filename backup-4-10-26.tgz <enter>
Value for 'confirm' [YES]: YES <enter>
reason Restore completed successfully from backup-4-10-26.tgz
action-success true
MDS1-ESUA# _ 

 

FEEDBACK: Are you happy with this material?