Nagios XI – How To Use The Bulk Host Cloning Purpose

Nagios XI – How To Use The Bulk Host Cloning
& Import Wizard
The Industry Standard in IT Infrastructure Monitoring
Purpose
This document describes how to use the Bulk Host Cloning & Import Wizard in Nagios® XI™. The Bulk Host Cloning & Import Wizard
allows you to easily import new hosts and services into Nagios XI. This tool is extremely useful for use in large environments where
several hosts need to be monitored quickly and in the same manner.
Target Audience
This document is intended for use by Nagios XI Administrators who want to quickly set up several hosts to be monitored in a similar
manner.
Overview
The Bulk Host Cloning & Import Wizard allows you to easily import new hosts and services into Nagios XI using a CSV dump. Imported
or cloned hosts have services that are replicated to match an already existing host the user selects as a template. This import/cloning
tool is extremely useful for large environments that want to quickly setup several hosts to be monitored in the same manner. This
document will cover the following topics:
•
•
Installing the Bulk Host Cloning & Import Wizard
Running the Configuration Wizard
Installing The Bulk Host Cloning & Import Wizard
Starting with Nagios XI 2012, all existing configuration wizards were included with Nagios XI releases. If you are running a earlier
version of Nagios XI, you will need to download the configuration wizard. If you are running Nagios XI 2012 or later you can skip this
step.
The Bulk Host Cloning and Import wizard can be downloaded at:
Bulk Host Cloning & Import Wizard
http://exchange.nagios.org/directory/Addons/Configuration/Configuration-Wizards/Bulk-Host-Import-Wizard/details
Download and install as you would any other wizard. If you are unsure of how to do that please refer to the documentation here:
How to Install Configuration Wizards in Nagios XI
http://assets.nagios.com/downloads/nagiosxi/docs/Installing_XI_Configuration_Wizards.pdf
Running The Configuration Wizard
Once in the Nagios XI web interface, click the Configure link in the top menu and then Run the Monitoring Wizard.
Click on the Bulk Host Cloning and Import wizard.
Nagios Enterprises, LLC US: 1-888-NAGIOS-1
P.O. Box 8154
Int'l: +1 651-204-9102
Saint Paul, MN 55108
Fax: +1 651-204-9103
USA
Web: www.nagios.com
Email:[email protected]
Page 1
Copyright © 2010 - 2014 Nagios Enterprises, LLC
Revision 1.0 – May, 2014
Nagios XI – How To Use The Bulk Host Cloning
& Import Wizard
In Step 2, select the existing host from the Host Name
drop-down menu that you would like to use as a
template, and click Next.
Remember you are going to clone one host many times.
It is recommended that you verify the host your are
cloning is set up properly. See the Additional Tips
section for more information.
In Step 3, after you have selected a template host, you
should specify which services from the template host
should be applied to newly imported hosts.
All of the available services are listed under the
Template Services section. In order to select a service,
just check the select box next to the desired service
name.
Under Import Data, you should specify which fields of
the CSV data you are uploading (Address, Name, and
Description) from the drop-drowns provided.
You should also enter the host data to import in CSV
format – one entry per line. Please reference the Import
Data section in the picture to the right, showing the Step
3 of the Bulk Host Cloning & Import Monitoring Wizard.
It is a good practice to clone only a few hosts initially and
then verify the results are as expected. If you get the
expected results, then clone a larger number of hosts.
See the Additional Tips section for more information
about cloning large numbers of hosts.
Follow the wizard by clicking on the Next button in Step 4 – Step 6. In these steps monitoring and notification options, as well as group
memberships will be inherited from the template host and services you selected.
To finish up, click on Apply in the final step of the wizard.
Nagios Enterprises, LLC US: 1-888-NAGIOS-1
P.O. Box 8154
Int'l: +1 651-204-9102
Saint Paul, MN 55108
Fax: +1 651-204-9103
USA
Web: www.nagios.com
Email:[email protected]
Page 2
Copyright © 2010 - 2014 Nagios Enterprises, LLC
Revision 1.0 – May, 2014
Nagios XI – How To Use The Bulk Host Cloning
& Import Wizard
Things You Should Know
Unable to Clone Some Service Checks
The Bulk Host Cloning and Import Wizard cannot properly clone some types of service checks, that rely on other applications. For
example, you cannot clone a host, created by running the Network Switch/Router Wizard or Web Transaction Wizard, because they rely
on mrtg and webinject.
Parent-Child Relationships
It is important to note that the parent-child relationships won't be inherited, unless they are set in the host's config file which you are
using as a template. If you want to inherit the parent-child relationship of the template host, verify the config file for template host
includes a hostgroup in its definition. To view the config file for a host go to Configure → Core Config Manager → Monitoring →
Hosts.
Find the host you are inheriting from on the list and under Actions, click
on the disk icon. This will open a new window in your browser displaying
the config file for the selected host.
If the hostgroup is defined in the config file it will be inherited to other
hosts via the Bulk Host Cloning and Import wizard.
For example, if you added a host named “LS1” to a hostgroup named “linux-servers” through Configure → Core Config Manager →
Monitoring → Hosts → LS1 → Manage Host groups, and opened the file “LS1.cfg”, you would see that the following line was added
to the config file:
hostgroups
linux-servers
Now, when you run the Bulk Host Cloning and Import Wizard the newly created hosts will be set as members of the “linux-servers”
hostgroup.
However, if you added the “LS1” host to the “linux-servers” hostgroup by going to the Configure → Core Config Manager →
Monitoring → Hosts Groups → linux-servers → Manage Host groups, the “linux-servers” hostgroup won't be defined in the
“LS1.cfg” file, and therefore the new hosts won't inherit this quality from the template host.
Additional Tips
First, before you even start the Bulk Host Cloning and Import Wizard, double check the host that you are about to clone. Make sure it is
set up properly and run the Write Config Tool, to make sure that you don't have any config errors. Go to Config → Tools → Write
Config Files.
Next, run the wizard but clone your host only a few times just to make sure you are not going to run into some unexpected issues.
Even if the cloning of your host is successful, it is very difficult to undo what you've done. It is not easy to revert your changes and start
“clean” in case you forgot to add a service, change alias, etc. This is especially true if you created 500+ new hosts.
If you are going to create a huge number of hosts, using the Bulk Host Cloning & Import Wizard, you may run into some timeout issues.
Nagios Enterprises, LLC US: 1-888-NAGIOS-1
P.O. Box 8154
Int'l: +1 651-204-9102
Saint Paul, MN 55108
Fax: +1 651-204-9103
USA
Web: www.nagios.com
Email:[email protected]
Page 3
Copyright © 2010 - 2014 Nagios Enterprises, LLC
Revision 1.0 – May, 2014
Nagios XI – How To Use The Bulk Host Cloning
& Import Wizard
To avoid this, open a terminal and log into your Nagios server as root. Next, edit the /etc/php.ini file by running the following command:
vi /etc/php.ini
Increase the values under the “Resource Limits” section according to your needs and system specifications. You may have to modify
these lines:
max_execution_time =
max_input_time =
memory_limit =
Also, you can add the following line on the bottom of the file:
max_input_vars = 100000
Save and close the file. Restart apache, so that the changes can take effect:
service httpd restart
Trouble Shooting
Issue: “No template services selected” error occurs in Step 3 of the wizard.
Solution: Selecting at least one service is required, in order to continue.
Issue: Apply Configuration fails with the following error:
“Error: Service description, host name, or check command is NULL. Error: Could not register service...”
Solution: Make sure that your “template” (the host you are trying to clone) has the same config name for host and services. If you
renamed host/services they may be different. In this case the wizard will fail with above listed error message.
Issue: An Alias is not inherited to a cloned host. This is determined by going to Home → Host Detail and selecting a host. The Host
Status Detail screen opens and you will see: “Alias: alias” in the top left corner under the host name.
Solution: Alias is not inherited by default – you need to define an alias (description) in the Step 3 of the wizard.
Issue: Hostgroup relationship is not inherited.
Solution: Define hostgroup members under the “Host Management”, NOT under the “Host Group Management” in the CCM. Reference
Parent-Child Relationships in the Things You Should Know section.
Finishing Up
You have now successfully run the Bulk Host Cloning & Import Wizard. If you have any additional support issues that you cannot
resolve, please, post your questions on the Nagios Support Forum:
http://support.nagios.com/forum/
Nagios Enterprises, LLC US: 1-888-NAGIOS-1
P.O. Box 8154
Int'l: +1 651-204-9102
Saint Paul, MN 55108
Fax: +1 651-204-9103
USA
Web: www.nagios.com
Email:[email protected]
Page 4
Copyright © 2010 - 2014 Nagios Enterprises, LLC
Revision 1.0 – May, 2014