Troubleshooting Guide
Chapter 14 - General Troubleshooting

Table Of Contents

General Troubleshooting

Introduction

Troubleshooting CORBA Problems

Troubleshooting Local Number Portability Problems

Resolving Local Number Portability Conflicts

Audit Requests

Report Requests

Troubleshooting Alerting Notification Problems

Command Responses

Success and Failure Responses

Termination Reason Responses

Trunk Reason Responses

Trunk Termination Reason Responses, Signaling System 7 Only

Fault Reason Responses

Protocol Troubleshooting

Troubleshooting Signaling System 7 SIGTRAN Problems

Cisco Internet Protocol Transfer Point Troubleshooting Procedures

Using BTS 10200 Command Line Interface Commands

Viewing BTS 10200 Logs

'Troubleshooting Transaction Capabilities Application Part with the Query Verification Tool

Debugging Network Related Transaction Capabilities Application Part/Signaling Connection Control Part Problems

Troubleshooting H.323 Problems

Outgoing Trunk Group is Out of Service

Outgoing H.323 Gateway is Out of Service

H.323 Gateway Fails to Register With Gatekeeper (Invalid Alias)

Outgoing H.323 Gateway Unregistered With Gatekeeper and Needs to Use Registration, Admissions, and Status

Stable Calls Are Dropped When Call Agent Switches Over

No Matching Dial Plan Found on Incoming H.323 Trunk Group

Configuration at Softswitch or Gatekeeper Has Placed Routing Into a Loop

Outgoing H.323 Calls Routed to Incorrect Endpoint When Using Registration, Admissions, and Status

Outgoing H.323 Calls Routed to Incorrect Endpoint When Using Direct Signaling

Registration, Admissions, and Status Still Used When Outgoing H.323 Call is Provisioned to Use Direct Signaling

Troubleshooting Integrated Services Digital Network Problems

How to Troubleshoot When the Integrated Services Digital Network Trunk Group Fails to Restore

Checking the Status of a Trunk Termination

Checking Media Gateway Provisioning

Additional Command Line Interface Verification

Maintenance of a Call Agent Connected to an Integrated Services Digital Network Trunk Group

File Configuration-bts.properties

Editing-bts.properties

Example Edit-bts.properties

Privacy Screening Troubleshooting

Symptom One

Solution One

Symptom Two

Solution Two

Symptom Three

Solution Three

Symptom Four

Solution Four

Call Agent Controlled Mode for RFC 2833 DTMF Relay Troubleshooting

General Troubleshooting Procedures

Basic Call Cannot Be Established

No DTMF Relay Involving H.323 Endpoints

NCS I10 and Audit Connection Troubleshooting

General Troubleshooting Information

Troubleshooting the Timeout Queue

Troubleshooting QoS

Troubleshooting Audit Connection

Multi-Lingual Support Troubleshooting

Viewing Trace Logs for Throttled Flood of MGCP Messages from Specific Endpoint

Platform Core File Alarm

Planning

Prerequisites

Restrictions and Limitations

Configuring


General Troubleshooting


Revised: December 11, 2008, OL-8723-17

Introduction

The chapter provides the general troubleshooting information needed to conduct troubleshooting on the Cisco BTS 10200 Softswitch. This chapter is divided into the following sections:

Troubleshooting CORBA Problems—Provides a reference to the Common Object Request Broker Architecture (CORBA) troubleshooting information in the BTS 10200 CORBA Adapter Interface Specification Programmer Guide.

Troubleshooting Local Number Portability Problems—Provides the information to solve local number portability (LNP) problems.

Troubleshooting Alerting Notification Problems—Explains how to troubleshoot the system when the 3PTYFS does not appear to be receiving the alerting notification and call data.

Command Responses—Describes success and failure responses to commands, as well as values for the term-reason and trunk-reason responses.

Protocol Troubleshooting—Provides the troubleshooting information for resolving BTS 10200 protocol problems.

File Configuration-bts.properties—Provides instructions for editing and configuring the bts.properties file.

Privacy Screening Troubleshooting—Provides instructions for troubleshooting privacy screening.

Call Agent Controlled Mode for RFC 2833 DTMF Relay Troubleshooting—Describes general troubleshooting procedures related to the call agent controlled mode for RFC 2833 DTMF relay.

NCS I10 and Audit Connection Troubleshooting—Describes the general troubleshooting procedures related to NCS I10 and the audit connection.

Multi-Lingual Support Troubleshooting—Describes the general troubleshooting procedures related to multi-lingual support.

Viewing Trace Logs for Throttled Flood of MGCP Messages from Specific Endpoint—Describes the general troubleshooting procedures related to viewing trace logs for a throttled flood of MGCP messages.


Caution The use of the UNIX ifconfig down command on any signaling interface to test or troubleshoot network or interface failures of the BTS 10200 Signaling Interface may lead to undesirable consequences or conditions.

Troubleshooting CORBA Problems

To troubleshoot CORBA interface problems, refer to the BTS 10200 CORBA Adapter Interface Specification Programmer Guide, Chapter 5.

Troubleshooting Local Number Portability Problems

Problems can arise when porting a subscriber's telephone number from one service provider to another. The Network Interconnection Interoperability Forum (NIIF), a part of the Alliance for Telecommunications Industry Solutions (ATIS) organization, has published a document (ATIS/NIIF-0017) that includes detailed steps that service providers should follow when LNP problems are encountered. The document is titled Guidelines for Reporting Local Number Portability Troubles in a Multiple Service Provider Environment, and it is available at https://www.atis.org/docstore/default.aspx.

The NIIF also maintains the National LNP Contact Directory, a protected document that provides telephone numbers of 24 by 7 LNP-qualified contacts for each service provider. The directory is located at the URL given above. You can download and submit an application for a password at the same URL.

Resolving Local Number Portability Conflicts

Some conflicts can arise in the LNP processes. Figure 14-1 illustrates the causes of conflicts and the procedures that the Number Portability Administration Center (NPAC) service management system (SMS) uses to resolve them.

If either the old or new service provider did not send a notification to the NPAC SMS, the NPAC SMS notifies the service provider from which it did not receive a notification that it is expecting a notification. If the NPAC SMS receives the missing notification, and both notifications indicate agreement among the service providers, the process proceeds as normal.

The following list describes the actions that the NPAC SMS takes in different situations:

If the NPAC SMS does not receive a concurring notification from the old service provider, the NPAC SMS logs the failure to respond and allows the new service provider to proceed with activation when the new service provider due date is reached.

If the NPAC SMS does not receive a concurring notification from the new service provider, the NPAC SMS logs the failure to respond, cancels the request, and notifies both service providers of the cancellation.

If the service providers disagree as to who will provide service for the telephone number, the NPAC SMS places the request in the "conflict" state and notifies both service providers of the conflict status and the Status Change Cause Code.

The service providers then determine between them who will serve the customer using their internal business processes.

When a resolution is reached, the NPAC SMS is notified by the new service provider and removes the request from the conflict state.

Within the first 6 hours, only the old service provider can initiate "conflict off." After 6 hours, either service provider can remove the conflict status. The new service provider can alternatively request cancellation of the Subscription Version.

Figure 14-1 Conflict Resolution Work Flow

Audit Requests

An audit function is necessary for troubleshooting customer problems and as a maintenance process to ensure Subscription Version data integrity across the entire LNP network. Audits are concerned with the process of comparing the NPAC SMS view of the LNP network's Subscription Version data with one or more of the service provider's views of its network.

The following methods help ensure data integrity across the LNP network:

On-demand audits can be initiated by any service provider who believes a problem may exist in another service provider's network. These audits are executed through queries to the appropriate service provider's network, and corrected by means of downloads to those same networks.

Local service providers are also responsible for comparing database extracts of Subscription data written to an File Transfer Protocol (FTP) site by the NPAC SMS with their own versions of the same Subscription data.

The NPAC SMS selects a random sample of active Subscription Versions from its own database, then compares those samples to the representation of that same data in the various local SMS databases.

Report Requests

The NPAC SMS supports report generation for predefined and ad hoc reports. The report generation function creates output report files according to specified format definitions, and distributes reports to output devices as requested. The report distribution service supports distribution to electronic files, to local or remote printers, to e-mail addresses, and to fax machines.

Troubleshooting Alerting Notification Problems

This section explains how to troubleshoot the system when the 3PTYFS does not appear to be receiving the alerting notification and call data.


Step 1 Verify that the ID, transport service access point (TSAP) ADDR, and TYPE are properly provisioned in the FEATURE-SERVER table.

Step 2 Verify that the alerting notification feature (ALERT_NOTIFY) is provisioned properly.

Step 3 Verify one of the following two cases, as applicable:

Verify that the ALERT_NOTIFY feature is included in the SERVICE table applicable to the specific subscriber.

Verify that Alerting Notification is included in the SERVICE table applicable to the specific POP (the service ID identified by the office-service-id token in the POP table).

Verify that the ALERT_NOTIFY feature is included in the default office service ID (if the feature is intended to be offered to all subscribers on the switch).


Note In the procedures included in this document, the alerting notification feature is provisioned using the feature identifier FNAME=ALERT_NOTIFY. The feature identifier can be any unique string of up to 16 ASCII characters chosen by the service provider. If you are not sure of the name used in your system for this feature, use the SHOW FEATURE command and view the system response to find the name.


Example:

SHOW FEATURE-SERVER;
SHOW FEATURE FNAME=ALERT_NOTIFY;
SHOW CA-CONFIG TYPE=DEFAULT-OFFICE-SERVICE-ID;
SHOW SERVICE ID=<the value of the default-office-service-id>
SHOW SERVICE ID=6543;
SHOW SUBSCRIBER-SERVICE-PROFILE SERVICE-ID=6543;

Step 4 If a TSAP address is used for the 3PTYFS, verify that the domain name is correctly provisioned in the DNS and resolves to the intended 3PTYFS.

Step 5 Enter the CLI command to check for Signaling alarm #12—Feature Server is not up or is not responding to Call Agent. If this alarm is raised, there is a communications problem between the BTS 10200 and the 3PTYFS.

Example:

show alarm type=signaling;
show alarm type=signaling; number=12;

The following details apply to SIGNALING alarm #12:

For a 3PTYFS that is more than one hop away from the BTS 10200, SIGNALING alarm #12 is raised when communications between the BTS 10200 and the first-hop node go down. However, the alarm is not raised if communications on the second (or more distant) hop go down, or if the DNS value for the 3PTYFS does not resolve correctly.

The system can take up to two minutes to detect a communications failure in the first hop toward the 3PTYFS.

Step 6 Verify that you have connectivity from the BTS 10200 to the 3PTYFS.

Step 7 Verify that the 3PTYFS is provisioned to support this feature in accordance with the applicable product documentation. The BTS 10200 does not send any provisioning or status/control commands to the 3PTYFS.

Step 8 Verify that the 3PTYFS and peripheral devices are operating properly according to the applicable product documentation.


Command Responses

This section describes success and failure responses to commands, as well as values for the term-reason and trunk-reason responses.


Note In this section, an asterisk preceding a token name means the token is mandatory. A token without an asterisk is optional.


Success and Failure Responses

The following message is returned upon the success of a command:

Configuration Command Executed.

One of the following responses can be returned upon the failure of a command:

Administrative (ADM) found no failure.

ADM MGW(s) cannot be found.

ADM subscriber(s) cannot be found.

ADM trunk group(s) cannot be found.

ADM trunk(s) cannot be found.

ADM no termination(s) found in MGW.

ADM no trunk group(s) found in trunking gateway.

ADM no trunk(s) found in trunk group.

ADM fail while in termination table.

ADM fail while in trunk group table.

ADM fail while in trunk table.

ADM fail while looking to find trunk index.

ADM fail while getting MGW administration state.

ADM fail while getting trunk group administration state.

ADM fail while looking for MGW index.

ADM administration state invalid.

ADM failed to allocate inter-process communication (IPC) message(s).

ADM failed to dispatch IPC message(s).

ADM operational state invalid.

ADM MGW(s) state change and pending.

ADM subscriber(s) state change and pending.

ADM trunk group(s) state change and pending.

ADM trunk(s) state change and pending.

ADM found subscriber category invalid.

ADM found trunk group type invalid.

ADM found trunk group state invalid.

ADM found MGW admin state not ready.

ADM found trunk group admin state not ready.

ADM entity in desired state.

ADM not allow trunk to reset.

ADM not allow subscriber to reset.

ADM change to out-of-service state required.

ADM change to request graceful mode error.

ADM found entity unequipped in initial state.

ADM operation not allowed because D Channel(s) is down.

The H.323 Gateway was not found in database management (DBM).

ADM found unknown failure reason(s).

Termination Reason Responses

The following responses can be returned for the termination reason (term-reason) response for subscriber termination and trunk termination commands:

All of wildcard too complicated

Channel-associated signaling (CAS) signaling protocol error

Codec negotiation failure

Endpoint does not have a digit map

Endpoint malfunctioning

Endpoint redirected to another Call Agent

Endpoint taken out of service

Error in RemoteConnectionDescriptor

Event/signal parameter error

Facility failure

Failure of a grouping of trunks

Incompatible protocol version

Insufficient bandwidth at this time

Insufficient bandwidth

Internal consistency in local connection options

Internal hardware failure.

Invalid call ID

Invalid conn identifier

Invalid or unsupported command parameter

Invalid or unsupported LocalConnectionOptions

Loss of lower connectivity

Loss of lower layer connectivity

Manual intervention

Missing remote connection descriptor

Missing remote connection descriptor

No fault reason available

No such event or signal

Packetization period not supported

Per endpoint connection limit exceeded

Quality of service (QoS) resource reservation was lost

Response too big

The media gateway is down

The media gateway is in a faulty state

The media gateway is transitioning to another state

The media gateway is unreachable

The phone is already off hook

The phone is already on hook

The transaction could not be executed because a protocol error was detected

The transaction could not be executed because of internal overload

The transaction could not be executed because the command contained an unrecognized extension

The transaction could not be executed because the endpoint is not ready

The transaction could not be executed because the endpoint is restarting

The transaction could not be executed because the endpoint is unknown

The transaction could not be executed because the gateway cannot send the specified announcement.

The transaction could not be executed because the gateway is not equipped to detect one of the requested events

The transaction could not be executed because the gateway is not equipped to generate one of the requested signals

The transaction could not be executed, because the endpoint does not have sufficient resources at this time

The transaction could not be executed, because the endpoint does not have enough resources available [permanent condition]

The transaction could not be executed, because the endpoint is [restarting]

The transaction could not be executed, due to a transient error

The transaction could not be executed, due to some unspecified transient error

The transaction could not be executed, endpoint does not have enough resources available

The transaction has been queued. An actual completion message will follow later

The transaction is currently being executed. An actual completion message will follow later

The transaction refers to an incorrect connection-id

The transaction refers to an unknown call Id

The transaction time out

The transaction was aborted by some external action

Unknown action or illegal combination of actions

Unknown extensions in local connection options

Unknown or unsupported command

Unknown or unsupported digit map extension

Unknown or unsupported quarantine handling

Unknown or unsupported RestartMethod

Unsupported or invalid mode

Unsupported or unknown package

Unsupported values on local connection options

Trunk Reason Responses

The following responses can be returned for the trunk reason (trunk-reason) response. One or more values can be returned, depending upon the operating conditions of the Call Agent.

ACL_CONGESTION_LEVEL_1—automatic congestion level (ACL) congestion is at level 1.

ACL_CONGESTION_LEVEL_2—ACL congestion is at level 2.

ACL_CONGESTION_LEVEL_3—ACL congestion is at level 3.

DPC_INACCESSIBLE—the DPC is not accessible.

HARDWARE-BLOCK—trunk-termination is manually controlled OOS (controlled mode=FORCED).

MAINT-BLOCK—trunk-termination is manually controlled OOS (controlled mode=GRACE).

MAINT-BUSY—trunk-termination is in maintenance state; controlled to MAINT.

MAINT-OOS—trunk-termination is manually controlled OOS. (There is no difference between this and a BLOCK.)

NON-FAULTY—Not blocked, available for service.

OUTGOING_RESTRICTED—the outgoing call is not allowed.

SIGNALLING-FAULT—Cannot exchange messages with public switched telephone network (PSTN) network:

dpc unavailable

user part unavailable

stcp association unavailable

Signaling link is faulty.

dpc congestion

TERM-FAULT—Bearer termination is in faulty condition.

TFC_CONGESTION_LEVEL_1—Transfer controlled (TFC) congestion is at level 1.

TFC_CONGESTION_LEVEL_2—TFC congestion is at level 2.

TFC_CONGESTION_LEVEL_3—TFC congestion is at level 3.

TFC_INTL_CONGESTION

UNKNOWN_REASON

Trunk Termination Reason Responses, Signaling System 7 Only

The following responses can be returned for the trunk terminations on SS7 trunks. One or more values can be returned, depending upon the operating conditions of the Call Agent, in addition to the reason responses listed under Trunk Reason Responses.

ACT_LOC_INIT_RESET—Reset circuit at startup as specified by command line argument for SGA process in the platform.cfg. Remains set until reset circuit (RSC)/group reset (GRS) and release complete (RLC)/group reset acknowledge (GRA) messages are exchanged with the remote switch.

ACT_LOC_MML_RESET—This is set when the reset command is issued from the CLI and remains set until reset is performed. Remains set until RSC/GRS and RLC/GRA messages are exchanged with the remote switch.

ACT_LOC_QUERY—This is set when the a diagnostic command is issued from the CLI to perform a circuit query and remains set until circuit query message (CQM) and circuit query response (CQR) messages are exchanged with a remote switch.

ACT_LOC_UPU—This is set when ITP informs that the user part is unavailable and remains set until a circuit verification response (CVR) is received or the ITP informs that the user part is available. The first incoming message will also clear this response.

ACT_LOC_VALIDATE—This is set when the a diagnostic command is issued from the CLI to perform a circuit validation and remains set until circuit validation test (CVT) and CVR messages are exchanged with the remote switch.

ACT_LOC_COTTEST—This is set when the a diagnostic command is issued from the CLI to perform a customer-originated trace (COT) test and remains set until SRINI TO CHECK messages are exchanged with the remote switch.

ACT_LOC_STOP—This is set to clear a call when a term-fault is received.

BLK_LOC_UPU—This is set when a trunk is blocked because user part is unavailable.

DES_LOC_GRACE—Local hardware restart in progress (RSIP) graceful.

DES_LOC_SIG—SS7—This is set when cannot exchange messages with PSTN network (a signaling fault):

dpc unavailable

user part unavailable

stcp association unavailable

Signaling link is faulty.

dpc congestion

SIGNALLING-FAULT-This is set to indicate that the BTS 10200 processed a DES_LOC_SIG—SS7 signaling fault.

DES_LOC_FORCE—Local hardware failure.

DES_LOC_MML—MMLQ—This is set when a control command is issued with mode=graceful and target-state=OOS. Also set during CQR processing.

DES_LOC_UPU—This is set when user part is unavailable.

JOB_PENDING—Ongoing job in progress. There is an ongoing action of message exchange with the remote switch.

JOB_REC—Job was received by the message definition language (MDL) component and is being processed.

OPER_ACTIVE—Trunk is available for calls.

REMOTE_GRACE—Trunk is blocked remotely because of a CLI command on the remote switch.

REMOTE_FORCE—Trunk is blocked remotely because of a hardware failure on the remote switch.

RESERVE_SPARE1—Reserved for future use.

RESERVE_SPARE2—Reserved for future use.

TERM_GRACE—Trunk is gracefully blocked because of an RSIP from the MGW.

Fault Reason Responses

The following responses can be returned for the fault reason (fault-reason) response for a subscriber termination command. One or more values can be returned, depending upon the operating conditions of the Call Agent.

The media gateway is down.

The media gateway is unreachable.

The media gateway is in a faulty state.

The media gateway is transitioning to another state.

The transaction could not be executed, due to a transient error.

The transaction could not be executed because the endpoint is unknown.

The transaction could not be executed because the endpoint is not ready.

The transaction could not be executed, endpoint does not have enough resources available.

The transaction could not be executed because a protocol error was detected.

The transaction could not be executed because the command contained an unrecognized extension.

The transaction could not be executed because the gateway is not equipped to detect one of the requested events.

The transaction could not be executed because the gateway is not equipped to generate one of the requested signals.

The transaction could not be executed because the gateway cannot send the specified announcement.

Invalid conn identifier.

Invalid call ID.

Unsupported mode or invalid mode.

Unsupported or unknown package.

Endpoint does not have a digit map.

The transaction could not be executed because the endpoint is restarting.

Endpoint redirected to another Call Agent.

No such event or signal.

Unknown action or illegal combination of actions.

Internal consistency in local connection options.

Unknown extensions in local connection options.

Insufficient bandwidth.

Missing remote connection descriptor.

Incompatible protocol version.

Internal hardware failure.

CAS signaling protocol error.

Failure of a group of trunks.

Unsupported values on local connection options.

Response too big.

Endpoint malfunctioning.

Loss of lower connectivity.

Endpoint taken out of service.

No fault reason available.

Protocol Troubleshooting

This section provides the troubleshooting information for resolving BTS 10200 protocol problems.

Troubleshooting Signaling System 7 SIGTRAN Problems

This section describes tools and procedures for troubleshooting SIGTRAN problems on the BTS 10200 and Cisco ITP. It also describes how to clear SIGTRAN related BTS 10200 alarms. In the descriptions within, a series of steps may be required to determine the source of the problem and may include viewing other alarms, invoking command-line interface (CLI) status and control commands,viewing the BTS 10200 logs, and invoking ITP control and status requests.

For details on Cisco ITP operations, refer to the Cisco IP Transfer Point Manual at the following url:

http://www.cisco.com/univercd/cc/td/doc/product/wireless/moblwrls/itp/

This section contains the following sections:

Cisco Internet Protocol Transfer Point Troubleshooting Procedures

Viewing BTS 10200 Logs

'Troubleshooting Transaction Capabilities Application Part with the Query Verification Tool

Cisco Internet Protocol Transfer Point Troubleshooting Procedures

The following procedures are useful for troubleshooting problems on the Cisco ITP. This section contains the following procedures:

Internet Protocol Transfer Point System Messages

Logging On to the Internet Protocol Transfer Point

Viewing the Internet Protocol Transfer Point Configuration

Internet Protocol Transfer Point Status Commands

Controlling Internet Protocol Transfer Point Resources

Internet Protocol Transfer Point System Messages

The Cisco ITP displays system messages when you are logged in to the console port. Some of these messages are similar to alarms. Analyzing ITP system messages is outside the scope of this document. For details concerning ITP system messages, please see the ITP Operations Manual at:

http://www.cisco.com/univercd/cc/td/doc/product/wireless/moblwrls/itp/23sw/index.htm

Logging On to the Internet Protocol Transfer Point

Some of the troubleshooting sections in this chapter require the user to log on to the ITP. Access the ITP through the associated console server or through direct access with a console cable. You need the username and password to access the ITP.

Troubleshooting the ITP will require you to be in ITP enable mode. The enable mode is password protected. To get into enable mode, after logging in to the ITP, type enable. You will be prompted for the enable password.

Viewing the Internet Protocol Transfer Point Configuration

To view the ITP configuration, log in to the ITP and get into enable mode. Enter the command show run. The configuration will be displayed. Continue to hit the enter key until you have viewed the entire configuration, or type "q" to stop viewing the configuration.

Internet Protocol Transfer Point Status Commands

The following ITP commands are helpful for displaying the status of ITP resources:

show cs7 as—Retrieves the application server (AS) status

show cs7 asp—Retrieves the application service provider (ASP) status

show cs7 linkset—Retrieves the Signaling System 7 (SS7) linkset status

show cs7 route—Retrieves the SS7 route status

show cs7 group state—Retrieves the signaling gateway (SG) group status

Controlling Internet Protocol Transfer Point Resources

Change the administrative state of an ITP resource as follows:


Step 1 Log on to the ITP, and get into configure mode.

Step 2 Type the first configuration line of the resource that you want to control.

Step 3 Type shut to take the resource out of service, or type no-shut to place the resource back in service.


The following example takes a linkset out of service:

va-2651-33#conf t
Enter configuration commands, one per line va-2651-33(config-cs7-ls)#
va-2651-33(config)#cs7 linkset lset1 1.1.20
va-2651-33(config-cs7-ls)#shut
*May 19 12:32:13.827: %CS7MTP3-5-ACTDEACTLINKSET: Linkset lset1 deactivation is in progress
*May 19 12:32:13.827: %CS7MTP3-5-LINKUPDOWN: Link 0 in linkset lset1 is down

To put the linkset back in service, type the following command:

va-2651-33(config-cs7-ls)#no shut
*May 19 12:33:47.704: %CS7MTP3-5-ACTDEACTLINKSET: Linkset lset1 activation is in progress
*May 19 12:33:47.704: %CS7MTP3-5-ACTDEACTLINK: Link 0 linkset lset1 activation is in progress

Using BTS 10200 Command Line Interface Commands

In the following sections, examples of BTS 10200 CLI commands are used to aid in resolving BTS 10200 alarms. The following CLI commands are helpful to display and clear alarms:

To display all the currently active alarms, enter the following command at a CLI prompt:

show alarm

To display all alarms of a specific type, enter:

show alarm type=<alarm type>

To clear an alarm, enter the following command:

clear alarm id=<alarm id>

For a detailed description of the CLI commands that are used, please see the BTS 10200 Command Line Interface Reference Guide, Release 4.5, at the following universal resource locator (URL):

http://www.cisco.com/univercd/cc/td/doc/product/voice/bts10200/bts4_5/cli/index.htm

Viewing BTS 10200 Logs

Viewing BTS 10200 logs is helpful when debugging MTP3 user adaptation (M3UA) related objects of the BTS 10200. Specific string patterns are printed out by the M3UA Interface Module and are useful to determine what is occurring in the log. These strings are formatted as follows:

MIM <functional area> <network object>

Functional areas include:

Configuration (CFG)

STATUS

Protocol decode unit (PDU)

STATISTICS

Control (CTRL)

PLATFORM

Network objects include:

Stream Control Transmission Protocol (SCTP)

Signaling gateway process (SGP)

SG

Destination point code (DPC)

Originating point code (OPC)

Routing key (RKEY)

CC_ROUTE

Search or grep the following example strings when searching the BTS 10200 logs:

M3UA Interface Module (MIM) CFG SCTP—Display how the SCTP has been configured at startup.

MIM PDU—Trace incoming and outgoing ISUP messages at the MIM layer.

MIM STATUS DPC—Display how the DPC status has changed in the system.

MIM STATUS SCTP—Display how the SCTP status has changed in the system.

MIM PLATFORM—Determine if a platform state change has been issued to the SGA/MIM module.

MIM CTRL SCTP—Determine if an SCTP association has been administratively taken out of service or put back in service.

'Troubleshooting Transaction Capabilities Application Part with the Query Verification Tool

The Query Verification Tool (QVT) enables a user to generate Transaction Capabilities Application Part (TCAP) queries to external databases through the CLI interface. For information about the Query Verification Tool, refer to the following URL:

http://www.cisco.com/en/US/docs/voice_ip_comm/bts/4.4/feature/module/QVTTVT.html

This section contains the following:

Table Configuration Problems

Table Configuration Problems

The CLI query command with the table-info option displays the tables used for routing the external SS7 queries on the BTS 10200. The query command can identify the following problems:

Missing Call Agent (CA)-CONFIG table

Missing SLHR-PROFILE table

Missing Service Logic Host Route (SLHR) table

Missing DPC table

Missing OPC table

Missing SUBSYSTEM-PROFILE table

Missing SUBSYSTEM table

Missing signaling connection control part (SCCP)-network (NW) table

Missing SCCP-ROUTE table

Missing ROUTING-KEY table

Missing SG group (GRP) table

Missing SG table

Missing SGP table

Missing SCTP-ASSOC table

To resolve a table error, add the appropriate entry to the table specified in the command response.

Debugging Network Related Transaction Capabilities Application Part/Signaling Connection Control Part Problems

The CLI query command can provide information about network related problems. This section describes problems identified by the query command and the solutions to them.

This section contains the following:

No Translation for an Address of Such Nature

No Translation for this Specific Address

Subsystem Congestion

Subsystem Failure

Unequipped User

Network Failure

Network Congestion

Unqualified

Error In Message Transport

Destination Cannot Perform Reassembly

Signaling Connection Control Part Failure

Segmentation Not Supported

Segmentation Failure

Query Verification Tool Timeout

Command Line Interface Timeout

No Translation for an Address of Such Nature

Layer

SCCP

Version

ITU88, ITU92, ITU96, ANSI88, ANSI92

Location

Signal transfer point (STP)

Cause

The global title translation (GTT) entry is not provisioned correctly in the STP.

Solution

Correct the GTT entry in the STP.


No Translation for this Specific Address

Layer

SCCP

Version

ITU88, ITU92, ITU96, ANSI88, ANSI92

Location

STP

Cause

The GTT entry is not provisioned correctly in the STP.

Solution

Add the GTT entry in the STP.


Subsystem Congestion

Layer

SCCP Subsystem (TCAP)

Version

ITU88, ITU92, ITU96, ANSI88, ANSI92

Location

Service control point (SCP)

Cause

The SCP subsystem is congested.

Solution

Ask the SCP Service Provider to solve the congestion problem


Subsystem Failure

Layer

SCCP Subsystem (TCAP)

Version

ITU88, ITU92, ITU96, ANSI88, ANSI92

Location

SCP

Cause

The SCP is down or the subsystem of the SCP is down.

Solution

Verify that the SCP point code is correct.


Unequipped User

Layer

SCCP Subsystem (TCAP)

Version

ITU88, ITU92, ITU96, ANSI88, ANSI92

Location

SCP

Cause

The SCCP user is not equipped

Solution

Verify that the SCP point code is correct


Network Failure

Layer

MTP3/MTP2/MTP1 or SCTP

Version

ITU88, ITU92, ITU96, ANSI88, ANSI92 for NTP3/2/1, Internet Engineering Task Force (IETF) RFC 2960 for SCTP

Location

Local, STP, or SCP

Cause

The Broadband Telephony Softswitch (BTS)-ITP sctp-association is down or the SS7 link, linkset, or route is down.

Solution

See Chapter 13, "Network Troubleshooting," section assistance in solving this problem.


Network Congestion

Layer

SCCP

Version

ITU88, ITU92, ITU96, ANSI88, ANSI92

Location

Local, STP, or SCP

Cause

The SCTP layer or the SS7 network is congested.

Solution

The service provider of the SS7 network needs to either provide higher capacity or re-engineer the traffic. SCTP layer congestion normally indicates insufficient central processing unit (CPU) power. Hardware needs to be upgraded or more BTS 10200 need to be added to offload traffic.


Unqualified

Layer

SCCP

Version

ITU88, ITU92, ITU96, ANSI88, ANSI92

Location

STP or SCP

Cause

Unknown.

Solution

Contact the support team or developer for assistance.


Error In Message Transport

Layer

SCCP

Version

ITU92

Location

STP

Cause

There was a failure in message transportation.

Solution

Contact the support team or the developer.


Destination Cannot Perform Reassembly

Layer

SCCP

Version

ITU88, ITU92, ITU96, ANSI88, ANSI92

Location

SCP

Cause

The peer side is not capable of reassembling extended unit data service (XUDTS) packets.

Solution

The ITP does not support segmentation and reassembly. Contact the Cisco Technical Assistance Center (TAC) for assistance.


Signaling Connection Control Part Failure

Layer

SCCP

Version

ITU88, ITU92, ITU96, ANSI88, ANSI92

Location

Local, STP, or SCP

Cause

The SCCP layer failed or the local TCAP signaling adapter (TSA) could not find the appropriate entry in the Subsystem table or the SCCP-nw table.

Solution

Add or properly populate the Subsystem and SCCP-nw tables. If it still does not work, restart the platform providing the service (Feature Server for AIN services (FSAIN) or Feature Server for POTS, Tandem, and Centrex services (FSPTC)).


Hop Counter Violation

Layer

SCCP

Version

ITU96, ANSI92

Location

STP

Cause

The maximum hop count is exceeded during the message routing.

Solution

Make sure the hop count value provisioned in the SCCP-NW table is not too small. Verify that the SS7 network provider does not have any route-loops.


Segmentation Not Supported

Layer

SCCP

Version

ITU96

Location

SCP

Cause

The peer side is not capable of reassembling XUDTS packets.

Solution

The ITP does not support segmentation and reassembly. Contact the Cisco TAC for assistance.


Segmentation Failure

Layer

SCCP

Version

ITU96

Location

STP

Cause

The segmentation failed.

Solution

The ITP does not support segmentation and reassembly. Contact the Cisco TAC for assistance.


Query Verification Tool Timeout

Location