Go to main content

Oracle® ILOM Administrator's Guide for Configuration and Maintenance Firmware Release 3.2.x

Exit Print View

Updated: November 2019
 
 

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 (or CMM) with the backed-up configuration data. Upon initiating a Restore operation, all Oracle ILOM client sessions to the restoring server SP or CMM 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 and the CMM.

  • 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
    Web
    1. Click ILOM Administration > Configuration Management > Backup/Restore.

    2. Click Restore in the Operations box.

    3. (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.

    4. 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 Figure 14, Table 14, File Transfer Methods .

    5. 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.

    6. Click Run to initiate the Restore operation.

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

    CLI
    1. Navigate to the config CLI target, for example:

      cd /SP/config

      cd /CMM/config

    2. (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.

    3. 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.

    4. To initiate the Restore operation, type the following command from within the /SP/config or /CMM/config directory. 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 Figure 14, Table 14, 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 or the CMM are momentarily suspended. The sessions will resume to normal after the Restore operation is complete.

Related Information: