How to associate host names

REDIRECT: This URL has changed to https://support8.gwos.com/gw/gw8/latest/how-to-s/how-to-associate-host-names-using-alias
Click the link above if you are not automatically redirected in 10 seconds.

The Alias feature allows an administrator to associate 2 or more host names as a set represented by one name, to have reporting for all the names in the set be presented and aggregated under that one name. This makes it possible to monitor one host object using more than one method, for example Cloud Hub for the VMware view and Nagios for the SNMP view, with the host named according to VMware policy under Cloud Hub on one hand, and named under Nagios rules on the other hand. Without the Host Identity aliasing feature these two nomenclatures would produce 2 separate host objects, licensed as 2 devices, and presented in separate contexts.

With the alias feature, the set can be designated with the two names being connected by a host identity or unique string that tells GroundWork they are one host object. The order in which the names are added to the alias record defines which name is to be displayed (the first) in the various dashboards.

A good example is the case of a NetApp monitoring a NetApp Disc resource, which is also discovered by VMware and presented initially as a differently named host. Once both facilities are reporting, an Administrator adds the two names to the alias list, whereupon a host identity is assigned and thereafter the separate reporting of the services (and host states) is aggregated under the name assigned first to the alias set. Status of the host is tracked as reported by the owner of the first name in the list. The owner in our example is Cloud Hub VMware Connector or the Nagios feeder (each has its own agent identity). In the host detail panel of Status, the additional host names and the status reported by each respective owner is listed.

Typically the aliasing data is entered after the monitoring agents discover and insert the names of the hosts. It is possible to pre-load this alias list so long as the names are accurately entered. This feature is not to be used in case the host names are identical in spelling but varying in case, for example GDMA host HOSTA and the same host seen by VMware as Hosta. A different policy and set of rules governs that case (i.e. the Merge Hosts option in Cloud Hub); attempting to use the aliasing feature to deal with it will create an error in processing.

Alias host identity entries take effect immediately, both when they are made and when entries are deleted.

Adding a host alias

  1. Select Configuration > Devices > Alias. A list of currently defined host aliasing will be displayed.
  2. To add a new host select the + icon and enter the full host name.  The system will list existing names in typeahead, but the name you enter is not required to exist a priori. 
  3. Then, select the Aliases field to add at least one alias.
  4. Select Add. You will see the new host added to the list populated with the Host name (that is, Host Identity) and Aliases.
  • The Status summary will now show hosts under the Host Identity which are actually representing multiple hosts. The other represented hosts will not be displayed within the navigation panes, since they are added as an alias of the visible host in the host identity table. These devices are consolidated into the same node.
  • To remove an alias, simply check the box next to the host name and select the trash icon. This cannot be undone. The defined hosts will go back to their separate individual identities within the monitoring system.

Related articles