Setting Up Nagios Monitoring

This article guides you through the installation and basic configuration of Nagios Core, a powerful open-source monitoring system, on a Linux server. Nagios Core allows you to proactively monitor your infrastructure, ensuring services are up and running and alerting you to potential issues before they impact your users. This is crucial for maintaining the reliability and performance of your servers, especially when hosting critical applications or websites.

Prerequisites

Before you begin, ensure you have the following:

• A Linux server with root or sudo privileges. A dedicated server from PowerVPS with full root access provides the ideal environment for running Nagios Core without resource contention.
• A stable internet connection to download necessary packages.
• Basic understanding of Linux command line operations.
• Web server (Apache is recommended) and PHP installed.
• Development tools (compiler, make, etc.) for compiling Nagios.

Installing Nagios Core

We will install Nagios Core from source to ensure we have the latest stable version and full control over the configuration.

Update System Packages

It's always a good practice to update your system's package list and upgrade existing packages to their latest versions.

sudo apt update && sudo apt upgrade -y

This command refreshes the list of available packages and installs any security updates or newer versions of installed software.

Install Required Dependencies

Nagios Core requires several development libraries and tools to compile correctly.

sudo apt install -y build-essential libgd2-dev libssl-dev libapache2-mod-php unzip libtool libltdl-dev libperl-dev libxslt1-dev automake autoconf

• `build-essential`: Provides essential tools for compiling software.
• `libgd2-dev`: Required for creating PNG images used in the Nagios web interface.
• `libssl-dev`: For secure communication (HTTPS).
• `libapache2-mod-php`: Enables PHP processing for the Nagios web interface.
• `unzip`: For extracting downloaded archives.
• `libtool`, `libltdl-dev`, `libperl-dev`, `libxslt1-dev`, `automake`, `autoconf`: Development libraries and tools necessary for the build process.

Download Nagios Core

Download the latest stable release of Nagios Core from the official website. You can find the latest version at [https://www.nagios.org/downloads/nagios-core/].

wget https://assets.nagios-plugins.org/nagios-core/releases/nagios-core-4.4.6.tar.gz
tar -xvzf nagios-core-4.4.6.tar.gz
cd nagios-core-4.4.6

• `wget`: Downloads the compressed tarball.
• `tar -xvzf`: Extracts the tarball.
• `cd`: Navigates into the extracted directory.

Compile and Install Nagios Core

Now, we'll compile and install Nagios Core.

./configure --with-command-group=nagios
make all
sudo make install
sudo make install-init
sudo make install-daemon-config
sudo make install-commandmode

• `./configure --with-command-group=nagios`: Configures the build process. The `--with-command-group=nagios` option ensures that the Nagios daemon runs with the `nagios` user and group, which is crucial for security.
• `make all`: Compiles the Nagios Core source code.
• `sudo make install`: Installs the Nagios binaries, configuration files, and documentation.
• `sudo make install-init`: Installs the init script for starting/stopping Nagios.
• `sudo make install-daemon-config`: Installs the default Nagios daemon configuration file.
• `sudo make install-commandmode`: Sets up the permissions for the CGI commands.

Create Nagios User and Group

Nagios runs as a dedicated user for security best practices.

sudo make install-usergroup

This command creates the `nagios` user and group if they don't already exist and assigns ownership of Nagios files and directories to them.

Install Nagios Plugins

Nagios needs plugins to check the status of various services.

cd ..
wget https://nagios-plugins.org/download/nagios-plugins-2.3.3.tar.gz
tar -xvzf nagios-plugins-2.3.3.tar.gz
cd nagios-plugins-2.3.3
./configure --with-nagios-user=nagios --with-nagios-group=nagios
make
sudo make install

• `cd ..`: Navigates back to the parent directory.
• Download and extract the Nagios plugins similar to Nagios Core.
• `./configure --with-nagios-user=nagios --with-nagios-group=nagios`: Configures the plugins to use the `nagios` user and group.
• `make` and `sudo make install`: Compiles and installs the plugins.

Configure the Web Interface

To access Nagios through a web browser, we need to configure Apache.

Install Apache and PHP

If you haven't already, install Apache and PHP.

sudo apt install -y apache2 php libapache2-mod-php

Configure Apache for Nagios

Copy the sample Apache configuration file for Nagios and enable it.

sudo cp /opt/nagios/etc/cgi.cfg /opt/nagios/etc/cgi.cfg.bak
sudo cp /opt/nagios/etc/objects/cgi.cfg /opt/nagios/etc/objects/cgi.cfg.bak
sudo cp /opt/nagios/etc/objects/apache2.conf /etc/apache2/sites-available/nagios.conf
sudo a2ensite nagios.conf
sudo systemctl restart apache2

• The `cp` commands create backups of important configuration files.
• `sudo cp /opt/nagios/etc/objects/apache2.conf /etc/apache2/sites-available/nagios.conf`: Copies the sample Apache configuration for Nagios to the Apache sites-available directory.
• `sudo a2ensite nagios.conf`: Enables the Nagios Apache site.
• `sudo systemctl restart apache2`: Restarts Apache to apply the new configuration.

Create Nagios Admin User

Create a user for accessing the Nagios web interface.

sudo htpasswd -c /opt/nagios/etc/htpasswd.users nagiosadmin

Enter a strong password when prompted. This creates an encrypted password file for authentication.

Configure Nagios Configuration Files

Edit the main Nagios configuration file to define basic settings.

sudo nano /opt/nagios/etc/nagios.conf

Ensure the following lines are present and correctly configured:

cfg_file=/opt/nagios/etc/objects/localhost.cfg

You might also want to adjust `log_file` and `status_file` paths if needed.

Next, configure the `cgi.cfg` file to point to the correct directories.

sudo nano /opt/nagios/etc/cgi.cfg

Make sure these lines are uncommented and correct:

nagios_log_file=/opt/nagios/var/nagios.log
status_file=/opt/nagios/var/status.dat
object_cache_file=/opt/nagios/var/objects.cache
resource_file=/opt/nagios/etc/resource.cfg

You'll also need to edit the `resource.cfg` to set your password for external commands (if you plan to use them).

sudo nano /opt/nagios/etc/resource.cfg

Uncomment and set the `$USER1$` and `$USER2$` variables:

$USER1$=/opt/nagios/libexec
$USER2$=/opt/nagios/var/spool/nagios.cmd

Restart Nagios and Apache

Apply all changes by restarting the Nagios service and Apache.

sudo systemctl restart nagios
sudo systemctl restart apache2

Accessing the Nagios Web Interface

Open your web browser and navigate to:

`http://your_server_ip/nagios`

Log in using the `nagiosadmin` username and the password you created. You should see the Nagios Core dashboard.

Basic Monitoring Configuration

Nagios uses configuration files to define hosts, services, and contacts. The primary configuration file is `nagios.cfg`, and host/service definitions are typically in separate files within the `objects` directory.

Monitoring the Local Host

Nagios is pre-configured to monitor the local host (`localhost`). This is a good starting point to verify your installation.

The configuration for `localhost` is usually in `/opt/nagios/etc/objects/localhost.cfg`. You can examine this file to understand how hosts and services are defined.

Adding a New Host

To monitor another server, you'll need to create a new host definition.

1. **Create a new host configuration file:**

    sudo nano /opt/nagios/etc/objects/my_server.cfg
    

2. **Add the host definition:**

    define host{
        use                     linux-server
        host_name               my-remote-server
        alias                   My Remote Server
        address                 192.168.1.100
        max_check_attempts      5
        check_period            24x7
        notification_interval   30
        notification_period     24x7
        contact_groups          admins
    }
    

* `use linux-server`: Inherits settings from the `linux-server` template defined in `templates.cfg`. * `host_name`: A unique name for the host. * `alias`: A more descriptive name. * `address`: The IP address or hostname of the server to monitor. * `max_check_attempts`: Number of times to check before assuming the host is down. * `check_period`: When checks should be performed. * `notification_interval`: How often to send notifications if the host is down. * `notification_period`: When notifications should be sent. * `contact_groups`: Assigns the host to a contact group.

3. **Add the new configuration file to `nagios.cfg`:** Edit your main Nagios configuration file:

    sudo nano /opt/nagios/etc/nagios.cfg
    

Add the following line to include your new host configuration:

    cfg_file=/opt/nagios/etc/objects/my_server.cfg
    

4. **Verify Nagios Configuration:** Before restarting, always verify your configuration for syntax errors.

    sudo /opt/nagios/bin/nagios -v /opt/nagios/etc/nagios.cfg
    

If there are no errors, you'll see output indicating successful verification.

5. **Restart Nagios:**

    sudo systemctl restart nagios
    

Adding a New Service

Now, let's define a service to check on the `my-remote-server`.

1. **Edit the host configuration file (`my_server.cfg`):**

    sudo nano /opt/nagios/etc/objects/my_server.cfg
    

2. **Add the service definition:** Add the following block after the host definition:

    define service{
        use                     generic-service
        host_name               my-remote-server
        service_description     HTTP
        check_command           check_http-H my-remote-server
        check_period            24x7
        max_check_attempts      3
        normal_check_interval   5
        retry_check_interval    2
        notification_interval   60
        notification_period     24x7
        notification_options    w,u,c,r
        contact_groups          admins
    }
    

* `use generic-service`: Inherits settings from the `generic-service` template. * `host_name`: The host this service belongs to. * `service_description`: A descriptive name for the service. * `check_command`: Specifies the plugin and arguments to use for checking. `check_http` is a built-in command for checking HTTP services. * `normal_check_interval`: How often to check the service when it's OK. * `retry_check_interval`: How often to check the service when it's in a warning or critical state. * `notification_options`: When to send notifications (warning, unknown, critical, recovery).

3. **Verify and Restart Nagios:**

    sudo /opt/nagios/bin/nagios -v /opt/nagios/etc/nagios.cfg
    sudo systemctl restart nagios
    

After a few minutes, you should see the new host and service appear in the Nagios web interface.

Troubleshooting

"Forbidden" Error in Web Interface

If you encounter a "Forbidden" error when trying to access the Nagios web interface, it's likely a permissions issue with the CGI scripts.

• **Check Apache Configuration:** Ensure the `ScriptAlias` directives in `/opt/nagios/etc/objects/apache2.conf` are correctly pointing to your Nagios CGI directory.
• **Permissions:** Verify that the `/opt/nagios/sbin` directory and its contents are executable by the Apache user (often `www-data`).

    sudo chown -R nagios:nagios /opt/nagios/sbin
    sudo chmod +x /opt/nagios/sbin/*
    

• **Apache User:** Make sure the Apache user is part of the `nagios` group.

    sudo usermod -a -G nagios www-data
    sudo systemctl restart apache2
    

Nagios Service Not Starting

If the Nagios service fails to start, check the Nagios log file for errors.

sudo tail -f /opt/nagios/var/nagios.log

Common issues include:

• **Syntax Errors in Configuration Files:** Use `sudo /opt/nagios/bin/nagios -v /opt/nagios/etc/nagios.cfg` to check for errors.
• **Permissions:** Ensure the `nagios` user has read access to configuration files and write access to log and spool directories (`/opt/nagios/var/`).
• **Missing Plugins:** Verify that all plugins specified in your `check_command` directives are installed and executable.

Host/Service Not Showing Up

• **Configuration Verification:** Always run `sudo /opt/nagios/bin/nagios -v /opt/nagios/etc/nagios.cfg` after making changes.
• **Included Configuration Files:** Ensure that your custom configuration files (e.g., `my_server.cfg`) are correctly listed in `nagios.cfg`.
• **Typographical Errors:** Double-check `host_name`, `service_description`, and `host_name` references in service definitions for any typos.

Further Steps

• **Contact Definitions:** Define contacts and contact groups to receive notifications.
• **Notification Commands:** Configure commands to send notifications via email, SMS, or other methods.
• **Advanced Plugins:** Explore the vast array of available Nagios plugins for monitoring almost any service.
• **Performance Tuning:** Optimize Nagios for larger environments.
• **Security Hardening:** Secure your Nagios installation further.

By following these steps, you can establish a robust monitoring system for your servers, ensuring high availability and quick response to issues. For demanding workloads, consider dedicated servers from PowerVPS to guarantee optimal performance for your Nagios Core instance.

Category:Monitoring Category:Linux Administration Category:Server Management