About Traps
This section defines the standard and proprietary traps supported by the system. A trap is initiated by tasks (such as the notify task) to report that an event has happened on the system. SNMP traps enable an SNMP agent to notify the NMS of significant events by way of an unsolicited SNMP message.
The system uses SNMPv2c. These notification definitions are used to send standard traps and Oracle’s own enterprise traps.
Traps are sent according to the criteria established in the following:
- IETF RFC 1907 Management Information Base for Version 2 of the Simple Network Management Protocol
- IETF RFC 2233 The Interfaces Group MIB using SMIv2
- Or the appropriate enterprise MIB (for example the Acme Packet syslog MIB or the Acme Packet System Management MIB).
For additional information about the traps and MIBS supported by the system, see the Oracle Communications Session Border Controller MIB Reference Guide.
Standard Traps
The following table identifies the standard traps that the system supports.
| Trap Name | Description |
|---|---|
| linkUp | The SNMPv2 agent detects that the ifOperStatus object of an interface has transferred from the down state to the up state. The ifOperStatus value indicates the other state. |
| linkDown | The SNMPv2 agent detects that the ifOperStatus object of an interface has transferred from the up state to the down state. The ifOperStatus value indicates the other state. |
| coldStart | The SNMPv2 agent is reinitializing itself and
its configuration may have been altered.
This trap is not associated with a system alarm. |
| authenticationFailure | The SNMPv2 agent received a protocol message
that was not properly authenticated. If the snmp-enabled and
enable-snmp-auth-traps fields in the ACLI’s system-config element are set to
enabled a snmpEnableAuthenTraps object is generated.
This trap is not associated with a system alarm. |
Enterprise Traps
The following table identifies the proprietary traps that the system supports.
| Trap Name | Description |
|---|---|
| apSyslogMessageGenerated | Generated by a syslog event. For example, this trap is generated if a switchover alarm occurs (for High Availability (HA) system peers only), or if an HA system peer times out or goes out-of-service. You enable or disable the sending of syslog messages by using the ACLI. |
| apSysMgmtGroupTrap | Generated when a significant threshold for a system resource use or health score is exceeded. For example, if Network Address Translation (NAT) table usage, Address Resolution Protocol (ARP) table usage, memory usage, or Central Processing Unit (CPU) usage reaches 90% or greater of its capacity, the apSysMgmtGroupTrap is generated. If the health score (for HA peers only) falls below 60, the apSysMgmtGroupTrap is generated. |
| apLicenseApproachingCapacityNotification | Generated when the total number of active sessions on the system (across all protocols) is within 98 - 100% of the licensed capacity. |
| apLicenseNotApproachingCapacityNotification | Generated when the total number of active sessions on the system (across all protocols) has gone to or below 90% of its licensed capacity (but no sooner than 15 seconds after the original alarm was triggered). |
| apEnvMonI2CFailNotification | Generated when the Inter-IC bus (I2C) state changes from normal (1) to not functioning (7). |
| apEnvMonStatusChangeNotification | Generated when any entry of any environment monitor table changes in the state of a device being monitored. To receive this trap, you need to set the system config’s enable- env- monitor- table value to enabled. |
| apSwCfgActivateNotification | Generated when an activate-config command is issued and the configuration has been changed at running time. |
| apSysMgmtPowerTrap | Generated if a power supply is powered down, powered up, inserted/present or removed/not present. |
| apSysMgmtTempTrap | Generated if the temperature falls below the monitoring level. |
| apSysMgmtFanTrap | Generated if a fan unit speed falls below the monitoring level. |
| apSysMgmtTaskSuspendTrap | Generated if a critical task running on the system enters a suspended state. |
| apSysMgmtRedundancyTrap | Generated if a state change occurs on either the primary or secondary system in a redundant (HA) pair. |
| apSysMgmtMediaPortsTrap | Generated if port allocation fails at a percentage higher or equal to the system’s default threshold rate. Trap is generated when there are at least 5 failures within a 30 second window and a failure rate of 5% or more. |
| apSysMgmtMediaBandwidthTrap | Generated if bandwidth allocation fails at a percentage higher or equal to the system’s default threshold rate. Trap is generated when there are at least 5 failures within a 30 second window and a failure rate of 5% or more. |
| apSysMgmtMediaOutofMemory | Generated if the media process cannot allocate memory. |
| apSysMgmtMediaUnknownRealm | Generated if the media process cannot find an associated realm for the media flow. |
| apSysMgmtRadiusDownTrap | Generated if all or some configured RADIUS accounting servers have timed out from a RADIUS server. |
| apSysMgmtGatewayUnreachableTrap | Generated if the gateway specified becomes unreachable by the system. |
| apSysMgmtH323InitFailTrap | Generated if the H.323 stack has failed to initialize properly and has been terminated. |
| apSysMgmtHardwareErrorTrap | Provides a text string indicating the type of hardware error that has occurred. If the message text exceeds 255 bytes, the message is truncated to 255 bytes. |
| apSysMgmtDOSTrap | Generated when the IP address and the realm ID is denied of service. |
| apSysMgmtCfgSaveFailTrap | Generated if an error occurs while the system is trying to save the configuration to memory. |
| apSysMgmtSystemStateTrap | Generated when the
Oracle Communications Session Border Controller is instructed to change the system-state or the
transition from becoming offline to online occurs. This trap contains one field
called APSysMgmtSystemState, and that field has three values:
|
| apSysMgmtAuthenticationFailedTrap | Generated when an attempt to login
to the
Oracle Communications Session Border Controller fails for any reason. The trap sent to all configured
trap receivers includes the following information:
|
Transcoding Capacity Traps
The Oracle Communications Session Border Controller sends the apSysMgmtGroupTrap as transcoding capacity nears its limit. This trap is sent and cleared for three conditions:
- Total DSP usage exceeds 95%
- Total AMR sessions exceed 95% of licensed capacity
- Total AMR-WB sessions exceed 95% of licensed capacity
- Total EVRC sessions exceed 95% of licensed capacity
- Total EVRCB sessions exceed 95% of licensed capacity
The apSysMgmtGroupTrap contains the condition observed (apSysMgmtTrapType) and the corresponding value reached (apSysMgmtTrapValue).
apSysMgmtGroupTrap NOTIFICATION-TYPE
OBJECTS { apSysMgmtTrapType, apSysMgmtTrapValue }
STATUS current
DESCRIPTION
" The trap will generated if value of the monitoring object
exceeds a certain threshold. "
::= { apSystemManagementNotifications 1 }When the resource usage retreats below a defined threshold, the Oracle Communications Session Border Controller sends an apSysMgmtGroupClearTrap.
apSysMgmtGroupClearTrap NOTIFICATION-TYPE
OBJECTS { apSysMgmtTrapType }
STATUS current
DESCRIPTION
" The trap will generated if value of the monitoring object
returns to within a certain threshold. This signifies that
an alarm caused by that monitoring object has been cleared. "
::= { apSystemManagementNotifications 2 }The following table summarizes trigger and clear conditions for transcoding capacity alerts as sent in the apSysMgmtGroupTrap:
| Monitored Transcoding Resource | SNMP Object & OID in apSysMgmtTrapType | Trap Sent | Clear Trap Sent |
|---|---|---|---|
| Total DSP Usage | apSysXCodeCapacity
1.3.6.1.4.1.9148.3.2.1.1.34 |
95% | 80% |
| AMR License Capacity Usage | apSysXCodeAMRCapacity
1.3.6.1.4.1.9148.3.2.1.1.35 |
95% | 80% |
| AMR-WB License Capacity Usage | apSysXCodeAMRWBCapacity
1.3.6.1.4.1.9148.3.2.1.1.36 |
95% | 80% |
| EVRC License Capacity Usage | apSysXCodeEVRCCapacity
1.3.6.1.4.1.9148.3.2.1.1.39 |
95% | 80% |
| EVRCB License Capacity Usage | apSysXCodeEVRCBCapacity
1.3.6.1.4.1.9148.3.2.1.1.40 |
95% | 80% |
| G729 License Capacity Usage | apSysXCodeG729Capacity
1.3.6.1.4.1.9148.3.2.1.1.42 |
95% | 80% |
| Opus License Capacity Usage | apSysXCodeOpusCapacity
1.3.6.1.4.1.9148.3.2.1.1.46 |
95% | 80% |
| Silk License Capacity Usage | apSysXCodeSilkCapacity
1.3.6.1.4.1.9148.3.2.1.1.47 |
95% | 80% |
| EVRCNW License Capacity Usage | apSysXCodeEVRCNWCapacity
1.3.6.1.4.1.9148.3.2.1.1.48 |
95% | 80% |
| EVS License Capacity Usage | apSysXCodeEVSCapacity
1.3.6.1.4.1.9148.3.2.1.1.49 |
95% | 80% |
The following SNMP Objects are inserted into the apSysMgmtTrapType when sending and clearing a transcoding capacity trap. You mayt query them individually with an SNMP GET.
- apSysXCodeCapacity (1.3.6.1.4.1.9148.3.2.1.1.34)
- apSysXCodeAMRCapacity (1.3.6.1.4.1.9148.3.2.1.1.35)
- apSysXCodeAMRWBCapacity (1.3.6.1.4.1.9148.3.2.1.1.36)
- apSysXCodeEVRCCapacity (1.3.6.1.4.1.9148.3.2.1.1.39)
- apSysXCodeEVRCBCapacity(1.3.6.1.4.1.9148.3.2.1.1.40)
- apSysXCodeG729Capacity(1.3.6.1.4.1.9148.3.2.1.1.42)
- apSysXCodeOpusCapacity(1.3.6.1.4.1.9148.3.2.1.1.46)
- apSysXCodeSilkCapacity(1.3.6.1.4.1.9148.3.2.1.1.47)
- apSysXCodeEVRCNWCapacity(1.3.6.1.4.1.9148.3.2.1.1.48)
- apSysXCodeEVSCapacity(1.3.6.1.4.1.9148.3.2.1.1.49)