Chapter 10. Uninstalling JBoss ON

Because both the JBoss Operations Network server and agent are extracted JAR files, removing a server or agent ultimately consists of simply deleting those files.

10.1. Uninstalling an Agent

10.1.1. Removing an Agent on Linux (JAR)

  1. Remove the platform entry from the JBoss ON server inventory.

    Important

    If the agent was configured, but the platform was never imported into the inventory, then you must import the platform from the discovery queue first, and then delete the platform. The discovery queue is a halfway point in the inventory. Even if the agent is removed, the platform could still linger in the discovery queue as a ghost entry.
  2. Stop the agent.
  3. Delete the agent's installation directory.

10.1.2. Removing an Agent RPM

  1. Remove the platform entry from the JBoss ON server inventory.

    Important

    If the agent was configured, but the platform was never imported into the inventory, then you must import the platform from the discovery queue first, and then delete the platform. The discovery queue is a halfway point in the inventory. Even if the agent is removed, the platform could still linger in the discovery queue as a ghost entry.
  2. Stop the agent service.
    [root@server ~]# service jon-agent stop
  3. If the package was installed using yum, then use the yum to remove the package:
    [root@server ~]# yum remove jboss-on-agent jboss-on-agent-init
    If the RPM package was installed using rpm, then uninstall it using rpm:
    [root@server ~]# rpm -e jboss-on-agent-3.1.2.0.GA1 jboss-on-agent-init-3.1.2.0.GA1

10.1.3. Removing an Agent on Windows

  1. Stop the agent.
  2. If the agent is configured as a Windows service, then remove it as a service.
    > rhq-agent.bat remove
  3. Delete the agent's installation directory.