How to test SNMP functionality on the BlackBerry Enterprise Server

Article ID: KB19986

Type: Support Content

Last Modified: 04-17-2012

 

Product(s) Affected:

  • BlackBerry Enterprise Server for Microsoft Exchange
  • BlackBerry Enterprise Server for IBM Domino
CollapseEnvironment
  • BlackBerry® Enterprise Server 5.0 to 5.0 SP2 for Microsoft® Exchange
  • BlackBerry® Enterprise Server 5.0 to 5.0 SP2 for IBM® Lotus® Domino®
  • BlackBerry® Monitoring Service
CollapseOverview

BlackBerry Enterprise Server 5.0 includes the BlackBerry Monitoring Service which allows an administrator to assess the health of the BlackBerry environment. The BlackBerry Monitoring Service does this by listening for Simple Network Management Protocol (SNMP) traffic from the BlackBerry Enterprise Server.

Included with the BlackBerry Monitoring Service is a tool that also allows an administrator to quickly verify SNMP functionality in the BlackBerry environment. For more information on how to set up and use SNMP on the BlackBerry Enterprise Server, please review the BlackBerry Enterprise Server product documentation. Links to these documents can be found in the Additional Information section.

Note: If the BlackBerry Monitoring Service was not installed, this tool will not be available. To identify SNMP functionality without the use of SNMP_snapshot.exe, please review Parts 2 and 3 only.

Part 1: Verifying SNMP functionality using SNMP_snapshot.exe

The tool SNMP_snapshot.exe contains the following switches:

  • <HOST> - The host name of the system running the SNMP agent
  • <PORT> - The port that SNMP is running on. Port 161 is the standard SNMP port
  • <COMMUNITY> - The SNMP community name.
    Note:
    The Community name is case sensitive.
  • <COMPAT> - If this is present, the SNMP_Snapshot.exe tool scans for 4.1 compatible object identifiers.
  1. Open a command prompt on the BlackBerry Enterprise Server.
  2. Go to: C:\Program Files (x86)\Research In Motion\BlackBerry Enterprise Server\Monitoring Service\tools
  3. Type the following command:

    snmp_snapshot.exe <HOST> <PORT> <COMMUNITY> [COMPAT]

    1. Example: snmp_snapshot.exe BESSVR 161 BESMON
    2. Example: snmp_snapshot.exe BESSVR 161 BESMON compat
  4. An output file will be created in the same location as the tool and the filename will appear as: snmp_snapshot_<host>_<timestamp>.txt.

An example of text contained in the output file created is below. This entry for example shows the name of the BlackBerry Agent component and the numerical value is the Object Identifier (OID).

.1.3.6.1.4.1.3530.6.7.10.10.10.1.4.1.20 = 'BlackBerry Messaging Agent for IBM Lotus Domino'

The numerical value above is the called an Object Identifier (OID). To obtain the text value of the OID, proceed to Part 3.

Part 2: Verifying SNMP functionality using the SNMP Walk command

  1. Download and install a SNMP Management Information Base (MIB) browser application.
  2. Open the following MIB files located on the BlackBerry Enterprise Server in the SNMP MIB browser application.
    • C:\Program Files\Research In Motion\BlackBerry Enterprise Server\Monitoring Service\bin\BLACKBERRYSERVERMIB-SMIV2.mib
      • This is the .MIB file for the latest BlackBerry Enterprise Server version.
    • C:\Program Files\Research In Motion\BlackBerry Enterprise Server\Monitoring Service\bin\BLACKBERRYSERVERMIB-SMIv2_Compat.mib
      • This is the .mib file for the latest BlackBerry Enterprise Server version in the same format as the .mib file for BlackBerry Enterprise Server version 4.1.
  3. Configure the SNMP MIB browser application to access the SNMP Community that was set up on the BlackBerry Enterprise Server.
  4. Using the SNMP MIB browser, perform a Walk command.

After completing the steps above, the BlackBerry administrator is able to identify all SNMP information being sent by the BlackBerry Enterprise Server.

Note:
These steps may need to be modified based on the SNMP MIB browsing application that is being used. If the BlackBerry Enterprise Server MIB files are not loaded, only numerical Object Identifiers (OID) are displayed.

Part 3: Obtaining the name of a specific Object Identifier (OID) value from a MIB file

  1. Download and install a SNMP Management Information Base (MIB) browser application.
  2. Open the following MIB files located on the BlackBerry Enterprise Server in the SNMP MIB browser application.
    • C:\Program Files\Research In Motion\BlackBerry Enterprise Server\Monitoring Service\bin\BLACKBERRYSERVERMIB-SMIV2.mib
      • This is the .MIB file for the latest BlackBerry Enterprise Server version.
    • C:\Program Files\Research In Motion\BlackBerry Enterprise Server\Monitoring Service\bin\BLACKBERRYSERVERMIB-SMIv2_Compat.mib
      • This is the .mib file for the latest BlackBerry Enterprise Server version in the same format as the .mib file for BlackBerry Enterprise Server version 4.1.
  3. Configure the SNMP MIB browser application to access the SNMP Community that was set up on the BlackBerry Enterprise Server.
  4. Enter the OID (Ex. .1.3.6.1.4.1.3530.6.7.10.10.10.1.4.1.20) that was obtained in the text file generated by SNMP_snapshot.exe in Part 1 and perform a GET command.

After completing these steps, the administrator is able to identify the meaning of an OID. As per the example above, .1.3.6.1.4.1.3530.6.7.10.10.10.1.4.1.20 denotes basagentConfigPropertyname.1.20.

Note: These steps may need to be modified based on the SNMP MIB browsing application that is being used.

CollapseAdditional Information
  1. This tool is only available with BlackBerry Enterprise Server 5.0 and requires that the BlackBerry Monitoring Service is installed. For additional information on the BlackBerry Enterprise Server Monitoring Service and SNMP functionality, please review the following BlackBerry Enterprise Server documentation:

    BlackBerry Enterprise Server 5.0 SP2 for Microsoft Exchange
    BlackBerry Enterprise Server 5.0 SP2 for IBM Lotus Domino
  2. The following link is to a free MIB browser by iResoning.  It provides a tree structure of any loaded MIB file so allows quickly and easily browse down the hierarchy and find the needed information.  Selecting an item in the tree displays the OID along with other information in the details section.  The Get requests of the specified items to a host can be also performed to view their values.

    http://www.ireasoning.com/downloadmibbrowserfree.php


Disclaimer

By downloading, accessing or otherwise using the Knowledge Base documents you agree:

   (a) that the terms of use for the documents found at www.blackberry.com/legal/knowledgebase apply to your use or reference to these documents; and

   (b) not to copy, distribute, disclose or reproduce, in full or in part any of the documents without the express written consent of RIM.


Visit the BlackBerry Technical Solution Center at www.blackberry.com/btsc.