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/

This article will guide you through installing the Nagios Cross-Platform Agent (NCPA) on Arch Linux (version 2025.03.01) and configuring it in Nagios XI for centralized monitoring.

Prerequisites

Before we begin, ensure that you have the following:

1. A working Arch Linux system: Ensure your Arch Linux installation is up-to-date, and you have sudo privileges.
2. Nagios XI installed: Nagios XI should be installed on a separate server, as this will be used to manage and monitor the system where NCPA is deployed.
3. Network connectivity: Your Arch Linux system should be able to communicate with the Nagios XI server over the network.

Step 1: Installing Nagios Cross-Platform Agent (NCPA) on Arch Linux

As of March 2025, the NCPA package is not directly available in the Arch Linux repositories, so you will need to manually download and install the agent.

1.1. Download the NCPA Agent

To get the NCPA agent on Arch Linux, follow these steps:

1. Install necessary dependencies: First, ensure your system is fully updated, and install the required packages to build NCPA:

sudo pacman -Syu
sudo pacman -S git base-devel python3

sudo pacman -Syu
sudo pacman -S git base-devel python3

2. Clone the NCPA repository: Clone the official Nagios NCPA repository from GitHub:

git clone https://github.com/NagiosEnterprises/ncpa.git
cd ncpa

git clone https://github.com/NagiosEnterprises/ncpa.git
cd ncpa

3. Install NCPA: NCPA can be installed using the following commands. Since Arch Linux uses makepkg for building packages, you need to create the package manually:

makepkg -si

makepkg -si

This command will build and install NCPA, including any required dependencies.

4. Start the NCPA service: Once installed, you can start the NCPA service:

sudo systemctl start ncpa

sudo systemctl start ncpa

To enable NCPA to start automatically on boot, use:

sudo systemctl enable ncpa

sudo systemctl enable ncpa

You can check the status of the NCPA service by running:

sudo systemctl status ncpa

sudo systemctl status ncpa

5. Configure the firewall (if applicable): If you are using a firewall, make sure to allow the necessary ports (default is port 5693 for NCPA) to pass through:

sudo ufw allow 5693

sudo ufw allow 5693

1.2. Verify the NCPA Installation

After installing and starting the NCPA service, verify that it’s running properly by accessing the web interface. Open your browser and visit the following URL (replace <arch-linux-ip> with your actual IP address):

http://<arch-linux-ip>:5693

http://<arch-linux-ip>:5693

You should be prompted with a login screen. The default username is nagiosadmin and the default password is nagios.

Step 2: Configure NCPA in Nagios XI

Once you have installed and verified that NCPA is running on your Arch Linux system, the next step is to configure it within Nagios XI for centralized monitoring.

2.1. Add Host to Nagios XI

1. Log in to Nagios XI: Open your web browser and log in to your Nagios XI server (e.g., http://<nagios-xi-ip>/nagiosxi).
2. Navigate to the “Configure” menu: From the main dashboard of Nagios XI, go to the Configure tab and select Core Configuration Manager.
3. Add a new host: In the Core Configuration Manager, click on Hosts in the left-hand menu and then click the Add New button.
4. Host Settings:
   • Host Name: Enter a meaningful name for the Arch Linux host (e.g., arch-linux).
   • Alias: Optionally, provide an alias (e.g., Arch Linux System).
   • Address: Enter the IP address of your Arch Linux machine (e.g., 192.168.1.100).
   • Host Template: You can either use a predefined template or create a custom template for monitoring NCPA. If using a predefined template, select Generic Host.
5. Save the host configuration.

2.2. Add Service for NCPA Monitoring

Now that you’ve added the host, it’s time to add services to monitor specific metrics via NCPA.

1. Add Services: After saving the host, navigate to the Services section under the host configuration and click Add New.
2. Service Configuration:
   • Service Name: Enter a descriptive name for the service (e.g., CPU Usage or Memory Usage).
   • Service Description: Optionally, provide more details.
   • Service Type: Select NCPA.
   • Check Command: From the list of check commands, select check_ncpa.py or check_ncpa.py!<metric> (replace <metric> with the desired metric like cpu, memory, disk, etc.).
   • Additional Arguments: You can customize the command arguments to match your needs, such as the one below and save the service configuration:

-H <arch-linux-ip> -t <token> -P 5693 -M 'system/uptime'

-H <arch-linux-ip> -t <token> -P 5693 -M 'system/uptime'

3. Configure NCPA Token: To make sure the Nagios XI server communicates securely with NCPA, you will need to use the token set during NCPA setup (the default token is nagios). If you set a custom token, use it in the configuration.

Update the check command in Nagios XI to include this token, like this:

-H <arch-linux-ip> -t nagios -P 5693 -M 'system/uptime'

-H <arch-linux-ip> -t nagios -P 5693 -M 'system/uptime'

Below are screenshots of where you’ll go inside Nagios XI when setting up the wizard. Once you have selected the wizard make sure to follow the prompts. You can also select “finish with defaults” after entering in initial information.

2.3. Verify Monitoring

Once you’ve configured the host and services, go back to the Nagios XI dashboard and check the status of the new host and services. If everything is set up correctly, you should begin seeing the system metrics of the Arch Linux machine being reported in real-time. You can also test individual metrics by manually running the NCPA check command from the Nagios XI server:

/usr/local/nagios/libexec/check_ncpa.py -H <arch-linux-ip> -t nagios -P 5693 -M 'system/uptime'

/usr/local/nagios/libexec/check_ncpa.py -H <arch-linux-ip> -t nagios -P 5693 -M 'system/uptime'

If the configuration is correct, you will receive a status message with the requested metric data.

2.4. Automate Service Checks

To ensure that Nagios XI continuously monitors the Arch Linux system, make sure the services you created are set up to check regularly by setting the appropriate intervals in the service settings (e.g., every 5 minutes).

Step 3: Troubleshooting

If you encounter any issues, here are a few troubleshooting steps:

• Firewall: Ensure that port 5693 is open on both the Arch Linux server and the Nagios XI server.
• Token Mismatch: Double-check the token configuration in both Nagios XI and NCPA.
• NCPA Logs: Check the NCPA logs on your Arch Linux system for any error messages. Logs are usually found in /var/log/ncpa/.

Conclusion

By following these steps, you should have successfully installed the Nagios Cross-Platform Agent (NCPA) on your Arch Linux system and configured it for monitoring in Nagios XI. NCPA is a powerful and flexible tool for monitoring various system metrics, and when combined with Nagios XI, it provides a comprehensive solution for centralized network monitoring. Keep your system up-to-date and periodically review your Nagios XI configuration to ensure optimal performance.

For further assistance, refer to the Nagios Support Forum or the Nagios Knowledgebase.

For additional customization and advanced features, refer to the official NCPA documentation.