cisco MGX 8250 User Manual

Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0 July 2000
Corporate Headquarters
Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel:
Fax: 408 526-4100
Customer Order Number: DOC-7810897= Text Part Number: 78-10897-01
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHA NGE 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 IMPLIE D. U SER S MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE I NFORMAT ION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adapta tion of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public doma in version of the UNIX operating sy s tem. All rights reserved. Copyri ght © 1981, Regent s of the Univ ersi ty of California.
NOTWITHSTANDING ANY OTHER WARRAN TY HEREIN, ALL DOCUMENT FILESAND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH ALL FAULTS. CISCO AND T HE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EX PR ESS E D ORIMPLIED, INCLUDING, WIT HOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FRO M A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITSSUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Access Registrar, AccessPath, Any to Any, Are YouReady, AtmDirector, Browse with Me, CCDA, CCDE, CCDP, CCIE, CCNA, CCNP,CCSI, CD-PAC, the Cisco l ogo , Cisco Certified Internetwork Expert logo, CiscoLink,the Cisco Management Connection logo, the C isco NetWorks logo, the Cisco Powered Network logo, Cisco S ystems Capital, the Cisco Systems Capital logo, Cisco Systems Networking Acade my , the Cisco Systems Networking Academy logo, the Cisco Technologies logo, F ast Step, FireRunner, Fo llow Me Browsing, FormShar e, GigaStack, IGX, Int elli gence in the Optical Core, Internet Quotient, IP/VC, IQ Br eakthrough, IQ Expertise, IQ FastTrack, IQ Readiness Scorecard, The IQ Lo go, Kernel Proxy, MGX, Natural Network Viewer, NetSonar, Network Reg istr ar, the Networkers logo, Packet, PIX, Point and Click Internetworking, Policy Builder , Precept, RateMUX, ReyMaster, ReyView, ScriptShar e, Secure Script, Shop w ith Me, SlideCast, SMAR Tnet, SVX, The Ce ll, TrafficDirector, TransPath, VlanDirector, Voice LAN, Wavelength Router, Workgroup Director,and WorkgroupStack are trademarks; Changing the Way We Work, Live, Play, and Learn, Empowering the Internet Generation, The Internet Economy, and The New Internet Economy are service marks; and Aironet, ASIST, BPX, Catalyst, Cisco, Cisco IOS, the Cisco IOS logo, C is co Systems , the Cisco Systems logo, the Cisco Sy s tems Cisco Press logo, CollisionFree, Enterpr is e/S ol ver, EtherC h anne l, EtherS wit ch, FastHub, FastLink, FastPAD, FastSwitch, GeoT el, IOS, IP/T V, IPX, Ligh tSt ream, Lig htSwit ch, MICA, NetRang e r, Post-Ro uti ng, Pr e-Routing, Re gistrar, StrataView Plus, Stratm, TeleRouter, and VCO are registered trademarks of Cisco Systems, Inc. or its affiliates in the U.S. and certain other countries. All other trademarks mentioned in this document are the property of their respective owners. The use of the word partner does notim ply a partnership relationship between Cisco and any other company. (0005R)
Cisco MGX 8250Command Reference, Release 1.0
Copyright © 2000, Cisco Systems, Inc. All rights reserved. Printed in USA.
CONTENTS
CHAPTER
About This Manual
Objectives
Audience
Organization
Related Documentation
Conventions
Cisco Connection Online
1
MGX 8250 Command Line Interface
Introduction
List of Commands
?
1-11
abort
1-13
acqdsx3bert
addapsln
1-16
addaimgrp
addcdrscprtn
xix
xix
xix
xx
xx
xxi
xxii
1-1
1-1
1-2
1-15
1-18
1-19
addchan
addchanloop
addcon
1-32
addendpt
addimagrp
addlink
1-44
addlmiloop
addln
1-48
addlnloop
addlns2aimgrp
addport
addred
1-53
1-58
addrscprtn
addserialif
addtrapmgr
Release 1.0, Part Number 78-10897-01, July 2000
1-22
1-30
1-41
1-43
1-46
1-50
1-52
1-60
1-62
1-63
Cisco MGX 8250 Multiservice Gateway Command Reference
iii
Contents
addtrk
1-64
adduser
agetrapmgr
aimhelp
arpAdd
1-71
arpDelete
arpFlush
arpShow
bootChange
bye
1-77
cc
1-78
cd
1-79
clraimgrpcnt
clraimlncnt
clrallcnf
clralm
1-83
clralmcnt
1-65
1-67
1-68
1-72
1-73
1-74
1-75
1-80
1-81
1-82
1-86
clralmcnts
clralms
1-89
clratmlncnt
clratmlncnts
clrbertcntrs
clrcderrs
clrchancnt
clrchancnts
clrconcnt
clrconcnts
clrerr
clrifcnt
1-99
1-100
clrifcnts
clrimagrpcnt
clrimalncnt
clrlmistats
clrlog
1-105
1-88
1-90
1-91
1-92
1-93
1-94
1-96
1-97
1-98
1-101
1-102
1-103
1-104
iv
clrmsgcnt
Cisco MGX 8250 Multiservice Gateway Command Reference
1-106
Release 1.0, Part Number 78-10897-01, July 2000
Contents
clrportcnt
clrportcnts
clrsarcnt
1-109
clrsarcnts
clrscrn
clrslftst
clrsmcnf
1-112
1-113
1-114
clrsrmcnf
cmdhistory
cnfaimgrp
cnfapsln
1-118
cnfatmln
cnfbctype
cnfbert
cnfcbclk
1-123
1-124
cnfcdprtntype
cnfcdrscprtn
1-107
1-108
1-111
1-115
1-116
1-117
1-121
1-122
1-127
1-128
cnfchan
cnfchaneir
1-130
1-133
cnfchancacoff
cnfchanegressq
cnfchanfst
1-137
cnfchaningressq
cnfchanmap
cnfchanpol
cnfchanq
1-144
1-147
cnfchansrvrate
cnfclksrc
cnfcon
cnfdate
1-150
1-153
1-156
cnfdsx3bert
cnfegrservtype
cnfextclk
cnfenetgw
1-160
1-161
1-134
1-135
1-140
1-142
1-149
1-157
1-159
cnffst
Release 1.0, Part Number 78-10897-01, July 2000
1-162
Cisco MGX 8250 Multiservice Gateway Command Reference
v
Contents
cnfif
1-163
cnfifastrk
cnfifip
cnfilmi
1-166
1-168
cnfimagrp
cnfln
1-172
cnflnsubrate
cnfname
1-183
cnfoamlpbk
cnfpasswd
cnfplpp
cnfport
1-186
1-188
cnfportcllm
cnfportq
1-193
cnfportrscprtn
cnfprfparam
cnfrscprtn
cnfserialif
1-165
1-171
1-181
1-184
1-185
1-191
1-194
1-196
1-197
1-199
cnfslftst
cnfsnmp
cnfsrmclksrc
cnfstatsmgr
cnfswfunc
cnftime
1-205
cnftmzn
cnftmzngmt
cnftrafficgen
cnftrapip
cnftrk
1-211
cnfupcabr
cnfupccbr
cnfupcubr
cnfupcvbr
cnfvismip
commit
1-229
1-200
1-201
1-202
1-203
1-204
1-206
1-207
1-208
1-210
1-214
1-218
1-221
1-224
1-228
vi
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Contents
copy
cp
cth
1-231
1-232
1-233
copychans
copyports
cvsi
1-237
dcct
1-238
dcondb
del
1-239
1-240
delaimgrp
delapsln
delbert
1-243
delcdrscprtn
delchan
delchanloop
delchans
delcon
1-249
1-234
1-236
1-241
1-242
1-244
1-245
1-246
1-248
deldsx3bert
delifip
dellink
1-252
1-253
dellmiloop
delln
dellnloop
1-256
1-257
dellnsfmaimgrp
delport
delports
delred
delrscprtn
1-259
1-260
1-261
1-262
delslotlink
deltrapmgr
deltree
deluser
dir
dlmi
1-265
1-266
1-267
1-268
1-251
1-254
1-258
1-263
1-264
dncon
Release 1.0, Part Number 78-10897-01, July 2000
1-269
Cisco MGX 8250 Multiservice Gateway Command Reference
vii
Contents
dnif
1-270
dnilmi
1-271
downloadflash
dnport
1-274
dspaimgrp
dspaimgrpcnt
dspaimgrps
dspaimlncnt
dspalm
1-280
dspalmcnf
dspalmcnt
dspalms
1-293
dspapscfg
dspapsln
1-297
dspatmlncnf
dspatmlncnt
dspbctype
dspbert
1-303
1-272
1-275
1-277
1-278
1-279
1-283
1-287
1-295
1-300
1-301
1-302
dspcbclk
dspcd
1-304
1-305
dspcderrs
dspcdprtntype
dspcdrscprtn
dspcds
dspchan
1-314
1-316
dspchancnt
dspchanmap
dspchans
dspchstats
dspclkinfo
dspclksrc
dspcon
1-332
dspconcnt
dspcons
1-338
dspcurclk
1-310
1-311
1-312
1-322
1-325
1-326
1-328
1-330
1-331
1-336
1-339
viii
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Contents
dspdsx3bert
dspegrq
dspegrqs
1-341
1-342
dspegrservtype
dspenetgw
dsperr
1-345
dspfeature
dspfst
dspfw
1-350
1-351
dspfwrevs
dsphotstandby
dspif
dspifcnt
dspifip
dspifrsc
dspifs
dspilmi
1-355
1-356
1-357
1-358
1-359
1-360
1-340
1-343
1-344
1-348
1-352
1-353
dspilmicnt
dspilmis
1-363
dspimagrp
dspimagrpcnt
dspimagrps
dspimainfo
dspimalncnt
dsplink
1-370
dsplmiloop
dsplmistats
dspln
dsplnrsc
dsplns
1-374
1-377
1-378
dsploads
dsplog
dsplogs
1-382
1-384
dspmaptbl
1-362
1-364
1-366
1-367
1-368
1-369
1-371
1-373
1-381
1-385
dspmsgcnt
Release 1.0, Part Number 78-10897-01, July 2000
1-387
Cisco MGX 8250 Multiservice Gateway Command Reference
ix
Contents
dspname
dspnwip
1-389
1-390
dspoamlpbk
dsponoff
dspparifs
1-393
1-394
dsppasswd
dspplpp
dspport
1-396
1-397
dspportcnt
dspportq
1-405
dspportqs
dspportrscprtn
dspports
1-409
dspportstats
dspprf
1-414
dspprfhist
dspred
1-424
1-391
1-395
1-402
1-407
1-408
1-412
1-422
dsprscprtn
dsprscprtns
dspsarchans
dspsarcnt
dspsarcnts
dspserialif
dspservrate
dspshelfalm
dspslftst
1-441
dspslftsttbl
dspslotlink
dspsmcnf
dspsnmp
dspsrmclksrc
dspstatparms
dspswfunc
dspsysparm
1-425
1-426
1-427
1-429
1-434
1-437
1-438
1-439
1-442
1-443
1-444
1-446
1-447
1-448
1-449
1-450
dsptotals
Cisco MGX 8250 Multiservice Gateway Command Reference
x
1-451
Release 1.0, Part Number 78-10897-01, July 2000
Contents
dsptrafficgen
dsptrapip
dsptrapmgr
dsptrkcnf
dsptrkload
dsptrks
1-457
dspunit391
dspupgrade
dspusers
dspver
1-461
dspvismip
dth
1-463
dvsi
1-464
exit
1-465
formatdisk
help
1-467
history
1-482
1-452
1-453
1-454
1-455
1-456
1-458
1-459
1-460
1-462
1-466
ifShow
install
logout
ls
1-483
1-485
1-489
1-490
memShow
mkdir
1-492
modbert
moddsx3bert
mv
1-496
myid
newrev
1-497
1-498
pagemode
passwd
ping
printrev
pwd
remove
1-501
1-502
1-503
1-504
1-505
1-491
1-493
1-494
1-500
rename
Release 1.0, Part Number 78-10897-01, July 2000
1-506
Cisco MGX 8250 Multiservice Gateway Command Reference
xi
Contents
resetcd
resetsys
1-507
1-508
restoreallcnf
rnmnd
1-510
routeShow
routestatShow
rstupgrade
runslftstno
saveallcnf
sesntimeout
shutdisk
1-519
softswitch
startdsx3bert
switchapsln
switchback
switchcc
syncdisk
1-524
1-525
1-509
1-511
1-512
1-513
1-515
1-517
1-518
1-520
1-521
1-522
1-523
timeout
tstcon
1-527
tstconseg
tstdelay
uncnfifastrk
upcon
upif
upport
users
1-534
1-535
1-537
1-538
version
who
1-541
whoami
xaddcon
xclrchancnt
xclrportcnt
xcnfalm
xcnfalmcnt
1-526
1-529
1-531
1-533
1-539
1-542
1-543
1-550
1-552
1-553
1-555
xii
xcnfbert
Cisco MGX 8250 Multiservice Gateway Command Reference
1-558
Release 1.0, Part Number 78-10897-01, July 2000
Contents
xcnfdsx3bert
xcnfif
xcnfifip
1-564
1-566
xcnfilmi
xcnfln
1-572
xcnfport
xcnfportq
xcnfred
1-583
xcnfrscprtn
xcnfsrmlink
xcnftrapmgr
xdelcon
xdnport
1-598
xdspchan
xdspchancnt
xdspchans
xdspcon
1-562
1-568
1-576
1-581
1-585
1-587
1-589
1-591
1-599
1-604
1-609
1-611
xdspcons
xdspdsx3bert
xdspilmi
xdspln
xdsplns
1-616
1-618
1-621
xdspport
xdspportcnt
xdspportq
xdspportqs
xdspports
xdspred
1-634
xdspshelf
xdspsrmlink
xdsptrapmgr
xdspusers
xupport
1-641
1-614
1-615
1-623
1-626
1-630
1-632
1-633
1-635
1-636
1-638
1-639
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
xiii
Contents
xiv
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
FIGURES
Figure 1-1 Firmware-Related Commands
1-13
Figure 1-2 Status Messages Halted between an MGX 8250 Switch and a BPX Switch
Figure 1-3 SONET APS 1+1 with Two Back Cards
Figure 1-4 Local and Remote Loopbacks on the PXM
1-118
1-172
Figure 1-5 Status Messages Halted Then Enabled Again Using dellmiloop and delfdrlp
Figure 1-6 Install Command Used in the Upgrade Process
Figure 1-7 newrev Command Used in the Upgrade Process
Figure 1-8 rstupgrade Command Used in the Upgrade Process
1-485
1-498
1-513
1-46
1-254
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
xv
Figures
xvi
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
TABLES
Table 1-1 PXM Commands
Table 1-2 Node Connectivity Commands
Table 1-3 Service Module (SM) Commands
1-2
1-5
1-6
Table 1-4 Degrees of Card-Level Resource Partitioning
Table 1-5 Degrees of Card-Level Resource Partitioning
Table 1-6 Clock Sources
1-150
1-19
1-128
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
xvii
Tables
xviii
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Objectives
About This Manual
This preface describes the obje ct ives, audience, organization, and conventions of the
Cisco MGX 8250 Multiservice Gateway Command Reference
Cisco documentation and additional literature are available in a CD-ROM package, which ships with your product. The Documentation CD-ROM, a mem ber of th e C isc o C onn ec tion Family, is updated monthly. Therefore, it might be mor e current than printed documentat ion. To order additional copies of the Documentation CD-ROM, contact your local sales representative or call customer service. The CD-ROM package i s ava ila ble as a single package or as an an nu al subscription. Yo u ca n also access Cisco documentationonthe World Wide Webat h ttp://www.cisco.com,http://www-china.cisco.com,or http://www-europe.cisco.com.
If you are re ad ing Cisco product documen tati on on t he World Wide Web, you can submit comments electronically. Click Feedback in the toolbar, select Documentation, and click Enter the feedback form. After you complete the form, click Submit to send it to Cisco.We appreciate your comments.
This publication provides instructions for using the MGX 8250 commands in the command line interface.
.
Audience
Cisco MGX 8250 Multiservice Gateway Command Reference
The network designers and managers with the necessary understanding to install MGX 8250 switches.
Release 1.0, Part Number 78-10897-01, July 2000
provides installers, operators,
Cisco MGX 8250 Multiservice Gateway Command Reference
xix
Organization
Organization
The body of this publication is:
Chapter 1 MGX 8250 Command Line Interface
Provides a list of commands for the common equipment cards and the service modules for the Cisco MGX 8250 wide area edge switch.
Related Documentation
The following Cisco publications contain additional information related to the operation of t he Cisco WAN switchin g n etwork:
MGX 8250 Release 1.0 Related Documentation Documentation Description
Cisco MGX 8250 Multiservice Gateway Installation and Configuration Release 1. 0
Provides installation instructions for the 8250 multiservice gateway.
About This Manual
DOC-7810924= Cisco MGX 8250 Multiservi ce Gateway Error
Messages Release 1.0 DOC-7810923= Cisco BPX 8600 Series Installation and
Configuration Release 9.2
DOC-786326=
Cisco BPX 8600 Series Reference Release 9.2
DOC-786325=
Cisco IGX 8400 S erie s Installatio n and Configuration Release 9.2
DOC-786723=
Cisco IGX 8400 Series Reference Release 9.2
DOC-786736=
Cisco WAN Swi tching Command Reference Release 9.2
DOC-786721=
Cisco WAN Switching SuperUser Command Reference Release 9.2
Provides error message descriptions and recovery procedures.
Provides installation instructions for the BPX broadband switch.
Provides a general description and technical details of the BPX broadband swi tch.
Provides installation instructions for the IGX multiband switch.
Provides a general description and technical details of the IGX multiband switch.
Provides detailed info rm ation o n the ge nera l com mand line interface commands.
Provides detailed information on the command line interface commands requiring SuperUser access authorization.
DOC-786722=
WAN CiscoView for t he IGX 8400 S witches Release 2.0
DOC-786541=
Cisco MGX 8250 Multiservice Gateway Command Reference
xx
Provides instructions for using WAN CiscoView for the I GX 8400.
Release 1.0, Part Number 78-10897-01, July 2000
About This Manual
Conventions
WAN CiscoView for t he BPX 8600 Switches Release 2.0
DOC-786539=
Cisco WAN Manager Installation for Sol aris Release 9.2
DOC-78=785875=
Cisco WAN Manager Operations Rele ase 9.2
DOC-785876=
Cisco WAN Manager SNMP Se rvice Agent Release 9.2
DOC-785878=
Cisco WAN Manager Database Interfac e Release 9.2
DOC-785877=
Conventions
This publication uses th e following conventions to convey instructions and information. Command descriptions use these conventions:
Commands and keywords are in boldface.
Provides instructions for using WAN CiscoView for the B PX 8600.
Provides procedures for installing Release 9.2 of the CiscoWAN Manager (CWM) network management syste m on So lar is systems.
Provides procedures for operating Release 9.2 of the Cisco WAN Manager (CWM ) network management syste m .
Provides inform ation about the Cisco WAN Mana ger Simple Network Management Protocol (SNMP) Service Agent components and capabilities.
Provides the information to gain direct access to the Cisco WAN Manager Informix OnLine database that is used to store information about the elements within your networ k.
Note
Caution
Warning
Arguments for whic h you supply values are in
Required comma nd argu ment s a re inside angle brackets (< >).
Optional com mand arguments ar e i n sq ua re brackets ([ ]).
Alternative keywords are se para ted by vertical bars ( | ).
italics
.
Examples use these conventions:
Terminal s essions and information the system displays are in
Information y ou e nter is in
Nonprinting characte rs, such a s passwords, are in angle brackets (< >).
Default responses to system prompts are in square bra ckets ([ ]).
reader take note
Means
. Notes contain helpful suggestions or references to materials not
boldface screen
font.
screen
font.
contained in this manual.
reader be careful
Means
. In this situ ation, you might do something tha t could result in
equipment damage or loss of data.
This warning symbol means danger. You are in a situation that could cause bodily injury. Before you work on any equipment, you must be aware of the hazards involved with electrical circuitry and familiar with standard practices for preventing accidents. (To
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
xxi
Cisco Connection Online
see translated versions of this warning, refer to the Regulatory Compliance and Safety Information document that accompanied the product.)
Cisco Connection Online
Cisco Connectio n Onlin e (CCO) i s Cisco Sy stem s’ p rimar y, real-time support channel. Maintenance customers and partners can self-register on CCO to obtain additional information and services.
Availabl e 24 h our s a day, 7 days a w eek, CCO p rovides a w ea lth of sta ndard andvalue-added services to Cisco’s customers and busines s pa rtners. CCO services include product information, produc t documentation, software updates, releas e notes, technic al tips, the Bug Navigator, configuration note s, brochures, descriptions of service offerings, and download access to public and authorized files.
CCO serves a wide variety of users through two inte rfaces that are updated and e nhanc ed simultaneously:a character-based version and a multimedia versionthatresidesontheWorld WideWeb (WWW). The character-base d CCO supp orts Zmodem, Kermit, Xmodem , FTP, a nd Internet e-mail, a nd it is excellent for quick access to information over lower bandwidths. The WWW version o f CCO provides richly formatted documents with photographs,figures, graphics, and video, as well as hyperlinks to re late d in for mat ion.
You can access CCO in the f ollowing ways:
About This Manual
Note
WWW: http://www.cisco.com
WWW: http://www-europe.cisco.com
WWW: http://www-china.cisco.com
Telnet: cco.cisco. c om
Modem: Fro m No rth America, 408 526-80 70; from Europ e, 33 1 64 46 40 8 2. U se the following terminal settings: VT100 emulation; databits: 8; parity: none; stop bits: 1; and connection rates up to 28.8 kbps.
For a copy of CCO’s Freque ntly Asked Questions (FAQ), contact cco-h elp@ cisco. co m. For addi tiona l information, contact cco-team@cisco.com.
If you are a network administrator and need personal technical assistance with a Cisco product that is under warranty or covered by a maintenance c ontract, contact Cisco’s Te chni cal Assistance Center ( TAC) at800 553-2447, 408 526-7209, or tac@cisco.com. To obtain general infor mat i on a bout Cisco Systems, Cisco products, or upgra des, contact 800 553-6387, 408 526-7208, or cs-rep@cisco.co m.
xxii
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Introduction
CHAPTER
1
MGX 8250 Command Line Interface
The preferred tools for configuring, monitoring, and controlling an MGX 8 250 switch are the CiscoView and Cisco WAN Mana ger (CWM) ap plica tions fo r equ ipm ent management a nd conn ectio n management, respectively. (The C is co WAN Manager application is the forme r C isco StrataView Plus applicationwiththeequipmentmanagement removed.)Thecommandlineinterface (CLI) also provides access to an MGX 8250 switch and is highly applicable during initial installation, troubleshooting, and any situation where low-level control is u seful.
The MGX 8250 commands in the tab les that follow are divided by major f un ctiona l group. Each table shows the complete name of the command an d t he cards for which the command is valid . For furt her reference, chec k th e provides conceptual information about how the Cisco MGX 8250 switch can best implement network services in your network configuration.
The command line prompt shows the name of the switch, the number of the switch (which is always “1”), the slot number and type for the currentcard,and whether the card is in the active (“a”) or standby state (“s” ). The following is an exa mpl e of the comman d l in e prompt:
excel.1.6.AUSM.a >
In this cas e, the current card is an active AUSM in s lot 6, a nd th e name of the no de is “ excel .” The command notation and argument parameters follow standard programming convention: a space
separates the command and each parameter; variables have an italicized typeface; required arguments appear within “<>” marks; optional parameters appear within square brackets (“[ ]”); and a vertical b ar (|) represent s t he logical OR function .
Cisco MGX 8250 In stal lation a n d Configuration
document. T his document
Note
Release 1.0, Part Number 78-10897-01, July 2000
You must type a ll command arguments then pressReturn or Enter rather than enter one parameter at a time.
When you enter a com ma nd with no pa ramet ers , a usage message appears . Th is message shows syntax and rang es for the applicabl e c omma nd parameters.
Cisco MGX 8250 Multiservice Gateway Command Reference
1-1
List of Commands
List of Commands
The list of commands for the commo n eq uipme nt cards PXM and S RM appear in Tab le 1-1. The se commands are available when you log into the PXM. The node connectivity commands appear in Tabl e 1-2. Appli cab le service module comm an ds become available when yo u switc h t o a card by executing the cc co mm and. The list of service module com mand s appear in Table 1-3. Many commands apply to bot h th e common equipment car ds and the service modules.
Table 1-1 PXM Commands
Command Description
PXM Shelf Group
addtrapmgr Add Trap Manager agetrapmgr Age Trap Manag er clrcderrs Clear Card Errors in BRA M clrmsgcnt Clear Control M essa ge Co unte r cnfclksrc Configure Net work Clock So urc e cnfstatsmgr Configure Statistics Manager cnftrapmgr C onfigure/A dd /Del ete Trap Manage rs deltrapmgr Delete Trap Manager dspcd Display Card dspcderrs DisplayCardErrorsinBRAM dspcds Display Cards dspclksrc Display Clock Sources dspfwrevs Display Firmware Revisions dspmsgcnt Display Control M essage Counter dspsarcnts Display SAR Counters dspsmcnf Display Ser vic e Module Configuration dspstatparms Display Statistics Alarms dsptrapmgr Display Trap Manag er dsptrapmgrs Display Trap Man ag er s rese tcd Reset Card switchcc Switch Core Cards version Version (displays version data for a card) xcnftrapmgr Configure Trap Manag er xdsptrapmgr Display Trap Manag er
PXM User Group
adduser Add User cc Change Card clrscrn Clear Terminal Screen clrlog Clear Event/Message Log
Chapter 1 MGX 8250 Command Line Interface
1-2
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Table 1-1 PXM Commands (continued)
Command Description
cnfpwd C onfigure Password deluser Delete User dsplog Display Event/Message Log dspusers Display Users Help Help (list of commands per card) users Users
PXM Node Group
cnfname Configure Shelf Name cnfdate Configure Date cnftime Configure Time cnftmzn Configure Time Zone cnftmzngmt C onfigure Ti me Zone t o GMT cnfifip Configure Interface IP Address delifip Delete Interface IP Address dspifip Display LAN interface IP
PXM Redundancy Group
addred Add Redundancy delred Del ete Redundancy dspfeature Display Feature dspred Displa y Re dunda ncy softswitch Soft Switch switchback Switch Back
PXM Broadband Interface Group
addrscprtn Add Resource Partition clratmlncnt Clea r an ATM Line’s Counters clratmlncnts Clear All ATM Line Counters clrifcnt C lea r Cou nter s for a Broadband Interface clrifcnts Clear All Counters for a Broadband In ter face cnfatmln Configure ATM Lin e cnfcdrscprtn Configure Card Resource Partition cnfif Configure a Broa dband Interface cnfrscprtn Configure Resource Partition cnfsvclcn Configure SVC LCNs cnfsvcrange Configure SVC Ran ge dnif Disable the Broadband Interface dspatmlncnf Display ATM Line Configuration
List of Commands
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-3
List of Commands
Chapter 1 MGX 8250 Command Line Interface
Table 1-1 PXM Commands (continued)
Command Description
dspcdrscprt Display Card Resource Partition dspcdrsctype Display Ca rd Re sour ce Type dspif Display Inte rface dspifcnt Displa y Inte rface Count dspifrsc Display Interface Resource dspifs Display Interfaces dsplnrsc Display Line Resource dsprscprtns Display All Resource Partitions dspsvcrange Display SVC Rang e upif Add Broadband Interface on PXM
PXM Alarm Group
clralm Clear Line Alarms clralmcnt Clear Alarm C ounters/St atisti cs dspalm Display Alarms for a Line dspalms Display All Alarms o n Card dspalmcnf Display Alarm Thr eshol d Configura tion dspalmcnt Display Alarm Counters/Statistics (line) dspshelfalm Display Shelf Alarms
PXM Line Group
addapsln Add APS on a Line addln Add Line delln Delete Line dspln Display Line Configuration dsplns DisplayAllLinesonCard dspsrmlns DisplayAllLinesonCard
PXM Channel Group
clrsarcnt C l ear S AR Counters dspsarcnt Display SAR C ounters dspservrate Display Service Rate
SRM-3T3 Group
addlink Add SRM-3T3 T3 Link to T1 Slot and Line clrsrmcnf Clear SRM-3T3 Con figuration cnfsrmclksrc Configure SRM-3T3 Clock S ource dellink Delete SRM-3T3 T3 Link from T1 Slot and Line delslotlnk Delete Link from T1 Slot dsplink Display SRM-3T3 T3 Link to a T1 Slot and Line
1-4
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Table 1-1 PXM Commands (continued)
Command Description
dspslotlnk Display Link in T1 Slot dspsrmclksrc Displa y S RM-3T 3 Cloc k S ource
PXM Self-Test Group
clrslftst Clear Self -Test dspslftsttble Display Self-Te st Table
PXM BERT Group
cnfbert xcnfbert
delbert Stop Current BERT Session dspbert Display Results of BERT Session modbert Inject Bit Errors into C urr en t BE RT Session
List of Commands
Configure BERT Se ssion Parameters
Table 1-2 Node Connectivity Commands
Command Description
addtrk Add Trunk clrerr Clear Error Log cnfclksrc Configure Clock Source cnfcmparm C onfigure Connection Manager Parameters cnfifastrk Configure Interface asTrunk cnfname Configure Node Name cnfnwip Configure Networ k I P Address cnfswfunc Configure Software F unc tion cnfsysparm Configure Syst em Parameters cnftrk Configure Trunk deltrk Delete Trunk dncon Down Connection dspcmparm Display Connection Manager Parameters dspcon Display a Connection dspcons Display Connections dsperr Display Error Log dspload Display Load dspmnup Display Mandatory Update Parameters dspname Display Nodename dspnw Display Network dspnwcons Display Network Connections dspnwip Display Network IP Address
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-5
List of Commands
Table 1-2 Node Connectivity Commands (continued)
Command Description
dspswfunc Display Software Functions dspsysparm Display System Parameters dsptrkcnf Display Trunk Configuration dsptrkcons Display Trunk Connec tions dsptrkload Display Trunk Load dsptrkmcons Display Trunk Management Con nect ions dsptrks Display Trunks uncnfifastrk Unconfigure Interface Trunk upcon Up Connection
Table 1-3 Service Module (SM) Commands
Chapter 1 MGX 8250 Command Line Interface
Command Description FRSM AUSM CESM VISM CESM-T3E3
SM Shelf Group
clrcderrs Clear Card Err ors in BRAM X X clrmsgcnt Cle ar Co ntro l Message Counter X X X clrsmcnf ClearServiceModuleConfigurationXXXX cnfcdrscprtn Config ure C ard Resource Partition X X X cnfclksrc Configure Ne twork Clock S ource X cnffst Configure ForeSight X X cnfsvcrange Configure SVC Range X X dspcd DisplayCard XXXXX dspcderrs DisplayCardErrorsinBRAM X X dspcdrscprtn Display Card Resource Partition X X dspclksrc Display Clock Sources X dspmsgcnt DisplayControlMessageCounterXXXXX dspsmcnf Display Service Module
X
Configuration
dspstatparms Display Statistics Parameters X dsptotals Display Totals X X rese tcd Reset Card version Version (di spla ys ca rd version da ta ) X X X X
SM User Group
cc Change Card X X X X clrscrn Clear Terminal Screen X X X X dspmaptbl Display Map Table X X X Help Help(listofcommandspercard)XXXXX
1-6
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
List of Commands
Table 1-3 Service Module (SM) Commands (continued)
Command Description FRSM AUSM CESM VISM CESM-T3E3
Alarm Group
clralm ClearLineAlarms XXXXX clralmcnt ClearAlarmCounters/StatisticsXXXXX clralms ClearAllAlarmsontheCard XXXXX dspalm DisplayAlarmsforaLine XXXXX dspalmcnf Display Alarm Threshold
XXXXX
Configuration
dspalmcnt Display Alarm Counters/Statistics
XXXXX
(line)
dspalms DisplayAllAlarmsonCard XXXXX
SM Line Group
addln AddLine XXXXX addlnloop AddLineLoop XXXX cnfds3ln Configure DS3 Line X cnfln ConfigureLine XXXXX cnfplpp Configure PLPP Parameters X delln DeleteLine XXXXX dellnloop DeleteLineLoop XXXX dspds3ln Display a DS3 Line dspds3lns Display D S3 Lines dspln DisplayLineConfiguration XXXXX dsplns DisplayAllLinesonCard XXXXX
Port Group
addport Add Port X X clrportcnt Clear Port Counte rs X X clrportcnts Clear All Port Co unters X X cnfegrq Configure Egress Q ueue X cnfilmi Con figure I LMI X cnfport Configure FR Port(s) X X cnfportcllm Configure Port CLLM Parameters X X cnfportq Configure AUSM Por t Queue X copyports Copy Port Configuration X X delport Delete FRSM or AUSM Port X delports Delete Port Configurations X X X dnport Down Port X X dspegrq D isplay Egress Queue dspegrqs Display Egress Queues
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-7
Chapter 1 MGX 8250 Command Line Interface
List of Commands
Table 1-3 Service Module (SM) Commands (continued)
Command Description FRSM AUSM CESM VISM CESM-T3E3
dspilmi Display ILMI X dspilmicnt Display I LMI Counters X dspport Display Port Configuration X X dspportcnt D isplay FR Por t Cou nte rs X X dspportq Di splay Port Queue X dspportqs Display Po rt Q ueue s X dspports Display All Ports X X dspportstats Display Port Statistics X upport Up Port X
SM Channel Group
addchan Add Channel X X X X addchanloop Ad d a Channel Loopback X X X clrchancnt Clear Channel Counter for FRSM or
XXX X
AUSM Channels
clrsarcnts Clear SAR Counters X X X cnfchancaoff Configure Channel Admission
X
Control Off
clrchancnts Clear Channel Counter for All FR
XXX
Channels
cnfchanegressq Configure Channel Egre ss Queue X cnfchanfst Configure Channe l ForeSight X X cnfchaningressq Configure Channel Ingress Queue X cnfchanmap Configure C ha nnel Map X X X cnfchanpol Configure Channel Policing X cnfchanq Configure Channel Queue X X copychans Copy Channel Configuration s X X X delchan Delete Channel(s) X X X X delchanloop Delete a Channel Loopback X X X delchans Delete Channels X X X dspchan Display Channel Configuration X X X X dspchancnt Display Channel Counters X X X X dspchans Display All Channels X X X dspchstats Display Channel Statistics X dspsarcnt Display SAR Counters XXXX
SM Connection Group
addcon Add Connection X X cnfupcabr Configure UPC for ABR X
1-8
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
List of Commands
Table 1-3 Service Module (SM) Commands (continued)
Command Description FRSM AUSM CESM VISM CESM-T3E3
cnfupccbr Configure UPC for CBR X cnfupcubr Configure UPC for U BR X cnfupcvbr Configure UPC for VBR X delcon Delete Connection X X dspcon Display a Connection X X dspcons Display Connections X X dsploads Display Loads X tstcon Te st Connection X X X X tstconseg Test Connection Segment X
SM Self-Test Group
clrslftst Clear Self-Test X X X X dspslftsttble Display Self-Test Table X X X X
SM BERT Group
acqdsx3bert Acquire BERT X X clrbertcntrs Remove BERT Counters X X cnfdsx3bert
Configure BERT Parameters X X
xcnfdsx3bert deldsx3bert Stop BE RT Test Session X X dspdsx3bert
Display BERT Results X X
xdspdsx3bert moddsx3bert Inject Bit Errors into BERT Se ssion X X startdsx3bert Begin BERT Session X X
IMA Group
addimagrp Set Up New IMA Group X addlns2imagrp Add Lines to IMA Group X clrimagrpcnt D ele te IMA Group Counters X clrimalncnt Delete Line Counters of IMA Group X clrimatst Stop IMA GroupTest X cnfimaalmparm Configure IMA Group A lar m
X
Parameters for I MA Group
cnfimagrp Configure IMA Group X cnfimatst Configure Testing for IMA Group X delimagrp Remove IMA Group X delnsfmimagrp Remove L ine s f rom IMA Group X dspimaalmparm Display IMA Alarm Parameters X dspimagrp Display IMA Group Configuration X dspimagrpcnt Display Current IMA Group Count ers X
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-9
Chapter 1 MGX 8250 Command Line Interface
List of Commands
Table 1-3 Service Module (SM) Commands (continued)
Command Description FRSM AUSM CESM VISM CESM-T3E3
dspimagrps Display All IMA Groups X dspimaln Display IMA Group L ine X dspimalncnt Display Line Counters of IMA Group X dspimatst Display IMA Group Test Parameters X
1-10
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
?
Help
Use the ? command to view all commands associated with the current card, and to view a list of commands ass o cia t ed w i th a t r unc ate d command entry.
Card(s) on Which This Command Executes
PXM, FRSM, AUSM, CESM
Syntax
command
? [
Syntax Description
]
?
Related Commands
Attributes
Examples
command
help
Log: No State: Any Privilege: Any
This section c onta ins the following exam ples:
View all commands associated with a partial command entry string
View all commands associated with the current card
Full or part ial name of the comman d .
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-11
Chapter 1 MGX 8250 Command Line Interface
?
Example 1-1 View all commands associated with a partial command entry string
raviraj.1.7.PXM.a > ? con
Available commands
-----------------­ addcon clrconcnt clrconcnts cnfcon dcondb delcon dspcon dspconcnt dspcons shellConn tstcon tstconseg
raviraj.1.7.PXM.a >
Example 1-2 View all commands associated with the current card
System response for th e ? command is identical to that when executing the help command. See the examples in the help section beginning on pa g e1- 467.
1-12
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
abort
Abort
Use the abort command to s top the upgrade proces s and ret urn to the previous firmware version.
Using abort after a newrev returns the P XM to the origina l firmware image.
Using abort after install resets the PXM(s) to their original states.
See Fi gure 1-1 to see the relationshi p of the abor t command compared with other firmware co mmand s.
Figure 1-1 Firmware-Related Commands
Firmware
(any original firmware)
is loaded via TFTP
Active
PXM
A
11
abort
Standby
PXM
install command loads
firmware 2 (any new
firmware) to the hold PXM
newrev command switches
active and hold PXMs
in order to test new firmware
commit command copies
firmware to the
standby PXM
Standby
PXM
D
22
B
C
Active
PXM
Active
PXM
Hold PXM
Hold PXM
12
Active
PXM
12
abort command reverses process and restores the
rstupgrade command after the install command restores the switch to the A configuration
rstupgrade command after the newrev command places the switch in the D configuration
previous firmware
Active
PXM
E
11
Standby
PXM
29326
Card(s) on Which This Command Executes
PXM
Syntax
abort <
Release 1.0, Part Number 78-10897-01, July 2000
version
>
Cisco MGX 8250 Multiservice Gateway Command Reference
1-13
abort
Syntax Description
Related Commands
Attributes
Chapter 1 MGX 8250 Command Line Interface
version Original firmware version.
A system respo nse does not occur unle ss an erro r is detected.
dspupgrade, rstupgrade, newrev, dspfwrevs, printrev, commit, copy, install
Log: No State: Active Privilege: Any
Example 1-3 Abort loading firmware 1.1.24
NODENAME.1.7.PXM.a > abort 1.1.23 this may take a while ... abort command completed ok This card will be reset, the other will become active.
Example 1-4 Errors loading firmware (multiple cases)
NODENAME.1.8.PXM.a > abort 1.1.24 cannot be in 'upgrade idle', must be in 'upgrade' or 'upgrade install' ERR: command "abort" failed
NODENAME.1.7.PXM.a > abort 1.1.24
1.1.24 is not the old version 1.1.10aa ERR: command "abort" failed
1-14
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
acqdsx3bert
Acquire DS3 BERT
Use the acqdsx3bert command t o find out if a bit error rate test (BERT) sessi on already exists on the selected MGX 8250 switch.
Card(s) on Which This Command Executes
FRSM 2CT3, CESMT3
Syntax
acqdsx3bert
Related Commands
cnfdsx3bert, dspdsx3bert, moddsx3bert, startdsx3bert, xcnfdsx3bert, xdspdsx3bert
Attributes
acqdsx3bert
Log: No State: Any Privilege: Any
Example 1-5 Acquire current BERT session
NODENAME1.1.21.CESMT3.a > acqdsx3bert dspdsx3BertCntrs : BCRunning : 00 BCStorage : 0 BECRunning : 00 BECStorage : 0
DSX3 BERT in Sync
NODENAME1.1.21.CESMT3.a >
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-15
addapsln
addapsln
Add APS to a Line
Use the addapsln command to set Automatic Protection Switching (APS) on a specified line for the current PX M.
APS is a SONET switching mechanism that routes traffic from working lines to protect them in case of a line card failure or fiber cut.
To set APS parameters, use the cn f ap sl n command following the a ddapsln command.
Card(s) on Which This Command Executes
PXM
Syntax
Chapter 1 MGX 8250 Command Line Interface
Syntax Description
addapsln <
workline
workslot
protectline
protectslot
archmode
workline><workslot><protectline><protectslot><archmode
OC-3 or OC-12 lin e num ber on which t o set APS.
OC-3 range = 1–4
OC-12 = 1
Slot number of the PXM, either 7 or 8 .
Protection line number.
OC-3 range = 1–4
OC-12 = 1
Protection slot number, either 7 or 8.
APS architect mode to be used o n the working/protection line pai rs.
1 = 1+1 one back card
2 = 1+1 two back cards
3 = 1:1 one back card
>
Related Commands
Attributes
Cisco MGX 8250 Multiservice Gateway Command Reference
1-16
4=1+1AnnexB
cnfapsln, delapsln, dspapsln, switchapsln
Log: Yes State: A ctive Privilege: SuperUse r
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Example 1-6 Add APS Protection line 1 on slot 8 to APS Working line1 on slot 7. Set the APS
spirit4.1.8.PXM.a > addapsln 1 7 1 8 2 spirit4.1.8.PXM.a >
addapsln
architect mode on the working/protection line pair to 1+1.
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-17
addaimgrp
addaimgrp
Add IMA Group
Use the addaimgrp comman d to set an AIMUX group on the current AUSM.
Card(s) on Which This Command Executes
AUSM
Syntax
Chapter 1 MGX 8250 Command Line Interface
Syntax Description
Related Commands
Attributes
addaimgrp <
group_num
port_type
list_of_links
group_num><port_type><list_of_links><minNumLinks>
AIMUX group number, in the range 1–8.
Port type.
1=UNI
2=NNI
List of physical li nes, in the range 1–8, to be included in aimux_grp. Type a period (.) between each line in the string to delineate each member of the AIMUX group.
minNumLinks
Minimum number of links for the group formation, in the range 1–8.
delaimgrp, cnfaimgrp, dspaimgrp, dspaimgrps
1-18
Log: Yes State: Act ive Privilege : Group 1
Example 1-7 Add IMA group 2 as UNI with lines 3, 4, and 5
spirit4.1.18.AUSM.a > addaimgrp 2 3.4.5 spirit4.1.18.AUSM.a >
A system respo nse does not occur unless an erro r is detected. Possible errors inclu de :
Parameters are illegal or invalid.
IMA group a lrea dy exists.
A line is not enabled.
All lines are not in local mod e.
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
addcdrscprtn
Add Card Resource Partition
Use the addcdrscprtn command to set card-level r e sour ce partitions.
addcdrscprtn
Note
This command applies only if the card partition type is controllerBased.
The resource you can partition at the card level is the number of connections available to a network controller.
With card-level partitioning:
The number of c onn ect ions available at each port is the same.
You can spe cify the number of connection s ava ilable to each controller or let the m comp ete for connections at each p ort.
Table 1-4 describes the effects of each of three usages of addcdrscprtn.
Table 1-4 Degrees of Card-Level Resource Partitioning
Command Description
addcdrscprtn off
Card-level partitioning is inactive. You must partition resources at the port level. (See also cnfportrscprtn.)
addcdrscprtn on
Default. Card-level partitioning is on, but no allocation for a specific controller
is spec ified. The maximum num be r of connections o n a p ort is available to each contr oll er. Each controll er t here fo re competes fo r th e connections.
addcdrscprtn on <x><y><z>
In addition to the definitions in Table 1-4, note the following characteristics of this command:
If you specify that card-level partitioning is off (addcdrscprtn off), port-level p ar titi onin g is mandatory (cn fportr scp rtn).
If you do not execu te addcdrscprtn, th e default st ate of addcdrscprtn on is in effect.
If you specify card-level part itio ning (addcdrscprtn on xyz (cnfportrscpr tn) i s a n option you can u se to further modify the partitioning on a port.
Card(s) on Which This Command Executes
PXM, FRSM, CESM, VISM
Syntax: PXM
addcdrscprtn <
Release 1.0, Part Number 78-10897-01, July 2000
ctrlr_num><num_lcns
Same as addcdrscprtn,exceptx,y,andzrepresent th e number of connections per port available t o the PAR, PNNI, a nd Tag controllers, respectively.
), port-l evel partitio ning
>
Cisco MGX 8250 Multiservice Gateway Command Reference
1-19
addcdrscprtn
Syntax Description
Syntax: FRSM
Chapter 1 MGX 8250 Command Line Interface
ctrlr_num Controller type.
1=PAR
2=PNNI
3=TAG
num_lcns Number of available global logica l conne c tion n umb ers (G LCN s), i n the r an ge
0–32767.
Syntax Description
Syntax: CESM
Syntax Description
addcdrscprtn <
controller
numOfLcnAvail
addcdrscprtn <
controller><numOfLcnAvail
>
Controller type.
1=PAR/PVC
2 = PNNI/SPVC
3=TAG
Maximum number of LCNs, i n t he range appropriate for the card.
2CT3 range = 1–4 000
2T3 range = 1–2000
2E3 range = 1–2000
HS2 range = 1 –20 00
controller><numOfLcnAvail
>
1-20
controller
numOfLcnAvail
Cisco MGX 8250 Multiservice Gateway Command Reference
Controller type.
1=PAR/PVC
2 = PNNI/SPVC
3=TAG
Maximum number of LCNs, in the ra nge 0–248.
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Related Commands
cnfrscprtn, dspcdrscprtn, delcdrscprtn
Attributes
Log: Yes State: Any (Active for PXM ) Privilege: Any
Example1-8 OncurrentPXM,changecard-levelpartitioningtogive10000GLCNstoPARand10000
spirit4.1.8.PXM.a > addcdrscprtn 10000 0 10000 spirit4.1.8.PXM.a >
addcdrscprtn
GLCNs to Tag. The value for PNNI currently is 0.
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-21
addchan
addchan
Add Channel
Use the addchan co mman d to configure ch anne ls on the cur rent P XM, FRSM , AUSM, or CESM. The syntax for using addchan on an AUSM differs from that used on all other cards. See Syntax:AUSM, page 1-26 fo r guide li nes.
Card(s) on Which This Command Executes
PXM, FRSM (8T1/E1, HS1/B, VHS), AUSM, CESM
Syntax: PXM
Chapter 1 MGX 8250 Command Line Interface
Syntax Description
addchan <LCN><
chan_master
<
>
LCN
if_num
conn_type
vpi
vci
serv_type
if_num><conn_type><vpi><vci><serv_type><y_vpi><y_vci><y_nsap
Logical con necti on number, in the range 16–4111.
Numberofthe logicalinterfaceport that receivesconnectiontraffic, in the range 1–32.
Virtual p at h connection (VPC) or virtual channel connection (VCC).
1=VPC
2=VCC
Virtual p ath i dent ifier (VPI ) value, in the range 0–4095.
Virtual c hann el identifier (VCI) value, in t he range 0–65535.
Service type.
1 = CBR (constant bit rate)
2 = VBR ( variabl e bit rate)
3 = ABR (available bit rate)
>
1-22
4=UBR(unspecifiedbitrate)
5 = VBR-RT (variable bit rate—real-time class)
y_vpi
y_vci
Cisco MGX 8250 Multiservice Gateway Command Reference
Remote VPI value, in the range 0– 409 5.
Remote VCI value, in the range 0–65535.
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
addchan
Syntax: FRSM-8T1/E1
Syntax Description
y_nsap
Remote Network Service Access Point (NSAP) value, in the f ormat node.slot.port. An N SAP is the point at which OSI Network Service is made available to a transport layer (Layer 4) entity.
chan_master
Status of local endpoint, either master or slave.
1=master
2=slave
addchan <chan><port><dlci><cir><chan_type>[
rmtvci><rmtnsap
<
chan
port
>
Channel number, in the range 16–1015.
Port number for T1 or E1.
T1 range = 1–192
E1 range = 1–248
CAC]<mastership><locnsap><rmtvpi
>
dlci
cir
chan_type
CAC
mastership
Data-link connectio n iden tifier ( DLCI) value, in the range 0–1023.
Committed information rate (CIR) value for T1 bps or E1 bps.
T1 range = 0–1536000
E1 range = 0–204800
Channel type.
1=NIW
2 = SIW- transparent
3 = SIW-translation
4=FUNI
5=frameforwarding
Connection admission control (CAC), either enabled or disabled.
1 = enabl e
2 = disable (defau lt)
Status of current end, either master or slave.
1=master
2=slave
locnsap
Release 1.0, Part Number 78-10897-01, July 2000
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the local node n ame, slot, and port in NSAP format.
Cisco MGX 8250 Multiservice Gateway Command Reference
1-23
addchan
Chapter 1 MGX 8250 Command Line Interface
Syntax: FRSM-HS1/B
Syntax Description
rmtvpi
rmtvci
rmtnsap
Remote virtual path identifier (VPI) value, in the range 1–65535.
Remote virtua l channel identifier (VCI) value, in the range 1–65535.
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the remote node name, slot, and port in NSAP format.
addchan <chan_num ><port_num><dlci_num><cir><chan_type>[CAC]<mastership><locnsap>
rmtvpi><rmtvci><rmtnsap
<
chan_num
port_num
dlci_num
Channel numb er, in the range 16–1015.
Port number, in the range appropriate for the inter face.
Data-link conne ction identifier (DLCI) va lue, in the range 0–1023.
>
X.21 range = 1–4
HSSI range = 1– 2
cir
chan_type
CAC
mastership
Committed information rate (CIR) value, in the range appropriate for the interface.
X.21 range = 0–10000000 bps
HSSI range = 0–20000000 bps
Channel type .
1=NIW
2 = SIW-transparent
3 = SIW-translation
4 = FUNI
5 = frame forwarding
Connection ad mission control, either enabled or dis abl ed .
1 = enable
2 = disable (default)
Status of cu rr ent end, either mas te r o r sl ave.
1=master
2=slave
1-24
locnsap
A 20-byte string , whi ch is th e hexadecimal form of the ASCII character string that identifies the local node name, slot, and port in NSAP format.
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
addchan
Syntax: FRSM-VHS
Syntax Description
rmtvpi
rmtvci
rmtnsap
Remote virtual path identifier (VPI) value, in the range 1–65535 .
Remote virtual channel identifier (VCI) value, in the range 1–65535.
A 20-byte string , whi ch is th e hexadecimal form of the ASCII character string that iden ti fies the remote node name, slot, and port in NSAP format.
Possible errors include:
Parameters are illegal or invalid.
The channel already exists.
The port m ight not be up.
addchan <chan><port><dlci><cir><chan_type><serv_type>[
locnsap><rmtvpi><rmtvci><rmtnsap
<
chan
Channel number, in the range 16–4015.
>
CAC_enable]<mastership
>
port
dlci
cir
chan_type
serv_type
Port number, in the ran ge 1–256.
Data-link connectio n iden tifier ( DLCI) value, in the range 0–1023.
Committed information rate (CIR) value for T1 bps or E1 bps.
T1 range = 0–1536000
E1 range = 0–2048000
Channel type.
1=NIW
2 = SIW- transparent
3 = SIW-translation
4=FUNI
5=frameforwarding
Service type.
1 = CBR (constant bit rate)
2 = VBR ( variabl e bit rate)
3 = ABR (available bit rate)
4=UBR(unspecifiedbitrate)
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-25
addchan
Chapter 1 MGX 8250 Command Line Interface
Syntax: AUSM
CAC_enable
Connection admission control (CAC), either enabled or disabled.
1 = enable
2 = disable (defau lt)
mastership Status of current end, either master or slave.
1=master
2=slave
locnsap
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the local node n ame, slot, and port in NSAP format.
rmtvpi
rmtvci
rmtnsap
Remote virtual path identifier (VPI) value, in the range 1–65535.
Remote virtua l channel identifier (VCI) value, in the range 1–65535.
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the remote node name, slot, and port in NSAP format.
addchan <channel number><connection type><port nu mb er><vpi><vci><service type>
mastership><locnsap><rmtvpi><rmtvci><rmtnsap
<
>
Syntax Description
channel number
connection type
port number
vpi
vci
service type
Channel number, in the range 16–1015.
Connection type, either virtual path con necti on (VPC) o r virt ual channel connection(VCC ).
1=VPC
2=VCC
Port number, in the ran ge 1–8.
Virtual path identifier (VPI)value, in the range 0–255.
Virtual c hann el identifier (VCI) value, in t he range 0–65535.
Service type.
1 = CBR (constant bit rate)
2 = VBR ( variabl e bit rate)
3 = ABR (available bit rate)
4=UBR(unspecifiedbitrate)
1-26
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
addchan
Syntax: CESM-8T1E1
mastership
Status of current end, either master or slave.
1=master
2=slave
locnsap A 20-byte string, which is the hexadecimal form of the ASCII character string
that identifies the local node n ame, slot, and port in NSAP format.
rmtvpi Remote VPI value, i n t he range 1–65535.
rmtvci Remote VCI value, in the range 1–65535. This setting should be identical to that
for the logical port number of the r emote endpoint.
rmtnsap 20-bytestring, which is th e hexadecimalformof the ASCII character string that
identifies the remote node name, slot, and port in NSAP format.
Example 1-9 Add a VCC connection to channel 16 on port 1 with vpi=1, vci=1, ABR service type, and
an egress queue number of 1
spirit4.1.18.AUSM.a > addchan 16 2 1 1 1 3 1 spirit4.1.18.AUSM.a >
addchan <
chan_num><port_num><sig_type><partial_fill><cond_data><cond_signal
>
[mastership | locnsap | rmtvpi | rmtvci | rmtnsap]
Syntax Description
chan_num
port_num
sig_type
partial_fill
Channel number, in the range 32–279.
Port number for T1 or E1.
T1 range = 1–192
E1 range = 1–248
Type of signalling to be used. All channels on a line should have the same value.
1=basic
2=E1CAS
3=DS1superframeCAS
4=DS1extendedsuperframeCAS
Number of bytes to partia ll y fill a cell for different l i nes.
0 = a fully filled cell (default)
20–47 = cells for structured E1
25–47 = for st ructure d T1
33–47 = for unst ruct ure d T 1 o r E1
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-27
addchan
Chapter 1 MGX 8250 Command Line Interface
cond_data
Data-conditioning, either UDT or SDT.
UDT = 255
SDT range = 0–2 55
cond_signal Con dition signal, in t he range 0–15.
mastership Status of current end, either master or slave.
1=master
2 = slave (default)
locnsap
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the local node n ame, slot, and port in NSAP format.
rmtvpi
rmtvci
Remote virtual path identifier (VPI) value, in the range 1–65535.
Remote virtua l channel identifier (VCI) value, in the range 1–65535. This se ttin g should be id entic al to that for the logical port number of the remote endpoint.
rmtnsap
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the remote node name, slot, and port in NSAP format.
Syntax: CESM-T3E3
Syntax Description
Possible errors include:
Parameters are illegal or invalid.
The channel already exists.
The port m ight not be up.
addchan <chan_num ><port_num><
rmtnsap
<
chan
port
cond_sig
mastership
>
Channel number. Enter the value 32.
Port number. Enter the value 1.
Condition signal nu mber, in the range 0–15.
Status of the current end, either mas ter or slave.
1=master
2=slave
cond_sig><mastership><locnsap><rmtvpi><rmtvci
>
1-28
locnsap
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the local node n ame, slot, and port in NSAP format.
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
addchan
Related Commands
Attributes
rmtvpi
rmtvci
Remote virtual path identifier (VPI) value, in the range 1–65535.
Remote virtua l channel identifier (VCI) value, in the range 1–65535. This se ttin g should be id entic al to that for the logical port number of the remote endpoint.
rmtnsap
A 20-byte string, which is the hexadecimal form of the ASCII character string that identifies the remote node name, slot, and port i n NSAP format.
Possible errors include:
Parameters are illegal or invalid.
The channel already exists.
The port m ight not be up.
delchan, dspchan, dspchans
Log: Yes State: Act ive Privilege : Group 2
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-29
addchanloop
addchanloop
Add a Channel Loopback
Use the addchanloop command to configure a channel loopback to the current FRSM orAUSM card. This command causes the channel to l oop at the segmentation and reassembly (SAR) stage.
Card(s) on Which This Command Executes
FRSM, AUSM
Syntax: FRSM
Chapter 1 MGX 8250 Command Line Interface
Syntax Description
Syntax for AUSM-8T1E1
Syntax Description
addchanloop <
chan_num
addchanloop <
port.VPI.VCI
chan_num
port.VPI.VCI | Ch anN um
>
Channel number to be used for t he loopback on the FRSM card.
8T1/E1 range = 16–1015
HS1/B range = 16–1015
T3/E3/HS2 range = 16– 2015
2CT3 range = 16– 401 5
>
Port range = 1–N, as appropriate for the physical installation. Virtual p ath identifier ( VPI) range = 1–4095. Virtual c ha nnel identifier (VCI) range = 1–65535.
Related Commands
Attributes
Cisco MGX 8250 Multiservice Gateway Command Reference
1-30
ChanNum
delchanloop, tstcon, tstdelay
Log: No State: Active Privilege: Group 4
Channel number, in the range 16–1015.
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Example 1-10 Add channel loopback onto channel number 21
s1.1.12.AUSMB8.a > addchanloop 21
Example 1-11 Add channel loopback onto port 2, VPI 1, VCI 1
s1.1.12.AUSMB8.a > addchanloop 2.1.1
addchanloop
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-31
addcon
addcon
Chapter 1 MGX 8250 Command Line Interface
Add Connection
Use the addcon comman d to c onfigure connectivity to the current card. The addcon command is preferable to addchan for adding a connection because addcon does not re quire the N SAP a ddresses.
Command execution includes a specification of the endpoint as either the master or the slave. Execute addcon first at the slave end, then the master end. The syntax for the master end includes a parameter
SlaveConID
. Rather than a single number,
SlaveConID
is the node name, slot number,port number,and
connection id entifier (if applicable) of the slave en d.
Note
To set up a three-segment connection across a network, specify the PXM as slot 0.
Card(s) on Which This Command Executes
PXM, FRSM, CESM, AUSM
Syntax: PXM
addcon <
remoteConnId
[
port_no><conn_type><local_VPI><local_VCI><service>[CAC][mastership
]
Syntax Description
port_no Por t num be r, in the r ange 1–32.
conn_type
local_VPI
local_VCI
Virtual p at h connection (VPC) or virtual channel connection (VCC).
1=VPC
2=VCC
Local virtual path identifier (VPI), in the range 0–4095.
Local virtual channel identifier (VCI), in the range 0–65535.
]
1-32
service
CAC
Cisco MGX 8250 Multiservice Gateway Command Reference
Type of service.
1 = CBR (constant bit rate)
2 = VBR ( variabl e bit rate)
3 = ABR (available bit rate)
4=UBR(unspecifiedbitrate)
Connection admission control (CAC).
1 = enable
2 = disable (defau lt)
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
addcon
Syntax: FRSM-8T1/8E1
Syntax Description
mastership
Status of the current end, either maste r or slave.
1 = master (You must also set
2 = slave (default)
remoteConnId
for the master.)
remoteConnId Remote connection identifier,in the format NodeName.SlotNo.PortNo.VPI.VCI.
addcon <
RemoteEndConID
<
port number
DLCI
CIR
port number><DLCI><CIR><channel type>[Adm_cntrl]<controller_type>[mastership
>
Port number for T1 or E1.
T1 range = 1–192
E1 range = 1–248
Data-link connection identifier (DLCI) in the range 0–1023.
Committed information rate (CIR) for T1 bps or E1 bps.
T1 range = 0–1536000
]
channel type
Adm_cntrl
controller_type
E1 range = 0–2048000
Type of connection to be used on the channel.
1 = NIW (network i nte rworking )
2 = SIW-transparent (service interworking without any SDU translation)
3 = SIW-translation (service interworking with SDU translation)
4=FUNI(FrameRelayUNI)
5=frameforwarding
Connection admission control (CAC), either enabled or disabled.
1 = enabl e CAC
2 = disable CAC (default)
Signalling controller type, either PVC or SPVC.
1 = PVC (PAR ) ( default)
2 = SPVC (PNNI)
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-33
addcon
Chapter 1 MGX 8250 Command Line Interface
mastership
Status of the connection, either master or slave.
1=master
2 = slave (default)
RemoteEndConID Node n ame, slot number, port number, and DLCI.
or Node name, slot number, port number, Controller I D, and DLCI for a Frame
Relay endpoint. Use one of the fo llowing values to set controller type:
1=PAR
2=PNNI
3=TAG or Node name, slot number, port number, and VPI.VCI for anATM endpoint.
A system respo nse does not occur unless an erro r is detected. Possible errors inclu de :
Parameters are illegal or invalid.
The channel already exists.
The port m ight not be up.
Syntax: FRSM-2CT3
Syntax Description
addcon <
controller_type><mastership><RemoteEndConID
<
port number
DLCI
CIR
channel type
port number><DLCI><CIR><channel type><egress service type>[Adm_cntrl
Port number in th e range 1–256.
Data-link connectio n iden tifier ( DLCI) value, in the range 0–1023.
Committed information rate (CIR), in the range 0–1536000 bps.
Type of connection on this channel.
1 = NIW (network i nte rworking )
2 = SIW-transparent (service interworking without any SDU translation)
3 = SIW-translation (service interworking with SDU translation)
4=FUNI(FrameRelayUNI)
5=frameforwarding
]
>
1-34
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
addcon
egress se rvice t ype
Type of egress s ervice provided on this channel.
1 = highpriorityQ (typically committed b it rate connections)
2 = rtVBRQ (re al-t ime variable bit rate connectio n s )
3 = nrtVBRQ (n on- real time variable bit rate connections)
4 = aBRQ (available bit rate connections)
5 = uBRQ (unspe cified bit ra te connections)
Adm_cntrl Connection admission control ( CAC), either enabled or d isabled.
1 = enabl e CAC
2 = disable CAC (default)
controller_type
mastership
RemoteEndConID
Signalling controller type, either PVC or SPVC.
1 = PVC (PAR ) ( default)
2 = SPVC (PNNI)
Status of connec tion, either master or slave.
1=master
2 = slave (default)
Node name, slot number, port number, and DLCI.
or
Syntax: FRSM-2T3/2E3
Syntax Description
Node name, slot number, port number, Controll er ID, and DLCI fo r a F rame
Relay endpoint. Use one of the fo llowing values to set controller type:
1=PAR
2=PNNI
3=TAG or Node name, slot number, port number, and VPI.VCI for anATM endpoint.
addcon <
controller_type><mastership><RemoteEndConID
<
port number
DLCI
port number><DLCI><CIR><channel type><egress service type>[Adm_cntrl
Port number in th e range 1–2.
Data-link connectio n id entifier ( DLCI ) value in the range 0–1023.
]
>
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-35
addcon
Chapter 1 MGX 8250 Command Line Interface
CIR
Committed information rate (CIR) bps value for 2T3 or 2E3.
2T3 range = 0–44210000
2E3 range = 0–34010000
channel type Type of connection on this channel.
1 = NIW (network i nte rworking )
2 = SIW-transparent (service interworking without any SDU translation)
3 = SIW-translation (service interworking with SDU translation)
4=FUNI(FrameRelayUNI)
5=frameforwarding
egress se rvice t ype
Adm_cntrl
Type of egress s ervice provided on this channel.
1 = highpriorityQ (typically committed b it rate connections)
2 = rtVBRQ (rea l-tim e variable bit rate connections)
3 = nrtVBRQ (non real-time variable bit rate connections)
4 = aBRQ (available bit rate connections)
5 = uBRQ (unspe cified bit ra te connections)
Connection admission control (CAC), either enabled or disabled.
controller_type
mastership
RemoteEndConID
1 = enable CAC
2 = disable CAC (default)
Signalling controller type, either PVC or SPVC.
1 = PVC (PAR ) ( default)
2 = SPVC (PNNI)
Status of connec tion, either master or slave.
1=master
2 = slave (default)
Node name, slot number, port number, and DLCI. or Node name, slot number, port number, Controller I D, and DLCI for a Frame
Relay endpoint. Use one of the fo llowing values to set controller type:
0=PAR
1=PNNI
2=TAG
or Node name, slot number, port number, and VPI.VCI for anATM endpoint.
1-36
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Syntax: FRSM-HS2
addcon <port nu mbe r><DLCI><CIR><channel type><egress service type>[Adm_cntrl] <controller_type><mastership><Re mot eEnd ConI D>
Syntax Description
port number Port number, in the range 1–2.
DLCI Data-link channel identifier (DLCI) value, in the range 0–1023.
CIR Com mitted inf ormatio n r ate (CIR), in the range 0–51840000 bps.
channel type Type of connection on this channel.
1 = NIW (network i nte rworking )
2 = SIW-transparent (service interworking without any SDU translation)
3 = SIW-translation (service interworking with SDU translation)
4=FUNI(FrameRelayUNI)
addcon
egress se rvice t ype
Adm_cntrl
controller_type
5=frameforwarding
Type of egress s ervice provided on this channel.
1 = highpriorityQ (typically committed b it rate connections)
2 = rtVBRQ (re al-t ime variable bit rate connectio n s )
3 = nrtVBRQ (n on- real time variable bit rate connections)
4 = aBRQ (available bit rate connections)
5 = uBRQ (unspe cified bit ra te connections)
Connection admission control (CAC), either enabled or disabled.
1 = enabl e CAC
2 = disable CAC (default)
Signalling controller type, either PVC or SPVC.
1 = PVC (PAR ) ( default)
2 = SPVC (PNNI)
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-37
addcon
Chapter 1 MGX 8250 Command Line Interface
Syntax: AUSM
Syntax Description
mastership
Status of the connection, either master or slave. 1=master 2 = slave (default)
RemoteEndConID Node n ame, slot number, port number, and DLCI.
or Node name, slot number, port number, Controller I D, and DLCI for a Frame
Relay endpoint. Use one of the fo llowing values to set controller type:
0=PAR
1=PNNI
2=TAG
or Node name, slot number, port number, and VPI.VCI for anATM endpoint.
addcon slave | master <
port number><vpi><vci><Conn type><Service Type
>
slave | master Associates the AUSM port with either master or slave status.
port number
vpi
vci
Conn type
Port number, in the ran ge 1–8.
Virtual path identifier (VPI)value, in the range 0–255.
Virtual c hann el identifier (VCI) value, in t he range 0–65535.
Typ e of connection.
0 = VCC con necti on
non-zero = Lo ca l connection
VP ID of the VPC (1 to 20 (UNI)/100 (STI)/340 (NNI)
Service Type
SlaveConID
Service type.
1 = CBR (constant bit rate)
2 = VBR ( variabl e bit rate)
3 = ABR (available bit rate)
Used only f or ma ste r con figurat ion: Node name, slot number, por t nu mber, VCI, a nd V PI o f the slave end.
1-38
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Example 1-12 Add a VCC connection to channel 16 on port 2 with vpi=1, vci=1, ABR service type, and
spirit4.1.18.AUSM.a > addcon 16 2 1 1 1 3 1 spirit4.1.18.AUSM.a >
A system respo nse does not occur unless an erro r is detected. Possible errors inclu de :
Parameters are illegal or invalid.
The channel already exists.
The port m ight not be up.
Syntax: CESM 8T1/E1
addcon
an egress queue number of 1
Syntax Description
addcon <
mastership][RemoteEndConID
[
port_num
sig_type
partial_fill
port_num><sig_type><partial_fill><cond_data><cond_signalling>[controller_type
Port number for T1 or E1 inte rf ace.
T1 range = 1–192
E1 range = 1–248
Channel associated signalling (CAS) value.
1=basic
2=E1CAS
3=DS1superframeCAS
4=DS1extendedsuperframeCAS
Number of bytes to set cell fills, as associated with line types.
Partial fill, in the range 0–47. Enter the value either 0 o r 47 to set this
parameter f or fully filled cells.
Structured T1, in t he range 25–47.
Structure E1, in t he range 20–47.
]
]
cond_data
cond_signalling
Release 1.0, Part Number 78-10897-01, July 2000
Unstructured T 1/E1 , in the range 33–47.
Conditional data UDT or SDT.
UDT = 255
SDT range = 0–2 55 Conditional data is sent on the line when there is an underflow and also toward
the network when forming d ummy cells.
Conditional signalling, in the range 0–15. Conditional signalling i s s ent on the line when there is an underflow and also
toward the network when forming dummy cells.
Cisco MGX 8250 Multiservice Gateway Command Reference
1-39
addcon
Chapter 1 MGX 8250 Command Line Interface
controller_type
Signalling controller type, either PVC or SPVC.
1 = PVC (PAR ) ( default)
2 = SPVC (PNNI)
mastership Status of current end, either master or slave.
1=master
2 = slave (default)
RemoteEndConID
Node name, slot number, port number, and DLCI. or Node name, slot number, port number, Controller I D, and DLCI for a Frame
Relay endpoint. Use one of the fo llowing values to set controller type:
0=PAR
1=PNNI
2=TAG
or The node name , slot number, po rt number, and V PI.VC I f or a n ATM endpo int.
Note
Note: the slot number should be set to 0 (zero) to point to the active PXM.
Related Commands
Attributes
A system respo nse does not occur unless an erro r is detected. Possible errors inclu de :
Parameters are illegal or invalid.
The channel already exists.
The port m ight not be up.
delcon, dspcons, dspcon
Log: Yes State: Act ive Privilege : Group 2
1-40
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
addendpt
Add End Point
Use the addendpt command to set the endpoints on the VIS M card. An endpoint is a logical port that consists of one or more DS0s. It resembles the logical port on the channelized FRSM o r CESM card. The ds1_num and the ds0_list are used to create the endpoint ID . The SU requires the endpoint ID to send the Create Connection (CRCX) command of the SGCP protocol to the VISM.
Card(s) on Which This Command Executes
VISM
Syntax
addendpt
Syntax Description
Related Commands
addendpt <
endpoint_num
ds1_num
ds0_list
None
endpoint_num><ds1_num><ds0_list
>
Number of th e endpoint, in the ran ge 1–240.
Number of th e physical line associated with this endpoint, i n t h e ra nge 1–8.
The list of DS0s at this endpoin t. Set the list nu mber as a ppropr iate f or T1, E1 , or VISM.
E1 range = 1– 31
T1 range = 1–24
VISM: DS0s can be non-contiguous Separate individual DS0s by a period (.). For the current release of the VISM,
only 1 DS0 can exist on an endpo int . For multiple D S0s, you can sp ec ify a range of DS0s with a dash (-). For example, 1.3–5 means DS0s 1, 3, 4, and 5.
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-41
addendpt
Attributes
Chapter 1 MGX 8250 Command Line Interface
Log: Yes State: Act ive Privilege : Any
Example 1-13 Add endpoint number 1 to physical line 1. This endpoint uses DS0 1.
spirit4.1.28.VISM.a > addendpt 1 1 1 spirit4.1.28.VISM.a >
A system respo nse does not occur unle ss an erro r is detected.
1-42
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
addimagrp
Add IMA Group
Use the addimagrp comman d to configure an IMA gro up for the currentAUSM.
Card(s) on Which This Command Executes
AUSM
Syntax
addimagrp
Syntax Description
Related Commands
Attributes
addimagrp <
group_num
port_type
list_of_lines
group_num><port_type><list_of_lines><minNumLinks
Number of the IMA group to be configured, in the range 1– 8.
Value t o s et port type as either UNI or NNI.
1=UNI
2=NN1
List of links to be included in
group_num
. Delineate each item in the list
with a (.).
minNumLinks
Minimum number of li nks for t he group formation, in the range 1–8.
dspimagrp, dspimagrpcnt, dspimagrps, dspimainfo, dspimalncnt
>
Log: Yes State: Act ive Privilege : Group 1
Example 1-14 Add IMA group 2 as UNI with lines 3, 4, and 5
spirit4.1.28.AUSM.a > addimagrp 2 1 3.4.5 spirit4.1.28.AUSM.a >
A system respo nse does not occur unless an erro r is detected. Possible errors inclu de :
Parameters are invalid or illegal.
IMA group a lrea dy exists.
One of the lines is not e nabl ed.
All lines are not in local mode.
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-43
addlink
addlink
Add Link
Use the addlink commandtoconfigurealinkbetweenaT1linewithinaT3lineonanSRM-3T3card and a slot a nd l ine number on a T1 ser vice module.
Card(s) on Which This Command Executes
PXM
Syntax
Chapter 1 MGX 8250 Command Line Interface
Syntax Description
addlink <
T3LineNum><T1Slot><Numberof T1s><TargetSlotNum><TargetSlotLineNum
T3LineNum
T1Slot
Number of T1s
Target Slot n umbe r
>
Line number in the format
slot=15or31
line range = 1–3
slot.line
.
Slot nu mb er 15 is used for t h e cards in slot and 15 an d 16 (whichever is ac tive). Slot 31 is use d for cards in 31 and 32.
T1 slot number, in the range 1–28.
Number of T 1s, in t he range 1–8.
T1 service m odu le slot nu mber to b e linked to the T1 line, in the fo llowing ranges:
1–6
11–14
17–22
27–30.
Related Commands
Attributes
Cisco MGX 8250 Multiservice Gateway Command Reference
1-44
TargetSlotLineNum
T1 line numb er in the slot to be linked, in the range 1–4 or 1–8.
dsplink, dellink
Log: No State: Active Privilege: Any
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Example 1-15 Add a link between the T1 line 1 within T3 line 2 on the SRM-3T3 card in slot 15 and
spirit4.1.8.PXM.a > addlink 15.2 1 3 5 spirit4.1.8.PXM.a >
addlink
T1 line number 5 on the T1 service module in slot 3
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-45
addlmiloop
addlmiloop
Chapter 1 MGX 8250 Command Line Interface
Add Loopback Line
Use the addlmiloop command to stop sending LMI connection status messages to the BPX feeder trunk. This comm and should be used in conjunction w ith addfdrlp on the BPX (see Figure 1-2). This command can be us ed only if a feeder trunk exists.
After you have executed the addlmiloop c omma nd on the MGX 8250 switch and th e addfdrlp command on the BPX series s witc h, use the dsplmistats comman d on the BPX sw itc h. The dsplmistats command shows the LMI messages exchanged between the BPX series switch and the MGX 8250 switch. The LMI messages will not show an increase after LMI looping is implemented.
Figure 1-2 Status Messages Halted between an MGX 8250 Switch and a BPX Switch
addlmiloop addfdrlp
MGX 8250
Card(s) on Which This Command Executes
PXM
Syntax
addlmiloop <
slot.port
Syntax Description
slot.port
Related Commands
dellmiloop, dsplmiloop
Attributes
BPX
>
Slot number, in the range 1–32
Port number, in the ran ge 1–256
38406
1-46
Log: No State: Active Privilege: Group 1
Example 1-16 Add an LMI loopback line numbered 1 to the current card (the PXM in slot 8)
spirit4.1.8.PXM.a > addlmiloop 1 spirit4.1.8.PXM.a >
Example 1-17 Add a feeder loop on the BPX
spirit4.1.8.PXM.a > addfdrlp 5.5 spirit4.1.8.PXM.a >
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Example 1-18 Display LMI loop
spirit4.1.8.PXM.a > dsplmiloop TRK IN LMI LOOP
-------------------
1.8 Yes
Example 1-19 Display LMI statistics for the BPX; number of LMI messages in the statistics does not
VPI.VCI: 3.31 Lmi enabled Lmi polling enabled Invalid Pdu Rx: 0 Status Polling Timer (T396) : 10 Invalid Pdu Len Rx: 14 Status Enquiry Timer (T393) : 10 Unknown Pdu Type Rx: 0 Max Status Enquiry Retry (N394): 5 Unknown IE Type Rx: 4 Update Status Timer (T394) : 10 Bad Transaction Rx: 0 Max Update Status Retry (N395) : 5 Status Rx: 46504 Spc Polling Timer : 2 Status Enq Tx: 46546 Spc Retry Timer : 0 Status Enq Rx: 92014 Spc Retry Counter : 1 Status Tx: 92014 Node Status Retry Timer : 0 Status Ack Rx: 185 Node Status Retry Counter : 0 Update Status Tx: 297 Node Status Polling Timer : 8 Update Status Rx: 203 Status Ack Tx: 203
addlmiloop
increase
VPI.VCI: 3.31 Lmi enabled Lmi polling enabled Invalid Pdu Rx: 0 Status Polling Timer (T396) : 10 Invalid Pdu Len Rx: 14 Status Enquiry Timer (T393) : 10 Unknown Pdu Type Rx: 0 Max Status Enquiry Retry (N394): 5 Unknown IE Type Rx: 4 Update Status Timer (T394) : 10 Bad Transaction Rx: 0 Max Update Status Retry (N395) : 5 Status Rx: 46511 Spc Polling Timer : 0 Status Enq Tx: 46553 Spc Retry Timer : 0 Status Enq Rx: 92028 Spc Retry Counter : 1 Status Tx: 92028 Node Status Retry Timer : 0 Status Ack Rx: 185 Node Status Retry Counter : 0 Update Status Tx: 297 Node Status Polling Timer : 9 Update Status Rx: 203 Status Ack Tx: 203
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-47
addln
addln
Add Line
Use the addln command to a ctivate an OC-1 2, O C-3 , T3, o r E3 line on the cu r ren t c ar d.
Card(s) on Which This Command Executes
PXM, FRSM-series, AUSM, SRM-3T3, CESM-series, VISM
Syntax: PXM
Chapter 1 MGX 8250 Command Line Interface
Syntax Description
addln -ds3 <
LineNum
>|-e3<
-ds3 Command delineator that precedes the T3
LineNum
DS3 line n umbe r in the format
slot = 7, 8, 15, 16, 31, or 32
line = 1–N, as appropriate for the physical installation
-e3 Comma nd delineator that prece des the E3
LineNum
E3 line n umb er f orm at
slot = 7, 8, 15, 16, 31, or 32
line = 1–N, as appropriate for the physical installation
LineNum
> | -sonet <
slot.line
slot.line
.
LineNum
.
>
LineNum
LineNum
-sonet Command delineator that precedes the SONET
LineNum
OC-3 or OC-12 line num be r in the format
slot = enter a value of 7. Enter 8 if the active PXM is in slot 8
line = 1–N, as appropriate for the physical installation
slot.line
entry.
entry.
LineNum
.
entry.
1-48
Set line number value a t
Note
You can only activate one PXM line on the feeder implementation of an MGX 8250 switch node. With an OC-1 2 t runk, the only active port with any MGX 8250 switch implementation is port 1.
Cisco MGX 8250 Multiservice Gateway Command Reference
7
if the line type is SONET.
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Syntax: FRSM, AUSM, SRM, CESM, VISM
addln <line_num>
Syntax Description
line_num Line number, in the range appropriate for the card.
FRSM
8T1 range = 1–8
HS1/B range = 1 –4
AUSM
8T1/8E1 range = 1–8
IMATM-T3T1/E3E1 range = 1–8
CESM, enter a value in t he range 1–8
addln
Related Commands
Attributes
cnfln, delln, dspln
Log: Yes State: Act ive Privilege : 1 (A ny o n PXM)
Example 1-20 Add a line numbered 1 to current card (the PXM in slot 8)
spirit4.1.8.PXM.a > addln 1 spirit4.1.8.PXM.a >
A message does not appear unless an error occurs. Possible errors include:
Parameters are illegal or invalid.
Line already exists.
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-49
addlnloop
addlnloop
Add Line Loop
Use the addlnloop command to set a specified line in loopback state on the current card.
Card(s) on Which This Command Executes
PXM, FRSM, AUSM, CESM
Syntax: PXM
Chapter 1 MGX 8250 Command Line Interface
Syntax Description
addlnloop -ds3 <
LineNum
>|-e3<
-ds3 Command delineator that precedes the T3
LineNum
DS3 line n umbe r in the format
slot = 7, 8, 15, 16, 31, or 32
line = 1–N, as appropriate for the physical installation
-e3 Command de line ator that precedes the E3
LineNum
E3 line n umb er f orm at
slot = 7, 8, 15, 16, 31, or 32
line = 1–N, as appropriate for the physical installation
LineNum
>|-sonet<
slot.line
slot.line
.
LineNum
.
>
LineNum
LineNum
-sonet Command delineator that precedes the SONET
LineNum
OC-3 or OC-12 line num be r in the format
slot = 7 or 8
line = 1–N, as appropriate for the physical installation
slot.line
entry.
entry.
LineNum
.
entry.
Syntax: FRSM, AUSM, CESM
addlnloop <
Cisco MGX 8250 Multiservice Gateway Command Reference
1-50
line_num
Set line number value a t 7 if the lin e typ e is S ON ET.
>
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Syntax Description
line_num Line number to be set in loopback sta te, in the range appropriate for the card.
Related Commands
dellnloop
FRSM
8T1 range = 1–8
HS1/B range = 1 –4
AUSM
8T1/8E1 range = 1–8
IMATM-T3T1/E3E1 range = 1–8
CESM, enter a value in t he range 1–8
addlnloop
Attributes
Log: Yes State: Active Privilege: Service (A ny on PXM)
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-51
addlns2aimgrp
addlns2aimgrp
Add Lines to an AIM Group
Use the addlns2aimgrp command to add lines to an existing AIMUX group.
Card(s) on Which This Command Executes
AUSM
Syntax
Chapter 1 MGX 8250 Command Line Interface
Syntax Description
Related Commands
Attributes
addlns2aimgrp <
grp_num
list_of_lines
grp_num><list_of_lines
>
Number of the AIMUX group on which li nes are to be added , in th e range 1 – 8 .
List of lines to be associated with this AIMUX group. Use dotted format to delineate each line in your entry s tr ing.
dellnsfmaimgrp
Log: Yes State: Act ive Privilege : Group 1
Example 1-21 Add lines 1 and 2 to IMA group 2
spirit4.1.18.AUSM.a > addlns2aimgrp 2 1. spirit4.1.18.AUSM.a >
1-52
A message does not appear unless an error occurs. Possible errors include:
IMA group is not enabled.
Line is not enabled.
Line is part of a different IM A group.
Tolerable differential delay is exceeded.
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
addport
Add Port
Use the addport command to add a service port to th e sh elf configuration.
Card(s) on Which This Command Executes
PXM, FRSM, CESM
Syntax: PXM OC-3
addport
addport <
Syntax Description
port_number
line_number
percent_bandwidth
min_vpi
max_vpi
Syntax: PXM OC-12 back cards
addport <
Syntax Description
port_number
port_number><line_number><percent_bandwidth><min_vpi><max_vpi
OC-3 port number to be added, in the range 1–32.
OC-3 line number. Enter the value 4.
Percentage o f bandw idt h to be al loc ated to the port, in the ra nge 1–100.
Virtual p ath i dent ifier (VPI ) value, in the range 0–4095.
VPI value, in the range 0–4095.
port_number><line_number><percent_bandwidth><min_vpi><max_vpi
OC-12 port n umb er to be a dd ed , in t he range 1–32.
>
>
line_number
percent_bandwidth
min_vpi
max_vpi
Release 1.0, Part Number 78-10897-01, July 2000
OC-12 line number. Enter the value 1.
Percentage of bandwidth to be allocated to the port, in the range 1–100.
Virtual path identifier (VPI) value, in the range 0–4095.
VPI value, in the ra nge 0–4095.
Cisco MGX 8250 Multiservice Gateway Command Reference
1-53
addport
Syntax: PXM T3/E3 back cards
addport <port_number><line_n umber ><percent_bandwidth><min_VP I><max_VPI>
Syntax Description
port_number Por t num be r, in the r ange 1–32.
line_number T3/E3 line number. Enter the value 2.
percent_bandwidth Percentage of ba ndwi dth t o b e allocated to the port, in the range 1–100.
min_VPI Virtual path identifier (VPI) value, in the range 0–4095.
max_VPI VPI value, i n th e range 0–4095.
Syntax: FRSM-8T1E1 cards
Chapter 1 MGX 8250 Command Line Interface
Syntax Description
addport <
port_num
line_num
ds0_speed
begin_slot
num_slot
port_type
port_num><line_num><ds0_speed><begin_slot><num_slot><port_type
Port number of either the FR SM-8T 1 o r the FRSM-8E1.
FRSM-8T1 range = 1–192
FRSM-8E1 range = 1–248
FRSM-8T1E1 line num ber, in the range 1–8.
Bit rate a s either 56 K bps or 64 Kbps for the DS0.
1 = 56 Kbps
2 = 64 Kbps
Number of the beginning timeslot in the T1 or E1 frame.
Number of consecutive timeslo t s in t he T1 or E1 frame.
Type of servic e as Fr ame Relay, FU NI, or frame forwarding.
1 = Frame Relay
2=FUNI
>
1-54
3=frameforwarding
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Syntax: FRSM-2T3E3 cards
addport <port_num><line_num ><ds0_speed><begin_slot><num_slot><port_type>
Syntax Description
port_num Port num ber on the FRSM -2 T3 or FRSM-2E3, in the range 1–2.
line_num FRSM-2T3E3 line num ber in the range 1–2.
ds0_speed Bit rate as either 56 Kbps or 64 Kbps for the DS0.
1 = 56 Kbps
2 = 64 Kbps
addport
Syntax: FRSM-2CT3
Syntax Description
begin_slot
num_slot
port_type
addport <
port_num
line_num
ds0_speed
Number of the beginning timeslot in the T1 or E1 frame.
Number of consecutive timeslo t s in t he T1 or E1 frame.
Type of servic e as Fr ame Relay, FU NI, or frame forwarding.
1 = Frame Relay
2=FUNI
3= frame forwarding
port_num><line_num><ds0_speed><begin_slot><num_slot><port_type
Port number on the FRSM-2C T3, in the range 1–256.
FRSM-2CT3 line num ber i n the range 1–56.
Bitrateaseither56Kbpsor64KbpsfortheDS0.
1=56Kbps
>
begin_slot
num_slot
port_type
Release 1.0, Part Number 78-10897-01, July 2000
2=64Kbps
Number of the beginning timeslot in the T1 or E1 frame.
Number of consecutive timeslots in the T1 or E1 frame.
Type of ser vi ce as Fra me Relay, FUNI, or frame f orward in g.
1 = Fram e Relay
2 = FUNI
3 = frame forwarding
Cisco MGX 8250 Multiservice Gateway Command Reference
1-55
addport
Syntax: FRSM-HS1/B
Syntax Description
Chapter 1 MGX 8250 Command Line Interface
addport <port_num><port_type >
port_num Port number, in the range appropriate for the interface type.
X.21 range = 1–4
HSSI range = 1–2
Syntax: FRSM-HS2
Syntax Description
port_type
addport <
port_num
line_num
ds0_speed
begin_slot
Type of servic e as Fr ame Relay, FU NI, or frame forwarding.
1 = Frame Relay
2=FUNI
3=frameforwarding
port_num><line_num><ds0_speed><begin_slot><num_slot><port_type
Port number on the FRSM-HS2, in the range 1–2.
FRSM-HS2 line number, in the range 1–2.
Bit rate a s either 56 K bps or 64 Kbps for the DS0.
1 = 56 Kbps
2 = 64 Kbps
Number of the beginning timeslot in the T1 or E1 frame.
>
1-56
num_slot
port_type
Cisco MGX 8250 Multiservice Gateway Command Reference
Number of consecutive timeslo t s in t he T1 or E1 frame.
Type of servic e as Fr ame Relay, FU NI, or frame forwarding.
1 = Frame Relay
2=FUNI
3=frameforwarding
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Syntax: CESM-8T1E1 cards
addport <port_num><line_num ><begin_slot><num_slot><port_type>
Syntax Description
port_num Port num ber on the CESM-8T1 or CESM-8E1 card.
CESM-8T1 range = 1–192
CESM-8E1 range = 1–248
addport
line_num
begin_slot
num_slot
port_type
Syntax: CESM-T3E3 cards
addport <
Syntax Description
port_num
line_num
CESM-8T1E1 line number, in the range 1–8.
Number of the beginning timeslot in the T1 or E1 frame.
Number of consecutive timeslo t s in t he T1 or E1 frame.
Type of service.
1=structured
2 = unstructured
3 = framing o n VC disconnect
port_num><line_num
Port number. Enter the value 1.
Line number. Enter the value 1 .
>
Related Commands
cnfport, delport, dspport, dspports
Attributes
Log: Yes State: Act ive Privilege : Group 1 (Any on PX M )
Example 1-22 Add port 1 on line 1 with DS0 timeslots 1 through 24 assigned as structured
node501.1.1.CESM.a > addport 1 1 1 24 1 node501.1.1.CESM.a >
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-57
addred
addred
Add Redundancy
Use the addred command to link two MGX 8250 slots (a pr ima ry slot and a secondary slot) so that the switch treats the cards in these slots as a redundant pair of cards.
The secondary sl ot should be in the sam e half o f the shelf (upp er or lower) as the primary slot. Redundancy can be 1:1 o r 1 :N. If the re dundan cy is 1:N, link o ne se conda ry slot toNprimary slots through multiple executions of this command.
Card(s) on Which This Command Executes
PXM
Syntax
addred <redPrimarySlotNum><redSecondarySlo tNum><redType>
Syntax Description
Chapter 1 MGX 8250 Command Line Interface
Related Commands
redPrimarySlotNum
redSecondarySlotNum
redType
Slot num ber that contains the primary car d of the car d pair, in the following ranges:
1–6
9–14
17–22
25–30
Slot number that contains the seco ndary card of the card pair, in the following ranges:
1–6
9–14
17–22
25–30
Type of redundancy to be d eployed on the PXM.
1=1:1
2=1:N
1-58
dspred, delred
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Attributes
Log: No State: Active Privilege: Any
Example 1-23 Add 1:1 redundancy between card in slot 4 and card in slot 1
node501.1.7.PXM.a > addred 1 4 1 node501.1.7.PXM.a >
A system response does not occur unless a system error is detected.
addred
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-59
addrscprtn
addrscprtn
Chapter 1 MGX 8250 Command Line Interface
Add Resource Partition
Use the addrscprtn command to configure resource par titions for the current PXM. A resource partition on a PXM consists of a percentage o f bandwidth,a VPI/VCI range, and the number
of global logical connection numbers (GLCNs) available to a n etwork control application.
Note
On a virtual trunk, the min_vpi and max_vpi should be the same . Only a routing node can support virtual trunking.
Card(s) on Which This Command Executes
PXM
Syntax
addrscprtn <
max_vci><max_chans
<
if_num><ctrlr_num><ingr_pct_bw><egr_pct_bw><min_vpi><max_vpi><min_vci
Syntax Description
if_num
ctrlr_num Type of network control application to be used on the logical interface.
ingr_pct_bw
>
Logical interface number, in the range 1– 32.
1=PAR
2 = PNNI
3=TAG
Percentage of ingress bandwidth to be allocated on the interface, in the range 0–100.
>
1-60
egr_pct_bw
min_vpi
max_vpi
min_vci
max_vci
max_chans
Cisco MGX 8250 Multiservice Gateway Command Reference
Percentage of egress bandwidth to b e allocated on the interface, in the range 0–100.
Minimum virtual path identifier (VPI) value, in the range 0–4095 .
Maximum VPI value, in th e range 0 –40 95.
Minimum virtual channel identifier (VCI ) value, in th e range 0–65535.
Maximum VCI value, in the rang e 0–65535.
Maximum global logical connection numbers (GLCNs), in t he range 0–32767.
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Related Commands
cnfrscprtn, delrscprtn, dspifrsc, dspifs, dsprscprtns, dsprscprtn, dsplnrsc
Attributes
Log: No State: Any Privilege: Any
addrscprtn
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-61
addserialif
addserialif
Add Serial Interface
Use the addserialif command to add a serial interface.
Card(s) on Which This Command Executes
PXM
Syntax
Chapter 1 MGX 8250 Command Line Interface
Syntax Description
Related Commands
Attributes
addserialif <
serial_port_num
serial_port_num
Serial port nu mber.
1 = console
2=slip
>
cnfserialif, dspserialif
Log: Yes State: Act ive Privilege : Any
Example 1-24 Configure speed on SLIP for 19200 bps
NODENAME.1.7.PXM.a > addserialif 1 NODENAME.1.7.PXM.a >
1-62
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
addtrapmgr
Add Trap Manager
Use the addtrapmgr command to set up an SNMP trap manager for use with stand-alone applications. Trap mana gers that are added using the addtrapmgr comma nd do not age, and are not deleted after 30 minutes.
Card(s) on Which This Command Executes
PXM
Syntax
addtrapmgr
Syntax Description
Related Commands
Attributes
addtrapmgr <
ip_addr
ip_addr><portnum>
A 32-bit IP address in dotted decimal format. This setting is the IP address assigned to the port on the trap ma nage r.
portnum
Port number on the trap manager workstation to be used to receive traps. Default = 162.
deltrapmgr, dsptrapmgr, xcnft rapmgr
Log: Yes State: Act ive Privilege : Any
Example 1-25 Add a trap manager with the IP address of 161.10.144.56 to port 162
node501.1.7.PXM.a > addtrapmgr 161.10.144.56 162 node501.1.7.PXM.a >
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-63
addtrk
addtrk
Chapter 1 MGX 8250 Command Line Interface
Add Trunk
Use the addtrk command to activate a s pecified trunk on th e current PXM. The addtrk command applies only to rout ing node im ple me ntatio n. Execute addtrk after you have
configured the b roadba nd interface as a t ru n k by using cnfifastrk.
Note
Traffic class a nd max vpc conids should match before exe cuting the addtrk command.
Card(s) on Which This Command Executes
PXM
Syntax
addtrk <slot.p o r t>
Syntax Description
slot.port
Port identifier of the trunk to activate, using the format
slot ranges:
1–6
9–14
17–22
25–30
port range = 1–N, as appropriate for the physical installation
slot.port
.
Related Commands
Attributes
Cisco MGX 8250 Multiservice Gateway Command Reference
1-64
cnftrk, dsptrkcnf, dsptrkload, dsptrks
Log: No State: Active Privilege: Group 1
Example 1-26 Activate trunk on port 4 in the card in slot 1
node501.1.7.PXM.a > addtrk 1.4 node501.1.7.PXM.a >
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
adduser
Add User
Use the adduser command to c on figure a user name and as sociate d a ccess lev el on the PXM.
Card(s) on Which This Command Executes
PXM
Syntax
adduser
Syntax Description
adduser <
user_ID
accessLevel
user_ ID><accessLevel
Name to be used as the login at the PXM.
The name can consist of up to 12 characte rs composed of alpha and numeric characters, special characters “_” and “-”.
The name must begin with an alpha character and cannot contain spaces. The name is case-sensitive.
System privilege level to be allocated for the user ID.
GROUP1 (highest level)
GROUP2
GROUP3
GROUP4
GROUP5
ANYUSER (lowest level)
The new user that you configure can not have an access l evel that is higher tha n that defined for the current login ID.
>
Related Commands
dspusers, deluser
Attributes
Log: Yes State: Act ive Privilege : Group 5
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-65
adduser
Chapter 1 MGX 8250 Command Line Interface
Example 1-27 Add a user named fin with privilege level ANYUSER
spirit.1.7.PXM.a > adduser fin ANYUSER
Enter password: Re-enter password:
spirit.1.7.PXM.a >
1-66
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
agetrapmgr
Age Trap Manager
Use the agetrapm gr command to activate or deactivate aging on trap managers.
Card(s) on Which This Command Executes
PXM
Syntax
agetrapmgr
Syntax Description
Related Commands
Attributes
agetrapmgr <
ip_addr
aging
dsptrapmgr
Log: No State: Any Privilege: Any
ip_addr><aging
IP address in d otted decimal format. Use ip_addr 0 .0 .0.1 for al l managers.
Aging of eithe r th e individual trap managers or all trap managers.
If enabled, the trap manager is deleted from the table after a period of 30 minutes.
>
1 = enabl e (default) 2 = disable
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-67
aimhelp
aimhelp
AIM Help
Use the aimhelp commandtodisplaytheHelpscreenfortheAUSMservicemodule.
Card(s) on Which This Command Executes
AUSM
Syntax
aimhelp
Related Commands
help
Attributes
Chapter 1 MGX 8250 Command Line Interface
Log: No State: Any Privilege: Any
1-68
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
Example 1-28 Display Help screen for AUSM service module
raviraj.1.9.AUSM8.a > aimhelp
AUSM-8P Commands
addcon : Add a Connection addimagrp : Add an IMA group addln : Add a line addlnloop : Configure a line in local loopback addlns2imagrp : Add lines to an existing IMA group clralmcnt : Clear DS1 alarm count clralmcnts : Clear alarm count for all DS1 lines clralm : Clear the DS1 line alarms clrchancnt : Clear Channel Counters clrchancnts : Clear Channel Counters for all channels clralms : Clear DS1 alarms on all lines clrimagrpcnt : Clear IMA group Counters clrimalncnt : Clear IMA counters on a particular line clrportcnt : Clear Port Counters clrportcnts : Clear Port Counters for all ports clrsarcnt : Clear SAR channel counters clrsarcnts : Clear SAR counters for all channels clrslftst : Clear self test results clrimatst : clear IMA test procedure
aimhelp
Type <CR> to continue, Q<CR> to stop:
cnfchanfst : Configure the channel foresight parameters cnfchanq : Configure the channel queue parameters cnffst : Configure foresight params of a card cnfportq : Configure Egress queue parameters cnfimagrp : Configure an IMA group cnfilmi : Configure ILMI parameters of a port cnfln : Configure DS1/E1 line cnflnloop : Configure DS1/E1 line cnfplpp : Configure DS1/E1 line cnfslftst : Configure self test parameters cnfsvcrange : Partition Resource between PVCs & SVCs cnfupccbr : Configure UPC parameters of CBR connection cnfupcvbr : Configure UPC parameters of VBR connection cnfupcabr : Configure UPC parameters of ABR connection cnfupcubr : Configure UPC parameters of UBR connection cnfimatst : Enable the IMA test procedure cnfimaalmparm : COnfigure the IMA alaram Integration UP and DOWN times copychans : Copy a template connection delimagrp : Delete an IMA group
Type <CR> to continue, Q<CR> to stop: delcon : Delete a connection delln : Delete DS1 line dellnloop : Remove a DS1 line from local loopback dellnsfmimagrp : Delete lines from an existing IMA group dnport : Down an ATM port dspalm : Display DS1 alarms on a line dspalmcnf : Display DS1 alarm configuration dspalmcnt : Display alarm count for DS1 line dspalms : Display DS1 alarms on all lines dspcd : Display card information dspchancnt : Display channel counters dspcon : Display connection configuration dspcons : Display all the configured connections dspfeature : Display the features dspfst : Display the card Foresight params
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-69
aimhelp
Chapter 1 MGX 8250 Command Line Interface
dspilmi : Display ILMI parms of a port dspilmicnt : Display ILMI counters of a port dspimagrp : Display all parms configured for an IMA group dspimagrpcnt : Display IMA group Counters
Type <CR> to continue, Q<CR> to stop:
dspimagrps : Display the configured IMA groups dspimalncnt : Display IMA counters on a particular line dspimatst : Display IMA test status dspimaln : Display IMA link status dspimaalmparm : Display IMA alaram integration times dspln : Display DS1 line dsplns : Display all DS1 lines dsploads : Display the total bandwidth used up in each port dspplpp : Display the PLPP configuration of each line dspport : Display the configured ATM/IMA port dspportcnt : Display Port Counters dspportq : Display the egress queue configuration dspportqs : Display configuration of all egress queues dspports : Display the configured ATM/IMA ports dspsarcnt : Display the SAR counters of a connection dspsarcnts : Display the SAR counters of all connections dspslftst : Display self test configuration dspslftsttbl : Display the self test results dspsttatparms : Display the statistics params configured
Type <CR> to continue, Q<CR> to stop:
dspsvcrange : Display the resource partition between PVCs & SVCs dsptotals : Display the total connections configured per port runslftstno : Run a particular self test tstcon : Test the connection towards the N/W side tstconseg : Test the connection towards the CPE side tstconsti : Test the connection towards the N/W side using STI supervis ory cell tstdelay : Measure the delay towards the N/W side tstdelaysti : Measure the delay towards the N/W side using STI supervisor y cell upport : Up an ATM port xcnfalm : Configure alms of a DS1 line xcnfln : Configure a DS1 line xcnfln : Configure a DS1 line
raviraj.1.9.AUSM8.a >
1-70
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
arpAdd
Add Address Resolution Protocol Entry
Use the arpAdd command to a dd an Address Resolution Protocol (ARP) entry to the ARP table. This Internet protocol is used to map an IP address to a MAC address, and the ARP table contains these translations.
Card(s) on Which This Command Executes
PXM
Syntax
arpAdd <ip_address> <mac_address>
Syntax Description
arpAdd
Related Commands
Attributes
ip_address
mac_address
IP address in d otted decimal format.
Standardized d ata lin k la yer add re ss , si x bytes long . A lso k nown as a hardwar e address, MAC-layer address, and physical address.
arpShow, arpDelete, arpFlush
Log: No State: Any Privilege: Any
Example 1-29 Add an ARP entry on current PXM, then show ARP entry
NODENAME.1.7.PXM.a > arpAdd 172.29.36.102 0:e0:4f:5c:6c:5a
NODENAME.1.7.PXM.a > arpShow
172.29.36.28 at 8:0:20:a6:80:3b
190.29.36.255 at 0:e0:4f:5c:6c:20
172.29.36.102 at 0:e0:4f:5c:6c:5a
171.71.54.104 at 0:e0:4f:5c:6c:20 NODENAME.1.7.PXM.a >
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-71
arpDelete
arpDelete
Delete Address Resolution Protocol Entry
Use the arpDelete command to delete an entry in the Address Resolution Protocol (ARP) table. The ARP protocol is used to map an IP address to a MAC address, and the ARP table contains these translations.
Card(s) on Which This Command Executes
PXM
Syntax
arpDelete <ip_addr >
Syntax Description
Chapter 1 MGX 8250 Command Line Interface
Related Commands
Attributes
ip_addr
IP address in dotted decimal format.
arpAdd, arpShow, arpFlush
Log: No State: Any Privilege: Any
Example 1-30 Delete ARP entry for IP address 172.29.36.102
NODENAME.1.7.PXM.a> arpDelete 172.29.36.102
172.29.36.102 (172.29.36.102) deleted NODENAME.1.7.PXM.a>
1-72
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
arpFlush
Flush Address Resolution Protocol Table
Use the arpFlush command to remove non-permanent entries from the ARP table. The ARP protocol is used to map an IP address to a MAC address, and the ARP table contains these t ranslations.
Card(s) on Which This Command Executes
PXM
Syntax
arpFlush
Related Commands
arpAdd, arpDelete, a rpShow
Attributes
arpFlush
Log: No State: Any Privilege: Any
Example 1-31 Flush ARP table, then show ARP table
NODENAME.1.7.PXM.a > arpFlush
NODENAME.1.7.PXM.a > arpShow
171.71.54.104 at 0:e0:4f:5c:6c:20 NODENAME.1.7.PXM.a >
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-73
arpShow
arpShow
Show Address Resolution Protocol Table
Use the arpShow command to display the Address Resolution Protocol (ARP) table. The A RP table contains IP address–to–MAC ad dre ss translations mapped by the ARP protocol.
Card(s) on Which This Command Executes
PXM
Syntax
arpShow
Related Commands
arpAdd, arpDelete, arpFlush
Attributes
Chapter 1 MGX 8250 Command Line Interface
Log: No State: Any Privilege: Any
Example 1-32 Show ARP table on current PXM
NODENAME.1.7.PXM.a > arpShow
190.29.36.255 at 0:e0:4f:5c:6c:20
172.29.36.28 at 8:0:20:a6:80:3b
171.71.54.104 at 0:e0:4f:5c:6c:20 NODENAME.1.7.PXM.a >
1-74
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
bootChange
Boot Change
Use the bootChange co mmand to ch an ge to the boot I P address and gateway address of a P XM card. The IP address you de fine is used only when the PXM is in boot state. Use the cnfifip command to assign IP addresses for the PXM and the shelf. The bootChange values are sent and automatically updated on the standby card, and bootlines are synchro niz e d.
The PXM trie s to corr ect bad e ntr ies when i t boots up. This informat ion is copied to the st andby c ard. If the bootChange IP address is different from the shelf IP address, then it brings the Ethernet interface up on the standby wit h the bootChange IP addr ess.
The shellconn version of th is command updates only the local bootline valu es . The following parameters are necessary for the network to function:
Ethernet interface
IP address and subnetmask
DefaultEthernetgateway
bootChange
Note
If the firmware fails to reach the CLI prompt or come s up in b acku p boot, the Etherne t interface might be down, a problem created by an identical shelf IP address and boot change address. In such a case, the boo tChange command is used from the shell to set another IP addre ss an d then usrEnetEnable is called to activate that address.
If the CLI prompt does not display or if the switch is not enab led and in ba ckup boot , use the usrEnetEnable command to bring up the Ether net interface.
Card(s) on Which This Command Executes
PXM
Syntax
bootChange
Related Commands
cnfifip
Attributes
Log: Yes State: Active Privilege: Servic e
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-75
bootChange
Chapter 1 MGX 8250 Command Line Interface
Example 1-33 Execute bootChange on current PXM
raviraj.1.7.PXM.a > bootChange
'.' = clear field; '-' = go to previous field; ^D = quit
boot device : lnPci processor number : 0 host name : file name : inet on ethernet (e) : 172.29.37.41 : ffffff00 inet on backplane (b): host inet (h) : gateway inet (g) : 172.29.37.1 user (u) : ftp password (pw) (blank = use rsh): flags (f) : 0x0 target name (tn) : startup script (s) : other (o) :
raviraj.1.7.PXM.a >
1-76
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Chapter 1 MGX 8250 Command Line Interface
bye
Bye
Use the bye command to exit the current CLI shell.
Card(s) on Which This Command Executes
PXM, FRSM, AUSM, VISM
Syntax
bye
Related Commands
logout
Attributes
bye
Log: Yes State: Any Privilege: Any
Example 1-34 Exit current CLI shell
spirit.1.8.PXM.a > bye
(session ended)
Release 1.0, Part Number 78-10897-01, July 2000
Cisco MGX 8250 Multiservice Gateway Command Reference
1-77
cc
cc
Change Card
Use the cc commandtonavigatefromcardtocardontheshelf.
Card(s) on Which This Command Executes
PXM, FRSM, AUSM, CESM, V ISM
Syntax
slotNumber
cc <
Syntax Description
>
Chapter 1 MGX 8250 Command Line Interface
Related Commands
Attributes
slotNumber
Number of the card slot, in the range 1–32.
None
Log: Yes State: Any Privilege: Any
Example1-35 SwitchfromAUSMinslot22toPXMinslot8
node1.1.22.AUSM8.a > cc 8
(session redirected)
node1.1.8.PXM.a >
A syste m message does not occur unless a n error is detected. If the card slot is empty, an e rror message is presented.
1-78
Cisco MGX 8250 Multiservice Gateway Command Reference
Release 1.0, Part Number 78-10897-01, July 2000
Loading...