1.8 SNMP Gateway

Configure the SNMP Gateway to send the Netcool traps.

NOTE:When both the ObjectServer Granularity property and the Gate.Reader.IducFlushRate property are set to their default values, the gateway's ability to forward alert updates is affected. If the Gate.SNMP.ForwardUpdates property is set to TRUE in these conditions, the gateway will not be able to capture all alert updates.

If you find that the event updates are not synchronized from Netcool to AppManager, then you might want to reduce the value of the Gate.Reader.IducFlushRate property to 20 seconds or so.

For more information, see Event flush rate at the IBM Web site.

For information on configuring the SNMP Gateway, review the following sections:

1.8.1 SNMP Gateway Version 0.0.1395

By default, the G_SNMP.conf file is available in the following location:

  • On Microsoft Windows computers: $OMNIHOME\ini

  • On UNIX computers: $OMNIHOME/gates/snmp/

where $OMNIHOMEis the installation path for IBM Netcool.

You must copy the G_SNMP.conf file to the following location on your UNIX computers and edit the file: $OMNIHOME/etc/

The G_SNMP.conf file uses the following syntax:

CREATE MAPPING mappingname
{
varbindint = ‘@fieldname'
[,'varbindint = ‘@fieldname' [ON INSERT ONLY]]...
);

The mappingname is the name of the mapping to be created.

The varbindint is the integer value for the varbind field that will be written to in the SNMP trap.

The fieldname is the name of the field in the ObjectServer alerts.status table.

Mapping for Version 0.0.1395

Replace the mapping supplied in the G_SNMP.conf configuration file with the following content:

CREATE MAPPING SNMP_MAP
(
 0 = '@Class',
 1 = '@Identifier', 
 2 = '@Node',
 3 = '@Acknowledged',
 4 = '@ExpireTime',
 5 = '@ServerName',
 6 = '@ServerSerial'
);

Configure the SNMP writer supplied in the G_SNMP.conf configuration file by replacing the following content:

START WRITER SNMP_WRITER
(
TYPE = SNMP,
REVISION = 1,
PORT = 162,
GATEWAY = 'snmphost',
COMMUNITY = 'public',
FORWARD_UPDATES = TRUE,
MAP = SNMP_MAP
);

where snmphost is the name of the computer to which SNMP Gateway forwards traps.

NOTE:Set the port to be the same as the port configured for SNMP Trap Service. By default, SNMP Trap Service listens to port 162.

1.8.2 SNMP Gateway Version 1.5.1.0 and 1.6.0.0

By default, the NCO_GATE.props file is available in the following location:

  • On Microsoft Windows computers: $OMNIHOME\gates\snmp

  • On UNIX computers: $OMNIHOME/gates/snmp/

where $OMNIHOMEis the installation path for IBM Netcool.

You must copy the NCO_GATE.props file to the following location on your Windows and UNIX computers and edit the file to suit your environment:

  • On Microsoft Windows computers: $OMNIHOME\etc

  • On UNIX computers: $OMNIHOME/etc/

NOTE: NetIQ Corporation recommends that you copy NCO_GATE.props file to the default folder: $OMNIHOME/etc/default

To enable the SNMP Gateway to forward updates to AppManager, edit the following properties in the NCO_GATE.props file:

Property

Value

Gate.MapFile

$OMNIHOME/gates/snmp/snmp.map

Gate.SNMP.Community

public

Gate.SNMP.ForwardUpdates

TRUE

Gate.SNMP.Gateway

<connectorHost>:<portnumber>

where connectorHost is the name of the Connector computer and portnumber is the port configured for SNMP Trap Service. By default, SNMP Trap Service listens to port 162.

Mapping for Version 1.5.1.0

Replace the mapping supplied in the snmp.map file with the following content:

CREATE MAPPING StatusMap
(
'0' = '@Summary',
'1' = '@Severity', 
'2' = '@Location',
'3' = '@Node',
'4' = '@AlertGroup',
'5' = '@Acknowledged',
'6' = '@NodeAlias',
'7' = '@Identifier',
'8' = '@Class',
'Node' = '@Node'
);

Mapping for Version 1.6.0.0

Replace the mapping supplied in the snmp.map file with the following content:

CREATE MAPPING StatusMap
(
'0' = '@Class',
'1' = '@Identifier', 
'2' = '@NodeAlias',
'3' = '@Acknowledged',
'4' = '@Summary',
'5' = '@Severity',
'6' = '@Location',
'7' = '@Node',
'8' = '@AlertGroup',
'Node' = '@Node'
);