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.
- Stop the agent.
- Delete the agent from JBoss ON topology.
- In the JBoss ON UI, click the Administration tab in the top menu.
- In the Topology section in the left menu, select the Agents item.
- Select the row for the agent to delete, in the list of installed agents.
- Click the Delete button at the bottom of the page.
- Confirm that the agent should be deleted.
- On the managed system, delete the agent's installation directory.
5.1.2. Removing an Agent RPM
- Stop the agent service.
[jsmith@server ~]# service jon-agent stop
- Delete the agent from JBoss ON topology.
- In the JBoss ON UI, click the Administration tab in the top menu.
- In the Topology section in the left menu, select the Agents item.
- Select the row for the agent to delete, in the list of installed agents.
- Click the Delete button at the bottom of the page.
- Confirm that the agent should be deleted.
- 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.
- Stop the agent.
- Delete the agent from JBoss ON topology.
- In the JBoss ON UI, click the Administration tab in the top menu.
- In the Topology section in the left menu, select the Agents item.
- Select the row for the agent to delete, in the list of installed agents.
- Click the Delete button at the bottom of the page.
- Confirm that the agent should be deleted.
- If the agent is configured as a Windows service, then remove it as a service.
> rhq-agent.bat remove
- Delete the agent's installation directory.
