MIBMON
Introduction
GENEOS MIBMON Plug-in polls a list of MIBS from a specified remote device / node. The list of MIBS is defined in the plug-in setup. The frequency of the poll is defined by the SampleInterval setting of the Sampler Descriptor.
In line with all Geneos plug-ins, this plug-in caches the current MIB values so that if the new value is the same as the cached value, the plug-in does not send updates to the Gateway.
Prerequisites
The environment variable MIBDIRS must be set to the location of the directory containing the MIB files. This allows the MIBMON Plug-in to find the MIB files which contain the type and description of the MIB variables. Setting this environment variable to the correct value will ensure that the MIBMON Plug-in will display MIB values correctly, such as the following scenarios:
- a STRING value will be displayed as a readable string instead of as a sequence of hexadecimal values.
- an OID value will be displayed in human-readable form. For example, if the OID value of ifOperStatus is 1, the MIBMON Plug-in will display "up(1)" in the dataview.
Views
The UNIVERSAL MIBMON Plug-in produces a single view as follows. The view consists of name / value pairs. It is also possible to arrange the results in a user specified table where the column and row names are defined as part of the configuration.
Plug-in Configuration
The following parameters can be configured for this plug-in:
targetNode
snmp > port
The port to be used when connecting to the device / node where the mibs are polled from.
snmp > version
Deprecated, please use snmp > snmp_version for new configurations.
The version number of the SNMP protocol used - must correspond to the version supported by the device being interrogated.
Possible values are 1 or 2c or 3
Note: When interrogated Solaris 2.6 use version 1.
snmp > community
The SNMP community name as defined by the SNMP device being monitored.
snmp > snmp_version
The version number of the SNMP protocol used - must correspond to the version supported by the device being interrogated.
Possible values are 1, 2c, or 3.
Note: When device being interrogated uses Solaris 2.6, use version 1.
snmp > V3 > securityName
The SNMPV3 user to connect to the device as.
Note: If the Trapmon and Mibmon plugins are running under the same Netprobe and they have the same username or security name, then the Mibmon plugin overwrites the users configured for the Trapmon plugin. It is recommended to use different username for querying Mibs, and for sending and receiving Traps.
snmp > V3 > authenticationOptions > authProtocol
The authentication protocol to use. Can be MD5 or SHA.
snmp > V3 > authenticationOptions > authKey
The authentication key to use. Should be greater than or equal to 8 characters.
snmp > V3 > encryptionOptions > privProtocol
The privacy protocol to use for encryption. Can be AES or DES.
snmp > V3 > encryptionOptions > privKey
The private key to use for encryption. Should be greater than or equal to 8 characters.
snmp > V3 > context
The context name of the user being used to connect to the device / node.
snmp > queryTimeout
This is the timeout setting for the SNMP query (in seconds).
mibTable > rows
Row definitions for the dataview consisting of a rowname and a number of OIDS to populate the columns.
Mandatory: Yes
mibTable > rows > row
A row definition for the dataview consisting of a rowname and a number of OIDS to populate the columns.
Mandatory: Yes
mibBase
The prefix for all the MIB OIDs. This makes it easier to define a large number of MIB names that share the same starting sequence:
mibs mib name: system.sysName OID: 1.5.0 mib name: system.sysDecr OID: 1.1.0 mibBase: 1.3.6.1.2.1 is equivalent to mibs mib name: system.sysName OID: 1.3.6.1.2.1.1.5.0 mib name: system.sysDecr OID: 1.3.6.1.2.1.1.1.0
Mandatory: No