restore command

Use the restore command to restore all settings that are defined in the update configuration file on the server.

On IMM-based servers, the backup control settings are not restored by default. To restore the backup control settings on an IMM-based server, you must specify the -incbackupctl modifier (refer to the section Command modifiers for specific syntax.

Limitations

During a restore operation, settings that are defined in the password and authentication classes are not restored. To list the settings that belong to either the password or authentication class, use the following command:
asu showvalues authentication
To list only the password class settings, use the following command:
asu showvalues password

During a restore operation, the ASU does not delete settings that might exist on the target server that is being restored and that are not included in the restore file.

The restore command restores the values that are defined in the restore file for those settings that exist in the target system. Therefore, the restore operation should be viewed as restoring values and not as a system settings restore command.

Syntax

The syntax of the restore command is
asu restore file_name [--incbackupctl ] [-nx] [connect_options]
where

file_name is the name of the file that was created by a previous asu save command or by redirecting the output of a previous asu show command to a file.

Notes

  1. The optional -incbackupctl parameter is used on a restore operation to specify whether the settings defined by the backupctl class are to be included. To list the backcupctl class, use the show, command and specify the backupctl class.
  2. The connect options are defined for IMM-based servers only. The --host ip_address, --user user_id, and --password password connect options are all required if you connect remotely to the IMM. The default user and password will not support an out-of-band connection now. The --mtsn, --net, --user, and --password options can be used to connect to IMM-based servers if the server running ASU and the target IMM-based servers are in one LAN. The --user user_id and --password password connect options are not required if you are using the local KCS interface.

Output

Each setting and the restored value are displayed.
<setting 1>=<value 1>
<setting 2>=<value 2>




<setting n>=<value n>

The restore command and corresponding output are shown in the following example.

Command line (IMM-based servers):
 asu restore rep.data
rep.data file (Show or save output file):
uEFI.Com1BaudRate=115200
uEFI.Com1DataBits=8
uEFI.Com1Parity=None
uEFI.Com1StopBits=1
uEFI.Com1TextEmul=VT100
uEFI.Com1ActiveAfterBoot=Enable
uEFI.Com1FlowControl=Disable
Output:
uEFI.Com1BaudRate=115200
uEFI.Com1DataBits=8
uEFI.Com1Parity=None
uEFI.Com1StopBits=1
uEFI.Com1TextEmul=VT100
uEFI.Com1ActiveAfterBoot=Enable
uEFI.Com1FlowControl=Disable
Command line (BIOS-based servers):
asu restore rep.data
rep.data file (Show or save output file):
CMOS_CRTRequired=Enabled
CMOS_KbdRequired=Enabled




CMOS_OSUSBControl=Other OS
Output:
CMOS_CRTRequired=Enabled
CMOS_KbdRequired=Enabled




CMOS_OSUSBControl=Other OS
Note: The output is identical to the save or show output file that is used as input in the restore command.