Nagios XI - Switch and Router Wizard Architecture
Network Switch and Router Wizard Overview
Nagios XI uses configuration wizards to configure commands and services for any kind of monitoring. The Switch and Router wizard is specifically designed for monitoring network devices and does this using SNMP (Simple Network Management Protocol). This document describes how the Switch/Router wizard is designed and the components that make it work, and includes troubleshooting information.
Network Switch and Router Architecture
The Switch and Router Wizard is accessible in Nagios XI by navigating to Configure > Run The Monitoring Wizard > Network Switch / Router
Here is the architectural overview of the Network Switch and Router Wizard on a router with the IP Address of 192.168.5.1:
When you access the monitoring wizard you will encounter a number of steps to setup the wizard. It will ask for the following information:
MRTG and cfgmaker
The core of the Switch and Router wizard is a Perl configuration creation program called MRTG. It uses Perl to parse and write out configuration files by accepting arguments and files that are passed to it.
Here are the important file locations that MRTG will use to create the monitoring configuration for Nagios XI:
*mrtg device config folder- where cfgmaker writes to AND where the mrtg cron job will check for updates:
mrtgscan files- this is where the wizard will find existing mrtgscan files:
Here is the file name formatting for both types of MRTG configuration files:
Device configuration format in ../conf.d/:
mrtgscan config format in ../nagiosxi/tmp/:
When additions are made to the mrtg.cfg file by the Nagios XI Switch and Router Wizard then you will see this indicator. This is a good way to make sure the files are being written:
#### ADDED BY NAGIOSXI (USER: %s, DATE: %s) ####
This is the plugin that runs the Network Switch and Router wizard. It's use is described in the first few description lines:
# Check ifoperstatus() without calling the perl routine, this script uses
check_ifoperstatnag was created from ifoperstatus and allows SNMPv3 permission variables that are needed by version 3. Then, retrieve the trap data we want using snmpwalk which is highly customizable. This will also account for administratively down interfaces before the snmpwalk is ran.
The command definition templates are simple and designed to accept the arguments from the wizard:
You can see the command definition utilizing the check_ifoperstatnag plugin in the command definitions.
The most common issues with the Switch and Router wizard will involve MRTG dependencies, configuration and permissions. Check Perl Dependencies.
Trap/ MIB Definitions Missing
If you aren't able to parse or receive information about one of your network devices it could be because you do not have the proper MIB installed for the specific device. Many manufactures make MIBs for their devices so you will need to find them and discover which dependencies they require. Nagios XI has a large number of basic MIBs that are needed for basic devices including SNMPv1 and SNMPv2, but it is important to make sure that you install MIBs in order of dependency or the MIB definition will not be correctly written to the snmptt.conf page.
You can Manage MIB files for all of your devices by navigating to Admin > Manage MIBs (under System Extensions on the left side navigation tab).
Here you can find links to locate MIBs, Upload MIBs into your Nagios XI /usr/share/snmp/mibs/ directory, Process trap definitions for MIBs you upload and save/delete MIBs that are currently located in your /usr/share/snmp/mibs/ directory. (Note that when you use the Nagios XI user interface that the owner and group of the MIB files will be apache:apache because we are accessing them form the web interface. This won't matter unless you have another process, like snmptt for example, trying to read the MIB files themselves.)
For any support related questions please visit the Nagios Support Forums at:
|Posted by: lgroschen - Fri, Feb 6, 2015 at 1:38 PM. This article has been viewed 4423 times.|
|Online URL: https://support.nagios.com/kb/article/nagios-xi-switch-and-router-wizard-architecture-62.html|
Powered by PHPKB (Knowledge Base Software)