Simple Network Management Protocol (SNMP) is a widely used protocol for monitoring and managing network devices, including servers, routers, switches, and more. It allows systems administrators to gather information on system performance, monitor the health of network devices, and detect faults.

In this guide, we’ll walk through the process of setting up SNMP on a Debian 12 server, and then configuring Nagios XI to monitor that server’s health and performance. Nagios XI is a comprehensive IT monitoring solution that allows organizations to monitor their entire infrastructure. We’ll cover the installation of SNMP on Debian 12, configuring the server to allow Nagios XI to access SNMP data, and setting up Nagios XI to receive and visualize this data.

Prerequisites

Before beginning the setup, ensure the following:

• A working Debian 12 workstation.
• Nagios XI installed and running. (If you don’t have Nagios XI installed, you can follow their official documentation to install it.)
• Root or sudo access to both the Debian 12 server and the Nagios XI interface.

1. Setting Up & Installing SNMP on Debian 12

Debian comes with SNMP packages that can be installed via its package manager, apt. To install SNMP, follow these steps:

Update the system’s package list:

bash

sudo apt update

bash

sudo apt update

Install the SNMP daemon and utilities:

sudo apt install snmpd snmp

sudo apt install snmpd snmp

Confirm the installation by checking the version:

sudo snmpd -v

sudo snmpd -v

2. Create a New SNMP Config File

The SNMP service (snmpd) needs to be configured properly to ensure that Nagios XI can query it for the server’s performance data.

Open the SNMP configuration file in a text editor:

bash

sudo nano /etc/snmp/snmpd.conf

bash

sudo nano /etc/snmp/snmpd.conf

To ensure that SNMP can communicate securely, you’ll need to define community strings and set up access controls.

• Community String: The community string works like a password to access SNMP data. It’s recommended to use a secure, unique string.
• Access Control: This defines who can access the SNMP data (usually restricted to local IP addresses for security).

Here’s an example configuration:

sysLocation    "Your Location"
sysContact     "Your Name <your_email@example.com>"
sysName        "Your System Name"
agentAddress udp:161
rocommunity your_community_string default -V systemonly

sysLocation    "Your Location"
sysContact     "Your Name <your_email@example.com>"
sysName        "Your System Name"
agentAddress udp:161
rocommunity your_community_string default -V systemonly

• Replace YOUR_NAGIOS_IP_ADDRESS with the IP address of your Nagios XI server.

• The rocommunity directive allows read-only access to SNMP data, with “public” being the community string.

• The sysLocation and sysContact fields help provide additional information about the system.

• Save and exit the file (Ctrl + X, then Y to confirm, and Enter to save).

3. Create a New SNMP Config File

Restart the SNMP service to apply the changes:

sudo systemctl restart snmpd

sudo systemctl restart snmpd

Ensure SNMP is running and listening on the correct port (161):

sudo systemctl status snmpd

sudo systemctl status snmpd

4. Test SNMP Configuration

To test the SNMP service on your Debian 12 server, use the snmpwalk utility. This will help confirm that the SNMP daemon is functioning correctly.

snmpwalk -v2c -c public localhost

snmpwalk -v2c -c public localhost

If everything is configured correctly, you should see a long list of SNMP data, including system information, CPU stats, memory usage, and more.

5. Configuring Nagios XI to Monitor the Debian 12 Server

Now that SNMP is properly set up on your Debian 12 server, the next step is to configure Nagios XI to monitor it.

Access the Nagios XI Web Interface

1. Open your web browser and navigate to the Nagios XI interface.
2. Log in using your administrator credentials.
3. Once you are in, hover your mouse over the gear icon to the far left and select the “Configuration Wizards option. Your screen should look like mine below once you have completed this.

4. In the search field type “SNMP” and select the “Linux SNMP” option shown below.

5. Then fill in the necessary information, like in the photo below, such as Debian 11 ip address and the SNMP community string. Hit “finish” or “finish with defaults” at the end and you should be good to go.

6. Test the Configuration

Once you’ve added the services, it’s a good idea to verify that Nagios XI can successfully query your Debian 12 server using SNMP.

1. Go back to the Nagios XI dashboard.
2. Check if the new services are showing up and updating correctly.
3. If there’s an issue, check the logs in Nagios XI (/usr/local/nagios/var/nagios.log) and SNMP daemon logs (/var/log/syslog) for troubleshooting.

Conclusion

By following the steps outlined above, you can successfully set up SNMP on your Debian 12 server and integrate it with Nagios XI for comprehensive monitoring. This setup will allow you to track important server metrics such as CPU load, memory usage, and disk space, and get alerted when there are performance issues or failures.

With SNMP monitoring in place, you’ll gain more visibility into the health of your Debian server and be able to take action quickly to maintain a stable, high-performance environment.

Additional Resources

Visit Our Website: https://www.nagios.com

Visit Nagios Support: https://support.nagios.com/

Visit Nagios Exchange: https://exchange.nagios.org/

Prerequisites

Before beginning the setup process, ensure that you meet the following requirements:

• A running Debian 12 system
• Root or sudo privileges on the Debian 12 system
• A Nagios Log Server 2024R2 instance (you can use Nagios Log Server 2024R2 in your own infrastructure or use Nagios XI or a hosted version)
• Basic knowledge of Linux and command-line operations
• Make sure you have a bridged connection before starting up your Debian workstation

Automatic Script – Supported Operating Systems

• CentOS, Fedora, and RHEL
• Ubuntu and Debian

You must have rsyslog installed. If your operating system is not listed, you can manually configure syslog or rsyslog by going to the “Home” tab (after logging into Log Server), select “Add a log source” then click the “Linux” option and select whichever manual configuration setup option you prefer..

Step 1: Install Required Dependencies on Debian 12

First, you will need to install rsyslog, which is the default logging service for Debian, and configure it to send logs to the Nagios Log Server 2024R2.

1. Update the System

Make sure your Debian 12 system is up-to-date by running:

bash

sudo apt update

bash

sudo apt update

2. Install rsyslog

If rsyslog is not already installed, install it using the following command:

sudo apt install rsyslog

sudo apt install rsyslog

Step 2: Run the Script

On the system you want to send logs from, run the following commands to download and run the script to automatically setup rsyslog.

curl -sS -O http://u0022your Nagios Log Server ip addressu0022/nagioslogserver/scripts/setup-linux.sh

curl -sS -O http://u0022your Nagios Log Server ip addressu0022/nagioslogserver/scripts/setup-linux.sh

Then run

sudo bash setup-linux.sh -s u0022your Nagios Log Server ip addressu0022 -p 5544

sudo bash setup-linux.sh -s u0022your Nagios Log Server ip addressu0022 -p 5544

Afterwards you should see a message in your terminal that looks like this:

“rsyslog is running with the new configuration. Visit your Nagios Log Server dashboard to verify that logs are being received”

Step 3: Get IP address and verify incoming logs

To get your IP address go into the terminal and type:

ip a

ip a

Then take that address and past it into the IP Address field under “Verify Incoming Logs“. You should then see however many logs come through similar to the image below.

After you have verified go to the “Dashboards” tab on the lefthand side to see various syslog data coming from your Debian 12 machine.

You can even zoom in further to a certain time frame to see more syslog data like shown here:

Conclusion

To watch a video on how to do this click here and follow us on YouTube to stay up to date on new releases and features.

Documentation: Monitoring a New Log Source: https://assets.nagios.com/downloads/n…

Visit Our Website: https://www.nagios.com

Visit Nagios Support: https://support.nagios.com/

Visit Nagios Exchange: https://exchange.nagios.org/

Prerequisites

Before starting the installation, ensure that you have the following prerequisites in place:

• A working Debian 12 workstation.
• A user with sudo privileges.
• Basic knowledge of using the terminal and text editors like nano or vim.
• Knowledge of bash scripting
• A working instance of Nagios XI

Step 1: Update the System

It’s always a good idea to make sure your system is up to date before installing any new software. Open a terminal and run the following commands to update the package lists and upgrade existing packages:

sudo apt update

sudo apt upgrade -y

sudo apt update

sudo apt upgrade -y

Step 2: Download and Install the NCPA Package

Now, you’ll need to download the NCPA package from Nagios’s official website. You can do this using the wget command. First, navigate to the directory where you want to store the downloaded package. For simplicity, we’ll use the /tmp directory:

cd /tmp

cd /tmp

Next, download the latest NCPA package for Debian. The following command downloads the latest .deb package for Debian systems:

wget https://assets.nagios.com/downloads/ncpa3/ncpa-latest-1.amd64.deb

wget https://assets.nagios.com/downloads/ncpa3/ncpa-latest-1.amd64.deb

You should see an image similar to this below if done correctly:

Note: Ensure that you check the Nagios NCPA GitHub releases page for the most recent version of NCPA and replace the link above accordingly.

Step 3: Install the NCPA Package

Once the package is downloaded, you can install it using the dpkg command:

sudo dpkg -i ncpa-latest-1.amd64.deb

sudo dpkg -i ncpa-latest-1.amd64.deb

Step 4: Configure NCPA

After installation, you’ll need to configure the NCPA agent. The configuration file is located at /usr/local/ncpa/etc/ncpa.cfg.

To edit the configuration, you can use the script below:

sudo nano /usr/local/ncpa/etc/ncpa.cfg

sudo nano /usr/local/ncpa/etc/ncpa.cfg

Your screen should look similar to the one below after the script:

Set a Password for the NCPA API
In the configuration file, look for the API key parameter. This is used to authenticate API requests. You should set a strong password for the API key. It should look like this below:

The community string token, by default, might have a series of numbers or it might say “my_token”. After making changes press “CTRL and X ” then press Y to confirm your changes and hit Enter to save everything.

Step 5: Install & Enable UFW

If you already have ufw installed and enabled skip this step. If you dont you’ll need to install ufw with the following scripts. First we’ll check the status by:

sudo ufw status

sudo ufw status

Then if it’s not installed we’ll need install it, check the status again to make sure it’s there, enable then reload it. Enter each script individually not at the same time:

sudo apt install ufw
sudo ufw status
sudo ufw enable
sudo ufw reload

sudo apt install ufw
sudo ufw status
sudo ufw enable
sudo ufw reload

Step 6: Start the NCPA Service

Once you have configured NCPA to your liking and installed ufw, you need to start the NCPA service. Use the following command to start the NCPA service:

systemctl restart ncpa

systemctl restart ncpa

This will restart the service, and NCPA will now use the newly configured token.

Step 7: Configure Firewall

Next we’ll configure the firewall and allow traffic on port 5693 which is used by NCPA

1. Create directory for ufw application profiles

sudo mkdir -p /etc/ufw/applications.d

sudo mkdir -p /etc/ufw/applications.d

2. Create a custom application profile for NCPA. Make sure to enter each script individually and not at the same time.

sudo sh -c "echo '[NCPA]' > /etc/ufw/applications.d/ncpa"
sudo sh -c "echo 'title=Nagios Cross Platform Agent' >> /etc/ufw/applications.d/ncpa"
sudo sh -c "echo 'description=Nagios Monitoring Agent' >> /etc/ufw/applications.d/ncpa"
sudo sh -c "echo 'ports=5693/tcp' >> /etc/ufw/applications.d/ncpa"

sudo sh -c "echo '[NCPA]' > /etc/ufw/applications.d/ncpa"
sudo sh -c "echo 'title=Nagios Cross Platform Agent' >> /etc/ufw/applications.d/ncpa"
sudo sh -c "echo 'description=Nagios Monitoring Agent' >> /etc/ufw/applications.d/ncpa"
sudo sh -c "echo 'ports=5693/tcp' >> /etc/ufw/applications.d/ncpa"

3. Allow NCPA traffic through the firewall

sudo ufw allow NCPA

sudo ufw allow NCPA

4. Reload the firewall to apply the changes

sudo ufw reload

sudo ufw reload

Step 8: Verify NCPA Installation

1. This step is optional but recommended. Open a web browser and go to: https://<NCPA_IP_Address>:5693/

2. You will see the error message below saying that site isn’t safe to continue. Simply click Advanced and proceed to the site.

3. You will then enter the community string API token from earlier in step 4 & click Log In. If you have the token proceed to the next step otherwise go back & retrieve it.

4. Your screen should look like the one below. Click See Live Stats to continue

Step 9: Configure NCPA on Nagios XI

1. In the Neptune interface, log into Nagios XI and hover your mouse over the gear icon & select Configuration Wizards. Or click the gear icon & then click Configuration Wizards. If you’re using light or dark mode the buttons might be in different locations.

2. In the search bar above like in the picture below look for NCPA and select it

3. Enter the IP address, API token and system you are using (Debian) like in the picture below

4. Fill in the rest of the information to your liking and click Finish or Finish w/Defaults

5. After you are finished click the home icon on the far left and select the green host bar in the middle of the screen like in the picture below.

6. Select the name of the NCPA agent you just created & you will see Host Status Details

Conclusion

Installing Nagios NCPA on a Debian 12 workstation is a straightforward process that allows you to collect valuable system metrics and monitor your system from Nagios Core. By following these steps, you can ensure that your workstation is integrated into your monitoring setup, providing real-time insights into your system’s performance and health.

Once installed, you can further customize the NCPA configuration to suit your environment, add it to your Nagios monitoring setup, and ensure that your system is continuously monitored for performance issues.

Additional Resources

Visit Our Website: https://www.nagios.com

Visit Nagios Support: https://support.nagios.com/

Visit Nagios Exchange: https://exchange.nagios.org/

Nagios Log Server provides centralized log management, helping system administrators monitor, analyze, and store logs in a centralized repository. By the end of this guide, you will have configured your Debian 12 system to forward logs to Nagios Log Server for easy monitoring. After configuration, you should immediately start receiving the logs that you would normally view in the /var/log/messages file on the Linux system you configured.

Prerequisites

Before beginning the setup process, ensure that you meet the following requirements:

• A running Debian 12 system.
• Root or sudo privileges on the Debian 12 system.
• A Nagios Log Server instance (you can use Nagios Log Server in your own infrastructure or use Nagios XI or a hosted version).
• Basic knowledge of Linux and command-line operations.
• Make sure you have a bridged connection before starting up your Debian workstation.

Automatic Script – Supported Operating Systems

• CentOS, Fedora, and RHEL.
• Ubuntu and Debian.

You must have rsyslog installed. If your operating system is not listed, you can manually configure syslog or rsyslog by going to the “Home” tab (after logging into Log Server) then select “+ Linux” under “Add a log source to start collecting logs“ and select whichever manual configuration setup option you prefer.

Step 1: Install Required Dependencies on Debian 12

First, you will need to install rsyslog, which is the default logging service for Debian, and configure it to send logs to the Nagios Log Server.

1. Update the System

Make sure your Debian 12 system is up-to-date by running:

bash

sudo apt update

bash

sudo apt update

2. Install rsyslog

If rsyslog is not already installed, install it using the following command:

sudo apt install rsyslog

sudo apt install rsyslog

Step 2: Run the Script

On the system you want to send logs from, run the following commands to download and run the script to automatically setup rsyslog.

curl -sS -O http://"your Nagios Log Server ip address"/nagioslogserver/scripts/setup-linux.sh

curl -sS -O http://"your Nagios Log Server ip address"/nagioslogserver/scripts/setup-linux.sh

Then run

sudo bash setup-linux.sh -s "your Nagios Log Server ip address" -p 5544

sudo bash setup-linux.sh -s "your Nagios Log Server ip address" -p 5544

Afterwards you should see a message in your terminal that looks like this:

“rsyslog is running with the new configuration. Visit your Nagios Log Server dashboard to verify that logs are being received”

Step 3: Get IP Address and Verify Incoming Logs

To get your IP address go into the terminal and type:

ip a

ip a

Then take that address and past it into the IP Address field under “Verify Incoming Logs“. You should then see however many logs come through similar to the image below.

After you have verified go to the “Dashboards” tab at the top to see various syslog data coming from your Debian 12 machine. You can even zoom in further to a certain time frame to see more syslog data like shown here:

To watch a video on how to do this click here and follow us on YouTube to stay up to date on new releases and features.

Documentation: Monitoring a New Log Source: https://assets.nagios.com/downloads/n…

Learn More: Download Nagios Log Server: https://www.nagios.com/products/nagio…

Visit Our Website: https://www.nagios.com

Visit Nagios Support: https://support.nagios.com/

Visit Nagios Exchange: https://exchange.nagios.org/

This document describes how to manually install Nagios Log Server from source on a Debian 12 system.

Target Audience

This document is written for administrators who are looking to perform a new installation of Nagios Log Server on a Debian 12 machine, rather than using a pre-configured virtual machine image.

Platform Support

Nagios Enterprises provides support for installing Nagios Log Server on Debian 12 and other Linux Distributions (Only 64-bit supported):

See Nagios Software/OS compatibility matrix.

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

Installation Prerequisites

Important: Nagios Enterprises highly recommends and will only support installing Nagios Log Server on a newly installed, “clean” system (a bare minimal install with nothing else installed or configured). 

Attempting to install Nagios Log Server on a pre-existing system with other applications already installed can cause the Nagios Log Server installation process to fail, critical system components and settings (e.g.

database servers) to be modified in a way that negatively affects other applications, and previously installed applications to be automatically upgraded or removed. While installing Log Server 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 Nagios Log Server to function. If you choose to ignore these warnings, you do so at your own risk.

Other Nagios products (XI, Network Analyzer and Fusion) should not co-exist on the same server.

Internet access is required for installation and upgrades!

Terminal Access

These instructions require you to establish a terminal session to the server you plan to install Nagios Log Server on. You will need to login to your server as the root user to perform the installation.

Install Nagios Log Server

To check if curl is installed, you can run:

bash

curl --version

If it’s not installed, you can easily install it with:

bash

sudo apt update
sudo apt install curl

There are two methods for installing Nagios Log Server, they both perform a full installation, quick and manual.

Quick

Execute the following command in your terminal session:

curl https://assets.nagios.com/downloads/nagios-log-server/install.sh | sh

That command will download and install Nagios Log Server. Proceed to the Finalize Installation section.

Manual Download

Alternatively, you can install Nagios XI by issuing the following commands in your terminal session:

cd /tmp

then

wget https://assets.nagios.com/downloads/nagios-log-server/nagioslogserver-latest.tar.gz tar xzf nagioslogserver-latest.tar.gz

then

cd nagioslogserver

then

./fullinstall

Note: If you need to install a specific version of Nagios Log Server, please visit the following page of Nagios Log Server versions to obtain the URL, use that in the wget command above: https://assets.nagios.com/downloads/nagios-log-server/versions.php.

Finalize Installation

Once the installation has completed you should see a message like the following:

Nagios Log Server Installation Success!

You can finish the final setup steps for Nagios Log Server by visiting:

http://<server_ip_address>/nagioslogserver

Navigate to the user interface by using the URL provided in your terminal session.

You will be presented with the Final Installation Steps screen just like this:.

Select Install if this is the first server in your Nagios Log Server cluster. Select Connect if you want to add this server top an existing Nagios Log Server cluster. Please refer to the following Nagios Log Server documentation Adding Additional Instances to Cluster for detailed instructions.

You will be presented with a page of fields that need to be populated before proceeding.

If you have already purchased Nagios Log Server you can add your license key here. Under Admin Account Setup please populate the fields as they are all required to continue. Once you are ready click Finish Installation to save these settings.

Please wait while the settings are applied to the server, once complete you will be presented with the Login screen with the status of Installation Complete

Type the username and password required to login to Nagios Log Server and then click the Log In button to begin. You will be logged into Nagios Log Server and be placed at the home screen.

Finishing Up

Nagios Log Server will now be installed on your system, ready to start collecting logs.

If you have never used Nagios Log Server before then the following documentation is a great starting point to familiarize yourself with the Technical Overview and Terminology Definitions.

Please refer to the Nagios Log Server Administrator Guide which will help get you started using Nagios Log Server.

Contact Sales: sales@nagios.com

The Nagios Support Knowledgebase: https://support.nagios.com/kb.

To watch a video on this installation, click here. Make sure to like and follow us for our latest news & updates