Skip to content

rConfig - Device SNMP Polling

6 mins V8 Pro

Device SNMP Polling is a feature in rConfig that allows you to retrieve data from devices using SNMP protocols. This feature works by associating devices with SNMP Polling Groups, which are configured with specific SNMP OIDs and an SNMP Connection Profile.

Installation Requirements

Section titled “Installation Requirements”

The PHP SNMP extension is required for SNMP Polling to function correctly. Ensure that the extension is installed and enabled in your PHP configuration. You can install the extension using the following commands. Note, these scripts will work on existing CentOS, Rocky, RHEL, and Alma Linux 8/9 installations, and new installations.

CentOS / Rocky Linux Scripts

Section titled “CentOS / Rocky Linux Scripts”
Terminal window
cd /home
yum -y install wget
wget https://dl.rconfig.com/downloads/php-updates/centos-php8-update.sh -O /home/centos-php8-update.sh
chmod +x centos-php8-update.sh
./centos-php8-update.sh

How it Works

Section titled “How it Works”

Once the device is part of an SNMP Polling Group, all associated OIDs will be polled for value data during each configuration backup or download for the device. These properties are stored in the database, but only the latest retrieved results are displayed in the UI and Inventory Reports.

SNMP Properties

Viewing SNMP Polling Logs

Section titled “Viewing SNMP Polling Logs”

All events related to SNMP Polling for each device, polling group, and OID are stored in the Application Logs under Settings. Use these logs for troubleshooting and verification.

SNMP Polling Logs

Troubleshooting

Section titled “Troubleshooting”

Using the SNMP Polling CLI Command

Section titled “Using the SNMP Polling CLI Command”

To troubleshoot SNMP polling issues, you can use the following CLI command:

Terminal window
php artisan rconfig:snmp-poll-device {device_id?} {--walk}
  • device_id (optional): Specify the ID of the device to poll. If omitted, all devices will be polled.
  • --walk (optional): Perform an SNMP walk for detailed data collection.

Common Issues:

Section titled “Common Issues:”
  • Missing snmpwalk Command: Ensure the snmpwalk tool is installed on the server. If not, install the SNMP tools package.
  • No SNMP Polling Group: Verify that the device has an associated SNMP polling group.

This command provides detailed output for each device, including OID statuses and data, making it a powerful tool for diagnosing SNMP-related issues.

Before contacting support, ensure:

  • SNMP connectivity is functional.
  • The correct SNMP version and credentials (e.g., v2c public string, v3 credentials) are configured.
  • Firewalls allow SNMP traffic.
  • Application logs and debug commands are reviewed for errors.

Functionality

Section titled “Functionality”

Polling groups are invoked during configuration backups and downloads. The latest polled data is displayed in the UI and Inventory Reports. SNMP Polling is a powerful feature that provides valuable device properties for network management and monitoring.

Conclusion

Section titled “Conclusion”

SNMP Polling in rConfig provides a robust way to retrieve and display device properties. By setting up SNMP OIDs, connections, and polling groups, you can gather valuable data during configuration backups. Logs and debugging tools make it easy to troubleshoot and optimize your SNMP Polling setup.