View Source

h1. Deleting and Removing Hosts

In GroundWork Monitor you may want to delete a host configuration, delete multiple host configurations, remove Cloud Hub or Cacti associated hosts or remove hosts from the performance screen. Each of these procedures are outlined below.

h4. How to delete a host configuration

Perform the steps below to remove a single host configuration.
# Go to *Configuration* > *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*.

h4. How to delete multiple host configurations

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* > *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.
# Select *Delete*.
{note}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.{note}
{note}Like all configuration changes, you will need to perform a _Commit_ operation (*Configuration* > *Control* > *Commit*), to complete the task of removing a host.{note}


h4. How to delete GroundWork Hub hosts

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

If you decide you do not want to monitor a particular region but you want to keep the configuration, simply navigate to *GroundWork Administration* > *GroundWork Cloud Hub* and select *STOP* for the corresponding connection. The connection, as previously configured, can be started again by selecting *START*.

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.

# Log in to *GroundWork Monitor* as an Administrator.
# Go to *GroundWork Administration* > *GroundWork Cloud Hub*, select *STOP* and *DELETE* for each connection to be deleted.
# Then, open a terminal session and enter the following command to completely remove your Cloud Hub hosts:
{noformat}/usr/local/groundwork/tools/ -cleanup{noformat}

h4. How to delete Cacti hosts

For most SNMP monitoring, Cacti provides a simpler way to discover and configure monitoring of network devices. The data collected by Cacti is displayed through the Cacti UI as graphs and the graph data is also displayed in the GroundWork Status application. If Thresholds are set in Cacti for a device being monitored, that device and any checks performed on it will be automatically added to GroundWork Monitor. The addition is made to the Foundation database bypassing Nagios, additionally the triggering of the threshold will create an alarm message to be sent via the NoMa application. To properly remove Cacti associated hosts you must remove the Threshold first as outline below.

# Log in to *GroundWork Monitor* as an Administrator.
# Go to *Advanced* > *Network Graphing* and select the *thold* tab.
# Then under the *Thresholds* tab you will see a listing of all Cacti associated hosts (you may need to change the filter at the top to Status: All), and next to each you have the options to *Edit Threshold*, *Disable Threshold*, and *View Graph*.
# For each of the hosts you want to delete select the *Disable Threshold* icon (second icon), you will see the status on the right change to *Disabled*.
# In a few minutes the associated hosts should no longer be visible in the *Status* viewer.
Figure: Disabling host Thresholds
\\ !how_to_remove_cacti_hosts_01.png|thumbnail!

h4. How to delete WMI NRPE_NT hosts

# Launch the *Command Prompt* and check if the *NRPE_NT* directory exists in the *C:* directory.
# If the directory exists stop the service:
{noformat}net stop nrpe_nt{noformat}
# Then uninstall the service:
{noformat}\nrpe_nt\bin\nrpe_nt.exe -u{noformat}
# Next, navigate to *Computer* > *Local Disk (C\:) >* and delete the *NRPE_NT* directory.

h4. How to delete hosts from the performance screen

Following is a simple procedure to remove hosts from the performance screen.
# From the command line set the environment to include the path to the tools:
{noformat}source /usr/local/groundwork/scripts/{noformat}
# Log in to the postgres database:
{noformat}psql -U postgres{noformat}
# You should see a prompt similar to {{postgres=#}}, select the configuration database:
{noformat}\c monarch{noformat}
# Remove the entries you don't want from the host_service table.
For example, to delete all entries for host {{foo}}:
{noformat}delete from host_service where host like 'foo'{noformat}
To delete all entries for service _foo_service_:
{noformat}delete from host_service where service like 'foo_service'{noformat}
To delete a specific service from a host and leave the others:
{noformat}delete from host_service where host like 'foo' and service like 'foo_service'{noformat}