How do I forward Entuity events to Oracle Enterprise Manager?

To configure Entuity snmpforward

You can configure Entuity to automatically forward events to the Oracle Enterprise Manager server. The process is as follows:

1. Entuity generates event data.
2. Entuity configures the event data ready for forwarding. The snmpforward configuration specifies the trap forwarding filter, e.g. the type of events that can be forwarded as traps if they occur in the specified View.
3. snmpfoward then sends the data to Oracle Enterprise Manager.
4. Oracle Enterprise Manager accepts the traps data, recognizing the originating Entuity server from the trap source's IP address.

To configure Entuity snmpforward:

Configuration of the SNMP trap forwarding process, snmpforward, is through two files:

• entuity_home\etc\startup_O/S_site_specific.cfg
  • this contains a section that references the forwarding configuration file, and a routing section within it, applied to an instance of snmpforward. When Entuity starts, snmpforward also starts using the defined configuration.
• snmpforward configuration file
  • Entuity includes a sample configuration file entuity_home\etc\snmpforward_oem.cfg. It configures the events to forward, the user accounts to use and the Oracle Enterprise Manager server.

During Entuity upgrades, snmpforward_oem.cfg is backed up to entuity_home\etc\bkp, and the version in entuity_home\etc is overwritten. When you use snmpforward_oem.cfg, you should reapply your site-specific changes after an upgrade, alternatively rename your snmpforward configuration file.

To use the sample configuration:

The sample integration allows 7 event types to be forwarded to Oracle Enterprise Manager. Events are specified in the [include_events] section of the snmpforward configuration file, using the event name to identify the event type.

The 7 event types are as follows:

• AvailMonitor Low View Device Reachability.
• AvailMonitor Normal View Device Reachability.
• Network Outage.
• Network Outage Cleared.
• Service Down.
• Service State Off.
• Service State Unknown.
• Service Up.

To configure snmpforward to forward events as traps to an Oracle Enterprise Manager:

1. From the snmpforward configuration file, set the routing parameters:

   [snmp_route_1]
   agent_addr=127.0.0.1

   where:
   • agent_addr sets the IP address used by Entuity to forward traps. It must match the IP address entered when configuring the SNMP trap source in Oracle Enterprise Manager.
     
     
2. From the snmpforward configuration file, set the Entuity user account and view to be used by snmpforward:

   [snmp_reader_1]
   username=admin
   view=Regional

   where:
   • username is the Entuity user account used with snmpforward.
   • view is the Entuity business view from which Entuity forwards events. You can only
     specify one view.
     
     
3. From the destination section of the snmpforward configuration file, set the Oracle Enterprise Manager to which the traps are sent:
   

   [snmp_dest_1]
   host1=oracle_em_server:3872

   where:
   • hostn specifies the IP address, or hostname, and SNMP port number, 3872, of the target Oracle Enterprise Manager server. You can specify one or more hosts.
     
     
4. Update the appropriate start configuration file (e.g. startup_win32_site_specific.cfg, startup_unix_site_specific.cfg) to initialize snmpforward when the Entuity server starts. An example section is included in snmpforward_oem.cfg, which you can copy to the startup file:
   

   [oem_snmpforward]
   state=normal
   capabilities=polling
   type=command
   start=${ENTUITY_HOME}${FPS}integ${FPS}SNMP${FPS}snmpforward
   ${ENTUITY_HOME}${FPS}etc${FPS}snmpforward_oem.cfg snmp_route_1
   directory=${LOGDIR}
   is_critical=n

   where the only parameter you might want to amend is:
   
   • start defines the location and name of the configuration file and routing section applied to snmpforward.
     
     
5. Stop and restart the Entuity server. The configuration changes will then take effect.