3.3. Uninstalling JBoss ON

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

3.3.1. Uninstalling an Agent on a Managed System

3.3.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.

3.3.1.2. Removing an Agent RPM

  1. Stop the agent service.
    [root@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:
    [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.2.0.GA jboss-on-agent-init-3.2.0.GA

3.3.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.

3.3.2. Uninstalling the Server

Removing a server still leaves the database and its information intact, so historic data remain available directly from the database itself.

3.3.2.1. Removing a Server on Red Hat Enterprise Linux

  1. If this is the only JBoss ON server, then stop all agents. If there will be other JBoss ON servers in the topology, then agents managed by this server will naturally migrate over to the other servers in the high availability topology.
  2. Stop the server.
    [root@server ~]# serverRoot/jon-server-3.2.0.GA/bin/rhqctl.sh stop --server
  3. Delete the server's installation directory.

3.3.2.2. Removing a Server on Windows

  1. If this is the only JBoss ON server, then stop all agents. If there will be other JBoss ON servers in the topology, then agents managed by this server will naturally migrate over to the other servers in the high availability topology.
  2. Stop the server.
    > C:\rhq\jon-server-3.2.0.GA\bin\rhqctl.bat stop
  3. If the server is configured as a Windows service, then remove it as a service.
    > C:\rhq\jon-server-3.2.0.GA\bin\rhqctl.bat remove
  4. Delete the server's installation directory.