Document ID: 29122
Contents
Introduction
Prerequisites
Requirements
Components Used
Conventions
The on1 and off1 Command Parameters
Template for the on1 and off1 Commands
The on1 and off1 Command Parameter Definitions
The on2 and off2 Command Parameters
Template for the on2 and off2 Commands
The on2 and off2 Command Parameter Definitions
The on3 and off3 Command Parameters
Template for the on3 and off3 Commands
The on3 and off3 Command Parameter Definitions
NetPro Discussion Forums - Featured Conversations
Related Information
Introduction
This document describes the on1, on2, and on3 command nodal parameters that affect network performance. The intent is to provide a reference for the meaning and function of those nodal parameters. You must log on with a Service level username to enable or disable the on1, on2, and on3 command parameters.
Prerequisites
Requirements
Readers of this document should be knowledgeable of:
-
Strong knowledge of IGX/BPX platforms and network.
This document can generally be used to understand those parameters on other switch software versions of IGX and BPX.
Components Used
The information in this document is based on these software and hardware versions:
-
IGX 9.2.x switch software
The information presented in this document was created from devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If you are working in a live network, ensure that you understand the potential impact of any command before using it.
Conventions
For more information on document conventions, refer to the Cisco Technical Tips Conventions.
The on1 and off1 Command Parameters
To enable a feature, use the on1 command followed by the number of the parameter, which represents the feature.
To disable a feature, use the off1 command, followed by the number of the parameter, which represents the feature.
Template for the on1 and off1 Commands
The default values for the on1 and off1 command parameters are shown below.
Note: The parameter shown in italic does not display the default value, but is recommended. Also, some parameters may be in a different order, which is dependent on the version of software.
|
The on1 and off1 Command Template |
|---|
Function Number Status Function Number Status Background Upcard 1 Enabled Dynamic BW Allocation 15 Enabled Background Updates 2 Disabled Modem Polling 16 Enabled Standby Terminal 3 Disabled Conn Stat Sampling 17 Enabled Memory Protection 4 Enabled SVC Del Bgnd Updates 18 Disabled Comm Break 5 Enabled FastPAD Test 19 Disabled Comm Fail Test 6 Enabled Neighbor Update Errs 20 Disabled BRAM Memory Protect 7 Enabled CRC Test 8 Enabled CDT Clock Test 9 Enabled Bus Fail Detection 10 Enabled Line Diag 11 Enabled Clock Restoral 12 Enabled Cm_Rerouting 13 Enabled Clock Routing 14 Enabled |
The on1 and off1 Command Parameter Definitions
This section describes the parameters listed in the on1 and off1 command template.
-
Background Upcard
-
Enabled—The card is able to communicate with the processor via the Cbus.
-
Disabled—The card is not able to communicate with the processor via the Cbus. If disabled, and the card is removed by any reason—a power outage, firmware upgrade, abort, manual removal, and so on—it is shown as removed permanently in the dspcds command display.
-
-
Background Updates
-
Enabled—Not recommended.
-
Disabled—Recommended.
The Background Updates parameter was originally designed as a state machine used to control the sending of conditional updates. However, conditional updates are now controlled by a different portion of the switch software and are sent on demand rather than by the trigger of a state machine. Cisco Systems recommends that you disable this parameter.
-
-
Standby Terminal
-
Enabled—Allows you access to the standby processor card for debug purposes by using a virtual terminal (VT). You can use other methods to accomplish this with newer switch software releases—you do not need to enable this parameter.
-
Disabled—Does not allow you access to the standby processor card for debug purposes by using a VT.
-
-
Memory Protection
Caution: You must enable this parameter to ensure normal operation.-
Enabled—Memory protection is activated.
-
Disabled—Memory protection is not available. In instances where memory is patched for severe problem situations, this parameter is disabled while the patch is applied. Once the patch is complete, you must enable this parameter.
-
-
Comm Break
-
Enabled—A Comm Break is declared by a node if its management traffic is not acknowledged by another node.
-
Disabled—A Comm Break is not declared when management traffic is not acknowledged.
-
-
Comm Fail Test
-
Enabled—The Comm Fail test is run asynchronously by every node to ensure that it can communicate with its immediate neighbors over its trunks. In the Comm Fail test, the processor sends a packet, or stream of packets, out on a trunk. If there is no response within a specified time, the pattern is sent again. If there is no response for a given number of retries, the line is declared to be in the Comm Fail state and is removed from service. This failure information is then transmitted to all nodes in the network.
-
Disabled—The Comm Fail test is not performed.
-
-
BRAM Memory Protect
Caution: You must enable this parameter to ensure normal operation and it
may only be changed by Cisco engineering or TAC personnel.-
Enabled—Battery backed RAM (BRAM) protection is available. The node processor carries BRAM, which is used to hold all system configuration parameters, the system event log, and user-defined jobs.
-
Disabled—No BRAM memory protection is available, which may lead to RAM corruption.
-
-
CRC Test
Caution: You must enable this parameter, an internal cyclic redundancy
check (CRC), to ensure normal operation.-
Enabled—CRC is activated.
-
Disabled—CRC is not available. In instances where memory is patched for severe problem situations, this parameter is disabled while the patch is applied. Once the patch is complete, you must enable this parameter.
-
-
CDT Clock Test
Caution: This parameter is old, but you should enable it because there may
be switch software dependencies for this parameter that are embedded in the
baseline code.-
Enabled—The CDT clock test is activated.
-
Disabled—The CDT clock test is not available.
-
-
Bus Fail Detection
-
Enabled—Allows you to view the active and standby status of each bus when you use the dspbuses command.
-
Disabled—You cannot view the status of any bus.
-
-
Line Diag
Caution: You must enable this parameter to ensure normal operation.-
Enabled—Packet and circuit lines are tested after an alarm condition occurs.
-
Disabled—No packet or circuit lines are tested after an alarm condition occurs.
-
-
Clock Restoral
-
Enabled—When a node has clock sources configured, it chooses one of these primary clock sources for timing. If this clock source is lost, then the node changes to another clock source. When the original clock source returns to service, and if that clock source is a higher priority, the node changes back to that original clock source.
-
Disabled—The node does not change back to the original clock source.
-
-
CM Rerouting
-
Enabled—Allows failed connections to reroute.
-
Disabled—Does not allow failed connections to reroute.
-
-
Clock Routing
-
Enabled—Allows automatic selection of network clock sources.
-
Disabled—Does not allow automatic selection of network clock sources.
-
-
Dynamic BW Allocation
Caution: You must enable this parameter to ensure normal operation.-
Enabled—Dynamic bandwidth (BW) allocation is activated.
-
Disabled—Dynamic bandwidth allocation is not available.
-
-
Modem Polling
-
Enabled—Allows high-speed modem detection. High-speed modems emit a 2100 Hz tone for identification purposes. When that tone is detected, echo canceling within the path is disabled.
-
Disabled—Does not allow high-speed modem detection.
-
-
Conn Stat Sampling
-
Enabled—Allows the collection of Cisco WAN Manager (CWM) statistics. Trivial File Transfer Protocol (TFTP) statistics are enabled using the cnfstatparms command on each node or via CWM Stats Collection Manager (SCM).
-
Disabled—Does not allow the collection of CWM statistics; it is possible to have interval statistics enabled with the cnfstatparms command, but no files created if this parameter is disabled.
-
-
SVC Del Bgnd Updates
-
Enabled—Allows background updates for deleted Switched Virtual Circuits (SVCs).
-
Disabled—Does not allow background updates for deleted SVCs.
This parameter is a fix for bug CSCdp45833 ( registered customers only) . SVC deletions were sometimes incomplete, which caused dangling SVC LAN connections (LCONs), which caused voice quality problems.
-
-
FastPAD Test
-
Enabled—The FastPAD test is activated. This is part of the Frame level (FRM) protocol used to communicate with the FastPAD device.
-
Disabled—The FastPAD test is not available. If there are no Fast PAD devices in the network, you should disable this parameter to save CPU cycles on the node.
-
-
Neighbor Update Errs
Caution: You must disable this parameter to ensure normal
operation.-
Enabled—Neighbor update errors is activated.
-
Disabled—Neighbor update errors is not available.
-
The on2 and off2 Command Parameters
To enable a feature, use the on2 command followed by the number of the parameter, which represents the feature.
To disable a feature, use the off2 command, followed by the number of the parameter, which represents the feature.
Template for the on2 and off2 Commands
The default values for the on2 and off2 command parameters are shown below.
Note: The parameters shown in italic do not display the default values, but are recommended.
|
The on2 and off2 Command Template |
|---|
Function Number Status Function Number Status Line Stat Sampling 1 Enabled LAN Interface 15 Enabled Statistical Alarm 2 Enabled Update Standby Stats 16 Enabled Job Ready Checker 3 Enabled EIA Monitoring 17 Disabled Configuration Backup 4 Enabled Telnet Access 18 Enabled Standby Update 5 Enabled Junction ID 19 Enabled Downloader 6 Enabled Mult SV+/Routing Node 20 Enabled Cm Updates 7 Enabled Feeder with NW Trunks 21 Disabled Power Supply Monitor 8 Enabled Multiple Fdr Trunks 22 Disabled Topo/Stat Updates 9 Enabled Simulated Fdr Trks 23 Disabled CDP/CIP Sig. Polling 10 Enabled Auto Renum Fail Recov 24 Enabled Port Stat Sampling 11 Enabled IGX - ACM Selftest 25 Enabled Robust Updates 12 Enabled Card Simulation Tool 26 Disabled Robust Alarm Updates 13 Enabled Major Alarm on NNI 27 Disabled Realtime Counters 14 Enabled Deroute Delay 28 Enabled |
The on2 and off2 Command Parameter Definitions
This section describes the parameters listed in the on2 and off2 command template.
-
Line Stat Sampling
-
Enabled—Provides statistics to Cisco WAN Manager (CWM).
-
Disabled—Does not allow statistics to be provided to CWM. It is possible to have Trivial File Transfer Protocol (TFTP) interval statistics enabled, but no files are created for collection.
-
-
Statistical Alarm
-
Enabled—Auto statistics alarms are generated.
-
Disabled—No Auto statistical alarms are generated.
Auto statistics are used for the switch statistical alarming feature; refer to Solving the Error Message "Not enough Auto Stats Memory, Reconfigure using cnfnodeparm" for more information on Auto statistics. These are automatically allocated when certain statistical entities are upped or added. Auto statistic entities on the BPX are trunks, lines, and cards.
-
-
Job Ready Checker
-
Enabled—Allows jobs that you can configure on the node to run at various times or as a result of various triggers.
-
Disabled—Does not allow jobs that you can configure on the node to run at various times or as a result of various triggers.
-
-
Configuration Backup
-
Enabled—Changes made on the node are written to the battery backed RAM (BRAM).
-
Disabled—Changes made on the node are written to the dynamic RAM (DRAM) only and are lost if the node loses power.
-
-
Standby Update
-
Enabled—The active processor sends updates to the standby processor.
-
Disabled—The standby processor is not updated.
-
-
Downloader
-
Enabled—Allows software/firmware downloads to the node.
-
Disabled—Does not allow software/firmware downloads to the node.
-
-
CM Updates
Caution: You must enable this parameter to ensure normal operation.-
Enabled—Allows control of some dependencies for the connection manager (CM).
-
Disabled—Does not allow the control of dependencies for the CM.
-
-
Power Supply Monitor
-
Enabled—Allows you to view the power supply status with the dsppwr command.
-
Disabled—Does not allow you to view the power supply status with the dsppwr command.
-
-
Topo/Stat Updates
Caution: You must enable this parameter to ensure normal operation.-
Enabled—Assists controlling the topology and statistics updates.
-
Disabled—Does not assist controlling the topology and statistics updates.
-
-
CDP/CIP Sig. Polling
-
Enabled—Allows you to view the signaling used on voice connections with the dspsig command.
-
Disabled—Does not allow you to view the signaling used on voice connections with the dspsig command.
-
-
Port Stat Sampling
-
Enabled—Allows you to view and collect port related statistics.
-
Disabled—Does not allow you to view and collect port related statistics.
-
-
Robust Updates
-
Enabled—Allows the node to send statistics to Cisco WAN Manager (CWM).
-
Disabled—Does not allow the node to send statistics to CWM.
-
-
Robust Alarm Updates
-
Enabled—Trunk or line alarm indications are sent to Cisco WAN Manager (CWM) if you configure the alarms with the cnftrkalm and cnflnalm commands.
-
Disabled—Alarm indications are not sent to CWM.
-
-
Realtime Counters
-
Enabled—Allows the collection of real-time counters and statistics.
-
Disabled—Does not allow the collection of real-time counters and statistics.
-
-
LAN Interface
-
Enabled—The LAN port is usable.
-
Disabled—The LAN port is not usable.
-
-
Update Standby Stats
-
Enabled—Allows statistics to be passed from the active to the standby card.
-
Disabled—Statistics can not be passed from the active to the standby card.
-
-
EIA Monitoring
-
Enabled—Allows Electronic Industies Alliance (EIA) monitoring.
-
Disabled—Does not allow EIA monitoring.
Note: This parameter is obsolete for Switch Software 9.2.x and later.
-
-
Telnet Access
-
Enabled—Allows Telnet access to the node.
-
Disabled—Does not allow Telnet access to the node.
-
-
Junction ID
-
Enabled—Routes algorithms within a structured network. Since this parameter is not relevant for nonstructured networks, enabling does not affect CPU cycles.
-
Disabled—Does not route algorithms within a structured network.
-
-
Mult SV+ / Routing Node
-
Enabled—Provides the ability to have multiple Cisco WAN Manager (CWM) stations. You should enable this parameter on all nodes in networks where there is more than one CWM station.
-
Disabled—Does not provide the ability to have multiple CWM stations.
-
-
Feeder with NW Trunks
-
Enabled—Allows the feeder with network (NW) trunks feature with structured networks.
-
Disabled—Does not allow the feeder with NW trunks feature.
-
-
Multiple Fdr Trunks
-
Enabled—Allows the Multiple Fdr Trunks feature with structured networks.
-
Disabled—Does not allow the Multiple Fdr Trunks feature.
-
-
Simulated Fdr Trunks
Caution: You should disable this parameter to ensure normal operation; it
is only used in system testing.-
Enabled—Allows the Simulated Fdr Trunks feature with structured networks.
-
Disabled—Does not allow the Simulated Fdr Trunks feature.
-
-
Auto Renum Fail Recov
-
Enabled—Allows the automatic recovery of a renumbering failure.
-
Disabled—Does not allow the automatic recovery of a renumbering failure.
-
-
IGX ACM Self Test
-
Enabled—The Adapter Cellbus Module (ACM) self test is implemented as part of the standard self test. ACMs allow IPX front cards to be used in IGX nodes.
-
Disabled—No ACM self test occurs.
-
-
Card Simulation Tool
Caution: You should disable this parameter to ensure normal operation; it
is only used in system testing.-
Enabled—Allows you to use the Card Simulation Tool.
-
Disabled—Does not allow you to use the Card Simulation Tool.
-
-
Major Alarm on NNI
-
Enabled—When a Network-to-Network (NNI) connection fails, or the status has changed in the other network, a major alarm is indicated on the node that has the NNI connection on it.
-
Disabled—When a NNI connection fails, or the status has changed in the other network, a minor alarm is indicated on the node that has the NNI connection on it.
When you use the dspalms command, a Frame Relay port communication failure is indicated, followed by a number. The number indicates the number of NNI connections affected.
When you use the dsplog command, a minor alarm indicates that a Frame Relay port has failed. This means that Local Management Interface (LMI) has been lost from the other network. This failure is flagged as minor because it is not from within your network.
-
-
Deroute Delay
-
Enabled—Enables the deroute delay feature on the node.
-
Disabled—Disables the deroute delay feature on the node.
-
The on3 and off3 Command Parameters
To enable a feature, use the on3 command followed by the number of the parameter, which represents the feature.
To disable a feature, use the off3 command, followed by the number of the parameter, which represents the feature.
Template for the on3 and off3 Commands
The default values for the on3 and off3 command parameters are shown below.
Note: The parameter shown in italic does not display the default value, but is recommended.
|
The on3 and off3 Command Template |
|---|
Function Number Status Region memory init 1 Disabled Trace Msg Sent 2 Disabled Multi-DB Stby Updates 3 Enabled AIT/BTM/ALM 32h Ext2 4 Enabled Card Synchronization 5 Enabled Loop Access Dev Init 6 Disabled Auto allocate UXM UBU 7 Disabled Trace Conv Msg 8 Disabled Automatic Cbus Diags 9 Disabled CBUS Flood Protection 10 Enabled Load Bal on EqCost Rt 11 Disabled |
The on3 and off3 Command Parameter Definitions
This section describes the parameters listed in the on3 and off3 command template.
-
Region memory init
-
Enabled—RAM memory is cleared during a rebuild.
-
Disabled—RAM is not cleared during a rebuild, but considered to be deallocated, which allows you to view the information after the rebuild for debug purposes.
-
-
Trace Msg Sent
Caution: You should disable this parameter to ensure normal
operation.-
Enabled—Allows the nwtrace debug tool to trace network messages between nodes in the transmit direction before and after conversion in a network using version interoperability.
-
Disabled—Does not allow the nwtrace debug tool to trace network messages between nodes in the transmit direction before and after conversion in a network using version interoperability.
-
-
Multi-DB Stby Updates
-
Enabled—Allows multiple databases to be included in a single update message to the standby processor.
-
Disabled—Does not allow multiple databases to be included in a single update message to the standby processor.
-
-
AIT/BTM/ALM 32h Ext2
-
Enabled—Allows multiple 0x32 commands to be combined into a single 0x32 message sent to the trunk card. After using the swtichcc command, the 0x32 command is used to reprogram logical channel numbers (LCNs) for Broadband Trunk Module (BTM) and Asynchronous Transfer Mode Line Module (ALM) only.
-
Disabled—Does not allow multiple 0x32 commands to be combined into a single 0x32 message sent to the trunk card.
-
-
Card Synchronization
-
Enabled—Allows the synchronization of the broadband trunk cards on the IGX following a switchcc command; it synchronizes the card database with the actual logical channel numbers (LCNs) programmed on the card.
-
Disabled—Does not allow the synchronization of the broadband trunk cards on the IGX following a switchcc command.
-
-
Loop Access Dev Init
-
Enabled—Causes the simulated 38xx access device to initialize with Cisco WAN Manager (CWM). The parameter is used in conjunction with the cnfsimlp command.
-
Disabled—Does not cause the simulated 38xx access device to initialize with CWM.
-
-
Auto Allocate UXM UBUs
Caution: Cisco Systems recommends that you disable this parameter for
large networks because of processing requirements; minimum bandwidth allocated
automatically may not be sufficient.-
Enabled—Allows automatic calculation of Universal Bus Units (UBUs) for the Universal Switching Module (UXM) in line mode. UXMs have configurable UBUs. As lines, ports, and connections are added to a card, the allocated UBUs do not change automatically unless you enable this parameter.
Note: This feature does not work for trunk cards.
-
Disabled—Does not allow automatic calculation of UBUs for the UXM in line mode.
-
-
Trace Conv Msg
-
Enabled—Allows the nwtrace debug tool to trace network messages between nodes in the receive direction before and after conversion in a network using version interoperability.
-
Disabled—Does not allow the nwtrace debug tool to trace network messages between nodes in the receive direction before and after conversion in a network using version interoperability.
-
-
Automatic Cbus Diags
-
Enabled—Allows the node to go into offline diagnostics when both control buses fail with no available standby controller card.
-
Disabled—Allows the node to perform background Cbus testing to check for any good control bus before going into offline testing when both control buses fail with no available standby controller card.
-
-
CBUS Flood Protection
-
Enabled—Prevents a card in the node from flooding the Cbus, due to an IGX line card, which would typically require a power down to clear.
-
Disabled—Does not prevent a card in the node from flooding the Cbus.
This parameter is a fix for bug CSCdp35148 ( registered customers only) .
-
-
Load Balancing on Equal Cost Routes (Released in 9.4.10).
-
Enabled—Allows connections to be load balanced across routes of equal cost. This is based on the "open space" of the path.
-
Disabled—Uses the old method of routing connections across routes of equal cost, that is, based on lowest logical trunk ID.
-
NetPro Discussion Forums - Featured Conversations
| NetPro Discussion Forums - Featured Conversations for WAN Switching |
| Network Infrastructure: WAN Routing and Switching |
Related Information
- Cisco WAN Switching Solutions – Cisco Documentation
- Guide to New Names and Colors for WAN Switching Products
- Software Center – WAN Switching Software
- Technical Support – Cisco Systems
| Updated: Oct 04, 2005 | Document ID: 29122 |
