Restoring a Versioned Configuration from an archive (ConfigRestore)

To restore a versioned configuration from an archive, specify the ConfigRestore keyword when executing the icosutil utility. This keyword executes the ConfigRestore utility with the options specified on the command line. One of these options is the properties file (configArchivingUtility.properties).

Note: To avoid possible corruption issues, only the original unchanged archive files can be loaded into the system using the ConfigRestore utility.

Syntax

./icosutil ConfigRestore -f /opt/IBM/tivoli/netcool/ncm/config/properties/
configArchivingUtility.properties -archiveName gzipped_xmlfilename

Description

The ConfigRestore utility restores the specified versioned configuration from an archive. The ConfigRestore utility pulls the required information from the gzip XML file specified in gzipped_xmlfilename and restores the versioned configuration using the ITNCM Server criteria specified in the workArchivingUtility.properties file. By default, the workArchivingUtility.properties file resides in the /opt/IBM/tivoli/netcool/ncm/config/properties directory.

Restored configuration versions are presented in the GUI in the exact same state as the configuration version had when it was archived. Configuration versions are restored with same internal identifier values as the archived configuration had, this means it is not suitable for exporting/importing to different installations.

In order to perform Archive restoring, the user must belong to a group with the Manage Archive activity.

Parameters

ConfigRestore: Specifies the keyword that instructs the icosutil utility to execute the ConfigRestore utility. The ConfigRestore utility proceeds to restore the versioned configuration.
-f: Specifies an option when using the ConfigRestore keyword.
configArchivingUtility.properties: Argument for the ‘f’ option. Specifies the configArchivingUtility.properties file that defines the ITNCM Server criteria that the ConfigRestore utility uses to restore versioned configuration from an archive.
-archiveName: Specifies the name of the archive that contains the versioned configuration that you want to restore. The location of the archive does not have to be specified. Information about the location of the archive is stored(at time of archiving) internally in ITNCM. If the archive is not in the location stored internally in ITNCM then the ConfigRestore utility will attempt to load the archive from the current executing directory.
gzipped_xmlfilename: Specifies the name of the gzip XML file that the ConfigRestore utility uses to pull the required information.