- Preface
- Chapter 1 - Starting and Shutting Down the BTS
- Chapter 2 - Managing BTS Users and Commands Using EMS
- Chapter 3 - Monitoring and Backing Up the BTS
- Chapter 4 - Operating the BTS
- Chapter 5 - Managing External Resources
- Chapter 6 - Using BTS Measurements
- Chapter 7 - Using the BTS SNMP Agent
- Appendix A - Feature Tones
- Appendix B - FIM/XML
Managing External Resources
Introduction
This chapter tells you how to manage external resources provisioned on the BTS using administrative (ADM) commands. External resources have two service states:
•Administrative—State the BTS user provisions for the resource link
•Operational—Physical condition of the resource link or the resource)
The two types of service states are independent of each other, for example:
A user places an MGW link in-service; its administrative state is ADMIN_INS. But that link between the BTS and MGW is lost. The MGW link's operational state is MGW_STATUS_DOWN.
A query of the MGW returns both the administrative state and operational state.
Viewing BTS System-Wide Status
BTSSTAT runs on any BTS host. Any valid UNIX user can enter btsstat from a UNIX shell to initiate it. This command returns the following for all BTS components:
•Component id
•Side
•Host name
•Version
•Replication status
•Redundancy status
To run BTSSTAT from a non-BTS host, the configuration file needs the information in following table. BTSSTAT ignores all other lines in the file.
Managing Trunk Groups and Trunks
|
|
---|---|
Viewing TG status |
status trunk-grp id=2; Possible operational states: •in-service •out of service •manually busy •operate in wait state, operate in standby state •restore session request normal, restore session request switchover, restore session request maintenance, restore session fail normal, restore session fail switch-over, restore session fail maintenance, restore establish request normal, restore establish request switchover, restore establish request maintenance, restore establish fail normal, restore establish fail switchover, restore establish fail maintenance •in maintenance state •down session set fail soft normal, down session set fail hard normal, down session set fail soft maintenance, down session set fail hard maintenance, down establish request soft normal, down establish request hard normal, down establish request soft maintenance, down establish request hard maintenance, down establish request hard normal, down establish request soft maintenance, down establish request hard maintenance, down establish fail soft normal, down establish fail hard normal, down establish fail soft maintenance, down establish fail hard maintenance •delete graceful •request remove release, request remove session set •remove graceful in-service and maintenance state •DPC is inaccessible |
Viewing TGs with ISDN D channels |
show isdn-dchan |
Switching ISDN D channels |
control isdn-dchan tgn-id=1; This switches the active D channel to standby, and the standby D
channel to active.
|
Changing TGs states |
control trunk-grp tgn-id=129; mode=forced; target-state=oos; Note Before bringing an ISDN trunk in-service, put the connected media gateway in-service, see Changing media gateways status. |
Viewing trunk status |
status trunk-termination tgn-id=2; cic=8; |
Resetting trunks |
reset trunk-termination tgn-id=13; cic=1-6; Resetting does the following: •Clears all manual and blocked states •Clears active/transient calls on a trunk termination, with the exception of SS7 trunk terminations. •Brings trunks INS |
Changing trunk states |
control trunk-termination tgn-id=17; cic=1-23; target-state=ins; mode=forced; equip trunk-termination tgn-id=13; cic=all; Changes trunks in UEQP to OOS unequip subscriber-termination id=97_8@ipclab.cisco.com; Changes OOS trunks to UEQP |
Forcing MAINT state |
SS7 trunks control ss7-trunk-termination tgn-id=103; mode=forced; target-state=maint; Note Set COT on the terminating gateway or switch to perform these tests. Otherwise, the test or tests fail. ISDN trunks control isdn-trunk-termination tgn-id=17; mode=forced; target-state=maint; CAS trunks control cas-trunk-termination tgn-id=64; mode=forced; target-state=maint; Announcement trunks control annc-trunk-termination tgn-id=13; mode=forced; target-state=maint; |
Viewing test menus |
SS7 trunks diag ss7-trunk-termination test=<TAB> diag ss7-trunk-termination test=<RETURN> ISDN trunks diag isdn-trunk-termination test=<TAB> diag isdn-trunk-termination test=<RETURN> CAS trunks diag cas-trunk-termination test=<TAB> diag cas-trunk-termination test=<RETURN> Announcement trunks diag annc-trunk-termination test=<TAB> diag annc-trunk-termination test=<RETURN> |
Testing trunks (place in MAINT state first) |
SS7 trunks diag ss7-trunk-termination tgn-id=103; cic=13; test=1; Test 1: SS7 MGCP Connectivity Test—tests if MGCP has access to the SS7 trunk termination Test 2: SS7 Termination Connection Test—tests if there is a path to the device (ping). Test 3: SS7 COT Test—tests the integrity of the SS7 Bearer Path. Test 4: SS7 CQM Test—queries the SS7 circuit (or group of circuits) status. A range of CICs can be specified (to a maximum of 24). Both remote and local trunk states are displayed in the results. Test 5: SS7 CVT Test—tests to ensure that each end of the circuit has sufficient and consistent information for using the circuit in call connections. CLLI names are included. Test 6: SS7 CIC Audit—returns status of CICs Test 0: ALL—performs tests 1 through 6. ISDN trunks diag isdn-trunk-termination test=1; tgn-id=17; cic=1; 1. Tests if MGCP has access to the ISDN termination 2. Tests if there is a path to the device (ping) 3. Performs tests 1 and 2 CAS trunks diag cas-trunk-termination tgn-id=64;cic=1;test=1; 1. Tests if MGCP has access to the CAS termination 2. Tests if there is a path to the device (ping) 3. Performs tests 1 and 2 Announcement trunks diag annc-trunk-termination;test=1;tgn-id=13;cic=1 1. Tests if MGCP has access to the ANC termination 2. Tests if there is a path to the device (ping) 3. Performs tests 1 and 2 |
If a TG or trunk command fails, it can return one of the following generic failure reasons, as well as ones specific to the command.
Managing Subscriber Terminations
If a subscriber termination command fails, it can return one of the following generic failure reasons, as well as ones specific to the command.
Managing Gateways
|
|
---|---|
Viewing H.323 gateways |
status h323-gw id=CHINA-1; Possible RAS states: •CCH323_RAS_STATE_NONE—operational state is ADMIN OOS •CCH323_RAS_STATE_GRQ—Gatekeeper Discovery state •CCH323_RAS_STATE_RRQ—Gateway Registration state •CCH323_RAS_STATE_IDLE—ready for calls •CCH323_RAS_STATE_URQ—Un-registration state. |
Setting the state of H.323 gateways |
control h323-gw id=CHINA_1; target-state=INS;
|
Viewing signaling gateway processes (SGPs) |
status sgp id=sgp1;
|
Viewing media gateways status |
status mgw id=c5300_197; Possible states: •ADMIN-INS—In-service •ADMIN-OOS—Out of service •ADMIN-MAINT—Maintenance Mode •ADMIN-OOS-PENDING—Transitioning to out of service •ADMIN-MAINT-PENDING—Transitioning to Maintenance Mode |
Reporting all MTAs that use "best effort" (non DQoS) calls in the network having or not having a specific aggr id |
report mgw id=%; oper-status=qos-best-effort; aggr-id=aggr1; start_row=1; limit=5; Displays the output as CLI as the output-type has not been mentioned or report mgw id=%; oper-status=qos-best-effort; aggr-id=%; output-type=xml; start_row=1; limit=5; output=report; Displays the output in the specific format (CSV/XML) based on the output-tpye specified Note The output displays only those mgws that use NCS variant. |
Changing media gateways status |
control mgw id=c5300_162; mode=forced; target-state=INS; Modes can be forced or graceful. Forced tears down all calls immediately; graceful allows calls in progress to complete before teardown. Note Rules for changing an MGW states are in Figure 5-1. control mgw id=c2421.65; mode=forced; target-state=maint; Forces MAINT state, do this before testing |
Viewing media gateway test menus |
diag mgw test= <TAB>
or diag mgw test= <RETURN> |
Testing media gateways (place gateways in MAINT state first) |
diag mgw id=ubr-03; test=1; |
If a gateway command fails, you might receive one of the following generic failure reasons, or one specific to the command.
Managing Other External Resources
Learning External Resource Dependencies
|
|
---|---|
OOS |
•OOS •UEQP |
INS |
•OOS •MAINT •INS •UEQP |
MAINT |
•OOS •MAINT •UEQP |
|
|
---|---|
INS |
•OOS •MAINT •INS |
MAINT |
•OOS •MAINT |
This table lists the administrative states BTS returns.
|
|
---|---|
ADMIN-INS |
In service. |
ADMIN-OOS |
Out of service. |
ADMIN-MAINT |
Maintenance Mode. |
ADMIN-OOS-Pending |
Transitioning to out of service. |
ADMIN-MAINT-Pending |
Transitioning to Maintenance Mode. |
ACL |
Congestion is at level 1 |
ACL |
Congestion is at level 2 |
ACL |
Congestion is at level 3 |
TFC |
Congestion is at level 1 |
TFC |
Congestion is at level 2 |
TFC |
Congestion is at level 3 |
|
|
|
---|---|---|
INS |
•OOS •MAINT •INS |
•UEQP OOS •UEQP OSS, MAINT •UEQP OOS, MAINT, INS |
MAINT |
•OOS •MAINT |
•UEQP OOS •UEQP OSS, MAINT |
|
|
|
|
|
---|---|---|---|---|
UNEQP |
UNEQP |
ANY |
UEQP |
IDLE |
MANUALLY OOS |
OOS |
ANY |
LBLK |
IDLE |
MANUALLY MAIN |
MAINT |
IDLE |
LBLK |
IDLE |
IDLE |
INS |
IDLE |
ACTV |
IDLE |
ACTIVE INCOMING |
INS |
IDLE |
ACTV |
IDLE |
ACTIVE OUTGOING |
INS |
ACTIVE |
ACTV |
OBSY |
TRANSIENT INCOMING |
INS |
ACTIVE |
ACTV |
IBY-TRNS |
TRANSIENT OUTGOING |
INS |
BUSY |
ACTV |
OBSY-TRNS |
Note If a call termination attempt is made on a termination for which gateway is unreachable, the termination status will be updated as unreachable even if MGW keepalive is disabled. |
|
|
||
---|---|---|---|
UNKNOWN |
•The termination is not being audited for connectivity. •Capabilities, termination, and connection are not being synchronized with the termination. •When KEEPALIVE-METHOD=NONE in MGW-PROFILE, the termination status is UNKNOWN even if the transaction becomes UNREACHABLE. •Newly-provisioned terminations are in this state. |
||
ACTIVE |
•The termination is being audited for connectivity. •Capabilities, termination, and connection are being synchronized with the termination. |
||
UNREACHABLE |
•The termination is unreachable. •This occurs when MGW KEEPALIVE declares an MGW unreachable. •This changes to ACTIVE when MGW KEEPALIVE detects an MGW is reachable or any termination previously UNREACHABLE starts sending MGCP messages (NTFY, RSIP). |
||
FAULTY |
•The termination returneda permanent error code, making it unusable for future calls.
•The flag MGCP-MAX-FAULT-COUNT controls how many times BTS tries to recover the fault (performing re-audit/auto-recovery) before putting it in this state. |
||
MTRANS |
•Maintenance Transient, the termination is in the middle of anaudit/re-audit/auto-recovery. •This state may go along with other states (MTRANS-UNREACH). |
||
IDLE |
The termination is not involved in transient/active call |
||
BUSY |
•The termination is involved in Active/Transient call. •This state may go along with CTRANS state. |
||
CTRANS |
•Call Transient, the termination is involved in a Transient call. •This state always goes with BUSY. |
||
RESERVED |
The termination is reserved for a call during Busy Line Verification |
||
SERV_EFFC_TEST |
The termination is in a Service Effecting Network loopback or Network Continuity test. |
||
DOWN |
This occurs when the MGW sends an RSIP down (graceful) message. |
Source Token
Figure 5-1 Administrative and Operational Maintenance States for MGW
Figure 5-2 Administrative and Operational Maintenance States for Residential Gateways
Figure 5-3 ISDN Administrative and Operational Maintenance States for a Trunking Gateway
GigE Support
The purpose of implementing the GigE Support Feature provisioning is to increase the bandwidth between the network switches and the Cisco BTS 10200 from 100 Mbps to 1000 Mbps.
This section describes the steps needed to enable GigE support on the UNIX hosts of the Cisco BTS 10200 Softswitch. Use this procedure only after you upgrade to Cisco BTS 10200 Release 6.0(1) or later.
Caution This is not an upgrade procedure. Performing the steps in this procedure will bring the Cisco BTS 10200 down on one side with temporary loss of redundancy. Do not start this procedure unless you have authorization from your supervisor. If you have questions, contact Cisco Technical Assistance Center (TAC). |
Caution Perform this procedure on one UNIX host at a time. |
Caution This procedure should be executed by a person very familiar with the operation and administration of the Cisco BTS 10200 and 29xx switches as well as the network and cabling of the Cisco BTS 10200. |
Prerequisites
1. The Cisco BTS 10200 Softswitch Release 6.0(1) must already be installed.
2. The BTS 10200 UNIX host must have network interfaces capable of running at GigE speed (1000 Mbps).
Provisioning the GigE Interface
For each host in Cisco BTS 10200, perform the following steps:
Step 1 Ensure that the targeted Cisco BTS 10200 applications are operating in standby mode. These applications include the Call Agent (CA), the Feature Server for POTS, Tandem, and Centrex services (FSPTC), the Feature Server for AIN services (FSAIN), the Element Management System (EMS), and the Bulk Data Management System (BDMS). If necessary, perform a switchover to ensure this is the case.
Step 2 Use the platform stop all command to stop the targeted Cisco BTS 10200 applications running on the UNIX host.
Step 3 Identify and note the Ethernet ports on the 29xx switches that connect to the Cisco BTS 10200 UNIX host.
Step 4 Modify the configuration of the switch ports connected to the Cisco BTS 10200 UNIX host to auto negotiate. To do so, first log in to the 29xx switch through console access, change to the switch port, and modify the speed and duplex mode settings on each port using the following commands:
no speed 100
no duplex full
shut
no shut
Step 5 Save the switch configuration.
Step 6 Reboot the Cisco BTS 10200 host using the shutdown -g0 -y -i6 command. We recommend that you execute the shutdown command using the console port to avoid loss of connectivity during the reboot. After the reboot, all the targeted Cisco BTS 10200 applications should automatically restart and go into standby state.
Step 7 Verify interface speed and duplex mode by executing the following command on the host:
dladm show-dev
Example output:
ca102> dladm show-dev
bge0 link: up speed: 1000 Mbps duplex: full
bge1 link: up speed: 1000 Mbps duplex: full
bge2 link: up speed: 1000 Mbps duplex: full
bge3 link: up speed: 1000 Mbps duplex: full
Step 8 Repeat for the other UNIX hosts in the Cisco BTS 10200 system.