Cisco MGX 8850 Routing Switch Command Reference Release 2.0 October 2001 Corporate Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
Cisco Reader Comment Card General Information 1 Years of networking experience: 2 I have these network types: Other: LAN Backbone 3 I have these Cisco products: Other (specify models): Switches Routers 4 I perform these types of tasks: Network management H/W installation and/or maintenance Other: S/W configuration 5 I use these types of documentation: Command reference Other: H/W installation Quick reference S/W configuration Online help 6 I access this information through: % Printed docs
FIRST-CLASS MAIL PERMIT NO.
C O N T E N T S About This Manual Objectives Audience xxi xxi xxi Organization xxii Related Documentation Conventions xxiii xxiv Command Changes xxv New Commands xxv Changed Commands xxvi Removed Commands xxvi CHA PTER 1 Command Line Interface Overview The Role of the CLI 1-1 1-1 Command Line Prompt 1-2 Command Syntax 1 - 2 Notation 1 - 3 Position-Dependent and Keyword-Driven Parameters Command Entry 1 - 3 Contents of a Command Description Identifying the AXSM Models 1-3 1-4 Connection C
Contents del 1 - 17 exit 1 - 18 help 1 - 19 history 1 - 20 logout 1 - 21 ls 1 - 22 ping 1 - 24 pwd 1 - 25 who 1 - 26 whoami CHA PTER 2 1 - 27 Shelf Management Commands 2-1 Position-Dependent and Keyword-Driven Parameters Command Entry 2-2 Identifying the AXSM Models 2-2 Connection Capacities of the AXSM 2-2 Identifying Physical and Logical Elements AXSM Format 2 - 3 PNNI Format 2 - 4 abortrev adduser 2-9 2 - 10 bootChange burnboot 2 - 12 2 - 14 clidbxlevel 2 - 15 clrallc
Contents cnftmzngmt cnfuser 2 - 36 2 - 37 commitrev 2 - 39 delclksrc 2 - 41 deltrapmgr deluser 2 - 42 2 - 43 downloadflash dspbkpl dspcd 2 - 44 2 - 45 2 - 46 dspcds 2 - 49 dspclksrcs dspdisk 2 - 51 2 - 55 dspipconntask dspipif 2 - 56 2 - 57 dspipifcache 2 - 59 dspndparms 2 - 60 dsppvcif 2 - 61 dsprevs 2 - 63 dspserialif 2 - 66 dspsnmp 2 - 67 dsptrapmgr dspusers 2 - 68 2 - 69 dspversion ipifconfig 2 - 70 2 - 72 loadrev 2 - 75 pvcifconfig resetsys 2 - 79 2 - 81 restore
Contents timeout 2 - 100 users CHA PTER 3 2 - 101 Equipment and Resource Provisioning 3-1 Position-Dependent and Keyword-Driven Parameters Command Entry 3-2 Identifying the AXSM Models 3-2 Connection Capacities of the AXSM 3-2 Identifying Physical and Logical Elements AXSM Format 3 - 3 PNNI Format 3 - 4 addapsln 3-8 3 - 11 addpart 3 - 12 addport 3 - 15 addred 3 - 18 addrscprtn clrbecnt 3 - 19 3 - 21 clrfdrstat 3 - 22 cnfapsln 3 - 23 cnfatmln 3 - 25 cnfcdsct 3 - 27 cnfln 3 -
Contents dspapsbkplane dspapsln 3 - 48 3 - 49 dspapslns 3 - 51 dspatmln 3 - 52 dspbecnt 3 - 53 dspcd 3 - 54 dspcds 3 - 57 dspcdsct 3 - 59 dspcon 3 - 64 dspcons 3 - 68 dspcontrollers dspfdr 3 - 72 dspfdrs 3 - 73 dspfdrstat dspln 3 - 74 3 - 75 dsplns 3 - 77 dspload 3 - 79 dsppart 3 - 81 dspparts 3 - 83 dspport 3 - 84 dspports 3 - 86 dspportsct dspred 3 - 87 3 - 94 dsprscprtn 3 - 95 dsprscprtns dspsct 3 - 102 switchapsln 3 - 103 switchredcd 3 - 104 uplmi upln u
Contents AXSM Format 4 - 2 PNNI Format 4 - 2 addprfx 4-4 clrilmicnt 4-5 cnfaddrreg 4-6 cnfautocnf 4-7 cnfilmi 4-8 cnfilmienable 4 - 10 cnfilmiproto 4 - 12 dbgilmi 4 - 14 delprfx 4 - 15 dnilmi 4 - 16 dspilmi 4 - 17 dspilmiaddr 4 - 18 dspilmicnt dspilmis 4 - 19 4 - 20 dsppnilmi dspprfx upilmi CHA PTER 5 4 - 21 4 - 23 4 - 24 PNNI Commands 5-1 PNNI Addressing 5-2 Position-Dependent and Keyword-Driven Parameters Command Entry 5-3 Identifying the AXSM Models 5-3 Identifying
Contents cnfpnni-routing-policy cnfpnni-scope-map 5 - 35 5 - 39 cnfpnni-svcc-rcc-timer cnfpnni-timer dbgpnni 5 - 41 5 - 43 5 - 47 delpnni-node 5 - 51 delpnni-summary-addr dsppnni-bn-path 5 - 53 dsppnni-bypass dsppnni-dbg 5 - 56 5 - 58 dsppnni-election dsppnni-idb 5 - 52 5 - 60 5 - 62 dsppnni-inducing-uplink dsppnni-intf 5 - 66 dsppnni-link 5 - 69 dsppnni-link-selection dsppnni-mtu 5 - 64 5 - 71 5 - 73 dsppnni-neighbor dsppnni-node 5 - 74 5 - 77 dsppnni-node-list dsppnni-path 5
Contents Connection Capacities of the AXSM 6-3 Identifying Physical and Logical Elements AXSM Format 6 - 4 PNNI Format 6 - 4 Dot Notation in ATM Addresses addaddr 6-9 addpnport 6 - 12 aesa_ping 6 - 14 clrpnconstats clrsigstats 6 - 16 6 - 18 clrsscopstats 6 - 20 cnfe164justify cnfenhiisp 6 - 21 6 - 22 cnffdonaal5 cnffltset 6 - 23 6 - 24 cnfintfcongth 6 - 26 cnfnodalcongth cnfpnctlvc 6 - 28 6 - 31 cnfpnportacc 6 - 33 cnfpnportcac 6 - 34 cnfpnportcc 6 - 36 cnfpnportloscallrel cnfp
Contents dspaddr 6 - 65 dspatmaddr 6 - 66 dspconsegep 6 - 67 dspenhiisp dspfltset 6 - 68 6 - 69 dspintfcongcntr 6 - 71 dspintfcongflags dspintfcongth 6 - 72 6 - 73 dspnodalcongcntr 6 - 74 dspnodalcongflags 6 - 75 dspnodalcongth 6 - 76 dsppingatmaddr 6 - 78 dsppncon 6 - 79 dsppncons 6 - 81 dsppnconstats 6 - 83 dsppnctlvc 6 - 86 dsppnport 6 - 87 dsppnportcac 6 - 89 dsppnportcc 6 - 90 dsppnportidmaps 6 - 91 dsppnportloscallrel dsppnportrange dsppnportrsrc 6 - 93 6 - 94 ds
Contents CHA PTER 7 SPVC and SVC Commands 7-1 Position-Dependent and Keyword-Driven Parameters Command Entry 7-2 Identifying the AXSM Models 7-2 Connection Capacities of the AXSM 7-2 Identifying Physical and Logical Elements AXSM Format 7 - 3 PNNI Format 7 - 4 addcon 7 - 15 clrpnconstats 7 - 17 7 - 18 cnfabrtparmdft cnfcdvtdft cnfcon 7 - 20 7 - 22 7 - 24 cnfconsegep 7 - 28 cnfmbsdft 7 - 29 cnfoamsegep delcon 7 - 30 7 - 31 delcons 7 - 32 delconsegep dncon 7-3 7-6 clrpncon cnfa
Contents CHA PTER 8 Network Optimization Commands 8-1 Position-Dependent and Keyword-Driven Parameters Command Entry 8-1 Identifying the AXSM Models 8-2 Connection Capacities of the AXSM 8-2 Identifying Physical and Logical Elements AXSM Format 8 - 3 PNNI Format 8 - 4 cnfpnportloscallrel cnfrrtparm 8-5 8-8 cnfrteoptthld dspload 8 - 11 8 - 12 dsppnportloscallrel dsprrtparm 8 - 17 dsprteoptstat 8 - 18 8 - 19 routeShow 8 - 21 routestatShow CHA PTER 9 8 - 15 8 - 16 dsprteoptcnf rrt
Contents clrchancnts 9 - 14 clrdiagerr 9 - 15 clrdiagstat clrerr 9 - 16 9 - 17 clrerrhist 9 - 18 clrilmicnt 9 - 19 clrlncnt 9 - 20 clrlog 9 - 21 clrportcnt 9 - 22 clrportcnts 9 - 23 clrxbaralm 9 - 24 clrxbarerrcnt 9 - 25 cnfalm 9 - 26 cnfdiag 9 - 31 cnfdiagall 9 - 35 cnfpnportloscallrel cnfxbarerrthresh cnfxbarmgmt 9 - 42 copycons 9 - 43 9 - 45 delchanloop dellnloop dncon dnln 9 - 46 9 - 47 9 - 48 9 - 49 dnport 9 - 50 dspalm 9 - 51 dspalmcnf 9 - 53 dspalmcnt 9 - 5
Contents dspcdstatus 9 - 72 dspchancnt 9 - 75 dspchanloop 9 - 76 dspchantests 9 - 77 dspclkalms 9 - 79 dspclksrcs dspcon 9 - 81 9 - 84 dspconinfo 9 - 88 dspcons 9 - 90 dspcons-dbg 9 - 94 dspcontrollers 9 - 95 dspdiagcnf 9 - 96 dspdiagerr 9 - 98 dspdiagstat 9 - 100 dspdiagstatus dspenvalms dsperr 9 - 101 9 - 103 9 - 106 dsperrhist 9 - 108 dspilmicnt 9 - 110 dspln 9 - 111 dsplncnt 9 - 113 dsplns 9 - 115 dsplog 9 - 117 dsplogs 9 - 120 dspndalms 9 - 121 dsppnportlo
Contents offdiagstat 9 - 144 ondiagstat 9 - 145 pathtraceie 9 - 146 pathtracenode pathtraceport resetcd 9 - 147 9 - 148 9 - 150 resetsys 9 - 151 switchcc 9 - 152 tstconseg tstdelay upcon upln upport 9 - 153 9 - 155 9 - 158 9 - 159 9 - 160 INDEX Cisco MGX 8850 Routing Switch Command Reference xvi Release 2.
F I G U R E S Figure 5-1 Cisco Factory-shipped Node-Addressing Defaults Mapping into Both NSAP and DCC Address Formats Figure 5-2 Switch-Level ATM Address Figure 5-3 PNNI Logical Node Identifier Figure 5-4 Peer Group Identifier Figure 5-5 Cisco Factory-shipped Defaults for PNNI Peer Group Identifier, PNNI Summary Address, ATM Address, and PNNI Node Identifier 5 - 12 Figure 5-6 Cisco Factory-shipped Defaults for PNNI Peer Group Identifier, PNNI Summary Address, ATM Address, and PNNI Node Identifi
Figures Cisco MGX 8850 Routing Switch Command Reference xviii Release 2.
T A B L E S Table 1 MGX 8850 Switch Release 2 Related Documentation Table 2 WAN CiscoView for MGX 8850 Release 2 Related Documentation Table 3 Cisco WAN Manager Release 10 Related Documentation Table 1-1 Valid Line Numbers and Number of Bays for AXSM Card Types Table 1-2 Maximum Connections by Connection Type and Front Card Table 1-3 Maximum Connections on Back Cards and Lines Table 1-4 Mapping PNNI Port ID to AXSM Elements Table 1-5 Commands Table 2-1 Valid Line Numbers and Number of Bays
Tables Table 6-3 Maximum Connections on Back Cards and Lines Table 6-4 Mapping PNNI Port ID to AXSM Elements Table 7-1 Valid Line Numbers and Number of Bays for AXSM Card Types Table 7-2 Maximum Connections by Connection Type and Front Card Table 7-3 Maximum Connections on Back Cards and Lines Table 7-4 Mapping PNNI Port ID to AXSM Elements Table 7-5 Default Traffic Parameters for AXSM Table 7-6 Ranges for PCR, SCR, and MCR for Each Line Type Table 8-1 Valid Line Numbers and Number of Bays
About This Manual Welcome to the command line interface (CLI) documentation for the Cisco MGX™ 8850 wide area routing switch, Release 2. This chapter discusses: • Objectives • Audience • Organization • Related Documentation • Conventions • Command Changes Cisco documentation and additional literature are available in a CD-ROM package, which ships with your product. The Documentation CD-ROM, a member of the Cisco Connection Family, is updated monthly.
Organization Organization The chapters in this guide are: Chapter 1 Command Line Interface Overview Describes the how to use the command line interface CLI and includes descriptions of user-oriented commands. Chapter 2 Shelf Management Commands Describes commands that pertain primarily to switch-level configuration. Chapter 3 Equipment and Resource Provisioning Describes commands for specifying physical characteristics to the node and logical resources to the controllers.
Related Documentation Related Documentation This section lists documentation that applies to the MGX 8850 Release 2 switch and associated products in a Cisco WAN. Table 1 lists the product documentation for the MGX 8850 Release 2 switch. Table 1 MGX 8850 Switch Release 2 Related Documentation Documentation Description Cisco MGX 8850 Hardware Installation, Release 2 Provides a detailed description for installing the MGX 8850 switch in a restricted access location.
Conventions Table 3 lists the documentation for the Cisco WAN Manager (CWM) network management system. Table 3 Cisco WAN Manager Release 10 Related Documentation Documentation Description Cisco WAN Manager Installation for Solaris, Release 10 Provides procedures for installing Release 10 of the CWM network management system on Solaris systems.
Command Changes Command Changes This section contains lists of commands that are either new, changed, or removed in this release.
Command Changes • dspconload • dspdbinfo • dsperrs • dsplnbucketcnt • dsplnload • dsploginmsg • dsplpback • dsppatterns • dsppnni-dbg • dsppnni-election • dspportload • dsppswdreset or dsppasswdreset • dsprevs • dspsesn • dspsscopstats • dspsvcparm • smgrDataShow • softswitch • switchback • telnet • uplmi • users Changed Commands The commands that changed in this release by being executed on a different board, by requiring different parameters, or by having diffe
Command Changes • addslave (obsolete) • clrxbaralms • cnfifip (obsolete) • cnfxbaradmin (obsolete) • delln—removed from AXSM • dspifip (obsolete) • dspnddebug • dspshelfalm (obsolete)—pre-empted by dspenvalms • dspslotalms • dspxbaralms (removed from 2.0)—the singular command, dspxbaralm, remains • formatdisk • mkfs • offdiagcstat • shutdisk • syncdisk Cisco MGX 8850 Routing Switch Command Reference Release 2.
Command Changes Cisco MGX 8850 Routing Switch Command Reference xxviii Release 2.
C H A P T E R 1 Command Line Interface Overview This chapter describes the command line interface (CLI) for the Cisco MGX 8850 node. In addition, the chapter describes the basic user-commands for logging on to and out of the switch, changing between the CLI of different cards, and listing files on the hard drive. This chapter includes usage examples. For information on how to configure a switch and basic network services, refer to the Cisco MGX 8850 Routing Switch Software Configuration Guide, Release 2.
Chapter 1 Command Line Interface Overview Command Line Prompt Command Line Prompt The format of the CLI prompt is: name.slot number.card type.card state > where: • name is the name of the node (“Unknown” until a you assign name with the cnfname command). • slot number is the slot of the front card. • card type identifies the Processor Switching Module 45 (PXM45) or a service module type, such as the AXSM. • card state is “i” for initialized, “a” for active, or “s” for standby.
Chapter 1 Command Line Interface Overview Contents of a Command Description Notation The notation for command and argument parameters follows: • Commands and their parameters are separated by a space. • Variables appear in italics. • Keywords and commands appear in bold. • Required arguments appear within left and right arrowheads (“< >”). • Optional parameters appear within square brackets (“[ ]”). • A vertical bar ( | ) represents the logical OR function.
Chapter 1 Command Line Interface Overview Identifying the AXSM Models • The syntax of the command. This manual presents parameters in a column to make them easier to read, particularly when displayed through an electronic medium. • A syntax description lists all the parameters. Each item in the list includes a brief definition, functional details when appropriate, the range of values for the parameter, and an applicable default value.
Chapter 1 Command Line Interface Overview Connection Capacities of the AXSM Connection Capacities of the AXSM The SVC and SPVC connection capacities for the front card, back card, and physical lines appear in Table 1-2 and Table 1-3. The capacity of a single AXSM card is greater than that of the node itself.
Chapter 1 Command Line Interface Overview Identifying Physical and Logical Elements • Line • Logical port • Port group • Resource partition Not all of these elements correspond to elements you specify on the PXM45. Subsequent paragraphs describe only the common elements that are visible on the CLI of the PXM and the service module. The preceding elements are further defined in the Cisco MGX 8850 Routing Switch Software Configuration Guide, Release 2.0.
Chapter 1 Command Line Interface Overview List of Commands As Table 1-4 shows, a port to PNNI is a line on the AXSM, and a subport to PNNI is a logical interface (or logical port) on an AXSM. An example of a PNNI physical port identifier is 1:2.1:1. This portid corresponds to an AXSM, with the following particulars: • Slot 1 • Bay 2 • Line 1 • Logical interface 1 (or logical port 1) List of Commands The commands in this chapter appear in Table 1-5. It shows the name and function of each command.
Chapter 1 Command Line Interface Overview ? ? Help Use help to view all commands you can execute on the current card and at the current privilege level. The display does not show commands with a privilege level that is higher than that of the current user. If you follow the ? with part of a command name, the output shows all commands that contain that string. If you follow the ? with the complete name of one command, the output simply states whether that command is available.
Chapter 1 Command Line Interface Overview bye bye Bye Exit the current CLI session. Cards on Which This Command Runs PXM45, AXSM Syntax bye Related Commands logout, exit Attributes Log: log State: active, standby, init Privilege: ANYUSER Exit the current CLI shell. MGX8850.8.PXM.a > bye (session ended) Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 1 Command Line Interface Overview cc cc Change Card Use cc to change from the current CLI to the CLI of another card. Follow cc with a slot number. Cards on Which This Command Runs PXM45, AXSM Syntax cc Syntax Description slot number The number of the destination card slot. Related Commands None Attributes Log: log State: active, standby, init Privilege: ANYUSER Change from the command line of the AXSM in slot 12 to the command line of the PXM45 in slot 8. MGX8850.12.
Chapter 1 Command Line Interface Overview cd cd Change Directory Use cd to change to another directory on the PXM45 hard disk. Cards on Which This Command Runs PXM45 Syntax cd Syntax Description directory_name Name of the destination directory. Related Commands ls, pwd, rename, rm/rmdir, copy Attributes Log: log State: active, standby, init Privilege: ANYUSE Change directory to FW, then check the result by executing pwd. MGX8850.7.PXM.a > cd FW MGX8850.7.PXM.
Chapter 1 Command Line Interface Overview clrscrn clrscrn Clear Screen The clrscrn command clears the control terminal screen. After this command runs, only the current command line prompt appears on the screen. Cards on Which This Command Runs PXM45, AXSM Syntax clrscrn Related Commands None Attributes Log: no log State: active, standby, init Privilege: ANYUSER Example Clear the screen. MGX8850.11.AXSM.a > clrscrn MGX8850.11.AXSM.
Chapter 1 Command Line Interface Overview cmdhistory cmdhistory Display Command History The cmdhistory command lists the last 10 commands executed on the current card. To execute a previous command with parameters, type an exclamation mark and the associated number and no spaces, then press Enter or Return. Cards on Which This Command Runs PXM45, AXSM Syntax cmdhistory Syntax Description This command takes no parameters.
Chapter 1 Command Line Interface Overview cmdhistory Reserved Card: PXM45 State: Active Serial Number: SAK0401006C Prim SW Rev: 2.0(1)D Sec SW Rev: 2.0(1)D Cur SW Rev: 2.0(1)D Boot FW Rev: 2.
Chapter 1 Command Line Interface Overview copy copy Copy Use copy to copy a file to a new file on the disk on the PXM45-HD. This command is the same as the cp command. Cards on Which This Command Runs PXM45 Syntax copy Syntax Description source file name The name of the file you intend to copy. destination file name The name of the new file resulting from copy or the name of the existing file that is over-written as a result of copy.
Chapter 1 Command Line Interface Overview cp cp Copy Use cp to copy a file to a new file on the disk on the PXM45-HD. This command is the same as the copy command. Cards on Which This Command Runs PXM45 Syntax cp Syntax Description source file name The name of the file you intend to copy. destination file name The name of the new file resulting from cp or the name of the existing file that is over-written as a result of cp.
Chapter 1 Command Line Interface Overview del del Delete Use del to remove a file or directory from the PXM45 hard drive. Cards on Which This Command Runs PXM45 Syntax del Syntax Description path_name Name of an existing file or directory. Related Commands None Attributes Log: log State: active, standby, init Privilege: GROUP1 Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 1 Command Line Interface Overview exit exit Exit from User Session Use exit to exit the current user session and log out. To start another session, you must log in by using telnet (for example). Cards on Which This Command Runs PXM45, AXSM Syntax exit Related Commands bye, logout Attributes Log: log State: active, standby, init Privilege: ANYUSER Example Exit from the current user session. MGX8850.8.PXM.
Chapter 1 Command Line Interface Overview help help Help Use help to view commands associated with the current card. The help command is case-sensitive. Its behavior with or without parameters is: • With no parameter string, it lists all commands on the card. • With part of a command name, it lists all commands that contain that string. • With the entire command name, the output shows only whether the command is available.
Chapter 1 Command Line Interface Overview history history Command History Use history to display the last 10 commands executed on the current card. To repeat a command with its parameters, type an exclamation mark followed by the associated number and no spaces. Cards on Which This Command Runs PXM45, AXSM Syntax history Syntax Description This command takes no parameters.
Chapter 1 Command Line Interface Overview logout logout Log Out The logout command lets you end the current user session. Cards on Which This Command Runs PXM45, AXSM Syntax logout Syntax Description This command takes no parameters. Related Commands bye, exit Attributes Log: log State: active, standby, init Privilege: ANYUSER Example Log out of the current CLI shell. MGX8850.8.PXM.a > logout (session ended) Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 1 Command Line Interface Overview ls ls List Use ls to list the contents of the working directory. The filename is listed for each entry. The total space of the file system and free space is also summarized at the end of the output. Cards on Which This Command Runs PXM45 Syntax ls [dir] Syntax Description You can specify an optional directory or path to list.
Chapter 1 Command Line Interface Overview ls .. AXSM In the file system : total space : 819200 K bytes free space : 660582 K bytes MGX8850.7.PXM.a > ls AXSM . .. AXSM_SCT.CARD.2 AXSM_SCT.CARD.3 AXSM_SCT.PORT.2 AXSM_SCT.PORT.3 In the file system : total space : 819200 K bytes free space : 660582 K bytes MGX8850.7.PXM.a > Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 1 Command Line Interface Overview ping ping Ping Use ping to determine if a host is operational. The command causes the switch to send an ICMP packet to a destination address. Cards on Which This Command Runs PXM45 Syntax ping [] Syntax Description IP_Addr IP address of the destination host in dotted decimal format. Num_Packets Number of packets. The range is 0–65535.
Chapter 1 Command Line Interface Overview pwd pwd Present Working Directory Use pwd to identify the current working directory on the PXM45. Cards on Which This Command Runs PXM45 Syntax pwd Syntax Description This command takes no parameters. Related Commands cd, rmdir, rm, ls, copy Attributes Log: no log State: active, standby, init Privilege: ANYUSER Example Identify the present working directory. MGX8850.7.PXM.a > pwd C: MGX8850.7.PXM.
Chapter 1 Command Line Interface Overview who who Who Use who to see details about the user currently logged into a card. The information consists of the: • Type of port where you logged into the card • Slot number of the current card • Idle time in hours, minutes, and seconds • Current username • IP address of the device that accessed the card (not the IP address of the card or node) Cards on Which This Command Runs PXM45, AXSM Syntax who Syntax Description This command takes no parameters.
Chapter 1 Command Line Interface Overview whoami whoami Who Am I View the current login ID, access level, and associated terminal port of the current user. Cards on Which This Command Runs PXM45, AXSM Syntax whoami Syntax Description This command takes no parameters. Related Commands adduser, deluser, who Attributes Log: no log State: active, standby Privilege: ANYUSER Example Display information about the user of the current terminal session. MGX8850.7.PXM.
Chapter 1 Command Line Interface Overview whoami Cisco MGX 8850 Routing Switch Command Reference 1-28 Release 2.
C H A P T E R 2 Shelf Management Commands This chapter describes the shelf management commands and some commands that belong to other logical entities running on the switch—PNNI, for example. These commands allow you to add, delete, configure, display status for, and create statistics for node-level features. The functional areas under shelf management are: • Node-level parameters of nodename, date, time, time zone, and so on. • Firmware downloading.
Chapter 2 Shelf Management Commands Command Entry Command Entry When you enter a command with the current version of the product, you must type all intended arguments before you press the Return key or Enter key. If you press the Return key or Enter key with incorrect parameters or no parameters (if the command requires parameters), a message displays the syntax and parameter ranges. The returned message may also suggest what the problem is. For example, the message may warn of too few parameters.
Chapter 2 Shelf Management Commands Identifying Physical and Logical Elements Table 2-2 Maximum Connections by Connection Type and Front Card Front Card SVC SPVC AXSM-1-2488 128 K 64 K AXSM-4-622 128 K 64 K AXSM-16-155 128 K 64 K AXSM-16-T3E3 128 K 64 K Table 2-3 Maximum Connections on Back Cards and Lines Card Type Back Card Maximum Physical Line Maximum OC-48c 128 K 64 K OC-12c 64 K 32 K OC-3c 64 K 32 K T3 64 K 64 K E3 64 K 64 K Identifying Physical and Logical Eleme
Chapter 2 Shelf Management Commands Identifying Physical and Logical Elements Not all of these elements correspond to elements you specify on the PXM45. Subsequent paragraphs describe only the common elements that are visible on the CLI of the PXM and the service module. The preceding elements are further defined in the Cisco MGX 8850 Routing Switch Software Configuration Guide, Release 2.0. For a UNI or NNI, one logical interface (or logical port) exists per physical line.
Chapter 2 Shelf Management Commands Identifying Physical and Logical Elements • Bay 2 • Line 1 • Logical interface 1 (or logical port 1) Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 2 Shelf Management Commands abortrev abortrev Abort Revision—return to the previous firmware version. The abortrev command causes the target card to use the previous operational firmware image. It provides a way out of a graceful upgrade that has shown signs of unacceptable performance. (For example, a new feature may not perform as expected.) The commands for changing firmware versions commands run on the PXM45, but they can target either a service module or the PXM45 itself.
Chapter 2 Shelf Management Commands abortrev Note Of special note in Table 2-6, runrev causes the standby card to become the active card. The reversed location of the “Active” and “Standby” columns shows the changed states. Table 2-6 Redundant Pair Upgrade From 2.x to 2.y Firmware status Before upgrade After loadrev After runrev After commitrev Active Standby Active Standby Standby Active Standby Active Primary 2.x 2.x 2.x 2.x 2.y 2.y 2.y 2.y Secondary 2.x 2.x 2.y 2.y 2.x 2.
Chapter 2 Shelf Management Commands abortrev Example Abort the graceful upgrade to firmware file pxm45_002.000.000.000_mgx.fw (so 2.0(0) is the version). The system prompts you to confirm that you want the command to execute. pinnacle.8.PXM.a > abortrev 8 2.0(0) Cisco MGX 8850 Routing Switch Command Reference 2-8 Release 2.
Chapter 2 Shelf Management Commands addtrapmgr addtrapmgr Add Trap Manager Set up an SNMP manager that you intend to receive SNMP traps. The maximum number of trap managers on a node is 12. The trap managers you add through addtrapmgr and the trap managers that are added by the SNMP manager (Cisco WAN Manager or other application) do not age and are not deleted. To delete a trap manager, use either the deltrapmgr command or an SNMP Set on the intended object.
Chapter 2 Shelf Management Commands adduser adduser Add User Adds a user account with associated name, privilege level, and password. User names must begin with an alpha character. The maximum number of users is 100. The privilege level of the user you are adding must be lower than the user-level at which you execute adduser. For example, to create a user with a privilege 1, you must log in as a superuser or above. You can execute commands that require either the same or lower level privilege.
Chapter 2 Shelf Management Commands adduser Related Commands cnfuser, dspusers, deluser, cnfpasswd, whoami Attributes Log: log State: active Privilege: GROUP1 Example Add a user named “fin” with privilege level GROUP1. To add a GROUP1 user, the current user-prefilter level must be SUPER_GP or higher. To determine the current username, execute the whoami command. To see all current privilege levels, execute dspusers.
Chapter 2 Shelf Management Commands bootChange bootChange Boot Change Sets the boot IP address and gateway address of the PXM45 card. The boot IP address is used only when the PXM45 card boots up. In the current release, the only parameters you should enter are “inet on ethernet (e)” and “gateway inet (g).” The bootChange command presents one parameter at a time. Therefore, press the Return (or Enter) key at each prompt except for these two.
Chapter 2 Shelf Management Commands bootChange Example Specify an IP address of 170.11.52.61 for the Ethernet port and 170.11.52.2 for the gateway IP address. The display shows all the fields that the node presents. For all fields except the ethernet and gateway prompts, press Return or Enter. pinnacle.7.PXM.a > bootChange '.' = clear field; '-' = go to previous field; ^D = quit boot device : lnPci processor number : 0 host name : winter file name : /users/joloughl/pxm45_002.000.014-A1.
Chapter 2 Shelf Management Commands burnboot burnboot Burn Boot Software Burns the specified revision of boot software on a standby AXSM card by specifying the slot number of the card and the revision number of boot software to burn. Cards on Which This Command Runs PXM45 Syntax dspcd Syntax Description slot The slot number of the standby AXSM card on which to burn the software. revision The revision number of the software to burn.
Chapter 2 Shelf Management Commands clidbxlevel clidbxlevel Command Line Interface Level—modify the contents of the CLI help output. The clidbxlevel command lets you display the attributes for a command. You must execute clidbxlevel on each card where you want to change the level of displayed information. For example, if you execute clidbxlevel on an AXSM in slot 2 and want to see the same level of information in slot 8, you must execute clidbxlevel on the CLI in slot 8 and make the appropriate change.
Chapter 2 Shelf Management Commands clrallcnf clrallcnf Clear All Configurations Deletes the configuration of all the cards in the switch. After clrallcnf, you need to reconfigure the switch. (See setrev.) The clrallcnf command clears all configuration information except for the boot IP address (see bootchange) and the time of day. Caution Be absolutely sure you need to execute clrallcnf because it clears all configuration files on the PXM45.
Chapter 2 Shelf Management Commands clrcnf clrcnf Clear Configurations—clears a significant amount of the node configuration Clears the configuration then reboots the switch. This command restarts the switch with a new configuration but keeps the basic configuration for the switch—IP connectivity, for example. The clrcnf command is useful if you frequently reset the switch but do not want to reconfigure basic settings.
Chapter 2 Shelf Management Commands clrcnf Syntax Description This command takes no parameters. Related Commands None Attributes Log: no log State: active Privilege: SERVICE_GP Example Clear all the configuration elements for all the cards in the node. The system prompts for confirmation. node1.7.PXM.a > clrcnf All SM's disk config will be deleted, and the shelf will be reset. Do you want to proceed (Yes/No)? Cisco MGX 8850 Routing Switch Command Reference 2-18 Release 2.
Chapter 2 Shelf Management Commands cnfclkparms cnfclkparms Configure Clock Parameters—configure line characteristics for an E1 BITS clock The cnfclkparms command lets you configure the signal type and cable type for E1 BITS sources. The configuration applies to both (upper and lower) sources. Note In the current release, you can specify only the cable type.
Chapter 2 Shelf Management Commands cnfclksrc cnfclksrc Configure Clock Source—configure primary and secondary clocks and optional BITS clock Configures a primary or secondary clock source for the node. A clock source can be: • An external device that connects to the PXM-UI S3 card • A line on an active AXSM Clock Operation When the switch first powers up, the internal oscillator on the PXM45 provides the clock to the node.
Chapter 2 Shelf Management Commands cnfclksrc Syntax The syntax for cnfclksrc depends on the clock source. For the external BITS clock: cnfclksrc portid has the format [shelf.]slot.port –bits e1 | t1 [–revertive ] For AXSM-sourced clock (note the positions of the periods and colons): cnfclksrc portid has the format [shelf.]slot[:subslot].
Chapter 2 Shelf Management Commands cnfclksrc • AXSM-sourced clocks require that the lines, ports, and resource partitioning have been configured. • A switch can have one primary source and one secondary source. • For each execution of cnfclksrc, you can specify only one clock source (either but not both primary and secondary). Therefore, you must repeat cnfclksrc to specify the other clock source.
Chapter 2 Shelf Management Commands cnfclksrc Attributes Log: log State: active Privilege: GROUP1 Examples Configure the E1 clock at the upper connector of the PXM-UI S3 as the primary source. Configure subport (logical port) 10 on the line of the AXSM-1-2488 in slot 3 as the secondary. For the secondary source on the AXSM, note the locations of the periods and colons. Upon successful execution, the system displays a confirmation message. pinnacle.7.PXM.a> cnfclksrc primary 7.
Chapter 2 Shelf Management Commands cnfdate cnfdate Configure Date Configure the system date. The system does not return a message unless an error occurred. To see the date, execute dspdate. Cards on Which This Command Runs PXM45 Syntax cnfdate Syntax Description mm/dd/yyyy • mm is the month in the range 01–12. • dd is the day in the range 01–31. • yyyy is the year in the range 0000–9999.
Chapter 2 Shelf Management Commands cnfname cnfname Configure Name—specifies a name for the node. The case-sensitive node name must begin with a letter. It can include: • Up to 32 letters or numbers • Two special characters (“_” and “-”) • No spaces After you enter the name, the system prompts you for confirmation. To see the configured name, execute dspcds (or many of the other node-level display commands): the node name is the first item in the display.
Chapter 2 Shelf Management Commands cnfndparms cnfndparms Configure Node Parameters—configure diverse parameters for the node. The cnfndparms command lets you specify numerical values or enables for a diverse set of node-level parameters. This command has parameters that consist of an option number and a value or a yes/no option. The configuration resides in non-volatile RAM and thus survives a system reset or power cycle.
Chapter 2 Shelf Management Commands cnfndparms An AC power supply tray holds six power supply units (PSUs). (Refer to the Cisco MGX 8850 Hardware Installation Guide for details.) A supply belongs to one of two groups: A1–A3 or B1–B3. An 8-bit hexadecimal number identifies an individual supply. The value for Option 6 can be the sum of any combination of hexadecimal numbers.
Chapter 2 Shelf Management Commands cnfndparms Syntax Description option number A number that selects the option. The current parameters begin with number 2: • Option 1 is the number of seconds to count the resets of the shelf management cards. The range is 0–65355 (a 16-bit decimal number). The default is 3600 seconds (1 hour). A 0 means an infinite time period. The impact of an infinite time period is that only a specified count of resets can stop the resets.
Chapter 2 Shelf Management Commands cnfndparms Related Commands dspndparms, dspndalms, dspenvalms Attributes Log: no log State: active Privilege: SUPER_GP Example Change the time period for counting card resets to 30 minutes. First enter the command with no parameters. The system displays the options and prompts you to enter an option number (rather than display the help information for this command). Enter a 2, then the system displays the current value for this option. MGX8850.7.PXM.
Chapter 2 Shelf Management Commands cnfpasswd cnfpasswd Configure Password Change your own password. After you enter the cnfpasswd command without parameters, the system prompts you to enter the new password then prompts you to re-enter it. Note The default password is for a user-account is newuser. Cards on Which This Command Runs PXM45 Syntax cnfpasswd Syntax Description password Your new password.
Chapter 2 Shelf Management Commands cnfserialif cnfserialif Configure Serial Interface The cnfserialif command lets you change the data rate on a serial interface on the PXM45-UI-S3 back card. The two types of serial ports are the console port and the maintenance port. These ports provide user-access for controlling the switch. The default speed n a serial interface is 9600 bits per second, but higher speed terminals are frequently available.
Chapter 2 Shelf Management Commands cnfsnmp cnfsnmp Configure SNMP Strings Configure the SNMP strings. The three strings are community, contact, and system location. You can configure only one of these strings with a single execution of cnfsnmp. Cards on Which This Command Executes PXM45 Syntax cnfsnmp -community [string ] -contact [string] -location [string] Syntax Description -community Keyword that establishes the community access string to permit access to SNMPv1 protocol.
Chapter 2 Shelf Management Commands cnfsnmp Example Configure various community strings. node19.8.PXM.a node19.8.PXM.a node19.8.PXM.a node19.8.PXM.a node19.8.PXM.a node19.8.PXM.a node19.8.PXM.
Chapter 2 Shelf Management Commands cnftime cnftime Configure Time Configures the time for the node. To see the time after you execute cnftime, use dspdate. The system displays the time in 24-hour format. Note Configure a time zone through cnftmzn and optional GMT offset through cnftmzngmt before you configure the time through cnftime.
Chapter 2 Shelf Management Commands cnftmzn cnftmzn Configure Time Zone Configures the time zone in the Western Hemisphere for the switch. To configure a time zone outside the four standard time zones of the Western Hemisphere, enter the GMT argument, then execute cnftmzngmt to specify an offset in hours from Greenwich Mean Time. The system returns no messages unless an error occurs. To see the time zone, execute dspdate.
Chapter 2 Shelf Management Commands cnftmzngmt cnftmzngmt Configure Time Zone Relative to GMT Configures the time zone for the node relative to GMT. Typically, this command applies to nodes outside the four standard time zones of the Western Hemisphere. Use cnftmzngmt according to the following sequence: • First use cnftmzn to specify the time zone as GMT. • Then specify an offset in hours relative to Greenwich Mean Time by executing cnftmzngmt.
Chapter 2 Shelf Management Commands cnfuser cnfuser Configure User Configure a new password or privilege level for a user. If the user does not already exist, executing cnfuser with a new user-name creates that user. If you do not specify a user-name (userID) but include one or more of the other parameters, the command applies to the current user.
Chapter 2 Shelf Management Commands cnfuser Example Change the password and privilege lever of user “rocky.” New password is “nevermind,” and the privilege level is GROUP1. Note that the you must be logged in at a higher than GROUP1 privilege level to specify GROUP1 for “rocky.” If the “-u” and userID (rocky) were not entered, this command would change the password and privilege of the current user. raviraj.7.PXM.
Chapter 2 Shelf Management Commands commitrev commitrev Commit Revision Completes a graceful upgrade by committing to the operating firmware image as the primary version. The commitrev command is the necessary conclusion to a graceful upgrade. See the loadrev description for more details about graceful firmware changes. The impact of commitrev is: • It signifies that the primary firmware image activated through the runrev command is accepted.
Chapter 2 Shelf Management Commands commitrev Note Of special note in Table 2-8, runrev causes the standby card to become the active card and run the new version of firmware. The reversed location of the “Active” and “Standby” columns shows these changed states. Table 2-8 Redundant Pair Upgrade From 2.x to 2.y Firmware status Before upgrade After loadrev After runrev After commitrev Active Standby Active Standby Standby Active Standby Active Primary 2.x 2.x 2.x 2.x 2.y 2.y 2.y 2.
Chapter 2 Shelf Management Commands delclksrc delclksrc Delete Clock Source Deletes a user-specified primary or secondary clock source. Changing a clock source or changing the priority of the source (primary or secondary) are the most frequent uses of delclksrc. See the description of cnfclksrc for these common uses of delclksrc.
Chapter 2 Shelf Management Commands deltrapmgr deltrapmgr Delete Trap Manager Delete a trap manager. The deltrapmgr command requires an IP address for deletion. To see existing trap managers, use dsptrapmgr. For more information about trap managers, see the Cisco MGX 8850 Routing Switch Software Configuration Guide or the addtrapmgr description in this book. Cards on Which This Command Runs PXM45 Syntax deltrapmgr Syntax Description ip_addr IP address in dotted decimal format: nnn.nnn.
Chapter 2 Shelf Management Commands deluser deluser Delete User Removes a user from the list of users on an MGX 8850 node. The system does not allow you to delete a user with a privilege level higher than the level at which you execute the command. For example, if the current user privilege is 2 (GROUP2), you cannot delete a user at level 1 (GROUP1). See the adduser description for the user-privilege hierarchy. No screen output appears unless an error occurs.
Chapter 2 Shelf Management Commands downloadflash downloadflash Download Flash—load the first boot code found by the PXM45 hard drive into flash memory. The downloadflash command does not execute at the runtime prompt. It operates in bootmode only. A downloadflash session concludes the sequence of tasks for performing a PXM45 boot code load. Prior to executing this command, you must access the boot code and transfer the file to the PXM45 hard drive by using a “put” command).
Chapter 2 Shelf Management Commands dspbkpl dspbkpl Display Backplane—display details about the backplane. The dspbkpl command shows the following types of information about the backplane: • Card type (a hexadecimal number) • Chassis-level part number and revision number • PCB 73-level part number • Chassis serial number • CLEI code • PCB 28-level part number Cards on Which This Command Runs PXM45 Syntax dspbkpl Syntax Description This command takes no parameters.
Chapter 2 Shelf Management Commands dspcd dspcd Display Card Display the following information about a card: Note • Hardware serial number. • Firmware revision level. (See the loadrev description for an explanation of how to interpret the revision field.) • Status, possibly including the reason for the last reset (FunctionModuleResetReason) and state of the integrated alarm (cardIntegratedAlarm). • For a service module only: a count of configured lines, ports, and connections.
Chapter 2 Shelf Management Commands dspcd Attributes Log: no log State: active, standby, init Privilege: ANYUSER Examples Display card details for the current PXM45. Note The “A1” at the end of the primary software revision and boot firmware revision numbers shows that these versions are pre-release. Refer to the setrev description for details. MGX8850.7.PXM.a > dspcd MGX8850 System Rev: 02.
Chapter 2 Shelf Management Commands dspcd 800-level Rev: M6 07 --- Orderable Part#: 800-5776-3 800-4819-1 --- PCA Part#: 73-4504-2 73-3845-1 --- Reset Reason:On Power up Card SCT Id: 2 Type to continue, Q to stop: #Lines #Ports #Partitions #SPVC #SPVP #SVC ------ ------ ----------- ------- ------- ------2 2 2 10 0 10 Port Group[1]: #Chans supported:32512 Port Group[2]: #Chans supported:32512 Port Group[3]: #Chans supported:32512 Port Group[4]: #Chans supported:32512 Lines:1.1 1.2 1.
Chapter 2 Shelf Management Commands dspcds dspcds Display Cards Displays high-level information for all the cards in the node. For more detailed information about a card, execute dspcd on the CLI of that card.
Chapter 2 Shelf Management Commands dspcds Example Display information for all cards in the MGX 8850 switch. Unknown.7.PXM.a > dspcds Unknown System Rev: 02.00 Backplane Serial No: SAA03270618 Bp HW Rev: B0 Card Slot --- Front/Back Card State ---------- Card Type -------- Alarm Status -------- Aug.
Chapter 2 Shelf Management Commands dspclksrcs dspclksrcs Display Clock Sources Displays the configuration and status of the clock sources on the node. (For details about network synchronization, see the description of cnfclksrc.) The dspclksrcs output consists of: Note • For the primary clock: the type, source, status, and reason (for status change) of the clock. • For the secondary clock: the type, source, status, and reason (for status change) of the clock.
Chapter 2 Shelf Management Commands dspclksrcs Table 2-9 Reasons for Change of Clock State Reason Meaning okay The clock source is okay. unknown reason The clock manager has no information for Reason. no clock signal Loss of signal (LOS) on the clock source. frequency too high The frequency has drifted too high. frequency too low The frequency has drifted too low excessive jitter Jitter has exceeded tolerance for this stratum.
Chapter 2 Shelf Management Commands dspclksrcs source as unlockable and proceeds to use the next clock in the hierarchy (of primary, secondary, internal oscillator) as the current clock source. The exception to this final validation scenario occurs if the current clock source is the internal oscillator in either the free running mode or the hold-over mode: in this case, the software omits this final validation attempt because no other clocks sources within a clock hierarchy are available.
Chapter 2 Shelf Management Commands dspclksrcs Display information on the clock sources. The display shows that nothing has been configured, so the internal oscillator generates the primary and secondary clocks. The primary and secondary clock reason is “okay” in each case. Unknown.7.PXM.a > dspclksrcs Primary clock type: null Primary clock source: 0.0 Primary clock status: not configured Primary clock reason: okay Secondary clock type: null Secondary clock source: 0.
Chapter 2 Shelf Management Commands dspdisk dspdisk Display Disk Display utilization for all partitions on the hard disk. The display shows the allocated space and the free space. A likely application of dspdisk is a routine check of disk utilization by running a script that includes this command. Note The capacity of the disk is very large relative to typical usage and therefore does not present potential restrictions.
Chapter 2 Shelf Management Commands dspipconntask dspipconntask Display IP Connectivity Task Display the current state of the IP connectivity task. As a part of a troubleshooting regimen, the dspipconntask command can help you isolate a problem related to IP connectivity.
Chapter 2 Shelf Management Commands dspipif dspipif Display IP Interface Configuration Display configuration and other information for either one or all IP interfaces on the current PXM45. If you request all interfaces by entering dspipif with no parameters, the display shows information for all interface types. The displayed information comes from the current state of the interface and the configuration specified through ipifconfig.
Chapter 2 Shelf Management Commands dspipif pinnacle.7.PXM.a > dspipif Unknown System Rev: 00.00 Jan. 04, 2000 12:16:22 GMT MGX8850 Shelf Alarm: NONE IP INTERFACE CONFIGURATION -------------------------------------------------------------------atm (unit number 0): Not Configured lnPci (unit number 0): Flags: (0x63) UP BROADCAST ARP RUNNING Internet address: 172.29.52.88 Broadcast address: 172.29.255.
Chapter 2 Shelf Management Commands dspipifcache dspipifcache Display IP Interface Cache The command shows the mapping of SVCs that connect the PXM45s to workstations. Cards on Which This Command Executes PXM45 Syntax dspipifcache [interface] Syntax Description interface (Optional) The interface type. If you do not specify an interface type, the display contains cache contents for all interface types. The types are: • lnPci0 for Ethernet (the default on power-up) • atm0 for the ATM.
Chapter 2 Shelf Management Commands dspndparms dspndparms Display Node Parameters—display the current node-level parameters specified by cnfndparms. The node parameters in this case are a general set of diverse parameters. Refer to cnfndparms for a description of the parameters and possible values. Cards on Which This Command Runs PXM45 Syntax dspndparms Syntax Description This command takes no parameters.
Chapter 2 Shelf Management Commands dsppvcif dsppvcif Display PVC Interface Display details about the PVC interface for IP connectivity. The output shows the: • Interface type on which the PVC connections exists.
Chapter 2 Shelf Management Commands dsppvcif Example Display the current ATM interface state. orioses5.1.PXM.a > dsppvcif orioses5 System Rev: 01.00 Aug. 10, 2000 18:36:01 GMT SES-CNTL Node Alarm: NONE IP CONNECTIVITY PVC CACHE -------------------------------------------------------------------atm (unit number 0): Feeder VPI.VCI: 3.
Chapter 2 Shelf Management Commands dsprevs dsprevs Display Revisions—show all firmware versions by physical and logical slot numbers. The dsprevs command shows the current versions of firmware for all slots. The optional parameter lets you see the status of a firmware revision change that is in progress. Slight variations exist in the display with and without the optional status parameter: • Without a parameter, dsprevs shows the versions of current runtime firmware and boot firmware.
Chapter 2 Shelf Management Commands dsprevs Examples Display all firmware versions and include status of any firmware upgrades. Note that the display shows the logical slot number 7 for physical slot 8. The display shows that no firmware upgrades are in progress. If an upgrade were in progress on slots 7 and 8 and the present command were loadrev, the Rev Change Status column would show “Loadrev in prog-U.” SanJose.7.PXM.a > dsprevs -s SanJose System Rev: 02.00 Dec.
Chapter 2 Shelf Management Commands dsprevs 24 25 26 27 28 29 30 31 32 24 25 26 27 28 29 30 31 32 ------------------- ------------------- ------------------- Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 2 Shelf Management Commands dspserialif dspserialif Display Serial Interface The dspserialif command displays the data rate on one of the serial interfaces on the PXM45-UI-S3 back card. See cnfserialif for an explanation. (See the Cisco MGX 8850 Routing Switch Software Configuration Guide for an explanation of the application of these physical ports.
Chapter 2 Shelf Management Commands dspsnmp dspsnmp Display SNMP Strings The dspsnmp command displays the SNMP strings. Cards on Which This Card Executes PXM45 Syntax dspsnmp Syntax Description This command takes no parameters. Attributes Log: no log State: active Privilege: SUPER_GP Example Display the current SNMP strings. This example shows that the only specified string is the community “ro.” node19.8.PXM.a > dspsnmp node19MGX8850 Community: System Location: System Contact System Rev: 02.
Chapter 2 Shelf Management Commands dsptrapmgr dsptrapmgr Display Trap Manager Display details about all existing trap managers. The maximum number of trap managers on a switch is 12. The dsptrapmgr output shows: • IP address of each trap manager • Port number on the connected work station • Row status • Read trap flag stats • Next trap sequence number Of these elements, the IP address and port number result from addtrapmgr.
Chapter 2 Shelf Management Commands dspusers dspusers Display Users Displays all current users and their access levels if the keyword -u is not given. If the key word -u is specified, it displays the user ID and access level of that user only. Cards on Which This Command Runs PXM45 Syntax dspusers [-u ] Syntax Description -u Keyword that specifies the user (userId) to display.
Chapter 2 Shelf Management Commands dspversion dspversion Display Version—display firmware versions on an individual card. Show details for the versions of boot and runtime firmware residing on a card. Typically, you would use dspversion in conjunction with the commands for changing a card’s firmware version. (See Related Commands section.) For example, you can use dspversion to see if a particular firmware version is currently running.
Chapter 2 Shelf Management Commands dspversion Pre-release, developmental versions have one or two alphanumeric characters at the end of the version number, and these versions may appear in various contexts. For example, the help display for setrev gives examples of revision, but only the first two in the following list could be in released product. These two bullets show major release 2, minor release 1, and the minimal maintenance number of 1.
Chapter 2 Shelf Management Commands ipifconfig ipifconfig IP Interface Configuration Configure an interface to provide IP connectivity for user-control of the switch. Typically, the Cisco WAN Manager application running on a local or remote work station uses this connection to control the switch. (Note that ipifconfig and related commands have no bearing on the Console Port for an ASCII terminal that is co-located with the node.
Chapter 2 Shelf Management Commands ipifconfig Syntax ipifconfig [ip_address] [netmask ] [broadcast ] [up | down ] [arp | noarp] [svc | nosvc] [pvc | nopvc] [default | nodefault] [clrstats] Syntax Description interface A name that identifies the type of interface. The type of interface affects the applicability of other ipifconfig parameters.
Chapter 2 Shelf Management Commands ipifconfig pvc | nopvc (Optional) Specify whether PVC support is enabled. The default for this parameter is enabled (pvc). The application of PVC support is for a device in the network management path that provides IP connectivity but does not support SVCs. With PVC support enabled, you subsequently set up a PVC to that device by executing pvcifconfig. If PVC support is not enabled, pvcifconfig fails.
Chapter 2 Shelf Management Commands loadrev loadrev Load Revision Downloads a firmware image from the FW directory on the disk to flash memory on the targeted card. Executing is the first step in performing a graceful firmware upgrade. A graceful revision change preserves the configuration of the card and minimizes any data loss that could result from the brief disruption in service. Although loadrev runs on a PXM45, the target can be either a service or the PXM45 itself.
Chapter 2 Shelf Management Commands loadrev Table 2-11 Redundant Pair Upgrade From 2.x to 2.y Firmware status Before upgrade After loadrev After runrev After commitrev Active Standby Active Standby Standby Active Standby Active Primary 2.x 2.x 2.x 2.x 2.y 2.y 2.y 2.y Secondary 2.x 2.x 2.y 2.y 2.x 2.x 2.y 2.y Current 2.x 2.x 2.x 2.y 2.y 2.y 2.y 2.y abortrev resets abortrev resets only standby card. both cards.
Chapter 2 Shelf Management Commands loadrev For example, the significance of 2.0(14.8)P1 is shown below: major-release minor-release (maintenance.patch) phase 2. 1. (6.0) P1 Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 2 Shelf Management Commands loadrev Pre-release, developmental versions have one or two alphanumeric characters at the end of the version number, and these versions may appear in various contexts. For example, the help display for setrev gives examples of revision, but only the first two in the following list could be in released product. These two bullets show major release 2, minor release 1, and the minimal maintenance number of 1.
Chapter 2 Shelf Management Commands pvcifconfig pvcifconfig PVC Interface Configuration Modifies an existing PVC to support IP connectivity to a feeder such as a BPX switch or an MGX Release 1 switch. Cards on Which This Command Runs PXM45 Syntax pvcifconfig [ atmarp | noatmarp ] [ llcencap | vcmux ] [ default | nodefault] [ reset ] [ delete ] [ up ] [ clrstats ] Syntax Description interface An alphanumeric string that identifies the interface type.
Chapter 2 Shelf Management Commands pvcifconfig reset (Optional) Resets the PVC. delete (Optional) Delete the specified AESA configuration. clrstats (Optional) Clear all SVC statistics on this interface. up (Optional) Put the PVC in the UP state and try to bind the associated lcns. default | nodefault (Optional) Specifies whether this PVC is the default route on the interface. clrstats (Optional) Clear any statistics for this PVC (dropped packets, for example).
Chapter 2 Shelf Management Commands resetsys resetsys Reset System Reset the entire switch. Cards on Which This Command Runs PXM45 Syntax resetsys Syntax Description This command takes no parameters but displays a warning and prompts you to continue the execution. Related Commands resetcd Attributes Log: no log State: active, init Privilege: SUPER_GP Example Reset the system. When prompted to confirm this action, say no. pinnacle.7.PXM.
Chapter 2 Shelf Management Commands restoreallcnf restoreallcnf Restore All Configurations Restores all configuration files saved to the CNF directory on the hard drive. The saved configuration is the result of a prior execution of the saveallcnf command. To see a list of existing configurations that have been zipped by saveallcnf, cd to the C drive and list the contents of the CNF directory.
Chapter 2 Shelf Management Commands runrev runrev Run Revision Causes a new firmware version to start running. In a redundant card pair, runrev first causes the standby card to become the active card. The runrev command is the second of the required commands in a graceful upgrade. It runs on the PXXM45 but can target either a service module or the PXM45. The order of commands in a graceful upgrade, including the option of aborting the upgrade, appears in the following list.
Chapter 2 Shelf Management Commands runrev Note Of special note in Table 2-13, runrev causes the standby card to become the active card. The reversed location of the “Active” and “Standby” columns shows the changed states. Table 2-13 Redundant Pair Upgrade From 2.x to 2.y Firmware status Before upgrade After loadrev After runrev After commitrev Active Standby Active Standby Standby Active Standby Active Primary 2.x 2.x 2.x 2.x 2.y 2.y 2.y 2.y Secondary 2.x 2.x 2.y 2.y 2.x 2.
Chapter 2 Shelf Management Commands runrev Example Run version 2.0(0.4) in logical slot 7. A previous check of the cards (by using dspcds) and firmware images (by using dspcd) would show whether a redundant card and version 2.0(0.4) are present. excel.8.PXM.a > runrev 7 2.0(0.4) Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 2 Shelf Management Commands routeShow routeShow Route Show Show the current IP routing of the network layer of the operating system. Cards on Which This Command Runs PXM45 Syntax routeShow Related Commands routestatShow Attributes Log: no log State: active, standby, init Privilege: ANYUSER Example Display the current IP routing of the network layer of the operating system. pinnacle.8.PXM.
Chapter 2 Shelf Management Commands routestatShow routestatShow Show Routing Statistics Use the routestatShow command to view the current IP routing statistics for the network layer of the operating system. Cards on Which This Command Runs PXM45 Syntax routestatShow Related Commands routeShow Attributes Log: no log State: active, standby, init Privilege: ANYUSER Example Display the current IP routing statistics for the network layer of the operating system pinnacle.8.PXM.
Chapter 2 Shelf Management Commands saveallcnf saveallcnf Save All Configurations—save all configuration files to the hard drive. The saveallcnf command saves all configurations to a zipped file in the CNF directory on the hard drive. This command takes significant time, so a warning message prompts you for confirmation before the system performs the task. Upon completion, the system displays the name of the saved configuration file. The system stores up to two zipped configuration files.
Chapter 2 Shelf Management Commands saveallcnf Example Save the system configuration. Note that the system displays the name of the saved configuration file. MGX8850.7.PXM.a > saveallcnf The 'saveallcnf' command can be time-consuming. The shelf must not provision new circuits while this command is running. Do not run this command unless the shelf configuration is stable or you risk corrupting the saved configuration file.
Chapter 2 Shelf Management Commands setipconndebug setipconndebug Set IP Connection Debug Specify a debug mode and whether to use a console for debugging IP connectivity. This command requires SUPER_GP privilege. After you set the debug level, a status message states the current level. Syntax setipconndebug [-console | -noconsole] [debuglevel] Syntax Description -console | -no console Configure where to run setipconndebig: console (ASCII) terminal or elsewhere. debuglevel Specifies a debug level.
Chapter 2 Shelf Management Commands setrev setrev Set Revision Force-load and run a firmware version for a card. You must execute setrev from the CLI of the active PXM45 whether the target is a service module or the PXM45. Note For the first-time power-up of the node, you should execute the burnboot command to burn in the bootcode. For details, refer to the Cisco MGX 8850 Routing Switch Software Configuration Guide, Release 2. From a high-level perspective, the setrev command has two effects.
Chapter 2 Shelf Management Commands setrev Using the example of axsm_002.000.000.001.fw, the version is 2.0(1.1). Similarly, if no patch were present, the version number would be 2.0(1). Pre-release, developmental versions have one or two alphanumeric characters at the end of the version number, and these versions may appear in various contexts. For example, the help display for setrev gives examples of revision, but only the first two in the following list could be in released product.
Chapter 2 Shelf Management Commands setrev Example Specify version 2.0(2) for the card in slot 9. In addition to setrev, this example shows other commands you could use before and after setrev. The sequence begins with a display of all the cards. While the firmware is going into the RAM on the card, periodically execute dspcds on the PXM45 to see the changing status of the target card.
Chapter 2 Shelf Management Commands setrev Step 5 Check the progress by executing dspcds. The following display shows that the PXM45 has detected the card type in slot 9. The status is “init”—initialization in progress: pxm45tl System Rev: 00.00 Jan. 05, 2000 15:21:01 GMT Boot F/W Rev: 0.0(0) H/W Rev: 00.00 GMT Offset 0 Backplane Serial No: _UNKNOWN___ Backplane HW Rev: 00.00 Statistics Master IP Address: 0.0.0.
Chapter 2 Shelf Management Commands svcifconfig svcifconfig SVC Interface Configure Configure IP-related parameters for the SVCs that support network control at a workstation.The configuration applies to all the SVCs on one of the three physical port types. Note that a complete configuration requires you to execute svcifconfig twice. The first execution identifies the ATM end-station address (AESA) and encapsulation type at the router end.
Chapter 2 Shelf Management Commands svcifconfig llcencap | vcmux Applies to the router link only. This parameter specifies encapsulation. The choice primarily depends on whether the router supports LLC Snap encapsulation (llcsnap). The alternative is VC-based multiplexing (vcmux). default | nodefault (Optional) Specifies whether this SVC is the default route on the interface. reset (Optional) Reset of the SVC. The SVC is freed, then the call is attempted again.
Chapter 2 Shelf Management Commands switchcc switchcc Switch Core Cards Switch control of the MGX 8850 node from the present slot to the other PXM45 slot. If a standby PXM45 is not available, the node blocks the switchcc command. You cannot execute switchcc during a configuration-copy. If you attempt it, the system displays the message “Core card redundancy unavailable.
Chapter 2 Shelf Management Commands telnet telnet Telnet to another switch The telnet command lets you directly telnet to another switch from the current CLI session. Therefore, you do not have to exit the current CLI session and start a new telnet session to reach another switch. This command requires 2.1 or higher software. No limit exists on the number of telnet hops you can take from an individual CLI session. However, an individual node has a limit of 15 telnet sessions.
Chapter 2 Shelf Management Commands telnet Example Telnet to the switch with IP address 172.39.52.76. The destination switch is of uncertain software level, so check to see whether it can let you telnet to another node. Eventually, return to the source node by exiting the destination node. pop20two.8.PXM.a > telnet 172.39.52.76 Trying 172.39.52.76... Connected to 172.39.52.76 Login: superuser password: 8850NY.7.PXM.a > ? telnet (nothing appropriate) 8850NY.7.PXM.
Chapter 2 Shelf Management Commands timeout timeout Timeout—specifies the number of seconds of idle time for the current user-session. The timeout command lets you extend the amount of idle time in a user-session from the default of 10 minutes. If you do not specify a timeout period, the system displays the current timeout. At the end of the session, the system logs you out. To disable the session timeout function, specify 0 seconds. Note The timeout command is the same as the sesntimeout command.
Chapter 2 Shelf Management Commands users users Users—display the ID of each user logged into a card.
Chapter 2 Shelf Management Commands users Example Display the current users on the switch. Only one user-session is currently running. The user telnetted to the switch from IP address 10.18.247.21. The idle time is 0 because the current user has just executed the users command. If other user-sessions were running and one or more were idle, the idle time for each user would be a non-zero number. Change to the AXSM CLI and execute users. pop20one.7.PXM.
C H A P T E R 3 Equipment and Resource Provisioning This chapter describes the commands that let you activate, configure, display, and delete resources at various levels of the switch. These levels are: • Node • Card • Line • Port The MGX 8850 node uses the concept of a bay. The bay refers to the back card position. The T3/E3, OC-3, and OC-12 versions of the ATM Switching Service Module (AXSM) can have two back cards, one in bay 1 (upper slot) and the second in bay 2 (lower slot).
Chapter 3 Equipment and Resource Provisioning Command Entry Command Entry When you enter a command with the current version of the product, you must type all intended arguments before you press the Return key or Enter key. If you press the Return key or Enter key with incorrect parameters or no parameters (if the command requires parameters), a message displays the syntax and parameter ranges. The returned message may also suggest what the problem is.
Chapter 3 Equipment and Resource Provisioning Identifying Physical and Logical Elements Table 3-2 Maximum Connections by Connection Type and Front Card Front Card SVC SPVC AXSM-1-2488 128 K 64 K AXSM-4-622 128 K 64 K AXSM-16-155 128 K 64 K AXSM-16-T3E3 128 K 64 K Table 3-3 Maximum Connections on Back Cards and Lines Card Type Back Card Maximum Physical Line Maximum OC-48c 128 K 64 K OC-12c 64 K 32 K OC-3c 64 K 32 K T3 64 K 64 K E3 64 K 64 K Identifying Physical and Log
Chapter 3 Equipment and Resource Provisioning Identifying Physical and Logical Elements Not all of these elements correspond to elements you specify on the PXM45. Subsequent paragraphs describe only the common elements that are visible on the CLI of the PXM and the service module. The preceding elements are further defined in the Cisco MGX 8850 Routing Switch Software Configuration Guide, Release 2.0. For a UNI or NNI, one logical interface (or logical port) exists per physical line.
Chapter 3 Equipment and Resource Provisioning Identifying Physical and Logical Elements • Bay 2 • Line 1 • Logical interface 1 (or logical port 1) Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 3 Equipment and Resource Provisioning addapsln addapsln Add APS Line Creates (designates) a pair of lines (workingIndex, protectIndex) as APS lines. To configure the APS parameters, use the cnfapsln command after creating the lines using the addapsln command. APS Overview Automatic Protection Switching (APS) is a standards-based redundancy scheme which enhances network reliability by protecting against line failure.
Chapter 3 Equipment and Resource Provisioning addapsln Note APS 1:1 is only supported on Model B software. It is not supported on Model A software. 3 Cards on Which This Command Runs AXSM AXSM Syntax addapsln AXSM Syntax Description workingIndex Slot number, bay number, and line number of the working line in the format: slot.bay.line protectIndex Slot number, bay number, and line number of the protection line in the format: slot.bay.
Chapter 3 Equipment and Resource Provisioning addcontroller addcontroller Add Controller Identifies a network control protocol to the Virtual Switch Interface (VSI) that runs on the node. If you do not identify a network control protocol (or simply controller), the switch does not use it.
Chapter 3 Equipment and Resource Provisioning addcontroller cntrlrType A number in the range 1–3 that identifies a network controller. For internal controllers, the numbers are reserved, as follows: 1 = PAR (Portable AutoRoute)—currently not used 2 = PNNI 3 = LSC (Label Switch Controller, also known as MPLS for Multiprotocol Label Switch Controller)—currently not used Note For an internal controller, the controller type (cntrlrType) must be the same as the controller ID (cntrlrId).
Chapter 3 Equipment and Resource Provisioning addcontroller vci Applies to only external controllers. VCI in the range 1–65535. cntrlrName (Optional) A string to serve as a name for the controller. Related Commands dspcontrollers, delcontroller Attributes Log: log State: active Privilege: SUPER_GP Example Add an internal PNNI controller. Note that, as stated in the Syntax Description for an Internal Controller, the controller ID matches the controller type. The optional controller name is “pnni.
Chapter 3 Equipment and Resource Provisioning addfdr addfdr Add Feeder Adds a feeder node connection to the specified port (ifNum). The interface numbers of active ports are displayed in the dspports command report. LMI is up by default when you use addfdr. When adding a feeder node, the following conditions apply: • You can add a feeder node only to an already existing port (ifNum). • You cannot add a feeder node to a port that already has a connection established on it.
Chapter 3 Equipment and Resource Provisioning addpart addpart Add Resource Partition Add a resource partition. Before you add resource partitions, be sure you have a plan for future developments, such as the addition of a new controller. Note The addpart and addrscprtn commands are identical. The name ‘addrscprtn’ is consistent with the corresponding command in Release 1 of the MGX 8850 node. Use the command name that suits you.
Chapter 3 Equipment and Resource Provisioning addpart ctrlr_id A number in the range 1–3 that identifies a network controller. The numbers are reserved, as follows: 1 = PAR (Portable AutoRoute)—currently not used 2 = PNNI 3 = LSC (Label Switch Controller, also known as MPLS for Multiprotocol Label Switch Controller)—currently not used egrminbw A guaranteed percentage of egress bandwidth. Each unit of egrminbw is 0.000001 of the total bandwidth on the port. (An egrMinBw of 1000000 = 100%.
Chapter 3 Equipment and Resource Provisioning addpart Example Create a resource partition with the following parameters: • Logical port 4 (already created by executing addport) • Partition number 4 • Controller ID 2 (the reserved ID for PNNI) • 10% of the bandwidth in the egress and ingress directions reserved for this partition • The range for VPIs is 10–110, the range for VCIs is 100–2000 • Minimum guaranteed connections is 100, maximum number of connections is 500 MGX8850.3.AXSM.
Chapter 3 Equipment and Resource Provisioning addport addport Add Port—add a logical port (to the VSI slave). A logical port is associated with a physical line. For a UNI or NNI, a line can support one logical port. For a virtual NNI (VNNI), a line can support multiple logical ports. The range of logical port numbers is 1–60 for the AXSM regardless of the interface type (UNI, NNI, or VNNI).
Chapter 3 Equipment and Resource Provisioning addport Cards on Which This Command Runs AXSM Syntax addport [vpi] Note For all ports, guaranteedRate must be the same as maxrate. Syntax Description ifNum A logical port (interface) number. Only one logical port is allowed if the line operates as a UNI or NNI. For the virtual network to network interface (VNNI), multiple ports can exist on a line. For AXSM, the range 1–60. bay.
Chapter 3 Equipment and Resource Provisioning addport sctID The ID of a service class template (SCT) for the port. The range is 0–255. The SCT file must exist on the PXM45 disk. See cnfcdsct. Cisco Systems provides SCT numbers 2 and 3. You can create more SCTs by modifying an existing SCT through the Cisco WAN Manager application and saving it with another SCT number. Subsequently, you can assign the new SCT to the port by the sctID parameter in cnfport.
Chapter 3 Equipment and Resource Provisioning addred addred Add Redundancy Links two slots to support card-level redundancy for a pair of service modules. The pair consists of a primary slot and a secondary slot. Currently, the only form of redundancy for service modules is 1:1. Although 1:n appears in the Help display, it is reserved for future use. To see the slots where redundancy exists, use dspcd or dspcds.
Chapter 3 Equipment and Resource Provisioning addrscprtn addrscprtn Add Resource Partition Add a logical partition of resources for a network controller on a port. Before you add resource partitions, be sure a plan exists for future developments, such as the addition of a new controller. Note The addpart and addrscprtn commands are identical. The name ‘addrscprtn’ is consistent with the corresponding command in Release 1 of the MGX 8850 switch. Use whichever command name suits you purpose.
Chapter 3 Equipment and Resource Provisioning addrscprtn Syntax Description if_num Logical interface (port) number. For AXSM, the range is 1–60. part_ID The number of the partition in the range 1–5. ctrlr_id The number of the controller in the range 1–20. egrminbw A guaranteed percentage of egress bandwidth. Each unit of egrMinBw is 0.00001 of the total bandwidth on the port. (An egrMinBw of 1000000 = 100%.) This approach provides a high level of granularity.
Chapter 3 Equipment and Resource Provisioning clrbecnt clrbecnt Clear Bit Error Count The clrbecnt command lets you clear the APS-related bit error counters for a working line. To see the contents of the error counters, use the dspbecnt command. Cards on Which This Command Runs AXSM Syntax clrbecnt Syntax Description working-bay.line Identifies the bay (1 or 2) and the number of the line. The line number is from 1 to the highest numbered line on the back card.
Chapter 3 Equipment and Resource Provisioning clrfdrstat clrfdrstat Clear Feeder Statistics Clears the LMI and node statistics for the feeder on the specified port (ifNum). For more detailed information on configuring a feeder, see the Cisco MGX 8850 Switch Software Configuration Guide, Release 2. Syntax clrfdrstat Syntax Description ifNum The interface number of the port on which to clear the feeder statistics.
Chapter 3 Equipment and Resource Provisioning cnfapsln cnfapsln Configure APS Line Configures the APS parameters for a line (working line). Use the cnfapsln command after creating the line using the addapsln command. See the description for the addapsln command for a detailed explanation of Automatic Protection Switching (APS).
Chapter 3 Equipment and Resource Provisioning cnfapsln Wait To Restore The number of minutes to wait after the working line has become functional again, before switching back to the working line from the protection line. The range is 5–12. Example: -wtr 5 direction 1: unidirectional, 2: bidirectional Example: -dr 2 Bidirectional means that both the receiving and transmitting paths are switched. Unidirectional means that only the affected path, receiving or transmitting, is switched.
Chapter 3 Equipment and Resource Provisioning cnfatmln cnfatmln Configure ATM Line Configures the ATM layer cell header for the specified line (bay.line). You must configure the ATM layer cell header for a line before you activate the line using upln, or before you add a logical port to the line using addport. Cards on Which This Command Runs AXSM Syntax cnfatmln -ln
Chapter 3 Equipment and Resource Provisioning cnfatmln Example For AXSM, line 1, bay 1, disable payload scrambling and specify a null cell header. MGX8850.7.AXSM.a > cnfatmln -ln 1.1 -sps 2 -nch ab12abab For AXSM, line 1, bay 1, enable payload scrambling and specify null cell headers. MGX8850.1.AXSM.a > cnfatmln -ln 1.1 -sps 1 -nch 1a1a1a1a -ncp aa Cisco MGX 8850 Routing Switch Command Reference 3-26 Release 2.
Chapter 3 Equipment and Resource Provisioning cnfcdsct cnfcdsct Configure Card SCT Assign a service class template (SCT) to an AXSM at the card level. The template contains bandwidth and policing parameters for an AXSM. Note Currently, the system does not support certain parameters in the service class templates (SCTs), so you can specify them through addcon, cnfcon, or Cisco WAN Manager. These parameters are (when applicable) PCR, SCR, and ICR.
Chapter 3 Equipment and Resource Provisioning cnfcdsct Syntax cnfcdsct Syntax Description SCT-id Number of the SCT at the card-level. The range is 1–255. Related Commands dspcdsct, dspcd, dspsct Attributes Log: log State: active Privilege: GROUP1 Example Specify card-level SCT number 3 for the current AXSM. MGX8850.9.AXSM.a > cnfcdsct 3 The SCT file must reside on the PXM disk before you use this command, or it fails and displays the error message in the following example: MGX8850.1.6.
Chapter 3 Equipment and Resource Provisioning cnfln cnfln Configure Line Configures a line on the current service module. Use cnfln after you have activated the line using upln. Note You cannot configure a line that currently has any configured virtual interfaces on it. Cards on Which This Command Runs AXSM Note The syntax varies according to the line type, so each line type has a description. Syntax for SONET Line cnfln -sonet
Chapter 3 Equipment and Resource Provisioning cnfln Syntax for T3/E3 Line cnfln -ds3 -lt -len -oof -cb -rfeac -clk Syntax Description (T3/E3) All parameters are keyword driven. Therefore, the order that you enter them does not matter. -ds3 Identifies the bay (1 or 2) and the number of the line. The format for LineNum is bay.line.
Chapter 3 Equipment and Resource Provisioning cnfln Related Commands dsplns, dspln, dnln, upln, addlnloop Attributes Log: log State: active Privilege: GROUP1 Examples Configure T3 line 4 on the current card to have B8ZS coding and a length of 10. MGX8850.1.4.AXSM.a > cnfln -ds3 4 2 10 Enable frame scrambling for SONET line 1 of the card in bay 1. MGX8850.1.4.AXSM.a > cnfln -sonet 1.1 -sfs 2 Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 3 Equipment and Resource Provisioning cnfpart cnfpart Configure Resource Partition Modifies a resource partition. A resource partition on an AXSM consists of minimum and maximum percentages of bandwidth, a VPI/VCI range, and a minimum and maximum number of connections available to a network control application. The current network controller is PNNI. Refer to the description of addpart for information on resource partitions. Note The cnfpart and cnfrscprtn commands are identical.
Chapter 3 Equipment and Resource Provisioning cnfpart -emax Specifies the maximum percentage of the bandwidth. Each unit of egrMaxBw is 0.00001 of the total bandwidth available to the port. (An egrMaxBw of 1000000 = 100%.) The resulting bandwidth must be at least 50 cps. -imin Specifies the guaranteed percentage of the ingress bandwidth. Each unit of ingMinBw is 0.00001 of the total bandwidth available to the port. For example, an ingMinBw of 1000000 = 100%.
Chapter 3 Equipment and Resource Provisioning cnfport cnfport Configure Port Configures a logical port on a service module. The system does not display a confirmation upon successful execution, so use dspport to check the changes. Note You cannot use cnfport to change the guaranteed rate and maximum rate parameters if a resource partition has been configured for the interface. You can change the SCT ID if you first down the port by executing dnport, then executing cnfport.
Chapter 3 Equipment and Resource Provisioning cnfport -max Specifies the maximum rate on a logical port in cells per second (cps). OC48: 50–5651320 cps OC12: 50–1412830 cps OC3: 50–353207 cps T3: 50–96000 (PLCP) or 104268 (ADM) cps E3: 50–80000 cps -sct Specifies the number of a service class template (SCT) for the egress direction. The range is 0–255. Cisco provides a default of SCT 0 as well as SCT numbers 2 and 3.
Chapter 3 Equipment and Resource Provisioning cnfrscprtn cnfrscprtn Configure Resource Partition Modifies a resource partition. A resource partition on an AXSM consists of minimum and maximum percentages of bandwidth, a VPI/VCI range, and a minimum and maximum number of connections available to a network control application. The current network controller is PNNI. Refer to the description of addrscprtn for information on resource partitions. Note The cnfpart and cnfrscprtn commands are identical.
Chapter 3 Equipment and Resource Provisioning cnfrscprtn -emax A maximum percentage of the bandwidth. Each unit of egrMaxBw is 0.00001 of the total bandwidth available to the port. (An egrMaxBw of 1000000 = 100%.) The resulting bandwidth must be at least 50 cps. -imin A guaranteed percentage of the ingress bandwidth. Each unit of ingMinBw is 0.00001 of the total bandwidth available to the port. For example, an ingMinBw of 1000000 = 100%. -imax A maximum percentage of the ingress bandwidth.
Chapter 3 Equipment and Resource Provisioning delapsln delapsln Delete APS Line Removes the specified APS line from the switch. See the description for the addapsln command for a detailed explanation of Automatic Protection Switching (APS). Cards on Which This Command Runs AXSM Syntax delapsln Syntax Description workingline Slot number, bay number, and line number of the active line to delete, in the format: slot.bay.line. Example: 1.1.
Chapter 3 Equipment and Resource Provisioning delcontroller delcontroller Delete Controller Delete a controller. The delcontroller command does not erase the controller software but directs the switch not to use it. Cards on Which This Command Runs PXM45 Syntax delcontroller Syntax Description cntrlrId The controller ID (cntrlrId) has a range of 1–20 and is assigned by using the addcontroller command. To see all controllers on the switch, use dspcontrollers.
Chapter 3 Equipment and Resource Provisioning delfdr delfdr Delete Feeder Deletes a feeder node connection from the specified port (ifNum). The interface numbers of active ports are displayed in the dspports command report. Note You cannot delete a port that has feeder node connections on it. For more detailed information on configuring a feeder, see the Cisco MGX 8850 Switch Software Configuration Guide, Release 2.
Chapter 3 Equipment and Resource Provisioning delpart delpart Delete Resource Partition Delete a resource partition. Note that you must delete all connections in the resource partition before you can delete it. For information on resource partitions, refer to the description of addpart. Note The delpart and delrscprtn commands are identical. The name ‘delrscprtn’ is consistent with the corresponding command in Release 1 of the MGX 8850 switch. You can use either command.
Chapter 3 Equipment and Resource Provisioning delport delport Delete Port Remove a logical port from a service module. You must delete all connections and resource partitions on the port before you can delete it. Cards on Which This Command Runs AXSM Syntax delport Syntax Description ifNum A logical port (interface) number. Only one logical port is allowed if the line operates as a UNI or NNI. For the virtual network to network interface (VNNI), multiple ports can exist on a line.
Chapter 3 Equipment and Resource Provisioning delred delred Delete Redundancy Deletes 1:1 redundancy for a pair of card slots. Note 1:N redundancy requires a Service Resource Module (SRM) in the switch. The current release does not support SRMs. Cards on Which This Command Runs PXM45 Syntax delred Syntax Description redPrimarySlotNumber Slot number that contains the primary card of the pair. The ranges are 1–6 and 9–14 on the MGX 8850 switch.
Chapter 3 Equipment and Resource Provisioning delrscprtn delrscprtn Delete Resource Partition Delete a resource partition. Note that you must delete all connections in the resource partition before you delete it. For information on resource partitions, refer to the description of addrscprtn. Note The delpart and delrscprtn commands are identical. The name ‘cnfrscprtn’ is consistent with the corresponding command in Release 1 of the MGX 8850 switch. You can use either command.
Chapter 3 Equipment and Resource Provisioning dnlmi dnlmi Down Local Management Interface De-activates the Local Management Interface (LMI) on the specified logical port (ifNum). Cards on Which This Command Runs AXSM Syntax dnlmi Syntax Description ifNum The interface number of the logical port on which to de-activate the LMI. Related Commands uplmi Attributes Log: log State: active Privilege: ANYUSER Example dnlmi 2 Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 3 Equipment and Resource Provisioning dnln dnln Down Line The dnln command lets you de-activate a line on the current card. Before you can de-activate a line, you must take the following steps: Step 1 Remove connections. Use delcon or delcons. Step 2 Remove any resource partitions. Use dsprscprtn to see existing partitions and delrscprtn to remove partitions. Step 3 Remove all logical ports. Use dspports to see existing logical ports on the line and delport to remove logical ports.
Chapter 3 Equipment and Resource Provisioning dnport dnport Down Port The dnport command disables (or downs) a logical port and thereby halts all traffic on the logical port. The usual purpose for using dnport is troubleshooting. The configuration for the port remains intact whether the logical port is a UNI or an NNI. The command for enabling a downed port is upport. For an NNI, the PXM45 de-routes the failed connections then re-routes them through other trunks.
Chapter 3 Equipment and Resource Provisioning dspapsbkplane dspapsbkplane Display APS Backplane Displays whether or not the APS mini-backplane is properly seated with the backcards. When successful, this command displays: BackPlane:ENGAGED When not successful, this command displays: BackPlane:NOT ENGAGED See the addapsln command for an explanation of Automatic Protection Switching (APS).
Chapter 3 Equipment and Resource Provisioning dspapsln dspapsln Display APS Line Displays the configuration of an APS line. This command can be executed for either a working line or a protection line. See the addapsln command for an explanation of Automatic Protection Switching (APS). Cards on Which This Command Runs AXSM Syntax dspapsln Syntax Description working-slot.bay.line Identity of the working line with the format slot.bay.line.
Chapter 3 Equipment and Resource Provisioning dspapsln Example Display the APS configuration for slot 13, bay 1, line 1. MGX8850.13.AXSM.a > dspapsln 13.1.1 Working Index : 13.1.1 Protection Index : 14.1.
Chapter 3 Equipment and Resource Provisioning dspapslns dspapslns Display APS Lines Displays all working and protection APS lines on a card. This command can be executed only on an active card. After identifying a particular APS line, you can use dspapsln to view details about the line. See the addapsln command for an explanation of Automatic Protection Switching (APS). Cards on Which This Command Runs AXSM Syntax dspapslns Syntax Description This command takes no parameters.
Chapter 3 Equipment and Resource Provisioning dspatmln dspatmln Display ATM Line Displays the cell header configuration for the line that was set using cnfatmln. The display indicates NNI or UNI cell headers. Cards on Which This Command Runs AXSM Syntax dspatmln Syntax Description bay.line Identifies the bay (1 or 2) and the number of the line. The line number is from 1 to the highest numbered line on the back card. For the range of line numbers on specific AXSM models, see Table 3-1.
Chapter 3 Equipment and Resource Provisioning dspbecnt dspbecnt Display Bit Error Count The dspbecnt command lets you display the APS-related bit error counters. Cards on Which This Command Runs AXSM Syntax dspbecnt Syntax Description working-bay.line Identifies the bay (1 or 2) and the number of the line. The line number is from 1 to the highest numbered line on the back card. For the range of line numbers on specific AXSM models, see Table 3-1.
Chapter 3 Equipment and Resource Provisioning dspcd dspcd Display Card Display the following information about a card: Note • Hardware serial number. • Firmware revision level. (See the loadrev description for an explanation of how to interpret the revision field.) • Status, possibly including the reason for the last reset (FunctionModuleResetReason) and state of the integrated alarm (cardIntegratedAlarm). • For a service module only: a count of configured lines, ports, and connections.
Chapter 3 Equipment and Resource Provisioning dspcd PXM45 Attributes Log: no log State: active, standby, init Privilege: ANYUSER Log: no log State: active, standby Privilege: ANYUSER AXSM Attributes Examples Display card details for the current PXM45. Note The “A1” at the end of the primary software revision and boot firmware revision numbers shows that these versions are pre-release. Refer to the setrev description for details. MGX8850.7.PXM.a > dspcd MGX8850 System Rev: 02.
Chapter 3 Equipment and Resource Provisioning dspcd Display card details for the current AXSM-16-155. MGX8850.3.AXSM.a > dspcd Front Card ---------- Upper Card ---------- Card Type: AXSM-16-155 MMF-8-155-MT --- State: Active Present Absent Serial Number: SAK0350008L SAK0403004A --- Boot FW Rev: 2.0(11)A1 --- --- SW Rev: 2.
Chapter 3 Equipment and Resource Provisioning dspcds dspcds Display Cards Displays high-level information for all the cards in the node. For more detailed information about a card, execute dspcd on the CLI of that card.
Chapter 3 Equipment and Resource Provisioning dspcds Example Display information for all cards in the MGX 8850 switch. Unknown.7.PXM.a > dspcds Unknown System Rev: 02.00 Backplane Serial No: SAA03270618 Bp HW Rev: B0 Card Slot --- Front/Back Card State ---------- Card Type -------- Alarm Status -------- Aug.
Chapter 3 Equipment and Resource Provisioning dspcdsct dspcdsct Display Card SCT Displays the contents of a card-level service class template (SCT) file. For information about SCTs, see the cnfcdsct description. To see the number of the current SCT for the card, use dspcd. The examples in this description illustrate the contents of SCT number 2 and SCT 3.
Chapter 3 Equipment and Resource Provisioning dspcdsct Example SCT 2 This example shows all parameters for SCT 2. Each display consists of one member of the SCT parameter group. The screen examples show the SCT ID that you have displayed (the command itself does not require the SCT ID because it is card-level. Display the bandwidth parameters for SCT 2. MGX8850.1.AXSM.
Chapter 3 Equipment and Resource Provisioning dspcdsct Display the Class of Service Buffer parameters for SCT 2. Note the following: • Min-Rate and Max-Rate do not apply in the current product. • Excess-Priority is a scheme for distributing excess bandwidth. The lowest number is the highest priority for a connection to receive excess bandwidth. If two or more connections have equal priority, the excess bandwidth is equally distributed between them.
Chapter 3 Equipment and Resource Provisioning dspcdsct +---------------------------------------------------------------------------------------------------------+ Display the Class of Service Thresholds for SCT 2. Note The two random early discard parameters (RED Factor and RED Prob) have no application in the current release of the product MGX8850.1.AXSM.
Chapter 3 Equipment and Resource Provisioning dspcdsct Display the general parameters for SCT 3. MGX8850.9.AXSM.
Chapter 3 Equipment and Resource Provisioning dspcon dspcon Display Connection Display information about an SPVC. The contents of the display on the AXSM and the PXM45 differ slightly. On both cards, the dspcon output appears in sections to make the information easier to sort. Most of the information in the dspcon output comes from addcon execution. See the addcon description for more information. Also, executing cnfpnni-intf can affect the dspcon output.
Chapter 3 Equipment and Resource Provisioning dspcon Display Connection on the AXSM On the AXSM, dspcon shows the following connection identifiers: • NSAP address, logical port, VPI/VCI, status, and ownership of local and remote ends of the connection. The display shows whether a particular endpoint is the master or slave. The provisioning parameters in the display show: • Connection type of VPC or VCC. • Service type (for example, ABR). • A number indicating the controller.
Chapter 3 Equipment and Resource Provisioning dspcon Related Commands addcon, dspcons, cnfcon PXM45 Attributes Log: no log State: active, standby Privilege: ANYUSER Log: no log State: active Privilege: GROUP1 AXSM Attributes Examples Display connection 5 31 63000 on the current AXSM. MGX8850.1.AXSM.
Chapter 3 Equipment and Resource Provisioning dspcon On the CLI of the PXM45, display connection 20 100 on 11:1.1:2. Unknown.7.PXM.a > dspcon 11:1.1:2 20 100 Port Vpi Vci Owner State ------------------------------------------------------------------------Local 11:1.1:2 20.100 MASTER FAIL Address: 47.00918100000000107b65f33d.0000010b1802.00 Remote 11:1.1:2 10.100 SLAVE FAIL Address: 47.00918100000000107b65f33d.0000010b1802.
Chapter 3 Equipment and Resource Provisioning dspcons dspcons Display Connections—display basic information for all connections. The default usage of dspcons uses no parameters and causes all available information for the connections to appear. To narrow the scope of the output, use one or more optional parameters. The dspcons command runs on the CLI of either the AXSM or the PXM45. The set of optional parameters and the output are different on these cards.
Chapter 3 Equipment and Resource Provisioning dspcons Cards on Which This Command Runs PXM45, AXSM PXM45 Syntax dspcons[-port portid] [-vpi starting-vpi] [-vci starting vci] [-state {fail|ais|abit|ok|down}] [-owner {master|slave}] PXM45 Syntax Description -port The port identifier (portid) in the format that the network controller utilizes: [shelf.]slot[:subslot].port[:subport] Currently, the value for shelf is always 0 and therefore is not necessary.
Chapter 3 Equipment and Resource Provisioning dspcons PXM45 Example Display all connections by entering dspcons on the CLI of the PXM45. MGX8850.7.PXM.a > dspcons Local Port Vpi.Vci Remote Port Vpi.Vci State Owner ----------------------------+-----------------------------+-------+-----3:1.1:1 20 0 6:1.1:1 20 0 OK MASTER Local Addr: 47.00918100000000107b65f33d.000001031801.00 Remote Addr: 47.00918100000000107b65f33d.000001061801.00 5:1.1:1 100 100 5:1.1:1 100 200 OK SLAVE Local Addr: 47.
Chapter 3 Equipment and Resource Provisioning dspcontrollers dspcontrollers Display Controllers Displays all controllers that have been added through the addcontroller command. Cards on Which This Command Runs PXM45 Syntax dspcontrollers Syntax Description This command takes no parameters. Related Commands addcontroller, delcontroller Attributes Log: no log State: active Privilege: ANYUSER Example Display all controller. In this example, the switch has only one controller—PNNI.
Chapter 3 Equipment and Resource Provisioning dspfdr dspfdr Display Feeder Displays the configuration information for the feeder on the specified port (ifNum). The interface numbers of active ports are displayed in the dspports command report. For more detailed information on configuring a feeder, see the Cisco MGX 8850 Switch Software Configuration Guide, Release 2. Syntax dspfdr Syntax Description ifNum The interface number of the port on which to display the feeder information.
Chapter 3 Equipment and Resource Provisioning dspfdrs dspfdrs Display Feeders Displays all feeders on all ports on the AXSM card and their information. For more detailed information on configuring a feeder, see the Cisco MGX 8850 Switch Software Configuration Guide, Release 2. Syntax dspfdrs Card(s) on Which This Command Executes AXSM Related Commands addfdr, delfdr, dspfdr Attributes Log: no log State: active Privilege: ANYUSER Example MGX8850.1.AXSM.
Chapter 3 Equipment and Resource Provisioning dspfdrstat dspfdrstat Display Feeder Statistics Displays the LMI and node statistics for the feeder on the specified port (ifNum). The interface numbers of active ports are displayed in the dspports command report. For more detailed information on configuring a feeder, see the Cisco MGX 8850 Switch Software Configuration Guide, Release 2.
Chapter 3 Equipment and Resource Provisioning dspln dspln Display Line Display the characteristics of a physical line. Note The connection count includes control VCs when you use dspln on a service module. However, when you use dspcd or dsppnport(s) on the CLI of the PXM, the display does not include control VCs. Cards on Which This Command Runs AXSM AXSM Syntax dspln <-ds3 | -sonet> AXSM Syntax Description -ds3 Command delineator that precedes the bay.line number entry for a T3 line.
Chapter 3 Equipment and Resource Provisioning dspln Display OC-48 line on the current OC-12 AXSM. MGX8850.1.AXSM.a > dspln Line Number Admin Status Loopback Frame Scrambling Xmt Clock source Line Type Medium Type(SONET/SDH) Medium Time Elapsed Medium Valid Intervals Medium Line Type Note -sonet 2.1 : 2.
Chapter 3 Equipment and Resource Provisioning dsplns dsplns Display Lines Displays the configuration for all lines on a card.
Chapter 3 Equipment and Resource Provisioning dsplns Example Display the configuration of the lines on an AXSM-4-622. MGX8850.1.AXSM.a > dsplns Medium Medium Sonet Line Line Line Frame Line Line Alarm APS Line State Type Lpbk Scramble Coding Type State Enabled ----- ----- ------------ ------ -------- ------ ------- -----------1.1 Up sonetSts12c NoLoop Enable Other ShortSMF Critical Disable 1.2 Up sonetSts12c NoLoop Enable Other ShortSMF Clear Disable 2.
Chapter 3 Equipment and Resource Provisioning dspload dspload Display Load Display the current level of usage of various parameters on a partition. To convey a picture of what is available on a resource partition, the display shows the configured bandwidth and connection numbers and what has actually been utilized. Cards on Which This Command Runs AXSM Syntax dspload Syntax Description ifNum Logical interface (port) number. For AXSM, the range is 1–60.
Chapter 3 Equipment and Resource Provisioning dspload Example Display the load on partition number 1 on logical port 1. The display shows that very little of the available connections and bandwidth have been used. Also, no exceptions have been recorded. M8850_NY.1.AXSM.
Chapter 3 Equipment and Resource Provisioning dsppart dsppart Display Resource Partition Displays information about one resource partition. The displayed information is shown in the example. Note The dsppart and dsprscprtn commands are identical. The name ‘dsprscprtn’ is consistent with the corresponding command in Release 1 of the MGX 8850 switch. You can use either command. Note The connection count includes control VCs when you execute dsppart on the CLI of a service module.
Chapter 3 Equipment and Resource Provisioning dsppart Example Display resource partition 1 on logical port 1 of the current AXSM. MGX8850.1.AXSM.a > dsppart 1 1 Interface Number : Partition Id : Controller Id : egr Guaranteed bw(.0001percent): egr Maximum bw(.0001percent) : ing Guaranteed bw(.0001percent): ing Maximum bw(.
Chapter 3 Equipment and Resource Provisioning dspparts dspparts Display Resource Partitions Display information for all the resource partitions on the current card. The displayed information is shown in the example. For information on specific elements of a resource partition, see the description of addpart. Note The dspparts and dsprscprtns commands are identical. The name ‘dsprscprtns’ is consistent with the corresponding command in Release 1 of the MGX 8850 switch. You can use either command.
Chapter 3 Equipment and Resource Provisioning dspport dspport Display Port Displays the configuration for a logical port. The displayed information is shown in the example. For a description of each item, see addport. The total number of connections in the display includes control VCs. The types of control VCs are SSCOP, PNNI-RCC, and ILMI (if ILMI is enabled). To see the connection counts that do not include control VCs, use dsppnport. Note The SCT ID that dspport shows pertains to the port.
Chapter 3 Equipment and Resource Provisioning dspport Example Display the port configuration for logical port 2 on the current AXSM. MGX8850.1.AXSM.a > dspport 2 Interface Number : Line Number : Admin State : Guaranteed bandwidth(cells/sec): Maximum bandwidth(cells/sec) : ifType : SCT Id : VPI number(VNNI only) : 2 2.1 Up 100000 100000 NNI 3 0 Operational State : Number of partitions: Number of SPVC : Number of SVC : Up 1 0 4 Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 3 Equipment and Resource Provisioning dspports dspports Display Ports Displays general information about all logical ports on the card. On the AXSM, the information consists of the following for each logical port: • Logical port number (ifNum). On the AXSM, for example, the range is 1–60. • Physical line number in the format bay.port. • Operation status—whether the port is up or down. • The minimum guaranteed rate in cells per second.
Chapter 3 Equipment and Resource Provisioning dspportsct dspportsct Display Port SCT Displays the contents of the service class template (SCT) on a port. Note Currently, the system does not support certain parameters in the service class templates (SCTs), so you can specify them through addcon, cnfcon, or Cisco WAN Manager. These parameters are (when applicable) PCR, SCR, and ICR.
Chapter 3 Equipment and Resource Provisioning dspportsct Examples SCT 2 This section displays all parameters for port SCT 2. MGX8850.1.AXSM.
Chapter 3 Equipment and Resource Provisioning dspportsct Display the Class of Service Buffer parameters for SCT 2 Note the following: • Min-Rate and Max-Rate do not apply in the current product. • Excess-Priority is a scheme for distributing excess bandwidth. The lowest number is the highest priority for a connection to receive excess bandwidth. If two or more connections have equal priority, the excess bandwidth is equally distributed between them.
Chapter 3 Equipment and Resource Provisioning dspportsct Display VC thresholds for SCT 2. Note the following: The Scaling COSB value applies to congestion in a Class of Service Buffer: if a particular buffer becomes congested, this scaling factor determines the how quickly the rate at which cells enter the buffer is throttled back (until the buffer is no longer congested, at which time normal rates resume).
Chapter 3 Equipment and Resource Provisioning dspportsct Example SCT 3 This example shows all parameters for SCT 3. Each display consists of one member of the SCT parameter group. Display the bandwidth parameters for SCT 3. MGX8850.9.AXSM.
Chapter 3 Equipment and Resource Provisioning dspportsct Display the Class of Service Buffer parameters for SCT 3 Note the following: • Min-Rate and Max-Rate do not apply in the current product. • Excess-Priority is a scheme for distributing excess bandwidth. The lowest number is the highest priority for a connection to receive excess bandwidth. If two or more connections have equal priority, the excess bandwidth is equally distributed between them.
Chapter 3 Equipment and Resource Provisioning dspportsct Display the Class of Service thresholds for SCT 3. Note The two random early discard parameters (RED Factor and RED Prob) have no application in the current release of the product MGX8850.9.AXSM.
Chapter 3 Equipment and Resource Provisioning dspred dspred Display Redundancy Displays the current redundant slot links. Note 1:N redundancy requires a Service Resource Module (SRM) in the switch. The current release does not support SRMs. Cards on Which This Command Runs PXM45 Syntax dspred Related Commands addred, delred, switchredcd Attributes Log: no log State: active Privilege: ANYUSER Example MGX8850.1.AXSM.
Chapter 3 Equipment and Resource Provisioning dsprscprtn dsprscprtn Display Resource Partition Displays information about one resource partition. The displayed information is shown in the example. Note The dsppart and dsprscprtn commands are identical. The name ‘dsprscprtn’ is consistent with the corresponding command in Release 1 of the MGX 8850 switch. You can use either command. Note The connection count includes control VCs when you execute dsprscprtn on the CLI of a service module.
Chapter 3 Equipment and Resource Provisioning dsprscprtn Example Display configuration for partition 1 on logical port 1 of the current AXSM. MGX8850.1.AXSM.a > dsprscprtn 1 1 Interface Number : Partition Id : Controller Id : egr Guaranteed bw(.0001percent): egr Maximum bw(.0001percent) : ing Guaranteed bw(.0001percent): ing Maximum bw(.
Chapter 3 Equipment and Resource Provisioning dsprscprtns dsprscprtns Display Resource Partitions Display information for all the resource partitions on the current card. The displayed information is shown in the example. For information on specific elements of a resource partition, see the description of addrscprtn. Note The dspparts and dsprscprtns commands are identical. The name ‘dsprscprtn’ is consistent with the corresponding command in Release 1 of the MGX 8850 switch.
Chapter 3 Equipment and Resource Provisioning dspsct dspsct Display SCT Display the contents of a service class template (SCT) for either the egress or ingress direction. For information on SCTs, see the cnfcdsct and addport description. Also, refer to the description of SCTs in the Cisco MGX 8850 Switch Software Configuration Guide, Release 2.
Chapter 3 Equipment and Resource Provisioning dspsct Attributes Log: log State: active, standby Privilege: ANYUSER Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 3 Equipment and Resource Provisioning dspsct Example Display each parameter in SCT file number 4 in the ingress direction. The output illustrates each category within the SCT file separately. MGX8850.1.AXSM.
Chapter 3 Equipment and Resource Provisioning dspsct +--------------------------------------------------------------------------+ MGX8850.6.AXSM.
Chapter 3 Equipment and Resource Provisioning dsptotals dsptotals Display Totals Displays a list of the number current active lines, ports, and channels and the number of maximum lines, ports and channels in the format: active/maximum For example, 1/60 indicates that 1 port is active and that the maximum possible ports is 60. Cards on Which This Command Runs AXSM Syntax dsptotals Syntax Description No Parameters. Attributes Log: no log State: active, standby MGX8850.2.AXSM.
Chapter 3 Equipment and Resource Provisioning switchapsln switchapsln Switch APS Line Switches the specified working APS line (bay, line) to its protection line. See the description for the addapsln command for a detailed explanation of Automatic Protection Switching (APS). Cards on Which This Command Runs AXSM Syntax switchapsln [] Syntax Description bay The working bay number to switch. line The working line number to switch.
Chapter 3 Equipment and Resource Provisioning switchredcd switchredcd Switch Redundancy Card Switches operation from the active redundant card to standby redundant card. Cards on Which This Command Runs PXM45 Syntax switchredcd Syntax Description fromSlot The currently active redundant card. toSlot The current standby redundant card, which is being switched to active.
Chapter 3 Equipment and Resource Provisioning uplmi uplmi Up Local Management Interface Activates the Local Management Interface (LMI) on the specified logical port (ifNum). Cards on Which This Command Runs AXSM Syntax uplmi Syntax Description ifNum The interface number of the logical port on which to activate the LMI. Related Commands dnlmi Attributes Log: log State: active Privilege: GROUP1 Example uplmi 2 Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 3 Equipment and Resource Provisioning upln upln Up Line Activates a line on the current card. After you have activated the line, use cnfln to configure the line characteristics such as the type of line (SONET, T3, or E3), line signaling, and so on. Note See description of cnfcdsct for important planning considerations before you use upln. Cards on Which This Command Runs AXSM Syntax upln Syntax Description bay.line Identifies the bay (1 or 2) and the number of the line.
Chapter 3 Equipment and Resource Provisioning upport upport Up Port The upport command returns a logical port to the up state (or “ups” the port) so the port can again carry traffic. The upport command concludes possible re-configuration or troubleshooting steps. Before you execute upport, you must have downed the port by executing dnport. Throughout the sequence of downing and upping a port, the configuration for the port remains intact whether the logical port is a UNI or an NNI.
Chapter 3 Equipment and Resource Provisioning upport Cisco MGX 8850 Routing Switch Command Reference 3-108 Release 2.
C H A P T E R 4 ILMI Commands This chapter describes the ILMI commands. These commands let you add, delete, configure, display status, and create statistics for ILMI at the UNI and for PNNI. The chapter begins with a description of issues related to command entry, port identification, and so on. Position-Dependent and Keyword-Driven Parameters A command can include parameters that are keyword-driven or position-dependent.
Chapter 4 ILMI Commands Identifying Physical and Logical Elements Identifying Physical and Logical Elements The Private Network-to-Network Interface (PNNI) control protocol and the service modules use different formats to identify the same entity. For example, the format of a logical port that you enter on an AXSM is different from the format you would enter on the PXM45. This section describes these formats in the PNNI and AXSM contexts and how they correspond to each other.
Chapter 4 ILMI Commands Identifying Physical and Logical Elements • Subport corresponds to the resource partition on the AXSM. For a UNI or NNI, this resource partition is the same number as the logical port number (ifNum) on the AXSM. For a virtual network-to-network interface (VNNI), the number does not directly correspond to the For each physical port number, PNNI also generates a logical port number as an encrypted form of the physical port number.
Chapter 4 ILMI Commands addprfx addprfx Add Prefix—create an address prefix for a UNI or IISP The addprfx command lets you add an ATM prefix for ILMI to a UNI or IISP. Cards on Which This Command Runs Syntax addprfx Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 4-2 atm-prefix A 13-byte ATM prefix (26 hexadecimal characters).
Chapter 4 ILMI Commands clrilmicnt clrilmicnt Clear ILMI Counters Clears the ILMI statistics for a partition and logical interface (or port) on a service module. Cards on Which This Command Runs AXSM Syntax clrilmicnt Syntax Description ifNum Logical port number. On an AXSM, the range is 1–60. partId The range for partition identifier is 1–5.
Chapter 4 ILMI Commands cnfaddrreg cnfaddrreg Configure Address Registration This command lets you enable or disable ILMI address registration for a port. Before you can run cnfaddrreg, the following must have occurred: 1. The applicable port must have been created by running the addpnport command. 2. The port must be downed by running the dnpnport command. The cnfaddrreg command can also enable (or disable) the address registration for backward compatibility.
Chapter 4 ILMI Commands cnfautocnf cnfautocnf Configure Auto Configuration The cnfautocnf command enables or disables ILMI auto configuration for a port. To use this command, the port must be added but administratively down (via dnpnnport). With auto-configuration enabled, the ILMI slave side starts ILMI auto configuration to negotiate the ATM layer parameters with its peer while ports come up.
Chapter 4 ILMI Commands cnfilmi cnfilmi Configure ILMI The cnfilmi command lets you configure the card-level ILMI for the AXSM. Activating the card-level ILMI through cnfilmi requires a pre-existing logical port (see addport) and resource partition (see addrscprtn or addpart). No response appears unless an error occurs. Note For network-level ILMI in relation to PNNI, run the PNNI-specific ILMI commands on the PXM45.
Chapter 4 ILMI Commands cnfilmi Example Unknown.1.AXSM.a > cnfilmi 1 -id 1 -ilmi 1 -vpi 40 -vci 99 -s 10 -t 10 -k 10 Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 4 ILMI Commands cnfilmienable cnfilmienable Enables ILMI on a PNNI port. Prior to cnfilmienable, you must use dnpnport to de-activate the port. Cards on Which This Command Runs PXM45 Syntax cnfilmienable [yes | no] Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 4-2.
Chapter 4 ILMI Commands cnfilmienable Examples Enable ILMI on a PNNI port 1:1.1:2. First, disable the port by using dnpnport. M8850_DC.7.PXM.a > dnpnport 1:1.1:2 M8850_DC.7.PXM.a > cnfilmienable 1:1.1:2 yes M8850_DC.7.PXM.a > uppnport 1:1.1:2 M8850_DC.7.PXM.a > dsppnilmi 1:1.1:2 Port: 1:1.
Chapter 4 ILMI Commands cnfilmiproto cnfilmiproto Configure ILMI Protocol The cnfilmiproto command lets you configure how PNNI reacts to ILMI slave events. Use dsppnilmi to confirm changes to the prefix . Cards on Which This Command Runs PXM45 Syntax cnfilmiproto [-securelink {yes|no}] [-attachmentpoint {yes | [-modlocalattrstd {yes | no] no] Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 4-2.
Chapter 4 ILMI Commands cnfilmiproto Examples SanJose.7.PXM.a > cnfilmiproto 11:2.1.1 -securelink no -attachmentpoint no -modlocalattrstd yes Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 4 ILMI Commands dbgilmi dbgilmi Debug ILMI Use dbgilmi to debug ILMI functionality (such as address registration or auto configuration). Note VSI pass-through information is exchanged between only the controller (PNNI) and the switch.
Chapter 4 ILMI Commands delprfx delprfx Delete Prefix The delprfx command lets you delete an ILMI address prefix associated with a UN or IISP. Cards on Which This Command Runs PXM45 Syntax delprfx Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 4-2. atm-prefix A 13-byte ATM address prefix, specified as 26 hexadecimal characters.
Chapter 4 ILMI Commands dnilmi dnilmi Down ILMI The dnilmi command lets you de-activate (down) ILMI on a logical port so you can modify a configuration, troubleshoot, or run certain commands that require ILMI to be inoperative. Cards on Which This Command Runs AXSM Syntax dnilmi Syntax Description ifNum Logical port number. On an AXSM, the range is 1–60. partId The range for partition identifier is 1–5.
Chapter 4 ILMI Commands dspilmi dspilmi Display ILMI Display the configuration for the interim local management interface (ILMI) on a specific port. The information in the dspilmi output was configured through the cnfilmi command. Cards on Which This Command Runs AXSM Syntax dspilmi Syntax Description ifNum Logical port number. On an AXSM, the range is 1–60. partId The range for partition identifier is 1–5.
Chapter 4 ILMI Commands dspilmiaddr dspilmiaddr Display ILMI Address—displays ILMI registered port addresses. The dspilmiaddr command lets you display the ATM addresses registered by the peer via the ILMI address registration mechanism. Cards on Which This Command Runs PXM45 Syntax dspilmiaddr Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 4-2.
Chapter 4 ILMI Commands dspilmicnt dspilmicnt Display ILMI Counters Displays the ILMI counters for a particular resource partition on a particular logical port. Cards on Which This Command Runs AXSM Syntax dspilmicnt Syntax Description ifNum Logical port number. On an AXSM, the range is 1–60. partId The range for partition identifier is 1–5.
Chapter 4 ILMI Commands dspilmis dspilmis Display ILMI Configurations The dspilmis command lets you display the configuration of all interim local management interfaces (ILMIs) on the service module. Cards on Which This Command Runs AXSM Syntax dspilmis Related Commands cnfilmi, dspilmi, dspilmicnt Attributes Log: nolog State: active, standby Privilege: ANYUSER Examples Display all ILMIs on the current service module. pop20two.1.AXSM.a > dspilmis Sig.
Chapter 4 ILMI Commands dsppnilmi dsppnilmi Display PNNI ILMI Displays the ILMI information for a PNNI logical port. The ILMI state can be one of the following. Disable Protocol is not enabled on this port. NotApplicable This port is not accessible due to hardware-related conditions. LostConnectivity Protocol on listening port is not enabled. Note EnableNotUp This port is not accessible due to hardware. UpAndNormal This port is physically up, and the protocol is enabled.
Chapter 4 ILMI Commands dsppnilmi Examples Display the ILMI for port 6:1.1:1. For comparison, run the dspilmi command on the card in slot 6, Note that it contains information that corresponds to the dsppnilmi output. M8850_NY.7.PXM.a > dsppnilmi 6:1.1:1 Port: 6:1.
Chapter 4 ILMI Commands dspprfx dspprfx Display Prefix Display the ILMI address prefixes for a port. Cards on Which This Command Runs PXM45 Syntax dspprfx Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 4-2. Related Commands addprfx, delprfx Attributes Log: nolog State: active, standby Privilege: ANYUSER Examples Display all ILMI address prefixes for port 4:1.1:11. SanJose.7.PXM.
Chapter 4 ILMI Commands upilmi upilmi Up ILMI—activate ILMI on a resource partition. Use upilmi to activate interim local management interface (ILMI) for a particular resource partition on a logical port. Before running the upilmi command for the partition, you must: 1. Activate a line through the upln command and configure the line through cnfln 2. Create a logical port through the addport command 3.
Chapter 4 ILMI Commands upilmi M8850_NY.5.AXSM.a > dspilmi 1 1 Sig. Port ---1 rsrc Ilmi Sig Sig Ilmi S:Keepalive T:conPoll K:conPoll Part State Vpi Vci Trap Interval Interval InactiveFactor ---- ---- ---- ---- --- ------------ ---------- ---------1 On 0 16 Off 1 5 4 Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 4 ILMI Commands upilmi Cisco MGX 8850 Routing Switch Command Reference 4-26 Release 2.
C H A P T E R 5 PNNI Commands This chapter describes the private network to network (or node to network) interface (PNNI) commands. These commands apply to node addressing and routing on the Cisco MGX 8850 switch, Release 2.0. (For PNNI port and signaling commands, see the chapter, “Logical Node, Port, and Signaling Commands.
Chapter 5 PNNI Commands PNNI Addressing PNNI Addressing The PNNI addresses and identifiers contain fields that are common to each other and should match each other. If you change a field in one item, Cisco Systems advises you to change the corresponding field in the other item. For example, if you change the ATM address, you should change corresponding fields in the PNNI summary address and node identifier. Note that the peer group identifier does not share in this recommendation.
Chapter 5 PNNI Commands Position-Dependent and Keyword-Driven Parameters Position-Dependent and Keyword-Driven Parameters A command can include parameters that are keyword-driven or position-dependent. For position-dependent parameters, you must type parameters in the order they appear in the syntax description or on-line help. To create a logical port, for example, the position-dependent syntax is: addport
Chapter 5 PNNI Commands Identifying Physical and Logical Elements Table 5-1 Valid Line Numbers and Number of Bays for AXSM Card Types Front Card Speed Lines Bays AXSM-1-2488 OC-48 1 1 AXSM-4-622 OC-12 1–4 1–2 AXSM-16-155 OC-3 1–8 1–2 AXSM-16-T3E3 T3, E3 1–8 1–2 Identifying Physical and Logical Elements The Private Network-to-Network Interface (PNNI) control protocol and the service modules use different formats to identify the same entity.
Chapter 5 PNNI Commands Identifying Physical and Logical Elements PNNI Format The PNNI controller requires the following format to identify a physical port: [shelf.]slot[:subslot].port[:subport] The PNNI physical port identifier (physical port ID) consists of a series of mandatory elements. Note the period or colon associated with each element inside the square brackets. The elements of the physical port ID are as follows: • The shelf is always 1 for the current product and so is usually omitted.
Chapter 5 PNNI Commands addpnni-node addpnni-node Add PNNI Node—creates a PNNI logical node. The addpnni-node command creates an instance of a PNNI logical node on the switch.
Chapter 5 PNNI Commands addpnni-node ATM Address of the Node A switch-level ATM address consists of: • An eight-bit byte that identifies the format of the address. The format is either E.164 or the more common NSAP. • 19 8-bit bytes for an ATM address. • The last byte of the ATM address is the selector byte. • The Selector byte identifies the host application on the switch.
Chapter 5 PNNI Commands addpnni-node Figure 5-3 PNNI Logical Node Identifier ATM address ATM format address Cisco length MAC address MAC address ICD PNNI hierarchy 56 160 47 00 91 81 00 00 00 XX XX XX XX XX XX XX XX XX XX XX XX 00 level 1 1 1 2 1 3 6 6 Default PNNI node identifier 1 57115 # of Bytes Peer Group Identifier A peer group identifier (pgID) consists of: • A level that indicates how many bits out of the entire pgID field are actually used.
Chapter 5 PNNI Commands addpnni-node Syntax Description level The level specifies the level of the node in a PNNI hierarchy and does so by indicating the number of valid bits for a node ID (-nodeId parameter) or peer group ID (-pg-id parameter). In the current release, you can configure only one level. The level must be the same within the network. The maximum number of levels you can configure on a switch 10. This limit is meaningful only in a multi-peer group.
Chapter 5 PNNI Commands addpnni-node -pgId The peer group ID (pg-id) identifies a PNNI peer group. (A PNNI peer group consists of all logical nodes with matching pg-ids. In a group of single-peer nodes, each switch has one logical PNNI node.) The number of 8-bit bytes in the peer group ID (pg-id) is 14. However, the value of the level parameter is the number of bits that are actually used for the peer group ID.
Chapter 5 PNNI Commands addpnni-node Usage Guidelines All nodes ship with a default ATM address, node ID, and peer group ID. Cisco uses these defaults to set up and test the switch. Before the switch carries live traffic, you should specify new addresses. For this purpose, you can either use the cnfpnni-node command or clear the configuration then use the addpnni-node command. (You can clear the PNNI configuration by using either clrcnf or clrallcnf.
Chapter 5 PNNI Commands addpnni-summary-addr addpnni-summary-addr Add PNNI Summary Address—create a PNNI summary address to specify a range of addresses. The addpnni-summary-addr command lets you create a summary address for a logical node. The result of this operation is a range of addresses. The controller uses this summary to accept or reject calls that arrive at an address within the address range.
Chapter 5 PNNI Commands addpnni-summary-addr node-index The node index indicates the relative position of the logical node within a multi-peer group on the switch. The range is 1–10, and the lowest level is 1. If you do not have the node index, use dsppnni-node to see a list of all logical nodes and node indexes on the current switch. In the current release, the value of node-index must be ‘1’. Range: 1–10 Default: 1 addressprefix The summary address assigned to the node.
Chapter 5 PNNI Commands addpnni-summary-addr Related Commands delpnni-summary-addr, dsppnni-summary-addr Attributes Log: log State: active Privilege: SUPER_GP Example This example shows the addpnni-summary-addr command line that adds a PNNI address prefix, configured as follows: • The PNNI summary address is 47.0091.8100.0000.0030.9409.f1f1. • The length of the PNNI summary address is 104 bits. • This PNNI summary address contains only internal addresses.
Chapter 5 PNNI Commands aesa_ping aesa_ping ATM End Station Address Ping—confirm the connection from a node to an ATM End Station. The aesa_ping command lets you ping any ATM end station address (AESA) connected to a PNNI network. Use this command to check PNNI connectivity to the given destination address. You can use the optional arguments -setupcall, -qos, -trace, and -data to send packets and provide greater granularity to the information that the command sends to the screen.
Chapter 5 PNNI Commands aesa_ping -trace Specifies whether a path trace is enabled during the ping. The trace stops when the interval specified by -timeout elapses. yes: A path trace is enabled. no: No path trace is enabled. Default: no -data Specify whether data packets are sent with the ping. The data packets cease when the interval specified by -timeout elapses. yes: The data packets are sent. no: No data packets are sent. Default: disable -timeout Specify the connection timeout for ping.
Chapter 5 PNNI Commands aesa_ping Example This example shows the aesa_ping command line that pings the ATM end station with the address 47.00918100000000d058ac23ac.00d058ac23ac.01. The ping is configured as follows: • No call is set up. • The QoS metric is UBR. • No trace is enabled. • No data is sent with the ping. • The ping waits six seconds for a reply. • The ping re-occurs every 60 seconds unless it finishes. • The peak cell rate of the ping is five cells per second (cps).
Chapter 5 PNNI Commands cnfpnni-election cnfpnni-election Configure PNNI Election—configure a rank and other parameters for electing a peer group leader. The cnfpnni-election command lets you specify the priority of a node for the purpose of electing a peer group leader (PGL). By using this ranking, you can promote or prevent certain nodes for consideration for election as PGL. Note For a single-peer group, this command has no application.
Chapter 5 PNNI Commands cnfpnni-election Syntax Description node-index The node-index uniquely identifies the node within the hierarchy on the switch. Range: 1–10 Default: 1 -priority Specify the leadership priority within a peer group. Range: 1–20 Default: 0 -initTime Specify the number of seconds that this node delays advertising its choice of preferred PGL.
Chapter 5 PNNI Commands cnfpnni-election Example In the current release, this command has no meaning. Cisco MGX 8850 Routing Switch Command Reference 5-20 Release 2.
Chapter 5 PNNI Commands cnfpnni-intf cnfpnni-intf Configure PNNI Interface— specify administrative weight or logical link aggregation for a port. The cnfpnni-intf command lets you specify two distinct PNNI parameters. The aggregation token applies to a logical node, and the administrative weight (AW) applies to a port. Note Aggregation tokens do not apply in a single-peer group.
Chapter 5 PNNI Commands cnfpnni-intf Syntax Description If you enter -awall to specify an AW, it overrides the AW for all individual service types. t portid The PNNI physical port ID. The portid has the format [shelf.]slot[:subslot].port[:subport]. For more details about portid, see PNNI Format. Default: none -aggregationToken Specify a 32-bit number for logical link aggregation between a peer group leader and the lowest level.
Chapter 5 PNNI Commands cnfpnni-intf Usage Guidelines PNNI includes a protocol for routing the topology state. This protocol advertises details about the peer group links and nodes. Links and nodes are assigned attributes that can be used to diagnose and tune network behavior. The administrative weight (AW) for a port is an integer that has no units of measure. The switch compares the sum of all AWs along a path with the sum of all AWs along another path to determine which path is more cost-effective.
Chapter 5 PNNI Commands cnfpnni-link-selection cnfpnni-link-selection Configure PNNI Link Selection—specify the routing policies for parallel links. The cnfpnni-link-selection command specifies which routing policies are used to select one of the parallel links that connect a neighboring PNNI node. Neighboring node in this case means a directly connected node. The cnfpnni-link-selection command applies only if parallel links exist between the specified port and neighboring nodes.
Chapter 5 PNNI Commands cnfpnni-link-selection Related Commands dsppnni-link-selection Attributes Log: log State: active Privilege: SUPER_GP Example Specify maximum available cell rate as the routing policy for the link with port ID 4:1.1:11. Use dsppnni-link-selection to see the link selection policy on this port. Note that dsppnni-link-selection shows the logical port number for the physical port ID. SanJose.7.PXM.a > cnfpnni-link-selection 4:1.1:11 maxavcr SanJose.7.PXM.
Chapter 5 PNNI Commands cnfpnni-mtu cnfpnni-mtu Configure PNNI Maximum Transfer Unit— specify the maximum data packet size that the node supports. The cnfpnni-mtu command specifies the maximum data packet size in number of bytes. This command is useful for internetworking compatibility, for which you must match the maximum packet size of your peer group to a size that another peer group can support.
Chapter 5 PNNI Commands cnfpnni-node cnfpnni-node Configure PNNI Node—modify parameters for an existing PNNI node. The node-level cnfpnni-node command lets you: • Modify the parameters of an existing logical node. • Enable or disable a node. This ability applies to: – Parameters that require the node to be disabled before you can modify them (if you do not modify parameters that require a disabled node, you can modify one or more parameters with one execution of cnfpnni-node).
Chapter 5 PNNI Commands cnfpnni-node Cards on Which This Command Runs PXM45 Syntax cnfpnni-node [-atmAddr atm-address] [-level level] [-nodeId node-id] [-pgId pg-id] [-lowest {true | false}] [-enable {true | false}] [-transitRestricted {on | off}] [-complexNode{on | off}] [-branchingRestricted {on | off}] Syntax Description node-index The node index specifies the relative position of a logical node within the hierarchy of a multi-peer group. The lowest level is 1.
Chapter 5 PNNI Commands cnfpnni-node -nodeId Specify the PNNI node identifier assigned to a PNNI node. The node-id consists of the PNNI hierarchy level (-level) followed by the length of the ATM address (addaddr length) followed by the ATM address (-atmAddr). Note Before you change the node ID, you must first use the cnfpnni-node command one time with the parameter string -enable false to disable the node. After changing the node ID, run the command with the parameter string -enable true.
Chapter 5 PNNI Commands cnfpnni-node -complexNode Specify whether this node is a complex node. The lowest-level node cannot be a complex node. on: This node is a complex node. off: This node is not a complex node. Default: off Note -branchingRestricted This release does not support multiple peer groups, so this parameter must remain off. Specify whether the PNNI node allows point-to-multipoint branches. on: This node does not allow point-to-multipoint branches.
Chapter 5 PNNI Commands cnfpnni-node Figure 5-6 Cisco Factory-shipped Defaults for PNNI Peer Group Identifier, PNNI Summary Address, ATM Address, and PNNI Node Identifier ATM address ATM format address Cisco length MAC address MAC address ICD PNNI hierarchy 56 160 47 00 91 81 00 00 00 XX XX XX XX XX XX XX XX XX XX XX XX 00 level # of Bytes 1 1 2 1 1 3 6 6 1 Default PNNI peer group identifier Default PNNI summary address Default PNNI node identifier 53346 Default ATM address Usage Guideline
Chapter 5 PNNI Commands cnfpnni-node • The node is at the lowest level of the network PNNI hierarchy. • The node is enabled. • The node does not permit traffic to cross it on the way to other nodes. • The node is not a complex node. • The node permits branching. Use dsppnni-node to display the PNNI configuration values. SanJose.7.PXM.a > cnfpnni-node 1 -level 56 -nodeId 56:160:47.0091 81000000 00309409f1f1.00309409f1f1.01 -atmAddr 47.0091 81000000 00309409f1f1.00309409f1f1.01 -pgId 56:47.00.
Chapter 5 PNNI Commands cnfpnni-pkttrace cnfpnni-pkttrace Configure PNNI Packet Trace— specify the parameters to trace packets. This command applies to debugging. It causes the switch to check the PNNI packets transmitted and received at each peer. For example, if an interface is not receiving user-traffic, you can execute dsppnni-pktrace to display packet information that can help you find the level and type of blockage.
Chapter 5 PNNI Commands cnfpnni-pkttrace -portId The port ID in this instance has the format of the logical ID number. The format is a 32-bit encoded number in the range 1–2147483648. If you do not have the port ID in this form, use dsppnport and provide it with the common portID format of slot[:subslot].port[:subport}. The output of dsppnport shows the logical number for the port ID. Use this value is for the -portID parameter.
Chapter 5 PNNI Commands cnfpnni-routing-policy cnfpnni-routing-policy Configure PNNI Routing Policy— specify the routing policy parameters. The cnfpnni-routing-policy command specifies which routing policy values are used during UNI call setup. Routing policies control PNNI routing for your network.
Chapter 5 PNNI Commands cnfpnni-routing-policy Syntax Description -sptEpsilon The shortest path (SPT) epsilon you supply specifies a tolerance in the form of a percent that can influence which paths qualify as equal-cost during route calculation. A higher tolerance results in a broader range of path cost-values that can qualify as equal-cost.
Chapter 5 PNNI Commands cnfpnni-routing-policy -loadBalance The PNNI routing protocol relies on the load balance policy when it determines that the routes to a destination have equal cost. (PNNI determines routes to be identical according to the metrics in the AW, CDV, or CTD routing table.) Note that the SPT epsilon value can be a factor when PNNI calculates cost. The choice for load balancing is “random” or “maxbw.” Type the entire word.
Chapter 5 PNNI Commands cnfpnni-routing-policy -ctdBgTable Enable or disable the background routing table of CTD. The CTD parameter is the interval between a cell exiting the source PNNI node and entering the destination PNNI node. on: The background routing table of CTD is enabled. off: The background routing table of CTD is disabled. Default = on -cdvBgTable Enable or disable the background routing table of CDV.
Chapter 5 PNNI Commands cnfpnni-scope-map cnfpnni-scope-map Configure PNNI Scope Map Table—specify the table that maps the UNI 4.0 values to the PNNI hierarchy levels. The cnfpnni-scope-map command specifies how UNI 4.0 address scope values are mapped to PNNI hierarchal levels. These parameters are stored in the scope map table. Note This function requires support of UNI 4.0 and therefore is not supported in this release.
Chapter 5 PNNI Commands cnfpnni-scope-map Attributes Log: log State: active Privilege: SUPER_GP Example This command is not supported by the current release. Cisco MGX 8850 Routing Switch Command Reference 5-40 Release 2.
Chapter 5 PNNI Commands cnfpnni-svcc-rcc-timer cnfpnni-svcc-rcc-timer Configure PNNI Switched Virtual Connection Routing Control Channel (SVCC-RCC) Timer—specify the parameters for any PNNI RCCs between logical nodes. The current release does not support this command. The cnfpnni-svcc-rcc-timer command lets you specify the initial PNNI SVCC-based variables for a network node. Logical group nodes (LGNs) use SVCC-RCCs to exchange routing information.
Chapter 5 PNNI Commands cnfpnni-svcc-rcc-timer -callingIntegrityTime The number of seconds the node waits while it attempts to set up an SVCC as the calling party. If the SVCC is not fully established within this time period, the node tears down the connection. Range: 5–300. Default = 300. -calledIntegrityTime The number of seconds the node waits while it attempts to set up an SVCC as the called party. If the SVCC is not fully established within this time period, the node tears down the connection.
Chapter 5 PNNI Commands cnfpnni-timer cnfpnni-timer Configure PNNI Timers The cnfpnni-timer command specifies the initial PNNI timer values and significant change thresholds of a PNNI node in the network. Note Use of this command must be carefully planned because modifying a timer can significantly change network efficiency.
Chapter 5 PNNI Commands cnfpnni-timer -helloHolddown Specify the initial value for the Hello hold down timer that the node uses to limit the rate at which it sends Hellos. Units: 100 ms. 1 = 0.1 seconds Range: 0.1–1000 Default = 10, (1 second) -helloInterval Specify the initial value for the Hello timer in seconds. The value limits the rate at which the node sends Hellos. Range: 1–300 seconds. Default = 15 seconds.
Chapter 5 PNNI Commands cnfpnni-timer -avcrMt Specify the minimum threshold used in the algorithms that determine significant change for available cell rate (AvCR) parameters which are expressed as a percentage. You can change this value to minimize the overhead created by advertisements triggered by AVCR changes. avcr-mt is expressed as a percentage. Range: 1–99 per cent. Default = 3 per cent.
Chapter 5 PNNI Commands cnfpnni-timer Example This example shows the cnfpnni-timer command line that is set with the following parameter values: • The node broadcasts Hello packets every 1.2 seconds. • The node broadcasts Hello packets every 1.2 seconds. • The node Hello timer is 15 seconds. • The node hello-inactivity-factor is 5 seconds. • The node recreates PTSEs every 1800 seconds (30 minutes).
Chapter 5 PNNI Commands dbgpnni dbgpnni Debug PNNI Messages— specify which PNNI debug messages are enabled. The dbgpnni command lets you specify the types of debug messages that appear in the display of the dsppnni-dbg command. Note The selections you make with this command can significantly affect network performance. The simultaneous dumping of multiple types of debug messages can increase the overhead more than incrementally as each dump is added.
Chapter 5 PNNI Commands dbgpnni -nbr Specify whether the PNNI neighbor FSM debug messages go to the console. on: The PNNI neighbor FSM messages go to the console. off: The PNNI neighbor FSM debug messages do not go to the console. Default: none -election Specify whether the PNNI PGL election debug messages go to the console. on: The PNNI PGL election messages go to the console. off: The PNNI PGL election debug messages do not go to the console.
Chapter 5 PNNI Commands dbgpnni -spt Specify whether the shortest path tree debug messages go to the console. on: The shortest path tree debug messages go to the console. off: The shortest path tree debug messages do not go to the console. Default: none -ra Specify whether the route agent debug messages go to the console. on: The route agent debug messages go to the console. off: The route agent debug messages do not go to the console.
Chapter 5 PNNI Commands dbgpnni Example Specify the following PNNI debug message-options: • Interface debugging is enabled. • Address handling debugging is enabled. Use dsppnni-dbg to check which debug messages types appear on the terminal. SanJose.7.PXM.
Chapter 5 PNNI Commands delpnni-node delpnni-node Delete PNNI Node–delete a PNNI node from the PNNI network topology. The delpnni-node command removes a PNNI node from the PNNI network topology. A node that this command deletes can be restored with the related command addpnni-node. Confirm the deletion of nodes with the dsppnni-node command.
Chapter 5 PNNI Commands delpnni-summary-addr delpnni-summary-addr Delete PNNI Summary Address—delete a PNNI summary address from the node. The delpnni-summary-addr command deletes a PNNI summary address for a PNNI node. Cards on Which This Command Runs PXM45 Syntax delpnni-summary-addr Syntax Description node-index In the current release, the only supported value for node-index 1.
Chapter 5 PNNI Commands dsppnni-bn-path dsppnni-bn-path Display PNNI Border Node Paths— display the PNNI border node paths. This debugging command displays the border node-to-border node paths of the immediate child-peer-group of the logical group nodes (LGN). Note The command applies to multi-peer groups only.
Chapter 5 PNNI Commands dsppnni-bn-path destination node ID The node ID of each destination.
Chapter 5 PNNI Commands dsppnni-bn-path Example Enter dsppnni-db-path and specify node index 2. mpg2.7.PXM.a > dsppnni-bn-path 2 node index:2 source node IDB index --------------------1 source node id -------------------------------------------------56:160:47.009181000000003071f80e56.003071f80e56.
Chapter 5 PNNI Commands dsppnni-bypass dsppnni-bypass Display PNNI Bypasses—display the PNNI complex node bypass table. This debugging command displays the PNNI bypass table for a logical group node (LGN) that uses the complex node representation of its peer group. The bypass table contains the topology and Hello information of every node in the peer group. Note This command applies to multi-peer groups only.
Chapter 5 PNNI Commands dsppnni-bypass Related Commands None Attributes Log: nolog State: active, standby Privilege: ANYUSER Example Display the bypass table for an LGN using complex node representation in the peer group. Geneva.7.PXM.a > dsppnni-bypass node index: 1 Input portId........ 376 Output portId........ 399 Ptse id............. 12 Flags................
Chapter 5 PNNI Commands dsppnni-dbg dsppnni-dbg Display PNNI Debug Flags—display the settings of all PNNI debug flags. The dsppnni-dbg command displays which PNNI debug options are enabled and which are disabled. Cards on Which This Command Runs PXM45 Syntax dsppnni-dbg Display Contents This section describes the content of the display for each node. The right column shows the label for each value that appears in the dsppnni-dbg command.
Chapter 5 PNNI Commands dsppnni-dbg node reachability Display the flag that indicates whether the node reachability debug is enabled. on: the node reachability debug is enabled. off: the node reachability debug is disabled. address Display the flag that indicates whether the addressing debug is enabled. on: the addressing debug is enabled. off: the addressing debug is disabled. itdb Display the flag that indicates whether the internal data base debug is enabled.
Chapter 5 PNNI Commands dsppnni-election dsppnni-election Display PNNI Election—display information for election a peer group leader. The dsppnni-election command displays parameters and current status related to the election of a peer group leader (PGL). This command and related information applies to multi-peer groups only. The cnfpnni-election command lets you specify election parameters. In a multi-peer group environment, each peer group can elect one PGL.
Chapter 5 PNNI Commands dsppnni-election Override delay The number of seconds that this node waits for itself to be declared the preferred PGL by unanimous agreement among its peers. Re-election time After losing connectivity to the current peer group leader, the number of seconds that this node waits before re-starting the process of electing a new peer group leader. Preferred PGL The ID of the node that should be the PGL according to the current node.
Chapter 5 PNNI Commands dsppnni-idb dsppnni-idb Display PNNI Internal Data Base—display the PNNI link-state information for the node. The dsppnni-idb command applies solely to debugging. It lets you see all the nodes and links that the current node has discovered. If a node or link should be in the internal database (IDB) but is missing, you can check the PTSEs (dsppnni-ptse) to begin tracing the missing topology information.
Chapter 5 PNNI Commands dsppnni-idb Syntax Description node-index The node index is the system-generated number of the local logical node. In a multi-peer group hierarchy, the range is 1–10. In the current release, the only node index is 1. Range: 1–10 -nodeNumbe A number that uniquely identifies a node in the network. For a list of the remote r node numbers that are visible to the local node, use dsppnni-node-list. Range: 1–256 -portId The logical number for a PNNI port.
Chapter 5 PNNI Commands dsppnni-inducing-uplink dsppnni-inducing-uplink Display PNNI Inducing Uplink—display the PNNI inducing uplink database. The dsppnni-inducing-uplink command displays the uplink-inducing database. The only application of dsppnni-inducing-uplink is debugging. Note This command applies to multi-peer groups only, so it has no purpose in the current release.
Chapter 5 PNNI Commands dsppnni-inducing-uplink Related Commands None Attributes Log: nolog State: active, standby Privilege: ANYUSER Example Display the inducing uplink for the level whose node index is 2. mpgses3.2.PXM.a > dsppnni-inducing-uplink 2 node index:2 Token................ 0 Child node portId.... 66560 Child node number.... 1 Upnode id.............32:56:47.009181001100000000000001.003071f80e56.00 Upnode ATM addr.......47.009181000000003071f80e56.003071f80e56.02 Upnode PG id..........
Chapter 5 PNNI Commands dsppnni-intf dsppnni-intf Display PNNI Interface— display the PNNI aggregation token and AW for a port. This command displays the following information for a PNNI port: • Aggregation token. The current release does not support the aggregation token. • Administrative weight (AW). • The logical port identifier assigned to the physical port identifier.
Chapter 5 PNNI Commands dsppnni-intf AW-CBR Display the AW for constant bit rate (CBR) connections on this interface. While a cbr connection is active, this option limits its bit rate to a static value that remains available until the connection is torn down. The bit rate is characterized by the peak cell rate (PCR) value. Range: 0–4194304 AW-ABR Display the AW for available bit rate (ABR) connections on this interface.
Chapter 5 PNNI Commands dsppnni-intf Attributes Log: log State: active, standby Privilege: ANYUSER Example Display the interface configuration for port 4:1.1:11. The current release does not support the link aggregation parameter (displayed as “Aggr token”), so it appears as a 0. SanJose.7.PXM.a > dsppnni-intf 4:1.1:11 Physical port id: 4: 1.1:11 Aggr token.......... AW-CBR.............. AW-RTVBR............ 0 5040 5040 Logical port id: 17045515 AW-NRTVBR........... AW-ABR.............. AW-UBR.....
Chapter 5 PNNI Commands dsppnni-link dsppnni-link Display PNNI Link Table– display the values of the PNNI link table. The dsppnni-link command displays the parameters of all PNNI links. • If you specify a node index and a port ID, the command displays information about that specific PNNI link. • If you specify only a node index, the display shows all PNNI links attached to that node. • If you specify nothing, the command displays all links attached to all PNNI nodes in the network.
Chapter 5 PNNI Commands dsppnni-link Example Specify node index 1 and port 1:1.2:2. p2spvc5.7.PXM.a > dsppnni-link 1 1:1.2:2 node index :1 Local port id: 16848898 Remote port id: 16848898 Local Phy Port Id:1:1.2:2 Type. lowestLevelHorizontalLink Hello state....... twoWayInside Derive agg........... 0 Intf index........... 16848898 SVC RCC index........ 0 Hello pkt RX......... 2 Hello pkt TX......... 2 Remote node name.......p2spvc6 Remote node id.........56:160:47.00918100000000309409f1ef.00309409f1ef.
Chapter 5 PNNI Commands dsppnni-link-selection dsppnni-link-selection Display PNNI Link Selection—display the PNNI link setting, physical port identifier, and logical port identifier. The dsppnni-link-selection command displays the link selection and both the physical and logical identifiers for that link. Refer to the description of cnfpnni-link-selection for information about the criteria PNNI uses to choose between two parallel links.
Chapter 5 PNNI Commands dsppnni-link-selection Example Displays the link selection for a parallel link on port 4:1.1:11. This link uses the default of minaw. Note that the display also shows the logical port number for the physical port ID. SanJose.7.PXM.a > dsppnni-link-selection 4:1.1:11 physical port id: logical port id: 4:1.1:11 17045515 link selection: minaw SanJose.7.PXM.a > Cisco MGX 8850 Routing Switch Command Reference 5-72 Release 2.
Chapter 5 PNNI Commands dsppnni-mtu dsppnni-mtu Display PNNI Maximum Transfer Unit—display maximum supported size of the PNNI data packet. The dsppnni-mtu command displays the maximum PNNI packet size in number of bytes. This command is primarily for configuring internetwork compatibility, but you can use it in lab trials to test the affect of various packet sizes on the performance of the peer group. Use cnfpnni-mtu to specify the PNNI packet size configuration.
Chapter 5 PNNI Commands dsppnni-neighbor dsppnni-neighbor Display PNNI Neighbor— display all PNNI nodes that directly connect to this node. The dsppnni-neighbor command displays all the PNNI nodes that are directly connected to the switch. • If you specify: both node-index and rmt-node-id, the command displays information about the rmt-node-id neighbors. • If you specify nothing, the command displays all neighbors attached this switch.
Chapter 5 PNNI Commands dsppnni-neighbor Neighbor state FULL?? Port count The number of ports. SVC RCC index The index for the SVC routing control channel. RX DS pkts The number of received signal packets in the receive direction. The current release does not support SVCC RCC, so this value is ‘0.’ TX DS pkts The number of transmitted signal packets in the transmit direction. RX PTSP pkts The number of PNNI topology state packets in the receive direction.
Chapter 5 PNNI Commands dsppnni-neighbor Example Display information about all neighboring PNNI nodes (with no optional parameters). Geneva.7.PXM.a > dsppnni-neighbor node index : 1 node name : Paris Remote node id: 56:160:47.00918100000000107b65f27c.00107b65f27c.01 Neighbor state: FULL Port count.......... 4 SVC RCC index....... 0 RX DS pkts.......... 3 TX DS pkts.......... 3 RX PTSP pkts........ 6032 TX PTSP pkts........ 2061 RX PTSE req pkts.... 2 TX PTSE req pkts.... 1 RX PTSE ack pkts....
Chapter 5 PNNI Commands dsppnni-node dsppnni-node Display PNNI Node—display the PNNI node information address and routing information. The dsppnni-node command displays the PNNI logical node information on the local switch. If you do not provide an index number, the output shows all logical nodes on the switch. However, in the current release, the display always shows only one logical node—with index number 1.
Chapter 5 PNNI Commands dsppnni-node Display Contents Cisco factory-set defaults for address prefixes and the peer group ID share field-values with the ATM address. (See Figure 5-7.
Chapter 5 PNNI Commands dsppnni-node Restricted transit Display the flag that indicates whether transit is restricted across this node. This value can be set to off to secure the node, or to minimize traffic handled by the node if it is of either low-capacity or high-criticality. on: Calls can transit across this node. off: Only calls terminating on end-systems supported by this node can access this node. Complex node Indicates whether this node is a complex node.
Chapter 5 PNNI Commands dsppnni-node ATM address For the constituents of the ATM address, see the description of addpnni-node or cnfpnni-node. Before you change the ATM address, disable the nod by executing cnfpnni-node -enable false. See description of cnfpnni-node Peer group id Display the -pgId of length level that is assigned to the PNNI node. The peer group is the PNNI local group.The peer group consists of all PNNI nodes with matching pg-id values.
Chapter 5 PNNI Commands dsppnni-node-list dsppnni-node-list Display PNNI Nodes List— display a list of all learned PNNI nodes in the network. The dsppnni-node-list command lists the PNNI nodes in the network that are visible to the current switch. For a single-peer group (SPG), the displayed nodes exist at one level. For a multi-peer group (MPG), the list contains all nodes on the current switch and all nodes that are visible to every node on the current switch.
Chapter 5 PNNI Commands dsppnni-node-list Display Contents for the dsppnni-node-list Command This section describes the contents of a node list. For a multi-peer group (not applicable in the current release), it also describes how the display changes from one level of a hierarchy to a higher level. Although the description relates primarily to the example of a multi-peer network diagram in Figure 5-8, the information also substantially applies to the example SPG that follows the MPG example.
Chapter 5 PNNI Commands dsppnni-node-list 3. For levels above the lowest, the node index is appended to the name of the switch. See the node name column in the display for a multi-peer group in the Example section. For the definition of a node index, see the description of the dsppnni-node command.
Chapter 5 PNNI Commands dsppnni-node-list Figure 5-9 A List of Nodes in a Multi-Peer Group mpglax1.1.PXM.a > dsppnni-node-list node # node id node name level ------- -------------------------------------------------- ---------- ------1 56:160:47.009181000000003071f80e4a.003071f80e4a.01 mpglax1 56 node # node id node name level ------- -------------------------------------------------- ---------- ------3 48:56:47.339181000000000000000000.003071f80833.
Chapter 5 PNNI Commands dsppnni-node-list mpglax1.1.PXM.a > dsppnni-node-list node # node id node name level ------- -------------------------------------------------- ---------- ------1 56:160:47.009181000000003071f80e4a.003071f80e4a.01 mpglax1 56 node # node id node name level ------- -------------------------------------------------- ---------- ------3 48:56:47.339181000000000000000000.003071f80833.
Chapter 5 PNNI Commands dsppnni-node-list Example of SPG Display the node list for a single-peer group. Note that the level for each node is 56. Geneva.7.PXM.a > dsppnni-node-list node # node id node name level ------- -------------------------------------------------- ---------- ------1 56:160:47.009181000000001029300121.001029300121.01 pswpop6 56 node # node id node name level ------- -------------------------------------------------- ---------- ------2 56:160:47.00918100000000c043002de1.00c043002de1.
Chapter 5 PNNI Commands dsppnni-path dsppnni-path Display PNNI Path—display the pre-computed path tables. The dsppnni-path command displays the pre-computed paths between the source (the current node) and the destination nodes. The system has determined these paths to be the best or optimal paths for various service classes according to one of three metrics. These metrics are the administrative weight (AW), the cell transfer delay (CTD), or the cell delay variation (CDV).
Chapter 5 PNNI Commands dsppnni-path aw Specify administrative weight as the routing metric. The possible service classes associated with AW are CBR, rt-VBR, nrtVBR, and UBR. ctd Specify cell transfer delay as the metric. The possible service classes are CBR, rt-VBR, or nrt-VBR. cdv Specify cell delay variation as the metric. The possible service classes are CBR and rt-VBR. node-index The node index is a number in the range 1–256 that uniquely identifies a switch within a PNNI network.
Chapter 5 PNNI Commands dsppnni-path Examples The routing criteria for both examples is UBR service with routing metric AW. First, display the pre-computed paths between the current source and the node with index number 5. Thereafter, enter dsppnni-path but do not include an index number so the display shows all paths. SanJose.7.PXM.a node #/PortId --------------D 5/ 0 S 1/ 17045505 > dsppnni-path aw ubr 5 node id -------------------------------------------------56:160:47.00918100000000309409f160.
Chapter 5 PNNI Commands dsppnni-path node #/PortId --------------D 4/ 0 3/ 16848897 2/ 17438721 S 1/ 17504257 node id -------------------------------------------------56:160:47.00918100000000309409f23c.00309409f23c.01 56:160:47.00918100000000301a431c19.00301a431c19.01 56:160:47.00918100000000309409f2aa.00309409f2aa.01 56:160:47.00918100000000309409f1f1.00309409f1f1.
Chapter 5 PNNI Commands dsppnni-path node #/PortId --------------D 7/ 0 11/ 16848918 3/ 16848917 2/ 17176577 S 1/ 17504257 node id -------------------------------------------------56:160:47.00918100000000001a531c01.00001a531c01.01 56:160:47.00918100000000001a531c83.00001a531c83.01 56:160:47.00918100000000301a431c19.00301a431c19.01 56:160:47.00918100000000309409f2aa.00309409f2aa.01 56:160:47.00918100000000309409f1f1.00309409f1f1.
Chapter 5 PNNI Commands dsppnni-pkttrace dsppnni-pkttrace Display Packet Trace—display the parameters of a particular packet trace configuration. This command applies to debugging only. The dsppnni-pkttrace command displays the packet-trace settings. These settings are configured by the cnfpnni-pkttrace command. You can use a packet trace to examine the contents of the PNNI Hello packets that are exchanged between two neighboring peers. Note This command is very intrusive.
Chapter 5 PNNI Commands dsppnni-pkttrace Related Commands cnfpnni-pkttrace Attributes Log: nolog State: active Privilege: CISCO_GP Example First, configure the following packet trace parameters through cnfpnni-pkttrace: • The direction is transmit. • The node index is 1. • The logical port identifier is 17373186. If you do not have the logical port identifier, use the dsppnport command to see the logical port number derived from the physical port number.
Chapter 5 PNNI Commands dsppnni-ptse dsppnni-ptse Display PNNI topology state element—displays PTSE tables. The dsppnni-ptse command displays PNNI topology state elements (PTSEs). The purpose of this command is troubleshooting, and it requires familiarity with the ATM Forum PNNI 1.0 specification. Without knowledge of this specification, the usefulness of dsppnni-ptse is minimal.
Chapter 5 PNNI Commands dsppnni-ptse Cards on Which This Command Runs PXM45 Syntax dsppnni-ptse [node-index [node-id [ptse-id]]] [-detail {true | false}] Syntax Description Note The parameters node-index, node-id, and ptse-id are nested. Therefore, you cannot enter node-id without node-index, nor can you enter ptse-id without node-index and node-id. node-index A unique, network-wide node identifier. This system-generated number has a range of 1–256. Range: 1–256.
Chapter 5 PNNI Commands dsppnni-ptse PTSE ID The unique identifier of the PTSE. ptse-id is a 32 bit number index assigned by the PNNI node that created the PTSE. PTSE type The type of PTSE is an ASCII designated by the ATM forum PNNI standard. Broad and narrow categories. Nodal State Parameter Information internal reachable ATM addresses A list of reachable ATM addresses that are inside the peer group or network.
Chapter 5 PNNI Commands dsppnni-ptse next higher level binding information IG length A 16-bit number. The current release does not support higher level binding. parent LGN id The parent LGN ID is a 22-byte hex string. The current release does not support logical group numbers (LGNs). parent LGN ATM address The parent LGN ATM address is a 20-byte, hex string. The current release does not support group numbers (LGNs). parent PG id The peer group ID (of length level) assigned to the parent PG.
Chapter 5 PNNI Commands dsppnni-ptse scope The UNI 4.0 address scope. Note The current release does not support UNI 4.0, so the scope is ‘0’. address info length The length of the address information—an eight-bit number. address count The number of reachable addresses—a 16-bit number. reachable address prefixes Display any PNNI summary address reachable by the node. The length of addressprefix is set by prefixlength.
Chapter 5 PNNI Commands dsppnni-ptse remote node id The node ID of the remote node. For a description of the node ID, see the description for addpnni-node or cnfpnni-node. remote port id The logical PNNI identifier on the remote interface. For more details, see PNNI Format. Range: 1–2147483648 local port id The logical PNNI identifier on the local interface. For more details, see PNNI Format.
Chapter 5 PNNI Commands dsppnni-ptse Resource Availability IG Parameters type Indication of bi-directional resource availability information group (RAIG) length A 16-bit number. flags A 16-bit number. aw The bandwidth used by AW metric cells in cells per second. Range: 1–2147483648. ctd The bandwidth used by CTD metric cells in cells per second. Range: 1–2147483648. cdv The bandwidth used by CDV metric cells in cells per second. Range: 1–2147483648.
Chapter 5 PNNI Commands dsppnni-ptse crm The cell rate margin (CRM) is a measure of the difference between the effective bandwidth allocation and the allocation for sustainable cell rate. It is a safety margin allocated above the aggregate sustainable cell rate for nrt-VBR and rt-VBR. This feature has little impact on traffic management. The ATM Forum does not require support for CRM, and Cisco Systems currently does not support it on the Cisco MGX 8850 and SES products. Range: 1–2147483648.
Chapter 5 PNNI Commands dsppnni-ptse Type................ Sequence number..... PTSE id............. PTSE type........... Type................ Reserved............ Input port id....... 64 Length.............. 1200 1 Checksum............ 94d 2 Remaining lifetime.. 2997 Nodal State Parameter( 96) 96 Length.............. 65 0 Flags............... 0 48 Output port id...... 12 For the second example, specify the following parameters: • The node-index is 1. • The node-id is 56:160:47.
Chapter 5 PNNI Commands dsppnni-ptse As directed at the beginning of this example, display details for PTSE 19. M8850_NY.7.PXM.a > dsppnni-ptse 2 48:56:4700918100000200000000000000036b5e30cd00 19 -detail true node index: 2 originating node name: M8850_NY-02 originating node id: 48:56:47.009181000002000000000000.00036b5e30cd.00 Type................ 64 Length.............. 52 Sequence number..... 152 Checksum............ bba PTSE id............. 19 Remaining lifetime.. 2389 PTSE type...........
Chapter 5 PNNI Commands dsppnni-reachable-addr dsppnni-reachable-addr Display PNNI Reachable Addresses— displays the reachable PNNI addresses in the peer group. This command displays all the reachable addresses and address prefixes in the peer group. For a description of the items in the display, refer to the section, “Display Contents for dsppnni-reachable-addr.
Chapter 5 PNNI Commands dsppnni-reachable-addr Display Contents for dsppnni-reachable-addr The table contains all reachable addresses within a peer group comes from the internal data base (IDB). scope Note The UNI 4.0 address scope. Refer to ATM forum documentation for a description of these scopes. The current release does not support UNI 4.0, so scope currently is always ‘0’. Range port id The logical port identifier.
Chapter 5 PNNI Commands dsppnni-reachable-addr Examples Display the reachable addresses that directly connect to this node: the parameter is local. Geneva.7.PXM.a > dsppnni-reachable-addr local scope............... 0 port id.............4294967295 Exterior............ false ATM addr prefix.....47.0091.8100.0000.0030.ff0f.ef38.0000.010b.180b/152 scope............... 0 port id.............4294967295 Exterior............ false ATM addr prefix.....47.0091.8100.0000.0030.ff0f.ef38.0000.010b.1816/152 scope....
Chapter 5 PNNI Commands dsppnni-reachable-addr AW MaxCR AvCR CTD CDV CLR0 CLR0+1 CRM VF CBR -----5040 351500 290935 41 10 10 8 n/a n/a RTVBR -----5040 351500 290935 41 10 8 8 n/a n/a backward direction NRTVBR ABR ----------5040 5040 351500 351500 290935 290935 41 n/a n/a n/a 6 n/a 8 n/a n/a n/a n/a n/a UBR -----5040 351500 290935 n/a n/a n/a n/a n/a n/a scope............... 0 Advertising node number 8 Exterior............ false ATM addr prefix.....47.0091.8100.0000.0010.7b65.
Chapter 5 PNNI Commands dsppnni-routing-policy dsppnni-routing-policy Display PNNI Routing Policy—display the PNNI routing policy parameters. The dsppnni-routing-policy command displays the parameters associated with the current routing policy for this node. The displayed parameters determine: Caution • The tolerance of cost-calculations. • The frequency of routing table generation. • The type of load balancing that is specified. • The type of on-demand routing that is specified.
Chapter 5 PNNI Commands dsppnni-routing-policy Display Contents This section lists the displayed information for each node. The display shows the configuration that results from cnfpnni-routing-policy. SPT epsilon This parameter is meaningful primarily for crankback. The epsilon you supply specifies a tolerance in the form of a percent that can influence which paths qualify as equal-cost during route calculation.
Chapter 5 PNNI Commands dsppnni-routing-policy On demand routing The current rule for on-demand routing is firstfit or bestfit. The firstfit routing policy selects the first route found that goes to the destination. The time for finding a route is the least possible, but the optimal route may not be selected. The bestfit policy selects a route based on: SPT path holddown time • The least-cost route, where the sum of all administrative weights in both directions of the route must be less than maxCost.
Chapter 5 PNNI Commands dsppnni-routing-policy Attributes Log: nolog State: active, standby Privilege: ANYUSER Example Display the parameters associated with the current routing policy for this node. Geneva.7.PXM.a > dsppnni-routing-policy SPT SPT SPT CTD epsilon......... holddown time... path holddown time Background Table 0 1 2 on Load balance........ On demand routing... AW Background Table CDV Background Table random best fit on on Geneva.7.PXM.
Chapter 5 PNNI Commands dsppnni-scope-map dsppnni-scope-map Display Scope Map—display the PNNI scope map table. The dsppnni-scope-map command displays the table that maps UNI 4.0 scope to PNNI hierarchy level. Note The scope map table requires UNI 4.0 support, so this command is not useful in the current release. Cards on Which This Command Runs PXM45 Syntax dsppnni-scope-map Objects Displayed: Displays the entire scope map table.
Chapter 5 PNNI Commands dsppnni-spoke dsppnni-spoke Display PNNI Spoke—display the PNNI complex node default advertisement values. Note This debugging command does not apply to single-peer groups. The dsppnni-spoke command displays how the UNI 4.0 address scope values map to the PNNI hierarchal levels. It displays the PNNI default spoke for a logical group node (LGN) using complex node representation in a given peer group (PG). The spoke is the conceptual “radius” of the peer group.
Chapter 5 PNNI Commands dsppnni-spoke AW-CBR The administrative weight for CBR connections on this interface. While a CBR connection is active, this option limits its bit rate to a static value that remains available until the connection is torn down. The bit rate is characterized by the peak cell rate (PCR) value. Range: 0–4194304 AW-ABR The administrative weight for available bit rate (ABR) connections on this interface. Specify the 24 bit number AW for ABR on this interface.
Chapter 5 PNNI Commands dsppnni-summary-addr dsppnni-summary-addr Display PNNI Summary Address—display the PNNI summary addresses. The dsppnni-summary-addr command displays all summary addresses at the specified degree of granularity. • If you specify node-index, the command displays the PNNI summary addresses of the node-index PNNI node. • If you do not specify node-index, the command displays PNNI summary addresses for all local nodes on network.
Chapter 5 PNNI Commands dsppnni-summary-addr State This system-generated ASCII string indicates the advertisement state. Possible states: “advertising,” “notadvertised,” or “inactive” Summary address The ATM PNNI summary address assigned to the network. The default is a combination of the peer group ID appended with the switch MAC address. prefixlength The length of the summary address-prefix in number of bits, equal or less than 152 bits.
Chapter 5 PNNI Commands dsppnni-svcc-rcc dsppnni-svcc-rcc Display PNNI Switched Virtual Connection Routing Control Channel (SVCC-RCC)— display the PNNI SVC-based RCC table. The dsppnni-svcc-rcc command displays the SVCC-RCC connection and packet values. If you specify: • Both node-index and svc-index, the display shows information about an SVCC-based RCC. • Only node-index, the display shows all SVC-based RCCs attached to the svc-index node.
Chapter 5 PNNI Commands dsppnni-svcc-rcc Example This command is not supported by the current release. This example shows the dsppnni-svcc-rcc command line that displays SVC-based RCCs. Geneva.7.PXM.a > dsppnni-svcc-rcc node index: 1 svc index: 33 Hello pkt RX........ 34 SVCC VPI............ 34 Hello pkt TX........ 34 SVCC VCI............ 128 Hello state........... 2wayOutside Remote node id.........56:160:39.840f80113744000000400202.00107b0efe01.00 Remote node ATM addr...39:840f.8011.3744.0000.0040.
Chapter 5 PNNI Commands dsppnni-svcc-rcc-timer dsppnni-svcc-rcc-timer Display PNNI Switched Virtual Connection Routing Control Channel (SVCC-RCC) Timer Values—display the PNNI SVCC-based RCC timer values. The dsppnni-svcc-rcc-timer command displays the SVCC-RCC timer values that are set by the cnfpnni-svcc-rcc-timer command. Note This command applies to multi-peer groups only.
Chapter 5 PNNI Commands dsppnni-svcc-rcc-timer Calling party integrity time Display the value of callingIntegrityTime, which limits wait times for establishing an SVCC as a called party. After the node has decided to accept an SVCC as the called party, the calledIntegrityTime variable specifies the interval (in sec) that this node will wait for an SVCC to become fully established before giving up and tearing down the connection.
Chapter 5 PNNI Commands dsppnni-timer dsppnni-timer Display PNNI Timer— display the PNNI timer values. The dsppnni-timer command displays the nodal timer values configured through the cnfpnni-timer command. If you provide a node index with the command, the output contains information for that particular node rather than all logical nodes on the switch.
Chapter 5 PNNI Commands dsppnni-timer Hello inactivity factor The Hello inactivity factor figures in the generation of a time period that a neighbor is considered alive after the local receives the last Hello packet from that neighbor. This period is in seconds and is the product of the hello-inactivity-factor and the peer-neighbor hello-interval. PTSE lifetime factor The value for the lifetime multiplier is a percentage.
Chapter 5 PNNI Commands dsppnni-timer Example Display PNNI timer values. Since the value of node-index = 1, the command line displays the PNNI timer values for only node 1. SanJose.7.PXM.a > dsppnni-timer 1 node index: 1 Hello holddown(100ms)... 120 PTSE holddown(100ms)... 120 Hello int(sec).......... 15 PTSE refresh int(sec).. 1800 Hello inactivity factor. 5 PTSE lifetime factor... 200 Retransmit int(sec)..... 5 AvCR proportional PM.... 3 CDV PM multiplier...... 25 AvCR minimum threshold..
Chapter 5 PNNI Commands dsppnni-timer Cisco MGX 8850 Routing Switch Command Reference 5-124 Release 2.
C H A P T E R 6 Logical Node, Port, and Signaling Commands This chapter describes primarily the PNNI commands that apply to PNNI ports. It also contains some node-level commands, such as a variety of commands that relate to node-level congestion thresholds. In general, the commands let you create, delete, display logical elements, and view and clear statistics.
Chapter 6 Logical Node, Port, and Signaling Commands Position-Dependent and Keyword-Driven Parameters Position-Dependent and Keyword-Driven Parameters A command can include parameters that are keyword-driven or position-dependent. For position-dependent parameters, you must type parameters in the order they appear in the syntax description or on-line help. To create a logical port, for example, the position-dependent syntax is: addport
Chapter 6 Logical Node, Port, and Signaling Commands Connection Capacities of the AXSM Table 6-1 Valid Line Numbers and Number of Bays for AXSM Card Types Front Card Speed Lines Bays AXSM-1-2488 OC-48 1 1 AXSM-4-622 OC-12 1–2 1–2 AXSM-16-155 OC-3 1–8 1–2 AXSM-16-T3E3 T3, E3 1–8 1–2 Connection Capacities of the AXSM The SVC and SPVC connection capacities for the front card, back card, and physical lines appear in Table 6-2 and Table 6-3.
Chapter 6 Logical Node, Port, and Signaling Commands Identifying Physical and Logical Elements Apart from the way PNNI and the lower levels of logic identify the same element, the sequence of commands also needs explanation. When you configure logical ports—for just one example—you must complete certain tasks on the AXSM CLI before or after related PNNI tasks. For certain commands, this manual lists prerequisite commands or tasks.
Chapter 6 Logical Node, Port, and Signaling Commands Dot Notation in ATM Addresses port number. (This section does not define a PNNI logical port number, nor does it describe the correspondence between an AXSM port and a PNNI logical port number.) For the correspondence between a PNNI physical port and the port identifier on an AXSM, see Table 6-4.
Chapter 6 Logical Node, Port, and Signaling Commands addaddr addaddr Add Address—create an ATM address. Use addaddr to specify one or more ATM addresses for a port. The port can be a UNI or an IISP port. For each port, the mandatory parameters are an ATM address and the length of that address. For a description of the format of an ATM address and address planning in general, see the Cisco MGX 8850 Software Configuration Guide, Release 2 or higher.
Chapter 6 Logical Node, Port, and Signaling Commands addaddr length -type Address length. The units of measure differ for each address plan. The -plan option lets you specify E.164 or NSAP. • For an NSAP address plan, the units of measure are bits. The range is 0–160. Using the maximum of a 20-byte ATM address: 20 bytes x 8 bits per byte = 160 bits. • For an E.164 address plan, the value is the number of decimal digits.
Chapter 6 Logical Node, Port, and Signaling Commands addaddr Attributes Log: log State: active Privilege: GROUP1 Example For logical port 11:2.8:28, specify the address that follows. Specify its length in bits (160), and leave all optional parameters in the default state. Use dspaddr to confirm the address. Note that the ICD code differs from the default from Cisco Systems. The address is: 47.0077.6400.0000.0000.0ca7.9e01.4000.0c81.8000.00 Geneva.7.PXM.a > addaddr 11:2.8:28 47.0077.6400.0000.0000.
Chapter 6 Logical Node, Port, and Signaling Commands addfltset addfltset Add Filter Set—create or modify an ATM address filter set. A filter controls the access of incoming calls to a port. The addfltset command lets you create a new filter set or modify the contents of an existing filter set. Note that, if you want to change the address plan, you must delete the filter set and re-create it. You can assign more than one filter to a port.
Chapter 6 Logical Node, Port, and Signaling Commands addfltset -length -plan Address length. The units of measure differ for each address plan. The -plan option lets you specify E.164 or NSAP. • For an NSAP address plan, the units of measure are bits. The range is 0–160. Using the maximum of a 20-byte ATM address: 20 bytes x 8 bits per byte = 160 bits. For a prefix, you must follow the significant bytes with 3 dots (and no spaces). See Example. • For an E.
Chapter 6 Logical Node, Port, and Signaling Commands addfltset Attributes Log: log State: active Privilege: GROUP1 Examples On the port with prefix 47.1111.1111, create address filter “mendocino.” The 47 indicates NSAP ICD address plan. Note that the three-dot notation is necessary for the prefix, and the address length of 40 is the 40 bits that make up that hex prefix. Unknown.1.1.PXM.a > addfltset mendocino -address 47.1111.1111...
Chapter 6 Logical Node, Port, and Signaling Commands addpnport addpnport Add Port—adds a UNI or NNI port through PNNI. The addpnport command lets you pre-configure an NNI or UNI port. The purpose of pre-configuring is that it may best serve the configuration strategy of some companies. To pre-configure a port means you add it on the PXM45 before you add it on the service module (by using addport). Eventually, you must run addport on the service module.
Chapter 6 Logical Node, Port, and Signaling Commands addpnport Example Add a port with the ID 6:1.1:1. Use the dsppnports command to see if 6:1.1:1 appears in a list of all ports.(If many PNNI ports already existed, you could use the dsppnport command for 6:1.1:1) It appears at the end of the list—after the entries for BITS clock ports in the format 7.x. Note that the IF status and the Administrative status are both up.
Chapter 6 Logical Node, Port, and Signaling Commands aesa_ping aesa_ping ATM End System Address Ping—ping any ATM end station connected to a PNNI network. The aesa_ping command lets you ping an AESA based on an ATM address that you provide as a destination address. If you specify only the destination address, the local node merely looks up that address in its routing table.
Chapter 6 Logical Node, Port, and Signaling Commands aesa_ping -trace Enable path trace during ping. This parameter only applies if -setupcall is enabled. Possible values: yes or no Default: no -timeout Connection timeout for the ping. This parameter applies only if setupcall is enabled. Range: 5–120 seconds Default: 5 seconds -data If you enable data, the switch transfers data then prints statistics at the end of the timeout.
Chapter 6 Logical Node, Port, and Signaling Commands clrpnconstats clrpnconstats Clear Port Connection Statistics Clears call statistics for one port or all ports. Cards on Which This Command Runs PXM45 Syntax clrpnconstats [portid] Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 6-4.
Chapter 6 Logical Node, Port, and Signaling Commands clrpnconstats Clear the call statistics on port 4:1.1:11. Geneva.7.PXM.a > clrpnconstats 4:1.1:11 Check the results by executing dsppnconstats. Geneva.7.PXM.a > dsppnconstats 4:1.1:11 Call Statistics for 4:1.
Chapter 6 Logical Node, Port, and Signaling Commands clrsigstats clrsigstats Clear Signaling Statistics Clears existing signaling statistics for one port or all ports. Cards on Which This Command Runs PXM45 Syntax clrsigstats [portid] Syntax Description portid The port in the format [shelf.]slot[:subslot].port[:subport]. See PNNI Format, page 6-4.
Chapter 6 Logical Node, Port, and Signaling Commands clrsigstats Example Clear the signaling statistics on port 3:1.1:11. Thereafter, check the results with dspsigstats. Geneva.7.PXM.a > clrsigstats 3:1.1:1 Clearing Signaling Statistics for 3:1.1:1 8850_NY.7.PXM.a > dspsigstats 3:1.1:1 Signaling Statistics for 3:1.
Chapter 6 Logical Node, Port, and Signaling Commands clrsscopstats clrsscopstats Clear SSCOP Statistics The clrsscopstats command lets you clear the statistics for the service-specific connection-oriented protocol (SSCOP). You can specify the statistics for an individual port or all ports on the switch. Cards on Which This Command Runs PXM45 Syntax clrsscopstats [ portid ] Syntax Description portid If you do not specify a port, this command clears all SSCOP statistics on the switch.
Chapter 6 Logical Node, Port, and Signaling Commands cnfe164justify cnfe164justify Configure E.164 Justification Specifies whether the E.164 AESAs with the E.164 AFI are converted to the left or right-justified encoding format. For PNNI to search the address correctly, all nodes in the PNNI network must use the same justification. Cards on Which This Command Runs PXM45 Syntax cnfe164justify left | right Syntax Description left or right Justification of E164 addresses.
Chapter 6 Logical Node, Port, and Signaling Commands cnfenhiisp cnfenhiisp Configure Enhanced IISP—enable or disable enhanced IISP features. The cnfenhiisp command enables or disables the enhanced IISP feature on the port. This command applies to only IISP ports. When you change the operational state of enhanced IISP, the change does not affect existing calls.
Chapter 6 Logical Node, Port, and Signaling Commands cnffdonaal5 cnffdonaal5 Configure Nodal Frame Discard The cnffdonaal5 command lets you determine whether the switch can use frame discard for AAL5 cells. Use the dspsigparm command to see the enable status of frame discard for AAL5 cells. Cards on Which This Command Runs PXM45 Syntax cnffdonaal5 yes | no Syntax Description yes Install frame discard on the presence of the AAL5 IE. The default is yes.
Chapter 6 Logical Node, Port, and Signaling Commands cnffltset cnffltset Configure Filter Set—modifies an ATM address filter set. Use cnffltset to modify an existing filter set. This command can: • Add more addresses to the filter set. • Change the access mode or address field of a filter set entry. After a filter is modified for a specific port, associate the filter to that port by using cnf-pnportacc.
Chapter 6 Logical Node, Port, and Signaling Commands cnffltset Related Commands addfltset, delfltset, dspfltset Attributes Log: log State: active Privilege: SUPER_GP Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 6 Logical Node, Port, and Signaling Commands cnfintfcongth cnfintfcongth Configure Interface Congestion Threshold The cnfintfcongth command lets you configure congestion thresholds for a logical port. The thresholds apply to incoming calls and status enquiries. When the upper congestion limit is reached, the port may block incoming calls and adjust the pace of status enquiries. You must specify at least one keyword.
Chapter 6 Logical Node, Port, and Signaling Commands cnfintfcongth Example Configure a congestion threshold of 200 for set-up messages on 6:1.1:1. Check the results by using the dspintfcongth command. M8850_NY.7.PXM.a > cnfintfcongth 6:1.1:1 -setuphi 200 M8850_NY.7.PXM.a > dspintfcongth 6:1.1:1 Congestion Thresholds for port : 6:1.1:1 Parameter --------setuphi unackedStatEnqLo unackedStatEnqHi Value ----100 40 200 unit ---cps messages messages M8850_NY.7.PXM.
Chapter 6 Logical Node, Port, and Signaling Commands cnfnodalcongth cnfnodalcongth Configure Nodal Congestion Thresholds The cnfnodalcongth command lets you configure congestion thresholds at the node level. The thresholds relate to call setup messages, status enquiries, queue levels, and so on. You must specify at least one optional parameter.
Chapter 6 Logical Node, Port, and Signaling Commands cnfnodalcongth -connpendhi The aggregate number of connections in the establishment phase above which the establishment congestion state is flagged. Range: 1–1000 connections Default: 500 connections -incompjour The number of incomplete journaling cycles that must be exceeded to trigger an increase in the journaling rate. Range: 1–10 cycles Default: 5 cycles -vsiqmild The VSI Q depth above which VSI master is mildly congested.
Chapter 6 Logical Node, Port, and Signaling Commands cnfnodalcongth Examples Configure the nodal congestion thresholds, as follows: svcpop1.1.PXM.a > cnfnodalcongth -setuphi 80 -vsiqmild 100 -vsiqmedium 140 -vsiqsevere 175 svcpop1.1.PXM.
Chapter 6 Logical Node, Port, and Signaling Commands cnfpnctlvc cnfpnctlvc Configure Port Control Virtual Channel—configure bandwidth parameters for a control channel. The cnfpnctlvc command lets you configure bandwidth parameters for two types of control channels on a port. The types of control channels are service-specific connection-oriented protocol (SSCOP) and PNNI routing control channel (PNNI-RCC).
Chapter 6 Logical Node, Port, and Signaling Commands cnfpnctlvc -scr The sustained cell rate of the control VC. Range: 1–5000 cps Default: -mbs • If vc-type is pnnircc, the default is 453 cps. • If vc-type is sscop, the default depends on the line rate. The maximum burst size of the control VC. Range: 1–1000 cells Defaults: • If vc-type is pnnircc, the default is 171 cells. • If vc-type is sscop, the default is 1000 cells.
Chapter 6 Logical Node, Port, and Signaling Commands cnfpnportacc cnfpnportacc Configure Port Access—associates an ATM filter set with a port. The cnfpnportacc command lets you associate an ATM filter set with a port (after you create the filter set with addfltset). You must specify at least one filter set if you use this command.
Chapter 6 Logical Node, Port, and Signaling Commands cnfpnportcac cnfpnportcac Configure Port Connection Admission Control—configure CAC for a all connections on a port. The cnfpnportcac command lets you reserve a percent of the bandwidth parameters for an individual service type. The new configuration applies to new, incoming calls, while existing calls remain unaffected. You can execute this command whether the port is active or in the provisioning state. The bookfactor is the percent of utilization.
Chapter 6 Logical Node, Port, and Signaling Commands cnfpnportcac -maxvc The max-vc-percent is the maximum percentage of VCs for a service category on this port. Range: 0–100 Default: 100 -minvc The min-vc-percent is the minimum percentage of VCs for a service category on this port. Range: 0–100 Default: 0 -maxvcbw The max-vc-bw is the maximum number of cells per second specified by the PCR allowed for a VC in a service category on this port.
Chapter 6 Logical Node, Port, and Signaling Commands cnfpnportcc cnfpnportcc Configure Port Call Control Sets call control parameters for a port. The possible applications of cnfpnportcc are to let you: Note • Specify maximum root and leaf connections for point-to-multipoint connections • Specify whether all SVCs or all SPVCs are blocked on the port The current release does not support point-to-multipoint calls. You can execute this command whether the port is active or in the provisioning state.
Chapter 6 Logical Node, Port, and Signaling Commands cnfpnportcc Related Commands dsppnportcc Attributes Log: log State: active Privilege: GROUP1 Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 6 Logical Node, Port, and Signaling Commands cnfpnportloscallrel cnfpnportloscallrel Configure PNNI Port Loss of Signal Call Release The cnfpnportloscallrel command lets you shut off the standard delay for rerouting calls on a port when the system detects loss of signal (LOS) on a port. When the system detects LOS on an NNI link, the switch does not immediately tear down the calls on the link—in case the break is momentary.
Chapter 6 Logical Node, Port, and Signaling Commands cnfpnportrange cnfpnportrange Configure Port Range—configure a range of VPIs or VCIs for SVCCs and SVPCs. The cnfpnportrange command lets you specify a range of VPIs and VCIs on a port for SVCCs or SVPCs for the purpose of screening calls from another switch. If the VPI or VCI for one of these control channels from another switch does not fall within the range for the called port, the called switch rejects the call.
Chapter 6 Logical Node, Port, and Signaling Commands cnfpnportrange -minsvpcvpi The min-svpc-vp: minimum VPI for SVPC. Range: 1–4095 Default: 1 -maxsvpcvpi The max-svpc-vp: maximum VPI for SVPC. Range: 1–4095 Default: 4095 Related Commands dsppnportrange Attributes Log: log State: active Privilege: GROUP1 Cisco MGX 8850 Routing Switch Command Reference 6-40 Release 2.
Chapter 6 Logical Node, Port, and Signaling Commands cnfpnportsig cnfpnportsig Configure Port Signaling—specify ATM signaling parameters on a PNNI port. Before you can execute cnfpnportsig, the port must be down (by dnpnport). For a UNI or an NNI, the type of interface you specify on the controller must match the interface type that you configure on the slave (the service module).
Chapter 6 Logical Node, Port, and Signaling Commands cnfpnportsig -nniver The NNI version: iisp30, iisp31, pnni10, or enni. Note that univer and nniver are mutually exclusive—so the interface at each end of the connection must have the same interface type. Also, the port type on the PNNI controller must be the same as on the slave (through addport ... ifType on the AXSM, for example). The default for this parameter is PNNI 1.0. If this version is sufficient, you can forego this parameter.
Chapter 6 Logical Node, Port, and Signaling Commands cnfpnportsig Related Commands dsppnportsig Attributes Log: log State: active Privilege: GROUP1 Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 6 Logical Node, Port, and Signaling Commands cnfpnportsig Examples Specify an RCC VCI of 10000 for port 1:2.1:1. Be sure the interface type is compatible with the parameter you want to change. Do the following: 1. Confirm that the interface type for 1:2.1:1 is NNI. 2. Down the port. 3. Configure the RCC VCI to be 10000. 4. Check the port by using the dsppnportsig command. 5. Up the port. M8850_NY.7.PXM.a > dsppnport 1:2.
Chapter 6 Logical Node, Port, and Signaling Commands cnfsig cnfsig Configure Signaling—configures signaling timers and crankback attempts for a port. The cnfsig command lets you configure signaling timers for a port whether the port is up or down. The new configuration applies to new incoming calls while existing calls remain intact. In addition to standard timers, this command lets specify the maximum number of crankbacks that PNNI can attempt at a port.
Chapter 6 Logical Node, Port, and Signaling Commands cnfsig -t310 The T310 timer. Range: • 10–20 seconds for UNI. • 30–120 seconds for PNNI. The range you can specify for PNNI is 30–120. If you do not specify a T310 timer value for PNNI, it remains the default of 10 seconds for PNNI. Default: 10 -t316 The t316-timer: Set the T316 timer. Range: 90–300 seconds Default: 90 -t317 The t317-timer: Set the T317 timer. Range: 60–300 seconds Default: 60 -t322 The t322-timer: Set the T322 timer.
Chapter 6 Logical Node, Port, and Signaling Commands cnfsig Example Configure port 1:1.1:1 to have the maximum crankback count of 5. Check the results with the dspsig command. Note the default values in the dspsig output. pop20one.7.PXM.a > cnfsig 1:1.1:1 -maxcrbk 5 pop20one.7.PXM.a > dspsig 1:1.1:1 Signaling Timers for port: 1:1.
Chapter 6 Logical Node, Port, and Signaling Commands cnfsigdiag cnfsigdiag Configure Signaling Diagnostic The cnfsigdiag command lets you create a filter table for signaling diagnostics or disable signaling diagnostics. Signaling diagnostics are disabled by default. The ATM signaling diagnostics are tools for troubleshooting call failures in the network and should not be enabled while the switch is operating.
Chapter 6 Logical Node, Port, and Signaling Commands cnfsigdiag -cldaddrmask The the atm-address-mask: Address mask for identifying valid bits of the called NSAP address field (ff.ff.ff, for example). To match this selection criterion, a failed connect setup must have a called party address value equal to the configured called party address for all bits that are 1 in the specified mask. Default: NULL. NULL means the rejected call matches the filter criteria for any called address in the rejected call.
Chapter 6 Logical Node, Port, and Signaling Commands cnfsigdiag -servctgy Filters ATM signaling call failures by service category (service type): valid entries are: all (for all service types), cbr, rtvbr, nrtvbr, ubr, or abr. Default: all -status The status of the entry for the signaling diagnostics filter table. Type active to begin filtering failed connections or inactive to stop filtering failed connections.
Chapter 6 Logical Node, Port, and Signaling Commands cnfspvcprfx cnfspvcprfx Configure SPVC Prefix—configure a node-level prefix for SPVCs. For the node to support SPVCs, it must have a 13-byte SPVC prefix that applies to the entire node. No SPVCs can exist on the node until it has an SPVC prefix. Likewise, to change this prefix, no SPVCs can exist on the node. Prerequisites Setting up a node and a network requires advance planning for the PNNI node addressing scheme.
Chapter 6 Logical Node, Port, and Signaling Commands cnfspvcprfx Example First display the current SPVC prefix. The ICD field shows the prefix is the default from Cisco (0091). Configure the SPVC prefix 47.0077780000000aa2109ff214. pop20one.7.PXM.a > dspspvcprfx SPVC Node Prefix: 47.00918100000000107b65f33c pop20one.7.PXM.a > cnfspvcprfx 47.0077780000000aa2109ff214 Cisco MGX 8850 Routing Switch Command Reference 6-52 Release 2.
Chapter 6 Logical Node, Port, and Signaling Commands cnfsscop cnfsscop Configure SSCOP The cnfsscop command lets you configure service-specific connection-oriented protocol (SSCOP) on a port. You can use this command regardless of the state of the port. You must specify at least one of the optional parameters.
Chapter 6 Logical Node, Port, and Signaling Commands cnfsscop -norsptmr Number of seconds after which at least one STAT PDU must be received (for the No Response timer). A 0 forces restoration of the default value. Range: 1–45 seconds Default: 30 seconds -t309tmr Number of seconds before SAAL reconnects after disconnection. Range: 1 –15 seconds Default: 10 seconds -maxcc Maximum number of retries for connection control operations. A 0 forces restoration of the default.
Chapter 6 Logical Node, Port, and Signaling Commands cnftrapip cnftrapip Configure Trap IP The cnftrapip command lets you configure the trap IP for Cisco WAN Manager. You can then use the command dsptrapip to confirm the value. Before you use cnftrapip: 1. The SNMP agent must be installed. 2. The switch’s interface must have an IP address. (To assign an IP address to a switch’s interface, use ipifconfig.
Chapter 6 Logical Node, Port, and Signaling Commands deladdr deladdr Delete Address Removes an ATM address for a UNI or IISP. Cards on Which This Command Runs PXM45 Syntax deladdr [-plan {e164 | nsap}] Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 6-4. atm-address The ATM address: its format depends on whether the address type is NSAP or E.164.
Chapter 6 Logical Node, Port, and Signaling Commands deladdr Related Commands addaddr, dspaddr Attributes Log: log State: active Privilege: GROUP1 Example On port 11:2.8:22, delete 47.0091.8100.0000.0000.0ca7.9e01.4000.0c81.8000.00. Note that the command entry includes the address length of 160 after the address. Geneva.7.PXM.a > deladdr 11:2.8:28 47.0091.8100.0000.0000.0ca7.9e01.4000.0c81.8000.00 160 Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 6 Logical Node, Port, and Signaling Commands delfltset delfltset Delete Filter Set Removes an ATM address filter set. Cards on Which This Command Runs PXM45 Syntax delfltset [index] Syntax Description name The name of the filter set. index Delete a specific filter element. Range: 1–65535 Default: 0 Related Commands addfltset, cnffltset, dspfltset Attributes Log: log State: active Privilege: GROUP1 Example Remove the “connect” filter set from the port. Geneva.7.PXM.
Chapter 6 Logical Node, Port, and Signaling Commands delpnport delpnport Delete Port Remove a UNI or NNI port from the controller. It is allowed only if the PNNI port does not exist on the switch i.e, the PNNI partition associated with the port is removed. If the controller does no provisioning on the port in the Plug and Play Scenario, then the PNNI port on the controller is removed if you remove the PNNI Partition on the switch.
Chapter 6 Logical Node, Port, and Signaling Commands delpnportacc delpnportacc Delete Port Access Removes an address access filter group from a port. Cards on Which This Command Runs PXM45 Syntax delpnportacc {in | out} Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 6-4. in Delete incoming access group for the port. out Delete outgoing access group for the port.
Chapter 6 Logical Node, Port, and Signaling Commands delsigdiag delsigdiag Delete Signaling Diagnostic Removes a signaling diagnostics filter table entry or removes some configuration values within a filter table entry.
Chapter 6 Logical Node, Port, and Signaling Commands delsigdiag -inport yes returns the incoming port to the default. Default: no -outport yes returns the outgoing port to the default. Default: no -maxrec yes returns the maximum records to the default. Default: no -scope yes to disable filtering by scope. Default: no -servctgy yes returns the service category to the default.
Chapter 6 Logical Node, Port, and Signaling Commands disablesscop disablesscop Disable SSCOP The disablesscop command lets you disable SSCOP on a port. The port must be administratively down (by the dnpnport command). Be sure a valid and useful reason exists for disabling SSCOP. Cards on Which This Command Runs PXM45 Syntax disablesscop {yes | no} Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport].
Chapter 6 Logical Node, Port, and Signaling Commands dnpnport dnpnport Down PNNI Port The dnpnport command takes a UNI or NNI port out of service (administratively “downs” a port). For example, downing a port is necessary for certain provisioning activity or maintenance activity. Where appropriate, the applicable commands state that you must down a port by using dnpnport. Note This command deletes all connections on a port—except for SPVCs whose endpoints are on the port.
Chapter 6 Logical Node, Port, and Signaling Commands dspaddr dspaddr Display Address The dspaddr command displays ATM addresses and associated information for a UNI or IISP. For details on the displayed items, see the addaddr description.
Chapter 6 Logical Node, Port, and Signaling Commands dspatmaddr dspatmaddr Display ATM Addresses—displays active ATM addresses on a port. The output of dspatmaddr includes configured ATM addresses, configured ILMI address prefixes, and ATM addresses registered by way of the ILMI address registration procedure. Cards on Which This Command Runs PXM45 Syntax dspatmaddr Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport].
Chapter 6 Logical Node, Port, and Signaling Commands dspconsegep dspconsegep Display Connection Segment Endpoint Displays oam segment endpoint for a connection endpoint. When both vpi and vci are present, the segment endpoint is a F5 flow endpoint (for VCCs). When the optional vci is not present, the segment endpoint is a F4 flow endpoint (for VPCs). This command applies to established calls only.
Chapter 6 Logical Node, Port, and Signaling Commands dspenhiisp dspenhiisp Display Enhanced IISP Displays the enhanced IISP setting for one port or all ports. Cards on Which This Command Runs PXM45 Syntax dspenhiisp [] Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 6-4. Related Commands cnfenhiisp Attributes Log: nolog State: active, standby Privilege: ANYUSER Example Geneva.7.PXM.
Chapter 6 Logical Node, Port, and Signaling Commands dspfltset dspfltset Display Filter Set Displays a specific ATM filter set or a summary of ATM filter sets. Cards on Which This Command Runs PXM45 Syntax dspfltset [-name <...>] Syntax Description -name If you do not type a filter set name, a summary of ATM filter sets is displayed.
Chapter 6 Logical Node, Port, and Signaling Commands dspfltset Example Geneva.7.PXM.
Chapter 6 Logical Node, Port, and Signaling Commands dspintfcongcntr dspintfcongcntr Display Interface Congestion Counters Display the congestion thresholds for a port. This command cannot be used if the interface is in PROVISIONING state or if the interface (“IF” in the display) is down. Cards on Which This Command Runs PXM45 Syntax dspintfcongcntr Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport].
Chapter 6 Logical Node, Port, and Signaling Commands dspintfcongflags dspintfcongflags Display Interface Congestion Flags To display various congestion detection and action flags maintained at the CCM at the interface level. Cards on Which This Command Runs PXM45 Syntax dspintfcongflags Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 6-4.
Chapter 6 Logical Node, Port, and Signaling Commands dspintfcongth dspintfcongth Display Interface Congestion Thresholds The dspintfcongth command display the congestion thresholds for a port. Cards on Which This Command Runs PXM45 Syntax dspintfcongth Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 6-4.
Chapter 6 Logical Node, Port, and Signaling Commands dspnodalcongcntr dspnodalcongcntr Display Nodal Congestion Threshold Counters The dspnodalcongcntr command displays thresholds and current contents of the congestion counters for the node. Cards on Which This Command Runs PXM45 Syntax dspnodalcongcntr Related Commands None Attributes Log: nolog State: active, standby Privilege: ANYUSER Example Display the node-level congestion thresholds. Geneva.7.PXM.
Chapter 6 Logical Node, Port, and Signaling Commands dspnodalcongflags dspnodalcongflags Display Nodal Congestion Flags The dspnodalcongflags command displays congestion flags maintained at the CCM at the node level. Cards on Which This Command Runs PXM45 Syntax dspnodalcongflags Related Commands dspintfcongflags Attributes Log: nolog State: active, standby Privilege: ANYUSER Example Display the node-level congestion flags. Geneva.7.PXM.
Chapter 6 Logical Node, Port, and Signaling Commands dspnodalcongth dspnodalcongth Display Nodal Congestion Thresholds Displays configuration of the nodal congestion thresholds. Cards on Which This Command Runs PXM45 Syntax dspnodalcongth Output Description setuphi The number of connection setup messages per second, above which the set-up messages have congested the node.
Chapter 6 Logical Node, Port, and Signaling Commands dspnodalcongth vsiqmild The VSI Q depth above which the VSI master is mildly congested. This threshold is represented as a percentage of the VSI master-slave communication window. This threshold applies to all the interfaces on the node. Range: 1–175 Default: 5 vsiqmedium The VSI Q limit above which the VSI master is congested at a medium level. This threshold is represented as a percentage of VSI master-slave communication window size.
Chapter 6 Logical Node, Port, and Signaling Commands dsppingatmaddr dsppingatmaddr Display Ping ATM Address Display the default ping ATM address. Cards on Which This Command Runs PXM45 Syntax dsppingatmaddr Related Commands dsppingatmaddr, aesa_ping Attributes Log: nolog State: active Privilege: ANYUSER Example Display the ATM ping address. Geneva.7.PXM.a > dsppingatmaddr 47.0091.8100.0000.0030.ff0f.ef38.0030.ff0f.ef38.
Chapter 6 Logical Node, Port, and Signaling Commands dsppncon dsppncon Display Connection—display information about an active SVC or SPVC. The information that dsppncon displays corresponds to the objects described in the portCallTable and portAbrCallTable MIBs. This command can be issued at any node in the route. Refer to the example for the contents of the command output.
Chapter 6 Logical Node, Port, and Signaling Commands dsppncon Example Display VPI/VCI 100 100 on port 1.5. mpgses1.2.PXM.a > dsppncon 1.5 100 100 Port : 1.5 VPI : 100 VCI : 100 CallRef: 116 CallRefFlag: 0 CallLeafRef : 0 Calling-address: 47.009181000000003071f80e4a.000000010500.00 Calling-subaddress #1: N/A Calling-subaddress #2: N/A Called-address: 47.009181000000003071f80e49.000000010500.00 Called-subaddress #1: N/A Called-subaddress #2: N/A OE Port : 1.
Chapter 6 Logical Node, Port, and Signaling Commands dsppncons dsppncons Display Port Connections Displays a summary of SVCs and SPVCs on one port or all ports. The default is all connections on all ports because all parameters are optional. You can specify a starting VPI or VCI to begin a range of connections. In addition, you can display one of two types: point-to-point or point-to-multipoint.
Chapter 6 Logical Node, Port, and Signaling Commands dsppncons Example Geneva.7.PXM.a > dsppncons Port VPI VCI CallRef X-Port VPI VCI CallRef 1:1.2:2 1 100 33 1:1.2:2 1 101 32 Calling-Addr:47.00918100000000107be92f3d.000001011802.00 Called-Addr:47.00918100000000107be92f3d.000001011802.00 1:1.2:2 1 101 32 1:1.2:2 1 100 33 Calling-Addr:47.00918100000000107be92f3d.000001011802.00 Called-Addr:47.00918100000000107be92f3d.000001011802.00 1:1.2:2 2 200 34 1:1.6:6 0 49 8388609 Calling-Addr:47.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnconstats dsppnconstats Display Connection Statistics Displays connection statistics for a port. Refer to the section, for a description of the items in the display. Cards on Which This Command Runs PXM45 Syntax dsppnconstats Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 6-4.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnconstats Output Description for dsppnconstats Incoming Call Attempts The number of incoming signaling messages—Setup and AddParty—received on this port for call establishment. Incoming Call Success The number of incoming signaling messages—Connect and AddPartAck—received on this port, which indicates successful call establishment.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnconstats Outgoing Timer Failures The number of signaling timers that timed out on outgoing point-to-point SVC/SPVC calls sent from this port. Outgoing Crankback Failures The number of crankback information elements sent from this port for outgoing signaling release messages. Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnctlvc dsppnctlvc Display Control VC Parameters The command lets you display the bandwidth parameters for the control VCs on the port. These bandwidth parameters result from the use of the (optional) cnfpnctlvc command. Note To see details about the VCs that support ILMI, use dsppnilmi. Cards on Which This Command Runs PXM45 Syntax dsppnctlvc Syntax Description portid The portid is the PNNI physical port. The format is [shelf.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnport dsppnport Display PNNI Port—displays PNNI port information. The dsppnport command shows dynamic, operational data rather than just the configuration data you would see by executing dspport on a service module. The total number of connections that the dsppnport shows does not include control VCs.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnport Example First determine if connections exist on port 3:1.1:1 by executing dspcons. One connection exists, and the display shows the view from each port (3:1.1:1 and 2:2.2:1). Display port 2:2.2:1 then port 3:1.1:1. Note the differences in the display when you specify the master-end port and the slave-end port. Also, note that the interface type is UNI 3.1.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnportcac dsppnportcac Display Port Call Admission Control Displays CAC policy parameters for the port as configured by cnfpnportcac. For a list of the displayed items, see the Example section. For a description of these items, see the cnfpnportcac description. Cards on Which This Command Runs PXM45 Syntax dsppnportcac Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport].
Chapter 6 Logical Node, Port, and Signaling Commands dsppnportcc dsppnportcc Display Port Call Control This command lets you display the call control parameters for a logical port. See cnfpnportcc for a description of applicable parameters. Cards on Which This Command Runs PXM45 Syntax dsppnportcc Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 6-4.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnportidmaps dsppnportidmaps Display Port ID Maps—display physical port ID to logical port ID mapping. The dsppnportidmaps command lets you display the mapping of physical port identifiers (portIDs) to logical port identifiers. The purpose of having logical port IDs is that some command require the logical port ID. The displayed information consists of: • Physical port ID in the format slot[:subslot].
Chapter 6 Logical Node, Port, and Signaling Commands dsppnportloscallrel dsppnportloscallrel Display PNNI Port Loss of Signal Call Release This command displays the enable status of the LOS call release feature. See cnfpnportloscallrel for a description of this feature. Cards on Which This Command Runs PXM45 Syntax dsppnportloscallrel Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 6-4.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnportrange dsppnportrange Display Port Range Displays ATM VPI/VCI range only for the port configured by cnfpnportrange. dsppnport displays the operational values. Cards on Which This Command Runs PXM45 Syntax dsppnportrange Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 6-4.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnportrsrc dsppnportrsrc Display Port Resources Displays available bandwidth and channels on the port for all service classes. Cards on Which This Command Runs PXM45 Syntax dsppnportrsrc Syntax Description portid See PNNI Format, page 6-4. The portid represents the PNNI physical port and has the format [shelf.]slot[:subslot].port[:subport].
Chapter 6 Logical Node, Port, and Signaling Commands dsppnports dsppnports Display Ports The dsppnports command displays status for all logical ports. If you do not identify a particular type of interface, the display shows all interface types.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnports EnableNotUp This port is not accessible due to hardware. UpAndNormal This port is physically up, and the protocol is enabled. Related Commands dsppnportrsrc, dsppnport Attributes Log: nolog State: active, standby Privilege: ANYUSER Description of the dsppnports Connection Summaries This section contains the following: 1. A list identifies all fields in the connection summary part of the display. 2.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnports For an example SPVC, refer to Figure 6-1. An SPVC’s master endpoint is on a UNI on Node 1. The slave endpoint is on a UNI on Node 3. The SPVC traverses a via node, Node 2.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnports Example Display all PNNI logical ports on the switch. UNI ports 7.35, 7.36, 7.37, and 7.38 are reserved for BITS clock sources on the PXM45 UI card. In reality, only 7.35 and 7.36 are meaningful. M8850_NY.7.PXM.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnportsig dsppnportsig Display Port Signaling—displays signaling parameters on a port. The dsppnportsig command displays the ATM signaling parameters as configured by cnfpnportsig. Cards on Which This Command Runs PXM45 Syntax dsppnportsig Syntax Description portid See PNNI Format, page 6-4. The portid represents the PNNI physical port and has the format [shelf.]slot[:subslot].port[:subport].
Chapter 6 Logical Node, Port, and Signaling Commands dsppnsysaddr dsppnsysaddr Display PNNI Port System Addresses— displays the PNNI system address table. The dsppnsysaddr command displays addresses in the system address table. The system address table only contains static addresses. Note This command does not belong to the RA module.
Chapter 6 Logical Node, Port, and Signaling Commands dsppnsysaddr Figure 6-2 Cisco Factory-shipped Defaults for PNNI Peer Group Identifier, PNNI Summary Address, ATM Address, and PNNI Node Identifier ATM address ATM format address Cisco length MAC address MAC address ICD PNNI hierarchy 56 160 47 00 91 81 00 00 00 XX XX XX XX XX XX XX XX XX XX XX XX 00 level # of Bytes 1 1 2 1 1 3 6 6 1 Default PNNI peer group identifier Default PNNI summary address Default PNNI node identifier 53346 Default
Chapter 6 Logical Node, Port, and Signaling Commands dsppnsysaddr Type: host Port id: 17251106 47.0091.8100.0000.0030.9409.f1f2.0000.0104.180c.00/160 Type: host Port id: 17251106 47.1111.1111.1111.1111.1111.1111.0000.0000.0000/152 Type: uni Port id: 17045515 47.1111.1111.1111.1111.1111.1111.0000.0000.0000/152 Type: uni Port id: 17045516 Geneva.7.PXM.a > The following example includes the option “host,” so dsppnsysaddr displays only the host addresses in the peer group. Geneva.7.PXM.
Chapter 6 Logical Node, Port, and Signaling Commands dspsig dspsig Display Signaling Displays the configuration of the signaling timers for the port. Cards on Which This Command Runs PXM45 Syntax dspsig Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 6-4.
Chapter 6 Logical Node, Port, and Signaling Commands dspsigdiag dspsigdiag Display Signaling Diagnostic Displays the configured filter entries and the collection call records for the ATM signaling diagnostics. Cards on Which This Command Runs PXM45 Syntax dspsigdiag {filter | rec | status} [index] Syntax Description filter Display the information in the filter table. rec Display the call failure records. status Display global diagnostics status.
Chapter 6 Logical Node, Port, and Signaling Commands dspsigdiag Examples Display the filter sets. SanJose.7.PXM.a > dspsigdiag filter F I L T E R I N D E X 1 -------------------------------Scope: internal, Cast Type: p2mp Connection Kind: soft-vc Service Category: CBR (Constant Bit Rate) UBR (Unspecified Bit Rate) Clear Cause: 0, Initial TimerValue: 600 Max Records: 20, NumMatches: 0, Timer expiry: 600 Incoming Port: ATM0/0/1, Outgoing Port: ATM0/1/1 Calling Nsap Address:47.111122223333444455556666.
Chapter 6 Logical Node, Port, and Signaling Commands dspsigparm dspsigparm Display Signaling Parameter The dspsigparm command shows whether the switch is enabled to perform frame discard on AAL5 cells. The cnffdonaal5 command lets you enable or disable frame discard for AAL5 cells. The default is enabled. Cards on Which This Command Runs PXM45 Syntax dspsigparm Syntax Description This command takes no parameters.
Chapter 6 Logical Node, Port, and Signaling Commands dspsigstats dspsigstats Display Signaling Statistics Displays signaling statistics for a port. See the Example section for a list of the types of statistics. Cards on Which This Command Runs PXM45 Syntax dspsigstats Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 6-4.
Chapter 6 Logical Node, Port, and Signaling Commands dspsigstats Example Display signaling statistics for port 1:2.1:1. 8850_NY.8.PXM.a > dspsigstats 1:2.1:1 Signaling Statistics for 1:2.
Chapter 6 Logical Node, Port, and Signaling Commands dspsigstats Display the SPVC address first on port 1:1.1:1 then on port 1:1.4:4. p2spvc5.7.PXM.a > dspspvcaddr 1:1.1:1 Interface Id -----------1:1.1:1 Soft VC Address(es) ------------------47.0091.8100.0000.0010.7be9.2f6d.0000.0101.1801.00 p2spvc5.7.PXM.a > dspspvcaddr 1:1.4:4 Interface Id -----------1:1.4:4 Soft VC Address(es) ------------------47.0091.8100.0000.0010.7be9.2f6d.0000.0101.1804.
Chapter 6 Logical Node, Port, and Signaling Commands dspspvcprfx dspspvcprfx Display SPVC Prefix The dspspvcprfx command displays the prefix for the switch-level SPVC address. The switch comes with a default SPVC prefix, and you can modify the prefix by executing cnfspvcprfx. See description of cnfspvcprfx for more details. Cards on Which This Command Runs PXM45 Syntax dspspvcprfx Syntax Description This command takes no parameters.
Chapter 6 Logical Node, Port, and Signaling Commands dspsscop dspsscop Display SSCOP—display SSCOP details for a PNNI port. The dspsscop command displays information about the state of the link on the port, status inquiry and response timers, and statistics. Cards on Which This Command Runs PXM45 Syntax dspsscop Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 6-4.
Chapter 6 Logical Node, Port, and Signaling Commands dspsscop Example SanJose.7.PXM.a > dspsscop 4:1.1:11 SSCOP details for interface: 4:1.1:11 Current State = enabled, Current Link State = Established State, SSCOP version = 3.
Chapter 6 Logical Node, Port, and Signaling Commands dspsscopstats dspsscopstats Display SSCOP Statistics Displays SSCOP statistics for the port. Cards on Which This Command Runs PXM45 Syntax dspsscopstats Syntax Description portid The portid is the PNNI physical port. The format is [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 6-4. Related Commands cnfsscop, disablesscop, dspsscop Attributes Log: nolog State: active, standby Privilege: ANYUSER Examples SanJose.7.
Chapter 6 Logical Node, Port, and Signaling Commands dspsvcparm dspsvcparm Display SVC Parameters Displays global SVC parameters for the node. Cards on Which This Command Runs PXM45 Syntax dspsvcparm Related Commands cnfe164justify Attributes Log: nolog State: active, standby Privilege: ANYUSER Example SanJose.7.PXM.a > dspsvcparm Global SVC parameters ============================ E164 Address Conversion Justification :left SanJose.7.PXM.
Chapter 6 Logical Node, Port, and Signaling Commands dsptrapip dsptrapip Display Trap IP The dsptrapip command displays the switch trap IP address. The switch must have a trap IP assigned by the cnftrapip command. Cards on Which This Command Runs PXM45 Syntax dsptrapip Syntax Description This command takes no parameters. Related Commands cnftrapip, dsptrapmgr, addtrapmgr, deltrapmgr Attributes Log: log State: active Privilege: GROUP1 Example Assign and confirm a trap IP address. SanJose.7.
Chapter 6 Logical Node, Port, and Signaling Commands tstpndelay tstpndelay Test Port Delay Initiates loopback test for a connection. If you provide both a VPI and VCI, the segment endpoint is an F5 flow endpoint (for VCCs). If you provide only a VPI, the segment endpoint is a F4 flow endpoint (for VPCs). This command displays the round trip delay in microseconds. Use cnfconsegep to specify the segment endpoint if one does not already exist.
Chapter 6 Logical Node, Port, and Signaling Commands uppnport uppnport Up PNNI Port: The uppnport command lets you put a UNI or NNI port into service (administratively “up” the port).
Chapter 6 Logical Node, Port, and Signaling Commands uppnport Example Check for any downed ports by executing dsppnports. Use uppnport to up any ports that are down. The output of dsppnports shows that only one user port exists (not the 7.3x ports, the first two of which are the BITS clock ports). 8850_NY.8.PXM.
C H A P T E R 7 SPVC and SVC Commands This chapter describes the commands that apply to semi-permanent virtual circuits (SPVCs) and switched virtual circuits (SVCs). These commands allow you to add, delete, configure, display status, and specify statistics for these connections.
Chapter 7 SPVC and SVC Commands Command Entry Command Entry When you enter a command with the current version of the product, you must type all intended arguments before you press the Return key or Enter key. If you press the Return key or Enter key with incorrect parameters or no parameters (if the command requires parameters), a message displays the syntax and parameter ranges. The returned message may also suggest what the problem is. For example, the message may warn of too few parameters.
Chapter 7 SPVC and SVC Commands Identifying Physical and Logical Elements Table 7-2 Maximum Connections by Connection Type and Front Card Front Card SVC SPVC AXSM-1-2488 128 K 64 K AXSM-4-622 128 K 64 K AXSM-16-155 128 K 64 K AXSM-16-T3E3 128 K 64 K Table 7-3 Maximum Connections on Back Cards and Lines Card Type Back Card Maximum Physical Line Maximum OC-48c 128 K 64 K OC-12c 64 K 32 K OC-3c 64 K 32 K T3 64 K 64 K E3 64 K 64 K Identifying Physical and Logical Elements
Chapter 7 SPVC and SVC Commands Identifying Physical and Logical Elements Not all of these elements correspond to elements you specify on the PXM45. Subsequent paragraphs describe only the common elements that are visible on the CLI of the PXM and the service module. The preceding elements are further defined in the Cisco MGX 8850 Routing Switch Software Configuration Guide, Release 2.0. For a UNI or NNI, one logical interface (or logical port) exists per physical line.
Chapter 7 SPVC and SVC Commands Identifying Physical and Logical Elements • Bay 2 • Line 1 • Logical interface 1 (or logical port 1) Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 7 SPVC and SVC Commands addcon addcon Add Connection Adds a logical connection as an SPVC on a service module. The switch assigns a 20 octet NSAP address to the slave endpoint, which is sent back to the master and uniquely identifies the endpoint on the network. An AXSM front card can support a maximum of 64K SPVCs. This command does not apply to SVCs. Before Adding a Connection Before you can add an SPVC, the following tasks must have been completed: 1.
Chapter 7 SPVC and SVC Commands addcon Traffic parameters such as CDV, CTD are entered at both the master and slave endpoints for both the forward and reverse directions. However, the values of these parameters entered at the slave end are ignored during call setup. Therefore, you can specify the lcdv, rcdv, lctd and rctd options at the master end only. SCT Default Traffic Parameters The Service Class Templates (SCTs) provide the default traffic parameters for the logical ports.
Chapter 7 SPVC and SVC Commands addcon Table 7-6 Ranges for PCR, SCR, and MCR for Each Line Type Parameter Range PCR Minimum value of 7 cell/sec. Maximum depends on the physical line on which the interface is configured: for OC12:between 7 and 1412832 for OC3:between 7 and 353208 for T3:between 7 and 96000(PLCP), 104268(ADM) for E3:between 7 and 80000 for T1:between 7 and 3622 for E1:between 7 and 4528 Default : Taken from the SCT which was chosen for the virtual interface.
Chapter 7 SPVC and SVC Commands addcon Syntax addcon [-slave
Chapter 7 SPVC and SVC Commands addcon service type mastership Value in the range 1–12 to specify the service type: • 1=CBR1 (Constant Bit Rate 1) • 2=VBR1RT (Variable Bit Rate 1, Real Time) • 3=VBR2RT (Variable Bit Rate 2, Real Time) • 4=VBR3RT (Variable Bit Rate 3, Real Time) • 5=VBR1NRT (Variable Bit Rate 1, Non-Real Time) • 6=VBR2NRT (Variable Bit Rate 2, Non-Real Time) • 7=VBR3NRT (Variable Bit Rate 3, Non-Real Time) • 8=UBR1 (Unspecified Bit Rate 1) • 9=UBR2 (Unspecified Bit Rate
Chapter 7 SPVC and SVC Commands addcon -cdvt Local Cell Delay Variation Tolerance (CDVT). Specifies the CDVT from a local endpoint to a remote endpoint (1–5000000 microseconds). Cell Delay Variation Tolerance controls the time scale over which the PCR is policed. Note that no remote CDVT is necessary. -lcdv Local Cell Delay Variation (CDV). Specifies the CDV from a local endpoint to a remote endpoint (1–16777215 microseconds).
Chapter 7 SPVC and SVC Commands addcon -frame Frame discard: Enter a 1 to enable or a 0 to disable. The default is disabled (0). -mc Maximum cost (maxcost): a value that creates a priority for the connection route. The switch can select a route only if the cost does not exceed maxcost. The range for maxcost is 0–2147483647. If you do not specify maxcost, the connection has the highest routing priority by default. Therefore, the maxcost parameter lets you lower the routing priority of a connection.
Chapter 7 SPVC and SVC Commands addcon Error Messages The system can display error messages for the following reasons: • Some of the traffic management parameters apply to specific service types (rt-VBR, for example). If you type a parameter that does not apply to a selected traffic type, the connection is rejected. • Insufficient resources are available to accept the provisioning request. • The type of card does not support a certain feature. • The port cannot support SPVCs.
Chapter 7 SPVC and SVC Commands addcon In the following two examples, the connection works with default values of PCR, SCT, MCR taken from the SCT. Defaults applied for the connection can be viewed by using the dspcon command. MGX8850.1.11.AXSM.a > addcon 1 10 40 1 s slave endpoint added successfully slave endpoint id : 00000E1000001C008051B730FFFFFF010B180100.10.40 MGX8850.1.11.AXSM.a > addcon 1 10 50 1 m -slave 00000E1000001C008051B730FFFFFF010B180100.10.
Chapter 7 SPVC and SVC Commands clrpncon clrpncon Clear Connection Delete a call—either all SVCs or a specific SVC on a port. (If you attempt to clear an SPVC with this command, the switch deletes the connection but then automatically attempts to reroute it. For an SPVC or SPVP, use delcon so you can delete the endpoints.) Cards on Which This Command Runs PXM45 Syntax clrpncon {all | vpi} [vci] Syntax Description portid The portid represents the PNNI physical port and has the format [shelf.
Chapter 7 SPVC and SVC Commands clrpncon Examples First, list the connections on the port to identify the specific connection to delete. For this example, use clrpncon to release the connection on port 1.2 with the VPI/VCI or 1 100. This connection is the first in the display output. Thereafter, use dsppncons to check the results. Geneva.7.PXM.a > dsppncons Port VPI VCI CallRef X-Port VPI VCI CallRef 1:1.2:2 1 100 33 1:1.2:2 1 101 32 Calling-Addr:47.00918100000000107be92f3d.000001011802.
Chapter 7 SPVC and SVC Commands clrpnconstats clrpnconstats Call Control Operations Clears existing call statistics for one logical port or all logical ports. Cards on Which This Command Runs PXM45 Syntax clrpnconstats [portid] Syntax Description portid The portid represents the PNNI physical port and has the format [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 7-4.
Chapter 7 SPVC and SVC Commands cnfabr cnfabr Configures the ABR-specific parameters for an existing SPVC. The connection must be of service type ABR (in the addcon command, service type=10). Cards on Which This Command Runs AXSM Syntax cnfabr [-icr ] [-adtf ] [-rdf ] [-rif
Chapter 7 SPVC and SVC Commands cnfabr -nrm Keyword that specifies the maximum number of cells that the source can send for each forward RM-cell. Nrm is a power of 2 in the range 2–256. -trm Keyword that specifies the maximum number of milliseconds for one RM-cell to travel from source to endpoint. The range is 100 x 2 -7 to 100 x 20 milliseconds. -cdf Keyword that specifies the Cutoff Decrease Factor (CDF).
Chapter 7 SPVC and SVC Commands cnfabrtparmdft cnfabrtparmdft Configure ABR Traffic Parameter Defaults Configures the default ABR traffic parameter(s), used for SPVC, per port. Note Currently, this command is available but has no effect. When a user requests an ABR connection, the controller adds the default ABR traffic parameters before the connection is committed. The user can change the ABR traffic parameters, per connection, using the cnfabr command available on the AXSM.
Chapter 7 SPVC and SVC Commands cnfabrtparmdft -trm Keyword that specifies the maximum number of milliseconds for one RM-cell to travel from source to endpoint. The range is 100 x 2 -7 to 100 x 20 milliseconds. -adtf Keyword that specifies the ACR Decrease Time Factor (ADTF). This is the time permitted to decrease the cell rate from the RM-cell rate to the Allowed Cell Rate (ACR) for normal traffic. The range is 1 to 1023 milliseconds. -cdf Keyword that specifies the Cutoff Decrease Factor (CDF).
Chapter 7 SPVC and SVC Commands cnfcdvtdft cnfcdvtdft Configure Cell Delay Variation Tolerance Default For all connections of a particular service type on a PNNI logical port, cnfcdvtdft configures the default number of microseconds for the cell delay variation tolerance (CDVT). The direction is ingress. The new configuration applies to new incoming calls but not existing calls.
Chapter 7 SPVC and SVC Commands cnfcdvtdft Examples Specify a CDVT of 125000 microseconds for ABR connections on port 4:1.1:11. Check the results by executing dspcdvtdft for the port. Geneva.7.PXM.a > cnfcdvtdft 4:1.1:11 abr 125000 Geneva.7.PXM.a > dspcdvtdft 4:1.1:11 CDVT: cbr: 250000 rt-vbr: 250000 nrt-vbr: 250000 ubr: 250000 abr: 125000 Geneva.7.PXM.a > Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 7 SPVC and SVC Commands cnfcon cnfcon Configure Connection Modifies the bandwidth, policing, and routing parameters of an existing endpoint. This command applies to only an SPVC or SPVP. For ABR-specific parameters, use the cnfabr command.
Chapter 7 SPVC and SVC Commands cnfcon Local-Only Parameters The parameters CDVT, stats enable, cc enable (specified using -cdvt, -stat, -cc) are significant only at the endpoint where you enter them. Therefore, they can be different at each end of the connection.
Chapter 7 SPVC and SVC Commands cnfcon - rscr Keyword that specifies the Sustained Cell Rate (SCR) from a remote endpoint to a local endpoint (7–5651328 cells per second). Sustained Cell Rate is the maximum cell rate that a connection can sustain for long periods. - lmbs Keyword that specifies the Maximum Burst Rate (MBS) from a local endpoint to a remote endpoint (1–5000000 cells). Maximum Burst Size is the maximum number of cells that can burst at the PCR and still be compliant.
Chapter 7 SPVC and SVC Commands cnfcon - mc (Optional) Keyword that specifies the maximum cost (maxcost): a value that creates a routing priority. If you do not specify this optional parameter, the connection defaults to having the highest routing priority. Therefore, the maxcost parameter lets you lower the priority of a connection—but only in regards to finding a route for it. The range for maxcost is 0–2147483647. The PXM45 does not use a particular route if the cost for the route exceeds the maxcost.
Chapter 7 SPVC and SVC Commands cnfconsegep cnfconsegep Configure Connection Segment Endpoint Configures a connection as a segment endpoint. When both VPI and VCI are present, the segment endpoint is an F5 flow endpoint (for VCCs). When the optional VCI is not present, the segment endpoint is an F4 flow endpoint (for VPCs). Use this command only for established calls. Note Before executing this command, be sure continuity checking is de-activated.
Chapter 7 SPVC and SVC Commands cnfmbsdft cnfmbsdft Configure Maximum Burst Size Default Configures the default maximum burst size (MBS) for SPVCs on a port. The applicable service types are real-time and non real-time variable bit rate (rt-VBR and nrt-VBR). The most likely connection type for which you would use cnfmbsdft is SVC. You can also rely on the value set with this command as a default for SPVCs if you do not specify an MBS through addcon for each SPVC of service type VBR.
Chapter 7 SPVC and SVC Commands cnfoamsegep cnfoamsegep Configure OAM Segment Endpoint Define the port as a segment endpoint for F4 and F5 operations administration and maintenance (OAM) cells. This command does not take effective for existing connections, and only does for newly established calls. This command can be used regardless of the state of the port.
Chapter 7 SPVC and SVC Commands delcon delcon Delete Connection Use the delcon command to delete an SPVC or SPVP. Delete the connection at both ends—first at the master end, then at the slave. Cards on Which This Command Runs AXSM Syntax delcon Syntax Description ifnum Logical port number. On the AXSM, the range is 1–60. vpi Virtual path identifier in the range 0–255 (UNI) or 0–4095 (NNI or VNNI).
Chapter 7 SPVC and SVC Commands delcons delcons Delete Connections Delete a range of ATM connections. Caution Before entering this command, you need to know exactly how many connections you need to delete. This command starts deleting connection endpoints in lexicographic order (dspcons displays in the same order). Incorrect usage of this command could result in deletion of more endpoints than necessary, and repairing such damage could be very costly.
Chapter 7 SPVC and SVC Commands delconsegep delconsegep Delete Connection Segment Endpoint Deletes a segment endpoint on a connection. When both VPI and VCI are present, the segment endpoint is an F5 flow endpoint (for VCCs). When the optional VCI is not present, the segment endpoint is an F4 flow endpoint (for VPCs). Note The delconsegep command works for SVCs only.
Chapter 7 SPVC and SVC Commands dncon dncon Down Connection Administratively deactivates (or “downs”) so you can modify or troubleshoot the network. This operation applies to only SPVCs. To reactivate the connection, use upcon. Cards on Which This Command Runs AXSM Syntax dncon Syntax Description ifNum The logical port number. The range for AXSM is 1–60. vpi Virtual path identifier. On a UNI, the range is 0–255. On an NNI, the range is 0–4095.
Chapter 7 SPVC and SVC Commands dspabrtparmdft dspabrtparmdft Display ABR Parameter Defaults Displays the default ABR parameters for a logical port under PNNI. Cards on Which This Command Runs PXM45 Syntax dspabrtparmdft Syntax Description portid has the format [shelf.]slot[:subslot].port[:subport]. Related Commands addcon, cnfabr, cnfabrtparmdft Attributes Log: no log State: active, standby Privilege: ANYUSER Example Display the default ABR parameters on portid 1:1.1:1.
Chapter 7 SPVC and SVC Commands dspcdvtdft dspcdvtdft Display CDVT Default Displays the default CDVT for the port. Cards on Which This Command Runs PXM45 Syntax dspcdvtdft Syntax Description portid The portid represents the PNNI physical port and has the format [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 7-4. Related Commands dspcdvtdft, cnfcdvtdft Attributes Log: no log State: active, standby Privilege: ANYUSER Example Display the CDVT defaults for port 11:1.
Chapter 7 SPVC and SVC Commands dspcon dspcon Display Connection Display information about an SPVC. The contents of the display on the AXSM and the PXM45 differ slightly. On both cards, the dspcon output appears in sections to make the information easier to sort. Most of the information in the dspcon output comes from addcon execution. See the addcon description for more information. Also, executing cnfpnni-intf can affect the dspcon output.
Chapter 7 SPVC and SVC Commands dspcon Display Connection on the AXSM On the AXSM, dspcon shows the following connection identifiers: • NSAP address, logical port, VPI/VCI, status, and ownership of local and remote ends of the connection. The display shows whether a particular endpoint is the master or slave. The provisioning parameters in the display show: • Connection type of VPC or VCC. • Service type (for example, ABR). • A number indicating the controller. For example, 2 refers to PNNI.
Chapter 7 SPVC and SVC Commands dspcon Syntax Description ifNum (AXSM) Logical interface (port) number. For AXSM, the range is 1–60. portid (PXM45) The portid represents the PNNI physical port and has the format [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 7-4. vpi VPI number. At the UNI, the range is 0–255. At the NNI, the range is 0–4095. vci VCI number. For a VCC, the range is 32–65535. For a VPC, the VCI is 0.
Chapter 7 SPVC and SVC Commands dspcon On the CLI of the PXM45, display connection 20 100 on 11:1.1:2. Unknown.7.PXM.a > dspcon 11:1.1:2 20 100 Port Vpi Vci Owner State ------------------------------------------------------------------------Local 11:1.1:2 20.100 MASTER FAIL Address: 47.00918100000000107b65f33d.0000010b1802.00 Remote 11:1.1:2 10.100 SLAVE FAIL Address: 47.00918100000000107b65f33d.0000010b1802.
Chapter 7 SPVC and SVC Commands dspconinfo dspconinfo Display Connection Information—display summaries of connection configuration (SPVCs or SPVPs only) The dspconinfo runs on the PXM45 and lists the total number SPVCs on each PNNI port on the node.
Chapter 7 SPVC and SVC Commands dspcons dspcons Display Connections—display basic information for all connections. The default usage of dspcons uses no parameters and causes all available information for the connections to appear. To narrow the scope of the output, use one or more optional parameters. The dspcons command runs on the CLI of either the AXSM or the PXM45. The set of optional parameters and the output are different on these cards. (See Syntax Description for the card-specific parameters.
Chapter 7 SPVC and SVC Commands dspcons Cards on Which This Command Runs PXM45, AXSM PXM45 Syntax dspcons [-port portid] [-vpi starting-vpi] [-vci starting vci] [-state {fail|ais|abit|ok|down}] [-owner {master|slave}] [-sc service class] PXM45 Syntax Description -port The port identifier (portid) in the format that the network controller utilizes: [shelf.]slot[:subslot].port[:subport] Currently, the value for shelf is always 0 and therefore is not necessary.
Chapter 7 SPVC and SVC Commands dspcons AXSM Syntax dspcons [-conn ] [-filt ] [-if ] [-vpi ] [-vci ] AXSM Syntax Description -conn The connection ID (conn ID) of the connection to begin the display. The format of conn ID is: ifNum.vpi.vci The logical port number. The range for AXSM is 1–60. The VPI has the range 0–4095. The VCI has the range 32–65535. -filt Unlike on the PXM45, you do not use keywords for this parameter on the AXSM.
Chapter 7 SPVC and SVC Commands dspcons PXM45 Example Display all connections by entering dspcons on the CLI of the PXM45. MGX8850.7.PXM.a > dspcons Local Port Vpi.Vci Remote Port Vpi.Vci State Owner ----------------------------+-----------------------------+-------+-----3:1.1:1 20 0 6:1.1:1 20 0 OK MASTER Local Addr: 47.00918100000000107b65f33d.000001031801.00 Remote Addr: 47.00918100000000107b65f33d.000001061801.00 5:1.1:1 100 100 5:1.1:1 100 200 OK SLAVE Local Addr: 47.00918100000000107b65f33d.
Chapter 7 SPVC and SVC Commands dspconsegep dspconsegep Display Connection Segment Endpoint Displays OAM segment endpoint for a connection endpoint. When both VPI and VCI are present, the segment endpoint is an F5 flow endpoint (for VCCs). When the optional VCI is not present, the segment endpoint is an F4 flow endpoint (for VPCs). This command is used only for established calls. Note The delconsegep command works for SVCs only.
Chapter 7 SPVC and SVC Commands dspmbsdft dspmbsdft Display MBS Default Displays the default MBS configured for the port. Cards on Which This Command Runs PXM45 Syntax dspmbsdft Syntax Description portid The portid represents the PNNI physical port and has the format [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 7-4. Related Commands cnfmbsdft Attributes Log: no log State: active, standby Privilege: ANYUSER Example Display the MBS default for port 11:1.1:11.
Chapter 7 SPVC and SVC Commands dspoamsegep dspoamsegep Display OAM Segment Endpoint Displays whether or not the given port (portid) is designated as an OAM Segment Endpoint. See cnfoamsegep. Operation, administration, and maintenance (OAM) is an ATM Forum specification for cells used to monitor virtual circuits. OAM cells provide a virtual circuit-level loopback which demonstrates whether a circuit is up or not.
Chapter 7 SPVC and SVC Commands dsppncon dsppncon Display PNNI Connection—display information about an existing call. Displays information for an active SVC, SPVC, or SPVP. The displayed call information corresponds to the objects described in the portCallTable and portAbrCallTable MIBs. This command can be issued at any node in the route path.
Chapter 7 SPVC and SVC Commands dsppncon Example Display VPI/VCI 100 100 on port 1.5. mpgses1.2.PXM.a > dsppncon 1.5 100 100 Port : 1.5 VPI : 100 VCI : 100 CallRef: 116 CallRefFlag: 0 CallLeafRef : 0 Calling-address: 47.009181000000003071f80e4a.000000010500.00 Calling-subaddress #1: N/A Calling-subaddress #2: N/A Called-address: 47.009181000000003071f80e49.000000010500.00 Called-subaddress #1: N/A Called-subaddress #2: N/A OE Port : 1.
Chapter 7 SPVC and SVC Commands dsppncon ABR Call: Port: 5.
Chapter 7 SPVC and SVC Commands dsppncons dsppncons Display PNNI Connections Displays a summary of active calls on one port or all ports. This command can be issued at any node. Cards on Which This Command Runs PXM45 Syntax dsppncons [-port portid] [-vpi starting-vpi] [-vci starting-vci] [-type {p2p | p2mp | ctrl}] Syntax Description -port The portid represents the PNNI physical port and has the format [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 7-4.
Chapter 7 SPVC and SVC Commands dsppncons Examples Port VPI VCI CallRef X-Port VPI VCI CallRef 1:1.2:2 1 100 33 1:1.2:2 1 101 32 Calling-Addr:47.00918100000000107be92f3d.000001011802.00 Called-Addr:47.00918100000000107be92f3d.000001011802.00 1:1.2:2 1 101 32 1:1.2:2 1 100 33 Calling-Addr:47.00918100000000107be92f3d.000001011802.00 Called-Addr:47.00918100000000107be92f3d.000001011802.00 1:1.2:2 2 200 34 1:1.6:6 0 49 8388609 Calling-Addr:47.00918100000000107be92f3f.000001011804.00 Called-Addr:47.
Chapter 7 SPVC and SVC Commands dsppnconstats dsppnconstats Display PNNI Connection Statistics Displays call statistics for a PNNI logical port. Cards on Which This Command Runs PXM45 Syntax dsppnconstats Syntax Description portid The portid represents the PNNI physical port and has the format [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 7-4.
Chapter 7 SPVC and SVC Commands dsppnconstats Incoming Call Failures Number of incoming point-to-point and point-to-multipoint SVC/SPVC call attempts that failed on this port. Incoming Call Filtering Failures Number of incoming point-to-point and point-to-multipoint SVC/SPVC call attempts that failed the address filtering on this port.
Chapter 7 SPVC and SVC Commands upcon upcon Up Connection—bring a connection back into service. Activate a connection that was previously downed by the dncon command. The typical use of dncon is some form of operational modification or troubleshooting. Cards on Which This Command Runs AXSM Syntax upcon Syntax Description ifNum The logical port number. The range for AXSM is 1–60. vpi Virtual path identifier. On the AXSM, the range is 0–255. vci Virtual connection identifier.
Chapter 7 SPVC and SVC Commands upport upport Up Port The upport command enables (or “ups”) a logical port. The usage of upport follows dnport. See the dnport description for information on the use of these commands. Use dspports or dspport as needed to determine the port to enable or to see the status of the port after you enable it. Cards on Which This Command Runs AXSM Syntax upport Syntax Description ifNum The logical port number. The range for AXSM is 1–60.
Chapter 7 SPVC and SVC Commands upport Cisco MGX 8850 Routing Switch Command Reference 7-58 Release 2.
C H A P T E R 8 Network Optimization Commands This chapter describes the commands that let you improve the use of network resources. The commands consist primarily of route optimization commands. The chapter begins with a generic description of command syntax. Position-Dependent and Keyword-Driven Parameters A command can include parameters that are keyword-driven or position-dependent.
Chapter 8 Network Optimization Commands Identifying the AXSM Models Identifying the AXSM Models The model number of an AXSM identifies the line speed, line count, and number of bays (see Table 8-1.) Note that the number of lines applies to an individual back card, so the total number of lines supported by the front card equals the highest line number times the number of bays. The OC-48 card AXSM-1-2488 has the lowest number of lines—one.
Chapter 8 Network Optimization Commands Identifying Physical and Logical Elements Table 8-3 Maximum Connections on Back Cards and Lines Card Type Back Card Maximum Physical Line Maximum OC-48c 128 K 64 K OC-12c 64 K 32 K OC-3c 64 K 32 K T3 64 K 64 K E3 64 K 64 K Identifying Physical and Logical Elements The Private Network-to-Network Interface (PNNI) control protocol and the service modules use different formats to identify the same entity.
Chapter 8 Network Optimization Commands Identifying Physical and Logical Elements PNNI Format The PNNI controller requires the following format to identify a physical port: [shelf.]slot[:subslot].port[:subport] The PNNI physical port identifier (physical port ID) consists of a series of mandatory elements. Note the period or colon associated with each element inside the square brackets.
Chapter 8 Network Optimization Commands cnfpnportloscallrel cnfpnportloscallrel Configure PNNI Port Loss of Signal Call Release The cnfpnportloscallrel command lets you shut off the standard delay for rerouting calls on a port when the system detects loss of signal (LOS) on a port. When the system detects LOS on an NNI link, the switch does not immediately tear down the calls on the link—in case the break is momentary.
Chapter 8 Network Optimization Commands cnfrrtparm cnfrrtparm Configure Reroute Retry Parameters—configures the waiting time intervals for rerouting a failed SPVC. The cnfrrtparm command allows you configure the time periods that the switch waits between each reroute retry attempt. When an SPVC fails, the system immediately attempts to reroute the connection.
Chapter 8 Network Optimization Commands cnfrrtparm Example Set the slow timer to 300 second intervals and the fast timer base to 7 seconds (70 x 100 milliseconds). Check the results by executing dsprrtparm. 8850_NY.7.PXM.a > cnfrrtparm -slowtmr 300 -fasttmrbase 70 8850_NY.7.PXM.a > dsprrtparm Global SPVC Retry Parameters: -------------------------------Slow Retry Interval: 300 sec Fast Retry Interval Base: 70 (in 100 msec) 8850_NY.7.PXM.a > Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 8 Network Optimization Commands cnfrteopt cnfrteopt Configure Route Optimization Configure periodic route optimization to improve bandwidth utilization. This type of optimization is a type of connection grooming. To automate route optimization, cnfrteopt lets you specify an interval between new optimization cycles—every 2 hours, for example. (To force immediate route optimization, use the optrte command.) You can choose a time period for optimization so that disruption is minimal.
Chapter 8 Network Optimization Commands cnfrteopt [-range ] [-interval ] [-tod ] Syntax Description portid Port identifier has the format [shelf.]slot[:subslot].port[:subport]. enable | disable Enables or disables route optimization. The default is disabled, but if grooming is operational and you want to disable it, you must execute cnfrteopt and enter “disable.” -range Keyword that specifies a range of connections for grooming.
Chapter 8 Network Optimization Commands cnfrteopt Cards on Which Command Executes PXM45 Related Commands cnfrteoptthld, optrte, dsprteoptcnf, dsprteoptstat Attributes Log: log State: active Privilege: GROUP1 Examples For logical port 2 on the lower bay of the service module in slot 1, configure 1 hour of connection grooming starting between 1:00 and 3:00 AM local time. The range of SPVCs is 100.1000 through 100.10000. cnfrteopt 1:2.1:2 enable -range 100/1000..100/10000 -interval 60 -tod 01:00..
Chapter 8 Network Optimization Commands cnfrteoptthld cnfrteoptthld Configure Route Optimization Threshold Configure a threshold the system uses to decide whether one route is a sufficient improvement to warrant re-routing. The criterion for selecting a new route is a threshold in the form of the percent of difference in route cost. The default for route optimization is a 30% reduction of the cost of a route.
Chapter 8 Network Optimization Commands dspload dspload Display Load—displays maximum channels and bandwidth and currently available channels and bandwidth on a partition. This command displays the configured maximum and guaratneed number of channels and the configured maximum and guaranteed bandwidth on a partition on a logical interface. It also displays the currently available number of channels and the currently available bandwidth on the partition.
Chapter 8 Network Optimization Commands dspload Example Display the load on partition number 1 on logical port 1. MGX8850.1.AXSM.
Chapter 8 Network Optimization Commands dspload Table 8-5 Interface Load Info Descriptions (continued) Field Descriptions Available Igr Bandwidth The amount of bandwidth that is currently available in the ingress direction. Available Egr Bandwidth The amount of bandwidth that is currently available in the egress direction.
Chapter 8 Network Optimization Commands dsppnportloscallrel dsppnportloscallrel Display PNNI Port Loss of Signal Call Release This command displays the enable status of the LOS call release feature. See cnfpnportloscallrel for a description of this feature. Cards on Which Command Executes PXM45 Syntax dsppnportloscallrel Sybtax Description portid See PNNI Format, page 8-4. The portid represents the PNNI logical port and has the format [shelf.]slot[:subslot].port[:subport].
Chapter 8 Network Optimization Commands dsprrtparm dsprrtparm Display Reroute Parameters—displays the current values for two types of reroute intervals. The dsprrtparm command shows the current slow interval time and fast timer base. See the description of cnfrrtparm for the function of these intervals. Cards on Which Command Executes PXM45 Syntax dsprrtparm Syntax Description This command takes no parameters.
Chapter 8 Network Optimization Commands dsprteoptcnf dsprteoptcnf Display Route Optimization Configuration Display the current configuration for route optimization. The configuration itself originates with the cnfrteopt command. The dsprteoptcnf display shows the following: • The node-level threshold for route optimization. It is the percent of reduction in the route cost. • Identity of the optimization target by port and VPI/VCI range. • Enable status of optimization.
Chapter 8 Network Optimization Commands dsprteoptstat dsprteoptstat Display Route Optimization Status Display the current percent of route cost reduction. This percent is a threshold that the PXM45 requires to determine that one route costs sufficiently less to warrant re-routing. The percent applies to all connections on the node. The system default is 30%, but you can configure a percent through the cnfrteoptthld command. For more details on route optimization, see the cnfrteopt description.
Chapter 8 Network Optimization Commands optrte optrte Optimize Routes Force immediate optimization of either a single SPVC route, a range of SPVCs, or all SPVCs on a particular port. (Connection grooming is a common word for optimization.) Re-routing depends on a reduction in the cost of the route. If the PXM45 can find a route with sufficiently lower cost, the SPVC is de-routed then re-routed. The system default is a 30% reduction in the cost but is configurable through the cnfrteoptthld command.
Chapter 8 Network Optimization Commands optrte Attributes Log: log State: active Privilege: GROUP1 Example Immediately find a better route for the SPVC with vpi.vci 1000.50000 on portid 1:2.1:1 pop20two.7.PXM.a > optrte -vpi 1000 -vci 50000 Cisco MGX 8850 Routing Switch Command Reference 8-20 Release 2.
Chapter 8 Network Optimization Commands routeShow routeShow Route Show Show the current IP routing of the network layer of the operating system. Cards on Which This Command Runs PXM45 Syntax routeShow Related Commands routestatShow Attributes Log: no log State: active, standby, init Privilege: ANYUSER Example Display the current IP routing of the network layer of the operating system. pinnacle.8.PXM.
Chapter 8 Network Optimization Commands routestatShow routestatShow Show Routing Statistics Display statistics for the current IP routing in the network layer of the system. Cards on Which This Command Runs PXM45 Syntax routestatShow Related Commands routeShow Attributes Log: no log State: active, standby, init Privilege: ANYUSER Display the current IP routing statistics. pinnacle.8.PXM.
Chapter 8 Network Optimization Commands rrtcon rrtcon Re-route Connection—force the system to re-route a connection The rrtcon command lets you trigger the immediate re-routing of a connection. Cards on Which This Command Runs AXSM Syntax rrtcon Syntax Description ifNum The logical port number. The range for AXSM is 1–60. vpi The VPI of the connection. For UNI, the range is 0–255. For NNI, the range is 0–4095. vci The VCI of the connection.
Chapter 8 Network Optimization Commands rrtcon Cisco MGX 8850 Routing Switch Command Reference 8-24 Release 2.
C H A P T E R 9 Troubleshooting Commands This chapter describes commands that directly or indirectly facilitate troubleshooting. They include commands for viewing and clearing alarms and statistics. The chapter begins with a description of the CLI, various elements of the AXSM, and the PNNI port identifier. Position-Dependent and Keyword-Driven Parameters A command can include parameters that are keyword-driven or position-dependent.
Chapter 9 Troubleshooting Commands Identifying the AXSM Models Identifying the AXSM Models The model number of an AXSM identifies the line speed, line count, and number of bays (see Table 9-1.) Note that the number of lines applies to an individual back card, so the total number of lines supported by the front card equals the highest line number times the number of bays. The OC-48 card AXSM-1-2488 has the lowest number of lines—one.
Chapter 9 Troubleshooting Commands Identifying Physical and Logical Elements • Line • Logical port • Port group • Resource partition Not all of these elements correspond to elements you specify on the PXM45. Subsequent paragraphs describe only the common elements that are visible on the CLI of the PXM and the service module. The preceding elements are further defined in the Cisco MGX 8850 Routing Switch Software Configuration Guide, Release 2.0.
Chapter 9 Troubleshooting Commands Identifying Physical and Logical Elements As Table 9-2 shows, a port to PNNI is a line on the AXSM, and a subport to PNNI is a logical interface (or logical port) on an AXSM. An example of a PNNI physical port identifier is 1:2.1:1. This portid corresponds to an AXSM, with the following particulars: • Slot 1 • Bay 2 • Line 1 • Logical interface 1 (or logical port 1) Cisco MGX 8850 Routing Switch Command Reference 9-4 Release 2.
Chapter 9 Troubleshooting Commands abortofflinediag abortofflinediag Abort Offline Diagnostics Aborts the currently running offline diagnostics. Note See the cnfdiag command for a detailed description of MGX 8850 diagnostics. Syntax abortofflinediag Syntax Description slot The slot of the card for which to abort the offline diagnostics.
Chapter 9 Troubleshooting Commands addchanloop addchanloop Add Channel Loopback—add a loopback to a specific channel in a network test configuration. The channel loopback tests the integrity of the connection (channel) at the local UNI or across the network. The system returns an error message if the connection is broken or incorrect data arrives at the end of the loopback. The maximum number of connection loopbacks that can exist on an AXSM is 256.
Chapter 9 Troubleshooting Commands addchanloop vci The VCI of the connection. The range is 32–65535. loopback mode The mode of the loopback is the direction. • 1 = the ingress direction. • 2 = the egress direction. Related Commands delchanloop, dspchanloop Tabulates Log: log State: active, standby Privilege: SERVICE_GP Example Add a loopback on the connection with VPI/VCI of 1 50 on logical port 4.
Chapter 9 Troubleshooting Commands addlnloop addlnloop Add Line Loop Specifies a loopback state for a line on the current service module. Note Before you can change the loopback type for an existing loopback, you must first delete the loopback by executing dellnloop or just addlnloop with the No loopback mode. Cards on Which This Command Runs AXSM AXSM Syntax addlnloop <-ds3 | -sonet bay.line> <-lpb loopback type> Note For AXSM cards, the keyword ds3 applies to both T3 and E3 line types.
Chapter 9 Troubleshooting Commands clrallcnf clrallcnf Clear All Configurations Clear all configurations for all the cards in the node. After you enter the command, the system prompts you to confirm the action. Caution Be absolutely sure you need to execute this command because it clears all configuration files on the PXM45. After clrallcnf, you need to reconfigure the switch.
Chapter 9 Troubleshooting Commands clralmcnt clralmcnt Clear Alarm Counters Clear all the alarm counters and statistics on the specified line on the current card. All counters are reset to 0. All statistical alarms that are displayed by dspalms and dspalmcnt are cleared. The system does not display a response unless it detects a syntax error. Cards on Which This Command Runs AXSM Syntax clralmcnt Syntax Description bay.line Identifies the bay (1 or 2) and the number of the line.
Chapter 9 Troubleshooting Commands clrbecnt clrbecnt Clear Bit Error Count The clrbecnt command lets you clear the APS-related bit error counters for a working line. To see the contents of the error counters, use the dspbecnt command. Cards on Which This Command Runs AXSM Syntax clrbecnt Syntax Description working-bay.line Identifies the bay (1 or 2) and the number of the line. The line number is from 1 to the highest numbered line on the back card.
Chapter 9 Troubleshooting Commands clrcdcnt clrcdcnt Clear Card Counters Clears the counters for received and transmitted cells on the current card. See dspcdcnt for examples of the counter contents. The information that clrcdcnt clears and that dspcdcnt displays primarily applies to debugging. Cards on Which This Command Runs AXSM Syntax clrcdcnt Syntax Description This command takes no parameters.
Chapter 9 Troubleshooting Commands clrchancnt clrchancnt Clear Channel Counters—clears the error counters for a single connection. Clear all counters for ATM cells on a connection (channel). The command applies to an SVC or an SPVC. For a list of displayed counters, see the example of dspchancnt. Once you execute clrchancnt, the previous counter contents are unrecoverable. Note This command does not apply to OC-48 cards.
Chapter 9 Troubleshooting Commands clrchancnts clrchancnts Clear Channel Counters—clears the error counters for all connections on a card. Clears the statistics counters on all connections. Cards on Which This Command Runs AXSM Syntax clrchancnts Syntax Description No parameters. Related Commands dspchancnt, clrchancnt Attributes Log: no log State: active Privilege: SUPER_GP Example SunnyVale.13.AXSM.a > clrchancnts Cisco MGX 8850 Routing Switch Command Reference 9-14 Release 2.
Chapter 9 Troubleshooting Commands clrdiagerr clrdiagerr Clear Diagnostics Errors Clears all diagnostics error messages that are currently in memory. Note See the cnfdiag command for a detailed description of MGX 8850 diagnostics. Syntax clrdiagerr Syntax Description slot The slot of the card for which to clear the diagnostics errors.
Chapter 9 Troubleshooting Commands clrdiagstat clrdiagstat Clear Diagnostics Statistics Clears all the diagnostics statistics currently in memory. The diagnostics statistics program keeps count of how many times diagnostics has run. Note See the cnfdiag command for a detailed description of MGX 8850 diagnostics. Syntax clrdiagstat Syntax Description slot The slot of the card for which to clear the diagnostics statistics.
Chapter 9 Troubleshooting Commands clrerr clrerr Clear Error Clear all error log files for a slot. After you execute clrerr, the information is unrecoverable. The cleared information consists of system-level or internal errors and so applies more to developers and individuals capable of internal troubleshooting. To see the information that clrerr removes, see dsperr. After you enter clrerr, the system prompts you to confirm that you want to clear all error log files.
Chapter 9 Troubleshooting Commands clrerrhist clrerrhist Clear Error History—clear the history of errors for a card. The clrerrhist commands resets the contents of the error history file for a particular card. Although you execute this command on the CLI of the PXM45, you can specify the error history of any slot. For a list of the information fields in an error history file, see the description of dsperrhist.
Chapter 9 Troubleshooting Commands clrilmicnt clrilmicnt Clear ILMI Counters Clears the ILMI statistics for a partition and logical port on a service module. Cards on Which This Command Runs AXSM Syntax clrilmicnt Syntax Description ifNum The logical port number. The range for AXSM is 1–60. partId Number of the partition in the range 1–20.
Chapter 9 Troubleshooting Commands clrlncnt clrlncnt Clear Line Counters—clear cell and connection-related counters for a line. See dsplncnt for descriptions of the counters. The system returns a response only if an error occurs. Cards on Which This Command Runs AXSM Syntax clrlncnt Syntax Description bay.line Identifies the bay (1 or 2) and the number of the line. The range for line can be 1 to the highest numbered line on the back card.
Chapter 9 Troubleshooting Commands clrlog clrlog Clear Log Use the clrlog command to clear either a specific log file or all log files. The log resumes accumulating event messages after the command executes. Cards on Which This Command Runs PXM45 Syntax clrlog [-log ] Syntax Description -log Specifies the type of log file (log) to clear. See dsplog for a list of the types of logs files.
Chapter 9 Troubleshooting Commands clrportcnt clrportcnt Clear Port Counter Clear counter values on a specific logical port. Cards on Which This Command Runs AXSM Syntax clrportcnt Syntax Description ifNum The logical port number. The range for AXSM is 1–60. Related Commands clrportcnts, dspportcnt Attributes Log: log State: active Privilege: SUPER_GP Example Clear all the port counters on port 1. flyers01.17.AXSM.
Chapter 9 Troubleshooting Commands clrportcnts clrportcnts Clear Port Counters Clear all port counters on the current AXSM. The system does not return a message unless a syntax error occurs (such as a spurious character following the command on the CLI). Cards on Which This Command Runs AXSM Syntax clrportcnts Syntax Description This command takes no parameters.
Chapter 9 Troubleshooting Commands clrxbaralm clrxbaralm Clear Crossbar Alarm—clear the crossbar alarms. To see the alarms that clrxbaralm clears, execute dspxbaralarm or dspswalms. The clrxbaralm command clears the alarms for either a specific switch plane or for all the switch planes on the active switching card. In an MGX 8850 node, the switching slot is the slot number of the PXM45.
Chapter 9 Troubleshooting Commands clrxbarerrcnt clrxbarerrcnt Clear Crossbar Error Count—clear the counters for crossbar errors. To see the errors that clrxbarerrcnt clears, execute dspxbarerrcnt. The clrxbarerrcnt command clears the errors for either a specific switch plane or all the switch planes on the active switching card. In the MGX 8850 node, the switching slot is the slot number of the PXM45.
Chapter 9 Troubleshooting Commands cnfalm cnfalm Configure Alarm Configures statistical alarm thresholds for a line. The configurable items for SONET and PLCP are defined in RFC 2258. The configurable items for DS3 and E3 are defined in RFC 2496.
Chapter 9 Troubleshooting Commands cnfalm alarm severity A keyword and number to identify the severity of the alarm that is triggered when any of the specified thresholds is crossed: 1 = minor alarm, and 2 = major alarm. Precede the alarm severity with the appropriate keyword. For the alarm severity keyword for each line type, see the first item in each of the lists follows. (For example, -secsev refers to the severity of the section alarm on a SONET line.
Chapter 9 Troubleshooting Commands cnfalm -lnuas15 Unavailable seconds during a 15-minute period. -lnuas24 Unavailable seconds during a 24-hour period. Thresholds for SONET Path -sev Severity of the alarm (1 = minor, 2 = major) for SONET path. -es15 Errored seconds during a 15-minute period. -es24 Errored seconds during a 24-hour period. -ses15 Severely errored seconds during a 15-minute period.
Chapter 9 Troubleshooting Commands cnfalm -sefs15 Severely errored frame seconds during a 15-minute period. -sefs24 Severely errored frame seconds during a 24-hour period. -uas15 Unavailable seconds during a 15-minute period. -uas24 Unavailable seconds during a 24-hour period. -dsev Severity of the alarm (1 = minor, 2 = major) for DS3. -lcv15 Code violations for a line during a 15-minute period.
Chapter 9 Troubleshooting Commands cnfalm -puas15 PLCP unavailable seconds during a 15-minute period. -puas24 PLCP unavailable seconds during a 24-hour period. Related Commands dspalmcnf Attributes Log: log State: active Privilege: GROUP1 Example Configure the following thresholds for triggering a major line-level alarm on line 2 in bay 1: • The line type is SONET line. • The bay is 1, and the line number is 2. • The severity of the triggered alarm is major.
Chapter 9 Troubleshooting Commands cnfdiag cnfdiag Configure Diagnostics Enables the online or offline diagnostics. The cnfdiag command also configures the time settings for the start time and coverage for running the offline diagnostics. When you enter cnfdiag with no parameters, it displays the current configuration and status of the diagnostics. The cnfdiagall command is the same as cnfdiag except that it configures all slots on the card at once.
Chapter 9 Troubleshooting Commands cnfdiag Standby State When you enable online diagnostics on a standby AXSM card, the following tests run: • Crossbar loopback walk test on QE, Humvee, and Crossbar paths • Back card loopback test on T3/E3 lines Offline Diagnostics Offline diagnostics are destructive tests (that interfere with active traffic) and therefore run only on standby cards. Offline diagnostics must be scheduled using the offline start (offStart) and offline day-of-week (offDow) parameters.
Chapter 9 Troubleshooting Commands cnfdiag • 5. NovRAM Checksum Test Cell Path Test • CBC Cell Path Test - Backplane Side • Framer Cell Path Test - Port Side • Humvee / Transceiver / Crossbar Switch Cell Path Test AXSM Offline Diagnostics 1. I/O PLD data bus test 2. Skystone Framer register & RAM test. 3. Humvee ASIC register test 4. CBC register test 5. ATMizer RAM test 6. QE48 register and RAM test 7. NovRAM checksum test 8.
Chapter 9 Troubleshooting Commands cnfdiag Related Commands cnfdiagall, dspdiagcnf Attributes Log: no log State: active Privilege: SERVICE_GP Example cnfdiag 7 enable disable light 22:30 -M-W-F- Cisco MGX 8850 Routing Switch Command Reference 9-34 Release 2.
Chapter 9 Troubleshooting Commands cnfdiagall cnfdiagall Configure Diagnostics All This command enables and configures online or offline diagnostics for all card slots. (This command is the same as cnfdiag except that it effects all slots instead of just one.) When you enter this command with no parameters, it displays the current configuration and status of the diagnostics. Note See the cnfdiag command for a detailed description of MGX 8850 diagnostics.
Chapter 9 Troubleshooting Commands cnfdiagall Attributes Log: no log State: active, standby Privilege: SERVICE_GP Example cnfdiagall enable disable light 22:30 -M-W-F- Cisco MGX 8850 Routing Switch Command Reference 9-36 Release 2.
Chapter 9 Troubleshooting Commands cnfpnportloscallrel cnfpnportloscallrel Configure PNNI Port Loss of Signal Call Release The cnfpnportloscallrel command lets you shut off the standard delay for rerouting calls on a port when the system detects loss of signal (LOS) on a port. When the system detects LOS on an NNI link, the switch does not immediately tear down the calls on the link—in case the break is momentary.
Chapter 9 Troubleshooting Commands cnfxbarerrthresh cnfxbarerrthresh Configure Crossbar Error Threshold—specify a threshold for a particular crossbar error The Syntax Description contains a list of possible errors. A crossbar error threshold consists of: Note • A period for counting errors • Severity of the resulting alarm (minor, major, and critical) • Upper and lower counts for each alarm severity The default settings for crossbar error thresholds are optimal for nearly all applications.
Chapter 9 Troubleshooting Commands cnfxbarerrthresh almcnt The number of errors for an alarm severity above which the alarm goes to the next highest severity. Usage Guidelines for cnfxbarerrthresh You can change the threshold for only one type of error at a time. Also, you must enter all parameters of the threshold whether or not you change them. For example, if you want to change only the duration of errored milliseconds, you must include the existing parameters.
Chapter 9 Troubleshooting Commands cnfxbarmgmt cnfxbarmgmt Configure Crossbar Management—configure load sharing The application for is a redundant PXM45 setup. It allows the MGX 8850 to maintain its peak throughput of 45 Gbps without requiring a switchover to the standby cards if a switch ASIC becomes defective. In this scheme, one of the switch ASICs on the standby PXM45 takes over the switching for the defective ASIC on the active PXM45. Note On an MGX 8850 node, this command applies to Release 2.
Chapter 9 Troubleshooting Commands cnfxbarmgmt Related Commands dspxbarmgmt, dspxbarerrthresh, dspxbarerrcnt Attributes Log: log State: active Privilege: SERVICE_GP Example Specify an error threshold of five links to declare a bad switch plane and enable auto-shutdown. The system returns a message only if an error occurs. Use dspxbarmgmt to check the new configuration. pop20two.7.PXM.a > cnfxbarmgmt 1 1 5 pop20two.7.PXM.
Chapter 9 Troubleshooting Commands conntrace conntrace Call Control Operations Trace an established connection and display the result. Cards on Which This Command Runs PXM45 Syntax conntrace callref [EndPtRef] Syntax Description portid The portid represents the PNNI logical port and has the format [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 9-3. callref Call reference for the call. EndPtRef Endpoint reference for a p2mp call.
Chapter 9 Troubleshooting Commands copycons copycons Copy Channels (Debugging Command) Copies one or more endpoints from a specified endpoint. The number of entries to copy is specified using the -num option. This command works by incrementing the VCI for a VCC endpoints and the VPI for a VPC endpoints. The following steps are recommended when using this command: 1. First add a slave endpoint and then a master endpoint. 2. Copy the slave endpoints first using copychans. 3.
Chapter 9 Troubleshooting Commands copycons Attributes Log: log State: active Privilege: SERVICE_GP Example MGX8850.1.11.AXSM.a > copycons 3.10.50 3.10.60 -num 10 Cisco MGX 8850 Routing Switch Command Reference 9-44 Release 2.
Chapter 9 Troubleshooting Commands dbgcon dbgcon Debug Connection—enables or disables logging of SPVC-related errors. Enable or disable the SPVC log.To see whether the SPVC log is enabled, use dspcons-dbg. Cards on Which This Command Runs PXM45 Syntax dbgcon Syntax Description enable | disable Enable or disable the SPVC log. Type the entire word. The default is disabled.
Chapter 9 Troubleshooting Commands delchanloop delchanloop Delete Channel Loopback Delete a loopback from a connection (channel). For an understanding of the purpose of channel loopbacks, see the description of addchanloop. Cards on Which This Command Runs AXSM Syntax delchanloop Syntax Description ifNumber The logical port number. The range for AXSM is 1–60. vpi The VPI of the connection. The range is 0–4095. vci The VCI of the connection. The range is 1–65535.
Chapter 9 Troubleshooting Commands dellnloop dellnloop Delete Line Loop Remove the line loopback state from a line. Cards on Which This Command Runs AXSM AXSM Syntax dellnloop <-ds3 | -sonet> Note For AXSM cards, the keyword ds3 applies to both T3 and E3 line types. Syntax Description -ds3 | -sonet bay.line Specifies a SONET line (OC-3c, OC-12c, OC-48c) or a DS3 line (E3 or T3), the bay (1 for upper or 2 for lower), and the line number.
Chapter 9 Troubleshooting Commands dncon dncon Down Connection Temporarily deactivates (or downs) a connection so you can modify or troubleshoot it. The dncon command applies to only an SPVC. Execute at the master endpoint of a connection. Subsequently, when you view commands with dspconinfo or dspcon at the master endpoint, the display shows the connection state as down. If you execute either of these commands at the slave endpoint, the state appears as failed. To reactivate the connection, use upcon.
Chapter 9 Troubleshooting Commands dnln dnln Down Line Use dnln to de-activate a line on the current card. Before you can de-activate a line, you must: Step 1 Remove connections. Use delcon or delcons. Step 2 Remove any resource partitions. Use dsprscprtn to see existing partitions and delrscprtn to remove partitions. Step 3 Remove all logical ports. Use dspports to see existing logical ports on the line and delport to remove logical ports. Cards on Which This Command Runs AXSM Syntax dnln
Chapter 9 Troubleshooting Commands dnport dnport Down Port The dnport command disables (or downs) a logical port and thereby halts all traffic on the logical port. The usual purpose for using dnport is troubleshooting. The configuration for the port remains intact whether the logical port is a UNI or an NNI. The command for enabling a downed port is upport. For an NNI, the PXM45 de-routes the failed connections then re-routes them through other trunks.
Chapter 9 Troubleshooting Commands dspalm dspalm Display Alarm—displays the alarms from among the configured alarm types for a line. Use the dspalm command to view the alarms associated with a specified line. See cnfalm for a description of the types of alarms you can see. In addition to the configurable alarm types, the output also shows instances of loss of cell delineation (LOCD). Cards on Which This Command Runs AXSM AXSM Syntax dspalm -ds3|-e3|-sonet|-ds1|-e1
Chapter 9 Troubleshooting Commands dspalm Example Display alarms on OC-12 line 1.1. In this example, the components of a SONET line (section, line, and path) are clear. Also, no instances of loss of cell delineation (LOCD) have occurred. MGX8850.1.AXSM.a > dspalm -sonet 1.1 Line Number : 1.
Chapter 9 Troubleshooting Commands dspalmcnf dspalmcnf Display Alarm Configuration Display the threshold information about the alarm statistics being collected. Refer to the cnfalm description for details regarding alarm threshold configuration. Cards on Which This Command Runs AXSM Syntax dspalmcnf -sonetsec|-sonetline|-sonetpath|-ds3|-e3|-plcp Syntax Description -sonetsec -sonetline -sonetpath -ds3-e3 -plcp bay.
Chapter 9 Troubleshooting Commands dspalmcnf Examples Display alarm configuration for AXSM cards. MGX8850.1.AXSM.a > dspalmcnf -sonetline 1.2 LineNum: 1.2 Line Stat Alarm Severity: No Alarm 15min Threshold 24hr Threshold Line ESs : 60 600 Line SESs: 3 7 Line CVs : 75 750 Line UASs: 10 10 MGX8850.1.AXSM.a > dspalmcnf -sonetsec 1.1 LineNum: 1.
Chapter 9 Troubleshooting Commands dspalmcnt dspalmcnt Display Alarm Counters Displays the performance monitoring alarm counters for either a SONET or DS3 line. Cards on Which This Command Runs AXSM AXSM Syntax dspalmcnf -ds3|e3|-plcp|-sonet|ds1|-e1 Syntax Description -ds3 e3 -plcp -sonet ds1 -e1 Keywords that specify the type of alarm counters (see dspalmcnf for definitions) to display for the given line (bay.line) on an AXSM card. bay.
Chapter 9 Troubleshooting Commands dspalmcnt Display SONET line 1 in bay 1. MGX8850.6.AXSM.a > dspalmcnt -sonet 1.1 Line Num: 1.
Chapter 9 Troubleshooting Commands dspalms dspalms Display Alarms Display all line-related alarms on the card. RFC 2258 describes the alarm categories. The display can easily scroll for many pages if more than one line is active. See cnfalm for a description of types of alarms you might see. In addition to the alarms from cnfalm, the dspalms command also displays instances of loss of cell delineation (LOCD).
Chapter 9 Troubleshooting Commands dspalms Alarm State Section : Clear Line : Clear Path : Clear Statistical Alarm State Section : Clear Line : Clear Path : Clear LOCD Alarm : Clear Line Number: 2.2 Alarm State Section : Clear Line : Clear Path : Clear Statistical Alarm State Section : Clear Line : Clear Path : Clear LOCD Alarm : Clear Cisco MGX 8850 Routing Switch Command Reference 9-58 Release 2.
Chapter 9 Troubleshooting Commands dspbecnt dspbecnt Display Bit Error Count The dspbecnt command lets you display the APS-related bit error counters. Cards on Which This Command Runs AXSM Syntax dspbecnt Syntax Description working-bay.line Identifies the bay (1 or 2) and the number of the line. The line number is from 1 to the highest numbered line on the back card. For the range of line numbers on specific AXSM models, see Table 9-1.
Chapter 9 Troubleshooting Commands dspcd dspcd Display Card Display the following information about a card: Note • Hardware serial number. • Firmware revision level. (See the loadrev description for an explanation of how to interpret the revision filed.) If a card has no firmware, the display shows a version number of 0.0.0. • Status, possibly including the reason for the last reset (FunctionModuleResetReason) and state of the integrated alarm (cardIntegratedAlarm).
Chapter 9 Troubleshooting Commands dspcd Examples Display card details for the current PXM45. Note The A1 at the end of the primary software revision and boot firmware revision numbers shows that these versions are pre-release. Refer to the setrev description for details. MGX8850.7.PXM.a > dspcd MGX8850 System Rev: 02.00 MGX8850 Slot Number 7 Redundant Slot: 8 Front Card ---------Inserted Card: PXM45 Reserved Card: PXM45 State: Active Serial Number: SAK0405008B Prim SW Rev: 2.0(246)A1 Sec SW Rev: 2.
Chapter 9 Troubleshooting Commands dspcd Reset Reason:On Power up Card SCT Id: 2 #Lines #Ports #Partitions #SPVC #SVC ------ ------ ----------- ------- ------1 1 1 2 1 Port Group[1]: #Chans supported:32512 Port Group[2]: #Chans supported:32512 Port Group[3]: #Chans supported:32512 Port Group[4]: #Chans supported:32512 Lines:1.1 Lines:1.2 Lines:2.1 Lines:2.2 Cisco MGX 8850 Routing Switch Command Reference 9-62 Release 2.
Chapter 9 Troubleshooting Commands dspcdalms dspcdalms Display Card Alarms Use dspcdalms on the PXM45 to display alarms that have been reported by a service module.
Chapter 9 Troubleshooting Commands dspcdalms Examples Display card-level alarms for the card in slot 8. node19.8.PXM.
Chapter 9 Troubleshooting Commands dspcdalms Slot 13 Crit 0 Maj 0 Slot 14 Crit 0 Maj 0 Slot 15 Crit 0 Maj 0 Slot 16 Crit 0 Maj 0 Use dspcdalms Min 0 || Slot 29 Crit Min 0 || Slot 30 Crit Min 0 || Slot 31 Crit Min 0 || Slot 32 Crit to see more detail. 0 0 0 0 Maj Maj Maj Maj 0 0 0 0 Min Min Min Min 0 0 0 0 MGX8850.7.PXM.
Chapter 9 Troubleshooting Commands dspcdbucketcnt dspcdbucketcnt Display Cell Counts for the Card The dspcdbucketcnt command shows the following cell-related counts: • Cells transferred between the card and the backplane • Cells from the QE 48 • CLP0 and CLP1 cells that the card dropped • Invalid, errored, and unsupported OAM cells • Errored RM cells In addition to the other bucket command on the AXSM (dsplnbucketcnt), the display commands for the switch planes on the PXM45 may help you analyz
Chapter 9 Troubleshooting Commands dspcdcnt dspcdcnt Display Card Counters Displays the number of cells transferred between the service module and the switching planes. (Synonyms for switching plane are crossbar, xbar, and switch fabric.) One switch fabric is implemented in hardware by one ASIC. The dspcdcnt command primarily applies to debugging. The type of information consists of: • Cells transferred between the service module and each of the switch planes within the total array of switch planes.
Chapter 9 Troubleshooting Commands dspcdcnt AXSM Example Display the cell transfers between the current AXSM and the switch planes (crossbar planes). SanJose.4.AXSM.
Chapter 9 Troubleshooting Commands dspcderrs dspcderrs Display Card Errors Display information about card errors. Cards on Which This Command Runs PXM45 Syntax dspcderrs Related Commands clrerr Attributes Log: no log State: active, standby Privilege: ANYUSER Example Display all card errors. wilco.7.PXM.a > dspcderrs dspcderrs 08/05/95-18:53:05 tRootTask 09/05/95-09:14:08 tRootTask value = 0 = 0x0 3 Task failed 3 Task failed : scm : scm wilco.7.PXM.
Chapter 9 Troubleshooting Commands dspcds dspcds Display Cards Displays high-level information for all the cards in the node. For more detailed information about a card, execute dspcd on the CLI of that card.
Chapter 9 Troubleshooting Commands dspcds Example Display information for all cards in the MGX 8850 switch. MGX8850.7.PXM.a > dspcds MGX8850 System Rev: 02.00 Backplane Serial No: SAA03270618 Bp HW Rev: B0 Card Slot --- Front/Back Card State ---------- Card Type -------- Alarm Status -------- Aug.
Chapter 9 Troubleshooting Commands dspcdstatus dspcdstatus Display Card Status Displays the most serious alarms reported by a service module. The alarm information pertains to: • Lines • Ports • Connections • Feeders • Severity of each alarm You can use this command to isolate the alarm source if, for example, you see that a Critical Alarm LED is lit or just want to check the node for alarms. You can subsequently use other alarm commands to locate the problem.
Chapter 9 Troubleshooting Commands dspcdstatus Figure 9-2 Alarm Type Hierarchy Disk Card Power supply Line DC level Port Fan Feeder Temperature Channel Legacy alarms 34910 Card alarms The alarm monitoring function reports the highest status alarm after it sorts the current alarms first by severity then by hierarchy. If alarms of equal severity exit in both hierarchies, the system reports the node alarm as the highest status alarm.
Chapter 9 Troubleshooting Commands dspcdstatus The display for dspalms shows that line 1 in bay 1 has LOS. (This example shows only the alarmed line. A complete display shows the status of all lines) Golden_U2.11.AXSM.a > dspalms Line Number: 1.1 Alarm State Section : LOS,LOF Line : AIS Path : RDI Cisco MGX 8850 Routing Switch Command Reference 9-74 Release 2.
Chapter 9 Troubleshooting Commands dspchancnt dspchancnt Display Channel Counters Display the statistical counters for a connection (channel). See the cnfdiag command for a detailed description of MGX 8850 diagnostics. Note This command does not apply to OC-48 cards. Cards on Which This Command Runs AXSM Syntax dspchancnt Syntax Description ifNum The logical port number. The range for AXSM is 1–60. vpi The VPI in the range 1–4095. vci The VCI in the range 1–65535.
Chapter 9 Troubleshooting Commands dspchanloop dspchanloop Display Channel Loopbacks Show channel (connection) loopbacks on a logical port. Cards on Which This Command Runs AXSM Syntax dspchanloop Syntax Description ifNumber The logical port number. The range for AXSM is 1–60. Related Commands addchanloop, delchanloop Attributes Log: no log State: active, standby Privilege: SERVICE_GP Example Display any channel loopbacks on logical port 4.
Chapter 9 Troubleshooting Commands dspchantests dspchantests Display Channel Tests—display results of tstdelay or tstconseg commands. The tstdelay or tstconseg commands test the integrity of the path of a connection in the ingress and egress directions, respectively. After you successfully start a test through tstdelay or tstconseg, the returned message directs you to use dspchantests or dspcon to see the results.
Chapter 9 Troubleshooting Commands dspchantests Examples Run tstdelay on connection 1 10 100 then display the results. Step 1 Execute tstdelay: node19.1.AXSM.a > tstdelay 1 10 100 Test started; Use dspcon/dspchantests to see test results Step 2 Check the results: node19.1.AXSM.a > dspchantests 1 10 100 Connection Id Test Type Direction ============= ========= ========= 01.0010.
Chapter 9 Troubleshooting Commands dspclkalms dspclkalms Display Clock Alarms Displays alarms associated with the primary or secondary clock source. The switch constantly monitors the state of the clocks. On the local node, the clock monitor declares an alarm if the clock becomes undetectable or goes out of specification for any reason. The definition of each alarm severity comes from Bellcore TR-NWT-000474.
Chapter 9 Troubleshooting Commands dspclkalms Example Display clock alarms. pop20two.7.PXM.a > dspclkalms pop20two System Rev: 02.00 MGX8850 Clock Manager Alarm Summary ---------------------------Critical Major Minor 000 000 000 Jul. 31, 2000 11:23:17 GMT Shelf Alarm: NONE Cisco MGX 8850 Routing Switch Command Reference 9-80 Release 2.
Chapter 9 Troubleshooting Commands dspclksrcs dspclksrcs Display Clock Sources Displays the configuration and status of the clock sources on the node. (For details about network synchronization, see the description of cnfclksrc.) The dspclksrcs output consists of: Note • For the primary clock: the type, source, status, and reason (for status change) of the clock. • For the secondary clock: the type, source, status, and reason (for status change) of the clock.
Chapter 9 Troubleshooting Commands dspclksrcs Table 9-3 Reasons for Change of Clock State Reason Meaning okay The clock source is okay. unknown reason The clock manager has no information for Reason. no clock signal Loss of signal (LOS) on the clock source. frequency too high The frequency has drifted too high. frequency too low The frequency has drifted too low excessive jitter Jitter has exceeded tolerance for this stratum.
Chapter 9 Troubleshooting Commands dspclksrcs clock source is the internal oscillator in either the free running mode or the hold-over mode: in this case, the software omits this final validation attempt because no other clocks sources within a clock hierarchy are available. Revertive Behavior For information on revertive behavior, see the cnfclksrc description.
Chapter 9 Troubleshooting Commands dspcon dspcon Display Connection Display information about an SPVC. The contents of the display on the AXSM and the PXM45 differ slightly. On both cards, the dspcon output appears in sections to make the information easier to sort. Most of the information in the dspcon output comes from addcon execution. See the addcon description for more information. Also, executing cnfpnni-intf can affect the dspcon output.
Chapter 9 Troubleshooting Commands dspcon Display Connection on the AXSM On the AXSM, dspcon shows the following connection identifiers: • NSAP address, logical port, VPI/VCI, status, and ownership of local and remote ends of the connection. The display shows whether a particular endpoint is the master or slave. The provisioning parameters in the display show: • Connection type of VPC or VCC. • Service type (for example, ABR). • A number indicating the controller. For example, 2 refers to PNNI.
Chapter 9 Troubleshooting Commands dspcon Syntax Description ifNum (AXSM) Logical interface (port) number. For AXSM, the range is 1–60. portid (PXM45) The portid represents the PNNI logical port and has the format [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 9-3. vpi VPI number. At the UNI, the range is 0–255. At the NNI, the range is 0–4095. vci VCI number. For a VCC, the range is 32–65535. For a VPC, the VCI is 0.
Chapter 9 Troubleshooting Commands dspcon -------------------------------------------------------------------------Loopback Type :No Lpbk | Dir:N/A | Status: No Lpbk | RTD: 0 us On the CLI of the PXM45, display connection 20 100 on 11:1.1:2. Unknown.7.PXM.a > dspcon 11:1.1:2 20 100 Port Vpi Vci Owner State ------------------------------------------------------------------------Local 11:1.1:2 20.100 MASTER FAIL Address: 47.00918100000000107b65f33d.0000010b1802.00 Remote 11:1.1:2 10.
Chapter 9 Troubleshooting Commands dspconinfo dspconinfo Display Summaries of Connection Information—display general information about SPVCs. The dspconinfo runs on the PXM45 and lists the total number SPVCs on each PNNI port on the node. the default is all ports on the node, but you can also specify a particular PNNI port.
Chapter 9 Troubleshooting Commands dspconinfo Example Display the SPVC summaries for the current node. svcswp10.7.PXM.a > dspconinfo Local Port #Active #Fail #AISFail #ABITFail #Down #Total ----------------------------+-----------------------------+--------------------5.4 3998 0 0 0 0 3998 6.4 3997 0 0 0 0 3997 An example of an individual port follows. The display shows 1096 connections on 11:1.1:11. Geneva.7.PXM.a > dspconinfo -port 11:1.
Chapter 9 Troubleshooting Commands dspcons dspcons Display Connections—display basic information for all connections. The default usage of dspcons uses no parameters and causes all available information for the connections to appear. To narrow the scope of the output, use one or more optional parameters. The dspcons command runs on the CLI of either the AXSM or the PXM45. The set of optional parameters and the output are different on these cards. (See Syntax Description for the card-specific parameters.
Chapter 9 Troubleshooting Commands dspcons Cards on Which This Command Runs PXM45, AXSM PXM45 Syntax dspcons [-port portid] [-vpi starting-vpi] [-vci starting vci] [-state {fail|ais|abit|ok|down}] [-owner {master|slave}] PXM45 Syntax Description -port The port identifier (portid) in the format that the network controller utilizes: [shelf.]slot[:subslot].port[:subport] Currently, the value for shelf is not necessary.
Chapter 9 Troubleshooting Commands dspcons AXSM Syntax dspcons [-conn ] [-filt ] [-if ] [-vpi ] [-vci ] AXSM Syntax Description -conn The connection ID (conn ID) of the connection to begin the display. The format of conn ID is: ifNum.vpi.vci The range for ifNum is 1–60 for the AXSM. The VPI has the range 0–4095. The VCI has the range 32–65535. -filt Unlike on the PXM45, you do not use keywords for this parameter on the AXSM.
Chapter 9 Troubleshooting Commands dspcons PXM45 Example Display all connections by entering dspcons on the CLI of the PXM45. MGX8850.7.PXM.a > dspcons Local Port Vpi.Vci Remote Port Vpi.Vci State Owner ----------------------------+-----------------------------+-------+-----3:1.1:1 20 0 6:1.1:1 20 0 OK MASTER Local Addr: 47.00918100000000107b65f33d.000001031801.00 Remote Addr: 47.00918100000000107b65f33d.000001061801.00 5:1.1:1 100 100 5:1.1:1 100 200 OK SLAVE Local Addr: 47.00918100000000107b65f33d.
Chapter 9 Troubleshooting Commands dspcons-dbg dspcons-dbg Display Connections-Debug—shows whether the SPVC log is enabled or disabled. The dspcons-dbg command shows whether the SPVC log is enabled. The dbgcon command lets you enable or disable this log. Cards on Which This Command Runs PXM45 Syntax dspcons-dbg Syntax Description This command takes no parameters.
Chapter 9 Troubleshooting Commands dspcontrollers dspcontrollers Display Controllers Displays all controllers that have been added through the addcontroller command. Cards on Which This Command Runs PXM45 Syntax dspcontrollers Syntax Description This command takes no parameters. Related Commands addcontroller, delcontroller Attributes Log: no log State: active Privilege: ANYUSER Example Display all controller. In this example, the switch has only one controller—PNNI.
Chapter 9 Troubleshooting Commands dspdiagcnf dspdiagcnf Display Diagnostics Configuration Displays the current diagnostics configuration, such as whether online or offline is enabled, the coverage time, starting time, and the days of the week (SMTWTFS) that the offline diagnostics runs.
Chapter 9 Troubleshooting Commands dspdiagcnf Example pop20one.7.PXM.
Chapter 9 Troubleshooting Commands dspdiagerr dspdiagerr Display Diagnostics Errors Displays the current offline or online diagnostics errors. Cards on Which This Command Runs PXM45 Syntax dspdiagerr Syntax Description online/offline Specify whether to display the online or the offline diagnostics errors. Related Commands clrdiagerr Attributes Log: no log State: active, standby Privilege: ANYUSER Example MGX8850.7.PXM.
Chapter 9 Troubleshooting Commands dspdiagerr 24 25 26 27 28 29 30 31 32 ---------- ---------- Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 9 Troubleshooting Commands dspdiagstat dspdiagstat Display Diagnostics Statistics Displays the number of times that the diagnostics has run. The output shows the number of attempts and the number of failures for both offline and online diagnostics. Note See the cnfdiag command for a detailed description of MGX 8850 diagnostics. Syntax dspdiagstat Syntax Description slot The slot of the card for which to display the diagnostics statistics.
Chapter 9 Troubleshooting Commands dspdiagstatus dspdiagstatus Display Diagnostics Status Displays the diagnostics status for each card on the switch. The diagnostics statuses are: Note • Idle • Ready • Offline • Online See the cnfdiag command for a detailed description of MGX 8850 diagnostics. Syntax dspdiagstatus Syntax Description This command takes no parameters.
Chapter 9 Troubleshooting Commands dspdiagstatus 16IdleACTIVE 17IdleACTIVE 18IdleACTIVE 19IdleACTIVE 20IdleACTIVE 21IdleACTIVE 22IdleACTIVE 23IdleACTIVE 24IdleACTIVE 25IdleACTIVE 26IdleACTIVE 27IdleACTIVE 28IdleACTIVE 29IdleACTIVE 30IdleACTIVE 31IdleACTIVE 32IdleACTIVE CARD CARD CARD CARD CARD CARD CARD CARD CARD CARD CARD CARD CARD CARD CARD CARD CARD ROLE ROLE ROLE ROLE ROLE ROLE ROLE ROLE ROLE ROLE ROLE ROLE ROLE ROLE ROLE ROLE ROLE Cisco MGX 8850 Routing Switch Command Reference 9-102 Release 2.
Chapter 9 Troubleshooting Commands dspenvalms dspenvalms Display Environment Alarms Display alarms related to the environment of the node. The monitored categories are: • Temperature inside the enclosure • AC power supplies if applicable • DC supply power • DC system power • Bottom fan tray operation • Top fan tray operation The definition of each alarm severity comes from Bellcore TR-NWT-000474.
Chapter 9 Troubleshooting Commands dspenvalms vmon (voltage monitor) shows permitted ranges and actual DC voltages. Related Commands dspndalms, dspcdstatus Attributes Log: no log State: active Privilege: ANYUSER Examples Check the temperature. MGX8850.7.PXM.a > dspenvalms temp MGX8850 System Rev: 02.00 Aug.
Chapter 9 Troubleshooting Commands dspenvalms Power Supply Power Supply Power Supply DC Voltage A1 A2 A3 A none none none 42 to 54 None None None VoltsDC none none none 49 Normal Normal Normal Normal Power Supply Power Supply Power Supply DC Voltage B1 B2 B3 B none none none 42 to 54 None None None VoltsDC none none none 0 Missing Missing Missing Normal Top Fan Tray Top Fan Tray Top Fan Tray Top Fan Tray Top Fan Tray Top Fan Tray Top Fan Tray Top Fan Tray Top Fan Tray Bottom Bottom Bottom Bott
Chapter 9 Troubleshooting Commands dsperr dsperr Display Error Display error message files. The dsperr command is primarily a debug command. Because it displays tasks and system calls, the information is more suitable to developers or others who can use information that is internal to the switch rather than applicable to the network. The information may also be useful to Cisco support personnel.
Chapter 9 Troubleshooting Commands dsperr Attributes Log: no log State: active, standby, init Privilege: ANYUSER Example Display one screen of internal error messages for slot 1. The Error Num is 4849. pop20two.8.PXM.
Chapter 9 Troubleshooting Commands dsperrhist dsperrhist Display Error History—displays a list of errors for a card slot. The display consists of the following for each record in the history file: • A number for the entry in the error history file • An event number in hexadecimal format • An event name—a few words that describe the error (such as the severity or affected area) • A time stamp The maximum number of entries in the history for a slot is 10.
Chapter 9 Troubleshooting Commands dsperrhist Display the error history for the AXSM in slot 6. jbscott.8.PXM.a > dsperrhist 6 Log of Errors and Failures (Slot 6): Entry#--Event#---EventName-------------------------------TimeStamp----------General: 01 0x0005 SHM_CDF_DISCOVER_TMR_POP 11/21/2000-13:49:47 ----------------------------------------------------------------------------- Display the error history for the AXSM in slot 1. pop20two.7.PXM.
Chapter 9 Troubleshooting Commands dspilmicnt dspilmicnt Display ILMI Counters Displays the ILMI counters for a particular resource partition on a particular logical port. Cards on Which This Command Runs AXSM Syntax dspilmicnt Syntax Description ifNum The logical port number. The range for AXSM is 1–60. partId The number of the resource partition. The range is 1–20.
Chapter 9 Troubleshooting Commands dspln dspln Display Line Display the configuration of a physical line. Note The connection count includes control VCs when you execute dspln on the CLI of a service module. However, when you execute dspcd or dsppnport(s) on the CLI of the controller card, the display does not include control VCs. Cards on Which This Command Runs AXSM Syntax dspln <-ds3 | -sonet>
Chapter 9 Troubleshooting Commands dspln Display OC-48 line on the current OC-12 AXSM. pop20two.1.AXSM.a > dspln -sonet 2.1 Line Number : 2.
Chapter 9 Troubleshooting Commands dsplncnt dsplncnt Display Line Counters—display the contents of counters for various cell-related statistics on a line.
Chapter 9 Troubleshooting Commands dsplncnt Attributes Log: no log State: active, standby Privilege: ANYUSER Example Display the cell counters for line 1 in bay 1. MGX8850.11.AXSM.a > dsplncnt 1.1 Line Number : 1.
Chapter 9 Troubleshooting Commands dsplns dsplns Display Lines Displays the configuration for all lines on a card.
Chapter 9 Troubleshooting Commands dsplns Examples Display line configuration on the current AXSM-1-2488. pinnacle.1.AXSM.a > dsplns Medium Medium Sonet Line Line Line Frame Line Line Line Status Type Lpbk Scramble Coding Type ----- ----- ------------ ------ -------- -------- ------1.1 Down sonetSts48c NoLoop Enable Other ShortSingleMode Display the configuration of each T3 line on the current AXSM-16-T3E3. jdlenoir.11.AXSM.
Chapter 9 Troubleshooting Commands dsplog dsplog Display Log Display log file contents. The dsplog command is a debugging command and requires in-depth knowledge of the internal workings of the system. For example, the display may show points where the switch software steps into and out of functions or tracks tasks that it is spawning. The PXM45 supports multiple log files: if the space allocation for one file becomes exhausted, the system starts filling a new, sequentially numbered file.
Chapter 9 Troubleshooting Commands dsplog -sev Specifies the severity of the alarm. Select it by entering a number in the range 1–7: 1. EVENT_FATAL: This severity indicates that the event affects the existing data traffic for the systems and is considered fatal because the platform cannot recover. Fatal events cause a card reset. Also, any error or condition that damages or causes loss of ongoing data traffic is fatal.
Chapter 9 Troubleshooting Commands dsplog Example Display the contents of log file number 1. This example shows the first of multiple screens. jdlenoir.7.PXM.a > dsplog -log 1 07-00236 11/16/2000-15:21:26 CLI-7-CMDLOG tTnInTsk01 0x8037558c cliCmdLog: cisco@telnet.01: (cc 7). 11-00017 11/16/2000-15:21:26 CLI-7-CMDLOG tSmInTsk03 0x801ef16c cliCmdLog: cisco@smterm.03: (logout). - 1 dropped 07-00235 11/16/2000-15:18:26 CLI-7-CMDLOG tTnInTsk01 0x8037558c cliCmdLog: cisco@telnet.01: (cc 11).
Chapter 9 Troubleshooting Commands dsplogs dsplogs Display Logs—display a list of all existing log files. The dsplogs shows the existing log files (but not the file contents). The dsplogs command lets you see which files exist and thus determine specific contents to view when you execute dsplog. Cards on Which This Command Runs PXM45 Syntax dsplogs Syntax Description This command takes no parameters.
Chapter 9 Troubleshooting Commands dspndalms dspndalms Display Node Alarms Displays various types of alarms on the node from a high-level perspective. With the information in the dspndalms display, you can select one of the following commands to investigate the alarm: • dspcdalms identifies line, port, or connection alarms on an AXSM. • dspclkalms shows alarms related to network clocks. • dspenvalms lists alarms for out-of-range conditions for temperature, voltage sources, and so on.
Chapter 9 Troubleshooting Commands dspndalms Examples Display node alarms. The output shows two major, card-level alarms. Use the dspcdalms command to determine which card or cards have the alarms. ITNODE3.7.PXM.a > dspndalms Node Alarm Summary Alarm Type ---------Clock Alarms Switching Alarms Environment Alarms Card Alarms Critical -------0 0 0 0 Major ------0 0 0 2 Minor ------0 0 0 0 The output of dspcdalms shows that both card alarms are on the card in slot 8—the standby PXM45.
Chapter 9 Troubleshooting Commands dspndalms Execute dspcds to get an idea of the card state and then, if necessary, execute dspcd for slot 8 to acquire more details on the state of the card in slot 8. However, the output of dspcds shows that the card set is missing, which also explains the disk error. ITNODE3.7.PXM.a > dspcds ITNODE3 System Rev: 02.00 Backplane Serial No: SAA03140750 Bp HW Rev: B0 Card Slot --- Front/Back Card State ---------- Card Type -------- Alarm Status -------- Dec.
Chapter 9 Troubleshooting Commands dsppnportloscallrel dsppnportloscallrel Display PNNI Port Loss of Signal Call Release This command displays the enable status of the LOS call release feature. See cnfpnportloscallrel for a description of this feature. Cards on Which This Command Runs PXM45 Syntax dsppnportloscallrel Syntax Description portid The portid represents the PNNI logical port and has the format [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 9-3.
Chapter 9 Troubleshooting Commands dspportcnt dspportcnt Display Port Counters Displays ATM cell counters for a logical port. Refer to the example for contents. Cards on Which This Command Runs AXSM AXSM Syntax dspportcnt Syntax Description ifNum Logical port number. The range depends on the card. For AXSM, the range 1–60.
Chapter 9 Troubleshooting Commands dspportcnt Examples Display port counters on logical port (ifNum) 1 of the current AXSM. MGX8850.1.AXSM.
Chapter 9 Troubleshooting Commands dspprfhist dspprfhist Display Performance History The dspprfhist command shows the percentage of activity of tasks. Refer to the Example section for the type of displayed information. The command applies primarily to internal Cisco developers. Cards on Which This Command Runs PXM45, AXSM Syntax dspprfhist Syntax Description This command takes no parameters.
Chapter 9 Troubleshooting Commands dspswalm dspswalm Display Switching Alarms—displays alarms for switching circuits on the PXM45. The dspswalm command can be used to determine if a card should be returned to Cisco for repair. For optional fault isolation after you execute dspswalm, use the crossbar commands to see if crossbar errors have occurred. The crossbar-specific commands apply to hardware or software developers who may need analyze the behavior of the switch ASIC.
Chapter 9 Troubleshooting Commands dspswalm Attributes Log: no log State: active Privilege: ANYUSER Examples Display switching alarms. node_chi.8.PXM.a > dspswalms Node Switching Alarm Summary Card Crossbar Crossbar Fabric Humvee Alarm Critical Critical Critical 0 0 0 Major Major Major 0 0 0 Minor Minor Minor 0 0 0 Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 9 Troubleshooting Commands dsptrapmgr dsptrapmgr Display Trap Manager Display details about all existing trap managers. The dsptrapmgr output shows: • IP address of each trap manager • Port number on the connected work station • Row status • Read trap flag stats • Next trap sequence number Of these elements, the IP address and port number result from addtrapmgr. Cards on Which This Command Runs PXM45 Syntax dsptrapmgr Syntax Description This command takes no parameters.
Chapter 9 Troubleshooting Commands dspxbar dspxbar Display Crossbar—display the configuration of the crossbars The dspxbar command displays general information about the configuration of a switch plane (or switching fabric or crossbar, also synonymous with switch ASIC). The configuration normally has fixed default values and is not configurable.
Chapter 9 Troubleshooting Commands dspxbar The crossbar configuration consists of four categories of information for each slot: • The type of backpressure is always Inband (meaning ingress direction). A crossbar does not have buffers (as the AXSMs do) and therefore must send backpressure signals to the queuing chips on each AXSM if congestion begins to occur in the switching plane.
Chapter 9 Troubleshooting Commands dspxbar Example Display switch ASIC (or switch plane or crossbar) 0. MGX8850.8.PXM.a > dspxbar MGX8850 System Rev: 02.00 Jul.
Chapter 9 Troubleshooting Commands dspxbaralm dspxbaralm Display Crossbar Alarms—display severity of crossbar alarms. The dspxbaralm command shows whether a crossbar alarm is minor, major, or critical. The display shows status on both the active and standby PXM45. Note This low-level command normally applies to software or hardware development and therefore is not useful for troubleshooting at the network or node level. For troubleshooting at the switch level, use dspndalms and dspswalms.
Chapter 9 Troubleshooting Commands dspxbaralm Example Display the severity of crossbar alarms. On the card in slot 7, crossbars 1 and 2 show errors. In such a case as two crossbars showing major errors, a card in a slot rather than a switch ASIC may be at fault. Therefore, you could execute dspcds to see if service module has an alarm or dspxbarerrcnt for switch ASICs 1 and 2 to see if each ASIC is showing similar data for the same card slot. You could also execute dspcdalm on the PXM45. MGX8850.7.PXM.
Chapter 9 Troubleshooting Commands dspxbarerrcnt dspxbarerrcnt Display Crossbar Error Counters—display the count of various types of errors. The dspxbarerrcnt command shows numbers of various types of errors on each slot-link. Note that the error can occur anywhere along the path of the ASIC and the hardware on the service module. The types of errors apply to the 60-byte switch frames.
Chapter 9 Troubleshooting Commands dspxbarerrcnt Related Commands dspxbar, dspxbaralm, dspxbarerrthresh, cnfxbarerrthresh, dspndalms, dspswalms Attributes Log: log State: active, standby Privilege: ANYUSER Example Display the crossbar error counters for switch ASIC 2 in slot 7. The Node Alarm field of the display shows the errors have resulted in a critical alarm. A large number of errors have occurred in the slot 12 link.
Chapter 9 Troubleshooting Commands dspxbarerrthresh dspxbarerrthresh Display Crossbar Error Threshold—display the thresholds for alarms of different severities. A crossbar can have nine types of errors, and each error has a threshold. The errors are loss of synchronization, a variety of parity and CRC errors, and so on (see Definitions of Crossbar Errors).
Chapter 9 Troubleshooting Commands dspxbarerrthresh Related Commands dspxbar, dspxbaralm, dspxbarerrcnt Attributes Log: no log State: active Privilege: ANYUSER Example Display the current crossbar error thresholds. JBP2_Lower.8.PXM.a > dspxbarerrthresh JBP2_Lower System Rev: 02.01 Nov.
Chapter 9 Troubleshooting Commands dspxbarmgmt dspxbarmgmt Display Crossbar Management—display the load sharing configuration. The dspxbarmgmt command shows details about the load sharing configuration for the node. See the cnfxbarmgmt description for an explanation. Cards on Which This Command Runs PXM45 Syntax dspxbarmgmt Syntax Description This command takes no parameters.
Chapter 9 Troubleshooting Commands dspxbarstatus dspxbarstatus Display Crossbar Status Display status of each slot for a crossbar. Cards on Which This Command Runs PXM45 Syntax dspxbarstatus [plane ] Syntax Description plane (Optional.) The number of the switching plane. The default is 0. For the MGX 8850 node, the range is 0–2.
Chapter 9 Troubleshooting Commands dspxbarstatus Misc Error Bitmap: 0x0 Cisco MGX 8850 Routing Switch Command Reference 9-142 Release 2.
Chapter 9 Troubleshooting Commands dumptrace dumptrace Dump Trace—place the contents of a trace in a log file and show the name of the file. The output of dumptrace is a filename. Provide this name to dsplog -log option to see its contents. Cards on Which This Command Runs PXM45 Syntax dumptrace Syntax Description This command takes no parameters.
Chapter 9 Troubleshooting Commands offdiagstat offdiagstat Off Diagnostics Statistics Halts the statistical diagnostic program that keeps count of how many times the diagnostics have run. Syntax offdiagstat Syntax Description This command takes no parameters. Cards on Which This Command Runs AXSM Related Commands ondiagstat Attributes Log: log State: active Privilege: SERVICE_GP Example pop20one.10.AXSM.a > offdiagstat Disabling diag stats, enabling bucket stats.
Chapter 9 Troubleshooting Commands ondiagstat ondiagstat On Diagnostics Statistics Starts running the diagnostics statistics program that keeps count of how many times diagnostics has run. Syntax ondiagstat Syntax Description This command takes no parameters. Cards on Which This Command Runs AXSM Related Commands offdiagstat Attributes Log: log State: active Privilege: SERVICE_GP Example pop20one.10.AXSM.a > ondiagstat Enabling diag stats, disabling bucket stats.
Chapter 9 Troubleshooting Commands pathtraceie pathtraceie Path Trace IE Removes or inserts path trace information element (IE) at port level. Cards on Which This Command Runs PXM45 Syntax pathtraceie {rmv | ins} Syntax Description portid The portid represents the PNNI logical port and has the format [shelf.]slot[:subslot].port[:subport]. See also PNNI Format, page 9-3. rmv Allow to remove Trace Transit List IE at the port. ins Allow to insert Trace Transit List IE at the port.
Chapter 9 Troubleshooting Commands pathtracenode pathtracenode Path Trace Node Enables or disables path trace feature at the node level. Cards on Which This Command Runs PXM45 Syntax pathtracenode {enable | disable} Syntax Description enable/disable Enables (disables) path trace at node level. Related Commands conntrace, pathtraceport, pathtraceie Attributes Log: log State: active Privilege: SUPER_GP Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 9 Troubleshooting Commands pathtraceport pathtraceport Call Control Operations: Enable/Disable Path Trace at Port Level Enables (disables) path trace feature at port level, then saves the result of the path trace in the log file.
Chapter 9 Troubleshooting Commands pathtraceport Related Commands conntrace, pathracenode, pathraceie Attributes Log: log State: active Privilege: SUPER_GP Examples Format of the path trace result for a call in the log file: Result:Succ/Fail Reason: "Desc" Called No: "--" Calling No: "--" Cause: "value:Desc" NodeId Ingress Port Egress Port Vpi/Vci Call Ref EndPtRef (opt) XXXX YYYY ZZZZ aaa/bbb cccc dddd XXXX YYYY ZZZZ aaa/bbb cccc dddd Cisco MGX 8850 Routing Switch Command Reference Release 2.
Chapter 9 Troubleshooting Commands resetcd resetcd Reset Card—resets the card or the failure history. The resetcd command lets you reset a card or, if you specify the appropriate option, the failure history of a card. Using the resetcd command without defining a slot number results in an ungraceful (disruptive) upgrade. This is the fastest method to upgrade a card, but it disrupts service.
Chapter 9 Troubleshooting Commands resetsys resetsys Reset System Reset the entire node. Cards on Which This Command Runs PXM45 Syntax resetsys Syntax Description This command takes no parameters but displays a warning and prompts you to continue the execution. Related Commands resetcd Attributes Log: no log State: active, init Privilege: SUPER_GP Example Reset the system. pinnacle.7.PXM.a > resetsys This command resets the entire shelf, a destructive command.
Chapter 9 Troubleshooting Commands switchcc switchcc Switch Core Cards Switch control of the node from the active PXM45 to the standby PXM45. If a standby PXM45 is not available, the switchcc command fails. You cannot execute switchcc during a configuration-copy. If you attempt it, the system blocks the command. Furthermore, the command fails if the switch is unstable or if the standby PXM45 is not in the standby state.
Chapter 9 Troubleshooting Commands tstconseg tstconseg Test Connection Segment Test the integrity of an SVC or SPVC. With tstconseg, a single collection of supervisory cells is sent in the egress direction between the card and service equipment (CPE). (See tstdelay for ingress direction.) When the test successfully starts, the system displays a message stating that the test has begun and directs you to use either dspcon or dspchantests to see the results.
Chapter 9 Troubleshooting Commands tstconseg Example Test the integrity of 1 10 1000 in the egress direction. node19.1.AXSM.a > tstconseg 1 10 100 Test started; Use dspcon/dspchantests to see test results Cisco MGX 8850 Routing Switch Command Reference 9-154 Release 2.
Chapter 9 Troubleshooting Commands tstdelay tstdelay Test Delay Test the integrity of the connection in the ingress direction by sending a collection of supervisory cells to the remote end of the network and back. (See tstconseg for the egress direction.) The tstdelay command applies to only SPVCs. If the test successfully begins, the display states the fact and directs you to use the dspcon or dspchantests command to view the round trip time in microseconds.
Chapter 9 Troubleshooting Commands tstdelay Attributes Log: log State: active Privilege: GROUP1 Example On the AXSM slot, get the round-trip delay for connection 1 10 100. This example contains four command executions to illustrate how to obtain a list of logical ports; obtain a connection number; start the test; and view the results. the commands are dspports, dspcons, tstdelay, and dspcon. Step 1 Identify the logical ports on the card by executing dspports.
Chapter 9 Troubleshooting Commands tstdelay -------------------------------------------------------------------------Local PCR : 14 Remote PCR : 14 Local SCR : 3 Remote SCR : 3 Local CDV : -1 Remote CDV : -1 Local CTD : -1 Remote CTD : -1 Local MBS : 1 Remote MBS : 1 Local CDVT : -1 Remote CDVT : -1 Admin weight : -1 Frame discard: N -------------------------------------------------------------------------OAM CC Config : DISABLED Statistics : DISABLED ------------------------------------------------------
Chapter 9 Troubleshooting Commands upcon upcon Up Connection—return a downed connection to the active (administratively up) state. Activate a connection that was previously brought down by the dncon command. (The typical purpose of dncon is some form of operational modification or troubleshooting.) Execute upcon at the master end of the connection. Cards on Which This Command Runs AXSM Syntax upcon Syntax Description ifNum The logical port number. The range for AXSM is 1–60.
Chapter 9 Troubleshooting Commands upln upln Up Line Activates a line on the current card. After you have activated the line, use cnfln to configure the line characteristics such as the type of line (for SONET types, T3, or E3), line signaling, and so on. Note See description of cnfcdsct for important planning considerations before you use upln. Cards on Which This Command Runs AXSM Syntax upln Syntax Description bay.line Identifies the bay (1 or 2) and the number of the line.
Chapter 9 Troubleshooting Commands upport upport Up Port The upport command returns a logical port to the up state (or ups the port) so the port can again carry traffic. The upport command concludes possible re-configuration or troubleshooting steps. Before you execute upport, you must have downed the port by executing dnport. Throughout the sequence of downing and upping a port, the configuration for the port remains intact whether the logical port is a UNI or an NNI.
I N D E X Symbols B ? bootChange 1-8 burnboot bye A abortallsaves xxv abortofflinediag C 9-5 2-6 cc 1 - 10 actaudit xxv ccc xxv addaddr 6-6 cd 1 - 11 addcon Changed Commands 3-6 addchanloop clidbxlevel 3-8 clrallcnf 3 - 11 addfltset 2 - 15 xxv clralmcnt xxvi xxi 2 - 16, 9 - 9 clralm 6-9 xxvi xxv Cisco CD-ROM addcontroller addln checkflash 9-6 7-6 addfdr 2 - 14 1-9 abortrev addapsln 2 - 12 xxv, 9 - 10 addlnloop xxv, 9 - 8 clrbecnt xxv, 3 - 21, 9 - 11
Index clrpnconstats 6 - 16, 7 - 17 clrportcnt 9 - 22, 9 - 23 clrportcnts xxv, 9 - 23 clrqosdefault clrscrn xxv clrsscopstats 6 - 20 9 - 24 clrxbaralms xxvii clrxbarerrcnt 9 - 25 cmdhistory cnfabr 1 - 13 cnfabrtparmdft cnfalm 2 - 25 cnfndparms 2 - 26 cnfnodalcongth 6 - 28 7 - 30 3 - 32 cnfpasswd xxv, xxvi, 2 - 30 cnfpasswdreset cnfpnctlvc xxv 6 - 31 cnfpnni-election cnfpnni-intf 5 - 18 5 - 21 cnfpnni-link-selection 7 - 18 cnfaddrreg cnfname cnfpart 6 - 18 clrxbaralm 7 -
Index cnftmzn delprfx 2 - 35 cnftmzngmt cnftrapip delsesn cnfxbarmgmt 6 - 61 2 - 42 2 - 43 disablesscop 1 - 15 core cp deluser 9 - 40 xxv copycons xxv deltrapmgr 9 - 38 2 - 39 conntrace 3 - 44 delsigdiag xxvii cnfxbarerrthresh commitrev 3 - 43 delrscprtn 2 - 37 cnfxbaradmin copy delred 2 - 36 6 - 55 cnfuser 4 - 15 dncon 7 - 34, 9 - 48 dnilmi 4 - 16 dnlmi 9 - 43 dnln xxv 3 - 45 3 - 46, 9 - 49 dnpnport 1 - 16 dnport D 6 - 64 3 - 47, 9 - 50 downloadflash 2 - 44
Index dspchancnt dspln 9 - 75 3 - 75, 9 - 111 dspchanloop 9 - 76 dsplnbucketcnt dspchantests 9 - 77 dsplncnt 9 - 113 dsplnload xxvi dspclkalms 9 - 79 dspclksrcs dspcon 2 - 51, 9 - 81, 9 - 83 3 - 64, 3 - 65, 7 - 37, 7 - 38, 9 - 85 dsplns 3 - 77, 9 - 115 dspload 3 - 79, 8 - 12 dspconfigs xxv dsplog dspconinfo 7 - 41, 9 - 88 dsploginmsg dspconload xxvi dsplogs dspcons 3 - 68, 3 - 69, 7 - 42, 7 - 43, 9 - 90, 9 - 91 xxvi 9 - 117 xxvi 9 - 120 dsplpback xxvi dspcons-dbg xxvi
Index dsppnni-neighbor dsppnni-node 5 - 74 5 - 77 dsppnni-node-list dsppnni-path dsprteoptstat 8 - 18 3 - 98 dspserialif 5 - 87 dsppnni-ptse 8 - 17 dspsct 5 - 81 dsppnni-pkttrace dsprteoptcnf dspsesn 5 - 92 xxvi dspshelfalm 5 - 94 dsppnni-reachable-addr 5 - 104 dspsig dsppnni-routing-policy 5 - 108 dspsigdiag dsppnni-scope-map dsppnni-spoke 5 - 112 5 - 113 dsppnni-summary-addr dsppnni-svcc-rcc dsppnport 5 - 115 5 - 119 5 - 121 dsppnportcac dsppnportidmaps 6 - 91 dsppnpo
Index F P formatdisk passwd xxvii xxvi pathtraceie 9 - 146 pathtracenode H 9 - 147 pathtraceport Help 1 - 19 ping help 1 - 19 pvcifconfig history pwd 1 - 20 9 - 148 1 - 24 2 - 79 1 - 25 R I ipifconfig Removed Commands 2 - 72 resetcd 9 - 150 resetsys L 2 - 81, 9 - 151 restoreallcnf loadrev logout ls 2 - 82 routeShow 2 - 75 2 - 86, 8 - 21 routestatShow 1 - 21 1 - 22 xxvi rrtcon 8 - 23 runrev 2 - 83 2 - 87, 8 - 22 M S maximum cost mkfs 7 - 12, 7 - 27 saveallcn
Index T telnet xxvi, 2 - 98 timeout 2 - 100 tstconseg tstdelay 9 - 153 9 - 155 tstpndelay 6 - 116 U upcon 7 - 56, 9 - 158 uplmi xxvi, 3 - 105 upln 3 - 106, 9 - 159 uppnport upport users 6 - 117 3 - 107, 7 - 57, 9 - 160 xxvi, 2 - 101 W who 1 - 26 whoami 1 - 27 Cisco MGX 8850 Routing Switch Command Reference Release 2.
Index Cisco MGX 8850 Routing Switch Command Reference IN-8 Release 2.
