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