Uninstalling the Hybrid Gateway

If you no longer want to view the IBM® Tivoli® Monitoring managed systems in the Cloud APM console, uninstall the IBM Cloud Application Performance Management Hybrid Gateway.

Procedure

  1. In the Hybrid Gateway install_dir/hybridgateway/bin directory (such as /opt/ibm/hybridgateway/bin), run the following command:
    ./hybridgateway.sh uninstall
    The Hybrid Gateway is removed and a message confirms that it has been uninstalled successfully. If you have any applications in the Cloud APM console that include hybrid agents, the hybrid agents continue to appear until the monitoring infrastructure processes their removal.
  2. In the Cloud APM console, Click System Configuration > Hybrid Gateway Manager.
  3. Select the Hybrid Gateway profile that you no longer want and click Delete.
    After you confirm that you want to delete the Hybrid Gateway, the profile is permanently removed.

What to do next

  • To remove any hybrid agent managed systems from an application in the Cloud APM console, follow the instructions in Managing applications for editing an application.
  • If, instead of successful removal of the software, you get an error message similar to the one shown in this example, review the log file for the possible causes:
    error: Failed dependencies:
    ibm-java-x86_64-jre is needed by (installed) smai-kafka-00.08.00.00-1.el6.x86_64
    Uninstallation failed. The uninstaller was unable to remove some of the components, 
    please inspect the log file ("/tmp/hybridgateway/logs/uninstall-hybridgateway-20150228080551.log") 
    for more information.
    The error shown in the example occurred because the ibm-java-x86_64-jre is required by an externally installed package on the system. The installer does not remove the JRE because it would likely render the other package nonfunctional. As a workaround, uninstall the products with the dependency on ibm-java-x86-64-jre before uninstalling the Hybrid Gateway.