Configuring SNMP manager

Simple Network Management Protocol (SNMP) is a standard protocol for managing networks and exchanging messages. The system can send SNMP messages that notify personnel about an event. You can use an SNMP manager to view the SNMP messages that the system sends.

With an SNMP manager, such as IBM® Systems Director, you can view, and act on the messages that the SNMP agent sends. The SNMP manager can send SNMP notifications, which are also known as traps, when an event occurs in the system. Select Settings > Event Notifications > SNMP Manager to configure SNMP managers for event notifications. You can specify up to a maximum of six SNMP managers.

In the SNMP mode of event notification, one SNMP notification (trap) with object identifiers (OID) .1.3.6.1.4.1.2.6.212.10.0.1 is sent by the GUI for each event. The following table provides the SNMP objects included in the event notifications.

Table 1. SNMP objects included in event notifications
OID	Description	Examples
.1.3.6.1.4.1.2.6.212.10.1.1	Cluster ID	317908494245422510
.1.3.6.1.4.1.2.6.212.10.1.2	Entity type	SERVER, FILESYSTEM
.1.3.6.1.4.1.2.6.212.10.1.3	Entity name	gss-11, fs01
.1.3.6.1.4.1.2.6.212.10.1.4	Component	SMB, AUTHENTICATION
.1.3.6.1.4.1.2.6.212.10.1.5	Severity	SEVERE, WARN, INFO
.1.3.6.1.4.1.2.6.212.10.1.6	Date and time	17.02.2016 13:27:42.516
.1.3.6.1.4.1.2.6.212.10.1.7	Event name	MS1014
.1.3.6.1.4.1.2.6.212.10.1.8	Message	At least one CPU of "gss-11" is failed.
1.3.6.1.4.1.2.6.212.10.1.9	Reporting node	The node where the problem is reported.

Understanding the SNMP OID ranges

The following table gives the description of the SNMP OID ranges.

Table 2. SNMP OID ranges
OID range	Description
.1.3.6.1.4.1.2.6.212	IBM Spectrum Scale™
.1.3.6.1.4.1.2.6.212.10	IBM Spectrum Scale GUI
.1.3.6.1.4.1.2.6.212.10.0.1	IBM Spectrum Scale GUI event notification (trap)
.1.3.6.1.4.1.2.6.212.10.1.x	IBM Spectrum Scale GUI event notification parameters (objects)

The traps for the core IBM Spectrum Scale and those trap objects are not included in the SNMP notifications that are configured through the IBM Spectrum Scale management GUI. For more information on SNMP traps from the core IBM Spectrum Scale, see GPFS SNMP support

Example for SNMP traps

The following example shows the SNMP event notification that is sent when Start of change

performance monitoring sensor is shut down on a node End of change

SNMPv2-MIB::snmpTrapOID.0 = OID: SNMPv2-SMI::enterprises.2.6.212.10.0.1	
SNMPv2-SMI::enterprises.2.6.212.10.1.1 = STRING: "317908494245422510"	
SNMPv2-SMI::enterprises.2.6.212.10.1.2 = STRING: "NODE"	
SNMPv2-SMI::enterprises.2.6.212.10.1.3 = STRING: "gss-11"	
SNMPv2-SMI::enterprises.2.6.212.10.1.4 = STRING: "PERFMON"	
SNMPv2-SMI::enterprises.2.6.212.10.1.5 = STRING: "ERROR"	
SNMPv2-SMI::enterprises.2.6.212.10.1.6 = STRING: "18.02.2016 12:46:44.839"	
SNMPv2-SMI::enterprises.2.6.212.10.1.7 = STRING: "pmsensors_down"	
SNMPv2-SMI::enterprises.2.6.212.10.1.8 = STRING: "pmsensors service should be started and is stopped"
SNMPv2-SMI::enterprises.2.6.212.10.1.9 = STRING: "gss-11"

The following example shows the SNMP event notification that is sent for an SNMP test message: Start of change

SNMPv2-MIB::snmpTrapOID.0 = OID: SNMPv2-SMI::enterprises.2.6.212.10.0.1
SNMPv2-SMI::enterprises.2.6.212.10.1.1 = STRING: "317908494245422510"
SNMPv2-SMI::enterprises.2.6.212.10.1.2 = STRING: "CLUSTER"
SNMPv2-SMI::enterprises.2.6.212.10.1.3 = STRING: "UNKNOWN"
SNMPv2-SMI::enterprises.2.6.212.10.1.4 = STRING: "GUI"
SNMPv2-SMI::enterprises.2.6.212.10.1.5 = STRING: "INFO"
SNMPv2-SMI::enterprises.2.6.212.10.1.6 = STRING: "18.02.2016 12:47:10.851"
SNMPv2-SMI::enterprises.2.6.212.10.1.7 = STRING: "snmp_test"
SNMPv2-SMI::enterprises.2.6.212.10.1.8 = STRING: "This is a SNMP test message."
SNMPv2-SMI::enterprises.2.6.212.10.1.9 = STRING: "gss-11"

SNMP MIBs

The SNMP Management Information Base (MIB) is a collection of definitions that define the properties of the managed objects.

The IBM Spectrum Scale GUI MIB OID range starts with 1.3.6.1.4.1.2.6.212.10. The OID range 1.3.6.1.4.1.2.6.212.10.0.1 denotes IBM Spectrum Scale GUI event notification (trap) and .1.3.6.1.4.1.2.6.212.10.1.x denotes IBM Spectrum Scale GUI event notification parameters (objects). Use the following text to configure IBM Spectrum Scale GUI MIB:

IBM-SPECTRUM-SCALE-GUI-MIB DEFINITIONS ::= BEGIN

IMPORTS        
        MODULE-IDENTITY,
        OBJECT-TYPE,
        NOTIFICATION-TYPE,
        Counter64, 
        enterprises
                FROM SNMPv2-SMI
        DisplayString
                FROM RFC1213-MIB;

ibmSpectrumScaleGUI MODULE-IDENTITY
        LAST-UPDATED "201607080000Z"    -- July 08, 2016
        ORGANIZATION "International Business Machines Corp."
        CONTACT-INFO ""   
        DESCRIPTION  "Definition of Specrum Scale GUI Notifications for Spectrum Scale product. 
                      These objects are subject to modification by IBM as product specifications require."
        	
	-- Revision log, in reverse chronological order	
		
	REVISION "201607080000Z"    -- July 08, 2016
        DESCRIPTION "Version 0.2." 
                            ::= { ibmGPFS 10 }

-- ibmGPFS is copied from GPFS MIB (/usr/lpp/mmfs/data/GPFS-MIB.txt)
ibm                   OBJECT IDENTIFIER ::= { enterprises 2 }
ibmProd               OBJECT IDENTIFIER ::= { ibm 6 }
ibmGPFS               OBJECT IDENTIFIER ::= { ibmProd 212 }

ibmSpectrumScaleGuiNotification OBJECT IDENTIFIER ::= { ibmSpectrumScaleGUI 0}
ibmSpectrumScaleGuiEventObject OBJECT IDENTIFIER ::= { ibmSpectrumScaleGUI 1}

--- ********************************************************************************
--  IBM Spectrum Scale GUI Scalar object declarations - accessible for notifications
--- ********************************************************************************
ibmSpectrumScaleGuiEventCluster OBJECT-TYPE
        SYNTAX DisplayString (SIZE (0..255))
        MAX-ACCESS accessible-for-notify
        STATUS current
        DESCRIPTION
                "The cluster where the notification occurred."
      ::= { ibmSpectrumScaleGuiEventObject 1 }

ibmSpectrumScaleGuiEventEntityType OBJECT-TYPE
        SYNTAX DisplayString (SIZE (0..255))
        MAX-ACCESS accessible-for-notify
        STATUS current
        DESCRIPTION
                "The type of entity for which the notification occurred."
      ::= { ibmSpectrumScaleGuiEventObject 2 }

ibmSpectrumScaleGuiEventEntityName OBJECT-TYPE
        SYNTAX DisplayString (SIZE (0..255))
        MAX-ACCESS accessible-for-notify
        STATUS current
        DESCRIPTION
                "The name of the entity for which the notification occurred."
      ::= { ibmSpectrumScaleGuiEventObject 3 }

ibmSpectrumScaleGuiEventComponent OBJECT-TYPE
        SYNTAX DisplayString (SIZE (0..255))
        MAX-ACCESS accessible-for-notify
        STATUS current
        DESCRIPTION
                "The component for which the notification occurred."
      ::= { ibmSpectrumScaleGuiEventObject 4 }

ibmSpectrumScaleGuiEventSeverity OBJECT-TYPE
        SYNTAX DisplayString (SIZE (0..255))
        MAX-ACCESS accessible-for-notify
        STATUS current
        DESCRIPTION
                "The severity."
      ::= { ibmSpectrumScaleGuiEventObject 5 }

ibmSpectrumScaleGuiEventTime OBJECT-TYPE
        SYNTAX  DisplayString (SIZE (0..255))
        MAX-ACCESS accessible-for-notify
        STATUS current
        DESCRIPTION
                "A representation of the date and time when the notification occurred."
      ::= { ibmSpectrumScaleGuiEventObject 6 }

ibmSpectrumScaleGuiEventName OBJECT-TYPE
        SYNTAX DisplayString (SIZE (0..255))
        MAX-ACCESS accessible-for-notify
        STATUS current
        DESCRIPTION
                "The event name."
      ::= { ibmSpectrumScaleGuiEventObject 7 }

ibmSpectrumScaleGuiEventMessage OBJECT-TYPE
        SYNTAX DisplayString (SIZE (0..1492))
        MAX-ACCESS accessible-for-notify
        STATUS current
        DESCRIPTION
                "The human readable message of the notification."
      ::= { ibmSpectrumScaleGuiEventObject 8 }
	  
ibmSpectrumScaleGuiEventReportingNode OBJECT-TYPE
        SYNTAX DisplayString (SIZE (0..255))
        MAX-ACCESS accessible-for-notify
        STATUS current
        DESCRIPTION
                "The node that reported the event."
      ::= { ibmSpectrumScaleGuiEventObject 9 }
	  
ibmSpectrumScaleGuiNotificationEvent NOTIFICATION-TYPE
        OBJECTS {
            ibmSpectrumScaleGuiEventCluster,         
            ibmSpectrumScaleGuiEventEntityType,
            ibmSpectrumScaleGuiEventEntityName,
            ibmSpectrumScaleGuiEventComponent,
            ibmSpectrumScaleGuiEventSeverity,
            ibmSpectrumScaleGuiEventTime,
            ibmSpectrumScaleGuiEventName,
            ibmSpectrumScaleGuiEventMessage,
            ibmSpectrumScaleGuiEventReportingNode          
         }
         STATUS  current
         DESCRIPTION
           "This notification indicates a Health event as reported by the Spectrum Scale GUI."
        ::= { ibmSpectrumScaleGuiNotification 1 }


END