Lustre SNMP Module

C H A P T E R 14

Lustre SNMP Module

The Lustre SNMP module reports information about Lustre components and system status, and generates traps if an LBUG occurs. The Lustre SNMP module works with the net-snmp. The module consists of a plug-in (lustresnmp.so), which is loaded by the snmpd daemon, and a MIB file (Lustre-MIB.txt).

This chapter describes how to install and use the Lustre SNMP module, and includes the following sections:

Installing the Lustre SNMP Module

Building the Lustre SNMP Module

Using the Lustre SNMP Module

14.1 Installing the Lustre SNMP Module

To install the Lustre SNMP module:

1. Locate the SNMP plug-in (lustresnmp.so) in the base Lustre RPM and install it.

/usr/lib/lustre/snmp/lustresnmp.so

2. Locate the MIB (Lustre-MIB.txt) in /usr/share/lustre/snmp/mibs/Lustre-MIB.txt and append the following line to snmpd.con.

dlmod lustresnmp /usr/lib/lustre/snmp/lustresnmp.so

3. You may need to copy Lustre-MIB.txt to a different location to use few tools. For this, use either of these commands.

~/.snmp/mibs 
/usr/local/share/snmp/mibs

14.2 Building the Lustre SNMP Module

To build the Lustre SNMP module, you need the net-snmp-devel package. The default net-snmp install includes a snmpd.conf file.

1. Complete the net-snmp setup by checking and editing the snmpd.conf file, located in /etc/snmp

/etc/snmp/snmpd.conf

2. Build the Lustre SNMP module from the Lustre src.rpm

Install the Lustre source

Run ./configure

Add the --enable-snmp option

14.3 Using the Lustre SNMP Module

Once the Lustre SNMP module in installed and built, use it for purposes:

For all Lustre components, the SNMP module reports a number and total and free capacity (usually in bytes).

Depending on the component type, SNMP also reports total or free numbers for objects like OSD and OSC or other files (LOV, MDC, and so on).

The Lustre SNMP module provides one read/write variable, sysStatus, which starts and stops Lustre.

The sysHealthCheck object reports status either as healthy' or 'not healthy' and provides information for the failure.

The Lustre SNMP module generates traps on the detection of LBUG (lustrePortalsCatastropeTrap), and detection of various OBD-specific healthchecks (lustreOBDUnhealthyTrap).