Skip to main content

restore command

Use the restore command to restore the settings that are already saved in the file for the current server.

Note

  • To restore the saved settings, use the save command to save the configuration in the file containing <setting>=<value>.

  • For the ThinkEdge servers, to restore the SED AK whose SED key is not installed, use the passphrase or backup file.

  • To restore the configuration settings by using the backup file, the file should be an encrypted file saved with the backup command, the --redfish and --passphrase parameters.

  • Users can use the saved file got in the save command. If users create the file and specify with the --file option, follow the file format. For more information, refer to save command.

  • There may be a long list of settings in the outputs of restore command. Therefore, OneCLI puts the results including all saved settings in a file and shows the summary in the command shell.

restore command syntax

OneCli.exe config restore --file <filename> [<options>]
Table 1. restore command specific parameters
ParameterRequired/OptionalNotes
--fileOptional

  • Specify the configuration file name for restoring settings, which should be used with the save command.

  • Specify the encrypted file name for restoring SED AK or the backup settings, which should be used with the backup command.

--passphraseOptionalThe passphrase to recover SED AK or configuration settings.

  • Specify the password used in the generate command when recovering SED AK with the passphrase.

  • Specify the password used in the backup command when recovering SED AK or configuration settings with the backup file.

--incbackupctlOptionalInclude VPD settings when restoring from the external file specified by --file.
--kcsOptionalForce to use IPMI over KCS local interface.

  • --bmc, -b

  • --bmc-cim-port, -p

  • --bmc-username, -u

  • --bmc-password, -w

  • --check-trust, -C

  • --config

  • --node

  • --nolog

  • --never-check-trust, -N

  • --output, -o

  • --redfish

Optional

Refer to Table 2.

Example of the restore command

To restore with saved settings:

onecli.exe config restore --file saved.txt --bmc USERID:PASSW0RD@XX.XX.XX.XX

To restore SED AK only with passphrase that used to generate the SED AK:

OneCli.exe config restore Security.SED_AK --passphrase xxxxxx 
--bmc USERID:PASSW0RD@XX.XX.XX.XX --redfish

To restore SED AK with passphrase and backup file:

OneCli.exe config restore Security.SED_AK --passphrase xxxxxx 
--file backup.txt --bmc USERID:PASSW0RD@XX.XX.XX.XX --redfish

To restore configuration settings with backup file:

OneCli.exe config restore --passphrase xxxxxx --file backup.txt 
--bmc USERID:PASSW0RD@XX.XX.XX.XX --redfish