About Removing Hosts
In GroundWork Monitor you may need to delete a host or multiple host configurations, delete Cloud Hub associated hosts, or other types of monitored hosts. This page describes how to remove hosts based on the monitoring method used.
Like all configuration changes, you will need to perform a Commit operation, (Configuration > Nagios Monitoring > Control > Pre flight test > Commit), to complete the task of removing a host or hosts.
Deleting a Nagios Configured Host
Delete one host
- Go to Configuration > Nagios Monitoring > Hosts > Hosts.
- Locate the host you want to delete and select Detail.
- Scroll down to the bottom of the Manage Host screen and click Delete.
Delete multiple hosts
There is an easy way to delete one, many, or all hosts. The Delete hosts tool completely removes a host, its associated services, and any reference such a a membership in host groups, service groups, groups, and profiles.
- Go to Configuration > Nagios Monitoring > Hosts.
- Select Delete hosts.
- Next, in the Delete Hosts screen, using the drop-down box, select from the list of abbreviated host names and host addresses.
- For example, selecting " * " lists all hosts, and " 1* " will list all hosts with an IP address that starts with the number 1.
- Once a host abbreviation is chosen the matching hosts will be listed. Select the check box next to each host to be removed.
If you select the " * " filter to list all hosts and select Check All to remove all hosts, the system will consider this action as an invalid configuration with no hosts and services. This should be avoided.
Deleting Cloud Hub Hosts
Cloud Hub instances are the hosts that have been setup using the GroundWork Cloud Hub monitoring subsystem. Cloud Hub configuration, using hypervisors and or virtualization manager(s), performs various functions including auto discovery, creating of hosts and host groups, and applying of profiles. Completely removing previously set environments in Cloud Hub includes a command line entry, which is outlined below.
Over license limit
It is recommended to check your license limit prior to configuring Cloud Hub connections. If you need to delete Cloud Hub connectors and can't log in to GroundWork Monitor to do so because the addition of connectors created enough hosts to exceed your license hard limit, please see Cloud Hub Troubleshooting.
Stop monitoring and keep configuration
If you decide you do not want to monitor a particular region but you want to keep the configuration, simply:
- Navigate to Configuration > Cloud Hub.
- Select STOP for the corresponding connection. The connection, as previously configured, can be started again by selecting START.
Completely delete a configuration
To completely DELETE a specific region's monitored hosts follow the steps below. All of the created host groups and the discovered and monitored instances for that region will be deleted from the Foundation database within a few minutes and monitoring access to the region endpoint will cease.
- As an Administrator, go to Configuration > Cloud Hub.
- Select STOP and DELETE for each connection to be deleted.
Deleting GDMA Hosts
To remove GDMA hosts from being monitored in GroundWork Monitor you need to uninstall the agent on the client server.
Uninstall GDMA for Linux
- Access a command line interface for the Linux GDMA client server.
- Backup any custom plugins in the /usr/local/groundwork directory structure. You will need to move these to the new location.
Next, as root user, run the following script to uninstall the agent:
You will be prompted with the question Do you want to uninstall GroundWork Distributed Monitoring Agent and all of its modules?, confirm the uninstall.
Remove the groundwork sub-directory and all sub-directories:
rm -rf /usr/local/groundworkCODE
On the GroundWork server delete the GDMA client host within the Auto Registration host group, (Configuration > Nagios Monitoring > Hosts > Hosts > Auto-Registration > <hostname> > Detail > delete).
Uninstall GDMA for Windows
- Access the File Manager for the Windows GDMA client server.
- Backup any custom plugins in the C:\Program Files (x86)\groundwork directory structure. You will need to move these to the new location.
- Next, from the C:\Program Files (x86)\groundwork directory, select and run the uninstall.exe file. You will be prompted with the question Do you want to uninstall GroundWork Distributed Monitoring Agent and all of its modules?, answer Yes to uninstall and proceed.
- Using the File Manager remove the groundwork directory all all sub-directories.
- On the GroundWork server delete the GDMA client host within the Auto Registration host group.
Deleting WMI NRPE_NT Hosts
- On the Windows WMI client server, launch the Command Prompt and check if the NRPE_NT directory exists in the C: directory.
If the directory exists stop the service:
net stop nrpe_ntCODE
Then uninstall the service:
Next, navigate to Computer > Local Disk (C\:) > and delete the NRPE_NT directory.