Upgrading probes from a test fix

All probes are upgraded using the deployment engine (DE). The DE handles the installation process, but before the DE can install an upgraded version of a probe from a test fix with the same version number, the older version of the probe must be uninstalled. For example, upgrading from test fix version 1.20.30 to GA version 1.20.30.

Uninstalling probes is a complicated task and should only be attempted when necessary due to some of the following complications.
  • The uninstall command will also remove any prerequisites that were installed with the probe, but if the prerequisites were installed separately then the prerequisites must be removed separately.
  • If a prerequisite is used by more than one probe, it will not uninstall.
To upgrade a probe from a test fix on UNIX and Linux operating systems, use the following steps:
  1. Ensure you are using the same user profile under which the DE is installed. The owner of the $OMNIHOME directory will also be the owner of the DE. Use the following command to display the $OMNIHOME owner:

    cd $OMNIHOME ; ls -ltr

  2. Switch to this user profile using the command:

    su -username

  3. Make a backup of any existing configuration files that you might already have for an earlier version of the probe and that you want to retain. For example; probe.props, probe.rules or probe.env. These files will usually be located in the following folder:

    $OMNIHOME/probes/arch

  4. Remove the probe using the uninstall command in the $NCHOME/_uninst/ directory:

    $NCHOME/_uninst/probe/uninstall

    Where probe is the probe you wish to uninstall.

    Note: This command does not remove configuration files which were modified when configuring the probe. These configuration files must be manually removed.
  5. Remove the configuration files that you backed up in step 3.
  6. Install the updated probe using the installation package.

    The installation package contains the appropriate files for all supported versions of Netcool/OMNIbus. For details about how to install the probe to run with your version of Netcool/OMNIbus, see:

    Installing the installation package

To upgrade a probe from a test fix on a Windows operating systems, use the following steps:
  1. Ensure you are using the same user profile under which the DE is installed. The owner of the %OMNIHOME% directory will also be the owner of the DE.
  2. Make a backup of any existing configuration files that you might already have for an earlier version of the probe and that you want to retain. For example; probe.props, probe.rules or probe.env. These files will usually be located in the following folder:

    %OMNIHOME%\probes\win32

  3. Remove the probe using the uninstall command in the %NCIHOME%\_uninst\ directory.

    %NCHOME%\_uninst\probe\uninstall

    Where probe is the probe you wish to uninstall.

    Note: This command does not remove configuration files which were modified when configuring the probe. These configuration files must be manually removed.
  4. Remove the configuration files that you backed up in step 3.
  5. Install the updated probe using the installation package.

    The installation package contains the appropriate files for all supported versions of Netcool/OMNIbus. For details about how to install the probe to run with your version of Netcool/OMNIbus, see:

    Installing the installation package