hp industry standard servers november 2002 Insight Manager 7 SNMP Extensions utility technical white paper table of contents abstract take control of the management environment management basics 2 2 2 SNMP Extensions features 7 information retrieved from MIBS SNMP operations by agent how can SNMP Extensions help? setting up the environment the set of installed MIBs protecting source MIBs managing MIBs from Insight Manager 7 registering a MIB why registration fails unregistering a MIB uploading a MI
Insight Manager 7 SNMP Extensions utility abstract Insight Manager 7 is a systems management application that lets you monitor the status of a device, its component objects, and their attributes. Insight Manager 7 reports on the device status, creates event and trap reports on device conditions, and performs a specific set of actions on managed devices. Insight Manager 7 includes SNMP Extensions Toolkit, a group of components that allows you to manipulate your management environment.
Insight Manager 7 SNMP Extensions utility The MIB is a virtual mapping of variables to physical hardware and its related devices. SNMP abstracts the control of the device through these variables. The below figure illustrates the interaction of the management application, the agents on a device, and the MIB databases. The configuration in this diagram shows two MIB databases. Multiple MIB databases within the same configuration should have the same versions of a MIB.
Insight Manager 7 SNMP Extensions utility variable name and description Syslocation The physical location of this node. (For example, the telephone closet, 3rd floor). SysDescr A textual description of the entity. This value should include the full name and version identification of the system’s hardware type, software operating system, and networking software. It is mandatory that this only contain printable ASCII characters.
Insight Manager 7 SNMP Extensions utility information retrieved from MIBS MIBs often organize their information by object groups that contain a related collection of variables. MIB variables contain attributes that include: • The data type • A textual description • The read or write access • Whether the variable is mandatory or optional MIBs contain the traps that the device can generate. Traps are messages the device sends when specific conditions occur.
Insight Manager 7 SNMP Extensions utility In order to send and receive traps, the managed object and the management application must be configured correctly: how can SNMP Extensions help? • The managed object must have a trap destination to direct traps to the server running the management application. • The management server must be configured to receive the traps.
Insight Manager 7 SNMP Extensions utility In addition to external MIB sources for third-party devices, you can continue to register new releases of HP MIBs that are distributed between releases of Insight Manager 7. New MIBs are distributed periodically on Management CDs. For the latest versions of HP MIBs, visit the website http://www.hp.com./ SNMP Extensions features SNMP Extensions contains a graphical user interface to a MIB compiler that is a part of Insight Manager 7.
Insight Manager 7 SNMP Extensions utility The SNMP Extensions Toolkit is intended for administrators and network managers who also have administrator privileges in Insight Manager 7. SNMP Extensions requires administrator privileges because core server SNMP definitions of Insight Manager 7 might be modified. the set of installed MIBs Insight Manager 7 provides a set of MIBs that are already registered into the database.
Insight Manager 7 SNMP Extensions utility starting SNMP Extensions 1. Browse to Insight Manager 7 on the server system using the URL for the server. For example: http://server_name:280/ 2. After the Device Overview page is displayed, click the Tools tab. 3. Select SNMP Extensions and click MIB Registration. The MIB Registration page is displayed. 4. Examine the elements on the page. You will see the lists of registered and unregistered MIBs and the options you have for working with them.
Insight Manager 7 SNMP Extensions utility registering a MIB Registration of a MIB compiles the information into the Insight Manager 7 database. MIBs require a short interval to become fully registered. The more information, such as the number of traps, the longer the registration takes. When you register, you can create a logfile and an editfile for a MIB. Logfiles—A logfile is a record of the MIB registration. A logfile is created in the subdirectory Program Files\HP\HP Insight Manager 7.07\log.
Insight Manager 7 SNMP Extensions utility registering a MIB 1. Click the Tools tab. 2. From the menu, select SNMP Extensions and click MIB Registration. 3. Select a MIB from the Unregistered MIBs column. 4. At Options for Register, select either or both file creation options: Create Logfile Use Editfile. Then choose one of the following options: • Create Editfile—Registers the selected MIB (using the source MIB file), and creates a new REV file if one does not exist for the selected MIB.
Insight Manager 7 SNMP Extensions utility unregistering a MIB Unregistering removes the MIB information from the database along with the dependent MIBs and removes any associated events, whether the information comes from the MIB or from its REV editfile. Unless you remove the MIB from the \Mibs directory, it remains in the Unregistered MIBs column. 1. Select the MIB from the Registered MIBs column. 2. Click Unregister.
Insight Manager 7 SNMP Extensions utility editing a MIB Begin on the SNMP Extensions MIB Registration page. Select a MIB from the Registered MIBs column. 1. Click Edit Registered MIB. The SNMP Trap Edit page opens. On the edit page, the traps associated with the selected MIB are displayed for editing. 2. Click the drop-down list to view the traps that are defined in the MIB. Select one. The trap's corresponding information is displayed. Modify the MIB information in any of the following ways.
Insight Manager 7 SNMP Extensions utility unregistering an installed MIB unregistering a MIB from the MIB Registration page deleting unregistered MIBS When a device is removed from the network, you can remove the MIB that supports it. SNMP Extensions Unregister function also removes all database references to the MIB and any dependent MIBs. If you reinstall the device in the future, reregister the MIB into the database.
Insight Manager 7 SNMP Extensions utility using trap categories Trap Categories are logical groupings of SNMP traps. Categories are used to sort the Event by Type criteria list. SNMP Extensions lets you modify existing assignments by moving traps between categories. SNMP Extensions also enables you to create new categories and move traps from the default assignment to the new category.
Insight Manager 7 SNMP Extensions utility changing trap category assignments • Application—Traps generated by miscellaneous applications, such as the BMC Patrol tools or Load Sharing Facility (LSF) V2.2 for UNIX systems. Note that this does not cover the Novell specific traps. Due to the large volume of NetWare OS-specific traps, Novell traps are categorized separately. • Threshold—Traps generated when monitored variables that are not in a specific category cross a defined threshold.
Insight Manager 7 SNMP Extensions utility Note: To take full advantage of the SNMP Explorer, you should be familiar with MIB-II structure and variables. You can examine MIB variables of any registered MIB in SNMP Explorer with the exception of complex variables, which have OIDs with lists or tables or variable OIDs that require you to specify a specific instance of the OID. opening the SNMP Explorer: 1. Click the Devices tab. 2. From the menu, click Device Queries. 3.
Insight Manager 7 SNMP Extensions utility field purpose Type One of several types, including INTEGER, STRING, IP ADDRESS, COUNTER, TIMETICKS, and GAUGE. Access One of several access types, including READ, WRITE, or READ-WRITE. Status The status for the variable in this MIB, such as MANDATORY, DEPRECATED, OPTIONAL, or OBSOLETE. Database Display Field Description of the variable and its purpose.
Insight Manager 7 SNMP Extensions utility verifiying the SNMP settings If you are an administrator, you can change the SNMP settings on the fly. This is useful if you need to change the community string, timeouts, or retries. 1. Click Show Device Settings. 2. Change the settings as necessary on the SNMP Settings page. 3. Click Submit to change the settings or Reset to restore them. 4. Click Return to go back to the SNMP Explorer page.
Insight Manager 7 SNMP Extensions utility The above command generates an editfile for corrections. The mibfile name is the name of the MIB with the .mib extension added on. mCompile [-c [-n "trapHandlerClass"] (-C | ) The above command applies changes to the database that were made to the commented REV file. The mibfile name is the name of the MIB with the .mib extension added on. The corresponding REV file has the name of the MIB with the .rev extension. mCompile -f
Insight Manager 7 SNMP Extensions utility running the mCompile command The command line program runs from an MS-DOS Prompt window. To open a DOS window: 1. From the desktop, click Start—>Run. In the Open field, enter cmd.exe. 2. Click OK. 3. Change to the directory where Insight Manager 7 is installed. For example, the command to change the default installation directory is: CD C:\Program Files\HP\HP Insight Manager 7 4. On the command line, enter: mcompile.
Insight Manager 7 SNMP Extensions utility a command line example The following shows the display of a mCompile command without parameters or switches. The single command presents all mCompile options. C:\Program Files\HP\Insight Manager 7>mcompile C:\Program Files\HP\Insight Manager 7>runtime\bin\ jre -ms8m -mx750m -cp lib\jgl3.1.0.jar;.;lib\swing.jar;lib\windows.jar;lib\msxml.jar;lib\ activation.jar;lib\mail.jar compaq.protocol.snmp.MibMgr.MibCompiler.
Insight Manager 7 SNMP Extensions utility where, -c Make database corrections (after a normal mib installation). -C Compile MIB then perform editfile operation. -d Delete a mib file (and all MIBs that import it). -D Enable debug mode (to screen). -f mib files. Specify a filename (with Full Path)containing a list of -g Generate an editfile for database corrections. -l List of mib files in database. -L Generate specified logfile. -n Java 'Notice' handler. Default is 'compaq.protocol.snmp.
Insight Manager 7 SNMP Extensions utility troubleshooting a failed registration The MIB may not register. If the MIB registration is unsuccessful, a message is displayed with a possible explanation. Registration most often fails for the following circumstances: • The program cannot import a dependency file. MIBs often refer to other MIBs, known as dependents. Dependent MIBs must be in the same location as the MIB that names them as dependents. Read the MIB you are registering to find the dependent MIBs.
Insight Manager 7 SNMP Extensions utility MapleConnection: Real Close!! freed: false protocol.snmp.MibMgr.db.dbSql:173 Compile Done compiling a MIB with an Error: badmib.MIB The following is an example of an invalid MIB. The nctmgt.mib was renamed to badmib.mib and line 65 was commented out. The modification causes a compilation error. >mcompile badmib.mib >runtime\bin\jre -ms8m -mx750m -cp lib\jgl3.1.0.jar;.;lib\swing.jar;lib\windows.jar;lib\msxml.jar;lib\ac tivation.jar;lib\mail.jar compaq.protocol.
Insight Manager 7 SNMP Extensions utility -- ema OBJECT IDENTIFIER ::= { dec 2 } -– BADMIB.
Insight Manager 7 SNMP Extensions utility } unknown(1) , other(2) , notInstalled(3) , notRunning(4) , running(5) , runningFailed(6) -- This MIB extension, private to Digital Equipment Corp., allows for -- management of Digital NT clusters.
Insight Manager 7 SNMP Extensions utility STATUS mandatory DESCRIPTION "Cluster software version string." ::= { ntcMgtClusterInfo 2 } ntcSoftwareStatus OBJECT-TYPE SYNTAX SoftwareStatus ACCESS read-only STATUS mandatory DESCRIPTION "Status of the cluster software: installed, running, failed, etc." ::= { ntcMgtClusterInfo 3 } ntcAlias OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "Cluster alias name.
Insight Manager 7 SNMP Extensions utility ACCESS read-only STATUS mandatory DESCRIPTION "Unique index for each entry." ::= { ntcMemberEntry 1 } ntcMemberName OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "Node name of this cluster member." ::= { ntcMemberEntry 2 } ntcMemberComment OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "Description of the node.
Insight Manager 7 SNMP Extensions utility DisplayString, ntcGroupObjects DisplayString } ntcGroupIndex OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "Unique index for each entry." ::= { ntcGroupEntry 1 } ntcGroupName OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "The group name." ::= { ntcGroupEntry 2 } ntcGroupComment OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "Description of the group.
Insight Manager 7 SNMP Extensions utility ntcGroupReevaluate OBJECT-TYPE SYNTAX Boolean ACCESS read-only STATUS mandatory DESCRIPTION “Indicates whether the object shall be reevaluated for movement to a new server when nodes in the group go up or down.” ::= { ntcGroupEntry 7 } ntcGroupMembers OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION “This is a list of member names where each name is separated by a space.
Insight Manager 7 SNMP Extensions utility ntcObjectComment DisplayString, ntcObjectType ObjectType, ntcObjectDrives DisplayString } ntcObjectIndex OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "Unique index for each entry." ::= { ntcObjectEntry 1 } ntcObjectName OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "Name of the cluster object.
Insight Manager 7 SNMP Extensions utility -- Information that reflects the last significant event (failover, failback, -- etc) -- Note - this is not a valid group but is a repository for those variables -- which need to be returned in a trap. Requesting a get or get-next of any -- variables in this group will result in a no such name error.
Insight Manager 7 SNMP Extensions utility --TRAP: ntcTransitionTrap -ntcTransitionTrap TRAP-TYPE ENTERPRISE ntcMgt VARIABLES { ntcLastTransMember, ntcLastTransGroup, ntcLastTransOnline, ntcLastTransTimestamp, ntcLastTransSequence, ntcLastTransReason } DESCRIPTION "Generated when a group transition occurs (failover or failback)." ::= 100 for more information END To learn more about Insight Manager 7, see the Insight Manager 7 Technical Reference Guide, or visit our website at: http://www.hp.
