Creating a Simple Network Management Protocol (SNMP) trap action
You use the SNMP trap action if you want OpenEdge Management resource-related event notifications to be sent to your SNMP management console. You define properties to send event notifications, referred to as traps, to SNMP management consoles such as BMC's PATROL Enterprise Manager Connect SNMP and Tivoli Enterprise Console.
The SNMP trap action generates an asynchronous message to an SNMP management console.
Note the following information about SNMP trap actions:
To define SNMP trap actions, you must have previously installed the OpenEdge Management SNMP Adapter product. You must also define the OpenEdge Management SNMP Adapter option on the OpenEdge Management Configuration page.
Since OpenEdge supports SNMP versions 2c and 3, the SNMP trap action properties are set based on the SNMP version.
All OpenEdge Management-specific SNMP variables and tables are located in the OpenEdge Management Information Base (MIB). The MIB file, PSC-FM-MIB.txt, is located in the config directory of your OpenEdge Management installation folder. By default, this location is Progress\oemgmt\config.
Review the contents of this file and focus specifically on the fmalertTable, which contains information specific to each alert. The alert ID information in this file allows you to understand the contents of this table.
The following table contains two examples that show how you can obtain alert details from the fmalertTable.
Table 7. Alert details obtained from the fmalertTable
To obtain an alert reason associated with Alert ID . . .
Issue an SNMP GET request using this Object Identifier (OID) . . .
3
1.3.6.1.4.1.1730.1.2.1.1.6.1.6.3
4
1.3.6.1.4.1.1730.1.2.1.1.6.1.6.4
For more information about the SNMP Adapter and its configuration, refer to the Changing the OpenEdge Management SNMP Adapter settings section in OpenEdge Management and OpenEdge Explorer: Getting Started. For information about initiating SNMP GET requests from an SNMP agent, see the SNMP documentation for your particular SNMP management console product.
To create an SNMP Trap Action:
1. In the OpenEdge Management console menu, choose one:
Select Library > New > SNMP Trap Action.
Select Library > Go to Library > Create SNMP Trap Action.
The Create new SNMP Trap Action page appears.
2. Enter the name in the Name field. You must not use spaces or special characters such as an asterisk (*), ampersand (&), or period ( . ) in the Name field.
3. Enter a description in the Description field.
4. Enter the name of the host machine on which the SNMP management agent resides in the Host field. Traps will be sent to this host machine. (If you set a default value for the Host field on the OpenEdge Management Configuration page, that value appears in this field.)
5. Enter the port number of the host machine on which the SNMP management agent resides in the Port field. Traps will be sent to this port number on the host machine. (If you set a default value for the Port field on the OpenEdge Management Configuration page, that value appears in this field.)
6. Select the SNMP adapter settings to be used for the trap by setting the Settings to use option.
To use the SNMP adapter settings, select Use preference settings.
To manually set the SNMP adapter settings, select Use trap settings.
If the SNMP version is set as version 2c (in Options > SNMP Adapter), the read community value of the SNMP adapter is displayed in the Read Community field. This is the community that will have read access to the trap information. You can customize the value by entering public, private, or any other community that you have set up for access.
If the SNMP version is set as version 3, the security configuration of the SNMP adapter is displayed. You can customize these settings for the SNMP trap. For more information on the SNMP Adapter settings for version 3, refer to the Changing the OpenEdge Management SNMP Adapter settings section in OpenEdge Management and OpenEdge Explorer: Getting Started.
While creating a trap action for SNMP version 3, if you do not set the authentication and privacy passwords, the SNMP adapter passwords are used as default. If you do enter new passwords, these passwords take precedence over the SNMP adapter passwords and are henceforth used as default.
7. Click Save.
Once you have set up SNMP trap actions, you can associate them with resources just as you would any OpenEdge Management action. When the resource generates an alert, the SNMP trap action is thrown.
You can review the contents of the trap (known as variable bindings) as they are defined in the MIB. You can query these variables any time the OpenEdge Management SNMP Adapter agent is running.
To define SNMP trap actions, you must have previously installed the OpenEdge Management SNMP Adapter product. You must also define the OpenEdge Management SNMP Adapter option on the OpenEdge Management Configuration page.