Restoring configuration data

Edit online

Restore Event Analytics configuration data by configuring and running the NOI_EA_Import_Configuration Netcool®/Impact policy.

Before you begin

Before performing this operation, you must perform the following activities:
  1. Identify the following parameters:
    • Names of the Event Analytics configurations that you want to import.
    • Path to the directory where the data for these Event Analytics configurations is stored.
    To identify these parameters, review the following sections in the NOI_EA_Export_Configuration Netcool/Impact policy:
    • Configuration names section: lists the names of the Event Analytics configurations that were backed up.
    • Base directory section: contains the path to the directory where the data for these Event Analytics configurations is stored.
  2. Check the following items:
    • The backup logs to see when the backup was last run, and if it was successful.
    • The base directory, to ensure that the Event Analytics configuration data is present and intact.
      Note: The Event Analytics configuration data is stored in sub-directories of the base directory. For example, assume the base directory is /opt/IBM/tivoli/impact/ea_backup and you backed up the following four configurations:
      • Customer_Config-1
      • Customer_Config-2
      • Customer_Config-3
      • Customer_Config-4
      In this case the data for each configuration is stored as follows:
      Event Analytics configuration Data stored in the following directory
      Customer_Config-1 /opt/IBM/tivoli/impact/ea_backup/Customer_Config-1
      Customer_Config-2 /opt/IBM/tivoli/impact/ea_backup/Customer_Config-2
      Customer_Config-3 /opt/IBM/tivoli/impact/ea_backup/Customer_Config-3
      Customer_Config-4 /opt/IBM/tivoli/impact/ea_backup/Customer_Config-4
  3. Ensure that no one is logged onto and working in Event Analytics. For the Event Analyticsconfigurations that are being restored, the restore operation deletes each configuration prior to restoring it, so it is best that no one is working on the system while the restore operation is in progress.

You should also check the following items:

Procedure

  1. Log into the Netcool/Impact GUI.
  2. Navigate to the Policies tab.
  3. Locate the NOI_EA_Export_Configuration policy in the list, and open this policy.
  4. Locate the NOI_EA_Import_Configuration policy in the list, and open this policy.
  5. Copy the following sections from the NOI_EA_Export_Configuration policy to the NOI_EA_Import_Configuration policy:
    • The array of configuration names, in the Configuration Names section. Here are some examples of how this might be coded.
      Note: You can restore any number of configurations, from just one configuration up to all of your configurations.
      Example: Restore a single configuration
      Assume that you want to restore data associated with the following single configuration:
      • Customer_Config-1
      In this case, you must code the array as follows, ensuring that you maintain the single quotes.
      Configs = [ 'Customer_Config-1' ];
      Example: Restore multiple configurations
      Assume that you want to restore data associated with the following four configurations:
      • Customer_Config-1
      • Customer_Config-2
      • Customer_Config-3
      • Customer_Config-4
      In this case, you must code the array as follows, ensuring that you maintain the single quotes.
      Configs = [ 'Customer_Config-1', 'Customer_Config-2', 'Customer_Config-3', 'Customer_Config-4' ];
    • The file path of the base directory, in the Base Directory section
  6. Optional: By default the restore utility will restore both related event and seasonality data from each of the configurations specified in step 5. You can optionally specify which types of data you want to restore.
    • If you want to restore related event data only, then set these parameters:
      IS_RELATED_EVENT = true;
IS_SEASONALITY = false;
    • If you want to seasonality data only, then set these parameters:
      IS_RELATED_EVENT = false;
IS_SEASONALITY = true;
  7. Save and run the policy.
    Each of the configurations that you have defined to be restored is deleted and restored in turn. For this reason, the restore process takes significantly longer than the backup process.
  8. Monitor progress of the restore operation by performing the following operations:
    • Navigate to the /opt/IBM/tivoli/impact/ directory.
    • Run the following command to monitor the log file:
      tail -f logs/impactserver.log
  9. On conclusion of the restore operation, a message is displayed indicating that the operation was successful.
    The time taken for the operation depends on the amount of data being restored.