Installing probes and gateways on Tivoli Netcool/OMNIbus V8.1

From Tivoli Netcool/OMNIbus V8.1 onwards, Tivoli Netcool/OMNIbus probes and 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 probe or gateway, you must have installed and configured Installation Manager and Tivoli Netcool/OMNIbus. To install probes and gateways, you must make sure that the Core Tivoli Netcool/OMNIbus features Probe Support and Gateway Support respectively are installed.

Installing probes and gateways using the Command Line Tool

To install the probe or 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 probe or 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.

The following is an example command used to install the SNMP Probe:

imcl -c install com.ibm.tivoli.omnibus.integrations.nco-p-mttrapd -repositories /home/my_home_dir/nco-p-mttrapd_im_package -installationDirecory /opt/IBM/tivoli/netcool

Where /home/my_home_dir/nco-p-mttrapd_im_package contains the unzipped contents of the SNMP Probe Installation Manager package.

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 probes and gateways using the Command Line Tool

To uninstall the probe or 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 probe or gateway that you want to uninstall.

The following is an example command used to uninstall the SNMP Probe:

imcl uninstall com.ibm.tivoli.omnibus.integrations.nco-p-mttrapd -installationDirecory /opt/IBM/tivoli/netcool

Installing probes and gateways using the GUI

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

  1. Unzip the IM package that contains the probe or 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 probe or gateway. This is the repository that contains the repository.config file.
  5. Click the Install software packages icon.
  6. Select the name of the probe or 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 probe or gateway, click Finish.

Uninstalling probes and gateways using the GUI

To uninstall the probe or 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 probe or 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 probe or gateway, click Finish.