IBM Support

Configuring SNMP settings and its known limitations

Technote (FAQ)


Question

How does SNMP settings work on DataPower?

Cause

Clarification is required for the use of the SNMP trap code and Logging target event code and some of their known limitations.
SNMP Settings can be configured from the Web GUI in the default domain by an administrator and is accessible from the menu from the following paths
Administration>Access>SNMP Settings and Objects>Access Settings>SNMP Settings

It can also be accessed from the CLI using the "snmp" command.


Answer

The SNMP trap code and Logging target event code require a 10 digit hexcode input. For example 0x1630002 in the configuration will not match event code 0x01630002. There is no validation to the arguments of either SNMP trap-code or logging event code, other than it can be a non-null string.


For example you can say "snmp; trap-code xxx", and get no error, so it is advised to double check subscriptions:

Setting SNMP Trap Code CLI:
xi50# conf
Global configuration mode
xi50(config)# snmp
SNMP Settings configuration mode
xi50(config snmp)# trap-code xxx
xi50(config snmp)# exit
xi50(config)#



Only a very limited number of DataPower result codes are used in the log system and can be subscribed to in a Logging target as an event code or as an SNMP trap code.
You can identify result codes from event log message identifiers by just the the starting digit. If the first digit is 0-7, it is a result code. If the first digit 8-F, it is a logging event code.

This means that some of the options, which are currently selectable, do not behave as a user would expect.

The following is a complete list of subscribe-able SNMP trap code:

Result code
Category
Severity
Message
0x03130002
b2bgw
error
Retransmit Exhausted
0x01a2000e
system
critical
Installed battery is nearing end of life.
0x01a6000f
system
info
Installed battery longevity test passed.
0x01b6000c
crypto
info
Certificate is about to expire
0x00350079
mgmt
notice
Domain is open for e-Business
0x02220001
environmental
critical
Power supply failure.
0x02220004
environmental
critical
System battery missing.
0x02220005
environmental
critical
System battery failed.
0x02220003
environmental
critical
Internal cooling fan has stopped.
0x02240002
environmental
warning
Internal cooling fan has slowed
0x0133001c
mq
error
Could not connect to the QM (Reason Code 2059)
0x01330025
mq
error
Q BackoutThreshold reached (Reason Code 2362)
0x01a30021
system
error
Cannot find the RAID controller in the system.
0x01a30022
system
error
The RAID controller is in the faulted state.
0x01a2001b
system
critical
The RAID battery is not detected.
0x01a2001c
system
critical
The RAID battery needs to be replaced.
0x01a2001d
system
critical
The RAID battery temperature is high.
0x01a2001e
system
critical
The RAID battery voltage is low.
0x00350016
mgmt
notice
Service installed on port
0x00340017
mgmt
warning
Service removed from port
0x01a10016
system
alert
Number of free XML Names is very low.
0x01a50004
system
notice
Memory usage recovered above threshold
0x01a50007
system
notice
Temporary file space recovered above threshold
0x01a5000a
system
notice
Number of free ports recovered
0x01a40001
system
warning
Throttling connections due to low memory
0x01a40005
system
warning
Throttling connections due to low temporary file space
0x01a40008
system
warning
Throttling connections due to low number of free ports
0x01a30003
system
error
Restart due to resource shortage timeout
0x01a30002
system
error
Restart due to low memory
0x01a30006
system
error
Restart due to low temporary file space
0x01a3000b
system
error
Restart due to XML Names prefix shortage
0x01a3000c
system
error
Restart due to XML Names namespace shortage
0x01a3000d
system
error
Restart due to XML Names local name shortage
0x01a30009
system
error
Restart due to port shortage




Document information

More support for: IBM DataPower Gateways
General

Software version: 7.2, 7.5, 7.5.1, 7.5.2, 7.6, 7.7

Operating system(s): Firmware

Reference #: 1649255

Modified date: 26 September 2013