Installing gateways on Tivoli Netcool/OMNIbus V8.1

From Tivoli Netcool/OMNIbus V8.1 onwards, Tivoli Netcool/OMNIbus gateways can be installed using the IBM Installation Manager. One of the key features of Installation Manager is that all platforms are shipped in a single ZIP file, which means that you do not have to select the platform that you require; Installation Manager does it for you.

Before you can install a gateway, you must have installed and configured Installation Manager and Tivoli Netcool/OMNIbus. To install gateways, you must make sure that the Core Tivoli Netcool/OMNIbus features Gateway Support is installed.

Installing gateways using the Command Line Tool

To install the gateway using the Command Line Tool, run the following command:

installation_manager_location/eclipse/tools/imcl -c install com.ibm.tivoli.omnibus.integrations.integration_name -repositories repository_containing_required_integration -installationDirectory location_of_netcool_omnibus_install_you_are_installing_into

Where integration_name specifies the name of the gateway that you want to install.

You will be prompted to agree to the terms and conditions of the license as a prerequisite for installing the integration. If you have already reviewed the license and want to skip the manual acceptance, add the -acceptLicense option to the install command to silently agree to the license.

Note: The command line tool does not add the repository permanently to the Installation Manager instance. If you subsequently start the Installation Manager GUI, the repositories will not be present in the Repositories dialog box.

Uninstalling gateways using the Command Line Tool

To uninstall the gateway using the Command Line Tool, run the following command:

installation_manager_location/eclipse/tools/imcl uninstall com.ibm.tivoli.omnibus.integrations.integration_name -installationDirectory location_of_netcool_omnibus_install_you_are_uninstalling_from

Where integration_name specifies the name of the gateway that you want to uninstall.

Installing gateways using the GUI

To install the gateway using the GUI, use the following steps:

  1. Unzip the IM package that contains the gateway into a directory of your choosing. A file called repository.config will appear after unzipping the IM package.
  2. Start Installation Manager using the following command:

    installer_path/IBMIM

    Where installer_path is the path to the Installation Manager directory.

  3. Perform the following menu actions to display the repository dialog box:

    Files > Preferences > Repositories.

  4. Use the button Add Repository in the repository dialog box to point to the repository that contains the unzipped IM package that contains the gateway. This is the repository that contains the repository.config file.
  5. Click the Install software packages icon.
  6. Select the name of the gateway that you want to install.
  7. Click Next.
  8. Click I accept when the Licensing panel appears.
  9. Highlight IBM Tivoli Netcool OMNIbus in the Package Group Name field.
  10. Click Next.
  11. Click Next.
  12. Click Install.
  13. When the Install Packages panel appears indicating that you have successfully installed the gateway, click Finish.

Uninstalling gateways using the GUI

To uninstall the gateway, use the following steps:

  1. Start Installation Manager using the following command:

    installer_path/IBMIM

    Where installer_path is the path to the Installation Manager directory.

  2. Click the Uninstall software packages icon.
  3. Select the name of the gateway that you want to uninstall.
  4. Click Next.
  5. Click Uninstall.
  6. When the Install Packages panel appears indicating that you have successfully uninstalled the gateway, click Finish.