Table Of Contents

Operations

Collecting SPE Performance Statistics

Configuring Collection of Statistics

Viewing Statistics

Managing and Troubleshooting Ports

Clearing Ports

Entering Port Configuration Mode

Managing and Troubleshooting SPEs

Specifying SPE Country Code

Entering SPE Configuration Mode

Configuring SPE Self-Tests

Testing Two Ports Back-to-Back

Disabling a Port from Dialup Services

Configuring Automatic SPE Recovery

Configuring Scheduled SPE Recovery

Clearing an SPE

Operations

---

This chapter details Cisco AS5850 routine operations that you must perform daily to configure port services on the universal port cards (UPCs). UPCs may support 216 ports or 324 ports, depending on the type of card.

The Cisco AS5850 universal gateway supports universal port cards. The 216 universal port card or 324 universal port card supports hardware and software interfaces. A port is defined as the binding of a time-division-multiplex (TDM) channel, service, and data queue to support a bidirectional service on the universal port card (UPC). A universal port is a port on a UPC that can be switched freely between two or more services without changing the TDM channel.

---

Note For details on these modem carrier cards, refer to the Cisco AS5850 Universal Gateway Hardware Installation Guide and Cisco AS5850 Universal Gateway Card Guide.

---

You can manage port connections at any of three levels—the UPC, service-processing-element (SPE—the processor on the slot card that executes protocols to process in-band data), or port level—using monitoring, polling, and troubleshooting commands. If you are familiar with the administration of modems used on other Cisco gateways, you will find that the port-management functions are very similar to those for the MICA modem (Cisco AS5800 DMM). This chapter discusses procedures and commands both similar and unique to the universal port architecture.

The universal port card uses slot and SPE software hierarchies. On the Cisco AS5850, the hierarchy is slot/spe. You can perform the following functions on an SPE:

•General configuration such as busyout, shutdown, or clear

•View statistics and states

•Configure auto and manual diagnostic tests and recovery process

•Upgrade firmware

•Retrieve trace information for ports running on an SPE

This chapter includes the following sections:

•Collecting SPE Performance Statistics

•Managing and Troubleshooting Ports

•Managing and Troubleshooting SPEs

Collecting SPE Performance Statistics

By default, event logging is enabled and SPEs are polled every 12 seconds. The log contains raw data in binary form, which must be viewed by way of the show commands listed in the "Viewing Statistics" section.

Configuring Collection of Statistics

To configure how records are kept for all available SPEs, use the following commands in global configuration mode (AS5850(config)# prompt).

Command	Purpose
spe poll auto	Enables the UPC to immediately send statistics data when its event buffers get filled, instead of waiting until the next polling interval. Use the no form to disable. When this option is disabled, data is dropped if the event buffers fill before the next polling interval. Used in the same way that the modem poll command is used for MICA modems.
spe poll time seconds	Sets the frequency with which performance statistics are retrieved from the SPEs and added to the log. Use the no form to disable. The default is 12 seconds. If the number of attempts to retrieve port status or statistics exceeds the number you define, the port is removed from operation, in which case you must reset the port using the clear port command. Replaces the modem poll time command. Used in the same way that the modem poll command is used for MICA modems.
spe call-record max-userid	Requests that the gateway generate a modem call record after a call is ended, and add it to the log. Use the no form to disable. Replaces the modem call-record command.
spe log-event-size number	Configures the size of the history event queue buffer for manageable SPEs in the gateway. The default is 100 events per port. Use the show port log command to view port events. Used in the same way that the modem buffer-size command is used for MICA modems.

To clear some or all of the log events relating to the SPEs, use the following commands in enable (privileged EXEC) mode (AS5850# prompt).

Command	Purpose
clear spe log	Clears event entries in the slot history event log.
clear spe counters	Clears statistical counters for all types of services for the specified SPE, SPE range, or all SPEs. If you do not specify the range of SPEs or type of SPE, all SPEs statistics are cleared. Used in the same way that the clear modem counters command is used for MICA modems.
show port log	Clears event entries in the port history event log.

Viewing Statistics

To view performance statistics for the UPCs, use one or more of the following commands in enable (privileged EXEC) mode (AS5850# prompt).

Command	Purpose
show spe or show spe modem	Displays the history statistics for a specific SPE, range of SPEs, or all SPEs. Used in the same way that the show modem command is used for MICA modems.
show spe modem csr	Displays call-success-rate statistics for a specific SPE, range of SPEs, or all SPEs.
show spe modem disconnect-reason	Displays disconnect reasons for a specific SPE or range of SPEs. Disconnect reasons are displayed with class boundaries. Used in the same way that the show modem call-stats command is used for MICA modems.
show spe version	Lists all SPEs and the SPE firmware files used. This helps you decide if you need to update your SPE firmware files. Used in the same way that the show modem mapping command is used for MICA modems.
show spe modem [low | high]	Shows the connect speeds negotiated within each low/high speed modulation or codecs for a specific range of SPEs or all SPEs.
show spe log	Displays the oldest event first from the slot history event log.
show spe log reverse	Displays the latest event first from the slot history event log.
show port operational-status	Displays the operational status of the specified ports or the specified port range. The port should have an active session associated when the command is run.
show port config	Displays configuration information for a specific port or range of ports. The port should have an active session associated when the command is run.
show port modem log	Displays the oldest event first from the port history event log. Used in the same way that the show modem log command is used for MICA modems.
show port modem log reverse	Displays the latest event first from the port history event log.

Managing and Troubleshooting Ports

This section describes how to clear ports, enter port-configuration mode, remove ports from service, and disable ports from dialup service. For details on disabling a port from dialup services, see the "Configuring SPE Self-Tests" section.

Clearing Ports

To clear ports if polling attempts have failed and the show spe slot/spe command shows that a port is removed from operation, use the following command in enable (privileged EXEC) mode (AS5850# prompt).

Command	Purpose
clear port slot/spe	Clears ports on an SPE. You can clear a single port, all ports on a slot, or all ports on the gateway. For example, clear port 4/1 clears all ports on SPE 1 on slot 4; clear port 4 clears all active ports on slot 4. Replaces the clear modem command.

Entering Port Configuration Mode

Port configuration mode is similar to line configuration mode. It enables individual ports or ranges of ports to be shut down or put in busyout mode. Port configuration-mode commands replace the modem range, modem busyout, and modem shutdown commands used for MICA modems.

•The following example demonstrates how to enter port configuration mode for a single port on the Cisco AS5850.

AS5850# configure terminal

Enter configuration commands, one per line.  End with CNTL/Z.

AS5850(config)# port 3/1 

AS5850(config-port)#

•The following example demonstrates how to enter port configuration mode for a range of ports on the Cisco AS5850.

AS5850# configure terminal

Enter configuration commands, one per line.  End with CNTL/Z.

AS5850(config)# port 3/1 3/18

AS5850(config-port)#

The following commands are available in port configuration mode (AS5850(config-port)# prompt).

Command	Purpose
busyout	Disables a port by waiting for the active services on the specified ports to end. Use the no form to reenable the ports. Replaces the modem busyout command.
shutdown	Clears active calls on the specified ports. No more calls can be placed on the port. The SPE state is changed to the Out-of-Service state. The state of the SPEs is reflected in the show spe command display. Use the no form to reenable the ports. Replaces the modem shutdown command.

Managing and Troubleshooting SPEs

This section describes how to set the SPE country code, enter SPE configuration mode, configure SPE self-tests, test ports, disable ports, configure SPE recovery, and clear an SPE.

Specifying SPE Country Code

To specify the country to set the UPC parameters (including country code and encoding) for UPCs, use the following command in global configuration mode (AS5850(config)# prompt).

Command	Purpose
spe country country-name	Specifies the SPE country code. If T1s are configured, default is t1-default; if E1s are configured, default is e1-default. Use the no form to set to the domestic default. A list of all supported countries is displayed in the help file. Replaces the modem country command. Note All sessions on all slot cards in all slots must be IDLE (no calls active) for this command to run.

Entering SPE Configuration Mode

SPE configuration mode allows you to enter SPE configuration commands. You can configure an SPE by specifying a slot and an SPE associated with the slot. Or you can configure a range of SPEs by specifying the first and last SPE in the range.

•The following example demonstrates how to enter SPE configuration mode on the Cisco AS5850 for a range of SPEs:

AS5850# config t

Enter configuration commands, one per line.  End with CNTL/Z.

AS5850(config)# spe 1/1 1/18

AS5850(config-spe)#

The following commands are available in SPE configuration mode (AS5850(config-spe)# prompt).

Command	Purpose
firmware location filename	Upgrades firmware for SPEs after the new SPE firmware image has been copied to Flash memory. This command cannot be performed on the SPEs that are in the bad state. For further information on firmware upgrades, see the "Upgrading SPE Firmware" section on page 5-25.
firmware upgrade {busyout | recovery | reboot}	Specifies the upgrade method. Three methods are available: busyout upgrades when all calls are terminated on the SPE; recovery upgrades at recovery maintenance time; reboot upgrades at the next reboot. For further information on firmware upgrades, see the "Upgrading SPE Firmware" section on page 5-25.
busyout	Gracefully disables an SPE by waiting for all active services on the specified SPE to end. If there are active ports on the specified SPE, the BusyoutPending state is assigned to the SPE that is reflected in the show spe command. When all calls end on the BusyoutPending SPE, the SPE state changes to Out-of-Service. Auto-diagnostic tests and firmware upgrade functions can be performed while SPEs are out of-service. This implies that SPEs that are in Busyout state can transition to the bad state because they failed auto-diagnostic test or firmware upgrade. User actions are logged into syslog. The shutdown command overrides the busyout command. Use the no form to reenable the SPEs.
shutdown	Clears active calls on all ports on the SPE. No more calls can be placed on these ports. The SPE state changes to Out-of-Service. The state of the SPEs is reflected in the show spe command. Use the no form to reenable the ports. Replaces the modem shutdown command.

Configuring SPE Self-Tests

The results of the SPE self-test are displayed in the Status column of the output from the show spe modem and show spe modem active commands. Ports that pass the diagnostic test are marked as idle, busy, downloading, and reset, and are put into service. Ports that fail the diagnostic test are marked as bad, and are not put into service or tested again until they are no longer marked as bad. If all ports of an SPE are bad, the corresponding SPE is also marked bad. These ports cannot be used for call connections. Depending on how many ports are present and not marked bad, this diagnostic test can take 5-15 minutes to complete.

You can perform additional testing on an inoperative port by using the test modem back-to-back command.

To perform self-diagnostic testing on all installed ports during system initial startup or rebooting, or during service, use the following command and options in global configuration mode (AS5850(config)# prompt).

Command	Purpose
port modem autotest	Performs back-to-back diagnostic testing for all ports. Use the no form to disable testing.
port modem autotest minimum ports	Defines the minimum number of free ports available for autotest to begin.
port modem autotest time hh:mm interval	Enables auto-testing time and interval.

Testing Two Ports Back-to-Back

When a port has tested bad, you can perform additional testing by conducting a series of internal back-to-back connections and data transfers between two ports. All port test connections occur inside the gateway. For example, if mobile users cannot dial into port 2/5 (the sixth port on the UPC in the second chassis slot), you can attempt a back-to-back test with port 2/5 and a known-functioning port such as port 2/6.

To perform internal back-to-back port tests between two ports, use the following command in enable (privileged EXEC) mode (AS5850# prompt).

Command	Purpose
test port modem back-to-back slot/port slot/port size	Performs internal back-to-back tests between two ports, sending test packets of the specified size.

You might need to use this command on several different combinations of ports to determine which one is not functioning properly. A pair of operable ports successfully connect and complete transmitting data in both directions. An operable port and an inoperable port do not successfully connect with each other.

A sample back-to-back test can look like the following:

AS5850# test port modem back-to-back 3/7 3/100

AS5850#.Feb 10 16:56:19.536: %PM_MODEM_MAINT-5-B2BCONNECT: Modems (3/07) and (3/100) 
connected in back-to-back test: CONNECT33600/V34/LAP

.Feb 10 16:56:25.708: %PM_MODEM_MAINT-5-B2BMODEMS: Modems (3/100) and (3/07) completed 
back-to-back test: success/packets = 200/200

If you attempt a back-to-back test on a port that is in use, the output can look like the following:

AS5850# test port modem back-to-back 3/7 3/100

Repetitions (of 10-byte packets) [1]: 100

Modem 3/07 is currently busy, Back-to-back Test will be delayed.

You can often fix an SPE handling a port that has been confirmed to have problems by using the clear spe command. For more information, see the "Clearing an SPE" section.

Disabling a Port from Dialup Services

To disable ports from dialing or answering calls, use one of the following commands in port configuration mode (AS5850(config-port)# prompt).

Command	Purpose
busyout	Disables a port from dialup services.
shutdown	Shuts down a port from dialup services.

The busyout command does not run until the active port is idle; no active connections are interrupted. In contrast, the shutdown command immediately ends all active connections on the specified port. The resulting port status is the same for both commands. Use the no form of these commands to restore a port for dialup services.

You can disable ports on specific SPEs in SPE configuration mode (AS5850(config-spe)# prompt).

Some problems with ports require a reload of SPE firmware, and all ports on an SPE must be out of service before you can reload the firmware.

You can still use the test modem back-to-back and clear port commands on a disabled port.

Configuring Automatic SPE Recovery

To configure automatic recovery (removal from service and reloading of SPE firmware) of ports on an SPE at any available time, use one of the following commands in global configuration mode (AS5850(config)# prompt).

Command	Purpose
spe recovery port-action {disable | recover} port-threshold num-failures	When an SPE port fails to connect for a certain number of consecutive times, a problem exists with the SPE firmware. These SPEs have to be recovered by downloading firmware. Any port failing to connect num-failures times is moved to a state based on port-action. You can disable (mark the port as bad) or recover the port when the SPE is idle and has no active calls. The default for num-failures is 30.
spe download maintenance	Alternative way to schedule recovery.

Configuring Scheduled SPE Recovery

To configure a scheduled recovery of SPEs, use the following command in global configuration mode (AS5850(config)# prompt).

Command

Purpose

spe download maintenance time hh:mm stop-time hh:mm max-spes num-of-spes window time-period expired-window {drop-call | reschedule}

Download maintenance starts at time, steps through all SPEs that need recovery and SPEs that need a firmware upgrade, and starts maintenance on max-spes at a time. The system waits for the window delay time for all the ports on the SPE to become inactive before moving the SPE to the idle state. The process downloads firmware immediately after the SPE moves to idle. If the ports are still in use by the end of window, depending on the expired-window setting, connections on the SPE ports are shut down and firmware is downloaded by way of the drop-call option, or the firmware download is rescheduled to the next download maintenance time by way of the reschedule option. This process continues until the number of SPEs under maintenance is below max-spes, until stop-time (if set), or until all SPEs marked for recovery or upgrade have had their firmware reloaded.

Clearing an SPE

To manually recover a port that is frozen in a suspended state, use the following command in enable (privileged EXEC) mode (AS5850# prompt).

Command	Purpose
clear spe	Causes the firmware configured for a SPE to be downloaded to the specified SPE or range of SPEs, and runs the power-on self-test (POST). Can be run regardless of the state of the SPEs. All active ports running on the SPE are prematurely ended and messages are sent to the appropriate log. Replaces the clear modem command.

The following example shows a cold start on SPE 1 on slot 1:

AS5850# clear spe 1/1

AS5850# Are you sure you want to clear SPE 1/1(Y/N)? Y