Menu Close

Red Hat Training

A Red Hat training course is available for Red Hat JBoss Operations Network

Chapter 5. Uninstalling the JBoss ON Server

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

5.1. Uninstalling an Agent on a Managed System

5.1.1. Removing an Agent on Linux (JAR)

Note
This procedure is for removing a standalone agent. If the agent was installed with the JBoss ON server or storage node, then use the rhqctl script to stop and remove it.
  1. Stop the agent.
  2. Delete the agent from JBoss ON topology.
    1. In the JBoss ON UI, click the Administration tab in the top menu.
    2. In the Topology section in the left menu, select the Agents item.
    3. Select the row for the agent to delete, in the list of installed agents.
    4. Click the Delete button at the bottom of the page.
    5. Confirm that the agent should be deleted.
  3. On the managed system, delete the agent's installation directory.

5.1.2. Removing an Agent RPM

  1. Stop the agent service.
    [jsmith@server ~]# service jon-agent stop
  2. Delete the agent from JBoss ON topology.
    1. In the JBoss ON UI, click the Administration tab in the top menu.
    2. In the Topology section in the left menu, select the Agents item.
    3. Select the row for the agent to delete, in the list of installed agents.
    4. Click the Delete button at the bottom of the page.
    5. Confirm that the agent should be deleted.
  3. If the package was installed using yum, then use the yum to remove the package:
    [jsmith@server ~]# yum remove jboss-on-agent jboss-on-agent-init
    If the RPM package was installed using rpm, then uninstall it using rpm:
    [jsmith@server ~]# rpm -e jboss-on-agent-3.3.2.GA jboss-on-agent-init-3.3.2.GA

5.1.3. Removing an Agent on Windows

Note
This procedure is for removing a standalone agent. If the agent was installed with the JBoss ON server or storage node, then use the rhqctl script to stop and remove it.
  1. Stop the agent.
  2. Delete the agent from JBoss ON topology.
    1. In the JBoss ON UI, click the Administration tab in the top menu.
    2. In the Topology section in the left menu, select the Agents item.
    3. Select the row for the agent to delete, in the list of installed agents.
    4. Click the Delete button at the bottom of the page.
    5. Confirm that the agent should be deleted.
  3. If the agent is configured as a Windows service, then remove it as a service.
    > rhq-agent.bat remove
  4. Delete the agent's installation directory.