Restore the Oracle ILOM Backup XML File

System administrators can perform a Restore operation to retrieve the XML file from a remote system, parse the contents, and update the SP with the backed-up configuration data. Upon initiating a Restore operation, all Oracle ILOM client sessions to the restoring server SP are momentarily suspended. The suspended sessions resume to normal after the Restore operation completes. A Restore operation typically takes two to three minutes to complete.

Before You Begin

To perform a configuration restore operation in Oracle ILOM, the Administrator (administrator) profile role is required or the following user roles must be assigned: Admin (a), User Management (u), Console (c) Reset and Host Control (r) and Read Only (o).
For further details, see User Role Required for Backing Up or Restoring the Oracle ILOM Configuration .
Sensitive data in the backup file taken from Oracle ILOM firmware 3.2.1+ versions can not be restored to an Oracle system running firmware prior to Oracle ILOM 3.2.1.

The following Oracle ILOM configuration restore procedure provides both web and CLI instructions for the SP.

To restore the backed up Oracle ILOM configuration XML file, perform the following steps for one of the Oracle ILOM user interfaces listed.

Oracle ILOM User Interface Restoring a Backup Copy of the Oracle ILOM Configuration Settings

Oracle ILOM User Interface	Restoring a Backup Copy of the Oracle ILOM Configuration Settings
Web	Click ILOM Administration > Configuration Management > Backup/Restore. Click Restore in the Operations box. (Optional) Select the Include Fault Data check box. When selected, the restore operation will include all fault data incidents in the restored xml configuration file. The Include Fault Data check box is available for configuration as of Oracle ILOM firmware 3.2.6. Note – A passphrase must be provided to restore fault data. For further details about entering a passphrase, see Step 5 below. Click the Transfer Method box to specify a method for transferring the Oracle ILOM configuration file. For property descriptions of each file transfer method, see File Transfer Methods . If the backup configuration file was encrypted with a passphrase, type the passphrase in the Passphrase text box, and then retype the passphrase in the Confirm Passphrase text box. Note – The passphrase entered must match the passphrase used to encrypt the backup configuration file. The passphrase length must be a minimum of 16 characters. Click Run to initiate the Restore operation. When the Restore operation is executing, client sessions to the Oracle ILOM SP are momentarily suspended. The sessions will resume to normal after the Restore operation is complete.
CLI	Navigate to the `config` CLI target, for example: `cd /SP/config` (Optional) To restore previously backed up fault data in the xml configuration file, set the property value for `include_faultdata` to `true`. For instance: `set include_faultdata=true` The `include_faultdata` property is available for configuration as of Oracle ILOM firmware version 3.2.6. Note – A passphrase must be provided to restore fault data in the xml configuration file. For further details about entering a passphrase, see Step 3 below. If the backup configuration file was encrypted with a passphrase, set the value for the passphrase property to the passphrase used to encrypt the file, for example: `set passphrase=value` Note – The passphrase entered must match the passphrase used to encrypt the backup configuration file. The passphrase length must be a minimum of 16 characters. To initiate the Restore operation, type the following command from within the `/SP/config`. For example: `set load_uri=transfer_method://username:password@ipaddress_or_hostname/directorypath/filename` Where the transfer method can be:tftp, ftp, sftp, scp, http, or https. For property descriptions of each file transfer method, see File Transfer Methods . For example: set load_uri=scp://adminuser:userpswd@198.51.100.4/Backup/Lab9/SP123.config When the Restore operation is executing, client sessions to the Oracle ILOM SP are momentarily suspended. The sessions will resume to normal after the Restore operation is complete.

Web

Click ILOM Administration > Configuration Management > Backup/Restore.
Click Restore in the Operations box.
(Optional) Select the Include Fault Data check box. When selected, the restore operation will include all fault data incidents in the restored xml configuration file.
The Include Fault Data check box is available for configuration as of Oracle ILOM firmware 3.2.6.

Note – A passphrase must be provided to restore fault data. For further details about entering a passphrase, see Step 5 below.
Click the Transfer Method box to specify a method for transferring the Oracle ILOM configuration file.
For property descriptions of each file transfer method, see File Transfer Methods .
If the backup configuration file was encrypted with a passphrase, type the passphrase in the Passphrase text box, and then retype the passphrase in the Confirm Passphrase text box.
Note – The passphrase entered must match the passphrase used to encrypt the backup configuration file. The passphrase length must be a minimum of 16 characters.
Click Run to initiate the Restore operation.
When the Restore operation is executing, client sessions to the Oracle ILOM SP are momentarily suspended. The sessions will resume to normal after the Restore operation is complete.

CLI

Navigate to the config CLI target, for example:
cd /SP/config
(Optional) To restore previously backed up fault data in the xml configuration file, set the property value for include_faultdata to true. For instance:
set include_faultdata=true

The include_faultdata property is available for configuration as of Oracle ILOM firmware version 3.2.6.

Note – A passphrase must be provided to restore fault data in the xml configuration file. For further details about entering a passphrase, see Step 3 below.
If the backup configuration file was encrypted with a passphrase, set the value for the passphrase property to the passphrase used to encrypt the file, for example:
set passphrase=value

Note – The passphrase entered must match the passphrase used to encrypt the backup configuration file. The passphrase length must be a minimum of 16 characters.
To initiate the Restore operation, type the following command from within the /SP/config. For example:
set load_uri=transfer_method://username:password@ipaddress_or_hostname/directorypath/filename

Where the transfer method can be:tftp, ftp, sftp, scp, http, or https.

For property descriptions of each file transfer method, see File Transfer Methods .

For example:

set load_uri=scp://adminuser:userpswd@198.51.100.4/Backup/Lab9/SP123.config

When the Restore operation is executing, client sessions to the Oracle ILOM SP are momentarily suspended. The sessions will resume to normal after the Restore operation is complete.

Related Information: