Overview
When accessing the Hosts Configuration Page, an Host Table is displayed,listing all Hosts objects. This table contains the following informations :
 This page also provides, on the left, an action Menu, used to :
| |
On the top of the table, A tool bar let Administrators the ability to :
|
Create a new Host
To create a new Host, use the button "Add new [Host]" located in the Action Menu Host creation form (empty) will be replace the list of host.  |
|
This form is composed of tabs, corresponding to categories of properties :
| |
 The left menu give to Administrators the ability to :
| |
For each category, a corresponding form is displayed.
| |
Generic tabGeneric properties contains the most common properties of an Host:
|
|
|
|
DataData is used to show and create variables used by Shinken to perform checks. Those values are also called Macros. As shown on the picture, when creating a new host, no data are available, even if the
|  |
| To see data that will be applied to host, it is necessary to first validate this host, and come-back to its configuration. |  |
Data are displayed in two sections :
Data from templates are seperated by template names. This allow Administrators to see what and where data have been get. Data are represented by a Key and a Value. When data are local, both of them can be modified. When data are inherited, only values can be modified. |  |
MonitoringThis form is used to configure properties that define monitoring for the host itself. Monitoring is defined by the following properties :
|
|
|
|
ChecksChecks is a read-only form, used to provide informations about checks By default, if no template applies on host, no check will be made. |  |
If the host inehrits from a template which has checks attached to it, checks will be filled In this example, we can see 3 checks, inherited from http template, and https template.
Name of check is a link to the check configuration of the selected object. |  |
NotificationsNotification is a form displaying all required fields to configure notifications properties :
|  |
|
|
AdvancedAdvanced form is used to set advanced features of monitoring.
|
|
|
|
Modify a host
| To modify properties of a host, first go on the Hosts page, from the Main menu, and then click on the host name you want to modify. |  |
The form displayed is the same as the form used to create a new Host. Once changes have been made, configuration of the Host must be saved by clicking the Validate button Cancel button revert all changes to precedent configuration. |  |
Delete a host
To delete a host, you can use the form of the host, or delete it directly from the list page.
From the Form page First go to the Hosts page, from the Main menu, then click on the host name you want to delete. Once in the page displaying the form, click on the Delete button available on the left menu. A confirmation popup will be displayed. | |
From the Main page First go to the Hosts page, from the Main menu, then click on the check box placed on the first column of the table. Use the Action menu on the top to select Delete, and click to the Launch Button. A confirmation popup will be displayed. |
|
Using the Main page gives Administrators ability to Delete many Hosts at once.
Duplicate a host
Duplication operation is very useful when similar Hosts must be added.
| To duplicate a host, first go on the Main page listing all hosts, then select a host by clicking on the check box placed on the first column. |  |
| Once selected, the host can be duplicated by selecting Duplicate in the select Action of the tool bar. Duplication is executed by clicking the Launch button. |  |
| The name of host duplicated is suffixed by "(copy)". |  |
Using the Main page gives Administrators ability to Dublicate many Hosts at once.
Duplicated Hosts are totaly detached and independant of the cloned Host. No relation is made in the configuration.
Enable / Disable a Host
Disable operations help Administrators to temporarly exclude an element from the monitoring. It can be very helpfull to prepare a future configuration.
Enabling or Disabling Host can be made from the Host Configuration, or from the Main Hosts page.
From the Host configuration
First go to the Hosts page, from the Main menu, then click on the host name you want to delete. Once in the page displaying the form, modify the Enabled status by clicking on the False button. |  |
| To Enable a Host, use the same procedure, by choosing "True" in the Enabled Field. |
From the Main page
First go to the Hosts page, from the Main menu, then click on the check box placed on the first column of the table. Use the Action menu on the top to select Disable, and click to the Launch Button. |
|
In both cases, the result will be displayed in the table listing all Hosts. |
|
| To Enable one or more Hosts, use the same procedure, by Choosing Enable. |
Using the Main page gives Administrators ability to Disable or Enable many Hosts at once.
See and apply differences proposed by the Automatic detection modules
Differences are generated from the configuration daemon when an host is already validate in the configuration and that the Automatic configuration modules (Sources and Taggers) did detect new properties (like custom data or new templates)
| When an host have such a differences, a green square will be shown on the "Differences" collumn. |  |
When you will hover your mice over the square, you will see all the proposed differences. Here the VMWare discovery module did find the JIRA host in the 172.18.206.51 ESX server, and it propose to add the vmware-vm template to this host. |  |
| If you accept the difference, select the host: |  |
And click on the button "Accept selected differences [ 1 ]".
The number will be equal to the number of hosts with differences you did selected.
By clicking on the button, you will accept the differences for all the selected hosts.
