Importing the data

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

Before you begin

  1. 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.
  2. Copy the data.zip file from the source server to the directory JazzSM_HOME/ui/input on the target server.

Procedure

To import the data from the .zip file to the target server:

  1. As supplied, the utility writes information, warning, and error messages to the log file. Change the level of logging, if required.
    Note: Recommended values are FINE, FINER, and FINEST. Each of these produces increasing numbers of messages. They can be helpful when diagnosing a problem in the import utility. After using one of these values, however, be sure to return to the original value before recommencing normal operations on the server.
  2. Navigate to the directory containing the utility, JazzSM_HOME/ui/bin.
  3. Enter one of the following commands to import the data:

    For UNIX operating systemFor Linux operating system./consolecli.sh Import --username smadmin --password password --excludePlugins ImportPagePlugin,ChartImportPlugin --settingFile WEBGUI_HOME/integration/importexport_tool/etc/OMNIbusWebGUI_settings.properties

    For Windows operating systemconsolecli.bat Import --username smadmin --password password --excludePlugins ImportPagePlugin,ChartImportPlugin --settingFile WEBGUI_HOME\integration\importexport_tool\etc\OMNIbusWebGUI_settings.properties

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

    To exclude any plug-ins from the import operation, add their names to the --excludePlugins qualifier, putting a comma between each plug in name. For example, to exclude the prompt plug-in, use:

    --excludePlugins ImportPagePlugin,ChartImportPlugin,ImportPromptPlugin

    Always include the ImportPagePlugin and ChartImportPlugin in the list.

    Note: To obtain a list of plug-in names that can be excluded from the import operation, enter the following command: ./consolecli.sh ListImportPlugins
  4. Restart the Dashboard Application Services Hub server.

    You need to restart the server if your site does not use timed tasks or you have imported a key system file such as server.init or ncwDataSourceDefinitions.xml.