Event Notifications
Applies To: Opalis 6.3
By default, event notifications are sent to the Events tab in the client. In addition, you can send these event notifications to an SNMP trap destination. The Opalis Event Delivery Configuration utility enables you to add and configure the SNMP trap destinations where you want to deliver the event notifications. In addition to the notifications generated by the self-monitoring feature, events are also generated by objects that fail to run or by integration packs when they cannot connect to third-party systems.
To run the Opalis Event Delivery Configuration utility
At a command prompt, go to the location where the executable is stored, by default, System Drive:\Program Files\Opalis Software\Opalis Integration Server\Management Service.
Type the name of the Opalis Event Delivery Configuration utility executable oedc followed by the applicable parameters and switches. See the following sections for the syntax and options. Use lower-case letters and place the commands and parameters in the order presented in the examples.
Restart the Action Server service and the Action Server Watchdog service.
Add an SNMP Trap Destination
Use this function to configure an SNMP trap destination. Event messages will be sent to both the Events tab in the client, and to the SNMP trap destinations that you add.
Syntax: oedc /snmp /add /ipaddress /port /version/community
Example: oedc /snmp /add /ip 10.1.1.10 /port 162 /version SNMP1 /community opalis
Switches:
/snmp – the operation that instructs the utility to work with SNMP traps.
/add – the parameter that instructs the utility to add an entry to the SNMP traps list.
/ip – the IP address of the computer where you send the SNMP trap.
/port – the port that you use to send the SNMP trap.
/version – the version of the SNMP protocol that you use when sending the SNMP trap.
/community – the community string that will be used for authenticating the SNMP trap.
Remove All SNMP Trap Destinations
Use this function to remove all SNMP trap destinations that you configured. You cannot remove individual SNMP trap destinations. After you remove the SNMP trap destinations, event messages will only be sent to the Events tab in the client.
Syntax: oedc /snmp /clear
Example: oedc /snmp /clear
Switches:
/snmp – the operation that instructs the utility to work with SNMP traps.
/clear – the parameter that instructs the operation to clear all SNMP trap destinations.
Handling SNMP Traps
After you have configured an SNMP trap destination for Opalis event notifications, you can handle them using any tool that reads SNMP traps, or you can use the Monitor SNMP Trap object to read the information. The content of SNMP traps will be limited to the first 1000 characters if the content exceeds that length.
The variable bindings are as follows:
Trap Enterprise ID |
1.3.6.1.4.1.4217.100.100 |
Generic ID |
(6) |
Specific ID |
(1) |
Opalis Event Information IDs |
Opalis Event Type – 1 Opalis Event Summary – 2 Opalis Event Details – 3 |
Example: |
Opalis Event Type – 1.3.6.1.4.1.4217.100.100.1 Opalis Event Summary – 1.3.6.1.4.1.4217.100.100.2 Opalis Event Details – 1.3.6.1.4.1.4217.100.100.3 |
Using the Opalis MIB File
Some external SNMP monitoring software may require the use of the Opalis MIB file. This file is located in the Support\SNMP folder.