Enabling SNMP events

If you want to be notified about cluster events, enable this feature. By default, events are not enabled.

Procedure

  1. Edit the ego.conf file to specify two parameters under the EGO event configuration section.

    The EGO_EVENT_PLUGIN and EGO_EVENT_MASK parameters are already included in the ego.conf file with default values, but may be commented out.

  2. Set up an SNMP v1 (Simple Network Management Protocol version 1) trap for EGO events.
    1. Specify the name and configuration file location with your SNMP information. The plug-in name must not include a suffix (.dll or .so):
      EGO_EVENT_PLUGIN=plugin_name[plugin_conf]…
      For example:
      EGO_EVENT_PLUGIN=eventplugin_snmp[SINK=host,MIBDIRS=EGO_TOP/mibs]
      where host represents the name of the host on which the SNMP trap daemon is running and EGO_TOP represents the top-level directory for EGO (for Windows, this is Installation_top).
      SNMP traps enable an agent to notify the management station of significant events by way of an unsolicited SNMP message. Note the following:
      • The MIBDIRS directory may also equal $EGO_CONFDIR/kernel/conf/mibs.
      • In a Windows environment, use quotation marks around the event plug-in definition.

        For example, EGO_EVENT_PLUGIN="eventplugin_snmp[SINK=host,MIBDIRS=Installation_top\mibs]"

    2. You can modify the default port (port 162) by specifying TRAPPORT=port_number in the string.
      EGO_EVENT_PLUG_IN="eventplugin_snmp[…,TRAPPORT=port_number]"

      Note that in a Linux® environment, do not use quotation marks around the event plug-in definition.

  3. Set EGO_EVENT_MASK to the log level you want.
    EGO_EVENT_MASK must be set to one of the following values:
    • LOG_ERR: Provides information about error events only
    • LOG_WARNING: Provides information about warning and error events
    • LOG_INFO: (Default) Provides information about all events

    For example, EGO_EVENT_MASK=LOG_INFO.

  4. Save the ego.conf file and restart your cluster.
  5. Using your SNMP manager, select what actions it takes when it receives a specific trap. See your SNMP manager help for more information.