1. Maintenance and Troubleshooting Guide
  2. Fault Management
  3. Realm Faults

Realm Faults

This section explains how to access realm fault statistics.

Signaling

Use the following command to display SIP realm statistics:

  • show sipd realms

Viewing SIP Realm Statistics

Display SIP realm statistics by using the show sipd realms command. For example: 

ORACLE# show sipd realms
19:38:17-18
               ---- Inbound ---- --- Outbound ---- -Latency- --- Max ---
Realm          Active Rate ConEx Active Rate ConEx  Avg  Max Burst In Out
external            0 0.0      0      0  0.0     0  0.0  0.0     0  0   0
external-child      0 0.0      0      0  0.0     0  0.0  0.0     0  0   0
internal            0 0.0      0      0  0.0     0  0.0  0.0     0  0   0

Media Statistics

You can use the following commands to display information about mbcd realms:

  • show mbcd realms
  • show mbcd realms <realm name>
  • show flows

There are also alarms that occur when the following events happen:

  • out of memory
  • internal
  • unknown realm
  • realm change
  • out of bandwidth
  • out of ports

Viewing MBCD Steering Port and Bandwidth Usage for Realms

Display steering ports and bandwidth usage for home, public, and private realms by using the show mbcd realms command.

For example:

acmepacket# show mbcd realms
18:46:29-2819
             --- Steering Ports ---  ----------- Bandwidth Usage ----------
Realm         Used   Free  No Ports    Flows Ingrss Egress  Total  Insuf BW
acme             0      0         0        0     0K     0K     0K         0
h323172          0  30001         0        0     0K     0K     0K         0
sip172           2  29999         0        0     0K     0K     0K         0
sip192           2  29999         0        0     0K     0K     0K         0

The information displayed includes the following:

  • Used—Number of steering ports used
  • Free—Number of free steering ports
  • No Ports—Number of times that a steering port could not be allocated
  • Flows—Number of established media flows
  • Ingress—Amount of bandwidth being used for inbound flows
  • Egress—Amount of bandwidth being used for outbound flows
  • Total—Maximum bandwidth set for this realm
  • Insuf BW—Number of times that a session was rejected due to insufficient bandwidth.

Viewing MBCD Statistics for a Specific Realm

Display media statistics for a specific realm by using the show mbcd realms <realm-name> command. This information is given for period and lifetime durations.

  • Ports Used—Number of ports used
  • Free Ports—Number of free ports
  • No Ports Avail—Number of times no steering ports were available
  • Ingress Band—Amount of bandwidth used for inbound flows
  • Egress Band—Amount of bandwidth used for outbound flows
  • BW Allocations—Number of times that bandwidth was allocated
  • Band Not Avail—Number of times a session was rejected due to insufficient bandwidth

For example:

acmepacket# show mbcd realms sip172
18:47:31-2881 Realm=sip172
                            -- Period -- -------- Lifetime --------
                  Active    High   Total      Total  PerMax    High
Ports Used             2       2      18         18      18       2
Free Ports         29999   30001   30017      30017   30017   30001
No Ports Avail         -       -       0          0       0       -
Ingress Band          0K      0K       0          0       0      0K
Egress Band           0K      0K       0          0       0      0K
BW Allocations         0       0       0          0       0       0
Band Not Avail         -       -       0          0       0       -
Total Bandwidth=0K
Steering Ports: 100% Success

Viewing MBCD Task Errors

The show mbcd errors command displays MBCD task error statistics, starting with a time stamp that shows when the current period began.

For example:

ORACLE# show mbcd errors
11:42:37-198
MBC Errors/Events              ---- Lifetime ----
                        Recent      Total  PerMax
Client Errors                0          0       0
Client IPC Errors            0          0       0
Open Streams Failed          0          0       0
Drop Streams Failed          0          0       0
Exp Flow Events              0          0       0
Exp Flow Not Found           0          0       0
Transaction Timeouts         0          0       0
Server Errors                0          0       0
Server IPC Errors            0          0       0
Flow Add Failed              0          0       0
Flow Delete Failed           0          0       0
Flow Update Failed           0          0       0
Flow Latch Failed            0          0       0
Pending Flow Expired         0          0       0
ARP Wait Errors              0          0       0
Exp CAM Not Found            0          0       0
Drop Unknown Exp Flow        0          0       0
Drop/Exp Flow Missing        0          0       0
Exp Notify Failed            0          0       0
Unacknowledged Notify        0          0       0
Invalid Realm                0          0       0
No Ports Available           0          0       0
Insufficient Bandwidth       0          0       0
Stale Ports Reclaimed        0          0       0
Stale Flows Replaced         0          0       0
Telephone Events Gen         0          0       0
Pipe Alloc Errors            0          0       0
Pipe Write Errors            0          0       0

There are two categories of MBCD error statistics: Client and Server.

Client statistics count errors and events encountered by applications that use the MBCD to set up and tear down media sessions:

  • Client Errors—Number of errors in the client application related to MBC transactions that are otherwise uncategorized
  • No Session (Open)—Number of MBC transactions creating or updating a media session that could not be sent to MBCD because the media session state information could not be located
  • No Session (Drop)—Number of MBC transactions deleting a media session that could not be sent to MBCD because the media session state information could not be located
  • Exp Flow Events—Number of flow timer expiration notifications received from the MBCD by all applications
  • Exp Flow Not Found—Number of flow timer expiration notifications received from the MBCD by all applications for which no media session or flow information was present in the application.
  • Transaction Timeouts—Number of MBC transaction timeouts
  • Server statistics count errors and events encountered by MBCD
  • Server Errors—Number of uncategorized errors in the MBC server
  • Flow Add Failed—Number of errors encountered when attempting to add an entry to the NAT table
  • Flow Delete Failed—Number of errors encountered when attempting to remove an entry from the NAT table
  • Flow Update Failed—Number of errors encountered when attempting to update an entry in the NAT table upon receipt of the first packet for a media flow
  • Flow Latch Failed—Number of errors when attempting to locate an entry in the NAT table upon receipt of the first packet for a media flow
  • Pending Flow Expired—Number of flow timer expirations for pending flows that have not been added to the NAT table
  • ARP Wait Errors—Number of errors and timeouts related to obtaining the Layer 2 addressing information necessary for sending media
  • Exp CAM Not Found—This statistic shows the number that the NAT table entry for an expired flow could not find in the NAT table. This usually occurs due to a race condition between the removal of the NAT entry and the flow timer expiration notification being sent to MBCD from the NP
  • Drop Unknown Exp Flow—Number of flows deleted by the MBCD because of a negative response from the application to a flow timer expiration notification
  • Unk Exp Flow Missing—Number of negative responses from the application to a flow timer expiration notification for which the designated flow could not be found in MBCD's tables
  • Exp Notify Failed—Number of errors encountered when the MBCD attempted to send a flow timer expiration notification to the application
  • Unacknowledged Notify—Number of flow expiration notification messages sent from MBCD to the application for which MBCD did not receive a response in a timely manner
  • No Ports Available—Number of steering port allocation requests not be satisfied due to a lack of free steering ports in the realm
  • Invalid Realm—Number of flow setup failures due to an unknown realm in the request from the application
  • Insufficient Bandwidth—Number of flow setup failures due to insufficient bandwidth in the ingress or egress realm

Viewing Realm Configurations

You can use the show realm command to display all realm-specific configurations. For example: 

ORACLE# show realm
14:27:38-56SIP Realm Statistics
                                  -- Period -- ------- Lifetime -------
Realm               Active  Rate   High  Total      Total PerMax   High
realm1
    Inbound              0   0.0      0      0          0      0      0
    Outbound             0   0.0      0      0          0      0      0

Viewing Realm Configurations for a Specific Realm

ORACLE# show realm realm1
realm stats for : Realm: realm1
14:29:22-40
Realm realm1 NO ACTIVITY

Viewing Monthly Minutes for a Specific Realm

You can use the show monthly minutes <realm-id> command to display the monthly minutes for a specified realm. For example: 

ORACLE# show monthly-minutes realm1
14:31:33-51
Realm            MinutesAllowed  MinutesLeft         Minutes Exceed Rejects
------------     -------------   -----------         --------------------
                                                     Recent   Total  PerMax
realm1           10              10                    0          0       0

Media Alarms

The following table lists information about the different media alarms.

Alarm Name Alarm ID Alarm Severity Cause(s) Example Log Message Actions
MBCD ALARM OUT OF MEMORY 262145 CRITICAL: for flow

MAJOR: for media (if server cannot allocate a new context)

No further memory can be allocated for MBCD. Flow: Cannot create free port list for realm.

Media Server: Failed to allocate new context.

apSyslogMessageGenerated

apSysMgmtMediaOutofMemory trap generated

MBCD ALARM INTERNAL 262146 MINOR An internal software error. Internal Error. No agent for socket <IPPort>. None
MBCD ALARM UNKNOWN REALM 262147 MAJOR: if media server is adding a new flow Media server is unable to find realm interface. Realm type (ingress, egress, hairpin) X, not found apSyslogMessageGenerated

apSysMgmtUnknownRealm

MBCD ALARM OUT OF BANDWIDTH 262149 CRITICAL: failure rate = 100%

MAJOR: failure rate > or = 50%

The realm is out of bandwidth. Out of bandwidth apSyslogMessageGenerated

apSysMgmtMediaBandwidthTrap

MBCD ALARM OUT OF PORTS 262150 CRITICAL: failure rate = 100%

MAJOR: failure rate > or = 50%

The realm is out of steering ports. Out of steering ports apSyslogMessageGenerated

apSysMgmtMediaPortsTrap

Viewing Deny ACL List

Display a list of deny ACLI entries by using the acl-show command at the topmost ACLI prompt. The following information is displayed:

  • Incoming port, slot, and VLAN tag
  • Source IP, bit mask, port, and port mask
  • Destination IP address and port
  • Protocol
  • ACL entry as static and dynamic
  • ACL entry index

For example:

ORACLE# acl-show
deny entries:
intf:vlan source-ip/mask:port/mask dest-ip/mask:port/mask   prot type    index
Total number of deny entries = 0
Denied Entries not allocated due to ACL constraints:     0
task done