Importing the data

Import the data from the .zip file to the target server.

Import Web GUI and Dashboard Application Services Hub data

Before you begin

To prevent the loss of information in the event of a disaster, and for disaster recovery, back up your installation of the Web GUI and the Dashboard Application Services Hub.

Procedure

  1. Copy data.zip from the source server to the directory JazzSM_HOME/ui/input on the target server.
  2. On the target server make sure that you are logged in as an administrative user and that the Dashboard Application Services Hub server is running.
  3. As supplied, the utility writes information, warning, and error messages to the log file. Change the level of logging, if required.
  4. If your installation of the Web GUI does not use the default location:
    1. Navigate to the directory WEBGUI_HOME/integration/plugins.
    2. Edit the file OMNIbusWebGUI_clone_settings.properties.
    3. Locate the following line

      JazzSM.cell.name=

    4. After this line, add the following line:

      product.home=WEBGUI_HOME

      Replace WEBGUI_HOME with the actual installation directory of the Web GUI.

    Note: The default installation directory of the Web GUI is one of the following:
    • For UNIX operating systemFor Linux operating system /opt/IBM/netcool/gui/omnibus_webgui
    • For Windows operating system C:\Program Files\IBM\netcool\gui\omnibus_webgui
  5. Navigate to the directory containing the utility, JazzSM_HOME/ui/bin.
  6. Enter one of the following commands to import the data:

    For UNIX operating systemFor Linux operating system./consolecli.sh Import --username smadmin --password password --settingFile WEBGUI_HOME/integration/plugins/OMNIbusWebGUI_DASH_clone.properties

    For Windows operating systemconsolecli.bat Import --username smadmin --password password --settingFile WEBGUI_HOME\integration\plugins\OMNIbusWebGUI_DASH_clone.properties

    Replace smadmin and password with the user name and password of the Dashboard Application Services Hub administrative user.

  7. Verify that the utility has added or updated files as required:
    1. Check the log file, JazzSM_HOME/ui/logs/consolecli.log, and ensure there were no errors.
    2. Verify that backup copies of the original files on the target server are in a .zip file in JazzSM_WAS_Profile/ui/backups.
  8. Optional: Edit the ncwDataSourceDefinitions.xml file and apply any settings you want to copy over from the existing source server.
  9. Restart the Dashboard Application Services Hub server.
    Note: If target server is part of a load balancing cluster, wait until the next timed task schedule completes before restarting the server. This ensures that the imported data is replicated to other nodes in the cluster and the data base.

Import Web GUI data only

Procedure

  1. Copy data.zip from the source server to the directory JazzSM_HOME/ui/input on the target server.
  2. On the target server make sure that you are logged in as an administrative user and that the Dashboard Application Services Hub server is running.
  3. As supplied, the utility writes information, warning, and error messages to the log file. Change the level of logging, if required.
  4. If your installation of the Web GUI does not use the default location:
    1. Navigate to the directory WEBGUI_HOME/integration/plugins.
    2. Edit the file OMNIbusWebGUI_clone_settings.properties.
    3. Locate the following line

      JazzSM.cell.name=

    4. After this line, add the following line:

      product.home=WEBGUI_HOME

      Replace WEBGUI_HOME with the actual installation directory of the Web GUI.

    Note: The default installation directory of the Web GUI is one of the following:
    • For UNIX operating systemFor Linux operating system /opt/IBM/netcool/gui/omnibus_webgui
    • For Windows operating system C:\Program Files\IBM\netcool\gui\omnibus_webgui
  5. Navigate to the directory containing the utility, JazzSM_HOME/ui/bin.
  6. Enter one of the following commands to import the data:

    For UNIX operating systemFor Linux operating system./consolecli.sh Import --username smadmin --password password --settingFile WEBGUI_HOME/integration/plugins/OMNIbusWebGUI_clone_settings.properties

    For Windows operating systemconsolecli.bat Import --username smadmin --password password --settingFile WEBGUI_HOME\integration\plugins\OMNIbusWebGUI_clone_settings.properties

    Replace smadmin and password with the user name and password of the Dashboard Application Services Hub administrative user.

  7. Verify that the utility has added or updated files as required:
    1. Check the log file, JazzSM_HOME/ui/logs/consolecli.log, and ensure there were no errors.
    2. Verify that backup copies of the original files on the target server are in a .zip file in JazzSM_WAS_Profile/ui/backups.
  8. Optional: Edit the ncwDataSourceDefinitions.xml file and apply any settings you want to copy over from the existing source server.
  9. Restart the Dashboard Application Services Hub server.
    Note: If target server is part of a load balancing cluster, wait until the next timed task schedule completes before restarting the server. This ensures that the imported data is replicated to other nodes in the cluster and the data base.