Nagios XI – Manual Installation Instructions

The Industry Standard in IT Infrastructure Monitoring

Purpose
This document is intended to outline the steps required to manually install Nagios XI, along with its prerequisites and subcomponents.

Target Audience
This document is intended for use by Nagios Authorized Resellers and other Nagios Partners who wish to install Nagios XI on physical
servers, operating systems and distributions other than those provided as our official offerings.

Platform Support
As of the time of writing, Nagios Enterprises is only able to officially provide support for installing Nagios XI on the following Linux
Distributions:

• RHEL
• CentOS
• Fedora Core

If you discover bugs or have fixes for installing Nagios XI on other platforms, please let us know. We will do our best to incorporate
your improvements to expand support for additional platforms in future XI releases, which will make future installation processes
smoother for you and your clients.

Installation Prerequisites
Nagios Enterprises recommends installing Nagios XI on a newly installed, “clean” system.

While installing XI on a system with other applications is possible, it is not recommended due to the possible interactions and
complexity of multiple components that are required for XI to function.

Downloading the Latest Release

Make sure to download the Nagios XI installation package to the /tmp directory of the server on which you wish to install it, as shown in
the following commands:

cd /tmp

To download the latest stable release, use the following command:

wget http://assets.nagios.com/downloads/nagiosxi/xi-latest.tar.gz

To download the latest development release, use the following command:

wget http://assets.nagios.com/downloads/nagiosxi/xi-latest-devel.tar.gz

Nagios Enterprises, LLC US: 1-888-NAGIOS-1 Web: www.nagios.com Page 1

P.O. Box 8154 Int'l: +1 651-204-9102 Email: [email protected]
Saint Paul, MN 55108 Fax: +1 651-204-9103
USA
Revision 1.6 – February, 2010
 Nagios XI – Manual Installation Instructions
Installing XI From The Installation Archive
To get started with the installation of XI you must first expand the installation archive.

If you are installing the latest stable release, use the following command:

tar xzf xi-latest.tar.gz

If you are installing the latest development release, use the following command:

tar xzf xi-latest-devel.tar.gz

Installation Steps
In order to install XI and it dependencies properly, you will need to run several commands in a specific order from the installation
directory. To get started, change to the newly created xi subdirectory to get started with the installation:

cd /tmp/xi

Note: Do not install Nagios XI from a directory that does not allow other users to have read/execute permissions to the installation files.
Part of the installation requires switch to different user accounts, which need to have access to the installer scripts.

You will now have to run the command shown below in order. Watch for error messages when running these commands, as some
installation scripts may fail if system requirements are missing, or operating system command names or application paths differ from
those currently supported.

Each command that must be run is listed below, along with a description of what it does. You may have to adapt the scripts to fit the
particular platform that you are attempting installation of Nagios XI one. Make sure to run these commands in the order they are
specified.

Command To Run Command Description

./0-yum Installs the Dag Wiers repo definition for RPM installations with yum

./1-prereqs Installs required RPM, Perl, and other packages required for XI and its related
components.

./2-usersgroups Creates Nagios user and groups on the system

./3-dbservers Initializes the Postgres and MySQL databases. Sets the MySQL root password to
'nagiosxi'

./4-services Adds entries to /etc/services

./5-sudoers Modifies /etc/sudoers to allow the nagios user to run certain commands

./6-firewall Updates the iptables definitions in /etc/sysconfig/iptables to allow traffic for various
components

./7-sendmail This is currently a null operation and can be ignored.

./8-selinux Disables SELinux by putting it into non-enforcing mode and modifying

/etc/selinux/config

./9-dbbackups Installs backup scripts for MySQL and Postgres in the /root/scripts directory and

Nagios Enterprises, LLC US: 1-888-NAGIOS-1 Web: www.nagios.com Page 2

P.O. Box 8154 Int'l: +1 651-204-9102 Email: [email protected]
Saint Paul, MN 55108 Fax: +1 651-204-9103
USA
Revision 1.6 – February, 2010
 Nagios XI – Manual Installation Instructions
creates backup directories in /store/backups

./10-phplimits Increases memory limit for PHP to 64MB in /etc/php.ini

./11-sourceguardian Installs the SourceGuardian loaders for 32-bit or 64-bit Linux platforms to
/usr/lib/php/modules or /usr/lib64/php/modules. SourceGuardian is required to
decrypt and run some protected PHP files distributed with Nagios XI. Loaders for
other platforms can be downloaded from http://www.sourceguardian.com/ixeds/

./12-mrtg Modifies the MRTG config file in /etc/mrtg/mrtg.cfg to use the RRDTool format and
changes permissions so the webserver can write to the file.

./A-subcomponents Installs various components required by Nagios XI - including Nagios Core, Nagios
Plugins, NDOUtils, PNP, extra plugins, webinject, etc.

./B-installxi Installs the Nagios XI scripts and php files in /usr/local/nagiosxi, sets appropriate file/
directory ownership, and creates and htpasswd file for use with Nagios Core and
PNP.

./C-cronjobs Installs cron jobs for the root and nagios users.

./D-chkconfigalldaemons Sets all appropriate services to start up in runlevels 3 and 5.

./E-importnagiosql Imports base object definitions (templates, commands, etc.) into NagiosQL for use
with Nagios Core

./F-startdaemons Starts the NDOUtils, Nagios Core, and PNP daemons

./Z-webroot Installs a welcome page in the root webserver directory /var/www/html

Finishing Up
If the installation commands completed successfully, you should now have a fully functioning Nagios XI system!

You are access the Nagios XI interface by pointing your web browser to:

http://<xiserver>/

where <xiserver> is the IP address of the server you just installed Nagios XI on.

Installation Support
Nagios Enterprises can provide installation support for Nagios XI if you require it. Please contact [email protected] for more
information.

Support problems and questions should be directed to our support forum at http://support.nagios.com/forum

Nagios Enterprises, LLC US: 1-888-NAGIOS-1 Web: www.nagios.com Page 3

P.O. Box 8154 Int'l: +1 651-204-9102 Email: [email protected]
Saint Paul, MN 55108 Fax: +1 651-204-9103
USA
Revision 1.6 – February, 2010