BSR 64000 Command Reference Guide

Compass ID: 271820115 Version 3 Release 5.0.0

Notice
Copyright © 2008 Motorola, Inc. All rights reserved No part of this publication my be reproduced in any form or by any means or used to make any derivative work (such as translation, transformation or adaptation) without written permission from Motorola, Inc. Motorola reserves the right to revise this publication and to make changes in content from time to time without obligation on the part of Motorola to provide notification of such revision or change. Motorola provides this guide without warranty of any kind, either implied or expressed, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Motorola may make improvements or changes in the product(s) described in this manual at any time. Motorola and the stylized M logo are registered trademarks of Motorola, Inc. Broadband Services Router, BSR, BSR 64000, RiverDelta, and SmartFlow are trademarks of Motorola, Inc. All other trademarks and registered trademarks are the property of their respective owners.

Caring for the Environment by Recycling When you see this symbol on a Motorola product, do not dispose of the product with residential or commercial waste. Recycling your Motorola Equipment Please do not dispose of this product with your residential or commercial waste. Some countries or regions, such as the European Union, have set up systems to collect and recycle electrical and electronic waste items. Contact your local authorities for information about practices established for your region. If collection systems are not available, call Motorola Customer Service for assistance.

Compass ID: 271820115 Version 3 Release 5.0.0 Published: 9/08

Contents

Preface
Scope ............................................................................................................................................xli Audience.......................................................................................................................................xli Documentation Set .......................................................................................................................xli Conventions................................................................................................................................xliii Notes, Cautions, Warnings .........................................................................................................xliv If You Need Help......................................................................................................................... xlv

1

System Administration Commands
Introduction .................................................................................................................................1-1 System Administration Command Descriptions .........................................................................1-2 aaa accounting commands default....................................................................................1-3 aaa accounting exec default..............................................................................................1-5 aaa authentication enable default......................................................................................1-7 aaa authentication fail-message........................................................................................1-8 aaa authentication local-override......................................................................................1-9 aaa authentication login default......................................................................................1-10 aaa authorization commands default ..............................................................................1-11 aaa authorization exec default ........................................................................................1-13 aaa console authentication ..............................................................................................1-14 aaa console authorization commands default .................................................................1-15 aaa new-model................................................................................................................1-16 alias.................................................................................................................................1-17 banner motd ....................................................................................................................1-18

Compass ID: 271820115 Version 3

iii

BSR 64000 Command Reference Guide

Release 5.0.0

batch ...............................................................................................................................1-19 boot system .....................................................................................................................1-20 broadcast.........................................................................................................................1-21 carriage-return-lf-mode ..................................................................................................1-22 chassis alias ....................................................................................................................1-23 chassis assetid.................................................................................................................1-24 chkdsk.............................................................................................................................1-25 clear core log ..................................................................................................................1-26 clear evt ..........................................................................................................................1-27 clear log ..........................................................................................................................1-29 clear redundancy stats.....................................................................................................1-30 clock set ..........................................................................................................................1-31 clock summer-time .........................................................................................................1-32 clock timezone................................................................................................................1-34 configure.........................................................................................................................1-36 console authentication radius .........................................................................................1-37 copy ................................................................................................................................1-38 copy core ........................................................................................................................1-40 core .................................................................................................................................1-41 datapath keepalive ..........................................................................................................1-42 delete...............................................................................................................................1-43 description ......................................................................................................................1-44 dir....................................................................................................................................1-45 disable.............................................................................................................................1-46 duplex .............................................................................................................................1-47 enable..............................................................................................................................1-48 enable authentication radius ...........................................................................................1-49 enable password..............................................................................................................1-50 enable rdn-process ..........................................................................................................1-51 enable secret ...................................................................................................................1-52 encapsulation snap..........................................................................................................1-53 erase................................................................................................................................1-54 exception.........................................................................................................................1-55 exit ..................................................................................................................................1-56

iv

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

forced-download.............................................................................................................1-57 format .............................................................................................................................1-58 help .................................................................................................................................1-59 history size......................................................................................................................1-60 hostname.........................................................................................................................1-61 hsim4 slot........................................................................................................................1-62 icp keepalive ...................................................................................................................1-63 ip ftp password ...............................................................................................................1-65 ip ftp username ...............................................................................................................1-66 ip netmask-format...........................................................................................................1-67 ip tacacs source-interface ...............................................................................................1-68 ip tftp source-interface loopback ....................................................................................1-69 ldap client .......................................................................................................................1-70 ldap search-base..............................................................................................................1-71 ldap server ......................................................................................................................1-72 load-interval....................................................................................................................1-73 logging ............................................................................................................................1-75 logging admin-status ......................................................................................................1-76 logging buffered .............................................................................................................1-78 logging console...............................................................................................................1-80 logging control docsis.....................................................................................................1-82 logging default................................................................................................................1-83 logging disable bpi_auth_invalid_messages ..................................................................1-84 logging disable bpi_auth_reject_messages.....................................................................1-85 logging disable bpi_map_reject_messages.....................................................................1-86 logging disable bpi_tek_invalid_messages ....................................................................1-87 logging disable cm_ranging_fail_r103_0.......................................................................1-88 logging evt clear .............................................................................................................1-89 logging evt set.................................................................................................................1-90 logging facility................................................................................................................1-91 logging on .......................................................................................................................1-92 logging rate-limit ............................................................................................................1-93 logging reporting ............................................................................................................1-94 logging reporting default ................................................................................................1-97

Compass ID: 271820115 Version 3

v

BSR 64000 Command Reference Guide

Release 5.0.0

logging session ...............................................................................................................1-98 logging snmp-trap...........................................................................................................1-99 logging source-interface loopback ...............................................................................1-101 logging trap...................................................................................................................1-102 login..............................................................................................................................1-104 logout............................................................................................................................1-105 macro ............................................................................................................................1-106 memory checkzero........................................................................................................1-107 message.........................................................................................................................1-108 network-clock-select.....................................................................................................1-109 network-clock-select revertive ..................................................................................... 1-111 more..............................................................................................................................1-112 page...............................................................................................................................1-114 password .......................................................................................................................1-115 privilege restricted ........................................................................................................1-116 radius-server .................................................................................................................1-117 radius-server source-interface loopback.......................................................................1-119 redundancy cmts...........................................................................................................1-120 redundancy force-switchover cmts...............................................................................1-122 redundancy force-switchover srm ................................................................................1-124 reload ............................................................................................................................1-125 reload switched .............................................................................................................1-126 repeat ............................................................................................................................1-130 reset...............................................................................................................................1-131 service password-encryption ........................................................................................1-132 session-timeout .............................................................................................................1-133 session-window set .......................................................................................................1-134 set bandwidth-factor .....................................................................................................1-135 set stats poll ..................................................................................................................1-136 show aliases ..................................................................................................................1-138 show boot......................................................................................................................1-140 show chassis alias .........................................................................................................1-141 show chassis assetid .....................................................................................................1-142 show chassis serial-num ...............................................................................................1-143

vi

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

show chassis status .......................................................................................................1-144 show clock ....................................................................................................................1-148 show core log................................................................................................................1-149 show evt........................................................................................................................1-150 show forced-download .................................................................................................1-154 show history..................................................................................................................1-156 show keepalive .............................................................................................................1-158 show log........................................................................................................................1-160 show logging evt...........................................................................................................1-162 show logging reporting.................................................................................................1-163 show logging syslog .....................................................................................................1-166 show macro...................................................................................................................1-167 show memory ...............................................................................................................1-168 show network-clocks ....................................................................................................1-171 show pool......................................................................................................................1-172 show process.................................................................................................................1-174 show process cpu..........................................................................................................1-176 show process memory ..................................................................................................1-180 show process msg-q-info..............................................................................................1-183 show process semaphores.............................................................................................1-184 show process stack .......................................................................................................1-186 show redundancy cmts .................................................................................................1-188 show redundancy srm ...................................................................................................1-192 show reload...................................................................................................................1-194 show running-config.....................................................................................................1-195 show srm alias ..............................................................................................................1-197 show srm assetid...........................................................................................................1-198 show srm serial-num.....................................................................................................1-199 show startup-config ......................................................................................................1-200 show stats fastpath........................................................................................................1-202 show stats summary error .............................................................................................1-204 show stats xfabric .........................................................................................................1-205 show system..................................................................................................................1-206 show system alarms......................................................................................................1-210

Compass ID: 271820115 Version 3

vii

BSR 64000 Command Reference Guide

Release 5.0.0

show system fans..........................................................................................................1-213 show tacacs...................................................................................................................1-215 show tacacs statistics ....................................................................................................1-216 show tech ......................................................................................................................1-217 show update ..................................................................................................................1-220 show user-group ...........................................................................................................1-221 show users ....................................................................................................................1-223 show vectron slot..........................................................................................................1-225 show version .................................................................................................................1-227 show xfabric .................................................................................................................1-230 slot ................................................................................................................................1-232 speed .............................................................................................................................1-233 srm alias........................................................................................................................1-234 srm assetid ....................................................................................................................1-235 sync file ........................................................................................................................1-237 tacacs reset-connections ...............................................................................................1-238 tacacs-server host..........................................................................................................1-239 tacacs-server key ..........................................................................................................1-241 tacacs-server port..........................................................................................................1-242 tacacs-server retry.........................................................................................................1-243 tacacs-server timeout ....................................................................................................1-244 telnet .............................................................................................................................1-245 telnet authentication radius...........................................................................................1-246 telnet session-limit........................................................................................................1-247 update bypass................................................................................................................1-248 update chassis ...............................................................................................................1-249 update slot.....................................................................................................................1-250 username.......................................................................................................................1-251 username privilege........................................................................................................1-253 username user-group ....................................................................................................1-254 xfabric keepalive ..........................................................................................................1-255

viii

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

2

IP Commands
Introduction .................................................................................................................................2-1 IP Command Descriptions ..........................................................................................................2-2 arp .....................................................................................................................................2-3 arp timeout........................................................................................................................2-5 cable helper-address .........................................................................................................2-6 clear arp-cache..................................................................................................................2-8 clear counters....................................................................................................................2-9 clear host.........................................................................................................................2-10 clear ip route ...................................................................................................................2-11 clear ip traffic .................................................................................................................2-12 clear sntp history.............................................................................................................2-13 host authorization ...........................................................................................................2-14 interface ..........................................................................................................................2-16 ip access-group ...............................................................................................................2-18 ip address ........................................................................................................................2-19 ip broadcast-address .......................................................................................................2-23 ip dhcp relay information ...............................................................................................2-24 ip domain-list..................................................................................................................2-26 ip domain-lookup............................................................................................................2-27 ip domain-name ..............................................................................................................2-28 ip forward-protocol udp..................................................................................................2-29 ip forwarding ..................................................................................................................2-30 ip helper-address.............................................................................................................2-31 ip host .............................................................................................................................2-32 ip irdp..............................................................................................................................2-33 ip mask-reply ..................................................................................................................2-35 ip mtu..............................................................................................................................2-36 ip multicast fastpath........................................................................................................2-37 ip name-server ................................................................................................................2-39 ip proxy-arp ....................................................................................................................2-40 ip rarp-server ..................................................................................................................2-41 ip redirects ......................................................................................................................2-42 ip route............................................................................................................................2-43

Compass ID: 271820115 Version 3

ix

BSR 64000 Command Reference Guide

Release 5.0.0

ip routing ........................................................................................................................2-44 ip source-route ................................................................................................................2-45 ip unreachables ...............................................................................................................2-46 passive-interface .............................................................................................................2-47 ping .................................................................................................................................2-49 show arp..........................................................................................................................2-51 show controllers..............................................................................................................2-53 show host authorization ..................................................................................................2-55 show host authorization cpe ...........................................................................................2-56 show host authorization interface cable .........................................................................2-58 show host authorization summary ..................................................................................2-60 show host unauthorized cpe............................................................................................2-62 show hosts ......................................................................................................................2-63 show interfaces ...............................................................................................................2-64 show ip arp .....................................................................................................................2-66 show ip dhcp stats...........................................................................................................2-69 show ip filters .................................................................................................................2-70 show ip filters summary .................................................................................................2-74 show ip flows..................................................................................................................2-77 show ip forwarding-table................................................................................................2-79 show ip interface.............................................................................................................2-81 show ip irdp ....................................................................................................................2-84 show ip multicast fastpath ..............................................................................................2-86 show ip multicast fwd-cache ..........................................................................................2-87 show ip protocols............................................................................................................2-89 show ip route ..................................................................................................................2-91 show ip traffic.................................................................................................................2-94 show l2-cam....................................................................................................................2-98 show sntp ......................................................................................................................2-101 show tcp brief ...............................................................................................................2-102 show tcp statistics .........................................................................................................2-103 shutdown.......................................................................................................................2-107 sntp authenticate ...........................................................................................................2-108 sntp authentication-key.................................................................................................2-109

x

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

sntp broadcastdelay ......................................................................................................2-110 sntp broadcast client ..................................................................................................... 2-111 sntp disable ...................................................................................................................2-112 sntp response timeout ...................................................................................................2-113 sntp server.....................................................................................................................2-114 sntp source-interface loopback .....................................................................................2-116 sntp timer ......................................................................................................................2-117 sntp trusted-key ............................................................................................................2-118 traceroute ......................................................................................................................2-119 trap-enable-if ................................................................................................................2-121 trap-enable-rdn .............................................................................................................2-122 tunnel destination..........................................................................................................2-123 tunnel mode ..................................................................................................................2-124 tunnel source.................................................................................................................2-125 unresolved-ip-packet-throttle .......................................................................................2-126

3

SNMP Commands
Introduction .................................................................................................................................3-1 SNMP Command Descriptions ...................................................................................................3-2 show snmp ........................................................................................................................3-3 snmp-server access ...........................................................................................................3-9 snmp-server chassis-id....................................................................................................3-11 snmp-server community .................................................................................................3-12 snmp-server community-table ........................................................................................3-13 snmp-server contact........................................................................................................3-16 snmp-server context........................................................................................................3-17 snmp-server convert .......................................................................................................3-18 snmp-server docs-trap-control........................................................................................3-19 snmp-server enable informs ...........................................................................................3-21 snmp-server enable traps ................................................................................................3-22 snmp-server engineID ....................................................................................................3-24 snmp-server group ..........................................................................................................3-25 snmp-server host.............................................................................................................3-26 snmp-server location ......................................................................................................3-29

Compass ID: 271820115 Version 3

xi

BSR 64000 Command Reference Guide

Release 5.0.0

snmp-server manager response-timeout .........................................................................3-30 snmp-server notify..........................................................................................................3-31 snmp-server notify-filter.................................................................................................3-33 snmp-server notify-filter-profile.....................................................................................3-35 snmp-server packetsize...................................................................................................3-37 snmp-server port number................................................................................................3-38 snmp-server shutdown....................................................................................................3-39 snmp-server sysname......................................................................................................3-40 snmp-server target-addr ..................................................................................................3-41 snmp-server target-params .............................................................................................3-44 snmp-server trap rate-limit .............................................................................................3-47 snmp-server trap-source loopback..................................................................................3-48 snmp-server user.............................................................................................................3-49 snmp-server view............................................................................................................3-51

4

Debug Commands
Introduction .................................................................................................................................4-1 Debug Command Descriptions ...................................................................................................4-1 debug aps ..........................................................................................................................4-2 debug arp ..........................................................................................................................4-3 debug cable err .................................................................................................................4-4 debug cable keyman .........................................................................................................4-5 debug cable mac ...............................................................................................................4-6 debug cable map ...............................................................................................................4-7 debug cable modem-select ...............................................................................................4-8 debug cable privacy ..........................................................................................................4-9 debug cable qos ..............................................................................................................4-10 debug cable range ...........................................................................................................4-11 debug cable reg...............................................................................................................4-12 debug cable remote-query ..............................................................................................4-13 debug cable ucc ..............................................................................................................4-14 debug ip access-list.........................................................................................................4-15 debug ip bgp ...................................................................................................................4-16 debug ip dvmrp...............................................................................................................4-18

xii

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

debug ip icmp .................................................................................................................4-19 debug ip igmp .................................................................................................................4-20 debug ip mfm..................................................................................................................4-21 debug ip mrtm.................................................................................................................4-22 debug ip ospf ..................................................................................................................4-23 debug ip packet...............................................................................................................4-25 debug ip pim ...................................................................................................................4-27 debug ip policy ...............................................................................................................4-29 debug ip redistribute to ...................................................................................................4-30 debug ip rip.....................................................................................................................4-32 debug ip rip database ......................................................................................................4-33 debug ip rip events..........................................................................................................4-34 debug ip rip trigger .........................................................................................................4-35 debug ip tcp transactions ................................................................................................4-36 debug ip udp ...................................................................................................................4-37 debug ip vrrp...................................................................................................................4-38 debug ipsec .....................................................................................................................4-39 debug mpls forwarding...................................................................................................4-41 debug mpls rsvp..............................................................................................................4-42 debug packet-cable .........................................................................................................4-44 debug ppp fsm ................................................................................................................4-45 debug ppp packet............................................................................................................4-46 debug radius....................................................................................................................4-47 debug snmp.....................................................................................................................4-48 debug sntp.......................................................................................................................4-49 debug specmgr................................................................................................................4-50 debug ssh ........................................................................................................................4-51 debug tacacs....................................................................................................................4-52 debug tacacs events ........................................................................................................4-53 debug task monitor .........................................................................................................4-54 debug tunnel ...................................................................................................................4-58 show debugging..............................................................................................................4-59 undebug all .....................................................................................................................4-60

Compass ID: 271820115 Version 3

xiii

BSR 64000 Command Reference Guide

Release 5.0.0

5

Access List Commands
Introduction .................................................................................................................................5-1 Access List Command Descriptions ...........................................................................................5-1 access-class in...................................................................................................................5-2 access-list (standard) ........................................................................................................5-3 access-list (extended)........................................................................................................5-4 ip access-group ...............................................................................................................5-11 ip access-list....................................................................................................................5-12 show access-lists.............................................................................................................5-13

6

Routing Policy Commands
Introduction .................................................................................................................................6-1 Routing Policy Command Descriptions......................................................................................6-1 default-information originate............................................................................................6-2 default-metric ...................................................................................................................6-4 ip local policy route-map..................................................................................................6-5 ip policy route-map...........................................................................................................6-6 match as-path....................................................................................................................6-7 match community .............................................................................................................6-8 match ip address ...............................................................................................................6-9 match ip next-hop ...........................................................................................................6-10 match ip route-source .....................................................................................................6-11 match metric ...................................................................................................................6-12 match route-type external ...............................................................................................6-13 match route-type internal................................................................................................6-14 match tag ........................................................................................................................6-15 route-map........................................................................................................................6-16 set as-path prepend .........................................................................................................6-18 set automatic-tag.............................................................................................................6-19 set comm-list ..................................................................................................................6-20 set community ................................................................................................................6-22 set default interface.........................................................................................................6-24 set interface.....................................................................................................................6-25 set ip default next-hop ....................................................................................................6-26

xiv

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

set ip diff-serv.................................................................................................................6-27 set ip next-hop ................................................................................................................6-29 set ip qos queue ..............................................................................................................6-30 set local-preference.........................................................................................................6-31 set metric ........................................................................................................................6-32 set metric-type ................................................................................................................6-33 set origin .........................................................................................................................6-34 set tag..............................................................................................................................6-35 set weight........................................................................................................................6-36 show ip redistribute ........................................................................................................6-37 show ip traffic.................................................................................................................6-39 show route-map ..............................................................................................................6-40

7

RIP Commands
Introduction .................................................................................................................................7-1 RIP Command Descriptions........................................................................................................7-1 auto-summary ...................................................................................................................7-2 clear ip rip statistics ..........................................................................................................7-3 default-information originate............................................................................................7-4 default-metric ...................................................................................................................7-5 distance .............................................................................................................................7-6 distribute-list in.................................................................................................................7-7 distribute-list out...............................................................................................................7-8 graceful-restart-period ......................................................................................................7-9 ip rip authentication key .................................................................................................7-10 ip rip host-routes.............................................................................................................7-11 ip rip message-digest-key md5 .......................................................................................7-12 ip rip receive version ......................................................................................................7-13 ip rip send version ..........................................................................................................7-14 ip split-horizon................................................................................................................7-15 maximum-paths ..............................................................................................................7-16 network ...........................................................................................................................7-17 offset-list.........................................................................................................................7-18 output-delay ....................................................................................................................7-20

Compass ID: 271820115 Version 3

xv

BSR 64000 Command Reference Guide

Release 5.0.0

passive-interface .............................................................................................................7-21 redistribute......................................................................................................................7-22 router rip .........................................................................................................................7-24 show ip rip database .......................................................................................................7-25 source-port 520 ...............................................................................................................7-27 timers basic .....................................................................................................................7-28 version ............................................................................................................................7-30

8

OSPF Commands
Introduction .................................................................................................................................8-1 OSPF Command Descriptions ....................................................................................................8-1 area authentication............................................................................................................8-2 area default-cost................................................................................................................8-3 area nssa............................................................................................................................8-4 area range..........................................................................................................................8-5 area stub............................................................................................................................8-6 area virtual-link ................................................................................................................8-7 auto-cost reference-bandwidth .........................................................................................8-9 auto-virtual-link ..............................................................................................................8-10 clear ip ospf ....................................................................................................................8-11 default-information originate..........................................................................................8-12 default-metric .................................................................................................................8-13 distance ...........................................................................................................................8-14 distance ospf ...................................................................................................................8-15 distribute-list...................................................................................................................8-17 graceful-restart................................................................................................................8-18 helper-mode ....................................................................................................................8-19 ip ospf authentication-key ..............................................................................................8-21 ip ospf cost......................................................................................................................8-22 ip ospf database-filter all out ..........................................................................................8-23 ip ospf dead-interval .......................................................................................................8-24 ip ospf hello-interval.......................................................................................................8-25 ip ospf message-digest-key.............................................................................................8-26 ip ospf network ...............................................................................................................8-27

xvi

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

ip ospf priority ................................................................................................................8-28 ip ospf retransmit-interval ..............................................................................................8-29 ip ospf transmit-delay .....................................................................................................8-30 maximum-paths ..............................................................................................................8-31 moto-nsf..........................................................................................................................8-32 network area ...................................................................................................................8-34 passive-interface .............................................................................................................8-35 redistribute......................................................................................................................8-36 rfc1583-compatible.........................................................................................................8-38 router-id ..........................................................................................................................8-39 router ospf.......................................................................................................................8-40 show ip ospf....................................................................................................................8-41 show ip ospf border-routers............................................................................................8-43 show ip ospf database.....................................................................................................8-44 show ip ospf interface.....................................................................................................8-47 show ip ospf memory .....................................................................................................8-49 show ip ospf neighbor ....................................................................................................8-51 show ip ospf network......................................................................................................8-53 show ip ospf virtual-links ...............................................................................................8-54 summary-address............................................................................................................8-55 timers spf ........................................................................................................................8-56

9

IGMP Commands
Introduction .................................................................................................................................9-1 IGMP Command Descriptions ....................................................................................................9-2 clear ip igmp counters ......................................................................................................9-3 ip igmp access-group ........................................................................................................9-4 ip igmp querier-timeout ....................................................................................................9-5 ip igmp query-interval ......................................................................................................9-6 ip igmp last-member-query-count ....................................................................................9-7 ip igmp last-member-query-interval.................................................................................9-8 ip igmp query-max-response-time....................................................................................9-9 ip igmp static-group........................................................................................................9-10 ip igmp version ...............................................................................................................9-11

Compass ID: 271820115 Version 3

xvii

BSR 64000 Command Reference Guide

Release 5.0.0

ip igmp version1-querier ................................................................................................9-12 show ip igmp groups ......................................................................................................9-13 show ip igmp interface ...................................................................................................9-15 show ip igmp statistics....................................................................................................9-17

10

VRRP Commands
Introduction ...............................................................................................................................10-1 VRRP Command Descriptions..................................................................................................10-1 clear ip vrrp.....................................................................................................................10-2 ip vrrp .............................................................................................................................10-3 ip vrrp (virtual router ID) ...............................................................................................10-4 ip vrrp address ................................................................................................................10-5 ip vrrp authentication key ...............................................................................................10-6 ip vrrp authentication type..............................................................................................10-7 ip vrrp enable..................................................................................................................10-8 ip vrrp preempt ...............................................................................................................10-9 ip vrrp priority ..............................................................................................................10-10 ip vrrp primary-ip .........................................................................................................10-11 ip vrrp timer ..................................................................................................................10-12 ip vrrp verify-availability .............................................................................................10-13 show ip vrrp ..................................................................................................................10-14

11

IP Multicast Commands
Introduction ...............................................................................................................................11-1 MRTM Command Descriptions ................................................................................................11-1 ip mroute.........................................................................................................................11-2 ip mroute static distance .................................................................................................11-3 ip mroute unicast distance ..............................................................................................11-4 ip multicast-routing ........................................................................................................11-5 show ip rpf......................................................................................................................11-6 MFM Command Descriptions...................................................................................................11-7 clear ip multicast fwd-cache...........................................................................................11-8 clear ip multicast proto-cache.........................................................................................11-9 mtrace ...........................................................................................................................11-10

xviii

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

show ip multicast cache-summary................................................................................ 11-11 show ip multicast fwd-cache ........................................................................................11-12 show ip multicast interface ...........................................................................................11-13 show ip multicast oi-fwd-cache....................................................................................11-14 show ip multicast no-oi-fwd-cache ..............................................................................11-15 show ip multicast proto-cache ......................................................................................11-16

12

DVMRP Commands
Introduction ...............................................................................................................................12-1 DVMRP Command Descriptions..............................................................................................12-1 ip dvmrp accept-filter .....................................................................................................12-2 ip dvmrp default-information originate ..........................................................................12-3 ip dvmrp metric-offset ....................................................................................................12-4 ip dvmrp output-report-delay .........................................................................................12-5 ip dvmrp out-report-filter ...............................................................................................12-6 ip dvmrp probe-interval ..................................................................................................12-7 ip dvmrp reject-non-pruners ...........................................................................................12-8 ip dvmrp summary-address ............................................................................................12-9 network .........................................................................................................................12-10 router dvmrp .................................................................................................................12-11 show ip dvmrp information ..........................................................................................12-12 show ip dvmrp interface ...............................................................................................12-13 show ip dvmrp neighbor ...............................................................................................12-14 show ip dvmrp network ................................................................................................12-15 show ip dvmrp route .....................................................................................................12-16 show ip dvmrp route hold-down...................................................................................12-17 show ip dvmrp summary-route.....................................................................................12-18 show ip dvmrp tunnels..................................................................................................12-19

Compass ID: 271820115 Version 3

xix

BSR 64000 Command Reference Guide

Release 5.0.0

13

CMTS Commands
Introduction ...............................................................................................................................13-1 CMTS Command Descriptions .................................................................................................13-1 arp timeout......................................................................................................................13-2 balance ............................................................................................................................13-3 band ................................................................................................................................13-4 bind cmts ........................................................................................................................13-5 bootrom-filename ...........................................................................................................13-6 bootrom-invalidate slot...................................................................................................13-7 cable bind........................................................................................................................13-8 cable bundle..................................................................................................................13-10 cable bundle master ......................................................................................................13-11 cable cmts type .............................................................................................................13-12 cable concatenation docsis-1.0 .....................................................................................13-13 cable deny ip.................................................................................................................13-14 cable dhcp force-unicast ...............................................................................................13-15 cable dhcp-giaddr primary............................................................................................13-16 cable dhcp leasequery message-type ............................................................................13-17 cable disable 3140-nbpwr-adjustment ..........................................................................13-19 cable disable bpi-cmcert ...............................................................................................13-20 cable disable eth-pkt-filtering.......................................................................................13-21 cable downstream aggregate.........................................................................................13-22 cable downstream bdm-interval ...................................................................................13-23 cable downstream bonding disable...............................................................................13-24 cable downstream bonding-domain..............................................................................13-25 cable downstream bonding-group ................................................................................13-26 cable downstream carrier-only .....................................................................................13-28 cable downstream channel-id .......................................................................................13-29 cable downstream channel-mode .................................................................................13-30 cable downstream description ......................................................................................13-31 cable downstream fiber-node........................................................................................13-32 cable downstream frequency ........................................................................................13-33 cable downstream interleave-depth ..............................................................................13-35 cable downstream loadbalance-group ..........................................................................13-37

xx

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

cable downstream modulation ......................................................................................13-38 cable downstream mot-bonding-group.........................................................................13-39 cable downstream port..................................................................................................13-41 cable downstream power-level .....................................................................................13-42 cable downstream primary-capable ..............................................................................13-44 cable downstream rate-limit .........................................................................................13-45 cable downstream scrambler on ...................................................................................13-46 cable downstream shutdown.........................................................................................13-47 cable downstream sync-interval ...................................................................................13-48 cable downstream threshold .........................................................................................13-49 cable downstream trap-enable-if ..................................................................................13-51 cable downstream trap-enable-rdn ...............................................................................13-52 cable dtx type................................................................................................................13-53 cable dynamic-service admitted-timeout......................................................................13-54 cable fast-path cm.........................................................................................................13-55 cable filter group index src-ip.......................................................................................13-56 cable filter group index dst-ip.......................................................................................13-57 cable filter group index ulp...........................................................................................13-58 cable filter group index tos ...........................................................................................13-59 cable filter group index action ......................................................................................13-60 cable filter group index enable .....................................................................................13-61 cable flap-list aging ......................................................................................................13-62 cable flap-list insertion-time.........................................................................................13-64 cable flap-list miss-threshold........................................................................................13-65 cable flap-list percentage threshold ..............................................................................13-66 cable flap-list power-adjust threshold ..........................................................................13-67 cable flap-list size .........................................................................................................13-68 cable flap-list trap-enable .............................................................................................13-69 cable helper-address .....................................................................................................13-70 cable helper-address host vendor-class-identifiers .......................................................13-72 cable host authorization range ......................................................................................13-73 cable insert-interval ......................................................................................................13-74 cable intercept...............................................................................................................13-75 cable load-balance ........................................................................................................13-77

Compass ID: 271820115 Version 3

xxi

BSR 64000 Command Reference Guide

Release 5.0.0

cable loadbalance-group ...............................................................................................13-78 cable loadbalance-policy ..............................................................................................13-79 cable loadbalance-restricted .........................................................................................13-80 cable loadbalance-rule ..................................................................................................13-82 cable load-balance spectrum-group ..............................................................................13-85 cable mdd-interval ........................................................................................................13-86 cable modem-aging-timer.............................................................................................13-87 cable modem dcc ..........................................................................................................13-88 cable modem deny........................................................................................................13-90 cable modem disable loadbalancing.............................................................................13-91 cable modem max-hosts ...............................................................................................13-92 cable modem max-hosts-all..........................................................................................13-93 cable modem qos dsa....................................................................................................13-94 cable modem qos dsc....................................................................................................13-96 cable modem qos dsd....................................................................................................13-97 cable modem remote-query ..........................................................................................13-98 cable modem remote-query source-interface ...............................................................13-99 cable modem ucc ........................................................................................................13-102 cable modem updis .....................................................................................................13-104 cable modulation-profile ............................................................................................13-105 cable modulation-profile copy....................................................................................13-109 cable modulation-profile description..........................................................................13-110 cable modulation-profile reset ....................................................................................13-111 cable mta-protection enable........................................................................................13-112 cable multicast ............................................................................................................13-113 cable multi-ds-override...............................................................................................13-115 cable privacy auth life-time ........................................................................................13-116 cable privacy cert........................................................................................................13-117 cable privacy cm-auth life-time..................................................................................13-118 cable privacy cm-auth reset ........................................................................................13-119 cable privacy cm-tek life-time....................................................................................13-121 cable privacy cm-tek reset ..........................................................................................13-122 cable privacy mcast ....................................................................................................13-123 cable privacy mcast access .........................................................................................13-124

xxii

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

cable privacy tek life-time ..........................................................................................13-125 cable qos-profile .........................................................................................................13-126 cable shared-secret......................................................................................................13-127 cable shared-secondary-secret ....................................................................................13-128 cable spectrum-group .................................................................................................13-129 cable spm-management ..............................................................................................13-130 cable submgmt default cpe-control active..................................................................13-131 cable submgmt default cpe-control learnable.............................................................13-132 cable submgmt default cpe-control max-cpe..............................................................13-133 cable submgmt default filter-group ............................................................................13-134 cable submgmt default filter-group cm ......................................................................13-135 cable sync-interval......................................................................................................13-136 cable tcpudp-filter group index src-port .....................................................................13-137 cable tcpudp-filter group index dst-port .....................................................................13-138 cable tcpudp-filter group index enable .......................................................................13-139 cable tcpudp-filter group index tcp-flag .....................................................................13-140 cable ucd-interval .......................................................................................................13-141 cable upstream active-codes .......................................................................................13-142 cable upstream capability ...........................................................................................13-143 cable upstream channel-id ..........................................................................................13-144 cable upstream channel-type ......................................................................................13-145 cable upstream channel-width ....................................................................................13-146 cable upstream codes-minislot ...................................................................................13-147 cable upstream concatenation.....................................................................................13-148 cable upstream data-backoff.......................................................................................13-149 cable upstream description .........................................................................................13-150 cable upstream eng-nb-atten-backoff value................................................................13-151 cable upstream eq-magnitude-scaling ........................................................................13-153 cable upstream force-frag ...........................................................................................13-155 cable upstream frequency ...........................................................................................13-156 cable upstream global-clock .......................................................................................13-158 cable upstream global-clock enable............................................................................13-159 cable upstream hopping-seed .....................................................................................13-160 cable upstream ingress-canceller enable ....................................................................13-161

Compass ID: 271820115 Version 3

xxiii

BSR 64000 Command Reference Guide

Release 5.0.0

cable upstream ingress-canceller idle-interval ...........................................................13-162 cable upstream invited-range-interval ........................................................................13-163 cable upstream iuc11-grant-size .................................................................................13-164 cable upstream loadbalance-group .............................................................................13-165 cable upstream maintain-power-density on ................................................................13-166 cable upstream map-interval.......................................................................................13-167 cable upstream max-calls ...........................................................................................13-168 cable upstream minislot-size ......................................................................................13-169 cable upstream modem-ranging-delay .......................................................................13-171 cable upstream modulation-profile.............................................................................13-172 cable upstream physical-delay....................................................................................13-174 cable upstream power-level ........................................................................................13-178 cable upstream power-level default............................................................................13-180 cable upstream pre-equalization .................................................................................13-182 cable upstream range-backoff.....................................................................................13-183 cable upstream range-forced-continue .......................................................................13-184 cable upstream range-power-override ........................................................................13-185 cable upstream rate-limit ............................................................................................13-186 cable upstream shutdown ...........................................................................................13-187 cable upstream snr-offset............................................................................................13-188 cable upstream spectrum-group..................................................................................13-189 cable upstream spread-interval ...................................................................................13-190 cable upstream trap-enable-cmts ................................................................................13-191 cable upstream trap-enable-if .....................................................................................13-192 cable upstream trap-enable-rdn ..................................................................................13-193 cable utilization-interval .............................................................................................13-194 channel-type ...............................................................................................................13-195 clear cable dcc-stats....................................................................................................13-197 clear cable downstream bonding-group statistics.......................................................13-198 clear cable flap-list .....................................................................................................13-199 clear cable modem ......................................................................................................13-200 clear cable modem downstream .................................................................................13-201 clear cable modem offline ..........................................................................................13-202 clear cable modem sync..............................................................................................13-203

xxiv

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

clear cable qos svc-flow statistics...............................................................................13-204 clear cable srvclass-stats.............................................................................................13-205 clear cable ucc-stats....................................................................................................13-207 clear cable ugs-stats....................................................................................................13-208 clear counters cable ....................................................................................................13-209 clear interfaces cable upstream channel-agility-stats .................................................13-210 clear interfaces cable upstream signal-quality............................................................13-211 clear usage-stats..........................................................................................................13-212 cmts-id ........................................................................................................................13-213 codes-subframe...........................................................................................................13-214 collect interval ............................................................................................................13-215 collect resolution ........................................................................................................13-216 dhcp leasequery authorization on ...............................................................................13-217 differential-encoding on .............................................................................................13-218 docstest .......................................................................................................................13-219 docstest type ...............................................................................................................13-220 fec-codeword ..............................................................................................................13-222 fec-correction..............................................................................................................13-223 fft display ....................................................................................................................13-224 fft setup .......................................................................................................................13-226 fft start ........................................................................................................................13-227 fft store........................................................................................................................13-228 guard-band..................................................................................................................13-229 hop action band...........................................................................................................13-230 hop action channel-width ...........................................................................................13-231 hop action frequency ..................................................................................................13-232 hop action modulation-profile ....................................................................................13-233 hop action power-level ...............................................................................................13-234 hop action roll-back ....................................................................................................13-236 hop period ...................................................................................................................13-237 hop snr hysteresis .......................................................................................................13-238 hop sampling-period active-channel...........................................................................13-240 hop sampling-period rollback-channel .......................................................................13-241 hop sampling-period spare-channel............................................................................13-242

Compass ID: 271820115 Version 3

xxv

BSR 64000 Command Reference Guide

Release 5.0.0

hop threshold error .....................................................................................................13-243 hop threshold flap .......................................................................................................13-244 hop threshold snr modulation-type .............................................................................13-245 init-tech.......................................................................................................................13-247 interface cable.............................................................................................................13-248 interleaver-block-size .................................................................................................13-249 interleaver-depth.........................................................................................................13-250 interleaver-step-size....................................................................................................13-251 ip address ....................................................................................................................13-252 ip dhcp relay information option ................................................................................13-255 iuc ...............................................................................................................................13-256 last-codeword-length ..................................................................................................13-259 load-balancing ............................................................................................................13-260 load-balancing static ...................................................................................................13-261 max-burst ....................................................................................................................13-262 modulation-type..........................................................................................................13-263 ping docsis ..................................................................................................................13-265 policy rule...................................................................................................................13-266 preamble-length ..........................................................................................................13-267 preamble-type .............................................................................................................13-268 reference-modem-exclusion .......................................................................................13-269 scrambler-mode ..........................................................................................................13-270 scrambler-seed ............................................................................................................13-271 show bindings.............................................................................................................13-272 show cable binding .....................................................................................................13-273 show cable bonding-group minrr-multipliers .............................................................13-275 show cable dcc-stats ...................................................................................................13-277 show cable downstream..............................................................................................13-279 show cable downstream bonding-groups ...................................................................13-282 show cable downstream idlist.....................................................................................13-285 show cable fiber-node.................................................................................................13-286 show cable filter .........................................................................................................13-288 show cable flap-list.....................................................................................................13-289 show cable insert-interval...........................................................................................13-291

xxvi

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

show cable loadbalance-group ...................................................................................13-292 show cable loadbalance-no-move-list ........................................................................13-294 show cable loadbalance-policy...................................................................................13-296 show cable loadbalance-restricted ..............................................................................13-298 show cable loadbalance-rule.......................................................................................13-299 show cable md-ds-sg ..................................................................................................13-300 show cable modem .....................................................................................................13-301 show cable modem bonding .......................................................................................13-305 show cable modem cpe...............................................................................................13-307 show cable modem detail ...........................................................................................13-310 show cable modem downstream.................................................................................13-313 show cable modem hosts ............................................................................................13-316 show cable modem loadbalance-group ......................................................................13-318 show cable modem mac..............................................................................................13-320 show cable modem mac30..........................................................................................13-323 show cable modem maintenance ................................................................................13-326 show cable modem mta ..............................................................................................13-328 show cable modem ps.................................................................................................13-328 show cable modem stb................................................................................................13-328 show cable modem offline..........................................................................................13-333 show cable modem phy ..............................................................................................13-335 show cable modem registered ....................................................................................13-338 show cable modem remote-query...............................................................................13-341 show cable modem stats .............................................................................................13-345 show cable modem summary .....................................................................................13-348 show cable modem summary total .............................................................................13-351 show cable modem svc-flow-id..................................................................................13-353 show cable modem svc-flow-id detail ........................................................................13-355 show cable modem time-registered ............................................................................13-358 show cable modem timing-offset ...............................................................................13-361 show cable modem unregistered ................................................................................13-365 show cable modem vendor .........................................................................................13-367 show cable modem vendor summary .........................................................................13-369 show cable modem verbose........................................................................................13-371

Compass ID: 271820115 Version 3

xxvii

BSR 64000 Command Reference Guide

Release 5.0.0

show cable modulation-profile ...................................................................................13-373 show cable modulation-profile brief ..........................................................................13-376 show cable modulation-profile description ................................................................13-377 show cable privacy auth .............................................................................................13-378 show cable privacy cm-auth .......................................................................................13-379 show cable privacy cm-tek .........................................................................................13-380 show cable privacy cmts.............................................................................................13-382 show cable privacy tek ...............................................................................................13-383 show cable qos profile ................................................................................................13-384 show cable qos profile user-defined ...........................................................................13-387 show cable qos svc-flow classifier .............................................................................13-390 show cable qos svc-flow dynamic-stat .......................................................................13-393 show cable qos svc-flow log.......................................................................................13-394 show cable qos svc-flow param-set ............................................................................13-395 show cable qos svc-flow phs ......................................................................................13-397 show cable qos svc-flow statistics..............................................................................13-399 show cable qos svc-flow summary.............................................................................13-401 show cable qos svc-flow upstream-stat ......................................................................13-402 show cable spectrum-group ........................................................................................13-403 show cable spectrum-group load-balance summary...................................................13-406 show cable spectrum-group map ................................................................................13-407 show cable spectrum-group modem-exclusion-list ....................................................13-409 show cable spectrum-group reference-modem...........................................................13-410 show cable spectrum-group snr-thresholds ................................................................13-411 show cable spectrum-group stats................................................................................13-412 show cable submgmt default ......................................................................................13-414 show cable sync-interval ............................................................................................13-415 show cable tcpudp-filter .............................................................................................13-416 show cable ucc-stats ...................................................................................................13-417 show cable ucd-interval ..............................................................................................13-419 show cable ugs-stats ...................................................................................................13-420 show cable upstream...................................................................................................13-422 show cable upstream global-clock..............................................................................13-426 show controllers cable ds-mac....................................................................................13-427

xxviii

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

show controllers cable ds-phy ....................................................................................13-431 show docsis-version....................................................................................................13-433 show docstest..............................................................................................................13-434 show interfaces cable..................................................................................................13-435 show interfaces cable bandwidth voice ......................................................................13-441 show interfaces cable configuration ...........................................................................13-443 show interfaces cable downstream .............................................................................13-445 show interfaces cable intercept...................................................................................13-448 show interfaces cable service-class ............................................................................13-450 show interfaces cable stats..........................................................................................13-453 show interfaces cable upstream ..................................................................................13-455 show interfaces cable upstream channel-agility-stats.................................................13-460 show running-config cable downstream port .............................................................13-462 show stats cmts ...........................................................................................................13-464 show stats summary error ...........................................................................................13-467 snr display...................................................................................................................13-469 snr loop .......................................................................................................................13-470 snr setup......................................................................................................................13-472 snr setup-get................................................................................................................13-474 snr setup-spare-mod-profile........................................................................................13-475 snr start .......................................................................................................................13-476 snr store ......................................................................................................................13-477 spectrum-copy ............................................................................................................13-478 spreader on..................................................................................................................13-479 tcm-encoding on .........................................................................................................13-480 time band ....................................................................................................................13-481 time delete ..................................................................................................................13-482 vendor-class-identifier ................................................................................................13-483

Compass ID: 271820115 Version 3

xxix

BSR 64000 Command Reference Guide

Release 5.0.0

14

QoS Commands
Introduction ...............................................................................................................................14-1 QoS Command Descriptions.....................................................................................................14-1 qos bw default.................................................................................................................14-2 qos queue bw ..................................................................................................................14-3 qos queue dot1p ..............................................................................................................14-4 show qos queue config ...................................................................................................14-5

15

POS Commands
Introduction ...............................................................................................................................15-1 POS Command Descriptions.....................................................................................................15-2 aps force..........................................................................................................................15-3 aps group ........................................................................................................................15-4 aps lockout......................................................................................................................15-5 aps manual ......................................................................................................................15-6 aps protect.......................................................................................................................15-7 aps revert ........................................................................................................................15-8 aps signal-degrade ber threshold ....................................................................................15-9 aps signal-fail ber threshold..........................................................................................15-10 aps unidirectional..........................................................................................................15-11 aps working ..................................................................................................................15-12 crc .................................................................................................................................15-13 interface pos..................................................................................................................15-14 ip address ......................................................................................................................15-15 peer default ip address ..................................................................................................15-16 pos ais-shut ...................................................................................................................15-17 pos flag .........................................................................................................................15-18 pos framing ...................................................................................................................15-20 pos internal-clock .........................................................................................................15-21 pos report ......................................................................................................................15-22 pos scramble .................................................................................................................15-24 pos signal mode ............................................................................................................15-25 pos threshold.................................................................................................................15-26 ppp magic-number........................................................................................................15-28

xxx

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

ppp negotiation-count...................................................................................................15-29 ppp timeout ...................................................................................................................15-30 show aps .......................................................................................................................15-31 show controllers pos .....................................................................................................15-32 show interfaces pos.......................................................................................................15-34 show ppp info ...............................................................................................................15-37 show ppp statistics........................................................................................................15-38

16

BGP Commands
Introduction ...............................................................................................................................16-1 BGP Command Descriptions ....................................................................................................16-1 aggregate-address ...........................................................................................................16-2 auto-summary .................................................................................................................16-3 bgp always-compare-med...............................................................................................16-4 bgp client-to-client reflection .........................................................................................16-5 bgp cluster-id ..................................................................................................................16-6 bgp confederation identifier ...........................................................................................16-7 bgp confederation peers..................................................................................................16-8 bgp dampening ...............................................................................................................16-9 bgp default ....................................................................................................................16-11 bgp permit.....................................................................................................................16-12 bgp router-id .................................................................................................................16-13 clear ip bgp ...................................................................................................................16-14 clear ip bgp dampening ................................................................................................16-15 clear ip bgp flap-statistics.............................................................................................16-16 default-information originate........................................................................................16-17 default-metric ...............................................................................................................16-18 distance bgp ..................................................................................................................16-19 distribute-list in.............................................................................................................16-21 distribute-list out...........................................................................................................16-22 ip as-path access-list .....................................................................................................16-23 ip community-list..........................................................................................................16-24 match as-path................................................................................................................16-26 match community .........................................................................................................16-27

Compass ID: 271820115 Version 3

xxxi

BSR 64000 Command Reference Guide

Release 5.0.0

maximum-paths ............................................................................................................16-28 neighbor advertisement-interval ...................................................................................16-29 neighbor confed-segment .............................................................................................16-30 neighbor default-originate ............................................................................................16-31 neighbor description .....................................................................................................16-32 neighbor distribute-list..................................................................................................16-33 neighbor ebgp-multihop ...............................................................................................16-34 neighbor filter-list .........................................................................................................16-35 neighbor maximum-prefix............................................................................................16-37 neighbor next-hop-self..................................................................................................16-39 neighbor password........................................................................................................16-40 neighbor peer-group (assigning members) ...................................................................16-41 neighbor peer-group (creating).....................................................................................16-42 neighbor remote-as .......................................................................................................16-43 neighbor remove-private-as..........................................................................................16-45 neighbor route-map ......................................................................................................16-46 neighbor route-reflector-client......................................................................................16-47 neighbor route-refresh ..................................................................................................16-48 neighbor send-community ............................................................................................16-49 neighbor shutdown .......................................................................................................16-50 neighbor soft-reconfiguration inbound.........................................................................16-51 neighbor timers.............................................................................................................16-52 neighbor update-source loopback.................................................................................16-54 neighbor weight ............................................................................................................16-55 network .........................................................................................................................16-56 redistribute....................................................................................................................16-57 route-map......................................................................................................................16-59 router bgp......................................................................................................................16-60 set as-path prepend .......................................................................................................16-61 set comm-list ................................................................................................................16-62 set community ..............................................................................................................16-64 set ip next-hop ..............................................................................................................16-66 set local-preference.......................................................................................................16-67 set metric-type ..............................................................................................................16-68

xxxii

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

set origin .......................................................................................................................16-69 set tag............................................................................................................................16-70 set weight......................................................................................................................16-71 show ip as-path-access-list ...........................................................................................16-72 show ip bgp...................................................................................................................16-73 show ip bgp cidr-only ...................................................................................................16-75 show ip bgp community ...............................................................................................16-76 show ip bgp community-list .........................................................................................16-78 show ip bgp dampened-paths .......................................................................................16-79 show ip bgp flap-statistics ............................................................................................16-80 show ip bgp ipv4 unicast ..............................................................................................16-82 show ip bgp memory ....................................................................................................16-86 show ip bgp neighbors..................................................................................................16-88 show ip bgp next-hops..................................................................................................16-90 show ip bgp paths .........................................................................................................16-91 show ip bgp peer-group ................................................................................................16-92 show ip bgp regexp.......................................................................................................16-94 show ip bgp summary...................................................................................................16-95 show ip community-list ................................................................................................16-97 synchronization.............................................................................................................16-98 timers bgp .....................................................................................................................16-99

17

PIM Commands
Introduction ...............................................................................................................................17-1 PIM Command Descriptions.....................................................................................................17-1 ip pim border ..................................................................................................................17-2 ip pim bsr-candidate .......................................................................................................17-3 ip pim bsr-candidate ip-address......................................................................................17-4 ip pim dr-priority ............................................................................................................17-5 ip pim message-interval..................................................................................................17-6 ip pim query-interval ......................................................................................................17-7 ip pim rp-candidate.........................................................................................................17-8 ip pim rp-candidate group-list ........................................................................................17-9 ip pim rp-candidate interval..........................................................................................17-10

Compass ID: 271820115 Version 3

xxxiii

BSR 64000 Command Reference Guide

Release 5.0.0

ip pim rp-candidate ip-address .....................................................................................17-11 ip pim rp-candidate priority..........................................................................................17-12 ip pim spt-threshold lasthop .........................................................................................17-13 ip pim spt-threshold rp..................................................................................................17-14 ip pim ssm.....................................................................................................................17-15 network .........................................................................................................................17-16 pim accept-rp ................................................................................................................17-17 pim graceful-restart restart-interval ..............................................................................17-18 pim register-checksum..................................................................................................17-19 pim rp-address ..............................................................................................................17-20 pim unicast-route-lookup..............................................................................................17-22 router pim .....................................................................................................................17-23 show ip pim ..................................................................................................................17-24

18

MPLS Commands
Introduction ...............................................................................................................................18-1 About RSVP ...................................................................................................................18-3 MPLS Command Descriptions..................................................................................................18-3 clear ip rsvp statistics......................................................................................................18-4 clear mpls traffic.............................................................................................................18-5 debug mpls forwarding...................................................................................................18-6 debug mpls rsvp..............................................................................................................18-7 ip rsvp .............................................................................................................................18-9 mpls create-lsp rsvp ......................................................................................................18-11 mpls create-lsp rsvp explicit-route identifier................................................................18-12 mpls create-lsp rsvp next-hop.......................................................................................18-13 mpls create-lsp static ....................................................................................................18-14 mpls fp max ..................................................................................................................18-16 mpls ip ..........................................................................................................................18-17 mpls label range............................................................................................................18-18 mpls rsvp restart-lsp .....................................................................................................18-20 mpls ttl ..........................................................................................................................18-21 show fast-path ranges ...................................................................................................18-22 show ip rsvp explicit-routed-lsps..................................................................................18-23

xxxiv

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

show ip rsvp interface...................................................................................................18-24 show ip rsvp lsp ............................................................................................................18-25 show ip rsvp neighbor ..................................................................................................18-26 show ip rsvp reservation ...............................................................................................18-27 show ip rsvp sender ......................................................................................................18-28 show ip rsvp statistics...................................................................................................18-29 show mpls filters...........................................................................................................18-30 show mpls forwarding-table .........................................................................................18-32 show mpls label range ..................................................................................................18-35 show mpls lsp ...............................................................................................................18-36 show mpls lsp interface ................................................................................................18-39 show mpls rsvp refresh-time ........................................................................................18-41 show mpls traffic ..........................................................................................................18-42

19

Service Class Commands
Introduction ...............................................................................................................................19-1 Entering Service Class Configuration Mode ..................................................................19-2 Service Class Command Descriptions ......................................................................................19-2 activity-timeout...............................................................................................................19-3 admission-timeout ..........................................................................................................19-4 admitted-bw-threshold....................................................................................................19-5 allow-share .....................................................................................................................19-6 cable service-class ..........................................................................................................19-7 cap...................................................................................................................................19-8 clear cable srvclass-stats.................................................................................................19-9 enforce-cmts-qos ..........................................................................................................19-10 grant-interval ................................................................................................................19-11 grant-jitter .....................................................................................................................19-12 grant-size ......................................................................................................................19-13 grants-per-interval ........................................................................................................19-14 mab ...............................................................................................................................19-15 max-burst ......................................................................................................................19-17 max-concat-burst ..........................................................................................................19-18 max-latency ..................................................................................................................19-19

Compass ID: 271820115 Version 3

xxxv

BSR 64000 Command Reference Guide

Release 5.0.0

max-rate ........................................................................................................................19-20 min-pkt-size..................................................................................................................19-21 min-rate.........................................................................................................................19-22 name .............................................................................................................................19-23 over-max-rate ...............................................................................................................19-24 poll-interval ..................................................................................................................19-25 poll-jitter .......................................................................................................................19-26 req-trans-policy.............................................................................................................19-27 restricted admission disabled........................................................................................19-29 schedpriority .................................................................................................................19-30 show cable service-class...............................................................................................19-31 show cable srvclass-stats ..............................................................................................19-35 tos-overwrite.................................................................................................................19-37 trafpriority.....................................................................................................................19-38 ugs-stats-window..........................................................................................................19-39

20

Secure Shell Server Commands
Introduction ...............................................................................................................................20-1 Secure Shell Server Command Descriptions ............................................................................20-1 password ssh-passphrase ................................................................................................20-2 show ssh config ..............................................................................................................20-3 show ssh hostkey-fingerprint..........................................................................................20-6 show users ssh ................................................................................................................20-7 ssh ciphers ......................................................................................................................20-8 ssh enable......................................................................................................................20-10 ssh-keygen2 ..................................................................................................................20-11 ssh load-host-key-files..................................................................................................20-13 ssh logout session-id.....................................................................................................20-14 ssh message-authentication ..........................................................................................20-15 ssh password-authentication radius ..............................................................................20-16 ssh password-guesses ...................................................................................................20-17 ssh port..........................................................................................................................20-18 ssh session-limit............................................................................................................20-19 ssh timeout....................................................................................................................20-20

xxxvi

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

21

PacketCable Commands
Overview ...................................................................................................................................21-1 Command Descriptions .............................................................................................................21-1 cable dynamic-service authorization-mode ....................................................................21-2 cable dynamic-service active-timeout ............................................................................21-4 clear configuration..........................................................................................................21-5 clear cops pdp-ip all........................................................................................................21-6 clear counters ipsec.........................................................................................................21-7 clear packet-cable cops...................................................................................................21-8 clear packet-cable gate ...................................................................................................21-9 clear packet-cable statistics ..........................................................................................21-10 cmts-ip ..........................................................................................................................21-11 cops client-timer ...........................................................................................................21-12 cops pdp-ip ...................................................................................................................21-13 cops pep-id....................................................................................................................21-14 cops status-trap-enable .................................................................................................21-15 dqos emergency-preempt..............................................................................................21-16 dqos emergency-trap-enable.........................................................................................21-17 dqos res-req-trap-enable ...............................................................................................21-18 dqos shutdown ..............................................................................................................21-19 dqos t0-timer/t1-timer...................................................................................................21-20 em element-number ......................................................................................................21-21 em event-disable-mask .................................................................................................21-22 em event-priority ..........................................................................................................21-23 em flag-override ...........................................................................................................21-24 em max-batch-events....................................................................................................21-25 em max-batch-time .......................................................................................................21-26 em qos-descriptor-disable.............................................................................................21-27 em retry-count ..............................................................................................................21-28 em retry-interval ...........................................................................................................21-29 em rks-failure-trap-enable ............................................................................................21-30 em shutdown.................................................................................................................21-32 em udp-port ..................................................................................................................21-33 es...................................................................................................................................21-34

Compass ID: 271820115 Version 3

xxxvii

BSR 64000 Command Reference Guide

Release 5.0.0

ike client-addr...............................................................................................................21-36 ike phase1 .....................................................................................................................21-37 ike phase2 .....................................................................................................................21-38 ike retries ......................................................................................................................21-39 ike timeout ....................................................................................................................21-40 ipsec..............................................................................................................................21-41 ipsec shutdown .............................................................................................................21-42 mm shutdown ...............................................................................................................21-43 mm t1-timer ..................................................................................................................21-44 packet-cable..................................................................................................................21-45 show cable dynamic-service.........................................................................................21-46 show ipsec ....................................................................................................................21-47 show packet-cable configuration..................................................................................21-50 show packet-cable cops ................................................................................................21-55 show packet-cable gate.................................................................................................21-57 show packet-cable statistics..........................................................................................21-60 spd allow-dynamic-rsp .................................................................................................21-65 spd override ..................................................................................................................21-66 spd policy......................................................................................................................21-67 spd preshared-key .........................................................................................................21-69

22

VLAN Tagging Commands
Introduction ...............................................................................................................................22-1 VLAN Tagging Command Descriptions...................................................................................22-1 bridge cable intercept .....................................................................................................22-2 bridge cable modem .......................................................................................................22-4 bridge mode trunk...........................................................................................................22-5 cable privacy mandatory.................................................................................................22-6 clear bridge vlan counters...............................................................................................22-7 encapsulation dot1q ........................................................................................................22-8 show bridge vlan.............................................................................................................22-9

xxxviii

Compass ID: 271820115 Version 3

Release 5.0.0

Contents

23

DSG Commands
Introduction ...............................................................................................................................23-1 Command Descriptions .............................................................................................................23-1 cable downstream dsg.....................................................................................................23-2 cable downstream dsg enable .........................................................................................23-3 cable dsg .........................................................................................................................23-4 channel-list .....................................................................................................................23-5 classifier..........................................................................................................................23-6 client-list .........................................................................................................................23-8 group-map.....................................................................................................................23-10 show cable dsg..............................................................................................................23-12 show cable dsg channel-list ..........................................................................................23-14 show cable dsg classifier ..............................................................................................23-15 show cable dsg client-list..............................................................................................23-16 show cable dsg downstream .........................................................................................23-17 show cable dsg group-map ...........................................................................................23-18 show cable dsg timer ....................................................................................................23-19 show cable dsg tunnel...................................................................................................23-20 show cable dsg tunnel-group ........................................................................................23-21 show cable dsg vendor-param ......................................................................................23-22 timer..............................................................................................................................23-23 tunnel ............................................................................................................................23-25 vendor-param................................................................................................................23-27

24

IPDR Commands
Introduction ...............................................................................................................................24-1 Command Descriptions .............................................................................................................24-1 debug ipdr .......................................................................................................................24-2 ipdr acksequenceinterval ................................................................................................24-3 ipdr acktimeinterval........................................................................................................24-4 ipdr collection-interval ...................................................................................................24-5 ipdr collector...................................................................................................................24-6 ipdr enable ......................................................................................................................24-8 ipdr keepaliveinterval .....................................................................................................24-9

Compass ID: 271820115 Version 3

xxxix

BSR 64000 Command Reference Guide

Release 5.0.0

ipdr poll-rate .................................................................................................................24-10 ipdr source-interface .....................................................................................................24-11 show cable metering-status...........................................................................................24-12 show ipdr connection....................................................................................................24-14 show ipdr session..........................................................................................................24-15

25

Cable Traffic Management Commands
Introduction ...............................................................................................................................25-1 Command Descriptions .............................................................................................................25-1 bidirectional....................................................................................................................25-2 cable traffic sample-interval ...........................................................................................25-3 cable traffic policy ..........................................................................................................25-4 clear cable traffic enforcement .......................................................................................25-6 clear cable traffic history ................................................................................................25-7 credit ...............................................................................................................................25-8 enabled..........................................................................................................................25-10 enforce ..........................................................................................................................25-12 max-rate ........................................................................................................................25-14 peak-time ......................................................................................................................25-16 penalty-period...............................................................................................................25-18 show cable subscriber-usage ........................................................................................25-20 show cable subscriber-usage summary.........................................................................25-26 show cable traffic policy ..............................................................................................25-29

Index

xl

Compass ID: 271820115 Version 3

Preface

Scope
This document describes how to install and configure the Motorola™ Broadband Services Router™ 64000 (BSR 64000™).

Audience
This document is for use by those persons who will install and configure the BSR 64000™ product. Only trained service personnel should install, maintain, or replace the BSR 64000.

Documentation Set
The following documents comprise the BSR 64000 documentation set:
■

BSR 64000 Quick Start Guide The quick start guide provides a "roadmap" to the tasks involved in physically installing the BSR 64000 product, physically connecting it to your network/HFC infrastructure, and performing configuration tasks to enable the BSR 64000 to operate in your networking environment.

■

BSR 64000 Installation Guide This guide provides detailed instructions for physically installing the BSR 64000 product including: procedures for rack mounting, making physical network cable connections, connecting DC power, and for determining the status of the BSR 64000 after applying power to it. This document also provides a description of the BSR 64000 chassis, its hardware components and modules.

Compass ID: 271820115 Version 3

xli

BSR 64000 Command Reference Guide

Release 5.0.0

■

BSR 64000 Resource and I/O Module Installation Guide This guide contains procedures for installing additional and replacement Resource and I/O Modules in a BSR 64000 chassis and for making physical cable connections to the modules.

■

BSR 64000 Command Line Interface User’s Guide For users, this guide describes the structure of the BSR 64000 Command Line Interface (CLI) and its various command modes. It also provides rules and guidelines for navigating through the CLI.

■

BSR 64000 Command Reference Guide This guide contains individual descriptions of the entire set of commands that comprise the BSR 64000 Command Line Interface (CLI). These commands are used to interface with, configure, manage, and maintain the BSR 64000.

■

BSR 64000 System Administration Guide For system administrators, this guide provides detailed procedures for performing initial configuration tasks including setting up: user accounts and passwords; telnet and console access; system logging; and associated servers such as DHCP, DNS, etc.

■

BSR 64000 CMTS Configuration and Management Guide This guide provides the instructions and procedures for configuring and managing BSR 64000 CMTS operation.

■

BSR 64000 Routing Configuration and Management Guide This guide contains the instructions and procedures for configuring and managing BSR 64000 routing operation, including RIP, OSPF, and BGP.

■

BSR 64000 SNMP Configuration and Management Guide This guide provides the instructions and procedures for configuring and managing BSR 64000 Simple Network Management Protocol (SNMP) operation. It also describes SNMP MIBs; provides information that describes standard and proprietary MIB support; describes how to walk MIBs; and how to compile and load SNMP MIBs.

■

BSR 64000 BGP/MPLS VPN Configuration Guide

ii-xlii

Compass ID: 271820115 Version 3

Release 5.0.0

Preface

This guide provides the instructions and procedures for configuring and managing the BSR 64000 to support and implement Border Gateway Protocol/ MultiProtocol Label Switching Virtual Private Networks (BGP/MPLS VPNs).
■

BSR 64000 Troubleshooting Guide This guide contains instructions and procedures for troubleshooting typical configuration problems that might be encountered using the BSR 64000. It also offers suggestions for information to record, and have available should the need arise to call Motorola support for assistance with BSR 64000 operational problems.

■

BSR 64000 Release Notes These documents are specific to each release of the BSR 64000 product (software and hardware). Release notes provide information about features not documented or incorrectly documented in the main documentation set; known problems and anomalies; product limitations; and problem resolutions.

Conventions
This document uses the conventions in the following table: Convention angle brackets < >

Example ping ping 54.89.145.71

Explanation
Arguments in italic and enclosed by angle brackets must be replaced by the text the argument represents. In the example, 54.89.145.71 replaces . When entering the argument, do not type the angle brackets. Bar brackets enclose optional arguments. The example indicates you can use the disable command with or without specifying a level. Some commands accept more than one optional argument. When entering the argument, do not type the bar brackets. Boldface text must be typed exactly as it appears.

bar brackets [ ]

disable [level]

bold text

cable relay-agent-option

Compass ID: 271820115 Version 3

ii-xliii

BSR 64000 Command Reference Guide

Release 5.0.0

Convention brace brackets {}

Example page {on | off}

Explanation
Brace brackets enclose required text. The example indicates you must enter either on or off after page. The system accepts the command with only one of the parameters. When entering the text, do not type the brace brackets. Italic type indicates variables for which you supply values in command syntax descriptions. It also indicates file names, directory names, document titles, or emphasized text. This font indicates system output. A vertical bar separates the choices when a parameter is required. The example indicates you can enter either command: page on or page off When entering the parameter, do not type the vertical bar or the brace brackets.

italic text

boot system

screen display vertical bar |

Wed May 6 17:01:03 2000 page {on | off}

Notes, Cautions, Warnings
The following icons and associated text may appear in this document. Note: A note contains tips, suggestions, and other helpful information, such as references to material not contained in the document, that can help you complete a task or understand the subject matter.

Caution: The exclamation point, within an equilateral triangle, is intended to alert the user to the presence of important installation, servicing, and operating instructions in the documents accompanying the equipment.

Warning: This symbol indicates that dangerous voltage levels are present within the equipment. These voltages are not insulated and may be of sufficient strength to cause serious bodily injury when touched. The symbol may also appear on schematics.

ii-xliv

Compass ID: 271820115 Version 3

Release 5.0.0

Preface

If You Need Help
If you need assistance while working with the BSR 64000 HD or BSR 64000, contact the Motorola Technical Response Center (TRC):
Inside the U.S. Outside the U.S. Motorola Online 1-888-944-HELP 1-888-944-4357 +1-215-323-0044 http://businessonline.motorola.com

The TRC is on call 24 hours a day, 7 days a week. In addition, Motorola Online offers a searchable solutions database, technical documentation, and low-priority issue creation and tracking.

Compass ID: 271820115 Version 3

ii-xlv

1
System Administration Commands

Introduction
This chapter describes the following types of commands for the BSR 64000™: User management commands which establish authentication and to protect the network from unauthorized users. Configuration file commands that handle the operating system and the system software for the BSR. The configuration file commands allow you to customize the operating system configuration at system startup, and to modify and store the configuration file for later use. System services commands that globally configure IP system services used with the BSR, such as protocols, NVRAM, IP parameters, the operating system, and the system clock Lightweight Directory Access Protocol (LDAP) commands that are used with the BSR to access online directory services over the TCP/IP network protocol. The BSR becomes an LDAP client and connects to an LDAP server to requests services and/or information.

Compass ID: 271820115 Version 3

1-1

BSR 64000 Command Reference Guide

Release 5.0.0

Logger commands which provide a way to configure system event reporting intended for diagnostics. The information in the report contains actions such as system startup, status, and event classes.

System Administration Command Descriptions
This section contains an alphabetized list and descriptions of the system administration commands supported by the BSR.

1-2

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

aaa accounting commands default
The aaa accounting commands default command enables command use accounting on the BSR. Enabling command use accounting provides resource usage data for commands used at a specified privilege level by creating a default list of methods used for accounting services. The no aaa accounting commands command disables command use accounting.

Group Access
All

Command Mode
Global Configuration

Command Line Usage aaa accounting commands {exec | isp-ro | isp-rw | mso-ro | mso-rw | sysadmin} default {none | start-stop | stop-only | wait-start} {local | none | radius | tacacs} no aaa accounting commands [exec | isp-ro | isp-rw | mso-ro | mso-rw | sysadmin]

Command Syntax exec isp-ro isp-rw mso-ro mso-rw sysadmin none commands in the User EXEC privilege level commands in the ISP Read/Only privilege level commands in the ISP Read/Write privilege level commands in the MSO Read/Only privilege level commands in the MSO Read/Write privilege level commands in the SYSADMIN privilege level disables accounting services

Compass ID: 271820115 Version 3

1-3

BSR 64000 Command Reference Guide

Release 5.0.0

start-stop

sends a "start" accounting notice at the beginning of a process and a "stop" accounting notice at the end of a process - the requested user process begins regardless of whether the "start" accounting notice was received by the accounting server sends a "stop" accounting notice at the end of the requested user process - does not send a "start" accounting request at the start of the process sends a "start" accounting notice at the beginning of a process and a "stop" accounting notice at the end of a process - the requested user process does not begin until the "start" accounting notice is received by the server local database to be used as the accounting method no method is specified as the accounting method RADIUS to be used as the accounting method. TACACS+ to be used as the accounting method.

stop-only

wait-start

local none radius tacacs

1-4

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

aaa accounting exec default
The aaa accounting exec default command enables terminal session accounting on the BSR. Enabling terminal session accounting provides resource usage data for a specified terminal session and creates a default list of methods used for accounting services. The no aaa accounting exec command disables terminal session accounting.

Group Access
All

Command Mode
Global Configuration

Command Line Usage aaa accounting exec {none | start-stop | stop-only | wait-start} default {local | none | tacacs} no aaa accounting exec

Command Syntax none start-stop disables accounting services sends a "start" accounting notice at the beginning of a process and a "stop" accounting notice at the end of a process - the requested user process begins regardless of whether the "start" accounting notice was received by the accounting server sends a "stop" accounting notice at the end of the requested user process - does not send a "start" accounting request at the start of the process

stop-only

Compass ID: 271820115 Version 3

1-5

BSR 64000 Command Reference Guide

Release 5.0.0

wait-start

sends a "start" accounting notice at the beginning of a process and a "stop" accounting notice at the end of a process - the requested user process does not begin until the "start" accounting notice is received by the server local database to be used as the authorization method. no method is specified as the accounting method RADIUS to be used as the accounting method. TACACS+ to be used as the accounting method.

local none radius tacacs

1-6

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

aaa authentication enable default
The aaa authentication enable default command enables AAA authentication to determine if a user can access the privilege level 15 (system administrator). The aaa authentication enable default command enables a specific authentication method or list of methods The no aaa authentication enable command disables AAA authentication.

Note: If multiple authentication methods are specified, the methods are invoked in the sequence they are configured.

Group Access
All

Command Mode
Global Configuration

Command Line Usage aaa authentication enable default {enable | local | none | radius | tacacs} no aaa authentication enable

Command Syntax enable local none radius tacacs enable password command setup to be used as the authentication method local database to be used as the authentication method no method is specified as the authentication method RADIUS to be used as the authentication method TACACS+ to be used as the authentication method

Compass ID: 271820115 Version 3

1-7

BSR 64000 Command Reference Guide

Release 5.0.0

aaa authentication fail-message
The aaa authentication fail-message command allows you to configure an error message to display when a TACACS login has failed. The no aaa authentication login default command disables the error message.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage aaa authentication fail-message [] no aaa authentication fail-message

Command Syntax
LINE the text message to display for the failed login/authentication

1-8

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

aaa authentication local-override
The aaa authentication local-override command enables local authentication. This command overrides any configured default authentication method. A configured default authentication method will be used only if local authentication fails. The no aaa authentication local-override disables local authentication.

Group Access
All

Command Mode
Global Configuration

Command Line Usage aaa authentication local-override no aaa authentication local-override

Command Default
Disabled

Compass ID: 271820115 Version 3

1-9

BSR 64000 Command Reference Guide

Release 5.0.0

aaa authentication login default
The aaa authentication login default command enables AAA authentication to determine if a user can login to the BSR. The no aaa authentication login default command disables AAA login authentication.

Note: If multiple authentication methods are specified, the methods are invoked in the sequence they are configured.

Group Access
All

Command Mode
Global Configuration

Command Line Usage aaa authentication login default {enable | line | local | none | radius | tacacs} no aaa authentication login

Command Syntax enable line local none radius tacacs enable password command setup to be used as the authentication method line password to be used as the authentication method local database to be used as the authentication method no method is specified as the authentication method RADIUS to be used as the authentication method TACACS+ to be used as the authentication method

1-10

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

aaa authorization commands default
The aaa authorization commands default command enables command authorization on the BSR. Command authorization determines if a user is allowed to run commands at a specified privilege level by creating a default list of methods used for authorization services. The no aaa authorization commands default command disables command authorization.

Group Access
All

Command Mode
Global Configuration

Command Line Usage aaa authorization commands {exec | isp-ro | isp-rw | mso-ro | mso-rw | sysadmin} default {local | none | tacacs} no aaa authentication commands {exec | isp-ro | isp-rw | mso-ro | mso-rw | sysadmin}

Command Syntax exec isp-ro isp-rw mso-ro mso-rw sysadmin local commands in the User EXEC privilege level commands in the ISP Read/Only privilege level commands in the ISP Read/Write privilege level commands in the MSO Read/Only privilege level commands in the MSO Read/Write privilege level commands in the SYSADMIN privilege level local database to be used as the authorization method

Compass ID: 271820115 Version 3

1-11

BSR 64000 Command Reference Guide

Release 5.0.0

none tacacs

no method is specified as the authorization method TACACS+ to be used as the authorization method

1-12

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

aaa authorization exec default
The aaa authorization exec default command enables privilege level authorization on the BSR. Privilege level authorization determines if a user is allowed to run an EXEC shell (user session) by creating a default list of methods used for authorization services. The no aaa authorization exec default command disables privilege level authorization.

Group Access
All

Command Mode
Global Configuration

Command Line Usage aaa authorization exec default {local | none | tacacs} no aaa authorization exec

Command Syntax local none tacacs local database to be used as the authorization method no method is specified as the authorization method TACACS+ to be used as the authorization method

Compass ID: 271820115 Version 3

1-13

BSR 64000 Command Reference Guide

Release 5.0.0

aaa console authentication
The aaa console authentication command enables TACACS authentication for the console if AAA is configured. The no aaa console authentication command disables login authentication for the console.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage aaa console authentication no aaa console authentication

Command Default
Enabled

1-14

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

aaa console authorization commands default
The aaa console authorization commands default command enables command authorization for the console if AAA is configured. The no aaa console authorization commands default command disables command authorization for the console.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage aaa console authorization commands default no aaa console authorization commands default

Command Default
Disabled

Compass ID: 271820115 Version 3

1-15

BSR 64000 Command Reference Guide

Release 5.0.0

aaa new-model
The aaa new model command enables the AAA network security model. The AAA network security model provides a software mechanism or framework for consistent authentication, authorization and accounting on the BSR. The no aaa new model disables the AAA network security model.

Group Access
All

Command Mode
Global Configuration

Command Line Usage aaa new model no aaa new model

Command Default
Disabled

1-16

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

alias
The alias command allows you to specify an alias for a CLI command in a specific command mode (User EXEC, Privileged EXEC, or Global Configuration). The no alias command deletes a specific alias defined within the command mode.

Group Access
All

Command Mode
Global Configuration

Command Line Usage alias {all | exec | priv | conf} no alias {all | exec | priv | conf}

Command Syntax all exec priv conf WORD WORD alias visible in all modes User EXEC mode alias command Privileged EXEC mode alias command Global Configuration mode alias command name of alias the command that is aliased

Compass ID: 271820115 Version 3

1-17

BSR 64000 Command Reference Guide

Release 5.0.0

banner motd
The banner motd command allows you to create a message-of the-day (motd) that displays before the login prompt. The no banner motd command deletes the message of the day.

Group Access
All

Command Mode
Global Configuration

Command Line Usage banner motd [] [... ] no banner motd

Command Syntax
1-25 WORD message line number text of the message

1-18

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

batch
The batch command executes a series of commands from a batch file stored in Flash memory or NVRAM.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage batch {flash: | nvram:} [acknowledge]

Command Syntax flash: nvram: acknowledge execute a batch file from Flash memory execute a batch file from NVRAM acknowledge the execution of each command

Compass ID: 271820115 Version 3

1-19

BSR 64000 Command Reference Guide

Release 5.0.0

boot system
The boot system command lets you boot the BSR using a boot image file stored in either Flash memory, NVRAM on the Supervisory Routing Module (SRM), or an FTP or TFTP server.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage boot system {flash: | nvram:|} {}

Command Syntax flash: nvram: specifies flash memory as the location of the boot image file specifies Non-volatile Random Access Memory (NVRAM) as the location of the boot image file filename of the boot image stored in Flash, NVRAM, or an FTP or TFTP server

filename

1-20

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

broadcast
The broadcast command is used to send a message to all connected users.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage broadcast Command Syntax
WORD The text message intended for broadcast

Compass ID: 271820115 Version 3

1-21

BSR 64000 Command Reference Guide

Release 5.0.0

carriage-return-lf-mode
The carriage-return-lf-mode command controls the order of the carriage return and linefeed sequence. When enabled, the carriage return will be output before the linefeed. When disabled, the linefeed will be output before the carriage return.

Group Access
All

Command Mode
Global Configuration

Command Line Usage carriage-return-lf-mode {disable | enable}

Command Syntax disable enable

disables carriage return then linefeed mode enables carriage return then linefeed mode

Command Default
Disabled

1-22

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

chassis alias
The chassis alias command is used to configure an alias name for the BSR 64000 chassis.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage chassis alias

Command Syntax string the chassis alias name - enclose the alias name within quotation marks if the string contains spaces

Compass ID: 271820115 Version 3

1-23

BSR 64000 Command Reference Guide

Release 5.0.0

chassis assetid
The chassis assetid command is used to configure your organization’s asset ID number that is assigned to the BSR 64000 chassis.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage chassis assetid

Command Syntax string the BSR 64000 chassis asset ID number - enclose the asset ID name within quotation marks if the string contains spaces

1-24

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

chkdsk
The chkdsk command checks for and corrects any file system errors found in files stored in Flash memory or NVRAM.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage chkdsk {flash: | nvram: }

Command Syntax flash: nvram: check the Flash memory file system check the NVRAM filesystem

Compass ID: 271820115 Version 3

1-25

BSR 64000 Command Reference Guide

Release 5.0.0

clear core log
The clear core log command clears the core.log file.

Group Access
All

Command Mode
All mores except for User EXEC

Command Line Usage clear core log

1-26

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

clear evt
The clear evt command resets the event count to "0" for all groups on all slots, groups on a specified slot, a specified group, or specified events.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage clear evt [ | ]

Command Syntax
NUM WORD the chassis slot number the name of an EVT group - refer to Table Table

Compass ID: 271820115 Version 3

1-27

BSR 64000 Command Reference Guide

Release 5.0.0

Table EVT Event Subsystems memchk net ipevt tpt arp rpt im icp evtm evta rmbind rm crmbpi crm crmsub crmfft crmsnr crmutl crmdtm crmcli crmdsg dsgif csm brmtag rsm rdb fpevt spcmgr dgm dqos pcmm em lbgmgr drm drme Memory Check Network IP Event System Testpoint Facility ARP SRM Repeater Interface Manager ICP EVT Manager EVT Agent RM Bind Resource Manager CRM BPI CRM CRM SubMgt CRM FFT CRM SNR CRM Util CRM DOCSTEST CRM CLI CRM DSG DSG Interface Certificate Storage Module BRM VLAN Tagging Redundancy SRM Run Time Database FP EVT Spectrum Manager DQM PacketCable DQOS PacketCable Multimedia PacketCable Event Message Load Balance Manage DOCSIS Redundancy Manager DOCSIS Redundancy Manager Engine drmr DOCSIS Redundancy Manager SRM swr Switched Reload tacacs TACACS+ vrfmgr VRF Manager ipsec IPSEC sys SYS UTIL snmpa SNMP Agent dsgmib SNMP DSG bufmgr Buffer Manager eth8 Ethernet Switch fei FEI srpcmt SRM Reporter CMTS maccfg MAC CFG cmtbuf CMTS Buffer fpga CMTS FPGA bcm Broadcom Driver bcmpkt Broadcam Driver Per Packet frm FRM ard ARD ardpkt ARD PKT que QUE Manager upc Upconverter res RES resrtr RES RTR resaut RES AUTH ressf RES SF resmgr RES MGR lbm Load Balancing lbm2 Load Balancing 2nd Table lbmsnr Load Balacing SNR cms Cable Modem Selector acc ACC accpkt ACC Packet ACC DHCP REG Range Data Path Mapping DOCSIS Redundancy Agent ubsha Upstream Scheduler RTR ubsbst Upstream Scheduler Burst ubsmac UBS CMTS MAC RTR ubs Upstream Scheduler ubsim UBS IM SYNC ubsmap UBS MAP macmr MAC MGR DOCS IF docsif macrtr MACRTR brgtag BRG TAG BRG brg BRG RTR brgrtr Spectrum Agent FFT spafft spasnr Spectrum Agent SNR rssi Spectrum Agent RSSI spasc Spectrum Agent SC ardrtr ARD RTR acctrt ACC RTR btp Boot Uptime mcns MCNS red CMTS Redundancy ICP ucc Upstream Channel Change dcc Dynamic Channel Change dsx Dynamic Service svcflo Service Flow cra CRA cra2 CRA SNR Broadcom 3138 Driver bcm1 bcmmac Broadcom 3212 Driver Preamble pream upcmot Upconverter Motorola accdhc reg range dpm dra

1-28

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

clear log
The clear log command deletes buffered log data.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage clear log

Compass ID: 271820115 Version 3

1-29

BSR 64000 Command Reference Guide

Release 5.0.0

clear redundancy stats
The clear redundancy stats command clears redundancy statistics.

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage clear redundancy stats []

Command Syntax
0-15 the chassis slot number

1-30

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

clock set
The clock set command sets the system clock.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage clock set { | }

Command Syntax hh:mm:ss 1-31 MONTH 1993-2035 current time in 24-hour format numeric notation for the current day three letter abbreviated name of the current month numeric notation for the current year

Compass ID: 271820115 Version 3

1-31

BSR 64000 Command Reference Guide

Release 5.0.0

clock summer-time
The clock summer-time command provides the BSR system administrator with the ability to adjust when the BSR will change the system clock offset for the start and end of daylight saving time. The Energy Policy Act of 2005 (H.R.6.ENR), Section 110 changes the start date of daylight saving time from the first Sunday of April to the second Sunday of March and changes the end date of daylight saving time from the last Sunday of October to the first Sunday of November. Starting in 2007, this new rule may cause the BSR to generate timestamps (such as in syslog messages) that are inaccurate if the time is not adjusted by the administrator or this command. The clock summer-time command changes the BSR clock offset from Greenwich Mean Time at the start and end times specified in the command. The no clock summer-time command restores the default daylight saving time configuration. The following command example sets the correct daylight saving time changes as specified by the Energy Policy Act of 2005: BSR:7A(config:)#clock summer-time EDT 60 start 2 sun mar 2:00 end first sun nov 2:00

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage clock summer-time start {{ | first | last} } end {{ | first | last} } clock summer-time start { } end { } clock summer-time start { } end { } no clock summer-time

1-32

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Note: The clock summer-time command arguments used after the start argument must be mirrored by the command arguments available after the end argument. For example: clock summer-time est 60 start 11 mar 10:30 end 4 nov 03:30 clock summer-time EDT 60 start 2 sun mar 2:00 end first sun nov 2:00

Command Syntax
WORD 1-1440 start 1-31 1-4 MONTH day hh:mm first last end the name of the time zone during daylight savings time minute offset to be added during daylight savings time the start of day light savings time the day of the month the week of the month the month of the year (3 letter abbreviation) the day of the week (3 letter abbreviation) the time of day that daylight savings time starts the first week of the month the last week of the month the end of daylight savings time

Compass ID: 271820115 Version 3

1-33

BSR 64000 Command Reference Guide

Release 5.0.0

clock timezone
The clock timezone command allows you to set the time zone for the system. The no clock timezone command changes the system time to Universal Time Coordinated (UTC).

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage clock timezone [] [daylightsavings] [on | off] no clock timezone Note: The daylightsavings option has no effect on the setting of time on the BSR. It is present only to satisfy a requirement for Packetcable. Packetcable has a field in a network bound event message that must be set to whether or not daylight savings time is in effect. To satisfy this, the user must manually configure this parameter when daylight savings time begins and also when it ends. For automatic setting of the time, the BSR can be configured to obtain its time via SNTP (Simple Network Time Protocol). Since SNTP has no way of indicating whether daylight savings time is in effect, the operator must use the daylightsavings option for compliance with Packetcable.

1-34

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Command Syntax
WORD Hours_offset Minute_offset daylightsavings on | off time zone listed when standard time is in effect hours corrected from UTC, range -23 to 23 non-negative difference in minutes corrected from UTC, range 0 to 59 configure daylight savings daylight savings on or off

Command Default
UTC

Compass ID: 271820115 Version 3

1-35

BSR 64000 Command Reference Guide

Release 5.0.0

configure
The configure command lets you enter Global Configuration mode from Privileged EXEC mode.

Note: To return to Privileged EXEC mode, enter exit, end, or Control-Z at the Global Configuration Mode prompt.

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage configure 1-36

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

console authentication radius
The console authentication radius command enables RADIUS authentication for user console logins. The no console authentication radius command disables this feature.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage console authentication radius [ local-password | username ] no console authentication radius [ local-password | username ]

Command Syntax local-password authenticate with a locally configured password if there is no response from the RADIUS server configure a console username to use for authentication the text of the console username - maximum of 64 characters

username WORD

Compass ID: 271820115 Version 3

1-37

BSR 64000 Command Reference Guide

Release 5.0.0

copy
The copy command copies a local or network file from one location to another, either locally or on the network.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage copy {flash: | ftp: | nvram: | running-config | startup-config | system: | tftp:} | {flash: | nvram: | running-config | startup-config | system:}

Command Syntax flash: ftp: nvram: running-config startup-config system: tftp: copy the configuration file from flash copy the configuration file from a File Transport Protocol (FTP) server copy the configuration file from NVRAM copy from a currently running system configuration copy from the startup configuration in NVRAM copy from the system copy the configuration file from a Trivial File Transport Protocol (TFTP) server copy the configuration file to flash copy the configuration file to a File Transport Protocol (FTP) server

flash: ftp:

1-38

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

nvram: running-config startup-config system: tftp:

copy the configuration file to NVRAM copy to the currently running system configuration copy to the startup configuration in NVRAM copy to the system copy the configuration file to a Trivial File Transport Protocol (TFTP) server

Compass ID: 271820115 Version 3

1-39

BSR 64000 Command Reference Guide

Release 5.0.0

copy core
The copy core command copies an SRM core file to a remote FTP host. This feature provides for effective debugging by allowing a review of the exact state of the BSR prior to a software failure.

Warning: The copy core command is for debugging purposes only and should be used under the guidance of Motorola technical support staff.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage copy core [ [ ftp ]]

Command Syntax

NUM ftp

the slot number of the SRM module copy core file to ftp: filesystem

1-40

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

core
The core command allows a user to configure memory core dump options.

Group Access
All

Command Mode
Global Configuration

Command Line Usage core {compression | path | protocol ftp | server } no core {path | server }

Command Syntax compression 0-9 the core dump compression level - "0" indicates compression is disabled while "9" indicates the maximum compression level the path to the core dump file on a target core dump server the FTP network protocol will be used to transfer core dump files the core dump target server’s IP address or hostname

path WORD protocol ftp server WORD

Compass ID: 271820115 Version 3

1-41

BSR 64000 Command Reference Guide

Release 5.0.0

datapath keepalive
The datapath keepalive command is enabled by default to protect the data path on redundant 2:8 CMTS modules. A CMTS module is reset after 100 datapath ICP keepalive message failures. This threshold may be reconfigured using the threshold argument. The no datapath keepalive command disables this feature.

Group Access
MSO

Command Mode
Slot Configuration

Command Line Usage datapath keepalive {monitor | slot-reset} [threshold ] no datapath keepalive

Command Syntax monitor slot-reset threshold 5-255 monitor the status reset the CMTS module after the threshold of ICP keepalive failures is reached the number of ICP keepalive failures permitted before resetting the CMTS module

Command Default slot-reset threshold = 100

1-42

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

delete
The delete command deletes a file stored in Flash memory or NVRAM or deletes the startup configuration file.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage delete {flash: | nvram: | startup-config}

Command Syntax flash: nvram: startup-config delete all files from Flash memory delete all files from NVRAM delete the startup-configuration file

Compass ID: 271820115 Version 3

1-43

BSR 64000 Command Reference Guide

Release 5.0.0

description
The description command is used to specify descriptive information for any interface on the BSR. This information is limited to 79 characters. Use the characters: _ or - to separate words. For example, if a particular CMTS interface served a certain section of a city, the MSO could assign the following description: MOT:7A(config-if)#description charlestown_1 Note: The entered description can be seen in the running configuration, and in the command output of show commands such as the show ip interface and show running-config commands. You can also use SNMP to view the descriptions. However, if you use SNMP to view the descriptions, be aware that SNMP has a display limit of 63 characters. Descriptions beyond this length will appear truncated when viewed via SNMP.

Command Mode
Interface Configuration (all interface types)

Command Line Usage description [...]

Command Syntax
WORD is the text that describes this interface.

1-44

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

dir
The dir command lists directories and files on a filesystem.

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage dir [all [time]] [flash: [time]] [nvram: [time]] [time]

Command Syntax all flash: nvram: time list all directories and files list all directories and files in flash list all directories and files in NVRAM sort by modification time

Command Default
NVRAM

Compass ID: 271820115 Version 3

1-45

BSR 64000 Command Reference Guide

Release 5.0.0

disable
The disable command allows you to enter User EXEC mode from the Privileged EXEC mode.

Note: To return to Privileged EXEC mode, enter enable at the User EXEC prompt and, if required, a password.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage disable 1-46

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

duplex
The duplex command configures an Ethernet interface for duplex mode (full or half) and enables/disables auto-negotiation

Group Access
ISP

Command Mode Interface Configuration (Ethernet interface only) Command Line Usage duplex {half | full | auto} no duplex {half | full | auto}

Command Syntax half configures the interface for half-duplex operation. Half-duplex operation allows the interface to send and receive signals, but not at the same time. configures the interface for full-duplex operation. Full-duplex operation allows the interface to send and receive signals at the same time. configures the interface to auto negotiate its operational mode (either full-duplex or half-duplex) with the device to which it is physically connected.

full

auto

Command Default
Auto negotiation enabled

Compass ID: 271820115 Version 3

1-47

BSR 64000 Command Reference Guide

Release 5.0.0

enable
The enable command allows you to enter Privileged EXEC mode from User EXEC mode. If the system prompts you for a password, enter the password. After entering Privileged EXEC mode, the prompt changes from the User EXEC mode prompt (hostname>) to the privileged EXEC mode prompt (hostname#).

Group Access
System Administrator

Command Mode
User EXEC

Command Line Usage enable 1-48

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

enable authentication radius
The enable authentication radius command enables RADIUS authentication for user logins. The no enable authentication radius command disables this feature.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage enable authentication radius [ local-password ] no enable authentication radius [ local-password ]

Command Syntax local-password authenticate with a locally configured password if there is no response from the RADIUS server

Compass ID: 271820115 Version 3

1-49

BSR 64000 Command Reference Guide

Release 5.0.0

enable password
The enable password command allows you to specify a password associated with the enable command. After specifying the password, entering the enable command at the User EXEC prompt causes the system to prompt you for the password. You must supply the password to enter the Privileged EXEC mode. The no enable password command deletes the password.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage enable password enable password {0 | 7 } no enable password

Command Syntax
LINE the password (31 character maximum) - enclosed with double quotes if the password contains spaces). The "%" and "!" characters must not be used. specifies an UNENCRYPTED password specifies a HIDDEN password the UNENCRYPTED or HIDDEN 'enable' password

0 7 WORD

1-50

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

enable rdn-process
This enable rdn-process command enables the process for collecting CPU utilization statistics.The no enable rdn-process command disables the collection of CPU utilization statistics.

Note: This feature is enabled by default, and must remain enabled if you intend to use it in conjunction with SNMP polling of the BSR.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage enable rdn-process no enable rdn-process

Command Default enabled Compass ID: 271820115 Version 3

1-51

BSR 64000 Command Reference Guide

Release 5.0.0

enable secret
The enable secret command allows you to provide an encrypted password that supersedes the enabled password. The no enable secret command removes the secret. Use the enable secret command to provide an encrypted password for entering Privileged EXEC mode in the running configuration file when then no service password-encryption command is in effect.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage enable secret [5] no enable secret

Command Syntax
5 WORD specifies an ENCRYPTED secret the secret (31 character maximum) enclosed with double quotes if the secret contains spaces). The "%" and "!" characters must not be used.

1-52

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

encapsulation snap
The encapsulation snap command specifies SNAP as the encapsulation method for Ethernet or Gigabit Ethernet interfaces. The SNAP encapsulation method, as specified in RFC 1042, allows Ethernet protocols to run on the IEEE 802.2 media. The no encapsulation snap command returns the interface encapsulation method to the default method which is ARPA.

Group Access
All

Command Mode
Interface Configuration (Ethernet and Gigabit Ethernet notifies only)

Command Line Usage encapsulation snap no encapsulation snap

Compass ID: 271820115 Version 3

1-53

BSR 64000 Command Reference Guide

Release 5.0.0

erase
The erase command erases a file system stored in Flash memory or NVRAM or the contents of the startup-configuration file.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage erase {flash: | nvram: | startup-config}

Command Syntax flash: nvram: startup-config erase all files in Flash memory erase all files in NVRAM erase the startup-configuration file

1-54

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

exception
The exception command enables the Exception Handler. The Exception Handler is a set of processes that are invoked when errors (exceptions) are caused by another process that is executing when the particular exception occurs. Exceptions can be reported or the BSR can be configured to automatically reboot if an exception occurs.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage exception {extended | reboot }

Command Syntax extended 0-1 perform Extended Exception Reporting: 1 = enable Extended Exception Reporting 0 = disable Extended Exception Reporting reboot on Exception: 1 = enable reboot 0 = disable reboot

reboot 0-1

Compass ID: 271820115 Version 3

1-55

BSR 64000 Command Reference Guide

Release 5.0.0

exit
The exit command (used from the Router Configuration, Interface Configuration, and Global Configuration modes) accesses the previous command mode in the command mode hierarchy. For example: using the exit command in Interface Configuration mode accesses Global Configuration mode. Using the exit command in Privileged EXEC or User EXEC modes, ends the command line session.

Group Access
All

Command Mode
All modes

Command Line Usage exit 1-56

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

forced-download
The forced-download command ensures that boot images are properly downloaded to modules in the BSR 64000 chassis. Use the forced-download command to ensure that all modules receive the correct boot image before performing an upgrade process or to ensure that a specific module receives the correct boot image before performing an upgrade process.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage forced-download [] no forced-download []

Command Syntax
0-15 BSR 64000 slot number

Compass ID: 271820115 Version 3

1-57

BSR 64000 Command Reference Guide

Release 5.0.0

format
The format command formats a filesystem in flash or NVRAM.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage format {flash: | nvram:}

Command Syntax flash: nvram: format flash format NVRAM

1-58

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

help
The help command displays instructions for using the CLI help functionality. Refer to the BSR 64000 Configuration and Management Guide for additional instructions on using the CLI help functionality.

Group Access
All

Command Mode
All modes

Command Line Usage help Compass ID: 271820115 Version 3

1-59

BSR 64000 Command Reference Guide

Release 5.0.0

history size
The history command enable and controls the command history function. The history size command lets you specify the size of the history buffer by number of lines. The no history command deletes the history buffer.

Group Access
All

Command Mode
All modes

Command Line Usage history [size ] no history

Command Syntax
1-256 the number of lines in the history buffer

Command Default
10

1-60

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

hostname
The hostname command configures the name for the system host.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage hostname Command Syntax
WORD the system’s alphanumeric network hostname

Compass ID: 271820115 Version 3

1-61

BSR 64000 Command Reference Guide

Release 5.0.0

hsim4 slot
The hsim4 slot command sets the mode in which the Ether-Flex module operates. If this command is not configured for a given slot, the default is for the module to operate in Gigabit Ethernet mode. Once this command is used, you must reset the configured slot for the module to operate in the newly selected mode. As a reminder, each time you use this command, the following warning message displays on the console:
%Warning: You must reset slot in order for the configuration to take effect.

Group Access
All

Command Mode
Global Configuration

Command Line Usage hsim4 slot {gigaether | ethernet}

Command Syntax

0-5, 9-15

The slot number of the Ether-Flex module. Ether-Flex modules cannot be installed in slots 6, 7 and 8. Gigabit Ethernet mode Ethernet mode

gigaether ethernet

1-62

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

icp keepalive
The icp keepalive command allows you to set the threshold for missed ICP keepalives after which the SRM module will be reset. The icp keepalive command also configures console or system logging of event messages related to missed ICP keepalives. The Resource Manager (RM) software component of the SRM module sends an ICP “SRM_READY” message as a poll every 2.5 seconds to all modules in the BSR chassis. If any module fails to respond after 10 “SRM_READY” messages (25 seconds), the SRM generates an “RM.35” log message and the module is reset.

Group Access
All

Command Mode
Global Configuration

Command Line Usage icp keepalive { debug | monitor | slot-reset} [threshold ] no icp keepalive [ debug | monitor | slot-reset] [threshold ]

Command Syntax debug enables the display of ICP keepalive log reports to the SRM console enables the display of ICP keepalive log reports to the system logger the number of missed ICP keepalive responses after which the SRM will reset the slot.

monitor

slot-reset

Compass ID: 271820115 Version 3

1-63

BSR 64000 Command Reference Guide

Release 5.0.0

threshold

configures number of ICP keepalive retransmits until an action is taken restores the default threshold value for the no icp keepalive debug, monitor, and slot-reset commands

threshold

Command Defaults

icp keepalive debug icp keepalive monitor icp keepalive slot-reset icp keepalive debug threshold icp keepalive monitor threshold icp keepalive slot-reset threshold

Disabled Disabled Disabled 10 messages 10 messages 10 messages

1-64

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

ip ftp password
The ip ftp password command displays the password to use to connect to the network using FTP. The no ip ftp password command deletes the password for an FTP connection.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage ip ftp password {0 | 7 | } no ip ftp password

Command Syntax
0 7 LINE specifies an unencrypted password will follow specifies a hidden password will follow the password (31 character minimum, 78 character maximum for option 7) - enclosed with double quotes if the password contains spaces). The "%" and "!" characters must not be used.

Compass ID: 271820115 Version 3

1-65

BSR 64000 Command Reference Guide

Release 5.0.0

ip ftp username
The ip ftp username command configures the connection to the network for using FTP. The no ip ftp username command configures the router anonymously for FTP. Use the ip ftp username command that is related to an account on the server.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage ip ftp username no ip ftp username

Command Syntax
WORD username (31 character maximum)

1-66

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

ip netmask-format
The ip netmask-format command lets you specify the format in which netmask values appear in show command output. The no ip netmask format command sets the output format back to the default.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ip netmask-format {bit-count | decimal | hexadecimal} no ip netmask-format {bit-count | decimal | hexadecimal}

Command Syntax bit-count decimal hexadecimal displays netmask as number of significant bits displays netmask in dotted decimal displays the netmask in hexadecimal

Command Default bitcount Compass ID: 271820115 Version 3

1-67

BSR 64000 Command Reference Guide

Release 5.0.0

ip tacacs source-interface
The ip tacacs source-interface command allows an operator to control the source IP address of TACACS+ packets generated by the BSR by specifying an Ethernet or loopback interface as the source IP address for TACACS+ packets. The normal convention for generated TACACS+ packets is to set the source IP address equal to the IP address of the outgoing interface. The ip tacacs source-interface command overrides this convention and instead uses the IP address of a specified Ethernet or loopback interface. This command facilitates the use of one IP address entry associated with the TACACS+ client instead of maintaining a list of all IP addresses and is useful in cases where the a router has many interfaces and an operator wants to ensure that all TACACS+ packets from a particular router have the same IP address. The no ip tacacs source-interface command removes the specified source interface. Note: Before using the ip tacacs source-interface command, the interface must be configured, assigned an IP address, and up and running. Any configuration change with this command will not take effect until after the next BSR connection attempt.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage ip tacacs source-interface {ethernet | loopback } no ip tacacs source-interface

Command Syntax ethernet X/Y loopback 1-255 the Ethernet interface slot and port number the loopback interface number

1-68

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

ip tftp source-interface loopback
The ip tftp source-interface loopback command allows an operator to control the source IP address of TFTP packets generated by the BSR by specifying a loopback interface as the source IP address for TFTP packets. The normal convention for generated TFTP packets is to set the source IP address equal to the IP address of the outgoing interface. The ip tftp source-interface loopback command overrides this convention and instead uses the IP address of the specified loopback interface. The no ip tftp source-interface loopback command removes the loopback source interface.

Note: Before using the ip tftp source-interface loopback command, the loopback interface must be configured and assigned an IP address.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage ip tftp source-interface loopback no ip tftp source-interface loopback

Command Syntax
1-255 the loopback interface number

Compass ID: 271820115 Version 3

1-69

BSR 64000 Command Reference Guide

Release 5.0.0

ldap client
The ldap client command enables the LDAP client. The no ldap client command disables the LDAP client.

Note: Configure a primary or secondary LDAP server addresses before enabling the LDAP client.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage ldap client no ldap client

1-70

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

ldap search-base
The ldap search-base command specifies the base distinguished name of the starting point for a search of the LDAP database. The no ldap search-base ends the search of the LDAP database.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage ldap search-base WORD no ldap search-base WORD

Command Syntax
WORD Distinguished name of entry to where the search will start

Compass ID: 271820115 Version 3

1-71

BSR 64000 Command Reference Guide

Release 5.0.0

ldap server
The ldap server command configures LDAP server parameters. The no ldap server command clears the LDAP server parameters.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage ldap server { [binddn ] [nobinddn] [nopassword] [password } no ldap server

Command Syntax
WORD binddn WORD nobinddn nopassword password WORD the primary LDAP server distinguished name distinguished name not required to bind to this server password not required password

1-72

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

load-interval
The load-interval command specifies the load interval timer value in minutes. The load interval timer captures bandwidth utilization information on a per-port basis for both received and transmitted data. Bandwidth utilization information can then be displayed with the show interfaces command. The following is typical load interval information as displayed with the show interfaces command:

Cable2/0 is up, line protocol is up Hardware is BCM3210 ASIC, address is 0030.7b74.3238 (bia 0030.7b74.3238) Internet address is 10.10.128.1/17 MTU 1500 bytes, BW 27000 Kbit, DLY 1000 usec, reliability 255/255, txload 1/255, rxload 20/255 Encapsulation MCNS, loopback not set Keepalive not set ARP type: ARPA, ARP Timeout 04:00:00 Last input 00:00:00, output 00:00:00, output hang never Last clearing of "show interface" counters never Queueing strategy: fifo Output queue 0/40, 69 drops; input queue 0/75, 7 drops 5 minute input rate 2202000 bits/sec, 416 packets/sec Load Interval 5 minute output rate 120000 bits/sec, 13 packets/sec Bandwidth Utilization 1125177443 packets input, 14081732 bytes, 25 no buffer Information Received 3125750 broadcasts, 0 runts, 0 giants, 0 throttles 1018 input errors, 87 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort 25006326 packets output, 1183354279 bytes, 0 underruns 0 output errors, 0 collisions, 4 interface resets 0 output buffer failures, 0 output buffers swapped out

Group Access
All

Command Mode
Interface Configuration

Command Line Usage load-interval Compass ID: 271820115 Version 3

1-73

BSR 64000 Command Reference Guide

Release 5.0.0

Command Syntax
1-300 the load interval timer value in minutes

Command Default
5 minutes

1-74

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

logging
The logging command specifies the IP address of a remote SYSLOG server. The no logging command clears the IP address specification of a remote SYSLOG server.

Group Access
All

Command Mode
Global Configuration

Command Line Usage logging no logging

Command Syntax
A.B.C.D. SYSLOG server IP address - up to 8 SYSLOG servers can be specified

Compass ID: 271820115 Version 3

1-75

BSR 64000 Command Reference Guide

Release 5.0.0

logging admin-status
The logging admin-status command controls the transmission of traps and SYSLOG messages with respect to the threshold specified with the logging rate-limit command. The logging admin-status command is only relevant if DOCSIS logging control has been specified with the logging control docsis command. In CLI logging control mode, the logging admin-status command will be ignored by the system and a warning message will display if it is used. In this mode, only the logging rate-limit command is relevant. In DOCSIS logging control mode, both the logging admin-status and logging rate-limit commands are needed to specify throttling. Note: An event is always treated as a single event for threshold counting. For example: an event causing both a trap and a SYSLOG message is still treated as a one event.

Command Line Usage logging admin-status {inhibited | maintainBelowThreshold | stopAtThres | unconstrained} no logging admin-status {inhibited | maintainBelowThreshold | stopAtThres | unconstrained}

Command Syntax inhibited causes all trap transmission and SYSLOG messages to be suppressed - if a threshold has been specified with the logging rate-limit command, a warning message will be displayed causes trap transmission and SYSLOG messages to be suppressed if the number of traps/messages would exceed the threshold specified with the logging rate-limit command

maintainBelowThreshold

1-76

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

stopAtThres

causes trap transmission SYSLOG messages to cease at the threshold specified with the logging rate-limit command - transmission will not resume until the logging admin-status command is reset to an option other than "stopAtThres" or the threshold is set to a higher value causes all traps and SYSLOG messages to be transmitted - if a threshold has been specified with the logging rate-limit command, a warning message will be displayed

unconstrained

Compass ID: 271820115 Version 3

1-77

BSR 64000 Command Reference Guide

Release 5.0.0

logging buffered
The logging buffered command sets the size of the logging buffer and the severity level. The no logging buffered command returns to the default buffer size (256 KB).

Note: Use the show log command, in Privileged EXEC mode, to display logged messages with the newest message displayed first.

Group Access
All

Command Mode
Global Configuration

Command Line Usage logging buffered [alerts | critical | emergencies | errors | informational | notifications | warnings] no logging buffered [alerts | critical | emergencies | errors | informational | notifications | warnings]

Command Syntax
4096 -16777216 logging buffer size in bytes

Severity Levels and Descriptions emergencies emergency conditions where the system is unusable - reserved for vendor-specific, fatal hardware or software errors that prevents normal system operation and causes reporting system to reboot (severity level = 0) conditions where immediate action is needed - a serious failure which causes the reporting system to reboot but is not caused by hardware or software malfunctioning (severity level = 1)

alert

1-78

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

critical

critical conditions - a serious failure that requires immediate attention and prevents the device from transmitting data but the system could recover without rebooting (severity level = 2) error conditions - a failure occurred that could interrupt the normal data flow (severity level = 3) warning conditions - a failure occurred that could interrupt the normal data flow (severity level = 4) normal but significant conditions - an event of importance occurred which is not a failure (severity level = 5) informational descriptive system messages an unimportant event, which could be helpful for tracing normal operations (severity level = 6)

error

warnings

notifications

information

Command Default notifications, log file is 256 Kbytes

Compass ID: 271820115 Version 3

1-79

BSR 64000 Command Reference Guide

Release 5.0.0

logging console
The logging console command enables the sending of system logging messages to the console. Additionally, the logging of messages displayed on the console terminal can be limited to a specified severity level. Use the no logging console command to disable console logging.

Group Access
All

Command Mode
Global Configuration

Command Line Usage logging console [alerts | critical | debugging | emergencies | errors | informational | notifications | warnings] no [alerts | critical | debugging | emergencies | errors | informational | notifications | warnings]

Command Syntax

Severity Levels and Descriptions emergencies emergency conditions where the system is unusable - reserved for vendor-specific, fatal hardware or software errors that prevents normal system operation and causes reporting system to reboot (severity level = 0) conditions where immediate action is needed - a serious failure which causes the reporting system to reboot but is not caused by hardware or software malfunctioning (severity level = 1)

alert

1-80

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

critical

critical conditions - a serious failure that requires immediate attention and prevents the device from transmitting data but the system could recover without rebooting (severity level = 2) error conditions - a failure occurred that could interrupt the normal data flow (severity level = 3) warning conditions - a failure occurred that could interrupt the normal data flow (severity level = 4) normal but significant conditions - an event of importance occurred which is not a failure (severity level = 5) informational descriptive system messages an unimportant event, which could be helpful for tracing normal operations (severity level = 6)

error

warnings

notifications

information

Command Default notifications Compass ID: 271820115 Version 3

1-81

BSR 64000 Command Reference Guide

Release 5.0.0

logging control docsis
The logging control docsis command allows the DOCSIS docsDevEvControlTable to determine which severity logs go to which destinations.

Note: Any of the various logging commands in place are overridden with this command.

The no logging control docsis disables the docsDevEvControlTable and re-establishes CLI logging control. Any configurations previously set with the logging command will now control which severity logs go to which destinations.

Group Access
All

Command Mode
Global Configuration

Command Line Usage logging control docsis no logging control docsis

Command Default no logging control docsis

1-82

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

logging default
The logging default command restores the default settings for all logging, including logging , logging reporting, and EVT configurations.
■ ■ ■

The docsDevEvControlTable is restored to its DOCSIS-specified default values. CLI logging control is re-established. All logging evt configuration lines are removed from the running configuration file. Any logging (for SYSLOG server) commands are unaffected. The logging rate-limit command is unaffected. The logging buffered command is restored to its default size. The command restores the following entries to the running configuration file: no logging control docsis logging buffered notifications logging console error no logging trap no logging snmp-trap logging facility local7

■ ■ ■ ■

Group Access
All

Command Mode
Global Configuration

Command Line Usage logging default

Compass ID: 271820115 Version 3

1-83

BSR 64000 Command Reference Guide

Release 5.0.0

logging disable bpi_auth_invalid_messages
The logging disable bpi_auth_invalid_messages command disables logging of the "BPI authorization invalid" DOCSIS error message. The no logging disable bpi_auth_invalid_messages command enables the logging of this error message. This command is useful in situations where a high volume of this error message is being generated and logged.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage logging disable bpi_auth_invalid_messages no logging disable bpi_auth_invalid_message

Command Default
Logging of BPI authorization invalid messages is enabled by default.

1-84

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

logging disable bpi_auth_reject_messages
The logging disable bpi_auth_reject_messages command disables logging of the "BPI authorization reject" DOCSIS error message. The no logging disable bpi_auth_reject_messages command enables the logging of this error message. This command is useful in situations where a high volume of this error message is being generated and logged.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage logging disable bpi_auth_reject_messages no logging disable bpi_auth_reject_messages

Command Default
Logging of BPI authorization reject messages is enabled by default.

Compass ID: 271820115 Version 3

1-85

BSR 64000 Command Reference Guide

Release 5.0.0

logging disable bpi_map_reject_messages
The logging disable bpi_map_reject_messages command suppresses Map Reject DOCSIS error messages being printed to the console but the error messages will still be logged through the EVT system. The no logging disable bpi_map_reject_messages command enables the console printing of Map Reject error messages. This command is useful in situations where large numbers of these error messages are being generated.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage logging disable bpi_map_reject_messages no logging disable bpi_map_reject_messages

Command Default
Logging of Map Reject messages is disabled by default.

1-86

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

logging disable bpi_tek_invalid_messages
The logging disable bpi_tek_invalid_messages command disables logging of the "BPI TEK Invalid" DOCSIS error message. The no logging disable bpi_auth_reject_messages command enables the logging of this error message. This command is useful in situations where a high volume of this error message is being generated and logged.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage logging disable bpi_tek_invalid_messages no logging disable bpi_tek_invalid_messages

Command Default
Logging of BPI TEK Invalid messages is enabled by default.

Compass ID: 271820115 Version 3

1-87

BSR 64000 Command Reference Guide

Release 5.0.0

logging disable cm_ranging_fail_r103_0
The logging disable cm_ranging_fail_r103_0 command disables logging of the "Unable to Successfully Range CM Retries Exhausted" DOCSIS error message. The no logging disable cm_ranging_fail_r103_0 command enables the logging of this error message. This command is useful in situations where a high volume of this error message is being generated and logged.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage logging disable cm_ranging_fail_r103_0 no logging disable cm_ranging_fail_r103_0

Command Default
Logging of these error messages is enabled by default.

1-88

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

logging evt clear
The logging evt clear command disables logging of all EVTs or disables EVT logging for a specific logging destination (s). The no logging evt clear command restores the default EVT logging configuration.

Group Access
All

Command Mode
Global Configuration

Command Line Usage logging evt clear {l|t|s|c} {} [] no logging evt clear {l|t|s|c} {} []

Command Syntax l|t|s|c the log message destination: l = local t = trap s = SYSLOG c = console the chassis slot number the name of an EVT group specific EVTs in the specified EVT group such as '1+5+8-13'

slot group range

Compass ID: 271820115 Version 3

1-89

BSR 64000 Command Reference Guide

Release 5.0.0

logging evt set
The logging evt set command configures EVT logging to log messages to a different destination. The EVT messages logged can also be configured on a per-slot, per group, or single, per-event basis. The no logging evt set command with no specified EVT group name restores the original logging configuration changed with one or more logging evt set commands.

Command Line Usage logging evt set {l|t|s|c} {} [] no logging evt set {l|t|s|c} {} []

Command Syntax l|t|s|c the log message destination: l = local t = trap s = SYSLOG c = console the chassis slot number the name of an EVT group specific EVTs in the specified EVT group such as '1+5+8-13'

slot group range

1-90

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

logging facility
The logging facility command specifies the SYSLOG facility to which error messages are sent. The no logging facility command reverts to the default of "local7".

Group Access
All

Command Mode
Global Configuration

Command Line Usage logging facility {local 0 | local 1 | local 2 | local 3 | local 4 | local 5 | local 6 | local 7} no logging facility

Command Syntax local 0-7 local facility 0 through 7

Command Default local 7

Compass ID: 271820115 Version 3

1-91

BSR 64000 Command Reference Guide

Release 5.0.0

logging on
The logging on command starts and stops the SYSLOG, and sends debug and error messages to a logging process. The no logging on command stops sending debug or error messages to a logging process.

Group Access
All

Command Mode
Global Configuration

Command Line Usage logging on no logging on

Command Default
Disabled

1-92

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

logging rate-limit
The logging rate-limit command limits the rate of system messages and SNMP traps logged per second. The no logging rate-limit command disables the rate limit.

Group Access
All

Command Mode
Global Configuration

Command Line Usage logging rate-limit no logging rate-limit

Command Syntax
0-2147483647 1-2147483647 the number of logged messages the rate of messages logged per second

Compass ID: 271820115 Version 3

1-93

BSR 64000 Command Reference Guide

Release 5.0.0

logging reporting
The logging reporting command specifies the recording mechanism for logging reports.

Group Access
All

Command Mode
Global Configuration

Command Line Usage logging reporting {alert | critical | debug | default | emergency | error | information | notice | warning} {all-clear | all-set | local | local-syslog | local-trap | local-trap-syslog} no logging reporting {alert | critical | debug | default | emergency | error | information | notice | warning} {all-clear | all-set | local | local-syslog | local-trap | local-trap-syslog}

Command Syntax

Severity Levels and Descriptions emergency emergency conditions where the system is unusable - reserved for vendor-specific, fatal hardware or software errors that prevents normal system operation and causes reporting system to reboot (severity level = 0) conditions where immediate action is needed - a serious failure which causes the reporting system to reboot but is not caused by hardware or software

alert

malfunctioning
(severity level = 1)

1-94

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

critical

critical conditions - a serious failure that requires immediate attention and prevents the device from transmitting data but the system could recover without rebooting (severity level = 2) error conditions - a failure occurred that could interrupt the normal data flow (severity level = 3) warning conditions - a failure occurred that could interrupt the normal data flow (severity level = 4) normal but significant conditions - an event of importance occurred which is not a failure (severity level = 5) informational descriptive system messages - an unimportant event, which could be helpful for tracing normal operations (severity level = 6) debugging messages (severity level = 7) set all the severity levels to default

error

warnings

notice

information

debug default

Logging Location Options local local-syslog local-trap log messages to local-nonvolatile memory (NVRAM) log messages to local NVRAM and the SYSLOG server log messages, excluding the specified trap level, to local NVRAM

local-trap-syslog log messages, excluding the specified trap level, to local NVRAM and a SYSLOG server

Compass ID: 271820115 Version 3

1-95

BSR 64000 Command Reference Guide

Release 5.0.0

all-clear all-set

unsets all logging locations for the report. sets all logging locations for the report.

Note: Debug messages will not be reported unless debugging has been turned on for a subsystem with the corresponding CLI debug command (e.g. debug snmp).

1-96

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

logging reporting default
The logging reporting default command is used to return to the default destination/ severity log reporting configuration.

Note: The default destination/severity log reporting configuration depends on which logging control mode is enabled.

Group Access
All

Command Mode
Global Configuration

Command Line Usage logging reporting default

Compass ID: 271820115 Version 3

1-97

BSR 64000 Command Reference Guide

Release 5.0.0

logging session
The logging session command enables the transmission of system logging messages to the current login session. The no logging session command disables the transmission of system logging messages to the current login session.

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage logging session no logging session

1-98

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

logging snmp-trap
The logging snmp-trap command logs all SNMP traps or logs SNMP traps of a specified severity level and higher. Note: The logging snmp-trap command limits SNMP trap logging to SNMP traps with a level up to and including the severity level specified with this command.

Group Access
All

Command Mode
Global Configuration

Command Line Usage logging snmp-trap [alerts | critical | emergencies | errors | informational | notifications | warnings] no logging snmp-trap [alerts | critical | emergencies | errors | informational | notifications | warnings]

Command Syntax

Severity Levels and Descriptions emergencies emergency conditions where the system is unusable reserved for vendor-specific, fatal hardware or software errors that prevents normal system operation and causes reporting system to reboot (severity level = 0) conditions where immediate action is needed - a serious failure which causes the reporting system to reboot but is not caused by hardware or software malfunctioning (severity level = 1)

alert

Compass ID: 271820115 Version 3

1-99

BSR 64000 Command Reference Guide

Release 5.0.0

critical

critical conditions - a serious failure that requires immediate attention and prevents the device from transmitting data but the system could recover without rebooting (severity level = 2) error conditions - a failure occurred that could interrupt the normal data flow (severity level = 3) warning conditions - a failure occurred that could interrupt the normal data flow (severity level = 4) normal but significant conditions - an event of importance occurred which is not a failure (severity level = 5) informational descriptive system messages - an unimportant event, which could be helpful for tracing normal operations (severity level = 6)

error warnings

notifications

information

1-100

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

logging source-interface loopback
The logging source-interface loopback command allows an operator to control the source IP address of SYSLOG packets generated by the BSR by specifying a loopback interface as the source IP address for SYSLOG packets. The normal convention for generated SYSLOG packets is to set the source IP address equal to the IP address of the outgoing interface. The logging source-interface loopback command overrides this convention and instead uses the IP address of the specified loopback interface.

Note: Before using the logging source-interface loopback command, the loopback interface must be configured and assigned an IP address.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage logging source-interface loopback

Command Syntax
1-255 the loopback interface number

Compass ID: 271820115 Version 3

1-101

BSR 64000 Command Reference Guide

Release 5.0.0

logging trap
The logging trap command filters messages logged to the SYSLOG servers based on severity. The command limits the log messages sent to a SYSLOG server to messages with a severity level up to and including the severity level specified with this command. The no logging trap command disables the logging of these messages to the SYSLOG servers.

Group Access
All

Command Mode
Global Configuration

Command Line Usage logging trap {alerts | critical | emergencies | errors | informational | notifications | warnings} no logging trap {alerts | critical | emergencies | errors | informational | notifications | warnings}

Command Syntax

Severity Levels and Descriptions emergencies emergency conditions where the system is unusable - reserved for vendor-specific, fatal hardware or software errors that prevents normal system operation and causes reporting system to reboot (severity level = 0) conditions where immediate action is needed - a serious failure which causes the reporting system to reboot but is not caused by hardware or software malfunctioning (severity level = 1)

alert

1-102

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

critical

critical conditions - a serious failure that requires immediate attention and prevents the device from transmitting data but the system could recover without rebooting (severity level = 2) error conditions - a failure occurred that could interrupt the normal data flow (severity level = 3) warning conditions - a failure occurred that could interrupt the normal data flow (severity level = 4) normal but significant conditions - an event of importance occurred which is not a failure (severity level = 5) informational descriptive system messages an unimportant event, which could be helpful for tracing normal operations (severity level = 6)

error

warnings

notifications

information

Command Default notifications level (severity=5)

Compass ID: 271820115 Version 3

1-103

BSR 64000 Command Reference Guide

Release 5.0.0

login
The login command logs a user on to the system.

Group Access
All

Command Mode
User EXEC

Command Line Usage login []

Command Syntax
WORD 1 to 16 character username

1-104

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

logout
The logout command logs a user out of the system. Use the logout command to end the current session. The logout command is used the same way as the exit command. In Privileged EXEC mode, use the logout command with a character argument to log a particular user out of the system. Only users with administrative privileges can log other users out.

Group Access
All

Command Mode
User EXEC and Privileged EXEC

Command Line Usage logout [ | ] (Privileged EXEC mode only) logout (User EXEC mode only)

Command Syntax session-id username the session ID number of the user to log out the name of the user to log out

Compass ID: 271820115 Version 3

1-105

BSR 64000 Command Reference Guide

Release 5.0.0

macro
The macro command defines a group of existing CLI commands that can be executed by entering the macro name at the command line. The no macro command removes a macro from the macro list.

Group Access
All

Command Mode
All modes except User EXEC and Privileged EXEC

Command Line Usage macro {Variable | } ... [Variable | ]}} no macro

Command Syntax
WORD Variable WORD the macro name macro variables the CLI commands - CLI commands must be added one at a time

1-106

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

memory checkzero
The memory checkzero command enables memory checking on the BSR.

Note: Memory checking can use considerable BSR system resources.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage memory checkzero

Command Syntax
0-1 1 = enable Memory Checking 0 = disable Memory Checking

Compass ID: 271820115 Version 3

1-107

BSR 64000 Command Reference Guide

Release 5.0.0

message
The message command sends a message to a specified active user.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage message Command Syntax
WORD WORD session number or username message to send

1-108

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

network-clock-select
The network-clock-select command configures network timing parameters. The no network-clock-select command disables network timing parameters.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage network-clock-select {1 | 2 } {bits | pos } {e1 {pcm31-crc | pcm31-hdb3 | pcm31-nocrc} | t1 {esf-b8zs | sf-d4 | slc96 | t1dm }} {a | b} no network-clock-select {1 | 2 } {bits | pos } {e1 {pcm31-crc | pcm31-hdb3 | pcm31-nocrc} | t1 {esf-b8zs | sf-d4 | slc96 | t1dm }} {a | b}

Command Syntax
1 2 bits pos e1 pcm31-crc pcm31-hdb3 pcm31-nocrc a b primary priority secondary priority E1/T1 BITS clock BSR POS interface slot and port configure interface as E1 PCM-31 framing with AMI line coding, CRC Multiframe PCM-31 framing with HDB3 line coding, CRC Multiframe PCM-31 framing with AMI line coding, No CRC Multiframe select port A select port B

Compass ID: 271820115 Version 3

1-109

BSR 64000 Command Reference Guide

Release 5.0.0

t1 esf-b8zs sf-d4 slc96 t1dm

configure interface as T1 ESF framing with B8ZS line coding SF-D4 framing with AMI line coding SLC96 framing with AMI line coding T1DM framing with AMI line coding

1-110

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

network-clock-select revertive
The network-clock-select revertive command enables revertive mode. The no network-clock-select revertive command disables revertive mode. Revertive mode enables the automatic switch-over to the highest priority clock source available if the current clock goes offline Note: In order for revertive mode to work properly, you must configure both the primary and secondary clock sources. If there are no clock sources configured, the Stratum 3 module on the SRM will remain in free-running mode.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage network-clock-select revertive no network-clock-select revertive

Compass ID: 271820115 Version 3

1-111

BSR 64000 Command Reference Guide

Release 5.0.0

more
The more command displays the contents of a specified file. Use the more nvram:startup-config command to view the startup configuration file in NVRAM. The config_file environmental table will be displayed if the startup configuration file is not displayed. The user can determine the status of the file which is either a complete or a distilled version of the configuration file. Use the more system:running-config command to view the running configuration file. The more system:running-config command displays the version of the software and any changes that were previously made.

Note: You can use the more command to view files on remote systems.

Group Access
System Administrator

Command Mode
All modes except User EXEC

Command Line Usage more {flash: | ftp: | nvram: | nvram:startup-config | startup-config | system:startup-config } [ | {begin | exclude | include} {} | {count | count-only}] more {flash: | ftp: | nvram: | nvram:startup-config | startup-config | system:startup-config } [ | {count | count-only}]

Command Syntax filename | begin file name turns on output modifiers (filters) filter for output that begins with the specified string

1-112

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

exclude include WORD count count-only

filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-113

BSR 64000 Command Reference Guide

Release 5.0.0

page
The page command controls the scrolling of system output displays.

Group Access
All

Command Mode
All modes

Command Line Usage page {off | on}

Command Syntax off on scrolling continues until the end of the display without stopping controlled scrolling through the use of the Enter/Return key and spacebar

Command Default on 1-114

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

password
The password command establishes a password that must be specified by users attempting to establish a console or telnet session with the BSR. A console or telnet session will not be established if the correct password is not specified by the user. The no password command removes the password.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage password {console | telnet}[0 | 7] no password {console | telnet}

Command Syntax console telnet 0 7 WORD password for console connections password for telnet connections specifies an UNENCRYPTED password specifies a HIDDEN password the password (31 character maximum, 78 character maximum for option 7) - enclosed with double quotes if the key contains spaces). The "%" and "!" characters must not be used.

Compass ID: 271820115 Version 3

1-115

BSR 64000 Command Reference Guide

Release 5.0.0

privilege restricted
The privilege restricted command designates a specific CLI command or group of commands as belonging to the "restricted" user group. Only users in the "restricted" user group have read-write access to commands designated as "restricted". Note: By default, users in the "restricted" user group will not be able to execute any commands unless they have been specified as "restricted" with the privilege restricted command.

Group Access
All

Command Mode
Global Configuration

Command Line Usage privilege restricted { [] | all} no privilege { [] | all}

Command Syntax
WORD the command whose privilege level is to be changed to "restricted" - multiple commands can be specified separated by spaces changes the privilege level to "restricted" for all of the sub-options of a given command

all

1-116

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

radius-server
The radius-server command configures a RADIUS client to allow communication with a RADIUS server. Configuring a RADIUS client involves the following tasks:
■ ■

specifying the RADIUS server defining the shared encryption key for authentication between the RADIUS server and the RADIUS client specifying the number of retry attempts if there is no response from an active RADIUS server specifying the time interval between retry attempts if there is no response from from an active RADIUS server

■

■

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage radius-server host {|} [auth-port [primary]] radius-server key radius-server retransmit radius-server timeout no radius-server host {|} [auth-port] no radius-server key no radius-server retransmit no radius-server timeout

Command Syntax host A.B.C.D specifies a RADIUS server the IP address of the RADIUS server

Compass ID: 271820115 Version 3

1-117

BSR 64000 Command Reference Guide

Release 5.0.0

Hostname auth-port 0-65535 primary key WORD

the hostname of the RADIUS server specify a UDP port number for RADIUS authentication - default port number is 1812 select this server as the primary RADIUS server text of the encryption key shared between the RADIUS client and the RADIUS servers Motorola recommends a 22 character minimum specify the number of retry attempts if there is no response from an active RADIUS server default is 3 retries specify the time interval in seconds between retry attempts if there is no response from from an active RADIUS server - default is 5 seconds

retransmit 0-100

timeout 1-1000

1-118

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

radius-server source-interface loopback
The radius-server source-interface loopback command allows an operator to control the source IP address of Radius authentication protocol packets generated by the BSR by specifying a loopback interface as the source IP address for Radius authentication protocol packets. The normal convention for generated Radius authentication protocol packets is to set the source IP address equal to the IP address of the outgoing interface. The radius-server source-interface loopback command overrides this convention and instead uses the IP address of the specified loopback interface. The no radius-server source-interface loopback command removes the loopback source interface. Note: Before using the radius-server source-interface loopback command, the loopback interface must be configured and assigned an IP address.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage radius-server source-interface loopback no radius-server source-interface loopback

Command Syntax
1-255 the loopback interface number

Compass ID: 271820115 Version 3

1-119

BSR 64000 Command Reference Guide

Release 5.0.0

redundancy cmts
The redundancy cmts command enables CMTS redundancy protection for a primary CMTS. The slot number of the primary CMTS must be in the range 0..5 or 9..14. Slot 15 may not be used for CMTS redundancy. The no redundancy cmts command disables CMTS redundancy protection for a slot.The slot number must be a primary slot number in the range 0..5 or 9..14. By default, redundancy is automatically enabled for all installed CMTS modules. Note: It is important to save any configuration changes made to a primary CMTS interface in the running configuration to the startup configuration with the copy running-config startup-config command. This ensures that any configuration changes are guaranteed to be maintained when a Primary CMTS Module switches over service to the Standby CMTS Module or the Standby CMTS Module gives back service to a Primary CMTS Module. If a CPE that is statically configured with an IP address instead of obtaining and IP address via DHCP registers on an active CMTS card, then a switchover occurs, the arp entry will not be deleted if the CM de-registers. If the CM attempts to re-register, the CPE will not pass data until the arp timeout expires.

Group Access
All

Command Mode
Global Configuration

Command Line Usage redundancy cmts no redundancy cmts

Command Syntax
NUM the BSR 64000 CMTS slot number

1-120

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Command Default redundancy enabled

Compass ID: 271820115 Version 3

1-121

BSR 64000 Command Reference Guide

Release 5.0.0

redundancy force-switchover cmts
The redundancy force-switchover cmts command forces a CMTS to switchover to the CMTS that provides redundancy for it. For a primary slot in the range 0..5, 9..14, the spare CMTS in slot 6 takes over. For slot 6, the spare CMTS gives back operation to whatever primary CMTS for which it was operating. Note: After the first administrative (manual) switchover you perform for BSR 64000 systems employing Redundant SRMs, Redundant CMTS modules, or both; wait a minimum of 5 minutes for SRMs and 60 seconds for CMTS modules before initiating another administrative switchover. It is important to save any configuration changes made to a primary CMTS interface in the running configuration to the startup configuration with the copy running-config startup-config command. This ensures that any configuration changes are guaranteed to be maintained when a Primary CMTS Module switches over service to the Standby CMTS Module or the Standby CMTS Module gives back service to a Primary CMTS Module. If a CPE that is statically configured with an IP address instead of obtaining and IP address via DHCP registers on an active CMTS card, then a switchover occurs, the arp entry will not be deleted if the CM de-registers. If the CM attempts to re-register, the CPE will not pass data until the arp timeout expires. Only users with read/write privileges are allowed to use the redundancy force-switchover cmts command. If a user has read-only privileges, the command is not executed and a message is displayed informing the user of insufficient privileges.

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage redundancy force-switchover cmts

1-122

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Command Syntax
NUM the BSR 64000 CMTS slot number

Compass ID: 271820115 Version 3

1-123

BSR 64000 Command Reference Guide

Release 5.0.0

redundancy force-switchover srm
The redundancy force-switchover srm command allows an administrative switchover from the active SRM to the standby SRM and will cause control of the BSR 64000 to pass from the active SRM to the standby SRM. Note: After the first administrative (manual) switchover you perform for BSR 64000 systems employing Redundant SRMs, Redundant CMTS modules, or both; wait a minimum of 5 minutes for SRMs and 60 seconds for CMTS modules before initiating another administrative switchover. It is important to save any configuration changes made to a primary SRM interface in the running configuration to the startup configuration with the copy running-config startup-config command. This ensures that any configuration changes are guaranteed to be maintained when a Primary SRM Module switches over service to the Standby SRM Module or the Standby SRM Module gives back service to a Primary SRM Module. Only users with read/write privileges are allowed to use the redundancy force-switchover srm command. If a user has read-only privileges, the command is not executed and a message is displayed informing the user of insufficient privileges.

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage redundancy force-switchover srm

1-124

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

reload
The reload command reloads the operating system. The reload command is most often used to reload upgraded software.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage reload [ at | cancel | fast | in countdown | reason ]

Command Syntax at hh:mm MONTH cancel fast in countdown reason LINE reloads at a specific time specific hour and minute to reload name of the month cancels a pending reload reloads the system immediately reloads after a time interval time interval in mm or hh:mm text of the reason to reload

Compass ID: 271820115 Version 3

1-125

BSR 64000 Command Reference Guide

Release 5.0.0

reload switched
A Hitless Upgrade is performed by distributing new software image(s) to all modules in the BSR 64000 chassis via the update chassis command and then using the reload switched command to sequentially reload the image to all modules in the chassis. The reload switched command performs a sequential reload of every module resident in the BSR chassis as part of a hitless upgrade. While each module is reloading, its operation will be performed by another module. Note: The reload switched command can be used by itself (without the update chassis command) to perform a hitless reload (not upgrade) of the chassis.

Note: The reload switched command checks to determine if redundancy is enabled for all slots. If any CMTS slot is not enabled for redundancy, a warning message appears. The reload switched command will not be executed in the following circumstances:
■ ■

a non-switched reload is currently pending. there are modules cards in the BSR chassis that are not in either the RUN or STBY state. the BSR chassis does not support both SRM and CMTS redundancy.

■

Warning: If a user attempts a Hitless Upgrade between archives having different HU Software Group numbers, the following warning message is displayed: WARNING - Attempting Hitless Upgrade between two incompatible archives. Recommended aborting the "reload switched" command Abort the "switched reload" ? [yes/no]: The user is given the choice of proceeding with the Hitless Upgrade or aborting the operation with the recommendation being to abort.

1-126

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

CLI commands that would interfere with operation of the reload switched command will not be executed during the switched reload procedure. These commands are:
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■

balance boot copy download (debug mode command) update redundancy cmts enable/disable redundancy force srm/cmts reload (except reload cancel) reset shutdown (if configuring an HSIM interface) no shutdown (if configuring HSIM interface)

During a switched hitless upgrade reload, the above commands will not execute even if the command does not apply to the module currently being reloaded. If an attempt is made to use these commands, the system will display a message similar to the following:
This command may not be performed while a switched reload is in progress. Enter . ‘show reload’ to display the current progress of the switched reload. Enter ‘reload cancel’ to cancel the switched reload.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage reload switched [check | hsim-delay | resume [ hsim-delay ]]

Compass ID: 271820115 Version 3

1-127

BSR 64000 Command Reference Guide

Release 5.0.0

Command Syntax check hsim-delay 15-120 check the system to see if Hitless Upgrade is supported the number of seconds (15-120) that Hitless Upgrade waits between the end of the reload of one HSIM card and the start of the reload of the next HSIM card - this time allows the routing tables to be populated before reloading the next HSIM card resume a cancelled or terminated switched reload

resume

The following is an example of typical output from the reload switched check command:\

Switched reload validation summary: System card types and states meet requirements of Hitless Upgrade. Please verify the software compatibility between the current and target application archives by checking the Hitless Upgrade Group numbers and making sure that they are the same in both the archives. eg - archive 4.1.0T00P48H04KRAU.Z - HU group is 04 For boot rom upgrade refer to release documentation to verify suitablity for Hitless Upgrade. Please check user documentation to insure that hardware revision numbers meet the requirements of the new software archive. It is the user's responsibility to insure that multi-path routes to the desired destinations have been configured. The software does not verify this.

1-128

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Note: For the reload switched resume command, the hsim-delay option has the same functionality as described above with one important difference; If the hsim-delay option is not specified with the reload switched resume command, then the hsim-delay value used during Hitless Upgrade will be the hsim-delay value specified with the previous reload switched hsim-delay command or the default hsim-delay value of 15 seconds. For example, the reload switched command is started with an hsim-delay of 35 secondS. reload switched hsim-delay 35 For some reason Hitless Upgrade is either aborted by the user or terminates due to some issue. When the issue has been addressed and Hitless Upgrade is resumed, the following scenarios will apply: • if the reload switched resume hsim-delay command is used without explicitly specifying an hsim-delay value, Hitless Upgrade uses the previous value of 35 seconds for the hsim-delay. if the reload switched resume command is used with an hsim-delay value of 25 seconds (reload switched resume hsim-delay 25), Hitless Upgrade will use the new specified value of 25 seconds for the hsim-delay.

•

Command Default hsim-delay = 15 seconds

Compass ID: 271820115 Version 3

1-129

BSR 64000 Command Reference Guide

Release 5.0.0

repeat
The repeat command repeats a command or series of commands

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage repeat {} { [...] | delay { [...]}}

Command Syntax
NUM WORD delay NUM the number of times to repeat the command or series of commands the command or series of commands the delay (in seconds) between the execution of each command

1-130

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

reset
The reset command resets all slots or a specific slot in the BSR 64000 chassis. Note: It is important to save any configuration changes made in the running configuration to the startup configuration with the copy running-config startup-config command before resetting a slot. This ensures that any configuration changes are guaranteed to be maintained after a slot is reset.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage reset {all | slot }

Command Syntax all slot 0-6, 8-15 reset all slots in the BSR 64000 chassis reset a specific slot

Compass ID: 271820115 Version 3

1-131

BSR 64000 Command Reference Guide

Release 5.0.0

service password-encryption
The service password-encryption command enables password encryption. The no service password-encryption disables password encryption. The service password-encryption command will also encrypt previously specified passwords in the running-config file that are currently unencrypted. Note: Once passwords appearing in the running configuration file are encrypted, they cannot be unencrypted using the no service password-encryption command.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage service password-encryption no service password-encryption

Command Default
No encryption

1-132

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

session-timeout
The session-timeout command lets you specify the length of time (in minutes) before the BSR terminates any inactive session. An inactive session is a session has received no user input or system output during the specified time interval.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage session-timeout {console | telnet}

Command Syntax console telnet 0-30 specifies console sessions specifies telnet sessions length of time in minutes before the session is terminated automatically by the BSR

Command Default
5 minutes for telnet sessions 0 for console sessions (session maintained indefinitely)

Compass ID: 271820115 Version 3

1-133

BSR 64000 Command Reference Guide

Release 5.0.0

session-window set
The session-window set command specifies the height and width parameters of the current CLI session window.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage session-window set {height | width }

Command Syntax height 4-128 width 16-384 sets window height in number of lines sets window width in number of columns

1-134

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

set bandwidth-factor
The set bandwidth-factor command configures the percentage of bandwidth that may be used by a Ethernet or Gigabit Ethernet interface. The no set bandwidth-factor command restores the default bandwidth factor of 100%.

Group Access
All

Command Mode
Interface Configuration (Ethernet and Gigabit Ethernet interfaces only)

Command Line Usage set bandwidth-factor no set bandwidth-factor

Command Syntax
10-100 the percentage of bandwidth that can be used (min 10 Mbps)

Command Default
100%

Compass ID: 271820115 Version 3

1-135

BSR 64000 Command Reference Guide

Release 5.0.0

set stats poll
The set stats poll command specifies a polling interval in seconds for various BSR slot statistics. The no set stats poll command disables slot statistics polling.

Group Access
All

Command Mode
Slot Configuration

Command Line Usage
For the SRM module in slot 7: set stats poll update no set stats poll update For all Ethernet or Gigabit Ethernet slots: set stats poll {bmeth | fastpath {ip | mpls} | gige | lcpu | update | xfabric} {} no set stats poll {bmeth | fastpath {ip | mpls} | gige | lcpu | update | xfabric} {} For all CMTS slots: set stats poll {cmts | update | xfabric} {} no set stats poll {cmts | update | xfabric} {}

Command Syntax bmeth cmts fastpath ip fastpath mpls buffer manager Ethernet statistics

CMTS Statistics Fastpath forwarding IP statistics Fastpath forwarding MPLS statistics

1-136

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

gige lcpu update xfabric 1-3600

Gigabit Ethernet statistics local CPU Ethernet statistics report statistics to SRM switch fabric statistics poll time in seconds

Compass ID: 271820115 Version 3

1-137

BSR 64000 Command Reference Guide

Release 5.0.0

show aliases
The show aliases command displays any one of the following:
■ ■ ■ ■

Aliases for commands in all modes Aliases for commands in a specific mode. Aliases for all commands that begin with, include, or exclude a specified string. Aliases for a specific mode that begin with, include, or exclude a specified string.

The following is an example of typical screen output from the show aliases command:

Privilege mode aliases: getHa22 copy ftp://150.21.2.61/pub/tter/tterHa22.Z nvram: getSf copy ftp://10.14.37.103/pub/tter/tter.Z nvram:tter.Z ccm clear cable modem all reset ccmoff clear cable modem offline getElf copy ftp://10.14.37.103/pub/tter/vxWorks.Z.elf nvram:vxWorks.Z.elf getVtag copy ftp://10.14.37.103/pub/tter/tterVtag.Z nvram:tterVtag.Z System-wide aliases: scmst show cable modem summary total scm show cable modem

Group Access
All

Command Mode
All except User EXEC

Command Line Usage show alias [conf | exec | priv] [ | {begin | exclude | include} {} | {count | count-only}] show alias [conf | exec | priv] [ | {count | count-only}]

1-138

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Command Syntax conf exec priv | begin exclude include WORD count count-only specifies aliases for Global Configuration mode specifies aliases for User EXEC mode specifies aliases for Privileged EXEC mode turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-139

BSR 64000 Command Reference Guide

Release 5.0.0

show boot
The show boot command lists the boot parameters. Use the show boot command to display the contents of the BOOT environment variables and the configuration register setting. The following is an example of typical screen output from the show boot command:

Boot location currently set to nvram:tter.Z

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show boot [ | {begin | exclude | include} {} | {count | count-only}] show boot [ | {count | count-only}]

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

1-140

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show chassis alias
The show chassis alias command to show the alias name for the BSR chassis.

Group Access
All

Command Mode
All modes

Command Line Usage show chassis alias

Compass ID: 271820115 Version 3

1-141

BSR 64000 Command Reference Guide

Release 5.0.0

show chassis assetid
The show chassis assetid command is used to view the asset ID number assigned to the BSR.

Group Access
All

Command Mode
All modes

Command Line Usage show chassis assetid

1-142

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show chassis serial-num
The show chassis serial-num command is used to view the serial number assigned to your BSR 64000.

Group Access
All

Command Mode
All modes

Command Line Usage show chassis serial-num

Compass ID: 271820115 Version 3

1-143

BSR 64000 Command Reference Guide

Release 5.0.0

show chassis status
The show chassis status command displays the operational status and twhe type of modules that are installed in the BSR. The following information is provided: Slot Type module slot number from 0 to 15 the type of module inserted into the BSR 64000. HSIM indicates either the POS or Gigabit Ethernet Network Interface modules (NIMs)- CMTS indicates the DOCSIS module - SRM indicates the Supervisory Routing Module (SRM3 or SRM4) the module subtype - 2X8 CMTS, ETH1, ETH8, etc. indicates the slot number of the redundant backup module indicates the current operational state of the module. RUN indicates that the module is fully operational. Flash indicates that the module is updating its FLASH memory. boot indicates that the module is currently in a boot state. stby indicates that the module is in standby mode resource module. An x indicates that this module is operational. A - (dash) indicates that this module is not currently operational physical module (IO module). An x indicates that this module is operational. A - (dash) indicates that this module is not currently operational if the system clock has been set using the clock set command, the UpTime field displays the amount of time that the module has been operational. The time is expressed in hh:mm:ss format if the module is down, the last operational time for the module displays the module booted successfully. the module failed the boot process.

Sub Red State

RM IO

UpTime

LastUpTime Success Failure

1-144

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

The following is an example of typical screen output from the show chassis status command: For Release 5.0.0, the show chassis status command has been enhanced with the TX32 module type and operational status. The following is typical screen output from the show chassis status command:

Current Time: 11/19-06:43:15 Running archive: NVRAM:500T00P01.Z Slot 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Type Sub Red State RUN RUN stby RUN RUN RUN RUN RM x x x x x x x IO x x x x x x x x x x UpTime LastUpTime Success Failure 0 0 0 0 1 1 0 0 0 0 1 1 0 1 0 0 0 0 0 0 TX32 Module 0 0 1 1 0 0 0 0 1 1 1 1

CMTS 2x8(2.0)

0w2d16h

CMTS 2x8 CMTS 2x8(2.0) SRM4

0w2d16h 0w2d16h 0w2d16h

DTX

TX32

0w2d16h

HSIM MMGE HSIM ETH8

0w2d16h 0w2d16h

Compass ID: 271820115 Version 3

1-145

BSR 64000 Command Reference Guide

Release 5.0.0

Note: The value displayed with the sysUpTime SNMP MIB object and the "UpTime" field as displayed in the show chassis status command output represent different system up time values. The sysUpTime MIB object represents the amount of time that the SNMP Agent has been running. This is relative to the time that the SNMP Agent was last restarted. Initially, this will be close to the time that the SRM module last restarted because the SNMP Agent resides on the SRM module. However, if the SNMP Agent itself is restarted with the snmp-server shutdown or snmp-server enable CLI commands, the sysUpTime will be reset to zero. The "UpTime" value displayed in the show chassis status command output represents the amount of time that the modules have been running relative to the last reboot of the chassis or last reset of the modules. These system time values may be different for each module, even after a reboot of the entire chassis, because not all modules complete their initialization at the same time. Also, the system time values will be different if individual modules are restarted via the CLI or are manually inserted at a later time. However, the per-module 'UpTime" values displayed in the show chassis status command output are NOT affected by the snmp-server shutdown and snmp-server enable commands because these values are relative to the module’s boot time not to the SNMP Agent’s boot time.

Note: After an SRM switchover, the show chassis status command output may display an inaccurate uptime value for SRM4 modules in the BSR chassis. This should not otherwise affect system performance. For BSR 64000 systems with an SRM4, a file called timezone is automatically created in NVRAM to store the system clock time zone information configured with the clock set and clock timezone commands. The timezone file should not be deleted. If the file is removed for any reason, then the system clock and time zone configuration must be re-entered using the clock set and clock timezone commands and verified using the show clock command.

1-146

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Group Access
All

Command Mode
All modes

Command Line Usage show chassis status [ | {begin | exclude | include} {} | {count | count-only}] show chassis status [ | {count | count-only}] Note: Do not truncate the show chassis status command (ex. sh ch st) when in Interface Configuration Mode. Truncating the show chassis status command when in Interface Configuration Mode will produce the expected command output but will also place the CLI into Global Configuration Mode.

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-147

BSR 64000 Command Reference Guide

Release 5.0.0

show clock
The show clock command shows the system clock. The following is an example of typical screen output from the show clock command:

TUE JAN 24 10:05:05 2006 Timezone eastern, -5 hr 0 min offset from UTC

Group Access
All

Command Mode
All modes

Command Line Usage show clock [ | {begin | exclude | include} {} | {count | count-only}] show clock [ | {count | count-only}]

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

1-148

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show core log
The show core log command addresses the problem of logged exception data being removed from a log file as other logged data is added and the log file’s capacity is exceeded before the exception log data can retrieved. In addition to logging exception data in the regular log file, the exception data is stored in a core log file. This log file can be viewed with the show core log command and cleared with the clear core log command.
■

The core log file stores up to 400 lines of exception data, occupying a maximum 102.4 KB file size in FLASH. The filename is core.log. After a reload, a new core.log file is created, and the old core.log file is backed up to a file named core.old. The core.old file can be viewed in a text editor.

■

■

The following displays typical output from the show core log command:

Preparing log file for reading ... [07/21-18:14:22.4807/21-18:13:41.89[07/21-18:14:22.3607/21-18:13:41.89[07/21-18:14:22.3407/21-18:13:41.89[07/21-18:14:22.3307/21-18:13:41.89[07/21-18:14:22.2907/21-18:13:41.89[07/21-18:14:22.2807/21-18:13:41.89-

08:EXC]-E- Reformating Exception Storage 08:EXC]-EtRDNc Timeout:0 08:EXC]-E- Tasks blocked on semaphore 0xfffff80: 08:EXC]-EtTnetRDNtd Timeout:0 08:EXC]-E- Tasks blocked on semaphore 0xb17d88c: 08:EXC]-EEventMgr Timeout:28

Group Access
All

Command Mode
All mores except for User EXEC

Command Line Usage show core log

Compass ID: 271820115 Version 3

1-149

BSR 64000 Command Reference Guide

Release 5.0.0

show evt
The show evt command displays EVT counts for all EVT groups, a specific EVT group, EVT group counts that only occur on a specific BSR slot, or individual event. By default, only EVT groups with non-zero event counts are displayed. The following is an example of typical screen output from the show evt command:

Slot 0: CRA - Cra event system EVT Base : 4608 Num Title Count Sv Logging ------------------------------------------ ---------- -- -------1 rcvd crm msg 144 D 14 Received CA Certificate SET request 3 D 18 Sent GET CA Cert. message to CRM 1 D 23 cmtsSendCrmCmAdd 12 D 24 cmtsSendCrmCmDel 8 D 25 cmtsSendCrmCmReg 12 D

Slot 0: MACCFG - macCfg event system EVT Base : 9984 Num Title Count Sv Logging ------------------------------------------ ---------- -- -------1 Flap tree add success 3 D 3 Flap tree delete success 3 D 8 FlapListAdd success 3 D 10 FlapListDel success 3 D 15 FlapListAgeout success 2 D 18 set cmh flap rowstatus to active 3 D 19 set cmh flap rowstatus to destroy 3 D 22 set cmh flap mac addr 4 D

In addition to the BSR 64000 slot number, EVT group name, and EVT base number, the following information is displayed Num Title the EVT number - EVTs are numbered from 1 to 255 (maximum) the title of the individual event

1-150

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Count Sv

the number of times the EVT has occurred since the count was last reset the severity level of the event - in order of increasing severity, the abbreviations are: D = Debug I = Informational N = Notice W = Warning E = Error C = Critical A = Alert E = Emergency

Logging

indicates to which logging subsystems EVT messages are forwarded: L = Local log file T = Trap to SNMP S = SYSLOG C = Console

Group Access
All

Command Mode
All modes

Command Line Usage show evt [ | ]

Compass ID: 271820115 Version 3

1-151

BSR 64000 Command Reference Guide

Release 5.0.0

Command Syntax
NUM WORD the chassis slot number the name of an EVT group - refer to Table Table

1-152

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Table EVT Event Subsystems memchk net ipevt tpt arp rpt im icp evtm evta rmbind rm crmbpi crm crmsub crmfft crmsnr crmutl crmdtm crmcli crmdsg dsgif csm brmtag rsm rdb fpevt spcmgr dgm dqos pcmm em lbgmgr drm drme Memory Check Network IP Event System Testpoint Facility ARP SRM Repeater Interface Manager ICP EVT Manager EVT Agent RM Bind Resource Manager CRM BPI CRM CRM SubMgt CRM FFT CRM SNR CRM Util CRM DOCSTEST CRM CLI CRM DSG DSG Interface Certificate Storage Module BRM VLAN Tagging Redundancy SRM Run Time Database FP EVT Spectrum Manager DQM PacketCable DQOS PacketCable Multimedia PacketCable Event Message Load Balance Manage DOCSIS Redundancy Manager DOCSIS Redundancy Manager Engine drmr DOCSIS Redundancy Manager SRM swr Switched Reload tacacs TACACS+ vrfmgr VRF Manager ipsec IPSEC sys SYS UTIL snmpa SNMP Agent dsgmib SNMP DSG bufmgr Buffer Manager eth8 Ethernet Switch fei FEI srpcmt SRM Reporter CMTS maccfg MAC CFG cmtbuf CMTS Buffer fpga CMTS FPGA bcm Broadcom Driver bcmpkt Broadcam Driver Per Packet frm FRM ard ARD ardpkt ARD PKT que QUE Manager upc Upconverter res RES resrtr RES RTR resaut RES AUTH ressf RES SF resmgr RES MGR lbm Load Balancing lbm2 Load Balancing 2nd Table lbmsnr Load Balacing SNR cms Cable Modem Selector acc ACC accpkt ACC Packet ACC DHCP REG Range Data Path Mapping DOCSIS Redundancy Agent ubsha Upstream Scheduler RTR ubsbst Upstream Scheduler Burst ubsmac UBS CMTS MAC RTR ubs Upstream Scheduler ubsim UBS IM SYNC ubsmap UBS MAP macmr MAC MGR DOCS IF docsif macrtr MACRTR brgtag BRG TAG BRG brg BRG RTR brgrtr Spectrum Agent FFT spafft spasnr Spectrum Agent SNR rssi Spectrum Agent RSSI spasc Spectrum Agent SC ardrtr ARD RTR acctrt ACC RTR btp Boot Uptime mcns MCNS red CMTS Redundancy ICP ucc Upstream Channel Change dcc Dynamic Channel Change dsx Dynamic Service svcflo Service Flow cra CRA cra2 CRA SNR Broadcom 3138 Driver bcm1 bcmmac Broadcom 3212 Driver Preamble pream upcmot Upconverter Motorola accdhc reg range dpm dra

Compass ID: 271820115 Version 3

1-153

BSR 64000 Command Reference Guide

Release 5.0.0

show forced-download
The show forced-download command shows information about which slots are set for forced download from the SRM. The following is an example of typical screen output from the show forced-download command:

Slot Slot Slot Slot Slot Slot Slot Slot Slot Slot Slot Slot Slot Slot Slot Slot

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

is is is is is is is is is is is is is is is is

forced forced forced forced forced forced forced forced forced forced forced forced forced forced forced forced

to to to to to to to to to to to to to to to to

always always always always always always always always always always always always always always always always

download download download download download download download download download download download download download download download download

from from from from from from from from from from from from from from from from

the the the the the the the the the the the the the the the the

SRM SRM SRM SRM SRM SRM SRM SRM SRM SRM SRM SRM SRM SRM SRM SRM

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show forced-download [ | {begin | exclude | include} {} | {count | count-only}] show forced-download [ | {count | count-only } {}]

1-154

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-155

BSR 64000 Command Reference Guide

Release 5.0.0

show history
The show history command displays a list of commands executed during a session. The list size is determined by the setting of the history size command. The following is an example of typical screen output from the show history command:

show show show show show show show show show show

ip bgp next-hops ip bgp summary ip bgp community boot aliases boot chassis alias chassis asset-id clock history

Group Access
All

Command Mode
All modes

Command Line Usage show history [ | {begin | exclude | include} {} | {count | count-only}] show history [ | {count | count-only}]

Command Syntax
| begin exclude turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string

1-156

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

include WORD count count-only

filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-157

BSR 64000 Command Reference Guide

Release 5.0.0

show keepalive
The show keepalive command displays keepalive status and configuration information for all switch fabric or ICP keepalives. The following is an example of typical screen output from the show keepalive command:

Status Features

: : : :

xfabric keepalive enabled icp keepalive enabled xfabric(monitor, 880-recover, slot-recover, cmts-rebind) icp(monitor, slot-reset )

Thresholds: xfabric (monitor 3, 880-recover 10, slot-recover 60, cmts-rebind 5) : icp (monitor 10, slot-reset 10) Keepalive Retransmit Counts: Slot xfabric ICP ---------------------10 : 1 0

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show keepalive [ | {begin | exclude | include} {} [ | {count | count-only}]] show keepalive [ | {count | count-only}]

Command Syntax
| begin turns on output modifiers (filters or counters) filter for output that begins with the specified string

1-158

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

exclude include WORD count count-only

filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-159

BSR 64000 Command Reference Guide

Release 5.0.0

show log
The show log command displays message logging in the log file the newest message first.The show log command displays log file contents and information about users who have logged into the BSR. The following is an example of typical screen output from the show log command:

Preparing log file for reading ... [02/11-10:39:08- 07:telnet01]-N-user enabled-user authenticated [02/11-10:39:04- 07:telnet01]-N-connection made from 10.14.11.218 on session 01 [02/10-18:41:11- 07:RMs]-N-Module state RUNNING CMTS slot 1 . [02/10-18:41:11- 07:RMs]-I-Slot 1 booted with version 2.1.0T00P39.KRBU [02/10-18:41:09- 07:SPECMGR]-N-No shut down succeed for channel ifIndex = 98561 [02/10-18:41:09[02/10-18:41:08[02/10-18:41:08[02/10-18:41:08[02/10-18:41:07iguration(), for [02/10-18:41:07disable [02/10-18:41:073 shutdown [02/10-18:41:07[02/10-18:41:072 shutdown [02/10-18:41:07[02/10-18:41:071 shutdown [02/10-18:41:07[02/10-18:41:07eam 0 shutdown [02/10-18:41:07[02/10-18:41:0707:CRMTASK]-N-link up notification, ifIndex = 98561. 07:CRMTASK]-N-link up notification, ifIndex = 98305. 07:IM]-N-IP Interface cable 1/0 on 150.31.41.1 is up 07:IM]-N-Interface cable 1/0 is up 07:RMsc]-E-bad return value 0 from parse() in loadInterfaceConf config line:' cable dynamic-service authorization-mode disable' 07:RMsc]-I-restoring: cable dynamic-service authorization-mode 07:RMsc]-N-configuration change by [hotswapper]: cable upstream 07:RMsc]-I-restoring: cable upstream 3 shutdown 07:RMsc]-N-configuration change by [hotswapper]: cable upstream 07:RMsc]-I-restoring: cable upstream 2 shutdown 07:RMsc]-N-configuration change by [hotswapper]: cable upstream 07:RMsc]-I-restoring: cable upstream 1 shutdown 07:RMsc]-N-configuration change by [hotswapper]: no cable upstr 07:RMsc]-I-restoring: no cable upstream 0 shutdown 07:RMsc]-N-configuration change by [hotswapper]: cable upstream

Group Access
All

Command Mode All modes except User EXEC
1-160 Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Command Line Usage show log [security] [ | {begin | exclude | include} {} [ | {count | count-only}]] show log [security] [ | {count | count-only}]

Command Syntax security displays security privilege information Note: the security option is only available to a user logged in as securityuser - refer to Configuring Cable Intercepts in the BSR 64000 CMTS Configuration and Management Guide turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

| begin exclude include WORD count count-only

Compass ID: 271820115 Version 3

1-161

BSR 64000 Command Reference Guide

Release 5.0.0

show logging evt
The show logging evt command displays the EVT configuration entries in the running configuration file. The following is an example of typical screen output from the show logging evt command:

EVT RUNNING logging evt logging evt logging evt

CONFIG: set c drme 82 set c rdb 197 set c dra 121

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show logging evt

1-162

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show logging reporting
The show logging reporting command displays the recording mechanism for logging messages based on their severity level. The display output is in the format: logging reporting e.g. logging reporting alert local. The following is an example of typical screen output from the show logging reporting command:

no logging control docsis logging reporting emergency local logging reporting alert local logging reporting critical local-trap-syslog logging reporting error local-trap-syslog logging reporting warning local-trap-syslog logging reporting notice local-trap-syslog logging reporting information all-clear logging reporting debug all-clear

The following information is displayed:

Severity Levels and Descriptions emergency emergency conditions where the system is unusable reserved for vendor-specific, fatal hardware or software errors that prevents normal system operation and causes reporting system to reboot (severity level = 0) conditions where immediate action is needed - a serious failure which causes the reporting system to reboot but is not caused by hardware or software malfunctioning (severity level = 1) critical conditions - a serious failure that requires immediate attention and prevents the device from transmitting data but the system could recover without rebooting (severity level = 2)

alert

critical

Compass ID: 271820115 Version 3

1-163

BSR 64000 Command Reference Guide

Release 5.0.0

error

error conditions - a failure occurred that could interrupt the normal data flow (severity level = 3) warning conditions - a failure occurred that could interrupt the normal data flow (severity level = 4) normal but significant conditions - an event of importance occurred which is not a failure (severity level = 5) informational descriptive system messages - an unimportant event, which could be helpful for tracing normal operations (severity level = 6) debugging messages (severity level = 7) set all the severity level to default

warnings

notice

information

debug default

Logging Location Options local local-syslog local-trap local-trap-syslog log messages for the report go to local-nonvolatile memory (NVRAM) log messages for the report go to local NVRAM and the SYSLOG server log messages for the report go to local NVRAM. SNMP traps are also sent to an SNMP manager log messages for the report go to local NVRAM and a SYSLOG server - SNMP traps are also sent to an SNMP manager unsets all logging locations for the report sets all logging locations for the report

all-clear all-set

1-164

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show logging reporting

Compass ID: 271820115 Version 3

1-165

BSR 64000 Command Reference Guide

Release 5.0.0

show logging syslog
The show logging syslog command displays a counter of the total number of log messages sent to the SYSLOG server and the number of messages dropped if a logging threshold has been exceeded. The following is an example of typical screen output from the show logging syslog command:

Syslog Messages Sent: 654 Syslog Messages Dropped due to throttling: 0

The following information is displayed: Syslog Messages Sent: Syslog Messages Dropped due to throttling: the number of log messages logged to the SYSLOG server the number of log messages that were to be logged to the SYSLOG server but were discarded because the threshold set with the logging rate-limit command was exceeded

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show logging syslog

1-166

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show macro
The show macro command lists all configured macros on the BSR.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show macro [ | {begin | exclude | include} {} [ | {count | count-only}]] show macro [ | {count | count-only}}]

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-167

BSR 64000 Command Reference Guide

Release 5.0.0

show memory
The show memory command displays the memory content of the starting address. Use the show memory command to view information about memory available after the system image decompresses and loads. The following is an example of typical screen output from the show memory command with the fastpath argument:

Fast Path memory usage as follows: Category -------Buffer Manager L2 Cam Total size Buffer Manager L2 CAM mapping table size Buffer Manager L2 CAM hash table size Buffer Manager L2 CAM MAC address tables size Buffer Manager L2 CAM Miscellaneous size Flow Classification Total size Icmp Filter FC mapping/hashing table size Policy FC mapping/hashing table size Flow Classification CAM/SRAM mapping table size Flow Classification Miscellaneous size Unicast Routing Total size Unicast Routing local route mapping Unicast Routing LME/SRAM mapping table size Total : : : : : : : : : : : # Of Bytes ---------1559084 1245232 2040 311808 4 5127504 52 144 5127304 4 12630540 : 49152 : 12581384 19317128

:

1-168

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

The following is an example of typical screen output from the show memory command with the information argument:
FREE LIST: num addr size --- ---------- ---------1 0x6ea6718 72 2 0x6ee8248 32 3 0x6ea67e0 40 4 0x6ee8d60 32 5 0x6ea6a10 40 6 0x6ea6960 24

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show memory [ | byte | end | long | short ] [ fastpath [brief] ] [ information [brief] [slot ] ] [ | {begin | exclude | include} {} [ | {count | count-only}]] show memory [ | byte | end | long | short ] [ fastpath [brief] ] [ information [brief] [slot ] ] [ | {count | count-only}]

Command Syntax address 1-4294967295 byte end long the starting memory address expressed in hexadecimal notation the number of bytes to dump display in byte format the ending memory address expressed in hexadecimal notation display in long format

Compass ID: 271820115 Version 3

1-169

BSR 64000 Command Reference Guide

Release 5.0.0

short fastpath brief information slot

display in short format the number of bytes used to program the HSIM FastPath display only the summary displays free memory statistics and a summary of memory usage displays free memory statistics and a summary of memory usage for a specified slot in the BSR chassis the BSR slot number turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

NUM | begin exclude include WORD count count-only

Command Default
32 bit

1-170

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show network-clocks
The show network-clocks command displays the network clock configuration. The following is an example of typical screen output from the show network-clocks command:

Priority 1 clock source: Reference not configured Priority 2 clock source: Reference not configured Current clock status: Out of Range Non-revertive mode selected Unlocked Free-running

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show network-clocks

Compass ID: 271820115 Version 3

1-171

BSR 64000 Command Reference Guide

Release 5.0.0

show pool
The show pool command displays information on data buffering including all memory buffer pools, application-specific pools, the network pool, system physical structures, and all mBuf pool names. The following is an example of typical screen output from the show pool command:

Statistics for pool: network number of FREE mbufs: 38271 number of mbufs: 38272 number of times failed to find space: 0 number of times waited for space: 0 number of times drained protocols for space: 0 high water mark: 9 __________________ CLUSTER POOL TABLE _____________________________________________________ size clusters free usage highwater mark ----------------------------------------------------64 16384 16383 44153 6 128 32768 32768 22520 2 256 4096 4096 64 1 512 2048 2048 25 1 1024 2048 2048 647 3 2048 512 512 0 0 -----------------------------------------------------

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show pool [ | all | application | icp | names | network | system ] [ | {begin | exclude | include} {} [ | {count | count-only}]] show pool [ | all | application | icp | names | network | system ] [ | {count | count-only}]

1-172

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Command Syntax
WORD all application icp names network system the name of the buffer pool view all memory buffer pools view all application-specific pools view chassis control messages in the ICP pool view the network pool where network data transfer information for the stack is located view the network pool where network data transfer information for the stack is located view system pool physical structures such as the number of sockets, routes, interface addresses, PCB, and multicast addresses turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

| begin exclude include WORD count count-only

Compass ID: 271820115 Version 3

1-173

BSR 64000 Command Reference Guide

Release 5.0.0

show process
The show process command displays information about software processes that are running on the router. The following is an example of typical screen output from the show process command:

All CPU accounting is approximate, there are 103 ticks per second NAME -------tExcTask TaskMon ctrlMon tPCCARD BgpTask DiagTask DvmrpTask EventMgr FpMsgHndlr IcpTask OspfTask PimTask SntpTask SonetBoardAP SonetTimingT StatsMgrTask VrrpTask fanStatus TID ------f7fbb60 7925f38 7928958 f69d078 6a566e0 76af6b0 609d888 b17caf8 9118668 a29e4d8 637da80 61afd80 76a9a68 76b20d0 76b4af0 ae05e80 79ba698 76ac558 PRI --0 1 2 20 30 30 30 30 30 30 30 30 30 30 30 30 30 30 total % (ticks) -----------------000.00%( 8 000.00%( 12 000.00%( 0 000.00%( 0 000.01%( 68 000.00%( 0 000.00%( 2 000.00%( 8 000.00%( 32 000.11%( 1289 000.02%( 203 000.00%( 8 000.00%( 2 000.00%( 0 000.00%( 12 000.00%( 13 000.00%( 27 000.18%( 2173 delta % (ticks) -----------------000.00%( 0) 000.00%( 0) 000.00%( 0) 000.00%( 0) 000.00%( 0) 000.00%( 0) 000.00%( 0) 000.00%( 0) 000.00%( 0) 000.10%( 2) 000.00%( 0) 000.00%( 0) 000.00%( 0) 000.00%( 0) 000.00%( 0) 000.00%( 0) 000.05%( 1) 000.25%( 5)

Group Access
All

Command Mode
All modes except User EXEC

1-174

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Command Line Usage show process [cpu | memory | msg-q-info | semaphores | stack] [ | {begin | exclude | include} {} [ | {count | count-only}]] show process [cpu | memory | msg-q-info | semaphores | stack] [ | {count | count-only}]

Command Syntax cpu memory msg-q-info semaphores stack | begin exclude include WORD count count-only cpu utilization by each process memory information per process information about current message queues display state of semaphore(s) process stack usage and interrupt routines, including the reason for the last system reboot turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-175

BSR 64000 Command Reference Guide

Release 5.0.0

show process cpu
The show process cpu command displays detailed CPU usage statistics for active SRM and CMTS modules in the BSR 64000 chassis. The module type (for example: 2x8 CMTS slot ) is displayed along with the CPU usage statistics for that module. For HSIM modules, the module sub type (for example: Sub Type: SMGE) is displayed.

Note: CPU usage statistics for HSIM or standby SRM modules will not be displayed using this command.

The following is an example of typical screen output from the show process cpu command:

Slot: 4 Module Type: 2x8

CMTS

All CPU accounting is approximate, there are 503 ticks per second NAME -------tExcTask TaskMon tShell ctrlMon tKADEBUG tWdbTask DiagTask EventMgr tCmdHdlQ tRdnCollectT tRdnReportTa tRmIomLedTas tUbs redMonitorTa redSyncTask tFtpdTask TID ------fbfd6d8 eea6498 eee0168 eea8eb8 8b8c720 eee2388 ec0acd0 f081f78 ee72b60 8d65288 8d638f8 8d6b888 c4d1598 ec08248 a7ea9f8 f077380 PRI --0 1 1 2 2 3 30 30 30 30 30 30 40 50 50 55 total % (ticks) -----------------000.00%( 0 000.00%( 119 000.00%( 0 000.00%( 0 000.00%( 32 000.00%( 0 000.00%( 0 000.00%( 9 000.00%( 38 000.03%( 1516 000.00%( 0 000.00%( 50 004.31%( 260069 000.00%( 268 000.15%( 9299 000.00%( 0 delta % (ticks) -----------------000.00%( 0) 000.00%( 119) 000.00%( 0) 000.00%( 0) 000.00%( 32) 000.00%( 0) 000.00%( 0) 000.00%( 9) 000.00%( 38) 000.03%( 1516) 000.00%( 0) 000.00%( 50) 004.31%( 260069) 000.00%( 268) 000.15%( 9299) 000.00%( 0)

1-176

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show process cpu [frequency | restart | slot | stop] [ | {begin | exclude | include} {} [ | {count | count-only}]] show process cpu [frequency | restart | slot | stop] [ | {count | count-only}]

Command Syntax frequency 30-200 restart how many times per second a CPU statistic measurement is taken in 30-200 Hz restart the utilization measurement process on any or all slots containing a CMTS or active SRM

Compass ID: 271820115 Version 3

1-177

BSR 64000 Command Reference Guide

Release 5.0.0

slot NUM

displays detailed CPU usage statistics for a CMTS or SRM module specified by the module’s slot number (0-15) Note: CPU usage statistics are not displayed for a standby NIM or standby SRM module if the specified slot is an HSIM module, the following message displays: This command does NOT accept HSIM slot if the specified slot does not contain a module, the following message displays: No data available for slot

stop | begin exclude include WORD count count-only

stops the utilization measurement process turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

1-178

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Command Default frequency = 60 Hz

Compass ID: 271820115 Version 3

1-179

BSR 64000 Command Reference Guide

Release 5.0.0

show process memory
The show process memory command displays per process memory usage information about software processes that are running on the BSR. The following screen output is displayed:
NAME TID STATUS Memory Requested Overhead HW mark --------------- --------- -------- --------- --------- --------- --------tRootTask bfffdf8 61713912 61706523 7389 61713936 tShell aeea888 PEND 3248 2981 267 3248 ctrlMon aeb20e8 PEND 152 128 24 152 tCmdHdlQ ae92450 READY 3712 3548 164 14016 tLogTask aeb7308 PEND+T 136 108 28 136 DiagTask ac2fd28 PEND 1928 1856 72 1928 redMonitorTask ac2d2a0 DELAY 379008 378976 32 379008 redSyncMsgTask ac2c018 DELAY 380664 380584 80 380664 redIcpTask ac2ad90 PEND 380696 380600 96 380696 redSTSIHTask ac28a70 PEND 48 32 16 48 IcpTask ac42d78 READY 65832 65772 60 74528 tEVTA ac3d3f0 PEND 2952 2920 32 4440 StatsMgrTask ac32dd8 PEND+T 528 464 64 528 tUpc aafe4d0 PEND 1680 1616 64 12520 fpgaDsTask 908f280 READY 48 32 16 48 tDftTask 908a570 DELAY 48 32 16 48 tArdTim 8583fb8 DELAY 48 32 16 48 dpsDsTask 8582b00 PEND 104 60 44 16144 resMgrTask 853e440 PEND 22240 22072 168 22768 tSftTask 853c088 PEND 48 32 16 48 tUbs 8446a40 READY 563368 562880 488 563896 tMcns2 8436000 PEND 48 32 16 48 tMacTask 842a5c0 READY 34793632 34792500 1132 34795744 rdnBpiMain 843e7b8 PEND+T 4048960 4048228 732 4048960 tMcnsLogTask 8434de0 PEND 6344 6284 60 6344 tRcyc 84223a0 READY 352 288 64 352 tCmacStats 8420180 PEND 262440 262368 72 262440 tSrmReporter 841df60 PEND+T 112 80 32 112 tRLimit 841bd40 DELAY 352 288 64 352 tMacRtr 8419b20 PEND 409352 408640 712 409880 tAccDhcp 8293c48 DELAY 48 32 16 48 tSPA 8292a28 PEND 148232 148188 44 148232 tDra 8286e18 PEND+T 184224 183832 392 185280 tCRA 5c26998 PEND 395976 395784 192 396632 tDownloadTask 5bbc540 PEND 15528 15480 48 15528 tRdb005 5bb1eb0 PEND+T 16352 16216 136 16880 tMcnsTask 842c7e0 READY 56 28 28 56 37 tasks used 103802408 103789516 12892

1-180

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show process memory { [ bytes | kilobytes | megabytes ]} | { [ bytes | kilobytes | megabytes ]} | {slot } {sorted [bytes | high-water-mark [bytes | kilobytes | megabytes ] | kilobytes | megabytes | name [bytes | kilobytes | megabytes ] | no-sort [bytes | kilobytes | megabytes ] | use [bytes | kilobytes | megabytes ]} [ | {begin | exclude | include} {} [ | {count | count-only}]] show process memory { [ bytes | kilobytes | megabytes ]} | { [ bytes | kilobytes | megabytes ]} | {slot } {sorted [bytes | high-water-mark [bytes | kilobytes | megabytes ] | kilobytes | megabytes | name [bytes | kilobytes | megabytes ] | no-sort [bytes | kilobytes | megabytes ] | use [bytes | kilobytes | megabytes ]} [ | {count | count-only}]

Command Syntax process-id bytes kilobytes megabytes process-name slot NUM A process identifier in hexadecimal format Display total sizes in bytes Display total sizes in kilobytes Display total sizes in megabytes The alphanumeric process name up to 15 characters Displays detailed memory usage statistics for a CMTS module specified by the module’s slot number Display sorted memory information for all processes Sort by maximum memory used

sorted high-water-mark

Compass ID: 271820115 Version 3

1-181

BSR 64000 Command Reference Guide

Release 5.0.0

name no-sort use | begin exclude include WORD count count-only

Sort by name Display the first memory request order Sort by memory used now turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Command Defaults
All display output is shown in bytes Sorting is disabled

1-182

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show process msg-q-info
The show process msg-q-info command displays information about current message queues.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show process msg-q-info [ | {begin | exclude | include} {} [ | {count | count-only}]] show process msg-q-info [ | {count | count-only}]

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-183

BSR 64000 Command Reference Guide

Release 5.0.0

show process semaphores
The show process semaphores command creates a message when an attempt to unlock a semaphore when it is already unlocked. The following is an example of typical screen output from the show process semaphores command:
B - Binary, M - Mutex, C - Counting, O - Old * - new from last show Creator Id(Hex) Type/sub ------------ -------- ----------tRootTask ef1808 B-ShowSem tRootTask c724b0 B-Init tRootTask c7258c M-Init tRootTask ec02d8 M-Spl tRootTask ec1c64 B-Mux tRootTask ec26e8 B-NetBuf tRootTask ec2708 B-NetBuf tRootTask ec2728 B-NetTask tRootTask ec9f98 M-PppHook tRootTask eca058 M-PppSecret tRootTask eca69c M-Evt tRootTask eca6bc M-Evt tRootTask eca6d8 M-Evt tRootTask eca6f8 M-Evt tLogTask eca7c4 M-LogCtrl tRootTask eeb7b8 B-Icp tRootTask eeb7dc M-FIO tRootTask ef14f8 B-MemCheck Queue #Pend State Blocked-Task TIMEOUT ----- ----- ---------- ------------ ------FIFO 0 FULL PRIOR 0 FULL PRIOR 0 OWNER:NONE PRIOR 0 OWNER:NONE PRIOR 0 FULL PRIOR 0 EMPTY PRIOR 0 EMPTY PRIOR 1 EMPTY tNetTask 5 PRIOR 0 OWNER:NONE PRIOR 0 OWNER:NONE PRIOR 0 OWNER:NONE PRIOR 0 OWNER:NONE PRIOR 0 OWNER:NONE PRIOR 0 OWNER:NONE PRIOR 0 OWNER:NONE FIFO 0 FULL PRIOR 0 OWNER:NONE FIFO 0 FULL

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show process semaphores [ | {begin | exclude | include} {} [ | {count | count-only}]] show process semaphores [ | {count | count-only}]
1-184 Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-185

BSR 64000 Command Reference Guide

Release 5.0.0

show process stack
The show process stack command monitors the stack utilization of processes and interrupt routines. The following is an example of typical screen output from the show process stack command:
NAME -----------tExcTask TaskMon ctrlMon tPCCARD tLogTask EventMgr tRtmMgrTask tNetTask igmpTask StatsMgrTask statsMgrIcp tEvtHdlr IcpTask tEVTM tEVTA tDRM tCRM tCsm tRM_elect tDownloadTas tRM_sm ENTRY -----------excTask 0x000089987c ctrlKeyTask pcd logTask EventMgrMain RtmMgrTask netTask igmpTask statsMgrTask statsMgrIcpT 0x000081103c IcpTask 0x00000b4b00 0x00000b4d00 drm_main crmTaskMain CsmMain RM_election_ DownloadTask RM_sm TID SIZE CUR HIGH MARGIN -------- ----- ----- ----- -----f7fbb60 7976 248 1520 6456 7925f38 10224 1112 1288 8936 7928958 10224 208 2040 8184 f69d078 3984 216 280 3704 f6a3ba8 20456 464 5512 14944 b17caf8 15336 216 5272 10064 ae850e8 10216 256 3232 6984 ae2eb38 19976 336 5264 14712 ae29af8 19976 296 2128 17848 ae05e80 10216 272 2104 8112 a82eb80 10216 232 2120 8096 a6898c0 10216 728 4520 5696 a29e4d8 10224 296 4416 5808 a27d508 32752 320 4312 28440 a2752e8 32752 320 2288 30464 a2633d0 10224 544 3592 6632 a2609b0 32752 2216 6576 26176 963bcc8 16368 1696 4848 11520 9634750 40936 168 2184 38752 919c498 10216 248 3216 7000 917f278 40944 584 20112 20832

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show process stack [ procID | procName ] [ | {begin | exclude | include} {} [ | {count | count-only}]] show process stack [ procID | procName ] [ | {count | count-only}]
1-186 Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Command Syntax procID procName | begin exclude include WORD count count-only process identifier in decimal or hexadecimal format (0x is required) the name of the process turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-187

BSR 64000 Command Reference Guide

Release 5.0.0

show redundancy cmts
The show redundancy cmts command displays the BSR 64000 redundancy configuration for CMTS modules in the BSR 64000 chassis. The following information is displayed: CMTS Slot Sub Type Slot Status the CMTS slots configured for CMTS redundancy the type of CMTS module installed in the slot- either 2x8, or 2x8(2.0) indicates whether the module is in the RUN (active) state or stby (standby) state - the stby state indicates that the module is ready to accept a switch-over from another slot the redundant slot to which this chassis slot switches over the context in which this Primary CMTS module slot is active - the chassis slot number is the same as a Primary CMTS module slot when a Primary CMTS module slot is active and when the Standby CMTS module slot is active, the Primary slot for which it is running is indicated

Red Slot Primary Slot

1-188

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Logging Status

full indicates that CMTS information has been fully replicated to the Standby CMTS module for this slot inactive indicates that the CMTS is not running or has no redundant slot to which to replicate. partial indicates that replication is currently underway - a CMTS cannot be forced to switchover until it has completed replication. If a failure occurs in this situation, auto-takeover will still takeover - only manual takeover will not work.

Manual Takeovers Auto-takeovers

the number of operator-requested takeovers the number of takeovers prompted by a CMTS module failure, reset, or de-insertion each takeover count represents the number of times that a slot has been taken over for (For example, the takeover counts for slot 3 gives the number of times that slot 6 (Standby CMTS Module) has taken over for slot 3 - the takeover counts for slot 6 give the number of givebacks from slot 6) the time in dd:mm:ss since the last chassis boot when the Primary CMTS Module was not active and the Standby CMTS Module did not takeover for it the time in dd:mm:ss since the Standby CMTS Module has taken over for the Primary CMTS Module

Unavailable Time

Time Since Failover

The following is an example of typical screen output from the show redundancy cmts command:

Compass ID: 271820115 Version 3

1-189

BSR 64000 Command Reference Guide

Release 5.0.0

CMTS Slot 5 6 9

Sub Type 2x8(2.0) 2x8 2x8

Slot Status boot boot boot

Red Slot -

Primary Slot 5 9

Logging Status inactive inactive inactive

Manual Takeovers 0 0 0

Auto Takeovers 0 0 0

Unavail Time 0:00:00 0:00:00 0:00:00

Time Since Failover 0:00:00 0:00:00 0:00:00

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show redundancy cmts [ | {begin | exclude | include} {} [ | {count | count-only}]] show redundancy cmts [ | {count | count-only}]

Command Syntax
| begin exclude include WORD turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string

1-190

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

count count-only

count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-191

BSR 64000 Command Reference Guide

Release 5.0.0

show redundancy srm
The show redundancy srm command tracks takeover statistics on the SRM module in a chassis. When a manual or an automatic takeover occurs, this will be reflected in the statistics for that SRM module by showing an increase in takeovers for the respective field on the respective module (the one that was just taken over). The command displays the SRM module slot number, subtype, status, redundant slot number, primary slot number, number of manual takeovers, number of automatic takeovers, and the time since its last failover. The time since failover on a certain module will display the amount of time since the respective module was last taken over. The following displays typical screen output for the show redundancy srm command:

SRM Slot 7

Sub Type SRM3

Slot Status RUN

Red Slot -

Primary Slot 7

Manual Takeovers 0

Auto Takeovers 0

Time Since Failover 0:00:00

Group Access
All

Command Mode
All modes except for User EXEC mode

Command Line Usage show redundancy srm [ | {begin | exclude | include} {} [ | {count | count-only}]]

Command Syntax
| begin exclude include turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string

1-192

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

WORD count count-only

the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-193

BSR 64000 Command Reference Guide

Release 5.0.0

show reload
The show reload command displays the status of a Hitless Upgrade in progress after a software reload of all modules in the BSR chassis has been initiated with the reload switched command.

Last reload reason: power reset No reload is scheduled

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show reload

1-194

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show running-config
The show running-config command displays configuration information currently running on the BSR.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show running-config [interface [cable ethernet | gigaether | | pos | loopback | tunnel ]] [ | {begin | exclude | include} {} [ | {count | count-only}]] show running-config [interface [cable ethernet | gigaether | | pos | loopback | tunnel ]] [ | {count | count-only}] show running-config verbose [ | {begin | exclude | include} {} [ | {count | count-only}]] show running-config verbose [ | {count | count-only}] show running-config security [ | {begin | exclude | include} {} [ | {count | count-only}]] show running-config security [ | {count | count-only}]

Command Syntax interface cable X/Y ethernet X/Y gigaether X/Y loopback 1-255 display running configuration information on all interfaces or a specific interface card the CMTS slot and MAC Domain number on the BSR the Ethernet/Fast Ethernet IEEE 802.3 slot and port number on the BSR the Gigabit Ethernet slot and port number on the BSR the loopback interface number

Compass ID: 271820115 Version 3

1-195

BSR 64000 Command Reference Guide

Release 5.0.0

pos X/Y tunnel 0-255 verbose security

the Packet over SONET slot and port number on the BSR the tunnel interface number runs the show running-config command in verbose mode displays security privilege information Note: the security option is only available to a user logged in as securityuser - refer to Configuring Cable Intercepts in the BSR 64000 CMTS Configuration and Management Guide turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

| begin exclude include WORD count count-only

1-196

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show srm alias
The show srm alias command is used to show the alias name for the SRM module.

Group Access
All

Command Mode
All except User EXEC

Command Line Usage show srm alias

Compass ID: 271820115 Version 3

1-197

BSR 64000 Command Reference Guide

Release 5.0.0

show srm assetid
The show srm assetid command is used to view the asset ID number assigned to the SRM.

Group Access
All

Command Mode
All except User EXEC

Command Line Usage show srm assetid

1-198

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show srm serial-num
The show srm serial-num command is used to view the serial number assigned to your SRM.

Group Access
All

Command Mode
All except User EXEC

Command Line Usage show srm serial-num

Compass ID: 271820115 Version 3

1-199

BSR 64000 Command Reference Guide

Release 5.0.0

show startup-config
The show startup-config command displays the contents of the system startup configuration file.

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage show startup-config [security] [ | {begin | exclude | include} {} [ | {count | count-only}]] show startup-config [security] [ | {count | count-only}]

Command Syntax security displays security privilege information Note: the security option is only available to a user logged in as securityuser - refer to Configuring Cable Intercepts in the BSR 64000 CMTS Configuration and Management Guide turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string

| begin exclude include WORD

1-200

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

count count-only

count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-201

BSR 64000 Command Reference Guide

Release 5.0.0

show stats fastpath
The show stats fastpath command allows a user to view various fastpath statistical information. The following is an example of typical screen output from the show stats fastpath command:

FastPath Statistics:

IP ----------

Unicast ---------Packets Header errors Version errors TTL errors Checksum errors Length errors Protocol errors Source address errors Destination address errors Forwarded packets Forwarded tunnel packets To SRM De-encapsulated Discards Dropped : : : : : : : : : : : : : : : 153018 0 0 0 0 0 0 0 0 147876 0 5142 0 0 0

Group Access
All

Command Mode
All modes

1-202

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Command Line Usage show stats fastpath [ | {begin | exclude | include} {} | {count | count-only}] show stats fastpath [ | {count | count-only}]

Command Syntax
NUM | begin exclude include WORD count count-only the BSR slot number containing the HSIM module turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-203

BSR 64000 Command Reference Guide

Release 5.0.0

show stats summary error
The show stats summary error command displays FEC error counts and ratios. The following is an example of typical screen output from the show stats summary error command:

MAC Address 0008.0e16.e6e2 0008.0e16.f954 00e0.0c60.02b4

I/F 0/0/U1 0/0/U1 0/0/U1

SID 2 1 3

CorrFec Count 0 0 0

CorrFec Ratio 0.00000000 0.00000000 0.00000000

UnCorrFec Count 0 0 0

UnCorrFec Ratio 0.00000000 0.00000000 0.00000000

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show stats summary error [sid | slot ]

Command Syntax sid 1-2049 display cable modem service flow identifier (SID) Forward Error Correction (FEC) error counts and ratios display FEC error counts and ratios for a particular chassis slot

slot NUM

1-204

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show stats xfabric
The show stats xfabric command displays downstream and upstream successfully transmitted packet counts and dropped or aborted packet counts for the switch fabric. The following is an example of typical screen output from the show stats xfabric command:

Downstream --------Packet Count Drop Count Upstream --------Packet Count Abort Count

: :

44907 0

: :

44907 0

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show stats xfabric

Command Syntax
NUM the BSR slot number

Compass ID: 271820115 Version 3

1-205

BSR 64000 Command Reference Guide

Release 5.0.0

show system
This show system command displays various operating information for the BSR 64000. The following is an example of typical screen output from the show stats system command:

Station-ID (mac) -------------------00:30:b8:c6:5c:00

Uptime h:m:s ------------3:49:04

Model Serial # HW SW --------- ---------- ------------ ---------BSR 64000 027006554 CHS-0009-01 4.2.0T00P43.H14.KRBU Module Status Temperature Low High ---------- --------- ----------- ----- ----SRM (750) ok 25C 77F 0C 65C SRM (DIMM) ok 29C 84F 0C 65C SRM (DC2DC) ok 28C 82F 0C 65C SRM (XFAB) ok 42C 107F 0C 80C Fan Temp ok 28C 82F 0C 50C CO Alarm Severity ------------------Critical Major Minor Number Active ------------0 0 0

1-206

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

The following information is provided: Station-ID a proper indication of which MAC address is being used for the system and can be either the SRM7/SRM8 or Chassis MAC ID the routing module’s uptime in hh:mm:ss format - use the show chassis status command for information on other modules Motorola identifiers that can also be retrieved with the show version command for the current master SRM

Uptime

Model/Serial #

Module temperature and status and the number of each class of alarms are also displayed.

Compass ID: 271820115 Version 3

1-207

BSR 64000 Command Reference Guide

Release 5.0.0

Note: The value displayed with the sysUpTime SNMP MIB object and the "UpTime" field as displayed in the show system command output represent different system up time values. The sysUpTime MIB object represents the amount of time that the SNMP Agent has been running. This is relative to the time that the SNMP Agent was last restarted. Initially, this will be close to the time that the SRM module last restarted because the SNMP Agent resides on the SRM module. However, if the SNMP Agent itself is restarted with the snmp-server shutdown or snmp-server enable CLI commands, the sysUpTime will be reset to zero. The "UpTime" value displayed in the show system command output represents the amount of time that the modules have been running relative to the last reboot of the chassis or last reset of the modules. These system time values may be different for each module, even after a reboot of the entire chassis, because not all modules complete their initialization at the same time. Also, the system time values will be different if individual modules are restarted via the CLI or are manually inserted at a later time. However, the per-module 'UpTime" values displayed in the show system command output are NOT affected by the snmp-server shutdown and snmp-server enable commands because these values are relative to the module’s boot time not to the SNMP Agent’s boot time.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show system [ | {begin | exclude | include} {} [ | {count | count-only}]] show system [ | {count | count-only}]

1-208

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-209

BSR 64000 Command Reference Guide

Release 5.0.0

show system alarms
The show system alarms command provides a summary of alarm information for the entire BSR 64000. The alarm summary display can be filtered according to whether the alarm is active, critical, major, or minor. The following is an example of typical screen output from the show stats alarms command:

CO Alarm Severity Number Active ------------------- ------------Critical 0 Major 0 Minor 0 BSR64K-9:7A#sho sys BSR64K-9:7A#sho system al BSR64K-9:7A#sho system alarms Alarm Summary Alarms Active Disabled Severity Error -------------- ------ -------- -------- ----------------------Power A Power B Top Fan Bot Fan Fan Temp Temp 750 Temp DIMM Temp DC2DC Temp XFab SRM I2C FAN I2C x -

The following information is provided:

Group Access
All

Command Mode
All modes except User EXEC
1-210 Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Alarms

the BSR component for which the alarm is valid: Power A Power B Top Fan Bot Fan Temp Fans Temp 750 Temp DIMM Temp DC2DC Temp XFab SRM I2C FAN I2C indicates if there is an active alarm per component - an "x" is present in the Active column if the current alarm is triggered an "x"' is present in the Disabled column if the current alarm will suppress an audio/ visual event, SYSLOG, and/or SNMP traps the severity level of the alarm - depending on severity, the severity column will indicate "Critical", "Major", or "Minor" matching the led (s) on the front of the BSR 64000 chassis the Error column is used to display a message sent to the central alarm component when an error occurs - two examples of possible error messages are: 2. "Fan Tray Communication Failed" - upon FAN I2C failure 3. "General Failure" - for Power A failure representing a case where a specific message was not supplied to the subsystem at the time of the alarm

Active

Disabled

Severity

Error

Compass ID: 271820115 Version 3

1-211

BSR 64000 Command Reference Guide

Release 5.0.0

Command Line Usage show system alarms [active | critical | major | minor] [ | {begin | exclude | include} {} [ | {count | count-only}]] show system alarms [active | critical | major | minor] [ | {count | count-only}]

Command Syntax active critical major minor | begin exclude include WORD count count-only display active alarms display critical alarms display major alarms display minor alarms turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

1-212

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show system fans
This show system fans command displays the current state of the fan tray subsystem. It is used for troubleshooting and operational verification. All alarm events are indicated with as corresponding error messages. The following is an example of typical screen output from the show stats fans command:

Fan Tray GLB: [ Top: [ Top: [ Bot: [ Bot: [

Alarm Status 0] Fan Trays Good 0] No Current Alarms 0] All Fans Good 0] No Current Alarms 0] All Fans Good

Top Fan Readings: ROM Rev# = 0x83 Status = [ 00] Alarm 1 = [ 00] Status 1 = [ 00] ThermOff1 = [ 4] Therm 1 = [ 137] Fan1Speed Fan3Speed Fan4Speed Buck PWM1 Buck PWM3 Buck PWM4 = = = = = = [ [ [ [ [ [ 94] 95] 95] 92] 97] 97]

28C

82F

2144rpms 2122rpms 2122rpms

AckCnt 1 = [ 0] MaxAckCnt1= [ 255] SetPnt SetPnt 1 = [ = [ 0] 94] 0rpms 2144rpms

Group Access
All

Command Mode
All modes except User EXEC

Compass ID: 271820115 Version 3

1-213

BSR 64000 Command Reference Guide

Release 5.0.0

Command Line Usage show system fans [ | {begin | exclude | include} {} [ | {count | count-only}]] show system fans [ | {count | count-only}]

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

1-214

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show tacacs
The show tacacs command displays statistics for all TACACS+ servers on the network including the IP address of the servers, connections, failed connection attempts, and packets sent and received. If there is more than one TACACS+ server configured, the command output displays statistics for all servers in the order in which they were configured. The following is an example of typical screen output from the show tacacs command:

Tacacs+ Server : 11.14.162.80/49 Number of Sessions: 1 Socket opens: 3 Socket closes: 3 Socket aborts: 0 Socket errors: 0 Socket Timeouts: 0 Failed Connect Attempts: 0 No current connection Session 1 Statistics Total Packets Sent: 7 Total Packets Recv: 7 Expected Replies: 0

Note: TACACS+ statistics can also be displayed with the show ip traffic command.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show tacacs

Compass ID: 271820115 Version 3

1-215

BSR 64000 Command Reference Guide

Release 5.0.0

show tacacs statistics
The show tacacs statistics command displays overall TACACS+ statistics including the total number of access (AAA) requests, the number of denied requests, and the number of allowed requests. The following is an example of typical screen output from the show tacacs statistics command:

TACACS+ Overall Statistics Number of access requests : 7 Number of access deny responses : 1 Number of access allow responses: 6

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show tacacs statistics

1-216

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show tech
The show tech command displays statistics and log information from the output of the following technical support related show commands: show chassis status show version show running-config show log show core log show ip traffic show stats xfabric show xfabric status show stats fastpath show stats lcpu show stats gige show stats bmeth show stats feth show controllers cable ds-mac show controllers cable ds-phy show controllers cable show interfaces cable service-class all show process memory show memory information show stats cmts show pool show pool application show process cpu show process memory sorted show process msg-q-info show process semaphores show process stack

■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■

Compass ID: 271820115 Version 3

1-217

BSR 64000 Command Reference Guide

Release 5.0.0

■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■

show evt show memory fastpath show interfaces show redundancy cmts show cable modem summary show cable modem summary total show bind show packet-cable cops inactive show packet-cable statistics show packet-cable statistics gate cops show l2-cam mac show l2-cam ip show l2-cam label show cable spectrum-group show cable downstream bonding-groups statistics

The display output of the show tech command is a compilation of the above show commands and can take several minutes to display on the screen. The output can also be saved to a file for later viewing. For a sample display of the output of the show tech command, see the individual show commands listed above. The show tech light version of the show tech command displays information that is helpful for trouble shooting. The show tech light command displays only dynamic information. The show tech command displays both dynamic and static information. Static commands are commands like show running config, show chassis status, show version and show log and are not included in the display output of the show tech light command. However, dynamic commands like show stats xfabric and show memory info are included in the display output of the show tech light command.

Note: The show tech command output will not display SNMP community and username or password entries.

1-218

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show tech [flash: | light | nvram: ]

Command Syntax flash: filename light output to a file on the Flash memory file system display abbreviated version of the show tech command - dynamic command information only output to a file on the NVRAM file system

nvram: filename

Compass ID: 271820115 Version 3

1-219

BSR 64000 Command Reference Guide

Release 5.0.0

show update
The show update command displays bypassed Resource Manager behaviors or ongoing or prior upgrade status for each slot on the BSR.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show update {bypass | status} [ | {begin | exclude | include} {} [ | {count | count-only}]] show update {bypass | status} [ | {count | count-only}}]

Command Syntax bypass status | begin exclude include WORD count count-only display bypassed Resource Manager behaviors display ongoing or prior upgrade status turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

1-220

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show user-group
The show user-group command displays the group access level for a specific CLI command. The group access levels are as follows: SYSADMIN ISP MSO RESTRICTED ALL access for users with System Administrator privileges access for users with Internet Service Provider privileges access for users with Multiple Service Operator privileges access for users with "restricted" privileges access for all users

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show user-group For example, entering the following: show user-group password telnet 0 test would return the following: The command "password telnet 0 test" is set to SYSADMIN access

Compass ID: 271820115 Version 3

1-221

BSR 64000 Command Reference Guide

Release 5.0.0

Command Syntax
WORD the command name - the complete command syntax must be entered otherwise the system will return an "is not a valid command" error message

1-222

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show users
The show users command displays information about active Telnet sessions including the username, user group and privilege level, the IP address of the originating host, and the session ID. The following is an example of typical screen output from the show users command:

Active connections user group/privilege origin session -----------------------------------------------------------------console sysadmin/rw console 0 enabled-user sysadmin/rw 10.14.37.103 1*

Group Access
All

Command Mode
Privileged EXEC and Global Configuration

Command Line Usage show users [ | {begin | exclude | include} {} [ | {count | count-only}]] show users [ | {count | count-only}]

Command Syntax
| begin exclude include WORD turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string

Compass ID: 271820115 Version 3

1-223

BSR 64000 Command Reference Guide

Release 5.0.0

count count-only

count the number of outputted lines count the number of lines while suppressing screen output

1-224

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show vectron slot
The show vectron slot command displays the version of the Vectron TRU clock/data recovery chip resident on a specified slot in the BSR chassis. The following is an example of typical screen output from the show vectron slot command:

Vectron time module version CL 4/27/2005 * BL 10/19/2004* FL 10/19/2004* GA 10/19/2004*

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show vectron slot [ | {begin | exclude | include} {} [ | {count | count-only}]] show vectron slot [ | {count | count-only}]

Command Syntax
0-15 | begin exclude include WORD the BSR chassis slot number turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string

Compass ID: 271820115 Version 3

1-225

BSR 64000 Command Reference Guide

Release 5.0.0

count count-only

count the number of outputted lines count the number of lines while suppressing screen output

1-226

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

show version
The show version command displays the configuration of the system hardware, the software version, the names and sources of configuration files, and the boot images. The following is typical screen output from the show version command:

Slot07 Master SRM3 Versions: Boot ROM: RDN 4.1.0.02 Created: Mon Sep 13 13:27:33 EDT 2004 System Image: 4.2.0T00P35.H11.KRAU Date Built: Wed Oct 26 10:48:32 EDT 2005 CPU: MPC750-MPC8260 Memory Size: 256 MB Format Version: 4 Assembly Type : 1 Part Number : PCA-0005-03 HW Revision : R Serial Number : 027004822 Mac Address : 00:30:b8:01:bc:00 Product Number: BSR 64000 SFB FPGA Version: 1015

The table below describes the displayed fields: Slot the type of module present in the slot such as 2:8 CMTS, 2:8 CMTS (2.0), Gigabit Ethernet, Ethernet, POS OC12/ POS OC3, Supervisory Routing Module (SRM3 or SRM4), etc. the boot version the current software version running on the module the date the above version was built the processor type name the processor memory size

Boot ROM: System Image: Date Built: CPU: Memory Size:

Compass ID: 271820115 Version 3

1-227

BSR 64000 Command Reference Guide

Release 5.0.0

Depending on the module type, the remaining output in each show version display shows the format version, assembly type, hardware revision, serial, part, and product numbers, FPGA Version number, and buffer management information.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show version [slot ] [ | {begin | exclude | include} {} [ | {count | count-only}]] show version [slot ] [ | {count | count-only}]

1-228

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

Command Syntax slot 0-15 | begin exclude include WORD count count-only slot in the BSR 64000 chassis slot number from which version information is to be displayed turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

1-229

BSR 64000 Command Reference Guide

Release 5.0.0

show xfabric
The show xfabric command displays keepalive status and configuration information for all switch fabric keepalives and the status of all operational slots.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show xfabric {keepalive | status} [ | {begin | exclude | include} {} [ | {count | count-only}]] show xfabric {keepalive | status} [ | {count | count-only}}]

Command Syntax keepalive status | begin exclude include WORD count count-only display the switch fabric keepalive configuration display status of operational slots turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

1-230

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

The following is an example of typical screen output from the show xfabric keepalive command:

Status Features

: xfabric keepalive enabled : icp keepalive enabled : xfabric(monitor, 880-recover, slot-recover, cmts-rebind)

: icp(monitor, slot-reset ) Thresholds: xfabric (monitor 3, 880-recover 10, slot-recover 60, cmts-rebind 5) : icp (monitor 10, slot-reset 10) Keepalive Retransmit Counts: Slot xfabric ICP ---------------------1 : 1 0

The following is an example of typical screen output from the show xfabric status command:

Slot 1 14 10 0 15 7

Sync normal normal normal normal normal normal

Status ok ok ok ok ok ok

Compass ID: 271820115 Version 3

1-231

BSR 64000 Command Reference Guide

Release 5.0.0

slot
The slot command enters Slot Configuration mode for a specified BSR slot from Global Configuration mode. To return to Global Configuration mode, use the end command.

Group Access
All

Command Mode
Global Configuration

Command Line Usage slot Command Syntax
NUM the specified BSR slot number

1-232

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

speed
The speed command specifies the speed at which the Ethernet interface operates. The default speed is auto-negotiated but the speed can be manually set to either 10 Mbps or 100 Mbps.

Group Access
ISP

Command Mode Interface Configuration (Ethernet interface only) Command Line Usage speed {100 | 10 | auto} no speed {100 | 10 | auto}

Command Syntax
100 10 auto 100 Mbps 10 Mbps autonegotiate the connection speed (100 Mbps or 10 Mbps) with the device at the other end of the physical connection.

Command Default
Auto negotiation enabled

Compass ID: 271820115 Version 3

1-233

BSR 64000 Command Reference Guide

Release 5.0.0

srm alias
The srm alias command is used to configure an alias name for the SRM module.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage srm alias

Command Syntax string the SRM alias name - enclose the alias name within quotation marks if the string contains spaces

1-234

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

srm assetid
The srm assetid command is used to configure your organization’s asset ID number that is assigned to the SRM module.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage srm assetid

Command Syntax string the SRM alias name - enclose the alias name within quotation marks if the string contains spaces

Compass ID: 271820115 Version 3

1-235

BSR 64000 Command Reference Guide

Release 5.0.0

srm assetid
The srm assetid command is used to configure your organization’s asset ID number that is assigned to the SRM module.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage srm assetid

Command Syntax string the SRM asset ID number - enclose the alias name within quotation marks if the string contains spaces

1-236

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

sync file
The sync file command synchronizes all files stored in Flash memory or NVRAM between an Active SRM and a Standby SRM including the startup and running configuration files.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage sync file {flash: | nvram:}

Command Syntax flash: nvram: synchronize files from Flash memory synchronize files from NVRAM

Compass ID: 271820115 Version 3

1-237

BSR 64000 Command Reference Guide

Release 5.0.0

tacacs reset-connections
The tacacs reset-connections command is used to reset all the TACACS+ server connections and associated sessions. After reset, all connections will be re-established. The tacacs reset-connections command is useful to initiate a reset and re-establish the existing connections after making any connection-specific configuration changes.

Group Access
All

Command Mode
Global Configuration

Command Line Usage tacacs reset-connections

1-238

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

tacacs-server host
The tacacs-server host command is used to specify and configure individual TACACS+ servers. The command can also be used to configure multiple TACACS+ servers. The TACACS+ client will contact the servers in the order in which they are specified.The no tacacs-server host command removes a TACACS+ server from the list. Note: Since the key, port, retry, and timeout parameters specified with the tacacs-server host command override any global settings made by the tacacs-server key, tacacs-server port, tacacs-server retry, and tacacs-server timeout commands, the tacacs-server host command can be used to enhance network security by uniquely configuring individual TACACS+ servers.

Group Access
All

Command Mode
Global Configuration

Command Line Usage tacacs-server host { | } [key | port | retry | single-connection | timeout ] no tacacs-server host [ | ]

Command Syntax key WORD specifies an authentication and encryption key - specifying a key with this command overrides the global key specified by the tacacs-server key command for this TACACS+ server only specifies a server port number - this value overrides the global port number value set with the tacacs-server port command for this TACACS+ server only

port 0-65535

Compass ID: 271820115 Version 3

1-239

BSR 64000 Command Reference Guide

Release 5.0.0

retry 0-100

specifies a retry value - this value overrides the global retry value set with the tacacs-server retry command for this TACACS+ server only opens a new TCP connection for every TACACS session established specifies a timeout value in seconds - this value overrides the global timeout value set with the tacacs-server timeout command for this TACACS+ server only

single-connection timeout 1-1000

1-240

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

tacacs-server key
The tacacs-server key command is used to specify a global authentication encryption key used for all TACACS+ communications between the TACACS+ client and the TACACS+ server. A global encryption key is used if no encryption key is specifically configured for this TACACS+ server. The no tacacs-server key disables authentication encryption. Note: The key entered must match the key used on the TACACS+ server. All leading spaces are ignored; spaces within and at the end of the key are not. If spaces are used within the key, the key should not be enclosed in quotation marks unless the quotation marks themselves are part of the key.

Group Access
All

Command Mode
Global Configuration

Command Line Usage tacacs-server key no tacacs-server key

Command Syntax
WORD specifies an authentication and encryption key - this key must match the key used by the TACACS+ server and is limited to 127 characters

Compass ID: 271820115 Version 3

1-241

BSR 64000 Command Reference Guide

Release 5.0.0

tacacs-server port
The tacacs-server port command to specify a global port number for all communication between the TACACS+ server and the TACACS client. A global port number is used if no port number is specifically configured for this TACACS+ server. The no tacacs-server port command restores the default port number value of 49.

Group Access
All

Command Mode
Global Configuration

Command Line Usage tacacs-server port no tacacs-server port

Command Syntax
0-65536 specifies the global port number used for all communication between the TACACS+ server and the TACACS client.

Command Default
49

1-242

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

tacacs-server retry
The tacacs-server retry command is used to globally specify a retry count for all TACACS+ servers. A global retry count is used if no retry count is specifically configured for this TACACS+ server. The no tacacs-server retry command restores the global default value of 3 retries.

Group Access
All

Command Mode
Global Configuration

Command Line Usage tacacs-server retry no tacacs-server retry

Command Syntax
0-100 the retry count

Command Default
3 retries

Compass ID: 271820115 Version 3

1-243

BSR 64000 Command Reference Guide

Release 5.0.0

tacacs-server timeout
The tacacs-server timeout command is used to specify a global timeout interval for all TACACS+ servers. A global timeout value is used if no timeout value is specifically configured for this TACACS+ server. The no tacacs-server timeout command restores the global default timeout value or specifies another value.

Group Access
All

Command Mode
Global Configuration

Command Line Usage tacacs-server timeout no tacacs-server timeout []

Command Syntax
1-1000 timeout value in seconds.

Command Default
10 seconds

1-244

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

telnet
The telnet command establishes a telnet connection between the BSR and a remote system.

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage telnet { | } []

Command Syntax
A.B.C.D WORD 0-65535 the IP address of the remote system the hostname of the remote system the destination port of the remote system

Compass ID: 271820115 Version 3

1-245

BSR 64000 Command Reference Guide

Release 5.0.0

telnet authentication radius
The telnet authentication radius command enables RADIUS authentication for telnet access. The no telnet authentication radius command disables this feature.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage telnet authentication radius [ fail-message | local-password ] no telnet authentication radius [ fail-message | local-password ]

Command Syntax fail-message LINE local-password specify message to display for a failed login/ authentication authenticate with a locally configured password if there is no response from the RADIUS server

1-246

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

telnet session-limit
The telnet session-limit command specifies a limit on the number of concurrent telnet sessions allowed to the BSR. Setting the session-limit to "0" will disallow any telnet sessions from being accepted. Setting a session-limit value will not affect any currently open telnet sessions. The no telnet session-limit command restores the default session limit of 16 concurrent telnet sessions.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage telnet session-limit no telnet session-limit []

Command Syntax
0-16 the telnet session limit number

Command Default
16

Compass ID: 271820115 Version 3

1-247

BSR 64000 Command Reference Guide

Release 5.0.0

update bypass
The update bypass command bypasses specified Resource Manager behaviors.

Group Access
All

Command Mode
Privileged EXEC and Global Configuration

Command Line Usage update bypass {all | boot | download | format | reset} [] no update bypass {all | boot | download | format | reset} []

Command Syntax all boot download format bypass all configurable behaviors bypass boot command to daughter card bypass behavior for default and forced download bypass slot format - causes the spare SRM to format the target boot device before receiving a new application image bypass slot reset slot number of the BSR 64000 chassis

reset 0-15

1-248

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

update chassis
The update chassis command allows a runtime upgrade of the BSR 64000 I/O module bootrom, the FPGA, and applications.

Note: Using the update chassis command may result in an audible loss of voice-over-IP data for up to 20 seconds

Group Access
All

Command Mode
Privileged EXEC and Global Configuration

Command Line Usage update chassis {flash: | ftp: | nvram: | tftp: } [reload]

Command Syntax flash: ftp: nvram: tftp: filename reload upgrade from archive in flash: copy to nvram: and upgrade upgrade from archive in nvram: copy to nvram: and upgrade filename of the boot image stored in flash, NVRAM, or an FTP or TFTP server set bootfile and perform reload

Compass ID: 271820115 Version 3

1-249

BSR 64000 Command Reference Guide

Release 5.0.0

update slot
The update slot command allows a user to perform a runtime upgrade of a Boot ROM on a single module with a single command instead of having to use the additional upgrade steps necessary when using the update bypass all command.

Group Access
All

Command Mode
Privileged EXEC and Global Configuration

Command Line Usage update slot {all | app | boot | fpga} [flash: | nvram:] Note: Entering the update slot command without specifying a boot image initiates an update from the boot system image. Otherwise, the update slot command attempts the specified upgrade type (all, app, boot, or fpga) using the specified boot image.

Command Syntax
NUM all app boot fpga flash: nvram: the slot number for a module installed in the BSR chassis upgrade all updates upgrade application upgrade boot image upgrade FPGA(s) upgrade from archive in the Flash memory file system upgrade from archive in the NVRAM file system

1-250

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

username
The username command establishes a login authentication system based on a

username.
Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage username password [ 0 | 7 ] username nopassword

Command Syntax
WORD nopassword password the username, up to 16 characters no password is required for the user to log in specify a password for the user (31 character maximum) - enclosed with double quotes if the key contains spaces). The "%" and "!" characters must not be used. specifies an UNENCRYPTED password specifies a HIDDEN password will follow the UNENCRYPTED (cleartext) user password (31 character maximum) - enclosed with double quotes if the key contains spaces). The "%" and "!" characters must not be used.

0 7 WORD

Compass ID: 271820115 Version 3

1-251

BSR 64000 Command Reference Guide

Release 5.0.0

Note: Refer to Defining a User Name with an Encrypted Password in the BSR 64000 Configuration and Management Guide for Release 3.1 for details on encrypting passwords.

1-252

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

username privilege
The username privilege command sets a privilege level for a user.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage username privilege {ro | rw}

Command Syntax
WORD privilege ro rw the username, up to 16 characters the user privilege level read-only privilege read and write privilege

Compass ID: 271820115 Version 3

1-253

BSR 64000 Command Reference Guide

Release 5.0.0

username user-group
The username user-group command assigns a user to a user group. The no username user-group command removes a user from a user group.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage username user-group {isp | mso | restricted | sysadmin} no username user-group {isp | mso | restricted | sysadmin}

Command Syntax
WORD user-group isp the username, up to 16 characters assigns the user group name provides this user access to most CLI commands including routing commands but excluding cable commands the number of the virtual ISP provides this user access to most CLI commands including cable commands but excluding routing commands only provides this user access to CLI commands with a designated privilege level of "restricted" as defined with the privilege restricted CLI command. provides this user access to all CLI commands

1-1 mso

restricted

sysadmin

1-254

Compass ID: 271820115 Version 3

Release 5.0.0

System Administration Commands

xfabric keepalive
The xfabric keepalive command enables the switch fabric keepalive timer and specifies the type of system reaction in the event of a switch fabric failure. The no xfabric keepalive command disables the switch fabric keepalive timer. Note: Motorola recommends always enabling the xfabric keepalive slot-recover command and copying the running configuration to the startup configuration. This causes the BSR to reset a slot which fails to respond to a 1-second switch fabric keepalive message for 10 consecutive intervals. If for any reason a customer's configuration or traffic level results in undesirably frequent slot resets, the threshold number of intervals can be increased to intervals with the xfabric keepalive slot-recover threshold command.

Group Access
All

Command Mode
Global Configuration

Command Line Usage xfabric keepalive { 880-recover | cmts-rebind | hsim-warmstart | monitor | slot-recover} [threshold ] no xfabric keepalive [880-recover | cmts-rebind | monitor | slot-recover ] [threshold] no xfabric keepalive threshold

Command Syntax
880-recover cmts-rebind hsim-warmstart initiate 880-recover if switch fabric is not operational rebind all CMTS modules to available HSIM modules if the data path is not operational initiate HSIM warmstart if the data path is not operational

Compass ID: 271820115 Version 3

1-255

BSR 64000 Command Reference Guide

Release 5.0.0

monitor slot-recover threshold 1-255 threshold

system logger notification only initiate a slot recovery reset if the switch fabric is not operational configures the number of 2.5 second timeouts until an action is taken restores the default threshold value for the no xfabric keepalive 880-recover, cmts-rebind, hsim-warmstart, monitor, and slot-recover commands - the no xfabric keepalive threshold command restores all default threshold values

Command Defaults
880-recover cmts-rebind hsim-warmstart monitor slot-recover 880-recover threshold cmts-rebind threshold Disabled Disabled Disabled Disabled Disabled 5 15

hsim-warmstart threshold 10 monitor threshold slot-recover threshold 10 60

1-256

Compass ID: 271820115 Version 3

2
IP Commands

Introduction
This chapter describes the following types of commands for the BSR: Interface commands not associated with a specific protocol can be used to configure interface features with any device on the network. Transmission Control Protocol/Internet Protocol (TCP/IP) commands handle network communications between network nodes. This includes network addressing information, control information that enables packets to be routed, and reliable transmission of data. Address Resolution Protocol (ARP) commands map IP addresses to physical hardware addresses. An ARP cache is used to maintain a correlation between each MAC address and its corresponding IP address. Domain Name System (DNS) commands are used to dynamically map hostnames to IP addresses and to control Internet routing information. Lists of domain names and IP addresses are distributed throughout the Internet by DNS servers. Simple Network Time Protocol (SNTP) commands are used to synchronize computer clocks in the global internet. SNTP operates in unicast, broadcast, and IP multicast modes. Tunneling commands provide a way to encapsulate packets inside of a transport protocol. IP in IP Encapsulation for tunnel interfaces is supported by the BSR.
Compass ID: 271820115 Version 3 2-1

BSR 64000 Command Reference Guide

Release 5.0.0

IP Command Descriptions
This section contains an alphabetized list and descriptions of the IP commands supported by the BSR.

2-2

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

arp
The arp command adds a permanent entry in the ARP cache. The no arp command removes the entry from the ARP cache. The arp command can also specify the type of ARP packet that is used, whether to use an alias if proxy arp is enabled, and to specify a cable bundle interface if cable bundling is being used. Note: Proxy ARP is not enabled by default. ARP cache entries map IP addresses and their associated 48-bit hardware MAC addresses. If the host supports dynamic resolution, static entries are usually not needed. Use the clear arp-cache command to remove all dynamically learned entries.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage arp {arpa | snap} [alias | cablebundle cable | cm-hardware-address ] no arp {arpa | snap} [alias | cablebundle cable | cm-hardware-address ]

Command Syntax
A.B.C.D H.H.H arpa snap alias IP address of ARP entry associated with the local data link address 48-bit local data link address (MAC address), format xxxx.xxxx.xxxx standard Ethernet-style ARP, RFC 826 IEEE 802.3 usage of ARP packets conforming to RFC 1042 respond to ARP as if it owns the specified address, if proxy arp is enabled

Compass ID: 271820115 Version 3

2-3

BSR 64000 Command Reference Guide

Release 5.0.0

cablebundle cable X/Y slot X and MAC domain Y of the cable bundle physical interface on the CMTS module cm-hardware-address H.H.H MAC address of the cable modem, format xxxx.xxxx.xxxx

Command Default no entries in table arpa (ethernet ARP)

2-4

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

arp timeout
The arp timeout command configures the amount of time an entry stays in the ARP cache. The no arp timeout command removes the time configuration an entry stays in the ARP cache. Use the show interfaces command in Privileged EXEC mode to view the ARP time-out value. Note: If the ARP time-out value is changed, the new value affects all the existing entries in the ARP cache and any entries subsequently added to the ARP cache.

Group Access
MSO

Command Mode
Interface Configuration

Command Line Usage arp timeout no arp timeout

Command Syntax
4-6000 amount of time, in minutes, that an entry is allowed to stay in the ARP cache

Command Default
60 minutes

Compass ID: 271820115 Version 3

2-5

BSR 64000 Command Reference Guide

Release 5.0.0

cable helper-address
The cable helper-address command enables broadcast forwarding for User Datagram Protocol (UDP) packets. The cable helper address function disassembles a DHCP broadcast packet and reassembles it into a unicast packet so that the packet can traverse the router and communicate with the DHCP server. The cable helper-address command is also used to bind a cable helper address to a secondary IP subnet of a CM connected to CPEs belonging to a particular ISP. This allows CPEs to have their IP address assigned from the DHCP server belonging to the corresponding ISP.

Note: The isp-bind option is only available after selecting the host or mta options. It is not available for the cable modem option.

Group Access
ISP

Command Mode
Interface Configuration (cable and loopback interfaces only)

Command Line Usage cable helper-address {cable-modem | host | mta} [isp-bind | global ] no cable helper-address {cable-modem | host | mta} [isp-bind | global ]

Command Syntax
A.B.C.D cable-modem host mta IP address of the destination DHCP server only CM UDP broadcasts are forwarded only CPE UDP broadcasts are forwarded only MTA UDP broadcasts are forwarded

2-6

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

isp-bind A.B.C.D global

secondary IP subnet to which the cable-helper is bound cable-helper is on the global network

Compass ID: 271820115 Version 3

2-7

BSR 64000 Command Reference Guide

Release 5.0.0

clear arp-cache
The clear arp-cache command clears all dynamic entries or a specific entry from the ARP cache.

Group Access
ISP

Command Mode
Privileged EXEC

Command Line Usage clear arp-cache []

Command Syntax
A.B.C.D IP address entry to be cleared from the ARP table

2-8

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

clear counters
The clear counters command is used to clear a specific interface counter or all interface counters.

Group Access
ISP

Command Mode
Privileged EXEC

Command Line Usage clear counters [cable | ethernet | gigaether | ipsec | loopback | pos | tunnel ]

Command Syntax cable X/Y cable X/Y.N ethernet X/Y gigaether X/Y gigaether X/Y.N ipsec loopback 1-255 tunnel 0-255 pos X/Y clear the cable counters for the specified slot X, port Y, and if applicable, sub-interface N clear the Ethernet counters for the specified slot X and port Y clear the Gigabit Ethernet counters for the specified slot X, port Y, and if applicable, sub-interface N clear the IPSEC counters clear the loopback counters for the specified loopback interface number clear the tunnel interface counters for the specified tunnel interface number clear the Packet over SONET (POS) counters for the specified slot X and port Y

Compass ID: 271820115 Version 3

2-9

BSR 64000 Command Reference Guide

Release 5.0.0

clear host
The clear host command deletes DNS host entries from the host-name-and-address cache.

Group Access
ISP

Command Mode
Privileged EXEC

Command Line Usage clear host { | *}

Command Syntax
Word * delete a specific DNS hostname entry delete all DNS hostname entries

2-10

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

clear ip route
The clear ip route command deletes route table entries.

Group Access
ISP

Command Mode
Privileged EXEC

Command Line Usage clear ip route {* | []}

Command Syntax
* A.B.C.D A.B.C.D delete all routes destination network route to delete destination network subnet mask

Compass ID: 271820115 Version 3

2-11

BSR 64000 Command Reference Guide

Release 5.0.0

clear ip traffic
The clear ip traffic command resets the IP traffic statistic counters to zero.

Group Access
ISP

Command Mode
Privileged EXEC

Command Line Usage clear ip traffic

2-12

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

clear sntp history
The clear sntp history command removes servers from the SNTP server history list displayed by the show sntp command and the show sntp detail command. To remove a specific SNTP server from the display, that particular SNTP server must be specified with the clear sntp history command. To remove all SNTP servers from the display, the clear sntp history command is used without specifying an individual SNTP server.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage clear sntp history [ | ]

Command Syntax
A.B.C.D Hostname the IP address of an SNTP server the hostname of an SNTP server

Command Default
All SNTP servers on the SNTP server list are displayed by the show sntp command and the show sntp detail command.

Compass ID: 271820115 Version 3

2-13

BSR 64000 Command Reference Guide

Release 5.0.0

host authorization
The host authorization command is used to enforce the binding of the CM and CPE MAC addresses to the IP address assigned to them (statically or through DHCP). The no host authorization command disables host authorization on the cable interface. The host authorization feature is used for security purposes on the cable network. When enabled, host authorization denies access to any hacker who tries to take or “spoof” an IP address from any legitimate user on the same cable network. A hacker takes the IP address from a user to steal their data service. The hacker accomplishes this by changing the IP address on their PC to the IP address that the DHCP server assigned to a legitimate user’s CPE. Cable operators can create static entries to deny hackers from stealing service from users. Through static entries, cable operators can manually bind the CPE MAC (hardware) and IP address to a particular cable modem. This command may be used in circumstances when DHCP is not used to assign the CPE IP addresses.

Group Access
ISP

Command Mode
Interface Configuration mode (cable interface only)

Command Line Usage host authorization { {cpe | cpr } | on} no host authorization on { {cpe | cpr } | on}

Command Syntax mac cpe cpr mac cable modem MAC address, format xxxx.xxxx.xxxx Customer Premises Equipment Customer Premise Router MAC address of the CPE or CPR, format xxxx.xxxx.xxxx

2-14

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

A.B.C.D on

IP address of the CPE or CPR enable host authorization

Command Default
Disabled

Compass ID: 271820115 Version 3

2-15

BSR 64000 Command Reference Guide

Release 5.0.0

interface
The interface command specifies an interface for further configuration. Once the interface is selected you enter Interface Configuration mode.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage interface {cable | ethernet | gigaether | loopback | pos | tunnel }

Command Syntax cable X/Y cable X/Y.N ethernet X/Y slot X, MAC domain Y, and, if applicable, the cable sub-interface N of the CMTS module slot X and port Y on the Ethernet interface: • • On the 8-port Ethernet module, there are 8 10/100 Mbps Ethernet ports On the SRM module, Ethernet interface 0 is a 10 Mbps management interface that does not support the negotiation feature and is associated with its corresponding port on the SRM I/O module Ethernet ports 1 and 2 are typically used to support an external T1/E1 BITS clock and are associated with their corresponding ports on the SRM I/O module gigaether X/Y gigaether X/Y.N slot X, port Y, and, if applicable, the sub-interface N of the 1000 Mbps optical Ethernet interface

2-16

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

loopback 1-255

loopback interfaces are used as inbound logical interfaces when physical interfaces go down - up to 255 loopback interfaces are supported slot X and port Y on the high speed OC3/OC12 SONET interface tunnels are logical interfaces used to make point-to-point links between two devices, up to 255 tunnels are supported

pos X/Y tunnel 0-255

Compass ID: 271820115 Version 3

2-17

BSR 64000 Command Reference Guide

Release 5.0.0

ip access-group
The ip access-group command configures an interface to use an access list. The no ip access-group command removes an access-list for the interface.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip access-group { | } {in | out} no ip access-group { | } {in | out}

Command Syntax
1-199 1300-2699 in out standard access-list number range extended access-list number range incoming packet is processed only if the source address is permitted by the access-list outgoing packet is processed only if access-list permits the packet

Command Default
No access groups defined.

2-18

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

ip address
The ip address command configures a primary or secondary IP address for an interface or defines the Gateway IP address (giaddr) for Customer Premises Equipment (CPE), Multimedia Telephone Adapter (MTA), or cable modem DHCP requests. The no ip address command is used to remove an IP address from the interface. The BSR now allows multiple BSRs connected to the same LAN (or VLAN) to share the same IP subnet by using the shared-proxy-arp option. An interface configured with the shared-proxy-arp option is allowed to share ARP resolutions with all Ethernet or Gigabit Ethernet interfaces configured with the ip proxy-arp command. When the BSR needs to resolve an IP address in a shared-proxy-arp IP subnet, it sends an ARP request upstream on the Ethernet or Gigabit Ethernet interfaces configured with the ip proxy-arp command and also sends the ARP request downstream on the cable interface(s) configured with the shared-proxy-arp option. The BSR then learns the host addresses of shared-proxy-arp IP subnets present on the Ethernet or Gigabit Ethernet interfaces configured with the ip proxy-arp command. Note: The shared-proxy-arp option must be specified after all other options. For example, when enabling shared-proxy-arp on a secondary host subnet, the secondary host options must be specified prior to the shared-proxy-arp option. When configuring the IP address of a cable or loopback interface, two additional options are supported; the host and mta options. The host and mta options are only available from cable or loopback interface configuration mode when selecting an IP address. During the DHCP process, the relay agent requests an IP address in a particular subnet by inserting the IP address of the interface into the DHCP requests from CMs, hosts, and MTAs. The primary address is always inserted in cable modem DHCP requests. If a secondary address or a secondary host address is defined, then the first secondary or secondary host IP address in the list is inserted into DHCP requests from hosts. If one or multiple secondary mta IP address are defined, then the first secondary mta IP address defined is inserted into DHCP requests from secondary MTA devices. The ip dhcp relay information option command must be enabled to allow the BSR to determine what type of device originated the DHCP request. By default, the primary address will be inserted into DHCP requests.

Compass ID: 271820115 Version 3

2-19

BSR 64000 Command Reference Guide

Release 5.0.0

The ip address command is also used to bind a secondary IP address to a secondary IP subnet of a CM which is connected to CPEs belonging to a particular ISP. This allows the BSR to set the giaddr of the CPE's DHCP packets to the secondary address of the CM to which the secondary addresses of the CPE are bound.

Note: You must configure a primary IP address before configuring any secondary IP addresses.

Note: The BSR supports 256 secondary IP subnets per CMTS module. The maximum number of secondary IP subnets that can be configured on the entire BSR chassis is 1024. If you are running a BCM 3140-based DOCSIS 2.0 2:8 CMTS module as two 1:4 configurations, the limit is still 256 secondary IP subnets for the entire 2:8 CMTS module. The total number of secondary IP subnets between MAC Domain 0 and MAC Domain 1 can only equal 256. Also, if you apply the same cable bundle to each MAC domain even though the secondary IP subnets are the same they must be counted twice. For example, if you have 256 secondary IP subnets in a cable bundle and you apply that cable bundle to two MAC domains, the total number of secondary IP subnets would be 512 which exceeds the limit for the DOCSIS 2.0 CMTS module. In this example, there can be no more than 128 secondary IP subnets on the cable bundle.

Group Access
ISP

Command Mode
Interface Configuration

2-20

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

Command Line Usage ip address {{}} [secondary] no ip address {{}} [secondary] Cable or Loopback interfaces only: ip address {{}} [shared-proxy-arp] ip address {{}} [secondary [ host | mta] [isp-bind | shared-proxy-arp]] ip address {{}} [secondary [shared-proxy-arp]] no ip address {{}} [shared-proxy-arp] no ip address { {}} [ secondary [ host | mta ][isp-bind ]] no ip address {{}} [secondary [shared-proxy-arp]]

Command Syntax
A.B.C.D A.B.C.D the IP address the subnetwork mask for the IP address - the BSR supports up to a 30-bit subnetwork IP address mask designates the specified IP address as a secondary IP address - on a cable interface, defines this IP address as the IP address to be inserted into host DHCP requests share ARP resolutions with Ethernet or Gigabit Ethernet interfaces configured with the ip proxy-arp command

secondary

shared-proxy-arp

Compass ID: 271820115 Version 3

2-21

BSR 64000 Command Reference Guide

Release 5.0.0

host

defines the IP address for the cable interface as the giaddr for host DHCP requests - on the cable interface, defines this IP address as the IP address to be inserted into host DHCP requests (this option is only available on the cable interface) defines the IP address for the cable interface as the giaddr for all MTA DHCP requests - on the cable interface, defines this IP address as the IP address to be inserted into MTA DHCP requests (this option is only available on the cable interface) specifies the secondary IP subnet to which this secondary address is bound.

mta

isp-bind A.B.C.D

2-22

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

ip broadcast-address
The ip broadcast-address command configures a broadcast address for an interface. The no ip broadcast-address command deletes the broadcast address for an interface.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip broadcast-address no ip broadcast-address

Command Syntax
A.B.C.D IP broadcast address assigned to the interface

Compass ID: 271820115 Version 3

2-23

BSR 64000 Command Reference Guide

Release 5.0.0

ip dhcp relay information
The ip dhcp relay information command enables the BSR to insert the DHCP relay information option (option-82) into received DHCP client messages being forwarded to a DHCP server (configured using the cable helper command). Support for DHCP Option-82, sub-option 2 (Agent Remote ID), which is enabled by the ip dhcp relay information option command, allows the relay agent in the BSR to insert the MAC address of the modem that the DHCP client is behind into outbound DHCP client requests (i.e., DHCP Discovers and DHCP Requests as they traverse the BSR). This enables the receiving DHCP server to identify the user sending the request and to treat that client appropriately. Support for DHCP Option-82, sub-option 1 (Agent Circuit ID), which is enabled by the ip dhcp relay information spectrum-group-name command, allows the relay agent in the BSR to insert, when available, the Spectrum Group name associated with the upstream channel that the DHCP client is using into outbound DHCP client requests (i.e., DHCP Discovers and DHCP Requests as they traverse the BSR).

The ip dhcp relay informationmulti-isp-enable command allows the BSR to insert the DHCP relay information option (option-82) into received DHCP client messages being forwarded to a DHCP server.
Note: If you are configuring two MAC domains on the 2x8 CMTS module, the ip dhcp relay information option command must be entered for each MAC domain. If this command is not entered in for each domain, CMs cannot register in that domain. Note: If a DHCP client on a particular subnet is using an upstream frequency that is not configured as a member of a Spectrum Group, the Spectrum Group name is not inserted by the DHCP relay agent into the DHCP discover packet.

Group Access
ISP

Command Mode
Interface Configuration (cable interface only)

2-24

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

Command Line Usage ip dhcp relay information { multi-isp-enable | option | spectrum-group-name} no ip dhcp relay information { multi-isp-enable | option | spectrum-group-name}

Command Syntax multi-isp-enable enables the insertion of the DHCP relay information option when multiple ISPs are used insert a MAC address (Agent Remote ID) only into a client’s DHCP discover packets insert the Spectrum Group name into all DHCP outbound requests

option spectrum-group-name

Compass ID: 271820115 Version 3

2-25

BSR 64000 Command Reference Guide

Release 5.0.0

ip domain-list
The ip domain-list command configures up to six domain names to resolve unqualified host names when the primary domain, specified by the ip domain-name command, fails to resolve. Use the ip domain-list command to define a list of secondary domain names. Secondary domain names are used if the primary domain name fails to resolve.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ip domain-list [] [] [] [] [] no ip domain-list [] [] [] [] []

Command Syntax
WORD domain name

2-26

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

ip domain-lookup
The ip domain-lookup command enables the IP Domain Name System (DNS) based host name-to-address translation. The no ip domain-lookup command disables the IP DNS-based name-to-address translation.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ip domain-lookup no ip domain-lookup

Command Default
Enabled

Compass ID: 271820115 Version 3

2-27

BSR 64000 Command Reference Guide

Release 5.0.0

ip domain-name
The ip domain-name command is used to configure a domain name. The no ip domain-name command removes the domain name. For each BSR, you should configure the name of the domain in which the BSR is located. This is the default domain name that is appended to host names that are not fully qualified.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ip domain-name no ip domain-name

Command Syntax
WORD domain name

Command Default
No domain is configured.

2-28

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

ip forward-protocol udp
The ip forward-protocol udp command controls what type of UDP packet to forward when broadcasting packets or allows all types of UDP packets to be forwarded. The no ip forward-protocol udp command disables IP forwarding.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ip forward-protocol udp [ | bootpc | bootps | domain | netbios-dgm | netbios-ns | tacacs | tftp | time] no ip forward-protocol udp [ | bootpc | bootps | domain | netbios-dgm | netbios-ns | tacacs | tftp | time]

Command Syntax
0-65535 bootpc bootps domain netbios-dgm netbios-ns tacacs tftp time UDP port number Bootstrap Protocol client (port 68) Bootstrap Protocol server (port 67) Domain Name Service (DNS) (port 53) NetBios datagram service (port 138) NetBios name service (port 137) TAC Access Control System (port 49) Trivial File Transfer Protocol (port 69) Time service (port 37)

Compass ID: 271820115 Version 3

2-29

BSR 64000 Command Reference Guide

Release 5.0.0

ip forwarding
The ip forwarding command neutralizes virus or hacking attacks by forwarding the offending traffic to Transmission Control Protocol (TCP) or User Datagram Protocol (UDP) source or destination port zero (depending where this traffic is coming from). It is then discarded through the BSR’s hardware. Once the hacking or virus problem is resolved, the no ip forwarding command is used to stop discarding TCP or UDP packets on their respective source port 0 or destination port 0.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ip forwarding {tcp | udp}{dst-zero | src-zero} no ip forwarding {tcp | udp}{dst-zero | src-zero}

Command Syntax tcp udp dest-zero src-zero TCP port UDP port destination port is 0 source port is 0

Command Default
Disabled

2-30

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

ip helper-address
The ip helper-address command specifies the destination IP address of the DHCP server for where broadcast packets are forwarded. The no ip helper-address command removes the IP address where broadcast packets are forwarded. Use the ip helper-address command to forward broadcast packets received on an interface.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip helper-address no ip helper-address

Command Syntax
A.B.C.D IP address of the DHCP server

Compass ID: 271820115 Version 3

2-31

BSR 64000 Command Reference Guide

Release 5.0.0

ip host
The ip host command is used to add a static, classless DNS host entry and its IP address to the IP hostname table. The no ip host command deletes the host address-to-name mapping in the host cache.

Note: The initial character of the name must be a letter.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ip host no ip host

Command Syntax
Hostname A.B.C.D name of host IP address

Command Default
No hosts configured.

2-32

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

ip irdp
The ip irdp command enables the ICMP Router Discovery Protocol (IRDP) on an interface. The no ip irdp command disables the ICMP IRDP on an interface.

Group Access
ISP

Command Mode
Interface Configuration (Ethernet and Gigabit Ethernet interfaces only)

Command Line Usage ip irdp [address | holdtime | maxadvertinterval | minadvertinterval | multicast | preference ] no ip irdp [address | holdtime | maxadvertinterval | minadvertinterval | multicast | preference ]

Command Syntax address A.B.C.D holdtime 1-9000 IP address to proxy-advertise, preference value amount of time, in seconds, advertisements hold valid

maxadvertinterval 4-1800 maximum time, in seconds, between advertisements minadvertinterval 3-1800 multicast preference -2147483648-2147483647 minimal time between advertisement in seconds advertisements are sent with multicast preference value for this interface, -231 to 231, higher values increase performance, preferred router

Compass ID: 271820115 Version 3

2-33

BSR 64000 Command Reference Guide

Release 5.0.0

Command Default holdtime = 1800 seconds 600 seconds 450 seconds

maxadvertinterval = minadvertinterval =

2-34

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

ip mask-reply
The ip mask-reply command enables Internet Control Message Protocol (ICMP) netmask reply messages. The no ip mask-reply command disables ICMP netmask reply messages.

Group Access
ISP

Command Mode
Interface Configuration

Command Mode ip mask-reply no ip mask-reply

Command Default
Enabled

Compass ID: 271820115 Version 3

2-35

BSR 64000 Command Reference Guide

Release 5.0.0

ip mtu
The ip mtu command configures the Maximum Transmission Unit (MTU) packet size allowed on the interface. The no ip mtu command resets the default.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip mtu no ip mtu

Command Syntax
68-1500 MTU size in bytes

Command Default
1496 bytes

2-36

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

ip multicast fastpath
The ip multicast fastpath command is used to specify which multicast flow or flows will be given preferential treatment for forwarding in the fast path. Which flow is forwarded in the fast path depends on the user configuration. A flow or a range of flows can be configured with an extended access list (eACL). If no eACL configured flows are present, all flows will be forwarded through the slow path in the SRM. When the traffic for these eACL configured flows is active, they will be forwarded in the fast path. Only the maximum allowed 16 fast path entries can be forwarded even though there might be more active flows configured. When an active flow is deleted, either due to a timeout or forced removal, the next active eACL configured flow, if any, will be forwarded in the fast path. Source and group destination IP addresses can be setup in ranges using wildcard network masks in the eACL. Only permit entries are parsed for eligibility of installing into the fast path. The fast path entries will be installed up to the first 16 flows configured in the eACL initially. When a multicast flow becomes active in the multicast forwarding cache and it matches any of the entries in the eACL, the entry will be programmed into the fast path if one of the 16 flows are available. A flow is considered active when traffic of that flow is being forwarded within a 3 minute window. The entries in the fast path will be re-evaluated on any updates to the eACL. For entries no longer matched in the eACL, they will be taken out of the fast path. The updated eACL will be parsed to see if any corresponding active flows need to be programmed into the fast path if there are still room in the fast path. However, if all 16 installed entries still match the configured range, no entry in the fast path will be replaced even if the configured range has become higher in the sequence order of the eACL. This is because ACLs only provide a way to make a binary decision, i.e. it is either eligible for the fast path or not, and not used for ordering to determine which entries get installed. There is an optional parameter “queue” for all multicast data packets to be forwarded out one of the eight specified queues which can be used for statistics, debugging or QoS purposes. The queue number cannot be changed once configured unless a new extended ACL is configured where all previous fast path flows are removed and any new fast path flows are created with the new queue number.

Group Access
ISP

Command Mode
Global Configuration

Compass ID: 271820115 Version 3

2-37

BSR 64000 Command Reference Guide

Release 5.0.0

Command Line Usage ip multicast fastpath { | } [ queue ] no ip multicast fastpath { | } [ queue ]

Command Syntax
100-199 2000-2699 queue 0-7 the mulitcast acceleration eligibility list the extended ACL range the HSIM transmit queue number

Command Default queue = 1

2-38

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

ip name-server
The ip name-server command is used to enter the IP address of one or more Domain Name System (DNS) servers. Up to six DNS servers can be configured on the BSR. The no ip name-server command deletes a DNS entry.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ip name-server [] no ip name-server []

Command Syntax
A.B.C.D IP address of a DNS server, 6 addresses may be specified

Compass ID: 271820115 Version 3

2-39

BSR 64000 Command Reference Guide

Release 5.0.0

ip proxy-arp
The ip proxy-arp command enables proxy Address Resolution Protocol (ARP) on an Ethernet and Gigabit Ethernet interface. The no ip proxy-arp command disables proxy ARP on an interface. Note: If a host in the local network is incapable of responding to an ARP request for some reason, the router will respond on behalf of the host when proxy arp is enabled and the IP-to-MAC address mapping of the host is stored in the router with a static arp command and the alias option specified. To verify ARP status, use the show running-config command. The BSR will also respond to an ARP request for a network on a different interface when proxy ARP is enabled.

Group Access
ISP

Command Mode
Interface Configuration (Ethernet and Gigabit Ethernet Interfaces only)

Command Line Usage ip proxy-arp no ip proxy-arp

Command Default
Disabled

2-40

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

ip rarp-server
The ip rarp-server command is used to enable the router to act as a Reverse Address Resolution Protocol (RARP) server. The no ip rarp-server command disables the router to act as a RARP server. The RARP server can be configured on each interface to ensure that the router does not affect RARP traffic on other subnetworks that do not need RARP assistance. The following conditions must be satisfied before receiving RARP support:
■ ■

The ip rarp-server command must be configured on the requesting interface A static entry, must exist in the IP ARP table, mapping the MAC address in the RARP request to an IP address

The IP address should be set to whatever address the user configures as the primary address for the interface.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip rarp-server no ip rarp-server

Command Syntax
A.B.C.D IP address for use as the source protocol address

Command Default
Disabled

Compass ID: 271820115 Version 3

2-41

BSR 64000 Command Reference Guide

Release 5.0.0

ip redirects
The ip redirects command enables the processing of "Host Redirect" messages. If both the global and interface configuration modes are enabled, the BSR will send an ICMPv4 "Host Redirect" packet to the original source of an IPv4 packet received by the BSR from that interface when both the source IP address and destination IP address of the packet are within a logical IPv4 subnet implemented on the incoming interface. The source should send packets directly to the destination rather than routing through the BSR. The no ip redirects command disables the processing of "Host Redirect" messages. When disabled, the BSR will not send an ICMPv4 "Host Redirect" message to the source. This command applies only to IP version 4 packets. Regardless of the configuration, the BSR attempts to forward packets back onto the incoming interface in order to reach their destinations. Note: Unless your network devices respond to IP redirects, which can be a security issue, Motorola recommends that this function be disabled. This will minimize network traffic load and packet processing by the BSR.

Group Access
ISP

Command Mode
Global Configuration and Interface Configuration (not supported for Cable interfaces)

Command Line Usage ip redirects no ip redirects

Command Default
Enabled

2-42

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

ip route
The ip route command is used to configure a static route when the router cannot dynamically build a route to the specific destination or if the route must be in place permanently. The no ip route command removes a static route.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ip route { | null | pos | tunnel } [ ] [ range ] [tag ] no ip route { | null | pos | tunnel } [ ] [ range ] [tag ]

Command Syntax
A.B.C.D A.B.C.D A.B.C.D null pos X/Y tunnel 0-255 1-255 range 1-65536 tag 1-4294967295 IP address of the destination network netmask of the destination network IP address of the forwarding router null interface number POS slot X and port Y tunnel interface number administrative distance number of route entries match value to control route-map redistribution

Command Default
Administrative distance = 1

Compass ID: 271820115 Version 3

2-43

BSR 64000 Command Reference Guide

Release 5.0.0

ip routing
The ip routing command enables IP routing. The no ip routing command disables IP routing.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ip routing no ip routing

Command Default
Enabled

2-44

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

ip source-route
The ip source-route command allows the BSR to handle IP datagrams with source routing header options. The no ip source-route command discards any IP datagrams containing a source-route option.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ip source-route no ip source-route

Compass ID: 271820115 Version 3

2-45

BSR 64000 Command Reference Guide

Release 5.0.0

ip unreachables
The ip unreachables command enables processing of an ICMP unreachable message when the BSR can not deliver a received packet. When enabled for both the global and interface configuration modes, the BSR will send an ICMPv4 "Network Unreachable" packet to the original source of an IPv4 packet received by the BSR for which the BSR does not have a route. The no ip unreachables command disables ICMP unreachable message processing when the router can not deliver a received a packet. If either the global or interface configuration mode is disabled, then the BSR will not send an ICMPv4 packet to the source. This command applies only to IP version 4 packets. Regardless of the configuration, the BSR will discard the packet when it has no route to its destination. Note: Because enabling this feature can cause large amounts of data to be sent on the network interface, Motorola recommends that this feature be disabled.

Group Access
ISP

Command Mode
Global Configuration and Interface Configuration (not supported for Cable interfaces)

Command Line Usage ip unreachables no ip unreachables

Command Default
Enabled

2-46

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

passive-interface
The passive-interface command suppresses routing updates from being transmitted over a specific ethernet or cable routing interface. The no passive-interface command re-enables route updates to be transmitted over the routing interface.

Note: Updates from routers that are directly connected to the passive interface continue to be received and processed.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage passive-interface {cable | default | ethernet | gigaether | loopback | pos } no passive-interface {cable | default | ethernet | gigaether | loopback | pos }

Command Syntax cable X/Y cable X/Y.N default ethernet X/Y gigaether X/Y gigaether X/Y.N slot X, MAC domain Y, and, if applicable, the cable sub-interface N of the CMTS module suppress routing updates on all interfaces Ethernet interface slot X and port Y slot X, port Y, and, if applicable, the sub-interface N of the 1000 Mbps optical Ethernet interface

Compass ID: 271820115 Version 3

2-47

BSR 64000 Command Reference Guide

Release 5.0.0

loopback 1-255 pos X/Y

loopback interface number Packet-Over-SONET interface slot X and port Y

Command Default
Routing updates are transmitted over the router (no passive-interface command).

2-48

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

ping
The Packet Internet Groper (PING) ping command sends an Internet Control Message Protocol (ICMP) echo request to a remote host that reports errors and provides information relevant to IP packet addressing. Use the ping command to check host reachability and network connectivity, or to confirm basic network connectivity. Note: The address of the source in an echo message will be the destination of the echo reply message. To form an echo reply message, the source and destination addresses are simply reversed, the type code changed to 0, and the checksum recomputed. ICMP is used to report problems with delivery of IP datagrams within an IP network. It can also show when a particular node is not responding, when an IP network is not reachable, when a node is overloaded, when an error occurs in the IP header information, etc. The protocol is also frequently used by Internet managers to verify correct operations of nodes and to check that routers are correctly routing packets to the specified destination address.

Group Access
All

Command Mode
User EXEC and Privileged EXEC

Command Line Usage ping { | }[size [] [timeout ] [source ] [tos ] [ttl ] [df]]

Command Syntax
A.B.C.D Hostname size 40-65535 IP address of the destination system name of the destination system size, in bytes, of the echo message

Compass ID: 271820115 Version 3

2-49

BSR 64000 Command Reference Guide

Release 5.0.0

1-65535 timeout 1-1024 source A.B.C.D tos 0-255 ttl 0-255 df

number of ping requests to send time, in seconds, to wait for a reply before the connection times out IP address of the BSR interface to use as the source of the ping request type of service time to live value set the "don’t fragment" IP flag in the outgoing ping IP header

2-50

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show arp
The show arp command displays static and dynamic entries in the ARP table. The following is an example of typical screen output from the show arp command:

Protocol Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet

Address Age(min) 10.10.10.10 10.255.4.1 10.255.5.1 10.255.6.1 10.255.7.1 150.31.60.1 41 150.31.60.10 150.31.60.99 150.31.61.23 21 150.31.61.27 31 150.31.61.28 3 150.31.61.29 3 150.31.61.34 3 150.31.61.37 3 150.31.61.80 3 150.31.61.81 3

Hardware Address 0030.b801.c5f4 0000.0000.0004 0000.0000.0005 0000.0000.0006 0000.0000.0007 00e0.6367.99b1 0030.b801.c570 0000.0000.9999 0008.0ee4.84e8 0008.0ee4.d550 0020.4026.77c0 0020.4027.a028 0020.4026.d5dc 0020.4026.77bc 0020.4029.19dc 0020.4027.a038

Type ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA

Interface ethernet 15/4

ethernet 7/0 ethernet 7/0 ethernet 7/0 cable 0/0 cable 0/0 cable 0/0 cable 0/0 cable 0/0 cable 0/0 cable 0/0 cable 0/0

Group Access
All

Command Mode All modes except User EXEC Command Line Usage show arp [ | {begin | exclude | include} {} [ | {count | count-only}]] show arp [ | {count | count-only}] Command Syntax
| begin turn on output modifiers (filters) filter for output that begins with the specified string

Compass ID: 271820115 Version 3

2-51

BSR 64000 Command Reference Guide

Release 5.0.0

exclude include WORD count count-only

filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

2-52

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show controllers
The show controllers command displays detailed hardware and configuration information for each module installed in the BSR chassis.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show controllers {ethernet [] | gigaether [] | pos [] | cable [upstream | downstream | mac ]} [ | {begin | exclude | include} {} [ | {count | count-only}]] show controllers {ethernet [] | gigaether [] | pos [] | cable [upstream | downstream | mac ]} [ | {count | count-only}]

Command Syntax ethernet X/Y display Ethernet interface controller information for the entire BSR chassis or the optional, specified BSR chassis slot X and port Y display Gigabit Ethernet interface controller information for the entire BSR chassis or the optional, specified BSR chassis slot X, port Y, and if applicable, sub-interface N display POS interface controller information for the entire BSR chassis or the optional, specified BSR chassis slot X and port Y

gigaether X/Y gigaether X/Y.N

pos X/Y

Compass ID: 271820115 Version 3

2-53

BSR 64000 Command Reference Guide

Release 5.0.0

cable X/Y cable X/Y.N

display cable interface controller information for the specified BSR chassis slot X, MAC domain Y, and if applicable sub-interface N display information for the specified upstream port including the upstream modulation type, channel width, frequency, and modulation profile information (i.e minislots, interleave, preamble, etc.) display information for the downstream port number including downstream modulation type, frequency (label), and symbol rate display MAC layer (layer 2) information for all cable modems on this specific CMTS module turn on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

upstream NUM

downstream NUM

mac

| begin exclude include WORD count count-only

2-54

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show host authorization
The show host authorization command displays the host authorization enabled state and displays all cable host entries in the ARP authorization table. The following is an example of typical screen output from the show host authorization command:

Device Host Modem Host Modem

Type Dyn Dyn Dyn Dyn

State Ack Ack-TD-TF Learned Ack-TD-TF

Seconds 90000 90000 90000 90000

Modem MAC Addr 0008.0e72.bf70 0008.0e72.bf70 0008.0e73.1dba 0008.0e73.1dba

Host IP Addr 150.31.43.3 150.31.42.2 150.31.43.2 150.31.42.3

Host MAC Addr 0008.0e72.bf72 0008.0e72.bf70 0008.0e73.1dbc 0008.0e73.1dba

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show host authorization

Command Syntax
0-15 CMTS slot number

Compass ID: 271820115 Version 3

2-55

BSR 64000 Command Reference Guide

Release 5.0.0

show host authorization cpe
The show host authorization cpe command is used to display the dynamic or static ARP entries for CPEs only. The following is an example of typical screen output from the show host authorization cpe command:

Type Dynamic Dynamic

Host IP Address 150.31.43.3 150.31.43.2

Host MAC Address 0008.0e72.bf72 0008.0e73.1dbc

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show host authorization cpe {leased | static} [ | {begin | exclude | include} {} [ | {count | count-only}]] show host authorization cpe {leased | static} [ | {count | count-only}]

Command Syntax leased static | begin exclude include display dynamically configured host authorization entries display statically configured host authorization entries turn on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string

2-56

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

WORD count count-only

the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

2-57

BSR 64000 Command Reference Guide

Release 5.0.0

show host authorization interface cable
The show host authorization interface cable command displays host authorization configuration information for a cable interface. The following is an example of typical screen output from the show host authorization interface cable command:

Device Host Host Modem Modem

Type Dyn Dyn Dyn Dyn

State Ack Ack Ack-TD-TF Ack-TD-TF

Seconds 3600 3600 3600 3600

Modem MAC Addr 0012.25d9.59f8 000e.5c6c.9810 0019.5eb4.8176 000e.5c00.d2e2

Host IP Addr 150.31.56.2 150.31.56.3 150.31.54.20 150.31.54.15

Host MAC Addr 0008.0ecc.9a52 0008.0ecc.9a3a 0019.5eb4.8176 000e.5c00.d2e2

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show host authorization interface cable [ | {begin | exclude | include} {} [ | {count | count-only}]] show host authorization interface cable [ | {count | count-only}]

Command Syntax
X/Y | begin exclude include slot X and MAC Domain Y of the CMTS module turn on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string

2-58

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

WORD count count-only

the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

2-59

BSR 64000 Command Reference Guide

Release 5.0.0

show host authorization summary
The show host authorization summary command is used to display ARP table summary information. The following is an example of typical screen output from the show host authorization summary command:

Interface Cable 4/0

Total Modems 2

Total Hosts 2

Total Routers 0

Dynamic Entries 4

Static Entries 0

Total Entries 4

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show host authorization summary [] [ | {begin | exclude | include} {} [ | {count | count-only}]] show host authorization summary [] [ | {count | count-only}]

Command Syntax
0-15 | begin exclude include WORD CMTS slot number turn on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string

2-60

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

count count-only

count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

2-61

BSR 64000 Command Reference Guide

Release 5.0.0

show host unauthorized cpe
The show host unauthorized cpe command displays the list of hosts/CPEs that are unauthorized due to a failed DHCP lease query response. The following is an example of typical screen output from the show host unauthorized cpe command:

Index 32767

Seconds 600

Modem MAC Addr 0012.2588.33ac

Host IP Addr 150.42.101.2

Host MAC Addr Vrf Index 0030.1bb4.a703 0

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show host unauthorized cpe

2-62

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show hosts
The show hosts command displays the cache list of hostnames with their IP addresses and aliases.

Group Access
ISP

Command Mode
Privileged EXEC

Command Line Usage show hosts

Compass ID: 271820115 Version 3

2-63

BSR 64000 Command Reference Guide

Release 5.0.0

show interfaces
Use the show interfaces command to display the status and statistics for the network interfaces. Use the show interfaces command without the slot and interface argument to display all interfaces. The following is an example of typical screen output from the show interfaces command:

gigaether 14/0.10 is up, line protocol is up Hardware address is 00:30:b8:80:63:3f Internet address is 150.31.90.10/24 Encapsulation Arpa 802.1Q Virtual LAN, VLAN ID 63 ARP Timeout 01:00:00 Last state change at 1d16h, 63 interface resets Queueing strategy: FIFO

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show interfaces [ethernet | gigaether | cable | pos | loopback | tunnel ] [accounting] [ | {begin | exclude | include} {} [ | {count | count-only}]] show interfaces [ethernet | gigaether | cable | pos | loopback | tunnel ] [accounting] [ | {count | count-only}]

Command Syntax ethernet X/Y gigaether X/Y gigaether X/Y.N Ethernet interface slot X and port Y Gigabit Ethernet interface slot X, port Y, and if applicable, sub-interface N

2-64

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

cable X/Y cable X/Y.N pos X/Y loopback 1-255 tunnel 0-255 accounting

cable interface slot X, port Y, and if applicable, sub-interface N Packet-over-SONET interface slot X and port Y loopback interface number tunnel interface number display the number of packets for each protocol type that has been sent through an interface turn on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

| begin exclude include WORD count count-only

Compass ID: 271820115 Version 3

2-65

BSR 64000 Command Reference Guide

Release 5.0.0

show ip arp
The show ip arp command displays the Internet Protocol (IP) Address Resolution Protocol (ARP) cache table entries for individual interfaces or all interfaces on the BSR. Each ARP entry describes the protocol type, IP address to MAC address binding, age time, ARP type, and interface location and type. Use the additional command arguments to filter the output information you want to receive. The following is an example of typical screen output from the show ip arp command:

Protocol Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet Internet

Address Age(min) 150.31.90.1 0 150.31.90.10 150.31.93.10 21 150.31.93.12 10 150.31.93.13 13 150.31.93.14 8 150.31.93.15 20 150.31.93.16 28 150.31.93.17 3 150.31.94.10 1 150.31.94.11 1 150.31.94.12 6 150.31.94.13 1 150.31.94.14 0 150.31.94.15 2 150.31.98.10 150.31.98.100 0 150.31.99.7 -

Hardware Address 00e0.6367.99b1 0030.b8c6.5c70 0011.1aca.1388 0011.1ac9.2094 0011.8061.3f0e 0011.1aca.13a6 0011.1aca.1394 00c0.4f5e.e476 0011.805f.fd30 0011.1ac9.2096 0011.1aca.138a 0011.1aca.1396 0011.8061.3f10 0011.1aca.13a8 0011.805f.fd32 0030.b8c6.5cf2 00c0.4f63.482c 0030.b800.0701

Type ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA ARPA

Interface ethernet 7/0 ethernet 7/0 cable 11/1 cable 11/1 cable 4/0 cable 11/0 cable 11/0 cable 11/1 cable 4/0 cable 11/1 cable 11/1 cable 11/0 cable 4/0 cable 11/0 cable 4/0 ethernet 15/2 ethernet 15/2 ethernet 7/1

Group Access
All

Command Mode
All modes except for User EXEC

Command Line Usage show ip arp [ | | | cable | ethernet | gigaether | loopback | incomplete ] [ | {begin | exclude | include} {} [ | {count | count-only}]]

2-66

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show ip arp [ | | | cable | ethernet | gigaether | loopback | incomplete ] [ | {count | count-only}]

Command Syntax
A.B.C.D H.H.H Hostname cable X/Y cable X/Y.N ethernet X/Y gigaether X/Y gigaether X/Y.N loopback 0-255 incomplete | begin exclude include WORD display ARP entries matching the specified IP address display ARP entries matching the specified 48 bit MAC address display ARP entries matching the specified hostname display ARP entries for the specified cable interface in the BSR slot X, MAC Domain Y, and if applicable, sub-interface N display ARP entries for the specified Ethernet interface in BSR slot X and port number Y display ARP entries for the specified Gigabit Ethernet interface in BSR slot X, port Y, and if applicable sub-interface N display ARP entries for the specified loopback interface display incomplete ARP entries turn on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string

Compass ID: 271820115 Version 3

2-67

BSR 64000 Command Reference Guide

Release 5.0.0

count count-only

count the number of outputted lines count the number of lines while suppressing screen output

2-68

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show ip dhcp stats
The show ip dhcp stats command displays DHCP messages sent and received for a specified slot or all slots on the BSR. The following is an example of typical screen output from the show ip dhcp stats command:

DHCP statistics: CMTS Slot Upstream Downstream 4 30238 30234 6 0 0 9 0 0 11 40174 40160

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip dhcp stats []

Command Syntax
NUM CMTS slot number

Compass ID: 271820115 Version 3

2-69

BSR 64000 Command Reference Guide

Release 5.0.0

show ip filters
The show ip filters command displays a variety of filter and routing policy configuration information. IP filters provide a mechanism for determining whether or not to process IP packets received over the BSR 64000 POS OC-3/C12, Multi-Mode Gigabit Ethernet (SX), Single-Mode Gigabit Ethernet (LX), or 10/100 Ethernet Network Interface Modules (NIMs). When an IP packet matches one of the patterns in a filter, the filter determines whether the packet is discarded or passed to the IP routing module for forwarding. Filtering decisions can be based on combinations of source address, destination address, TCP/UDP port, and protocol. The following is an example of typical screen output from the show ip filters command:

NL AP DR TL PP IG

= = = = = =

Null Filter, SM = Send To Srm, UA = Unresolved ARP, Access List Permit, AD = Access List Deny, PR = ACL Permit Range, ACL Deny Range, IR = ICMP Redirect, IU = ICMP Unreachable, Ip Tunnel Loopback, TE = Ip Tunnel Decap, TN = Ip Tunnel Encap, Policy Route Permit, PD = Policy Route Deny, PT = Policy Tunnel, Ignore CAM use LME, PU = Ip to Mpls Push VRF Dest Ip Address Src Ip Address Pro 134.33.90.99 172.50.1.100 150.31.98.100 150.31.94.11 ip ip SP / DP / DS Interface FT QId Type Code 0 IU 0 IU

Type InF InF

The show ip filters command displays the following filter configuration information for the acl, icmp, policy, qos, srm, and tunnel command options: Dest Ip Address Src Ip Address Pro destination IP address for this filter source IP address for this filter first three characters of the routing protocol acronym for this filter. For example, OSPF is displayed as OSP. source IP port for this filter

SP

2-70

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

DP FT

destination IP port for this filter Flow (classification) Type (FT). Flow types include the following: AP = Access List Permit AD = Access List Deny PR = ACL Permit Range DR = ACL Deny Range II = IP Ingress IR = ICMP Redirect IU = ICMP Unreachable TL = IP Tunnel Loopback TE = IP Tunnel Egress TN = IP Tunnel PP = Policy Route Permit PD = Policy Route Deny QS = QoS SM = Send To Srm NL = Drop outgoing QoS queue ID number

QId

The following additional filter configuration information is displayed for the policy command option: In If Out If DS Def incoming TCP/UDP port number associated with this filter entry outgoing TCP/UDP port number associated with this filter entry Diff-serv Code Point (differentiated services) default filter indicator

Compass ID: 271820115 Version 3

2-71

BSR 64000 Command Reference Guide

Release 5.0.0

Mac Mtu

MAC address for the interface Maximum Transmission Unit (MTU) packet size allowed on the interface

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip filters [acl | icmp | policy | srm | summary | tunnel] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip filters [acl | icmp | policy | qos | srm | summary | tunnel] [ | {count | count-only}]

Command Syntax acl icmp policy srm display access list filters display ICMP filters display policy routing filters send filters to the SRM to troubleshoot problems - for example, this can be used in instances when ARP is unresolved display a summary of all Fast Path filters - refer to show ip filters summary display IP tunneling filters turn on output modifiers (filters)

summary

tunnel |

2-72

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

begin exclude include WORD count count-only

filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

2-73

BSR 64000 Command Reference Guide

Release 5.0.0

show ip filters summary
The show ip filters summary command displays a summary of filter and routing policy statistics for IP filters for the BSR 64000 POS OC-3/C12, Multi-Mode Gigabit Ethernet (SX), Single-Mode Gigabit Ethernet (LX), or 10/100 Ethernet Network Interface Modules (NIMs). The show ip filters summary command displays the following filter summary statistics: Flow Classification Type Flow Classification Types: Null Filter Access List Permit Access List Deny IP Ingress IP Tunnel Egress IP Tunnel Loopback ICMP Redirect ICMP Unreachable IP Tunnel Policy Route Permit Policy Route Deny Qos Send To Srm number of filters applied to each Flow Classification Type BSR 64000 slot number of filters applied to the corresponding BSR 64000 slot

Number of Filters Slot Number of Filters

The following is an example of typical screen output from the show ip filters summary command:

2-74

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

Flow Classification Type ------------------------Null Filter Send To Srm Unresolved ARP Access List Permit Access List Deny ACL Permit Range ACL Deny Range ICMP Redirect ICMP Unreachable Ip Tunnel Loopback Ip Tunnel Decap Ip Tunnel Encap Policy Route Permit Policy Route Deny Policy Tunnel Ignore CAM use LME Ip to Mpls Push ------------------------total

Number of Filters ----------------0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 -------1

Slot ---15

Number of Filters ----------------1

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip filters summary [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip filters summary [ | {count | count-only}]
Compass ID: 271820115 Version 3 2-75

BSR 64000 Command Reference Guide

Release 5.0.0

Command Syntax
| begin exclude include WORD count count-only turn on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

2-76

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show ip flows
The show ip flows command displays active TCP/UDP flows/connections including servers. PCB specifies the source physical address of the flow or connection - PCB denotes printed circuit board specifies the protocol used in this flow or connection specifies the number of packets received specifies the number of packets sentr specifies the source IP address and UDP port of the flow specifies the destination IP address and UDP port of the flow the state of the flow or connection the Virtual Private Network associated with this flow or connection

Proto Recv-Q Send-Q Local Address Foreign Address (state) VPN

The following is an example of typical screen output from the show ip flows command:

Active Internet connections (including servers) PCB Proto Recv-Q Send-Q Local Address Foreign Address (state) VPN ----- ------ ------ -----------------------------------1fb10e8 TCP 56 54 150.31.20.10.23 10.14.37.103.39345 ESTABLISHED global 1fb0fd8 TCP 1fb1060 TCP 1fb0f50 UDP 89 45 101 78 23 0 150.31.20.10.43 10.14.37.103.42034 ESTABLISHED global 150.31.20.10.67 10.14.37.103.54220 ESTABLISHED global 127.0.0.1.161 0.0.0.0.0 LISTENING global

Compass ID: 271820115 Version 3

2-77

BSR 64000 Command Reference Guide

Release 5.0.0

Group Access
All

Command Mode
All modes

Command Line Usage show ip flows [ | {begin | exclude | include} {} | {count | count-only}] show ip flows [ | {count | count-only}]

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

2-78

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show ip forwarding-table
The show ip forwarding-table command displays all unicast route entries in the HSIM IP forwarding table. The following is an example of typical screen output from the show ip forwarding-table command:

NL NA GW LN PU

= = = = =

Null Route, LI = Local Interface, BC = Subnet Broadcast, Directly Connected Need ARP, WA = Directly Connected With ARP, Gateway Route, CH = Cmts Host Route, CI = Cmts Interface Route, Local Interface Network Route, CR = Cmts Route, TL = Tunnel Route, Ip to Mpls Push, 2P = Ip to Mpls 2 Push, LS

VRF ------

Ip Address/Prefix -----------------150.31.83.0/24 150.31.83.3/32 150.31.83.0/32 150.31.83.255/32 150.31.85.0/24 150.31.89.255/32 10.14.0.0/16 0.0.0.0/0 150.31.91.0/24 150.31.83.15/32 150.31.1.0/24

Phys If ------------eth 7/0 eth 7/0 eth 7/0 eth 7/0 eth 7/0 eth 7/1 eth 7/0 eth 7/0 eth 7/0 cab 2/0 eth 7/0

RT -LN LI BC BC LN BC LN LN LN CH LN

Gateway -----------------------150.31.83.3 --

MAC Address HitCnt -------------- ----------------0 9808 0 0 0 0 5 0 0 0 546

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip forwarding-table [ | hitCount [] | summary ] [ | {begin | exclude | include} {} | {count | count-only}] show ip forwarding-table [ | hitCount [] | summary ] [ | {count | count-only }]

Compass ID: 271820115 Version 3

2-79

BSR 64000 Command Reference Guide

Release 5.0.0

show ip forwarding-table [mpls | tunnel | vrf {}] [hitCount []] [ | {begin | exclude | include} {} | {count | count-only}] show ip forwarding-table [mpls | tunnel | vrf {}] [hitCount []] [ | {count | count-only }]

Command Syntax
A.B.C.D hitCount NUM summary mpls tunnel vrf word | begin count count-only exclude include WORD display the entries for the specified IP address display the access-list hit count for the (optional) BSR chassis slot number display a summary display the MPLS Fast Path filters display the tunnel filters display a VPN Routing/Forwarding instance turn on output modifiers (filters) filter for output that begins with the specified string count the number of outputted lines count the number of lines while suppressing screen output filter for output that excludes the specified string filter for output that includes the specified string the specified string

2-80

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show ip interface
The show ip interface command displays the status, statistical information, and configuration for the network interfaces. The show ip interface command without any command arguments displays status, statistical information, and configuration for all interfaces. The following is an example of typical screen output from the show ip interface command:

ethernet 7/0 is up, line protocol is up Internet address is 150.31.90.10/24 Broadcast address is 255.255.255.255 MTU 1500 bytes Directed broadcast forwarding is disabled Outgoing access list is not set Inbound access list is not set Policy routing is disabled Proxy ARP is disabled Split horizon is enabled ICMP redirects are always sent ICMP unreachables are always sent ICMP mask replies are always sent Router Discovery is disabled loopback 3 is up, line protocol is up Internet address is 150.31.93.1/24 Destination address is 150.31.93.1 MTU 1514 bytes Cable cable-modem helper addresses are: 150.31.1.100 global Cable host helper addresses are: 150.31.1.100 global Cable mta helper addresses are: 150.31.1.100 global Directed broadcast forwarding is disabled Outgoing access list is not set Inbound access list is not set Policy routing is disabled Split horizon is enabled ICMP redirects are never sent ICMP unreachables are always sent ICMP mask replies are always sent Router Discovery is disabled Secondary address 150.31.94.1/24

Compass ID: 271820115 Version 3

2-81

BSR 64000 Command Reference Guide

Release 5.0.0

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage show ip interface [ brief | cable | ethernet | gigaether | loopback | pos | tunnel ] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip interface [ brief | cable | ethernet | gigaether | loopback | pos | tunnel ] [ | {count | count-only}]

Command Syntax brief provides a brief summary of IP status and configuration information for a specific interface or all interfaces cable interface slot X, MAC Domain Y, and if applicable, sub-interface N Ethernet interface slot X and port Y Gigabit Ethernet interface slot X, port Y, and if applicable, sub-interface N loopback interface number Packet-over-SONET interface slot X and port Y tunnel interface number turn on output modifiers (filters) filter for output that begins with the specified string

cable X/Y cable X/Y.N ethernet X/Y gigaether X/Y gigaether X/Y.N loopback 1-255 pos X/Y tunnel 0-255 | begin

2-82

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

exclude include WORD count count-only

filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

2-83

BSR 64000 Command Reference Guide

Release 5.0.0

show ip irdp
The show ip irdp command displays ICMP Router Discovery Protocol information including interface holdtime values, configured preface values, and advertisement values for specified Ethernet or Gigabit Ethernet interfaces or all Ethernet or Gigabit Ethernet interfaces on the BSR. The following is an example of typical screen output from the show ip irdp command: ethernet 7/0 has router discovery disabled ethernet 7/1 has router discovery disabled ethernet 15/0 has router discovery disabled ethernet 15/1 has router discovery disabled ethernet 15/2 has router discovery disabled ethernet 15/3 has router discovery disabled ethernet 15/4 has router discovery disabled ethernet 15/5 has router discovery disabled ethernet 15/6 has router discovery disabled ethernet 15/7 has router discovery disabled

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage show ip irdp [ethernet | gigaether ] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip irdp [ethernet | gigaether ] [ | {count | count-only}]

2-84

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

Command Syntax ethernet X/Y gigaether X/Y gigaether X/Y.N | begin exclude include WORD count count-only Ethernet interface slot X and port Y Gigabit Ethernet interface slot X, port Y, and if applicable, sub-interface N turn on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

2-85

BSR 64000 Command Reference Guide

Release 5.0.0

show ip multicast fastpath
The show ip multicast fastpath command display multicast entries in the fast path. The following is an example of typical screen output from the show ip multicast fastpath command:

Source/Group ----------------------8.8.8.21/224.2.166.71 20.1.1.10/224.2.166.71 8.8.8.21/224.2.231.191 20.1.1.10/224.2.231.191

In Phys If ---------feth 2/0 feth 3/0 feth 2/1 feth 2/2

Out Phys Ifs ------------cab 5/0 cab 4/0 cab 5/0 cab 5/1 eth 2/6 cab 5/0 cab 1/0

FP Idx -----2 5 13 6

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip multicast fastpath

2-86

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show ip multicast fwd-cache
The show ip multicast fwd-cache command displays the multicast forwarding cache on a source and group pair basis. The added legend of “s” indicates that the flow is currently being switched/forwarded in the fast path. If the entry is in the fast path, the column in parenthesis displays any packets that have come through to the slow path. The following is an example of typical screen output from the show ip multicast fwd-cache command:

Legend (L): D = DVMRP accept, d = DVMRP drop, P = PIM accept, p = PIM drop s = Switched (FastPath), N = None/Drop, U = unknown Source/ (L) Incoming/ # in pkts # out pkts # OI Entry Group Outgoing (# in SRM) Timeout ------------------------------------------------ ------8.8.8.21/ Ps 90.1.1.15/ 2352 1 208 224.2.166.71 Ps 1.1.1.1 (49) 20.1.1.10/ P PIM REG IN/ 1074 1 210 224.2.166.71 P 90.1.1.15 1074 8.8.8.21/ Ps 90.1.1.15/ 47 1 209 224.2.231.191 Ps 1.1.1.1 (147) 20.1.1.10/ Ps 1.1.1.1/ 24709 1 210 224.2.231.191 Ps 90.1.1.15 (1)

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip multicast fwd-cache [ | | physical ]

Compass ID: 271820115 Version 3

2-87

BSR 64000 Command Reference Guide

Release 5.0.0

Command Syntax
A.B.C.D A.B.C.D physical only displays the cache for this source or group address only displays the cache for this specified source and group displays the cache only in relation to the physical interface - if "physical" is not specified - if "physical" is not specified, the command output relates to the logical interface

2-88

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show ip protocols
The show ip protocols command is used for debugging routing activity and processes by displaying the status of routing protocol processes currently on the system. The following is an example of typical screen output from the show ip protocols command:

Routing Protocol is "bgp 4 " Bgp default capabilities: ipv4-unicast route-refresh Timers: keepalive 60 hold 180 Client-to-client reflection is enabled Default local-preference 100 Routing Process OSPF with ID 150.31.94.1 Supports only single TOS(TOS0) routes This is an autonomous system boundary router SPF schedule delay 5 secs, Hold time between two SPFs 10 secs Minimum LSA interval 5 secs. Minimum LSA arrival 1 secs Number of external LSA 63 Number of areas in this router is 1. 1 normal 0 stub 0 nssa Area 0.0.0.0 Number of interfaces in this area is 6 Area has no authentication SPF algorithm executed 215 times Routing for Networks: 150.31.0.0/16 Distance: 110 (default is 110)

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage show ip protocols [bgp | summary] [ | {begin | exclude | include} {} [ | {count | count-only}]]

Compass ID: 271820115 Version 3

2-89

BSR 64000 Command Reference Guide

Release 5.0.0

show ip protocols [bgp | summary] [ | {count | count-only}]

Command Syntax bgp summary | begin exclude include WORD count count-only display BGP protocol infomation display a summary of system routing protocol processes turn on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

2-90

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show ip route
The show ip route command displays active entries in the BSR routing table. The following is typical screen output from the show ip route command:

Codes: C - connected, S - static, R - RIP, B - BGP i - IS-IS derived L1- IS-IS level-1, L2- IS-IS level 2 route O - OSPF, IA - OSPF inter area, N1 - OSPF NSSA external type 1 N2 - OSPF NSSA external type 2, E1 - OSPF external type 1 E2 - OSPF external type 2, * - candidate default U - per-user static route, P - periodic downloaded static route T - traffic engineered route Gateway of last resort is 150.31.90.1 to network 0.0.0.0 *S O O O O O O O O O O O O O O O 0.0.0.0/0 [1/0] via 150.31.90.1, ethernet 15/1 150.31.1.0/24 [110/1] via 150.31.90.1, ethernet 15/1 150.31.2.0/24 [110/1] via 150.31.90.1, ethernet 15/1 150.31.10.0/24 [110/21] via 150.31.90.1, ethernet 15/1 150.31.11.0/24 [110/31] via 150.31.90.1, ethernet 15/1 150.31.17.0/24 [110/31] via 150.31.90.1, ethernet 15/1 150.31.19.0/24 [110/22] via 150.31.90.1, ethernet 15/1 150.31.20.0/24 [110/21] via 150.31.90.1, ethernet 15/1 150.31.21.0/24 [110/31] via 150.31.90.1, ethernet 15/1 150.31.22.0/24 [110/31] via 150.31.90.1, ethernet 15/1 150.31.24.0/24 [110/22] via 150.31.90.1, ethernet 15/1 150.31.26.0/24 [110/31] via 150.31.90.1, ethernet 15/1 150.31.30.0/24 [110/21] via 150.31.90.1, ethernet 15/1 150.31.31.0/24 [110/31] via 150.31.90.1, ethernet 15/1 150.31.32.0/24 [110/31] via 150.31.90.1, ethernet 15/1 150.31.39.0/24 [110/22] via 150.31.90.1, ethernet 15/1

E2 E2

Compass ID: 271820115 Version 3

2-91

BSR 64000 Command Reference Guide

Release 5.0.0

"Rep" in the show ip route command display ouptut indicates a replicated route. For example:

10.1.6.0/24 [110/2] via 8.8.8.50, ethernet 12/2 (Rep) 186.1.1.0/24 [110/2] via 8.8.8.50, ethernet 12/2 (Rep)

Replicated routes are removed after an OSPF graceful restart function completes and routes are recalculated after an SRM switchover by the new active SRM or if the OSPF graceful restart process fails to complete. Note: The IP route information displayed reflects the routes that the routing table has exported after being filtered by each routing protocol’s export routing policy statements.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip route [ [longer-prefixes] [ [longer-prefixes] | bgp | connected | | isis | ospf | rip | static | summary | vrf ] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip route [ [longer-prefixes] [ [longer-prefixes] | bgp | connected | | isis | ospf | rip | static | summary | vrf ] [ | {count | count-only}]

2-92

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

Command Syntax
A.B.C.D A.B.C.D longer-prefixes bgp connected Hostname isis ospf rip static summary vrf word | begin exclude include WORD count count-only display routes for the specified IP address subnet mask display routes matching the specified network and mask pair only display Border Gateway Protocol routes display connected routes display routes for the hostname display ISIS routes display OSPF routes display RIP routes display static routes display a summary of routes display a VPN Routing/Forwarding instance turn on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

2-93

BSR 64000 Command Reference Guide

Release 5.0.0

show ip traffic
The show ip traffic command displays IP, ICMP, UDP, TCP, ARP, OSPF, IGMP, DVMRP, PIM, and RADIUS protocol packet statistics, depending on what protocols are in use on the BSR. The following is an example of typical screen output from the show ip traffic command:
IP statistics: Rcvd: 3348 total, 1215 local destination 0 no ip address configured on vrf 0 incoming interface with no ip addresses, 0 null incoming interface 0 packet received on a cable bundle i/f with master, 0 packets with local src addr 0 packets with src addr = 0xffffffff, 0 packets with src addr = 0 0 format errors, 0 checksum errors, 0 bad hop count 0 unknown protocol, 0 not a gateway 0 security failures, 0 bad options, 0 with options 0 end, 0 nop, 0 basic security, 0 loose source route 0 timestamp, 0 extended security, 0 record route 0 streamID, 0 strict source route, 0 alert, 0 cipso 0 policy-based routing forward, 0 other 0 reassembled, 0 timeouts, 0 couldn't reassemble 0 fragmented, 0 couldn't fragment 34 received, 0 sent 971 control pkt received, 3126 control pkt sent 0 data pkt received, 0 data pkt sent 6395 generated, 2133 forwarded 0 encapsulation failed, 0 unresolved, 0 no adjacency 0 Mcast In Drop, 0 Mcast Out Drop 0 no route, 0 unicast RPF, 0 forced drop 0 acces-list inbound, 0 access-list outbound 0 policy-based routing drop ICMP statistics: Rcvd: 0 format errors, 0 checksum errors, 0 redirects, 0 unreachable 0 echo, 0 echo reply, 0 mask requests, 0 mask replies,0 quench 0 parameter problem, 0 timestamp, 0 timestamp reply, 0 info request 0 other, 0 irdp solicitations, 0 irdp advertisements Sent: 0 redirects, 0 unreachable, 0 echo, 0 echo reply 0 mask requests, 0 mask replies, 0 quench, 0 timestamp 0 info reply, 0 time exceeded, 0 parameter problem

Opts:

Frags: Bcast: Mcast: Sent: Drop:

2-94

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

UDP statistics: Rcvd: 34 total, 0 checksum errors, 0 no port, 34 no port broadcast Sent: 0 total, 0 forwarded broadcasts Dhcp Relay Rcvd: 20 discover, 20 offer, 14 request 14 ack, 0 nak Dhcp Relay Sent: 20 discover, 20 offer, 14 request 14 ack, 0 nak DhcpLeaseQuery Sent: 0 DhcpLeaseQuery Rcvd: 0 Active, 0 Known, 0 Unknown, 0 Unimplemented TCP statistics: Dropped 0 broadcast/multicast TCP packets in the IP layer Rcvd: 109 total, 0 checksum errors, 0 no port Sent: 111 total ARP statistics: Rcvd: 10 requests, 1 replies, 0 reverse replies, 0 reverse requests, 0 oth er Sent: ts OSPF statistics: Rcvd: 1044 total (dropped 0), 665 hello (dropped 0) 3 database desc, 0 link state req, 301 link state updates 75 link state acks 3131 total, 2756 hello 2 database desc, 2 link state req, 77 link state updates 294 link state acks IGMP statistics: Sent/Received Total: 0/0, Format errors: 0/0, Checksum errors: 0/0 Host Queriers: 0/0, Host Reports: 0/0, Host Leaves: 0/0 Bad Queries: 0/0, Bad Reports: 0/0 4 requests, 7 replies (0 proxy), 0 reverse replies, 0 reverse reques

Sent:

Compass ID: 271820115 Version 3

2-95

BSR 64000 Command Reference Guide

Release 5.0.0

DVMRP statistics: Total DVMRP routes: 0, Valid DVMRP routes: 0 Total Probes sent: 0, Total Probes received: 0 Total Reports sent: 0, Total Reports received: 0 Total Prunes sent: 0, Total Prunes received: 0 Total Grafts sent: 0, Total Grafts received: 0 Total Graft Acks sent: 0, Total Graft Acks received: 0 Total Unknown packets received: 0 PIM statistics: All Pim Send & Receive counters: 0 RADIUS client statistics: Recv: invalid server 0

TACACS+ Statistics TACACS+ Overall Statistics Number of access requests

: 0

Number of access deny responses : 0 Number of access allow responses: 0

No TACACS+ Servers Configured.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip traffic [ | {begin | exclude | include} {} [ | {count | count-only}]]

2-96

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show ip traffic [ | {count | count-only}]

Command Syntax
| begin exclude include WORD count count-only turn on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

2-97

BSR 64000 Command Reference Guide

Release 5.0.0

show l2-cam
The show l2-cam command displays the BSR’s Layer 2 Content Addressable Memory (L2 CAM). The following is typical output from the show l2-cam command:

Index -----256 257 260 261 8059 8061

PID IP Address/Mask --------- ------------------eth 15/1 eth 15/2 eth 15/1 eth 15/2 eth 15/2 eth 15/1 150.31.90.10/32 150.31.98.10/32 150.31.90.0/24 150.31.98.0/24 0.0.0.0/0 0.0.0.0/0

PRI/CFI/VLAN -----------0/ 0/ 0/ 0/ 0/ 0/ 0/ 0/ 0/ 0/ 0/ 0/ 0 0 0 0 0 0

EN -1 1 1 1 1 1

PT -0 0 0 0 0 0

TOS --0 0 0 0 0 0

VRF ------

IIID -----eth 15/1 eth 15/2 eth 15/1 eth 15/2

ILID -----2 3 2 3 3 2

eth 15/2 eth 15/1

The following provides descriptions of the various show l2-cam command output fields: Index PID IP Address/Mask Type Label PRI label specified by this router Port ID - the BSR module slot and port number IP address identifies either the Provider (P) or Provider Edge (PE) router MPLS label frame priority level which is used for prioritizing traffic and is capable of representing 8 levels (0-7) Canonical Format Indicator (CFI), 1 indicates the MAC address is in non-canonical format, 0 indicates the MAC address is in canonical format VLAN ID number

CFI

VLAN

2-98

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

TP BEN EN PT TOS VRF EIID/IIID IIID ILID MAC Address

reserved by Motorola. Layer 2 Bridge status, 0 indicates disabled, 1 indicates enabled Routing status, 0 indicates disabled, 1 indicates enabled Preserve (P) Type of Service (TOS) status, 0 indicates disabled, 1 indicates enabled Type of Service value VRF name Egressing or Ingressing Interface ID Ingressing Interface ID Ingressing Logical ID MAC address (not valid for POS) of the BSR module slot and port number

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show l2-cam {ip | label | mac []} [ { | begin | exclude | include} {} [ | count | count-only}]] show l2-cam {ip | label | mac []} [ | {count | count-only}]

Note: The "l2" portion of the command syntax command contains a lower case "L" not a 1.

Compass ID: 271820115 Version 3

2-99

BSR 64000 Command Reference Guide

Release 5.0.0

Command Syntax ip display the Internet Protocol table, including bridging (VLAN tagging) entries display leased host authorization entries for a CPE display the entire MAC address table or MAC addresses for a specific BSR module, including VRF host authorization entries for all leased CPEs turn on output modifiers (filters) filter for output that begins with the specified string count lines outputted count lines outputted while surpressing output filter for output that excludes the specified string filter for output that includes the specified string the specified string

label mac [NUM]

| begin count count-only exclude include WORD

2-100

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show sntp
The Simple Network Time Protocol (SNTP) provides system time with high accuracy. The show sntp command displays the following SNTP information for the BSR: SNTP server Stratum Version Last Recvd. Trusted Server? configured SNTP server to request NTP packets or broadcast NTP server address number of NTP hops a machine is from an authoritative time source NTP server version when the last update was received "Yes" - if an authentication was attempted and succeeded; "No" - otherwise

The following is an example of typical screen output from the show sntp command:

Polling interval is 100 seconds. SNTP server Stratum Version 150.31.1.32 14 3

Last Recvd. Trusted Server? 0 hours 0 min 21 sec No

Group Access
All

Command Mode
All modes excpet User EXEC

Command Line Usage show sntp [detail]

Command Syntax

detail

display transaction details even if no SNTP server is configured

Compass ID: 271820115 Version 3

2-101

BSR 64000 Command Reference Guide

Release 5.0.0

show tcp brief
The show tcp brief command displays a brief summary of TCP status and configuration. The following is an example of typical screen output from the show tcp brief command:

Active TCP connections (including servers) PCB Proto Recv-Q Send-Q Local Address Foreign Address (state) VPN -------- ----- ------ ------ ---------------- ------------------ ----------- --d2bf708 TCP 0 0 150.31.90.10.23 10.14.37.103.41479 ESTABLISHED global all vpns d2bf460 TCP 0 0 0.0.0.0.179 0.0.0.0.0 LISTEN all vpns d2be4f8 TCP 0 0 0.0.0.0.23 0.0.0.0.0 LISTEN

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage show tcp brief

2-102

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

show tcp statistics
The show tcp statistics command displays the Transmission Control Protocol (TCP) statistics. The show tcp statistics command displays the following information: sent: packets sent data packets data packet retransmitted ack-only packets URG only packet window probe packet window update packet control packets received: packets received acks duplicate acks ack for unsent data packets received in sequence statistics for packets sent by the router total number of packets sent number of data packets sent number of data packets retransmitted number of packets sent that are acknowledgments only number of urgent packets sent number of window probe packets sent number of window update packets sent number of control packets (SYN, FIN, or RST) sent statistics in this section refer to packets received by the router total number of packets received number of acknowledgment packets received number of duplicate acknowledgment packets received number of acknowledgment packets with unsent data received number of data packets received in sequence

completely duplicate number of duplicate packets received packets

Compass ID: 271820115 Version 3

2-103

BSR 64000 Command Reference Guide

Release 5.0.0

packets with some dup data out-of-order packet packet of data after window window probe window update packets

number of packets received with partially duplicated data number of packets received out of order number of packets received with data that exceeds the receiver window size number of window probe packets received number of window update packets received

packet received after number of packets received after the close connection has been closed discarded for bad checksum discarded for bad header offset field discarded because packet too short connection request connection accepts number of packets received with checksum error number of packets received with bad offset to data number of packets received that were too short number of connections initiated number of connections accepted

connections established number of connections established connections closed retransmit timeout connection dropped by rxmit timeout keepalive timeouts keepalive probes sent connection dropped by keepalive number of connections closed number of times the router tried to retransmit, but timed out number of connections dropped in retransmit timeout number of keepalive packets in timeout number of keepalive probes number of connections dropped in keepalive

2-104

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

The following is an example of typical screen output from the show tcp statistics command:
TCP: 20117 packets sent 11990 data packets (399789 bytes) 0 data packet (0 byte) retransmitted 8116 ack-only packets (4 delayed) 0 URG only packet 0 window probe packet 0 window update packet 14 control packets 22949 packets received 11896 acks (for 399790 bytes) 2921 duplicate acks 0 ack for unsent data 11794 packets (12305 bytes) received in-sequence 2 completely duplicate packets (1 byte) 0 packet with some dup. data (0 byte duped) 0 out-of-order packet (0 byte) 0 packet (0 byte) of data after window 0 window probe 5573 window update packets 0 packet received after close 0 discarded for bad checksum 0 discarded for bad header offset field 0 discarded because packet too short 0 connection request 9 connection accepts 8 connections established (including accepts) 9 connections closed (including 8 drops) 1 embryonic connection dropped 11895 segments updated rtt (of 11903 attempts) 1 retransmit timeout 0 connection dropped by rexmit timeout 0 persist timeout 2916 keepalive timeouts 2915 keepalive probes sent 0 connection dropped by keepalive 0 pcb cache lookup failed

Compass ID: 271820115 Version 3

2-105

BSR 64000 Command Reference Guide

Release 5.0.0

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage show tcp statistics

2-106

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

shutdown
The shutdown command disables an interface. An interface is in a shutdown state when some configuration tasks must be performed on the interface. All interfaces on the BSR are shutdown by default. The no shutdown command is used to enable a disabled interface.

Note: Use the show interfaces command to display which interfaces are enabled or disabled.

Group Access
System Administrator

Command Mode
Interface Configuration

Command Line Usage shutdown no shutdown

Compass ID: 271820115 Version 3

2-107

BSR 64000 Command Reference Guide

Release 5.0.0

sntp authenticate
The sntp authenticate command enables authentication for SNTP. The no sntp authenticate command disables authentication for SNTP.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage sntp authenticate no sntp authenticate

2-108

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

sntp authentication-key
The sntp authentication-key command enables authentication for SNTP. The no sntp authentication-key command disables authentication for SNTP. Use the sntp authentication-key command to authenticate SNTP sources for additional security.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage sntp authentication-key [md5 ] no sntp authentication-key

Command Syntax
1-4294967295 md5 WORD key number use the md5 algorithm key value, up to 8 characters

Compass ID: 271820115 Version 3

2-109

BSR 64000 Command Reference Guide

Release 5.0.0

sntp broadcastdelay
The sntp broadcastdelay command establishes the round-trip delay time between the system and a broadcast server. The no sntp broadcastdelay command removes the round-trip delay time between the system and a broadcast server and returns it to the default. Use the sntp broadcastdelay command to set the exact time between the router as a broadcast client and the network.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage sntp broadcastdelay no sntp broadcastdelay

Command Syntax
1-999999 round-trip delay in microseconds

Command Default
3000 microseconds

2-110

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

sntp broadcast client
The sntp broadcast client command configures the BSR to listen for SNTP broadcasts. The no sntp broadcast client command blocks the BSR from receiving SNTP broadcast traffic. Use the sntp broadcast client command to receive NTP traffic from a broadcast server.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage sntp broadcast client no sntp broadcast client

Compass ID: 271820115 Version 3

2-111

BSR 64000 Command Reference Guide

Release 5.0.0

sntp disable
The sntp disable command disables SNTP. The no sntp disable command enables the BSR to accept NTP traffic from other servers.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage sntp disable no sntp disable

Command Default
Enabled

2-112

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

sntp response timeout
The sntp response timeout command is used to configure the switchover criteria when the active SNTP server is not responding and the next SNTP server on the SNTP server list becomes the active SNTP server. For details on configuring the list of SNTP servers, refer to the sntp server command. The switchover criteria is determined by the total number of failures occurring within a number of attempts at communicating with the active SNTP server. When the number of failures out of the number of attempts match the numbers configured with the sntp response timeout command, then the next SNTP server on the list will become the active SNTP server. The default values are three failures and five attempts. If using the default values and a server has three failures out of five attempts, then the next configured SNTP server on the SNTP server list becomes the active SNTP server. The no sntp response timeout command restores the default values.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage sntp response timeout attempts sntp response timeout failures no sntp response timeout attempts no sntp response timeout failures

Command Syntax
1-5 the number of attempts/failures allowed with the active SNTP server before switching to the next SNTP server

Command Default attempts = 5 failures = 3
Compass ID: 271820115 Version 3 2-113

BSR 64000 Command Reference Guide

Release 5.0.0

sntp server
The sntp server command configures a BSR for SNTP to accept NTP traffic. The no sntp server command disables the BSR from receiving NTP traffic. A secondary SNTP server can also be configured as a backup in case the primary SNTP server goes down unexpectedly. This secondary SNTP server automatically becomes the primary SNTP server after 5 unsuccessful attempts to contact the primary SNTP server.

Note: When the SNTP server address is set to 224.0.1.1 (the assigned multicast address for NTP), the BSR operates in unicast mode. It then transmits a request to this multicast address and waits for replies. It then "binds" to the first SNTP server that replies. All subsequent transactions happen in a unicast mode. In this way, the SNTP server’s address does not need to be known beforehand. If you configure the BSR to operate in authenticated mode, you must also configure an authentication key with the sntp authentication-key command and a trusted key with the sntp trusted-key command. Caution: If the sntp server configuration command is specified, the clock timezone command must also be specified. Otherwise, the timezone may not be initialized properly on the standby SRM and wildly fluctuating time changes may be recorded when switching from the primary to the standby SRM.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage sntp server {224.0.1.1 | | } [key ] [secondary [key ]] no sntp server [secondary]

2-114

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

Command Syntax
224.0.1.1 A.B.C.D Hostname key 1-4294967295 secondary the NTP Multicast group the SNTP server’s IP address. the SNTP server’s hostname the key number for authentication purposes specifies this SNTP server as a secondary SNTP server

Compass ID: 271820115 Version 3

2-115

BSR 64000 Command Reference Guide

Release 5.0.0

sntp source-interface loopback
The sntp source-interface loopback command specifies a configured loopback interface as the interface for sending SNTP messages. The no sntp source-interface loopback command removes the configured SNTP source-interface.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage sntp source-interface loopback no sntp source-interface

Command Syntax loopback 1-255 the loopback interface number; the loopback interface must be previously configured

Command Default
An SNTP source-interface is not configured.

2-116

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

sntp timer
The sntp timer command specifies the time interval between queries to the SNTP server. The no sntp timer command removes the time interval.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage sntp timer no sntp timer

Command Syntax
1-86400 time interval in seconds

Compass ID: 271820115 Version 3

2-117

BSR 64000 Command Reference Guide

Release 5.0.0

sntp trusted-key
The sntp trusted-key command authorizes synchronization and authenticates system identity. The no sntp trusted-key command disables synchronization and removes system identity. Use the sntp trusted-key command to establish a key or keys following the sntp authentication-key command to synchronize the system. The sntp trusted-key command synchronizes with only those systems that are trusted to deliver additional security.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage sntp trusted-key no sntp trusted-key

Command Syntax
1-4294967295 trusted authentication key-number for trusted time source

Command Default
No trusted keys defined

2-118

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

traceroute
The traceroute command is used to trace the route that packets take through the network from their source to their destination. The BSR sends out a sequence of User Datagram Protocol (UDP) datagrams to an invalid port address at the remote host to trace the route through the network, as follows:
■

First, three UDP datagrams are sent, each with a TTL field value set to 1. The TTL value of 1 causes the datagram to "timeout" as soon as it reaches the first router in the path. The router responds with an ICMP "time exceeded" message indicating that the datagram has expired. Next, three more UDP datagrams are sent, each with the TTL value set to 2. This causes the second router in the path to the destination to return an ICMP "time exceeded" message. This process continues until the UDP datagrams reach the destination and the system originating the traceroute has received an ICMP "time exceeded" message from every router in the path to the destination. Since the UDP datagrams are trying to access an invalid port at the destination host, the host responds with an ICMP "port unreachable" message which signals the traceroute program to finish. The following is typical screen output from the traceroute command:

■

■

traceroute to 150.31.40.10 : 1-64 hops, 38 byte packets 1 172.17.103.65 0.000 ms 0.000 ms 0.000 ms 2 172.17.1.1 0.000 ms 0.000 ms 0.000 ms 3 150.31.1.21 0.000 ms 16.7 ms 0.000 ms 4 150.31.40.10 0.000 ms 0.000 ms 0.000 ms Trace complete

Group Access
All

Command Mode
User EXEC and Privileged EXEC

Compass ID: 271820115 Version 3

2-119

BSR 64000 Command Reference Guide

Release 5.0.0

Command Line Usage traceroute { | } [Source ] [timeout ] [nprobes ] [minhops ] [maxhops ] [port ] [tos ] [df ]

Command Syntax
A.B.C.D Hostname Source A.B.C.D timeout 1-1024 nprobes 1-1024 minhops 1-64 destination IP address destination hostname IP address of the source interface number of seconds to wait for a response to a probe packet number of probes to send minimum TTL value - the default value is 1 but can be set to a higher value to suppress the display of known hops maximum TTL value - the traceroute command terminates when the destination or this value is reached destination port used by the UDP probe messages type of service value set the "Don’t Fragment" flag in the IP header

maxhops 2-1024

port 0-65535 tos 0-255 df

Command Defaults timeout = 3 seconds nprobes = 3 minhops = 1 maxhops = 64 port = 32868 tos = 0 df = disabled
2-120 Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

trap-enable-if
The trap-enable-if command enables the ifLinkUpDownTrapEnable trap. The ifLinkUpDownTrapEnable trap indicates whether a link up or link down trap should be generated for an interface. The no trap-enable-if command disables the ifLinkUpDownTrapEnable trap.

Group Access
All

Command Mode
Interface Configuration

Command Syntax trap-enable-if no trap-enable-if

Command Default
Disabled

Compass ID: 271820115 Version 3

2-121

BSR 64000 Command Reference Guide

Release 5.0.0

trap-enable-rdn
The trap-enable-rdn command enables the rdnCardIfLinkUpDownEnable trap. The rdnCardIfLinkUpDownEnable trap indicates whether a link up or link down trap should be generated for a BSR module. The no trap-enable-rdn command disables the rdnCardIfLinkUpDownEnable trap.

Group Access
All

Command Mode
Interface Configuration

Command Syntax trap-enable-rdn no trap-enable-rdn

Command Default
Disabled

2-122

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

tunnel destination
The tunnel destination command provides a tunnel interface destination. The no tunnel destination command removes a tunnel interface destination. Note: The tunnel destination command specifies the endpoint of the tunnel. If a hostname is specified, DNS must have already been configured. The host name-to-address translation is done following the command only once. If mapping changes occur, the command needs to be re-issued and is stored as an IP address in the configuration files.

Group Access
ISP

Command Mode
Interface Configuration (tunnel interface only)

Command Line Usage tunnel destination { | } no tunnel destination

Command Syntax
A.B.C.D Hostname IP address of the tunnel interface destination DNS name of tunnel interface destination

Compass ID: 271820115 Version 3

2-123

BSR 64000 Command Reference Guide

Release 5.0.0

tunnel mode
The tunnel mode command specifies the tunnel encapsulation method to be used when configuring a tunnel interface.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage tunnel mode {dvmrp | gre | ipip}

Command Syntax dvmrp Distance Vector Multicast Routing Protocol (DVMRP) - routes multicast datagrams only within a single Autonomous System Generic Routing Encapsulation (GRE) - a transport layer tunneling protocol that encapsulates a wide variety of protocol packet types inside IP tunnels IP in IP (IPIP) - is an IP-within-IP encapsulation protocol in which an outer IP header is added before the original IP header. The outer IP header Source and Destination addresses identify the "endpoints" of the tunnel. The original IP header Source and Destination addresses identify the original sender and recipient of the datagram.

gre

ipip

2-124

Compass ID: 271820115 Version 3

Release 5.0.0

IP Commands

tunnel source
The tunnel source command specifies a source address for a tunnel interface. The no tunnel source command removes a source address for a tunnel interface.

Group Access
ISP

Command Mode
Interface Configuration (tunnel interface only)

Command Line Usage tunnel source { | cable | default | ethernet | gigaether | loopback | pos } no tunnel source { | cable | default | ethernet | gigaether | loopback | pos }

Command Syntax
A.B.C.D cable X/Y default ethernet X/Y gigaether X/Y loopback 1-255 pos X/Y source IP address for the tunnel interface CMTS interface slot X and MAC Domain Y source interface is based on the destination IP address Ethernet interface slot X and port Y Gigabit Ethernet interface slot X and port Y loopback interface number Packet-Over-SONET interface slot X and port Y

Compass ID: 271820115 Version 3

2-125

BSR 64000 Command Reference Guide

Release 5.0.0

unresolved-ip-packet-throttle
The unresolved-ip-packet-throttle command provides a throttling mechanism to prevent problems such as voice packet drops or latency that can be caused by short bursts of a large number of packets which require ARP resolutions being sent to the CMTS at a rate higher than the CMTS can process. The unresolved-ip-packet-throttle command prevents such problems from occurring regardless of configuration or traffic load by preventing the CMTS from being overrun but still allowing normal ARP resolution traffic to occur

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage unresolved-ip-packet-throttle { burst-rate | rate } no unresolved-ip-packet-throttle

Command Syntax burst-rate 1-8000 rate 1-4000 configures the unresolved IP packet throttling burst-rate in packets/second configures the unresolved IP packet throttling packet rate in packets/second

Command Defaults
Enabled burst-rate = 20 packets/second rate = 200 packets/second

2-126

Compass ID: 271820115 Version 3

3
SNMP Commands

Introduction
This chapter describes the Simple Network Management Protocol (SNMP) commands used to manage the BSR 64000. Since it was developed in 1988, SNMP has become the de facto standard for internetwork management. SNMP is an application layer protocol and is based on the manager/agent model. SNMP is referred to as simple because the agent requires minimal software. Most of the processing power and the data storage resides on the management system, with a subset of those functions residing in the managed system. A typical agent usually implements the SNMP protocol, stores and retrieves management data (as defined by the MIB); can asynchronously signal an event to the manager; and can be a proxy for some non-SNMP network node. A typical manager implemented as a Network Management Station (NMS) Network-management stations implements the SNMP protocol; learns of problems by receiving event notifications, called traps, from network devices implementing SNMP; is able to query agents; gets responses from agents; sets variables in agents; and acknowledges synchronous events from agents. The primary protocols that SNMP runs on are the User Datagram Protocol (UDP) and IP. SNMP also requires Data Link Layer protocols such as Ethernet to implement the communication channel from the management to the managed agent.

Compass ID: 271820115 Version 3

3-1

BSR 64000 Command Reference Guide

Release 5.0.0

SNMP Command Descriptions
This section contains an alphabetized list and descriptions of the SNMP commands supported by the BSR.

3-2

Compass ID: 271820115 Version 3

Release 5.0.0

SNMP Commands

show snmp
The show snmp command displays SNMP statistics, determine the running status, and display configuration information such as chassis ID, system description, and system location, chassis ID, and counter information for the SNMP process. The show snmp command, without arguments, displays the following information:

SNMP In Packets Bad SNMP version errors Unknown community names Illegal operations for community names supplied ASN parse errors Requested variables Changed variables Get requests Get-next requests Get responses Set requests SNMP Out Packets Get-next requests Get responses Set requests Timeouts

total number of SNMP packets received by the SNMP agent number of bad SNMP packets received with bad SNMP version errors number of SNMP packets received with unknown community names number not allowed

number incorrectly encoded variables requested by SNMP managers variables altered by SNMP managers numberof get-request PDUs received number of get-next PDUs received number of get-response PDUs received number of set request PDUs received number of SNMP packets sent by the agent number of get-next PDUs sent by the agent number of get-response PDUs sent by the agent number of set request PDUs sent by the agent number of out PDU timeouts

Compass ID: 271820115 Version 3

3-3

BSR 64000 Command Reference Guide

Release 5.0.0

Packets too big No such name errors Bad values General errors

larger than maximum packet size sent by the agent name errors nonexistent number, undefinable Management Information Base (MIB) number of set requests that detail an invalid value for a MIB object number of requests failed due to some other error, excluding a noSuchName error, badValue error, or any of the other specific errors number of responses number of traps sent number of traps dropped due to exceeding a throttling rate limit

Responses Traps Traps Dropped due to throttling Informs Notification Errors Probes Inform Retries Probe Retries

number of inform requests sent number of notification errors sent

number of probes sent number of inform retries sent number of probe retries sent

3-4

Compass ID: 271820115 Version 3

Release 5.0.0

SNMP Commands

The following is an example of typical screen output from the show snmp command:

SNMP Information: Status: running Port Number: 161 Contact: Tom Terrific (Tom.Terrific@motorola.com) Description: BSR 64000(tm) | retry 0-2147483>} no ppp timeout {ncp | retry}

Command Syntax ncp 1-2147483 amount of time, in seconds, configured before timing out from lack of response at the NCP layer amount of time, in seconds, configured before timing out from lack of response at the LCP layer

retry 0-2147483

Command Default
10 seconds

15-30

Compass ID: 271820115 Version 3

Release 5.0.0

POS Commands

show aps
The show aps command provides APS configuration and statistics information for groups containing working and protection ports.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show aps

Compass ID: 271820115 Version 3

15-31

BSR 64000 Command Reference Guide

Release 5.0.0

show controllers pos
The show controllers pos command displays high level information on the POS controllers. Use the show controllers pos command for troubleshooting. The following POS controller information is provided: SECTION: section portion of the SONET link errors; a section can be between the Customer Premise Equipment (CPE) and SONET Service Provider Equipment (SPE) B1_ERRORS = B1 BER threshold crossing alarm LINE: line portion errors; a line can be between a SONET SPE, regenerators and another SONET SPE B2_ERRORS = B2 BER threshold crossing alarm REI_ERRORS = Remote Error Indicator PATH: errors that occur on the path portion of the SONET link; a path can be between a CPE, SONET SPE, regenerators and another SONET SPE and CPE B3_ERRORS = B3 BER threshold crossing alarm GI_ERRORS = G1 threshold crossing alarm Active Defects: Active Alarms: Alarm reporting enabled for: APS: PATH SIGNAL LABEL: list of all active SONET defects list of current alarms as enforce by SONET alarm hierarchy alarms enabled through the pos report command Rx(K1/K2)/Tx(K1/K2) = contents of the received and transmitted K1 and K2 bytes. C2 = received value from the SONET path signal label byte

15-32

Compass ID: 271820115 Version 3

Release 5.0.0

POS Commands

SYNCHRONOUS STATUS MESSAGE: CLOCK RECOVERY: PATH TRACE BUFFER: APS BER thresholds: TCA thresholds:

S1 = lower 4 bits of S1 byte.

SONET clock recovered using information in the SONET overhead. RDOOL = an inexact count of the number of

times Receive Data Out Of Lock has been detected.
SONET path trace buffer for communication information about remote hostname, interface name and number, and IP address, or any other message you choose list of the APS bit-error rate (BER) thresholds configured with the pos threshold command list of threshold crossing alarms (TCA) configured with the pos threshold command

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show controllers pos []

Command Syntax
X/Y POS interface slot and port number

Compass ID: 271820115 Version 3

15-33

BSR 64000 Command Reference Guide

Release 5.0.0

show interfaces pos
The show interfaces pos command displays the SONET interface configuration. The following information is provided: POS 15/0 is indicates whether the interface hardware is currently active and administratively can transmit and receive or if it has been taken down by an up/down, line administrator protocol is up/down Hardware MTU BW Encapsulation Keepalive Scramble LCP Initial IPCP Initial Last input hardware type maximum transmission units of the interface interface bandwidth in kilobits per second encapsulation method assigned to interface keepalive set indicator POS scramble enable LCP initialized IPCP initialized hours, minutes, and seconds since the last packet was successfully received by an interface.; useful for knowing when a dead interface failed hours, minutes, and seconds since the last packet was successfully transmitted by an interface of show interface counters hours, minutes, and seconds when the interface was reset first-in, first-out queuing strategy (other queueing strategies you might see are priority-list, custom-list, and weighted fair) number of packets in output and input queues. Each number is followed by a slash, the maximum size of the queue, and the number of packets dropped because a queue was full error-free packets received by the system

Last output Last clearing Last state change Queueing strategy Output queue, drops/input queue, drops packets input

15-34

Compass ID: 271820115 Version 3

Release 5.0.0

POS Commands

bytes (input) broadcasts multicasts input errors

number of bytes, including data and MAC encapsulation, in the error-free packets received by the system number of broadcast packets received by the interface number of multicast packets received by the interface number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and abort counts; other input-related errors can also increment the count, so that this sum might not balance with the other counts cyclic redundancy checksum generated by the originating LAN station or far-end device does not match the checksum calculated from the data received. On a LAN, this usually indicates noise or transmission problems on the LAN interface or the LAN bus itself. A high number of CRCs is usually the result of collisions or a station transmitting bad data. On a serial link, CRCs usually indicate noise, gain hits or other transmission problems on the data link number of times the serial receiver hardware was unable to hand received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data packets that are discarded because they are smaller than the medium's minimum packet size packets that are discarded because they exceed the medium's maximum packet size illegal sequence of one bits on the interface total number of messages transmitted by the system total number of bytes, including data and MAC encapsulation, transmitted by the system sum of all errors that prevented the final transmission of datagrams out of the interface being examined. Note that this might not balance with the sum of the enumerated output errors, as some datagrams can have more than one error, and others can have errors that do not fall into any of the specifically tabulated categories.

CRC

overruns

runts giants aborts packets output bytes (output) output errors

Compass ID: 271820115 Version 3

15-35

BSR 64000 Command Reference Guide

Release 5.0.0

collisions underruns carrier transitions

collision indication Number of times that the far-end transmitter has been running faster than the near-end router's receiver can handle Number of times the carrier detect signal of the interface has changed state.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show interfaces pos [] [ | {begin | exclude | include} {} [ | {count | count-only}]] show interfaces pos [] [ | {count | count-only}]

Command Syntax
X/Y | begin exclude include WORD count count-only POS interface slot and port number turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

15-36

Compass ID: 271820115 Version 3

Release 5.0.0

POS Commands

show ppp info
The show ppp info command displays PPP link and statistic information.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ppp info [ | {begin | exclude | include} {} [ | {count | count-only}]] show ppp info [ | {count | count-only}]

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

15-37

BSR 64000 Command Reference Guide

Release 5.0.0

show ppp statistics
The show ppp statistics command displays the PPP running statistics.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ppp statistics [ | {begin | exclude | include} {} [ | {count | count-only}]] show ppp statistics [ | {count | count-only}]

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

15-38

Compass ID: 271820115 Version 3

16
BGP Commands

Introduction
This chapter describes the Border Gateway Protocol version 4 (BGP-4) commands used with the BSR. BGP is an Inter-Autonomous System (AS) routing protocol that exchanges network availability information with any other router speaking BGP. The information for a network is the complete list of ASs that traffic must transport to reach that network and is then used to assure loop-free paths. This information is used to construct a graph of AS connectivity from which routing loops may be pruned, and some policy decisions at the AS level may be enforced.

BGP Command Descriptions
This section contains an alphabetized list and descriptions of the BGP commands supported by the BSR.

Compass ID: 271820115 Version 3

16-1

BSR 64000 Command Reference Guide

Release 5.0.0

aggregate-address
The aggregate-address command creates an entry in the BGP routing table. The no aggregate-address command disables this function. Use the aggregate-address command to implement aggregate routing by redistributing the route in BGP.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage aggregate-address [advertise-map ] [as-set] [attribute-map ] [summary-only] [suppress-map ] no aggregate-address [advertise-map ] [as-set] [attribute-map ] [summary-only] [suppress-map ]

Command Syntax A.B.C.D
A.B.C.D advertise-map WORD

aggregate address in routing table aggregate mask in routing table name of route map to choose the routes to include into the aggregate and generate associated attributes if as-set is specified route map name to establish aggregate route attribute generates AS set path information creates aggregate route and suppresses advertisements of all aggregated, more specific routes suppresses chosen, specific routes

attribute-map WORD as-set summary-only

suppress-map WORD

Command Default
Disabled

16-2

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

auto-summary
The auto-summary command returns the user back to the automatic summarization default of subnet routes into network-level routes. The no auto-summary command disables this function. When the route is summed up, it reduces the amount of routing information in the routing tables. Use the network command or the no auto-summary command to advertise and transmit subnet routes in BGP. BGP will not accept subnets distributed from IGP. If a network command is not entered, and auto-summarization is disabled, network routes will not be advertised for networks with subnet routes unless they contain a summary route.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage auto-summary no auto-summary

Command Default
Enabled

Compass ID: 271820115 Version 3

16-3

BSR 64000 Command Reference Guide

Release 5.0.0

bgp always-compare-med
The bgp always-compare-med command enables comparison of the Multi-exit Discriminator (MED) from path entries from different ASs. The no bgp always-compare-med command stops comparisons. Use the bgp always-compare-med command to change the default, allowing comparison of MEDs, which are received from any autonomous system. By default, during the best-path selection process, MED comparison is done only among paths from the same autonomous system. This command changes the default behavior by allowing comparison of MEDs among paths regardless of the autonomous system from which the paths are received. The MED path, considered the best path, is the parameter used when selecting the paths compared to many other options. The preference between a path with a lower MED and a path with a higher MED, is the lower MED path.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage bgp always-compare-med no bgp always-compare-med

16-4

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

bgp client-to-client reflection
The bgp client-to-client reflection command re-establishes route reflection from a BGP router reflector client to other clients. The no bgp client-to-client reflection command stops the re-establishment of route reflection from a BGP router reflector. Use the bgp client-to-client-reflection command to configure the cluster if it has more than one route and to increase redundancy. The routes from a client, or route reflector, are reflected to other clients. Clients of a route reflector are not required to be fully interconnected. More often than not, a cluster of clients will have a single route reflector. The router ID of the route reflector identifies the cluster. To ensure increased redundancy, and evade a single point of failure, a cluster might have more than one route reflector. If this is the case, all route reflectors that are in the cluster must be configured with a 4-byte cluster ID. Use the no bgp client-to-client command to disable BGP client-to-client reflection. If client-to-client reflection is enabled, clients of a route reflector can not be members of a peer group.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage bgp client-to-client reflection no bgp client-to-client reflection

Command Default
When a route reflector is configured, it reflects routes from a client to other clients.

Compass ID: 271820115 Version 3

16-5

BSR 64000 Command Reference Guide

Release 5.0.0

bgp cluster-id
The bgp cluster-id command configures a cluster ID if the BGP cluster has more than one route reflector. The no bgp cluster-id command removes the cluster. Use the bgp cluster-id command to increase redundancy and avoid a single point of failure. Route reflectors in a cluster must be configured with a 4-byte cluster ID in order to be recognized from route reflectors in the same cluster. Use this command to configure the cluster ID if the route reflector has more than one route.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage bgp cluster-id no bgp cluster-id

Command Syntax value router (as a route reflector) ID in IP address format

Command Default router ID route reflector in cluster

16-6

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

bgp confederation identifier
The bgp confederation identifier command configures a BGP confederation identifier. The no bgp confederation identifier command removes a BGP confederation identifier. Use the bgp confederation identifier command to reduce the IBGP mesh. It splits an autonomous system into many autonomous systems. They are then grouped into an individual confederation. Each autonomous system is entirely engaged and has a small number of connections to other autonomous systems in the confederation. The confederation appears to be an individual autonomous system to all else.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage bgp confederation identifier no bgp confederation identifier

Command Syntax
1-65535 autonomous system number to identify the confederation as a whole

Compass ID: 271820115 Version 3

16-7

BSR 64000 Command Reference Guide

Release 5.0.0

bgp confederation peers
The bgp confederation peers command configures the ASs that belong to the confederation. The no bgp confederation peer command removes an AS from the confederation. Use the bgp confederation peers command to configure the ASs that belong to a confederation. Autonomous systems specified in this command are visible internally to a confederation. Each autonomous system is fully meshed within itself. The BGP confederation identifier command specifies the confederation to which the autonomous systems belong.

Group Access
ISP

Command Mode
Router configuration

Command Line Usage bgp confederation peers [1-65535...] no bgp confederation peers

Command Syntax[
1-65535 autonomous system number

16-8

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

bgp dampening
The bgp dampening command enables BGP route dampening. The no bgp dampening command to sets the default values or disables this function. Note: The penalty is halved after the half-life period when a route is flapping. The router configured for damping (dampening) assigns a penalty to a route when a route flaps. Penalties are cumulative and are stored in the BGP routing table. A flapping route is suppressed when its penalty exceeds the suppress limit. A suppressed route is reused when its decayed penalty falls below the reuse limit.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage bgp dampening [ | route-map ] no bgp dampening

Command Syntax
1-45 half-life period in minutes, each time a route is assigned a penalty, the penalty is decreased by half after the half-life period in 5 second intervals, with penalties being cumulative allows route to be reused if penalty for flapping route falls below reuse value route suppresses when its penalty exceeds this value maximum suppression time in minutes route map name

1-20000 1-20000 1-255 route-map WORD

Compass ID: 271820115 Version 3

16-9

BSR 64000 Command Reference Guide

Release 5.0.0

Command Default half life route reuse route suppression maximum suppression time = 15 minutes = 750 = 2000 = 4 times the half-life

16-10

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

bgp default
The bgp default command specifies the default route advertisement which is sent to all routers in the local ASs. The no bgp default command disables a default advertisement. A default route in a router IP forwarding table is used by the router if a routing entry for a destination does not exist. By convention, a default route is represented by the network mask combination 0.0.0.0/0.0.0.0. Any AS advertising the default route represents itself as the gateway of last resort to other systems.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage bgp default { ipv4-unicast | local-preference | route-refresh | vpnv4 } no bgp default { ipv4-unicast | local-preference | route-refresh | vpnv4 }

Command Syntax ipv4-unicast local-preference 0-4294967295 activate IP Version 4 (IPv4) Unicast for a peer by default local preference value (higher values receive preference) - when multiple paths exist to the same destination, the local preference specifies the preferred path activate Route Refresh for a peer by default activate VPN-IP Version 4 (VPNv4) for a peer by default

route-refresh vpnv4

Compass ID: 271820115 Version 3

16-11

BSR 64000 Command Reference Guide

Release 5.0.0

bgp permit
The bgp permit command permits updates with either the AGGREGATOR attribute set to the 0 Autonomous System (AS) or with the 0.0.0.0 address in the BGP routing process. The no bgp permit command disables the updates.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage bgp permit [aggregator-AS-0 | aggregator-address-0] no bgp permit [aggregator-AS-0 | aggregator-address-0]

Command Syntax aggregator-AS-0 aggregator-address-0 permits updates to AGGREGATOR attribute set with an AS of 0. permits updates with the AGGREGATOR attribute set with a 0.0.0.0 address.

Command Default
Disabled

16-12

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

bgp router-id
The bgp router-id command overrides a configured BGP router identifier (IP address) by manually configuring a new identifier. The no bgp router-id command restores the initial configuration.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage bgp router-id no bgp router-id

Command Syntax
A.B.C.D the new BGP router identifier (IP address)

Compass ID: 271820115 Version 3

16-13

BSR 64000 Command Reference Guide

Release 5.0.0

clear ip bgp
The clear ip bgp command resets a BGP connection using soft reconfiguration.

Group Access
ISP

Command Mode
All modes except User EXEC

Command Line Usage clear ip bgp {* | | }[soft [in | out]]

Command Syntax
* A.B.C.D WORD soft in resets active BGP sessions IP address of BGP neighbor to clear name of a specific BGP peer group to clear the state reapply any export policies and sends refresh updates without clearing the state inbound soft reconfiguration; reapply any import policies and send refresh updates without clearing the state outbound soft reconfiguration

out

Command Default
Disabled

16-14

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

clear ip bgp dampening
The clear ip bgp dampening command clears route dampening information and unsuppresses the suppressed routes.

Group Access
ISP

Command Mode
All modes except User EXEC

Command Line Usage clear ip bgp dampening [ | ]

Command Syntax
A.B.C.D A.B.C.D IP address of the network about which to clear dampening information network mask applied to the above address

Compass ID: 271820115 Version 3

16-15

BSR 64000 Command Reference Guide

Release 5.0.0

clear ip bgp flap-statistics
The clear ip bgp flap-statistics clears BGP flap statistics.

Group Access
ISP

Command Mode
All modes except User EXEC

Command Line Usage clear ip bgp flap-statistics [ | filter-list | regexp ]

Command Syntax
A.B.C.D filter-list 1-199 regexp LINE network to clear flap statistics clear flap statistics for all the paths that pass the access list clear flap statistics for all the paths that match the regular expression clear flap statistics for all the paths that match the regular expression. a regular-expression to match the BGP AS paths

16-16

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

default-information originate
The default-information originate command generates a default route into the BGP database. The no default-information originate command disables default route generation.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage default-information originate no default-information originate

Command Default
Disabled

Compass ID: 271820115 Version 3

16-17

BSR 64000 Command Reference Guide

Release 5.0.0

default-metric
The default metric feature is used to eliminate the need for separate metric definitions for each routing protocol redistribution.The default-metric command forces the BGP routing protocol to use the same metric value for all distributed routes from other routing protocols. The no default-metric command removes or changes the default metric value for the BGP routing protocol.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage default-metric no default-metric

Command Syntax
0-4294967295 Default metric value.

16-18

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

distance bgp
The distance bgp command sets external, internal, and local administrative distances for routes to function. The no distance bgp command sets the default values. Use the distance bgp command to administer distance based on the preferred routing information source received from a router or group of routers. This enables the system to prioritize protocols dependant upon the distances between 1 to 255, where 0 is the best route, and the most unreliable route is 255. The bgp distance command has an influence on whether the BGP-learned routes are installed in the routing table.

Note: It is recommended that the administrative distance not be changed.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage distance bgp [ < 1-255> ] no distance bgp

Command Syntax
1-255 1-255 administrative distance for routes external to the AS administrative distance for routes external to the AS - routes with a distance of 255 are not installed in the routing table administrative distance for local route

1-255

Compass ID: 271820115 Version 3

16-19

BSR 64000 Command Reference Guide

Release 5.0.0

Command Default external distance internal distance local distance = = = 20 200 200

16-20

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

distribute-list in
The distribute-list in command filters networks received in routing updates. The no distribute-list in command changes or cancels the filters received in updates.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage distribute-list in no distribute-list in

Command Syntax
1-199 1300-2699 in access list number extended access list number applies access list to incoming route updates

Command Default
Disabled

Compass ID: 271820115 Version 3

16-21

BSR 64000 Command Reference Guide

Release 5.0.0

distribute-list out
The distribute-list out command prevents networks from being advertised in updates. The no distribute-list out command enables update advertisements. Use the distribute-list out command to apply the access list to outgoing route updates.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage distribute-list out no distribute-list out

Command Syntax
1-199 1300-2699 out pre-defined access list number applies access list to outgoing route updates

Command Default
Disabled

16-22

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

ip as-path access-list
The ip as-path access-list command creates or modifies a BGP related access list and its elements. The no ip as-path access command deletes the corresponding list element. Use the no ip as-path access-list command to modify elements and add to the IP as-path access list of corresponding elements. Use the ip as-path access-list and the neighbor filter-list commands to use as-path filters to filter BGP advertisements.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ip as-path access-list {permit | deny } no ip as-path access

Command Syntax
1-199 permit deny LINE access list number permits access for matching conditions denies access to matching conditions regular expression describing the as-paths to be matched

Compass ID: 271820115 Version 3

16-23

BSR 64000 Command Reference Guide

Release 5.0.0

ip community-list
The ip community-list command creates a BGP related access list and its elements.There are two types of community lists: standard and extended. The standard community lists have a list number from 1 to 99. The extended community lists have a list number from 100 to 199. The no ip community-list deletes the community lists and all associated elements. The community lists are used in the match community-list command and the set communities’ set comm-list delete commands. The route maps are used for inbound and outbound filtering. Note: The community lists are related to the respective elements, and are of the standard and extended types: Standard community lists: To create a standard community list and its elements, use the ip community-list command. To delete the list element use the no ip community-list command. If there is no elements left in the list, the list will be removed too. To delete the community list and all its elements use the no ip community-list command. Extended community lists: To create an extended community list and its elements use the ip community-list command. To delete the list element use the no ip community-list command. If there are no elements left in the list, the list will be removed too.

Group Access
ISP

Command Mode
Global Configuration

16-24

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

Command Line Usage ip community-list {deny | permit } [ | internet | local-AS | no-advertise | no-export ] ip community-list {deny | permit } [...] no ip community-list {deny | permit } [ | internet | local-AS | no-advertise | no-export ] no ip community-list {deny | permit } [...]

Command Syntax
1-99 100-199 deny permit 1-4294967295 standard access list number extended access list number prevents access for matching allows access for matching a community number - you can specify a

single number or multiple numbers separated by a space internet local-AS no-advertise no-export internet community do not advertise this route to peers outside of the local autonomous system do not advertise this route to any peer internal or external routes with this community are sent to peers in other sub-autonomous systems within a confederation an ordered list as a regular expression

LINE

Compass ID: 271820115 Version 3

16-25

BSR 64000 Command Reference Guide

Release 5.0.0

match as-path
The match as-path command matches a BGP autonomous system path access list match entries or appends new list numbers to the existing match entry. The no match as-path command removes the list numbers from the match entry used in the command. Use the match as-path command to match a BGP autonomous system path to advertise on the route-map. Values can be set using the match as-path command. Use the match as-path command to match at least one BGP autonomous system path to ensure advertisement on the route-map. Use the match as-path command to globally replace values matched and set with the match as-path command and the set weight command to supersede weights established with the neighbor weight and the neighbor filter-list commands. The values set by the match and set commands override global values. For example, the weights assigned with the match as-path and set weight route-map commands override the weights assigned using the neighbor weight and neighbor filter-list commands. The implemented weight is established by the initial autonomous system match.

Group Access
ISP

Command Mode
Route-map Configuration

Command Line Usage match as-path []

no match as-path []
Command Syntax
1-199 as-path list number - you can specify a

single number or multiple numbers separated by a space

16-26

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

match community
The match community command creates a BGP autonomous system community access list match entry or appends new list numbers to the existing match entry. The no match community command removes the match entry completely. The no match community command removes the list numbers or the exact-match attribute from the match entry use the command Use the match community-list command to ensure that the route is advertised for outbound and inbound route-maps. If a change to some of the information is to match is needed, configure a second route-map with specifics.

Group Access
ISP

Command Mode
Route-map Configuration

Command Line Usage match community [ ] exact-match] no match community [ ] exact-match]

Command Syntax
1-99 100-199 exact-match standard community list number extended community list number exact match required; all of the communities and only those communities in the community list must be present

Compass ID: 271820115 Version 3

16-27

BSR 64000 Command Reference Guide

Release 5.0.0

maximum-paths
The maximum-paths command specifies the maximum number of parallel routes an IP routing protocol can support. The no maximum-paths command changes or cancels the number of maximum paths.

Group Access
RESTRICTED

Command Mode
Router Configuration

Command Line Usage maximum-paths no maximum-paths

Command Syntax
1-2 the maximum number of parallel routes

16-28

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

neighbor advertisement-interval
The neighbor advertisement-interval command sets the minimum amount of time between sending BGP routing updates. Use the no neighbor advertisement-interval form of this command to delete an entry. Use the neighbor advertisement-interval command to configure all the members of the peer group with the same attributes.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } advertisement-interval no neighbor { | } advertisement-interval

Command Syntax
A.B.C.D WORD 0-600 neighbor IP address neighbor peer-group-name amount of time in seconds

Command Default
30 seconds for external peers 5 seconds for internal peers

Compass ID: 271820115 Version 3

16-29

BSR 64000 Command Reference Guide

Release 5.0.0

neighbor confed-segment
The neighbor confed-segment command allows you configure a neighbor to use either AS confederation sequence or AS confederation set as the path segment type in the AS path attribute. The no neighbor confed-segment command disables the AS confederation path segment type attribute.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor {} confed-segment {sequence | set} no neighbor {} confed-segment {sequence | set}

Command Syntax
A.B.C.D sequence set neighbor IP address convert to AS_CONFED_SEQUENCE (rfc3065: value 3) convert to AS_CONFED_SET (rfc3065: value 4)

Command Default
AS confederation path segment type attribute is disabled.

16-30

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

neighbor default-originate
The neighbor default-originate command allows a BGP speaker to send the default route 0.0.0.0 to a neighbor for the neighbor’s default. The no neighbor default-originate command sends no route as a default. The neighbor default-originate command does not require the presence of 0.0.0.0 in the local router, and when used with a route map, the default route 0.0.0.0 is injected only if the route map contains a match ip address clause and there is a route that matches the IP access list exactly. The route map can contain other match clauses also. The user can use standard or extended access lists with the neighbor default-originate command.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } default-originate [route-map ] no neighbor { | } default-originate [route-map ]

Command Syntax
A.B.C.D WORD WORD neighbor IP address peer group name route map name

Compass ID: 271820115 Version 3

16-31

BSR 64000 Command Reference Guide

Release 5.0.0

neighbor description
The neighbor description command provides a description of a neighbor. The no neighbor description clears the provided neighbor description.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } description [LINE] no neighbor { | } description [LINE]

Command Syntax
A.B.C.D WORD LINE neighbor IP address name of a BGP peer group up to 80 characters in length to describe neighbor

16-32

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

neighbor distribute-list
The neighbor distribute-list command distributes BGP neighbor information based on the access list. The no neighbor distribute-list command deletes an entry. Use the neighbor distribute-list command to filter BGP advertisements. Also, use the ip as-path access-list and the neighbor filter-list commands to use as-path filters to filter BGP advertisements. If a BGP peer group is specified, all members of that group are associated. Specifying the neighbor distribute-list command with an IP address to replace the value already in the peer group.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } distribute-list {in | out} no neighbor { | } distribute-list {in | out}

Command Syntax
A.B.C.D WORD 1-199 1300-2699 in out neighbor IP address name of a BGP peer group number of a standard or extended access list number of an expanded range access list within the group outside the group

Compass ID: 271820115 Version 3

16-33

BSR 64000 Command Reference Guide

Release 5.0.0

neighbor ebgp-multihop
The neighbor ebgp-mulithop command accepts route updates from external peers residing on the network that are not directly connected. The no neighbor ebgp-mulithop command blocks route updates. Use the neighbor ebgp-multihop command to modify BGP peer groups for unified configuration by specifying a peer-group-name.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } ebgp-multihop no neighbor { | } ebgp-multihop

Command Syntax
A.B.C.D WORD 1-255 IP address of external peer, BGP neighbor external BGP group name the maximum hop count - if no value is entered, the default value of 255 is used

16-34

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

neighbor filter-list
The neighbor filter-list command creates a BGP filter. The no neighbor filter-list command disables this function. Use the neighbor filter-list command to create filters on both inbound and outbound BGP routes. Unlimited weight filters are accepted on a per-neighbor principle, but only one inbound or one outbound filter is accepted, not both. Route selection rules determine the weight of a route. Weight assignment is based on the initial autonomous system path, or as-path. Weights announced override weights assigned by global neighbor commands. This happens when the initial match is made. Therefore, weights assigned using match as-path and set weight commands override weights assigned by the neighbor weight and neighbor filter-list commands. Members of a peer group realize configured specifics when the peer-group-name argument is used with the neighbor filter-list command. If the neighbor filter-list command is used with a specified IP address, then the IP address overrides the value from the peer group. Note: Using the command in the form, no neighbor {ip-address | peer-group} filter-list weight [], the optional [] argument has no effect. Using the command in the form, neighbor {ip-address | peer-group} filter-list [] {in | out }, the optional [] argument has no effect.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } filter-list {in | out | weight } no neighbor { | } filter-list {in | out | weight }

Compass ID: 271820115 Version 3

16-35

BSR 64000 Command Reference Guide

Release 5.0.0

Command Syntax
A.B.C.D WORD 1-199 in out weight 0-65535 neighbor IP address BGP peer group filter list number access list to incoming routes access list to outgoing routes BGP weight metric assigned for competing incoming routes; accepted values are 0 to 65535; the largest weight is preferred

Command Default
Disabled

16-36

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

neighbor maximum-prefix
The neighbor maximum-prefix command controls the number of prefixes accepted from a neighbor. The no neighbor maximum-prefix command stops the controlled number of prefixes accepted from a neighbor. Use the neighbor maximum-prefix command to manage the number of prefixes accepted from a neighbor. Note: A prefix is a classless route or a route with a particular starting point and length, with unlimited prefixes. Therefore, 198.7.97.0/27 and 198.7.97.0/ 20 are not the same prefix (route). If the maximum number of acceptable prefixes configured is exceeded, the router ends peering, which is the default.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } maximum-prefix [ | warning-only ] no neighbor { | } maximum-prefix [ | warning-only ]

Command Syntax
A.B.C.D WORD 1-65536 neighbor IP address name of BGP peer-group maximum number of configured prefixes allowed from specific neighbor

Compass ID: 271820115 Version 3

16-37

BSR 64000 Command Reference Guide

Release 5.0.0

1-100

integer specifying what percentage of the maximum number that the router generates a warning message only generate a warning message when the maximum number is exceeded

warning-only

Command Default
Disabled Threshold default, 75%

16-38

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

neighbor next-hop-self
The neighbor next-hop-self command disables BGP processing updates. The no neighbor next-hop-self command enables BGP processing updates. Note: Members of a peer group realize configured specifics when the peer-group-name argument is used with the neighbor next-hop-self command. Specifying the command with an IP address will override the value inherited from the peer group. Use the set ip next-hop command for additional control.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } next-hop-self no neighbor { | } next-hop-self

Command Syntax
A.B.C.D WORD neighbor IP address name of neighbor peer-group

Command Default
Disabled

Compass ID: 271820115 Version 3

16-39

BSR 64000 Command Reference Guide

Release 5.0.0

neighbor password
The neighbor password command enables the Message Digest 5 (MD5) authentication on a TCP connection between two BGP peers. The no neighbor password command disables the Message Digest 5 (MD5) authentication on a TCP connection between two BGP peers. Use the neighbor password command to authenticate and to verify TCP connections between two BGP peers, of which the same password is configured. This command begins the MD5 generation for outgoing packets and check every segment on a TCP connection for incoming packets.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } password {0 | 7 } no neighbor { | } password {0 | 7}

Command Syntax
A.B.C.D WORD 0 7 LINE neighbor IP address name of neighbor peer-group specifies an UNENCRYPTED password will follow specifies an ENCRYPTED password will follow the password (1-32 characters)

Command Default
Disabled

16-40

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

neighbor peer-group (assigning members)
The neighbor peer-group (assigning members) command configures a BGP neighbor to be a member a BGP peer group. The no neighbor peer-group (assigning members) command removes the neighbor from the peer group. The neighbor peer-group creates a new member of a peer-group. If there is no such peer, it will be created and assigned to the group. If there is such peer already, and it does not belong to any other group, it will be assigned to the group and inherit its AS number and all its policies. If an existing peer belongs to another group, it must be removed from that group first with no neighbor peer-group command. The neighbor at the IP address specified completes all of the configuration options of the peer group.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor peer-group no neighbor peer-group

Command Syntax
A.B.C.D WORD address of the BGP neighbor the name of the peer-group

Compass ID: 271820115 Version 3

16-41

BSR 64000 Command Reference Guide

Release 5.0.0

neighbor peer-group (creating)
The neighbor peer-group (creating) command creates a BGP peer group. The no neighbor peer-group (creating) command removes the peer group and all of its members.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor peer-group no neighbor peer-group

Command Syntax
WORD peer group name

16-42

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

neighbor remote-as
The neighbor remote-as command performs many functions as described below. Use the neighbor remote-as command to assign a BGP router to an autonomous system.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor remote-as creates a new BGP peer and assigns an AS number to it. If such peer does not exist already, it assigns a new AS number to existing peer. Such assignment can be done for the existing peer only if it is not a member of any peer-group. no neighbor [remote-as []] deletes the corresponding peer, regardless if it is peer-group member or not. neighbor remote-as assigns a new AS number to existing peer-group. If the peer-group has an AS number already, it will be replaced with the new one. All existing peer-group members will inherit this AS number too. no neighbor remote-as [] removes the peer-group and all its members.

Compass ID: 271820115 Version 3

16-43

BSR 64000 Command Reference Guide

Release 5.0.0

Command Syntax
A.B.C.D WORD 1-65535 BGP peer address name of BGP peer group neighbor autonomous system number

16-44

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

neighbor remove-private-as
The neighbor remove-private-as command triggers the removal of private AS numbers from outbound updates. Use no neighbor remove-private-as command to stops such removal.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } remove-private-as no neighbor { | } remove-private-as

Command Syntax
A.B.C.D WORD address of the BGP neighbor name of neighbor peer-group

Command Default
No removal

Compass ID: 271820115 Version 3

16-45

BSR 64000 Command Reference Guide

Release 5.0.0

neighbor route-map
The neighbor route-map command applies a route map to incoming or outgoing routes. The no neighbor route-map command clears a route map for incoming and outgoing routes.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } route-map {in | out} no neighbor { | } route-map {in | out}

Command Syntax
A.B.C.D WORD WORD in out neighbor IP address name of BGP peer group name of route-map apply to incoming routes apply to outgoing routes

16-46

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

neighbor route-reflector-client
The neighbor route-reflector-client command configures the router as a BGP route-reflector. The no neighbor route-reflector-client command configures a router back to a BGP route-reflector. Use the neighbor route-reflector-client command to establish a local router to act as the route-reflector with the specified neighbor as a client.

Note: When all clients are disabled, the local router is no longer a route-reflector.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } route-reflector-client no neighbor { | } route-reflector-client

Command Syntax
A.B.C.D WORD neighbor IP address name of BGP peer group

Compass ID: 271820115 Version 3

16-47

BSR 64000 Command Reference Guide

Release 5.0.0

neighbor route-refresh
The neighbor route-refresh command allows a BGP neighbor to accept route refresh requests. The no neighbor route-refresh command disables the acceptance of reoute refresh requests for a BGP neighbor.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } route-refresh no neighbor { | } route-refresh

Command Syntax
A.B.C.D WORD BGP neighbor IP address name of BGP peer group

16-48

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

neighbor send-community
The neighbor send-community command will allow a communities attribute, if any, to be sent in outbound updates to a neighbor. The no neighbor send-community command stops sending communities attribute.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } send-community [both | extended | standard] no neighbor { | } send-community [both | extended | standard]

Command Syntax
A.B.C.D WORD both extended standard neighbor IP address name of BGP peer group send standard and extended community attributes send extended community attributes send standard community attributes

Compass ID: 271820115 Version 3

16-49

BSR 64000 Command Reference Guide

Release 5.0.0

neighbor shutdown
The neighbor shutdown command disables a neighbor or peer group. The no neighbor shutdown command enables a neighbor or peer group. Use the neighbor shutdown command to end an session for a particular neighbor or peer group. This removes all routing information associated. Use the show ip bgp summary command for a list of neighbors and peer-group connection. Those neighbors with an Idle status and the Administrative entry have been disabled by the neighbor shutdown command.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } shutdown no neighbor { | } shutdown

Command Syntax
A.B.C.D WORD neighbor IP address name of BGP peer group

16-50

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

neighbor soft-reconfiguration inbound
The neighbor soft-reconfiguration inbound command starts the storage of incoming updates without any modification. The no neighbor soft-reconfiguration inbound command stops this storage and releases the memory used for them. Use the neighbor soft-reconfiguration inbound command to start update story required to enable inbound software configuration with the clear ip bgp soft [in] command. Outbound BGP soft-reconfiguration does not need inbound software configuration. Outbound BGP soft-reconfiguration does not need inbound software configuration. Note: When the neighbor soft-reconfiguration inbound command is issued, the peer will first be disabled and then enabled again. The no form of this command doesn't bring the peer down.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } soft-reconfiguration inbound no neighbor { | } soft-reconfiguration inbound

Command Syntax
A.B.C.D WORD inbound neighbor IP address name of BGP peer group specific inbound update

Command Default
No storage

Compass ID: 271820115 Version 3

16-51

BSR 64000 Command Reference Guide

Release 5.0.0

neighbor timers
The neighbor timers command sets the timers for a particular BGP peer or peer group. The no neighbor timers command clears the timers for a particular BGP peer or peer group. Use the neighbor timers command to configure a specific neighbor or peer-group timers values to bypass the timers configured for all BGP neighbors using the timers bgp command. Note: If, during the negotiated holdtime (which is the smallest of configured hold time and the holdtime advertised by the neighbor), no messages arrive, the peer will be brought down. If the negotiated holdtime is 0, then the peer will never be brought down, because it hasn't received any messages. If the value of the keepalive timer is 0, then no keepalive messages will be sent.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } timers {} [] no neighbor { | } timers

Command Syntax
A.B.C.D WORD 0-21845 0-65535 neighbor IP address name of BGP peer group frequency of keepalive messages to peers in seconds amount of time passed when no keepalive message is sent, in seconds

16-52

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

Command Default keepalive = 60 seconds hold time = 180 seconds

Compass ID: 271820115 Version 3

16-53

BSR 64000 Command Reference Guide

Release 5.0.0

neighbor update-source loopback
The neighbor update-source loopback command allows an internal BGP session to use any loopback interface for the TCP session. The no neighbor update-source loopback command blocks a BGP session from using a loopback interface for the TCP session.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } update-source loopback no neighbor { | } update-source loopback

Command Syntax
A.B.C.D WORD loopback 1-255 neighbor IP address name of BGP peer group loopback interface loopback interface number

Command Default
Best local address

16-54

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

neighbor weight
The neighbor weight command establishes a weight to a neighbor connection. The no neighbor weight command removes a weight to a neighbor connection. Note: Initially, all routes learned from this neighbor will have the assigned weight. The route with the highest weight is chosen as the choice route when multiple routes are available on the network.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage neighbor { | } weight no neighbor { | } weight

Command Syntax
A.B.C.D WORD 0-65535 neighbor IP address name of BGP peer group weight assignment

Command Default learned routes = 0 routes sourced by local router = 32768

Compass ID: 271820115 Version 3

16-55

BSR 64000 Command Reference Guide

Release 5.0.0

network
The network command specifies the list of networks for the BGP routing process. The no network command deletes the entry. Use the network command to control what networks are originated. be included in the BGP updates. Network types are learned from connected routes, dynamic routing, and static route sources. Because BGP can handle subnetting and supernetting, the mask is used. The maximum number of network commands is based on the configured nvram or ram.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage network [mask ] no network [mask ]

Command Syntax
A.B.C.D A.B.C.D network that BGP will advertise network or subnetwork mask address

16-56

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

redistribute
The redistribute command redistributes routes from one protocol domain to another routing domain. The no redistribute command disables route distribution from one protocol domain to another routing domain.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage redistribute {connected | ospf [match {internal | external | external 1 | external 2}] | rip | static} [metric ] [route-map ] [weight ] no redistribute {connected | ospf [match {internal | external | external 1 | external 2}] | rip | static} [metric ] [route-map ] [weight ]

Command Syntax connected ospf match internal external established routes as result of IP enabled on an interface OSPF source protocol the criteria by which OSPF routes are redistributed into BGP routes that are internal to an autonomous system routes external to an autonomous system, but are imported into OSPF as either Type 1 or Type 2 external route routes that are external to an autonomous system, but are imported into OSPF as Type 1 external routes

external 1

Compass ID: 271820115 Version 3

16-57

BSR 64000 Command Reference Guide

Release 5.0.0

external 2

routes that are external to an autonomous system, but are imported into OSPF as Type 2 external routes RIP source protocol IP or BGP static routes metric value used for the redistributed route. the name of the route-map used to conditionally control the route redistribution set a network weight value when redistributing into BGP

rip static metric 0-4294967295 route-map WORD weight 0-65535

Command Default
Disabled

16-58

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

route-map
The route-map command creates or modifies route-maps and their sequences. The no route-map command removes the corresponding sequence from the route-map.If there are no sequences left in the route-map, the route-map will be deleted too. Use the route-map command, and the match and set commands to configure the rules for redistributing routes from one routing protocol to another. Each route-map command has a list of match and set commands associated with it. The match commands specify the match criteria, which are the conditions under which redistribution is allowed for the current route-map command. The set commands specify the set actions, the particular redistribution actions to perform if the criteria enforced by the match commands are met. The no route-map command deletes the route map. Note: If the optional sequence number [] is omitted, the default sequence number 10 is used. If the optional access value [permit | deny] is omitted, the default value permit is used.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage route-map [deny | permit] [] no route-map [deny | permit] []

Command Syntax
WORD 0-65535 deny permit route-map name route-map sequence number denies access for matching conditions permits access for matching conditions

Compass ID: 271820115 Version 3

16-59

BSR 64000 Command Reference Guide

Release 5.0.0

router bgp
The router bgp command configures the BGP routing process. Use the no router bgp command clears BGP routing process configuration. Use the router bgp command to establish a distributed routing core that automatically guarantees the loop-free exchange of routing information between autonomous systems.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage router bgp no router bgp

Command Syntax
1-65535 number of the autonomous system identifying the router to other BGP routers

16-60

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

set as-path prepend
The set as-path prepend command modifies AS system path attributes for the matched BGP routes. The no set as-path prepend command ends modification of a system path for BGP routes. Use the set as-path prepend command to guide the path information to control the BGP decision process.

Group Access
ISP

Command Mode
Route Map Configuration

Command Line Usage set as-path prepend [] no set as-path prepend []

Command Syntax
1-65535 prepend string - you can specify a single

number or multiple numbers separated by a space

Compass ID: 271820115 Version 3

16-61

BSR 64000 Command Reference Guide

Release 5.0.0

set comm-list
The set comm-list command deletes communities from the community attribute of an inbound or outbound update. The no set comm-list command deletes the entry. Use the set comm-list command to delete communities from the community attribute of inbound or outbound updates using a route map to filter and determine the communities to be deleted. If the standard list is referred in the set comm-list delete command, only the elements with the single community number or no community number in them will be used. All others will be quietly ignored. Any element specified with the 'internet' keyword is equivalent to element without community number. If the set community comm and set comm-list list-num delete commands are configured in the same sequence of a route-map attribute, the deletion operation (set comm-list list-num delete) is performed before the set operation (set community comm). Note: If the set community and set comm-list delete commands are configured in the same sequence of a route-map attribute, the deletion operation (set comm-list delete) is performed before the set operation (set community).

Group Access
ISP

Command Mode
Route-map Configuration

Command Line Usage set comm-list { | } delete no set comm-list { | } delete

16-62

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

Command Syntax
1-99 100-199 delete standard community list number extended community list number delete inbound or outbound communities from the community attribute

Compass ID: 271820115 Version 3

16-63

BSR 64000 Command Reference Guide

Release 5.0.0

set community
The set community command adds or replaces communities from the community attribute of an inbound or outbound update. Use the no set community command removes the specified communities from the set. Use the route-map command, and the match and set commands to configure the rules for redistributing routes from one routing protocol to another. Each route-map command has a list of match and set commands associated with it. The match commands specify the match criteria, which are the conditions under which redistribution is allowed for the current route-map command. The set commands specify the set actions, the particular redistribution actions to perform if the criteria enforced by the match commands are met. The no route-map command deletes the route map. Note: The communities could be specified as numbers; the result will be the same; none removes community attribute from the update unless additive is specified for the set entry. In this case it doesn't modify update community attributes. In other words, the no set community command, if the entry had some community numbers in it before removal, and as the result of the removal no numbers are left, then the entry itself is deleted. The command set community none removes all community numbers from set entry, if any, but leaves the value of the additive attribute intact.

Group Access
ISP

Command Mode
Route-map Configuration

Command Line Usage set community { | local-AS | no-advertise | no-export | additive | none} no set community { | local-AS | no-advertise | no-export | additive | none}

16-64

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

Command Syntax
1-4294967295 additive local-AS no-advertise no-export community number add to the existing community do not advertise this route to peers outside of the local autonomous system do not advertise this route to any peer internal or external routes with this community are sent to peers in other sub-autonomous systems within a confederation no community attribute

none

Compass ID: 271820115 Version 3

16-65

BSR 64000 Command Reference Guide

Release 5.0.0

set ip next-hop
The set ip next-hop command establishes a next-hop value for the AS path. The no ip next-hop command deletes the entry. Use the ip policy route-map interface configuration command, the route-map global configuration command, and the match and set route-map configuration commands, to define the conditions for policy routing packets. The ip policy route-map command identifies a route map by name. Each route-map command has a list of match and set commands associated with it. The match commands specify the match criteria---the conditions under which policy routing occurs. The set commands specify the set actions---the particular routing actions to perform if the criteria enforced by the match commands are met. If the interface associated with the first next hop specified with the set ip next-hop command is down, the optionally specified IP addresses are tried in turn.

Group Access
ISP

Command Mode
Route-map Configuration

Command Line Usage set ip next-hop no set ip next-hop

Command Syntax
A.B.C.D IP address of the next hop to which packets are output; address of the adjacent router

Command Default
Disabled

16-66

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

set local-preference
The set-local preference command establishes a preference value for the AS system path. Use the set local-preference command to send the local-preference to all routers in the local autonomous system. Use the no set-local preference form of this command to delete the entry.

Note: In the no set-local preference command, the optional argument has no effect.

Group Access
ISP

Command Mode
Route-map Configuration

Command Line Usage set local-preference no set local-preference

Command Syntax
0-4294967295 local preference value

Compass ID: 271820115 Version 3

16-67

BSR 64000 Command Reference Guide

Release 5.0.0

set metric-type
The set metric-type command sets the destination routing protocol. The no set metric-type command returns the default. Use the set metric-type command, and the match and set commands to configure the rules for redistributing routes from one routing protocol to another. Each set metric-type command has a list of match and set commands associated with it. The match commands specify the match criteria, which are the conditions under which redistribution is allowed for the current set metric-type command. The set commands specify the set actions, the particular redistribution actions to perform if the criteria enforced by the match commands are met. The no set metric-type command deletes the route map.

Group Access
ISP

Command Mode
Route-map configuration

Command Line Usage set metric-type {internal | external | type-1 | type-2} no set metric-type {internal | external | type-1 | type-2}

Command Syntax internal external type-1 type-2 internal metric external metric OSPF external type 1 metric OSPF external type 2 metric

Command Default
Disabled

16-68

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

set origin
The set origin command configures the conditions for redistributing routes from any protocol to any protocol. The no set origin command deletes the BGP origin code. When the set origin command configures redistributing routes from any protocol to any protocol, any match clause is necessary which includes pointing to a “permit everything” to set tags.

Group Access
ISP

Command Mode
Route-Map Configuration

Command Line Usage set origin {egp | igp | incomplete} no set origin {egp | igp | incomplete}

Command Syntax egp igp incomplete remote EGP local IGP unknown heritage

Compass ID: 271820115 Version 3

16-69

BSR 64000 Command Reference Guide

Release 5.0.0

set tag
The set tag command sets the value of the destination routing protocol. The no set tag command removes the value. The route-map global configuration command and the match and set route-map configuration commands are used together to define the conditions for redistributing routes from one routing protocol into another. Each route-map command has a list of match and set commands associated with it. The match commands specify the conditions for redistribution for the current route-map command. The set commands specify the particular redistribution actions to perform if the criteria enforced by the match commands are met. The no route-map command deletes the route map.

Group Access
ISP

Command Mode
Route-map Configuration

Command Line Usage set tag no set tag

Command Syntax
0-4294967295 tag value

Command Default
If not specified, tag is forwarded to the new destination protocol.

16-70

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

set weight
The set-weight command to set the route weight on the network. The first autonomous system match determines the weight to be set. Use the set weight command to set the route weight on the network. The first AS match determines the weight to be set. The route with the highest weight is chosen as the choice route when multiple routes are available on the network. Weights spoken when an as path is matched, override any weight set by the neighbor command. Any match clause is necessary which includes pointing to a “permit everything” to set tags

Group Access
ISP

Command Mode
Route-map Configuration

Command Line Usage set weight no set weight

Command Syntax
0-65535 weight value

Compass ID: 271820115 Version 3

16-71

BSR 64000 Command Reference Guide

Release 5.0.0

show ip as-path-access-list
The show ip as-path-access-list command displays configured AS path access lists and their elements. Use the show ip as-path-access-list command to display configured as-path access lists and their elements. With the optional access list number argument, it displays the specified as-path access list, if such list exists. Without it, it displays all configured as-path access lists.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip as-path-access-list []

Command Syntax
1-199 access list number

16-72

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

show ip bgp
The show ip bgp command displays entries in the BGP routing table. Use the show ip bgp command to determine whether the session is active or not.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip bgp [] [] [longer-prefixes] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp [] [] [longer-prefixes] [ | {count | count-only}]

Command Syntax
A.B.C.D A.B.C.D longer-prefixes | begin exclude include WORD network address in the BGP routing table to display displays all BGP routes matching the network address/network mask pair displays route and more specific routes turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string

Compass ID: 271820115 Version 3

16-73

BSR 64000 Command Reference Guide

Release 5.0.0

count count-only

count the number of outputted lines count the number of lines while suppressing screen output

16-74

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

show ip bgp cidr-only
The show ip bgp cidr-only command displays routes without natural network masks, or Classless Inter-domain Routing (CIDR) routes.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip bgp cidr-only [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp cidr-only [ | {count | count-only}]

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

16-75

BSR 64000 Command Reference Guide

Release 5.0.0

show ip bgp community
The show ip bgp community command display routes that belong to specified BGP communities.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip bgp community [ | | exact-match | expanded | local-AS | no-advertise | no-export ] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp community [ | | exact-match | extended | local-AS | no-advertise | no-export ] [ | {count | count-only}]

Command Syntax
1-4294967295 LINE exact-match expanded local-AS no-advertise no-export the community number an ordered list as a regular expression display routes that have an exact match extended access list format do not advertise this route to peers outside of the local autonomous system do not advertise this route to any peer

internal or external routes with this community are sent to

peers in other sub-autonomous systems within a confederation
| turns on output modifiers (filters)

16-76

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

begin exclude include WORD count count-only

filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

16-77

BSR 64000 Command Reference Guide

Release 5.0.0

show ip bgp community-list
The show ip bgp community-list command display routes that are permitted by the BGP community list.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip bgp community-list { | } [exact-match] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp community-list { | } [exact-match] [ | {count | count-only}]

Command Syntax
1-99 100-199 exact-match | begin exclude include WORD count count-only standard community list number extended community list number display routes that have an exact match turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

16-78

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

show ip bgp dampened-paths
The show ip bgp dampened-paths command displays BGP dampened routes.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip bgp dampened-paths [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp dampened-paths [ | {count | count-only}]

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

16-79

BSR 64000 Command Reference Guide

Release 5.0.0

show ip bgp flap-statistics
The show ip bgp flap-statistics command displays BGP flap statistics.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip bgp flap-statistics [] [] [longer-prefixes ] [filter-list ] [ regexp ] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp flap-statistics [] [] [longer-prefixes ] [filter-list ] [ regexp ] [ | {count | count-only}]

Command Syntax
A.B.C.D A.B.C.D longer-prefixes filter-list 1-199 regexp LINE | begin exclude network address in the BGP routing table to display displays all BGP routes matching the network address/network mask pair displays route and more specific routes number of an autonomous system path access list a regular-expression to match the BGP autonomous system paths turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string

16-80

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

include WORD count count-only

filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

16-81

BSR 64000 Command Reference Guide

Release 5.0.0

show ip bgp ipv4 unicast
The show ip bgp ipv4 unicast command displays IPv4 address family unicast BGP routing information.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip bgp ipv4 unicast [] []] [longer-prefixes]]] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp ipv4 unicast [] []] [longer-prefixes]]] {} [ | {count | count-only}] show ip bgp ipv4 unicast cidr-only [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp ipv4 unicast cidr-only [ | {count | count-only}] show ip bgp ipv4 unicast community [ | | exact-match | expanded | local-AS | no-advertise | no-export ] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp ipv4 unicast community [ | | exact-match | expanded | local-AS | no-advertise | no-export ] {} [ | {count | count-only}] show ip bgp ipv4 unicast community-list { | } [exact-match] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp ipv4 unicast community-list { | } [exact-match] {} [ | {count | count-only}]

16-82

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

show ip bgp ipv4 unicast dampened-paths [ | {begin | exclude | include} show ip bgp ipv4 unicast dampened-paths {} [ | {count | count-only}]] show ip bgp ipv4 unicast dampened-paths [ | {count | count-only}] show ip bgp ipv4 unicast flap-statistics [] [] [longer-prefixes] [filter-list ] [ regexp ] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp ipv4 unicast flap-statistics [] [] [longer-prefixes] [filter-list ] [ regexp ] {} [ | {count | count-only}] show ip bgp ipv4 unicast paths [] [ | {begin | exclude | include} {} [ | {count | count-only}] show ip bgp ipv4 unicast paths [] [ | {count | count-only}] show ip bgp ipv4 unicast regexp {} [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp ipv4 unicast regexp{} [ | {count | count-only}]

Command Syntax
A.B.C.D A.B.C.D longer-prefixes cidr-only network address in the BGP routing table to display displays all BGP routes matching the network address/network mask pair displays route and more specific routes displays routes without natural network masks, or Classless Inter-domain Routing (CIDR) routes displays routes that belong to specified BGP communities the community number

community 1-4294967295

Compass ID: 271820115 Version 3

16-83

BSR 64000 Command Reference Guide

Release 5.0.0

LINE exact-match expanded local-AS no-advertise no-export

an ordered list as a regular expression display routes that have an exact match extended access list format do not advertise this route to peers outside of the local autonomous system do not advertise this route to any peer internal or external routes with this community are sent to peers in other sub-autonomous systems within a confederation displays routes that are permitted by the BGP community list. standard community list number extended community list number displays BGP dampened routes displays BGP flap statistics number of an autonomous system path access list displays routes matching the regular expression regular expression to match BGP autonomous systems paths displays all BGP paths in the database turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string

community-list 1-99 100-199 dampened-paths flap-statistics filter-list 1-199 regexp LINE paths | begin exclude

16-84

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

include WORD count count-only

filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

16-85

BSR 64000 Command Reference Guide

Release 5.0.0

show ip bgp memory
The show ip bgp memory command displays BGP memory usage information. The following is an example of typical screen output from the show ip bgp memory command:

Mem Pool Size Free Used High Water Mark -----------------------------------------------------------------------------Bgp Node 116036 Bgp 32B 32 1024 ( 32768) 0 ( 0) 0 ( 0) Bgp 64B 64 1024 ( 65536) 0 ( 0) 0 ( 0) Bgp 128B 128 4096 ( 524288) 0 ( 0) 0 ( 0) Bgp 256B 256 16 ( 4096) 0 ( 0) 0 ( 0) Bgp 512B 512 15 ( 7680) 1 ( 512) 1 ( 512) Bgp 2048B 2048 512 ( 1048576) 0 ( 0) 0 ( 0) Bgp 8192B 8192 128 ( 1048576) 0 ( 0) 0 ( 0) BgpRte 40 16384 ( 655360) 0 ( 0) 0 ( 0) BgpRt 76 16384 ( 1245184) 0 ( 0) 0 ( 0) BgpExp 36 16384 ( 589824) 0 ( 0) 0 ( 0) BgpCB 2284 256 ( 584704) 0 ( 0) 0 ( 0) -----------------------------------------------------------------------------Total Free 5670K (5806592) + Used 113K (116548) = 5784K (5923140)

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip bgp memory [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp memory [ | {count | count-only}]

16-86

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

16-87

BSR 64000 Command Reference Guide

Release 5.0.0

show ip bgp neighbors
The show ip bgp neighbors command displays information about TCP and BGP connections to neighbors.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip bgp neighbors [ | global [] | ipv4 [] | vpnv4 []] [advertised-routes | dampened-routes | received-routes | routes] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp neighbors [ | global [] | ipv4 [] | vpnv4 []] [advertised-routes | dampened-routes | received-routes | routes] [ | {count | count-only}]

Command Syntax
A.B.C.D global ipv4 vpnv4 advertised-routes dampened-routes received-routes the IP address of a neighbor - if not specified, all neighbors are displayed displays all neighbors for global BGP routing/ forwarding displays all neighbors active in the IPv4 address family displays all neighbors active in the VPNv4 address family displays all routes advertised to a BGP neighbor displays the dampened routes received from BGP neighbor displays all received routes (both accepted and filtered) from a specific neighbor

16-88

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

routes | begin exclude include WORD count count-only

displays all routes that were received and accepted for the specified neighbor turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

16-89

BSR 64000 Command Reference Guide

Release 5.0.0

show ip bgp next-hops
The show ip bgp next-hops command displays BGP next-hop information.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip bgp next-hops [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp next-hops [ | {count | count-only}]

Command Syntax

| begin exclude include WORD count count-only

turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

16-90

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

show ip bgp paths
The show ip bgp paths command displays all BGP paths in the database.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip bgp paths [] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp paths [] [ | {count | count-only}]

Command Syntax
LINE | begin exclude include WORD count count-only regular expression to match BGP autonomous systems paths turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

16-91

BSR 64000 Command Reference Guide

Release 5.0.0

show ip bgp peer-group
The show ip bgp peer-group command displays information about BGP peer groups.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip bgp peer-group [ | global [] | ipv4 [] | vpnv4 []] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp peer-group | global [] | ipv4 [] | vpnv4 []] [ | {count | count-only}]

Command Syntax
WORD global ipv4 vpnv4 | begin exclude include display information about a specific peer-group; number of peers and groups displays all peer-groups for global BGP routing/forwarding displays all peer-groups active in the IPv4 address family displays all neighbors peer-groups in the VPNv4 address family turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string

16-92

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

WORD count count-only

the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

16-93

BSR 64000 Command Reference Guide

Release 5.0.0

show ip bgp regexp
The show ip bgp regexp command displays routes matching the regular expression.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip bgp regexp {} [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp regexp {} [ | {count | count-only}]

Command Syntax
LINE | begin exclude include WORD count count-only regular expression to match the BGP autonomous system paths turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

16-94

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

show ip bgp summary
The show ip bgp summary command displays the status of all BGP connections. The following is an example of typical screen output from the show ip bgp summary command:

BGP router identifier 150.31.108.1, local AS number 3 Message statistics: Open Update Notify Keepalive Route Refresh Total Rcvd 0 0 0 0 0 0 RcvdLast Sent 0 0 0 0 0 0 SentLast

New since last show 2w3d ago: none CONF/RCVD values: U IPv4 unicast, u IPv4 unicast (no capabilities) V VPNv4, M IPv4 multicast, L MPLS Neighbor AS CONF/RCVD MsgRcvd MsgSent TblVer Up/Down State/PfxUsed

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip bgp summary [ global | ipv4 | vpnv4] [ | {begin | exclude | include} {} [ | {count | count-only}]] show ip bgp summary [ global | ipv4 | vpnv4] [ | {count | count-only}]

Compass ID: 271820115 Version 3

16-95

BSR 64000 Command Reference Guide

Release 5.0.0

Command Syntax global ipv4 vpnv4 | begin exclude include WORD count count-only displays all neighbors for global BGP routing/ forwarding displays all neighbors active in the IPv4 address family displays all neighbors active in the VPNv4 address family turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

16-96

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

show ip community-list
The show ip community-list command displays a configured community access list and the associated elements. Use the show ip community access list command to display configured community access lists and their elements. With the optional access list number argument, it displays the specified community access list, if such list exists. Without it, it displays, all configured community access lists.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip community-list { | }

Command Syntax
1-99 100-199 standard community list number extended community list number

Compass ID: 271820115 Version 3

16-97

BSR 64000 Command Reference Guide

Release 5.0.0

synchronization
The synchronization command enables IGP synchronization. The no synchronization command disables IGP synchronization.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage synchronization no synchronization

16-98

Compass ID: 271820115 Version 3

Release 5.0.0

BGP Commands

timers bgp
The timers bgp command adjusts BGP network timers. The no timers bgp command resets the BGP timing defaults values.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage timers bgp [] no timers bgp

Command Syntax
0-21845 0-65535 the frequency, in seconds, at which the software sends keepalive messages to its peer the holdtime interval, in seconds, which, after not receiving a keepalive message, that the software declares a BGP peer dead - the holdtime value is always three times the keepalive value

Command Syntax keepalive = 60 seconds holdtime = 180 seconds

Compass ID: 271820115 Version 3

16-99

BSR 64000 Command Reference Guide

Release 5.0.0

16-100

Compass ID: 271820115 Version 3

17
PIM Commands

Introduction
This chapter describes the Protocol-Independent Multicast (PIM) commands that are supported on the BSR 64000. The BSR supports PIM in sparse mode.

PIM Command Descriptions
This section contains an alphabetized list and descriptions of the PIM commands supported by the BSR.

Compass ID: 271820115 Version 3

17-1

BSR 64000 Command Reference Guide

Release 5.0.0

ip pim border
Use the ip pim border command to configure a PIM domain boundary on the interface of a border router peering with one or more neighbors outside the PIM domain.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip pim border no ip pim border

17-2

Compass ID: 271820115 Version 3

Release 5.0.0

PIM Commands

ip pim bsr-candidate
Use the ip pim bsr-candidate command to configure the BSR to be a candidate bootstrap router.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip pim bsr-candidate no ip pim bsr-candidate

Command Syntax
0-32 specifies the hash mask length from 0 to 32 bits.

Command Default
30 bits

Compass ID: 271820115 Version 3

17-3

BSR 64000 Command Reference Guide

Release 5.0.0

ip pim bsr-candidate ip-address
Use the ip pim bsr-candidate ip-address command to specifiy the IP address of a specific interface on the candidate Bootstrap Router (BSR).

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip pim bsr-candidate ip-address no ip pim bsr-candidate ip-address

Command Syntax
A.B.C.D 0-32 the interface IP address the hash mask length

Command Default
Hash mask length = 30 bits

17-4

Compass ID: 271820115 Version 3

Release 5.0.0

PIM Commands

ip pim dr-priority
The ip pim dr-priority command sets the priority for which a router is elected as the Designated Router (DR). When a DR is an election candidate, the router with the highest priority is elected as the DR. The DR priority is configured on the router’s interface. If a DR priority is assigned on multiple router interfaces, then the interface with the highest IP address is used as the DR. If a router does not advertise its priority in its hello messages, the router is elected as the DR. If multiple routers have the highest priority status, then the router with the highest IP address configured on an interface is elected to be the DR. The no ip pim dr-priority command removes a router from the list of potential Designated Routers.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip pim dr-priority no ip pim dr-priority

Command Syntax
1-255 the DR priority

Command Default
The default DR priority is 1 (highest).

Compass ID: 271820115 Version 3

17-5

BSR 64000 Command Reference Guide

Release 5.0.0

ip pim message-interval
Use the ip pim message-interval command to specify the PIM router join/prune messages interval.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip pim message-interval no ip pim message-interval

Command Syntax
1-65535 join/prune interval in seconds

Command Default
60 seconds

17-6

Compass ID: 271820115 Version 3

Release 5.0.0

PIM Commands

ip pim query-interval
The ip pim query-interval command adjusts how often PIM router query messages are sent to other PIM routers. IP multicast routers send PIM query "Hello" messages to determine which router is the Designated Router (DR) for each LAN segment. The DR sends Internet Group Management Protocol (IGMP) host query messages to all hosts on the directly connected LAN. When PIM operates in sparse mode, the DR sends source registration messages to the Rendezvous Point (RP). The no ip pim query-interval command disables the PIM router query message interval to the default.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip pim query-interval no ip pim query-interval

Command Syntax
0-65535 the PIM router query message interval in seconds

Command Default
30 seconds

Compass ID: 271820115 Version 3

17-7

BSR 64000 Command Reference Guide

Release 5.0.0

ip pim rp-candidate
Use the ip pim rp-candidate command to configure and advertise the router as a single Rendezvous Point (RP) candidate on the PIM domain.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip pim rp-candidate no ip pim rp-candidate

17-8

Compass ID: 271820115 Version 3

Release 5.0.0

PIM Commands

ip pim rp-candidate group-list
Use the ip pim rp-candidate group-list command to configure one or more groups that are associated with this Rendezvous Point (RP) candidates on the PIM domain.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip pim rp-candidate group-list no ip pim rp-candidate group-list

Command Syntax
1-99 the access list reference number for group prefixes

Compass ID: 271820115 Version 3

17-9

BSR 64000 Command Reference Guide

Release 5.0.0

ip pim rp-candidate interval
Use the ip pim rp-candidate interval command to change the candidate Rendezvous Point (RP) advertisement interval.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip pim rp-candidate interval no ip pim rp-candidate interval

Command Syntax
1-200 the candidate Rendezvous Point interval in seconds

Command Default
60 seconds

17-10

Compass ID: 271820115 Version 3

Release 5.0.0

PIM Commands

ip pim rp-candidate ip-address
Use the ip pim rp-candidate ip-address command to advertise the IP address of a specific interface for the candidate Rendezvous Point (RP).

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip pim rp-candidate ip-address no ip pim rp-candidate ip-address

Command Syntax
A.B.C.D the IP address of the candidate RP

Compass ID: 271820115 Version 3

17-11

BSR 64000 Command Reference Guide

Release 5.0.0

ip pim rp-candidate priority
Use the ip pim rp-candidate priority command to specify the candidate Rendezvous Point (RP) priority for the BSR on the PIM domain.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage ip pim rp-candidate priority no ip pim rp-candidate priority

Command Syntax
0-255 the assigned priority of the candidate RP

Command Default
0

17-12

Compass ID: 271820115 Version 3

Release 5.0.0

PIM Commands

ip pim spt-threshold lasthop
The ip pim spt-threshold lasthop command configures when a PIM last-hop router should join the shortest path tree (SPT). This is determined by specifying a network traffic threshold. The no ip pim spt-threshold lasthop command restores the default value or changes the setting.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ip pim spt-threshold lasthop { | infinity} no ip pim spt-threshold lasthop [ | infinity]

Command Syntax
0-4294967294 infinity the traffic rate in kilobits per second never switch to the shortest path tree indicates that the Rendezvous Point (RP) always uses a shared tree

Command Default
1024 kbps

Compass ID: 271820115 Version 3

17-13

BSR 64000 Command Reference Guide

Release 5.0.0

ip pim spt-threshold rp
Use the ip pim spt-threshold rp command to specify the multicast traffic threshold that must be reached by the Rendezvous Point (RP) router before the distribution tree is switched over to the Shortest Path Tree (SPT).

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ip pim spt-threshold rp { | infinity } no ip pim spt-threshold rp

Command Syntax
0-4294967294 the multicast traffic rate in kilobits per second (kbps) infinity indicates that the shared tree distribution control method is always used by the RP

Command Default
0

17-14

Compass ID: 271820115 Version 3

Release 5.0.0

PIM Commands

ip pim ssm
The ip pim ssm command is used to select the SSM range so that IP unicast source address and the multicast group address channel subscriptions from IGMP are ignored for groups outside the selected range. Once a range is specified, only Source Specific Join Messages within this specified range can be generated.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage ip pim ssm [default | range { | }] no ip pim ssm

Command Syntax default selects the default address range 232.0.0.0 through 232.255.255.255 (232/8) for SSM applications and protocols. selects a range that uses a standard or extended access-list number.

range

Command Default
Disabled

Compass ID: 271820115 Version 3

17-15

BSR 64000 Command Reference Guide

Release 5.0.0

network
The PIM version of the network command enables IP networks for the PIM routing process. The no network command disables networks for the PIM routing process.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage network no network

Command Syntax
A.B.C.D A.B.C.D IP address of directly connected network PIM wild card bits

17-16

Compass ID: 271820115 Version 3

Release 5.0.0

PIM Commands

pim accept-rp
The pim accept-rp command configures the router to accept only Join or Prune messages destined for the specified Rendezvous Point (RP) for a specific list of multicast groups. The no pim accept-rp command removes the RP address. The multicast groups must be in the range specified by the access list. If no access list is provided, the default is all class D group addresses. When the group address is not in the group range, the RP will not accept Join or Register messages and will respond immediately to Register messages with Register-Stop messages.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage pim accept-rp [1-99] no pim accept-rp [1-99]

Command Syntax
A.B.C.D 1-99 The IP address of the RP. The access list number that defines which groups the RP is allowed to send Join messages. If not specified, the whole class D groups are subject to the check.

Command Default
Disabled

Compass ID: 271820115 Version 3

17-17

BSR 64000 Command Reference Guide

Release 5.0.0

pim graceful-restart restart-interval
If multicast data traffic is being forwarded in the active SRM, the same multicast data traffic will remain forwarded across an SRM switchover. For multicast data that is being forwarded in the slow path on the SRM, there will be a slight interruption of data as the new active SRM is taking over. This interruption should be less than 3 seconds. For multicast data that is being forwarded in the fast path, there should be no significant interruption of data forwarding as the fast path is not being reset across an SRM switchover. The pim graceful-restart restart-interval command provides a configurable PIM graceful restart interval that will complete the protocol relearn process which validates all the replicated forwarding entries after an SRM switchover. The no pim graceful-restart restart-interval command returns to the default value. Note: The BSR does not support multicast data forwarding across a SRM switchover for traffic learned from other multicast routing protocols except for PIM-SM and PIM-SSM. When the newly active SRM initializes, all multicast forwarding entries that are learned from protocols other than PIM-SM or PIM-SSM will be deleted when graceful restart completes. These traffic flows will be recreated as soon as new traffic arrives.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage pim graceful-restart restart-interval no pim graceful-restart restart-interval

Command Syntax
30-180 the graceful restart period in seconds

Command Default
120 seconds

17-18

Compass ID: 271820115 Version 3

Release 5.0.0

PIM Commands

pim register-checksum
Use the pim register-checksum command to register a packet checksum type.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage pim register-checksum [ new | old ]

Command Syntax new old use only IP and PIM Control Headers use complete IP packet length

Command Default
Complete IP packet length

Compass ID: 271820115 Version 3

17-19

BSR 64000 Command Reference Guide

Release 5.0.0

pim rp-address
The pim rp-address command configures the address of a static PIM Rendezvous Point (RP) for a particular group. The no pim rp-address command removes an RP address for a particular group.

Note: You must configure the IP address of RPs on all routers (including the RP router) if you use static RP.

First-hop routers send register packets to the RP address on behalf of source multicast hosts. Routers also use this address on behalf of multicast hosts that want to become members of a group. These routers send Join and Prune messages towards the RP. The RP must be a PIM router but does not require any special configuration to recognize that it is the RP. RPs are not members of the multicast group but serve as a "meeting place" for multicast sources and group members. You can configure a single RP for more than one group. The access list determines which groups the RP can be used for. If no access list is configured, the RP is used for all groups. A PIM router can use multiple RPs, but only one per group. Statically configured RP will take precedence over RP learned though a dynamic mechanism such as the bootstrap mechanism.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage pim rp-address [1-99] no ip pim rp-address

17-20

Compass ID: 271820115 Version 3

Release 5.0.0

PIM Commands

Command Syntax
A.B.C.D The IP address of the router to be a statically configured PIM RP. This is a unicast IP address in four-part, dotted notation. The number of an access list that defines for which multicast groups the RP should use. This is a standard IP access list. If no number is entered, then the default is the whole class D group range.

1-99

Command Default
No PIM Rendezvous Points are preconfigured.

Compass ID: 271820115 Version 3

17-21

BSR 64000 Command Reference Guide

Release 5.0.0

pim unicast-route-lookup
The pim unicast-route-lookup command retrieves routes from the BSR’s unicast routing table.

Group Access
ISP

Command Mode
Router Configuration

Command Line Usage pim unicast-route-lookup no pim unicast-route-lookup

17-22

Compass ID: 271820115 Version 3

Release 5.0.0

PIM Commands

router pim
Use the router pim command to enter Router Configuration mode from Global Configuration mode and enable PIM routing.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage router pim

Compass ID: 271820115 Version 3

17-23

BSR 64000 Command Reference Guide

Release 5.0.0

show ip pim
The show ip pim command displays various PIM routing information. Use the show ip pim command to determine whether the session is active or not.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip pim bsr-router show ip pim interface [cable | count | ethernet | gigaether | loopback ] show ip pim neighbor [ | cable | detail | ethernet | gigaether | loopback ] show ip pim rp [ | mapping] show ip pim rp-hash show ip pim unresolved-groups

Command Syntax bsr-router interface cable X/Y count ethernet X/Y gigaether X/Y loopback 1-64 neighbor Bootstrap router (v2) information PIM interface information the slot and MAC Domain number of the CMTS module Internet multicast packet count Ethernet interface Gigabit Ethernet interface Loopback interface PIM neighbor information

17-24

Compass ID: 271820115 Version 3

Release 5.0.0

PIM Commands

A.B.C.D detail rp A.B.C.D mapping rp-hash unresolved-groups | begin exclude include WORD count count-only

IP address of a specific neighbor Shows all joins/prunes towards this neighbor PIM Rendezvous Point (RP) information IP group address show group-to-RP mappings RP to be chosen based on group selected information unresolved groups information turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

17-25

18
MPLS Commands

Introduction
Multiprotocol Label Switching (MPLS) provides a mechanism for engineering network traffic patterns that is independent of routing tables. In a standard routed network (without MPLS), as a packet travels from a source to a destination, an independent forwarding decision must be made at each router along the path. As a packet travels through the network, each router analyzes the packet and determines the “next hop router” that the packet must be sent to in order for the packet to arrive at its final destination. With MPLS, a packet only has to be analyzed once it enters the network. As the packet is received at the first router in the network, the router assigns a short “label” to the packet. When the packet is forwarded to the next router, the label is included in the packet. At subsequent routers, there is no further analysis of the packet’s layer 3 address. Instead, the label is used to instruct the router how to forward the packet. An MPLS network consists of Label Edge Routers (LERs) and Label Switch Routers (LSRs).
■

The LER is responsible for classifying each packet based on some user-configurable policy (source, destination, port, QoS class, etc.), and assigning a label to the packet.

Compass ID: 271820115 Version 3

18-1

BSR 64000 Command Reference Guide

Release 5.0.0

■

The LSRs are responsible for forwarding the packet along the correct Label Switched Path (LSP) based upon the label. LSPs are configured from end-to-end across the network. In order for a packet to properly travel across the network, all routers in the path must be aware of the label for each packet and which LSP to send the packet on. LSPs are configured statically at each router along the path or dynamically using the Resource Reservation Protocol (RSVP).

MPLS supports a variety routing protocols by creating end-to-end links across a network that serve as “tunnels” for all packets that need to travel to the same destination.

18-2

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

About RSVP
Resource Reservation Protocol (RSVP) data transfer occurs between a router that serves as the link’s entrance point and another router that serves as the link’s exit point. RSVP is used in conjunction with MPLS to distribute MPLS labels. RSVP is a resource reservation setup protocol that is used by both network hosts and routers. Hosts use RSVP to request a specific quality of service (QoS) from the network for particular application flows. Routers use RSVP to deliver QoS requests to all routers along the data path. RSVP also can maintain and refresh states for a requested QoS application flow. RSVP is not a routing protocol, but rather is designed to inter-operate with current and future unicast and multicast routing protocols. The routing protocols are responsible for choosing the routes to use to forward packets, and RSVP consults local routing tables to obtain routes. RSVP is responsible only for ensuring the QoS of packets traveling along a data path.

MPLS Command Descriptions
This chapter contains an alphabetized list and descriptions of the MPLS commands supported by the BSR.

Compass ID: 271820115 Version 3

18-3

BSR 64000 Command Reference Guide

Release 5.0.0

clear ip rsvp statistics
The clear ip rsvp statistics command clears RSVP statistics for all interfaces or selected interfaces with RSVP enabled.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage clear ip rsvp statistics [ethernet | gigaether | pos ]

Command Syntax rsvp statistics ethernet X/Y gigaether X/Y pos X/Y clear RSVP statistics for all or selected interfaces the Ethernet/Fast Ethernet IEEE 802.3 slot and port number on the BSR the Gigabit Ethernet slot and port number on the BSR the Packet over SONET slot and port number on the BSR

18-4

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

clear mpls traffic
The clear mpls traffic command clears MPLS protocol statistics for the entire system.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage clear mpls traffic

Compass ID: 271820115 Version 3

18-5

BSR 64000 Command Reference Guide

Release 5.0.0

debug mpls forwarding
The debug mpls forwarding command enables debugging for MPLS forwarding. The no debug mpls forwarding disables debugging for MPLS forwarding.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage debug mpls forwarding no debug mpls forwarding

18-6

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

debug mpls rsvp
The debug mpls rsvp command enables various debugging functions for MPLS RSVP protocol messages. The no debug mpls rsvp command disables debugging for MPLS RSVP protocol messages.

Group Access
ISP

Command Mode
All modes except User EXEC

Command Line Usage debug mpls rsvp {all | path | resv | ptear | rtear | error} no debug mpls rsvp {all | path | resv | ptear | rtear | error}

Command Syntax all path debug all MPLS RSVP protocol messages debug MPLS RSVP protocol Path messages each sender transmits Path messages downstream along the routes provided by the unicast and multicast routing protocols debug MPLS RSVP protocol Resv messages each receiver sends reservation request (Resv) messages upstream toward senders and sender applications and follow the reverse route of Path messages debug MPLS RSVP protocol PathTear messages - PathTear messages remove path states and dependent reservation states in any routers along a path and follow the same route as Path messages.

resv

ptear

Compass ID: 271820115 Version 3

18-7

BSR 64000 Command Reference Guide

Release 5.0.0

rtear

debug MPLS RSVP protocol ResvTear messages - ResvTear messages remove reservation states along a path and travel upstream toward senders of the session debug MPLS RSVP protocol PathErr and ResvErr error messages

error

18-8

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

ip rsvp
The ip rsvp command is used to enable the RSVP protocol on an interface. The no ip rsvp command is used to disable the RSVP protocol on an interface. The ip rsvp command can also be used to enable message aggregation and to specify the interval in seconds between the transmission of RSVP bundle messages, hello packets, message acknowledgements, and refresh messages.

Group Access
All

Command Mode
Interface Configuration

Command Line Usage ip rsvp {aggregate | bundle-time | hello-interval | hello-misses | msgack-time | refresh-time | summary-refresh} no ip rsvp {aggregate | bundle-time | hello-interval | hello-misses | msgack-time | refresh-time | summary-refresh}

Command Syntax aggregate enable message aggregation which allows the bundling of multiple RSVP messages in a single RSVP transmission specify the maximum interval in seconds between the generation of bundle messages specify the value in seconds as to how often this MPLS link generates hello packets the number of sequential Hello acknowledgments that a node can miss before the LSP can be removed

bundle-time 1-30 hello-interval 0-65535 hello-misses 4-10

Compass ID: 271820115 Version 3

18-9

BSR 64000 Command Reference Guide

Release 5.0.0

msgack-time 1-65535

specify the maximum interval in seconds between the acknowledgement of bundle messages specify the interval in seconds between the successive generation of refresh messages RSVP summary refresh

refresh-time 1-65535 summary-refresh

Command Default bundle time = 10 seconds hello-misses = 4 msgack-time = 2 seconds refresh-time = 30 seconds

Note: Setting the hello-interval to "0" disables the transmission of hello packets.

18-10

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

mpls create-lsp rsvp
The mpls create-lsp rsvp command creates a dynamic MPLS LSP using RSVP.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage mpls create-lsp rsvp [] no mpls create-lsp rsvp

Command Syntax string A.B.C.D A.B.C.D the LSP name the destination IP address the source IP address

Compass ID: 271820115 Version 3

18-11

BSR 64000 Command Reference Guide

Release 5.0.0

mpls create-lsp rsvp explicit-route identifier
The mpls create-lsp rsvp explicit-route identifier command is used to create one or more named paths on an ingress router. The no mpls create-lsp rsvp explicit-route identifier command removes a named path.

Group Access
All

Command Mode
Global Configuration

Command Line Usage mpls create-lsp rsvp explicit-route identifier [hops []] no mpls create-lsp rsvp explicit-route identifier

Command Syntax identifier string hops 1-20 the name of the LSP the number of hops - if not specified, the default number of hops is 10

18-12

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

mpls create-lsp rsvp next-hop
The mpls create-lsp rsvp next-hop command is used to specify one or more transit router addresses and whether the route from the previous hop router is a direct path.

Group Access
All

Command Mode
Global Configuration

Command Line Usage mpls create-lsp rsvp next-hop { Loose | Strict } [ Last-Hop ]

Command Syntax string A.B.C.D Loose the name of the LSP the IP address of the next hop router specifies that the route taken from the previous router to this router does not need to be a direct path, can include other routers, and can be received on any interface species that the route taken from the previous router to this router is a direct path and does not include any other routers - the IP address of the next hop router should be directly connected and should be one of the interface addresses in the LSP path the keyword that signifies that this is the last hop in the LSP configuration

Strict

Last-Hop

Compass ID: 271820115 Version 3

18-13

BSR 64000 Command Reference Guide

Release 5.0.0

mpls create-lsp static
The mpls create-lsp static command is used to create an MPLS LSP static route that uses push-label, pop-label, or swap-label operations. The no mpls create-lsp static command deletes an existing static LSP.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage mpls create-lsp static {ip-to-mpls-push | mpls-to-mpls-push | pop-label | swap-label [queue ]} no mpls create-lsp static

Command Syntax lsp-path-name ip-to-mpls-push 16-1048575 A.B.C.D mpls-to-mpls-push 16-1048575 16-1048575 A.B.C.D the LSP name perform ip-to-mpls push label operation push label adds a new label to the packet MPLS label to push on the packet IP address of the next hop router perform mpls-to-mpls push label operation push label adds a new label to the packet MPLS label to match the packet MPLS label to push on the packet the IP address of the next hop router

18-14

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

pop-label

create an MPLS LSP static route that uses pop-label operation - pop-label removes the label from the beginning of the packet MPLS label to pop on the packet create an MPLS LSP static route that uses swap-label operation - swap-label replaces the label at the top of the label stack with a new label MPLS label to swap out from the packet MPLS label to swap in to the packet IP address of the next hop router QoS queue identifier

16-1048575 swap-label

16-1048575 16-1048575 A.B.C.D queue 0-3

Compass ID: 271820115 Version 3

18-15

BSR 64000 Command Reference Guide

Release 5.0.0

mpls fp max
The mpls fp max command sets the maximum number of MPLS fastpath forwarding entries. The configurable MPLS entries feature allows a user to increase the number of IP forwarding entries by setting a maximum number for MPLS forwarding entries. By decreasing the number of MPLS entries from 10,000, the number of allowable IP entries is increased. The no mpls fp max command restores the default value.

Group Access
All

Command Mode
Global Configuration

Command Line Usage mpls fp max no mpls fp max

Command Syntax
256-10000 the number of MPLS forwarding entries

Command Default
MPLS Fastpath Entries = 10,000

18-16

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

mpls ip
The mpls ip command enables dynamic label switching and MPLS forwarding of IP (IPv4) packets on the interface. The mpls ip propagate-ttl command enables the traceroute command to show all the hops traversed by the MPLS packet in the network. When the no mpls ip propagate-ttl command is used, the hops will not displa on the output of the traceroute command.

Group Access
All

Command Mode
Global Configuration

Command Line Usage mpls ip [ propagate-ttl ] no mpls ip [ propagate-ttl ]

Command Syntax propagate-ttl propagate IP TTL into the label stack

Command Default time-to-live = 64 hops

Compass ID: 271820115 Version 3

18-17

BSR 64000 Command Reference Guide

Release 5.0.0

mpls label range
The mpls label range command allows you to specify an MPLS minimum and maximum label range for static or dynamic LSPs.

Group Access
All

Command Mode
Global Configuration

Command Line Usage mpls label range {dynamic-lsp | static-lsp}{ } no mpls label range {dynamic-lsp | static-lsp}

Command Syntax dynamic-lsp static-lsp 16-1048575 16-1048575 specify a label range for a dynamic LSP specify a label range for a static LSP the minimum label value the maximum label value

Note: A dynamic-lsp range can not overlap a static-lsp range.

18-18

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

mpls mtu
The mpls mtu command allows you to specify the MPLS maximum transmission unit for an interface.

Group Access
All

Command Mode Interface Configuration Command Line Usage mpls mtu no mpls mtu Command Syntax
64-65536 the maximum transmission size in bytes

Compass ID: 271820115 Version 3

18-19

BSR 64000 Command Reference Guide

Release 5.0.0

mpls rsvp restart-lsp
The mpls rsvp restart-lsp command restarts an MPLS LSP specified by name. If no name is specified, the command restarts all configures LSPs specified in the running-configuration file.

Group Access
All

Command Mode
Privileged EXEC, Global Configuration, and Interface Configuration (Ethernet, Gigabit Ethernet, and POS interfaces only)

Command Line Usage mpls rsvp restart-lsp []

Command Syntax string the LSP name

18-20

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

mpls ttl
The mpls ttl command changes the default time-to-live value used by the mpls ip propagate-ttl command. The no mpls ttl command restores the default value (64 hops) in the mpls ip propagate-ttl command.

Group Access
All

Command Mode
Global Configuration

Command Line Usage mpls ttl no mpls ttl

Command Syntax
1-255 the time-to-live value

Compass ID: 271820115 Version 3

18-21

BSR 64000 Command Reference Guide

Release 5.0.0

show fast-path ranges
The show fast-path ranges command displays the IP Table Entry size and the MPLS Label entry size in the Fast Path. The following is typical screen output from the show fast-path ranges command:

FP Entry Type ------------IP MPLS

Range ----

Group Access
All

Command Mode
All modes except for User EXEC mode

Command Line Usage show fast-path ranges [ | {begin | exclude | include} {} [ | {count | count-only}]]

Command Syntax
| begin exclude include WORD count count-only turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

18-22

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

show ip rsvp explicit-routed-lsps
The show ip rsvp explicit-routed-lsps command displays all LSPs created with the mpls create-lsp rsvp explicit-route identifier command.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip rsvp explicit-routed-lsps

Compass ID: 271820115 Version 3

18-23

BSR 64000 Command Reference Guide

Release 5.0.0

show ip rsvp interface
The show ip rsvp interface command displays the following running system interface information for the RSVP routing process: Interface State Neighbor Count Query Interval interface type, slot, and port number on the BSR 64000 the state of the interface - either "Up" or "Down" the number of routers connected to this interface the specified Hello Interval, in seconds, for this interface

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip rsvp interface [ ethernet | gigaether | pos ]

Command Syntax ethernet X/Y gigaether X/Y pos X/Y the Ethernet/Fast Ethernet IEEE 802.3 slot and port number on the BSR the Gigabit Ethernet slot and port number on the BSR the Packet over SONET slot and port number on the BSR

18-24

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

show ip rsvp lsp
The show ip rsvp lsp command displays LSP information.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip rsvp lsp [ethernet | gigaether | pos ]

Command Syntax ethernet X/Y gigaether X/Y pos X/Y the Ethernet/Fast Ethernet IEEE 802.3 slot and port number on the BSR the Gigabit Ethernet slot and port number on the BSR the Packet over SONET slot and port number on the BSR

Compass ID: 271820115 Version 3

18-25

BSR 64000 Command Reference Guide

Release 5.0.0

show ip rsvp neighbor
The show ip rsvp neighbor command displays the following running system information for current RSVP neighbors: Neighbor Address Interface Reduction Capable Uptime Expires Reduction Type IP address of the RSVP neighbor the interface on which Hello packets are sent to this neighbor refresh reduction creation - enabled or disabled the total time, in seconds, that the neighbor has been up the times, in seconds, that if a Hello packet is not received, this neighbor entry is deleted Summary Ref, Aggregate, or both

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip rsvp neighbor [ethernet | gigaether | pos ]

Command Syntax ethernet X/Y gigaether X/Y pos X/Y the Ethernet/Fast Ethernet IEEE 802.3 slot and port number on the BSR the Gigabit Ethernet slot and port number on the BSR the Packet over SONET slot and port number on the BSR

18-26

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

show ip rsvp reservation
The show ip rsvp reservation command displays the following running system RSVP-related receiver information: Senders Dest Tun-Id NHOP Style LSP Id the IP address of the sender the IP address of the receiver of this LSP the tunnel interface number or address to which packets with this label are going IP address of the next hop the reservation style the LSP ID used for sender identification

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip rsvp reservation [ ethernet | gigaether | pos ]

Command Syntax ethernet X/Y gigaether X/Y pos X/Y the Ethernet/Fast Ethernet IEEE 802.3 slot and port number on the BSR the Gigabit Ethernet slot and port number on the BSR the Packet over SONET slot and port number on the BSR

Compass ID: 271820115 Version 3

18-27

BSR 64000 Command Reference Guide

Release 5.0.0

show ip rsvp sender
The show ip rsvp sender command displays the following running system RSVP-related sender information: Source Addr LSP Dest Addr Phop Tun_Id LSP_Name Intf the IP address of the sender the number of LSPs the IP address to which the LSP is created the IP address of the previous hop the tunnel interface number or address to which packets with this label are going the user-defined name assigned to the LSP the interface on which this LSP is created

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip rsvp sender [ ethernet | gigaether | pos ]

Command Syntax ethernet X/Y gigaether X/Y pos X/Y the Ethernet/Fast Ethernet IEEE 802.3 slot and port number on the BSR the Gigabit Ethernet slot and port number on the BSR the Packet over SONET slot and port number on the BSR

18-28

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

show ip rsvp statistics
The show ip rsvp statistics command displays running system statistical information for the MPLS RSVP routing process.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ip rsvp statistics [ethernet | gigaether | pos ]

Command Syntax ethernet X/Y gigaether X/Y pos X/Y the Ethernet/Fast Ethernet IEEE 802.3 slot and port number on the BSR the Gigabit Ethernet slot and port number on the BSR the Packet over SONET slot and port number on the BSR

Compass ID: 271820115 Version 3

18-29

BSR 64000 Command Reference Guide

Release 5.0.0

show mpls filters
The show mpls filters command displays the MPLS filter table including the flow classification type (mpls-to-mpls-push, etc.) and the number of filters. The following information is provided: Dest Ip Address Src Ip Address Pro SP DP DS In If FT the destination IP address the source address in the packet the protocol the source port - either TCP or UDP the destination port Diff-serv Code Point (differentiated services) the incoming (Ingress) interface the flow classification type: PU = IP to MPLS Label Push PS = IP to MPLS Push Stacked IG = Ignore CAM use LME Lbl1 Lbl2 Out If Exp0 Exp1 Mac Mtu QId label 1 label 2 the outgoing interface the available experimental field class of service the standard experimental class of service the MAC address the change in the outgoing MTU Oueue ID used for POS

18-30

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show mpls filters [ hitCount | summary | vrf {}] [ | {begin | exclude | include} {} [ | {count | count-only}]] show mpls filters [ hitCount | summary | vrf {}] [ | {count | count-only }]

Command Syntax hitCount NUM summary vrf word | begin exclude include WORD count count-only the access list hit count and optional BSR chassis slot number summary of all MPLS Fast Path filters select a VPN Routing/Forwarding instance turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

Compass ID: 271820115 Version 3

18-31

BSR 64000 Command Reference Guide

Release 5.0.0

show mpls forwarding-table
The show mpls forwarding-table command displays the LSP forwarding table including the route label type and network. The following is an example of typical screen output from the show mpls forwarding-table command:

PU = MPLS Label Push, SW = MPLS Label Switch, LS = MPLS Label To SRM VRF IN Label OUT Lbl1 OUT Lbl2 Phys If ------ -------- -------- -------- ------1034 1035 1036 1037 1044 1045 1046 1047 ----------------RT -PO PO PO PO PO PO PO PO

PO = MPLS Label Pop,

Next Hop Ip MAC Address QId --------------- -------------- -------------------

HitCnt ------

0 0 2834493 0 0 0 6514681 0

The following information is provided: Label IN Label OUT Mtu Phys If the label assigned by this router the label assigned by next hop

the maximum transmission unit (MTU) of labeled packet the interface through which packets with this label are sent

18-32

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

RT

the forwarding flow classification type: PU = MPLS Label Push SW = MPLS Label Switch PO = MPLS Label Pop IP = MPLS Label to IP LS = MPLS Label To SRM

Next Hop Ip MAC Address QId

the IP address of the neighbor that assigned the outgoing label the MAC address (not valid for POS) the QoS queue ID

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show mpls forwarding-table [ hitCount | summary | vrf {}] [ | {begin | exclude | include} {} | {count | count-only}] show mpls forwarding-table [ hitCount | summary | vrf {}] [ | {count | count-only}]

Command Syntax

hitCount NUM summary vrf word |

the access list hit count and optional BSR chassis slot number summary of all MPLS Fast Path filters select a VPN Routing/Forwarding instance turns on output modifiers (filters)

Compass ID: 271820115 Version 3

18-33

BSR 64000 Command Reference Guide

Release 5.0.0

begin exclude include WORD count count-only

filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

18-34

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

show mpls label range
The show mpls label range command displays the configured minimum and maximum label range for both static and dynamic LSPs, as follows: Static LSP Min/Max label: X/Y the minimum and maximum label range for static LSPs

Dynamic LSP Min/Max the minimum and maximum label range for label: X/Y dynamic LSPs

The following is an example of typical screen output from the show mpls label range command:

Local label pool: Static LSP Min/Max label: 16/1023, Dynamic LSP Min/Max label: 1024/1048575

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show mpls label range

Compass ID: 271820115 Version 3

18-35

BSR 64000 Command Reference Guide

Release 5.0.0

show mpls lsp
The show mpls lsp command displays all configured LSPs on this BSR, as well as all the number of Ingress, Transit, and Egress routers that are part of an LSP. The show mpls lsp detail command displays the following information: Incoming label Outgoing label Prefix or TunnelId Incoming interface Outgoing interface Next Hop Status proto lspName initiator destination label stack the label assigned by this router the label assigned by next hop the address or tunnel to which packets with this label are going the interface through which packets with this label are received the interface through which packets with this label are sent the IP address of neighbor that assigned the outgoing label the status of the LSP - either up or down the protocol with which the LSP was setup either RSVP or Static the name of the LSP the source address of the LSP the destination address of the LSP all of the outgoing labels and associated label operations (PUSH/SWAP/POP)

18-36

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

The show mpls lsp summary command displays the following information: STATIC : INGRESS : TRANSIT : EGRESS : Total : RSVP : INGRESS : TRANSIT : EGRESS : Total : Total LSPs : summary of static LSPs the number of Ingress routers that are part of this static LSP that are either up or down the number of Transit routers that are part of this static LSP that are either up or down the number of Engress routers that are part of this static LSP that are either up or down the total number of static LSPs with status either up or down summary of dynamic LSPs set up via RSVP the number of Ingress routers that are part of this LSP that are either up or down the number of Transit routers that are part of this LSP that are either up or down the number of Engress routers that are part of this LSP that are either up or down the total number of dynamic LSPs set up via RSVP with status either up or down

the total number of static and dynamic LSPs

Group Access
All

Command Mode
All modes except User EXEC

Compass ID: 271820115 Version 3

18-37

BSR 64000 Command Reference Guide

Release 5.0.0

Command Line Usage show mpls lsp [detail | labels [detail] | lsp-tunnel [detail] | network [detail] | next-hop [detail] | summary ]] [ | {begin | exclude | include} {} [ | {count | count-only}]] show mpls lsp [detail | labels [detail] | lsp-tunnel [detail] | network [detail] | next-hop [detail] | summary ]] [ | {count | count-only}]

Command Syntax detail labels 16-1048575 16-1048575 lsp-tunnel 0-65536 network A.B.C.D A.B.C.D next-hop A.B.C.D summary | begin exclude include WORD count count-only display detailed information match label values low label value high label value match specific LSP tunnel identifier destination IP address and network mask IP address of next hop display a summary of all LSPs turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string the specified string count the number of outputted lines count the number of lines while suppressing screen output

18-38

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

show mpls lsp interface
The show mpls lsp command displays all configured LSPs on this BSR, as well as all the number of Ingress, Transit, and Egress routers that are part of an LSP that are associated with a specific interface.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show mpls lsp interface {ethernet | gigaether | pos } [detail] [ | {begin | exclude | include} {} [ | {count | count-only}]] show mpls lsp interface {ethernet | gigaether | pos } [detail] [ | {count | count-only}]

Command Syntax ethernet X/Y gigaether X/Y pos X/Y detail | begin exclude include the Ethernet/Fast Ethernet IEEE 802.3 slot and port number on the BSR the Gigabit Ethernet slot and port number on the BSR the Packet over SONET slot and port number on the BSR display detailed information turns on output modifiers (filters) filter for output that begins with the specified string filter for output that excludes the specified string filter for output that includes the specified string

Compass ID: 271820115 Version 3

18-39

BSR 64000 Command Reference Guide

Release 5.0.0

WORD count count-only

the specified string count the number of outputted lines count the number of lines while suppressing screen output

18-40

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

show mpls rsvp refresh-time
The show mpls rsvp refresh-time command displays the global refresh time.

Group Access
All

Command Mode All modes except User EXEC Command Line Usage show mpls rsvp refresh-time

Compass ID: 271820115 Version 3

18-41

BSR 64000 Command Reference Guide

Release 5.0.0

show mpls traffic
The show mpls traffic command displays the following MPLS network traffic information: total header errors bad hop count runt unreachable no lsp other error the total number of MPLS packets that have been received counted when a MPLS packet is discarded because of error in the packet header counted when a MPLS packet is discarded because its time-to-live (TTL) field was decremented to zero counted when a MPLS packet length is too small to hold a single label counted when a MPLS packet is discarded because its nextHop is unreachable. counted when there is no LSP established to forward the incoming MPLS packet counted when a MPLS packet is discarded without processing, such as when MPLS forwarding is not enabled on this router or for some other reason the total number of MPLS packets that have been sent the total number of MPLS packets that have been dropped

forwarded drop

18-42

Compass ID: 271820115 Version 3

Release 5.0.0

MPLS Commands

The following is an example of typical screen output from the show mpls traffic command:

MPLS statistics: Rcvd: 1112 total, 0 header errors 0 bad hop count, 0 runt, 0 unreachable 0 no lsp, 3 other error Sent: 1109 forwarded Drop: 3 drop

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show mpls traffic

Compass ID: 271820115 Version 3

18-43

19
Service Class Commands

Introduction
Service levels provide a means of defining service flows with specific QoS parameters (such as maximum, minimum, or reserved traffic rates, priority, and service scheduling types) and binding them to a named service class. The concept of maximum assigned bandwidth, in the context of a service class, provides a means for controlling the amount of bandwidth that a particular service class can use on an interface. This allows a user to configure levels of service to support applications with specific bandwidth and priority requirements such as voice, video, and data and to further permit users to provide differentiated levels of service. Admission control is an authorization mechanism that provides a method of controlling the admission of service flows belonging to specific service classes on individual interfaces. Admission control is determined by the bandwidth percentage (maximum assigned bandwidth) and the amount of over-booking (configured active percent) allowed for a service class on an interface. The creation of service classes involves assigning service flows to a service class and providing all flows belonging to that class with a defined Quality of Service. DOCSIS 1.1 has defined a set of QoS parameters, a means for associating specific QoS parameter values to a service flow, and assigning service flows their QoS parameters by referencing a service class name. A set of pre-defined, default service classes are provided with the BSR 64000 and a user has the capability of modifying these default service class parameters.
Compass ID: 271820115 Version 3 19-1

BSR 64000 Command Reference Guide

Release 5.0.0

Entering Service Class Configuration Mode
Service Class Configuration mode provides access to the service class commands described in this section. To enter Service Class Configuration mode, do the following: 1. From Global Configuration mode, enter cable service-class and press the key: MOT(config)# cable service-class The command line prompt changes to: MOT(config-srvclass)# To return to Global Configuration mode: 2. Enter the end or exit press the key: MOT(config-srvclass)# end -orMOT(config-srvclass)# exit

Service Class Command Descriptions
This section contains an alphabetized list and descriptions of the service class commands supported by the BSR.

19-2

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

activity-timeout
The activity-timeout command specifies the timeout for active QoS parameters which is the maximum duration that resources may remain unused on an active service flow. The no activity-timeout command restores the default value.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage activity-timeout no activity-timeout

Command Syntax
WORD 0-65535 the user-defined service class name created with the name command the activity timeout value in seconds

Command Default
0

Compass ID: 271820115 Version 3

19-3

BSR 64000 Command Reference Guide

Release 5.0.0

admission-timeout
The admission-timeout command specifies the timeout for admitted QoS parameters which is the duration that the CMTS must hold resources for a service flow's admitted QoS parameter set while they are in excess of its active QoS parameter set. The no admission-timeout command a restores the default value.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage admission-timeout no admission-timeout

Command Syntax
WORD 0-65535 the user-defined service class name created with the name command the admission timeout value in seconds

Command Default
200

19-4

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

admitted-bw-threshold
The admitted-bw-threshold command specifies the amount of admitted bandwidth, in percentage, for a service class on an interface. If this bandwidth threshold is exceeded, an event will be generated. The no admitted-bw-threshold command restores the default value.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage admitted-bw-threshold no admitted-bw-threshold

Command Syntax
WORD 0-100 the user-defined service class name created with the name command the percentage of admitted bandwidth

Command Default
0

Compass ID: 271820115 Version 3

19-5

BSR 64000 Command Reference Guide

Release 5.0.0

allow-share
The allow-share command provides the ability to share bandwidth between different service level classes. Enabling bandwidth sharing, allows the bandwidth of a service level class to be used as a bandwidth “pool” that can be shared by multiple service level classes.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage allow-share no allow-share

Command Syntax
WORD 0 1 the name of the service class disables bandwidth sharing enables bandwidth sharing

Command Default
Disabled for every service class.

19-6

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

cable service-class
The cable service-class command enters Service Class Configuration mode from Global Configuration mode. To return to Global Configuration mode, use the end command.

Group Access
All

Command Mode
Global Configuration

Command Line Usage cable service-class

Compass ID: 271820115 Version 3

19-7

BSR 64000 Command Reference Guide

Release 5.0.0

cap
The cap command specifies the configured active percent (CAP) parameter for a service flow. This parameter controls overbooking for a service class. The no cap command restores the default value. The configured active percent of a service class is an estimation of what fraction, expressed as a percentage, of service flows belonging to that service class that will be simultaneously active on an interface.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage cap no cap

Command Syntax
WORD 0-100 the user-defined service class name created with the name command the configured active percentage value

Command Defaults
Upstream Services Classes DefBEUp = 0 DefRRUp = 0 DefUGS = 100 DefUGSAD = 80 DefRTPS = 5 DefNRTPS = 5 DefEMUp = 100 Downstream Service Classses DefBEDown = 0 DefRRDown = 0 DefEMDown = 100 DefMCDown = 100

19-8

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

clear cable srvclass-stats
The clear cable srvclass-stats command clears service class statistics on the BSR. These are the same service class statistics displayed with the show cable srvclass-stats command.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage clear cable srvclass-stats [ [DOWN | UP | ]]

Command Syntax
X/Y NUM DOWN UP WORD the BSR 64000 slot number and MAC Domain the port number on the specified MAC Domain clear downstream service class statistics clear upstream service class statistics the user-defined service class name created with the name command

Compass ID: 271820115 Version 3

19-9

BSR 64000 Command Reference Guide

Release 5.0.0

enforce-cmts-qos
The enforce-cmts-qos command enforces all service level parameters for all cable modems belonging to a service class regardless of the parameters specified in the cable modem’s configuration file. When MAB, CAP, and the maximum or minimum reserve rates are configured for a given service class, these parameters are overriden by a cable modem’s configuration file if the cable modem was configured after the service class was set up. The enforce-cmts-qos command overrides the cable modem’s configuration file QoS settings with the CMTS’s service class configuration. The no enforce-cmts-qos command disables the cable modem’s configuraion file override. Note: The enforce-cmts-qos command will not override service flow TLV settings in cable modem configuration files for dynamically created service flows.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage enforce-cmts-qos no enforce-cmts-qos

Command Syntax
WORD the name of the service class

Command Default
Disabled

19-10

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

grant-interval
The grant-interval command specifies the nominal time between grants. The no grant-interval command restores the default value. Note: Specifying a grant interval is only relevant for service flows using Unsolicited Grant Service (UGS ) or Unsolicited Grant Service with Activity Detection (UGS-AD) scheduling.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage grant-interval no grant-interval

Command Syntax
WORD 0-4294967295 the user-defined service class name created with the name command the grant interval in microseconds

Command Default
UGS = 10000 UGS-AD = 10000

Compass ID: 271820115 Version 3

19-11

BSR 64000 Command Reference Guide

Release 5.0.0

grant-jitter
The grant-jitter command specifies the tolerated grant jitter which is the maximum amount of time that the transmission opportunities may be delayed from the nominal periodic schedule for this service flow. The no grant-jitter command restores the default value. Note: Specifying a tolerated grant jitter is only relevant for service flows using Unsolicited Grant Service (UGS ) or Unsolicited Grant Service with Activity Detection (UGS-AD) scheduling.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage grant-jitter no grant-jitter

Command Syntax
WORD 0-4294967295 the user-defined service class name created with the name command the tolerated grant jitter in microseconds

Command Default
UGS = 2000 UGS-AD = 2000

19-12

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

grant-size
The grant-size command specifies the unsolicited grant size. Grant size includes the entire MAC frame data PDU from the Frame Control byte to end of the MAC frame. The no grant-size command restores the default value. Note: Specifying an unsolicited grant size is only relevant for service flows using Unsolicited Grant Service (UGS ) or Unsolicited Grant Service with Activity Detection (UGS-AD) scheduling.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage grant-size no grant-size

Command Syntax
WORD 0-65535 the user-defined service class name created with the name command the unsolicited grant size in bytes

Command Default
UGS = 152 UGS-AD = 152

Compass ID: 271820115 Version 3

19-13

BSR 64000 Command Reference Guide

Release 5.0.0

grants-per-interval
The grants-per-interval command specifies the number of data grants per grant interval. The no grants-per-interval command restores the default value. Note: Specifying the number of data grants per grant interval is only relevant for service flows using Unsolicited Grant Service (UGS )or Unsolicited Grant Service with Activity Detection (UGS-AD) scheduling: • • for UGS, the value of this parameter indicates the actual number of data grants per Nominal Grant Interval for UGS-AD, the value of this parameter indicates the maximum number of Active Grants per Nominal Grant Interval

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage grants-per-interval no grants-per-interval

Command Syntax
WORD 0-127 the user-defined service class name created with the name command the number of grants

Command Default
1

19-14

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

mab
The mab command specifies the Maximum Assigned Bandwidth (MAB) which is the amount of bandwidth a service class is permitted to use on an interface. It is expressed as a percentage of the total interface bandwidth capacity. The MAB of a service class is applied during admission control to determine whether to admit a new service flow and again by the packet schedulers to provide a class-based weighting to the scheduler. The no mab command restores the default value. Note: For scheduling purposes, each service class gets its bandwidth based on its MAB fraction relative to other classes, not based on the absolute value of the MAB. For example, if there are only two active service classes and both have the same MAB, each service class would get 50% of the bandwidth. The absolute value of the MAB is only used for admission control not scheduling.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage mab no mab

Command Syntax
WORD 1-100 the user-defined service class name created with the name command the percentage of bandwidth a service class is permitted to use on an interface

Compass ID: 271820115 Version 3

19-15

BSR 64000 Command Reference Guide

Release 5.0.0

Command Defaults

Upstream Services Classes DefBEUp = 10 DefRRUp = 10 DefUGS = 25 DefUGSAD = 5 DefRTPS = 5 DefNRTPS = 5 DefEMUp = 1

Downstream Service Classses DefBEDown = 10 DefRRDown = 10 DefEMDown = 1 DefMCDown = 1

19-16

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

max-burst
The max-burst command specifies the maximum traffic burst size for flows belonging to a specific service class. The no max-burst command restores the default value.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage max-burst no max-burst

Command Syntax
WORD 1522-4294967295 the user-defined service class name created with the name command the token bucket size in bytes for this service flow - the minimum value is the larger of 1522 bytes or the value of Maximum Concatenated Burst size

Command Defaults
BE-DOWN = 3044 BE-UP = 3044 RTPS = 3044 NRTPS = 3044

Compass ID: 271820115 Version 3

19-17

BSR 64000 Command Reference Guide

Release 5.0.0

max-concat-burst
The max-concat-burst command specifies the maximum concatenated burst in bytes which a service flow is allowed. The maximum concatenated burst is calculated from the FC byte of the Concatenation MAC Header to the last CRC in the concatenated MAC frame. The no max-concat-burst command restores the default value.

Note: Specifying a maximum concatenated burst is only relevant for upstream service flows.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage max-concat-burst no max-concat-burst

Command Syntax
WORD 0-65535 the user-defined service class name created with the name command the maximum concatenated burst in bytes - a value of "0" means there is no limit

Command Default
All upstream non-UGS service classes = 1522

19-18

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

max-latency
The max-latency command specifies the maximum allowable time for sending a packet from a CMTS network interface to an RF interface starting at the point the packet is received on the network interface. The no max-latency command restores the default value.

Note: Specifying a maximum latency value is only relevant for downstream service flows.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage max-latency no max-latency

Command Syntax
WORD 0-4294967295 the user-defined service class name created with the name command the latency value in microseconds

Command Default
0

Compass ID: 271820115 Version 3

19-19

BSR 64000 Command Reference Guide

Release 5.0.0

max-rate
The max-rate command specifies the maximum data rate the CM must adhere to and the CMTS must enforce. The no max-rate command restores the default value.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage max-rate no max-rate

Command Syntax
WORD 0-4294967295 the user-defined service class name created with the name command the maximum data rate value in bits per second

Command Default
0

19-20

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

min-pkt-size
The min-pkt-size command specifies the minimum packet size in bytes reserved for a service flow. The minimum reserved rate (min-rate) must be set in conjunction with the minimum packet size for this service flow. The no min-pkt-size command restores the default value.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage min-pkt-size no min-pkt-size

Command Syntax
WORD 64-1522 the user-defined service class name created with the name command the minimum packet size in bytes

Command Default
128

Compass ID: 271820115 Version 3

19-21

BSR 64000 Command Reference Guide

Release 5.0.0

min-rate
The min-rate command specifies the minimum reserved traffic rate reserved for this service flow. The minimum packet size (min-pkt-size) must be set in conjunction with the minimum reserved traffic rate for this service flow.The no min-rate command restores the default value.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage min-rate no min-rate

Command Syntax
WORD 0-4294967295 the user-defined service class name created with the name command the minimum reserved traffic rate in bits-per-second

Command Default
0

19-22

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

name
The name command creates a service class record with a user-specified name that is entered on the command line. The no name command deletes this service class record. Commands for specifying configuration parameters will use the service class name as the key word for distinguishing which service class record is being configured.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage name [schedtype [be-down | be-up | non-rtps | rtps | ugs | ugs-ad]] no name

Command Syntax
WORD schedtype the user-defined service class name, 1-15 characters in length specifies which upstream scheduling service is used for upstream transmission requests and packet transmissions best effort service on the downstream port best effort service on the upstream port non-real-time polling real-time polling unsolicited grant service unsolicited grant service with activity detection

be-down be-up non-rtps rtps ugs ugs-ad

Compass ID: 271820115 Version 3

19-23

BSR 64000 Command Reference Guide

Release 5.0.0

over-max-rate
The over-max-rate command allows the maximum sustained rate to be increased for voice calls. This command is only functional for downstream voice flows.

Note: A setting of 100% (the default) will have the effect of disabling rate limting for voice calls.

Group Access
All

Command Mode
Service-Class Configuration

Command Line Usage over-max-rate Command Syntax

the amount of increase, specified as a percent

of the configured max rate

Command Default
100%

19-24

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

poll-interval
The poll-interval command specifies the nominal polling interval between successive unicast request opportunities for this service flow on the upstream channel. The no poll-interval command restores the default value. Note: Specifying a nominal polling interval is only relevant for service flows using Unsolicited Grant Service with Activity Detection (UGS-AD), Real-Time Polling Service (RTPS), or Non-Real-Time Polling Service (NRTPS) scheduling.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage poll-interval no poll-interval

Command Syntax
WORD 0-4294967295 the user-defined service class name created with the name command the nominal polling interval in microseconds

Command Default
UGS-AD = 10000 RTPS = 50000 NRTPS = 50000

Compass ID: 271820115 Version 3

19-25

BSR 64000 Command Reference Guide

Release 5.0.0

poll-jitter
The poll-jitter command specifies the maximum amount of time that the unicast request interval may be delayed from the nominal periodic schedule for this service flow. The no poll-jitter command restores the default value. Note: Specifying a poll jitter value is only relevant for service flows using Unsolicited Grant Service with Activity Detection (UGS-AD) or Real-Time Polling Service (RTPS) scheduling.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage poll-jitter no poll-jitter

Command Syntax
WORD 0-4294967295 the user-defined service class name created with the name command maximum amount of delay in microseconds

Command Default
UGS-AD = 5000 RTPS = 25000

19-26

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

req-trans-policy
The req-trans-policy command specifies:
■

which IUC opportunities the CM uses for upstream transmission requests and packet transmissions for this service flow whether requests for this Service Flow may be piggybacked with data whether data packets transmitted on this service flow can be concatenated, fragmented, or have their payload headers suppressed

■ ■

For UGS, it also specifies how to treat packets that do not fit into the UGS grant. The no req-trans-policy command restores the default value.

Note: Specifying a req-trans-policy value is only relevant for upstream service flows.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage req-trans-policy no req-trans-policy

Command Syntax
WORD 0x0-0x7fff the user-defined service class name created with the name command the Request/Transmission Policy bit mask

Compass ID: 271820115 Version 3

19-27

BSR 64000 Command Reference Guide

Release 5.0.0

Command Default
BE-UP = 0 UGS = 0x7f UGS-AD = 0x7f RTPS = 0x1f NRTPS = 0

19-28

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

restricted admission disabled
The restricted admission disabled command disables the admission of service flows in the admission restricted state. The admission restricted state is when a service flow is admitted when there is insufficient resources to meet its reserved rate and, subsequently, the flow only receives best effort service. The no restricted admission disabled command enables the admission of service flows in the admission restricted state.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage restricted admission disabled no restricted admission disabled

Command Default
Enabled

Compass ID: 271820115 Version 3

19-29

BSR 64000 Command Reference Guide

Release 5.0.0

schedpriority
The schedpriority command assigns a scheduling priority for a service class. The no schedpriority command a restores the default value. Each service class must be assigned a scheduling priority to determine the order in which service flows are serviced for transmitting packets (downstream) and generating data grants (upstream). Schedule priority is separate from the traffic priority parameter which is specified to differentiate priority for service flows with identical QoS parameter sets.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage schedpriority no schedpriority

Command Syntax
WORD 1-32 the user-defined service class name created with the name command the scheduling priority value

Command Default
1

19-30

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

show cable service-class
The show cable service-class command displays a configuration summary for all service classes, including all default service classes, that are active on the BSR.The complete configuration of an individual service class can also be displayed. The following default service classes are supported:

DefBEDown DefRRDown DefBEUp DefRRUp DefUGS DefUGSAD DefRTPS DefNRTPS DefEMUp DefEMDown DefMCDown

downstream service class, no minimum rate downstream service class, non-zero minimum rate upstream best-effort service class, no minimum rate upstream best-effort service class, non-zero minimum rate upstream unsolicited grant service class upstream unsolicited grant service with activity detection service class upstream real-time polling service class upstream non-real-time polling service class upstream emergency call service class downstream emergency call service class downstream mulitcast service class

The following is an example of typical screen output from the show cable service-class command:

Compass ID: 271820115 Version 3

19-31

BSR 64000 Command Reference Guide

Release 5.0.0

Upstream Service Classes Service Class mab cap priority allowShared enforce admitted bw

cmts-qos threshold -------------------------------------------------------------------------------DefBEUp 10 0 1 no no 0 DefRRUp DefUGS DefUGSAD DefRTPS DefNRTPS DefEMUp 10 25 5 5 5 1 0 100 80 5 5 100 1 1 1 1 1 1 no no no no no no no no no no no no 0 0 0 0 0 0

Total assigned bandwidth (mab sum): 61%

Downstream Service Classes Service Class mab cap priority allowShared enforce admitted bw

cmts-qos threshold ------------------------------------------------------------------------------DefBEDown 10 0 1 no no 0 DefRRDown DefEMDown DefMCDown 10 1 1 0 100 100 1 1 1 no no no no no no 0 0 0

Total assigned bandwidth (mab sum): 22%

The admitted bw threshold field specifies the amount of admitted bandwidth, in percentage, for a service class on an interface. If this bandwidth threshold is exceeded, an event will be generated.

19-32

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

The following is an example of typical screen output for an individual service class from the show cable service-class command:

service class name: direction: schedule type: maximum assigned bandwidth: configured active percent: scheduling priority: admitted bw threshold: traffic priority: maximum sustained rate: maximum traffic burst: minimum reserved rate: assumed minimum rate packet size: maximum concatenated burst: active QoS parameter timeout: admitted QoS parameter timeout: tos overwrite AND mask: tos overwrite OR mask: request/transmission policy: allow sharing: enforce cmts qos:

DefBEUp upstream best effort 10 0 1 0 0 0 3044 0 128 1522 0 200 0xff 0x0 0x0 no no

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show cable service-class []

Compass ID: 271820115 Version 3

19-33

BSR 64000 Command Reference Guide

Release 5.0.0

Command Syntax
WORD displays the complete configuration of a user-defined service class created with the name command or one of the default service classes

19-34

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

show cable srvclass-stats
The show cable srvclass-stats command displays service class statistics for a specified service class on a specified interface. The following is an example of typical screen output from the show cable srvclass-stats command:

Qos service class name: De Direction: upstream Interface slot/port/chan: 11/0/0 Total packets: 3187 Total bytes: 953566 Service flow counts: MacSlot/Port BGID Admit Defer Restrict Reject _________ ____ _____ _____ ________ __________ 11/0 NA 5 0 0 0 11/0 1 0 0 0 0 11/1 1 0 0 0 0 9/0 1 0 0 0 0 total 5 0 0 0

Admitted BW ___________ 0 0 0 0 0

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show cable srvclass-stats

Compass ID: 271820115 Version 3

19-35

BSR 64000 Command Reference Guide

Release 5.0.0

Command Syntax
NUM NUM specify a CMTS slot number specify a CMTS downstream or upstream port number or a TX32 module slot number/downstream port number/downstream channel number - refer to the diagram following the Command Syntax table Note: The comma should not be entered as part of the command syntax. the pre-defined service class name or the user-defined service class name created with the name command

WORD

, comma 4/[0-7]/[0-3]

TX32 Module Slot Number/ 2:8 CMTS Module Downstream or Upstream TX32 Downstream Port Number/ TX32 Downstream Channel Number Port Number

19-36

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

tos-overwrite
The tos-overwrite command provides an "AND" and "OR" mask which the CMTS must use to overwrite the "type of service" field on all upstream IP packets on a service flow. If this parameter is omitted, then the TOS field will not be modified by the CMTS. The no tos-overwrite command restores the default value.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage tos-overwrite no tos-overwrite

Command Syntax
WORD 0x0-0xff 0x0-0xff the user-defined service class name created with the name command TOS AND mask TOS OR mask

Command Default

TOS AND mask BE-UP = 0xff UGS = 0xff UGS-AD = 0xff RTPS = 0xff NRTPS = 0xff

TOS OR mask BE-UP = 0 UGS = 0 UGS-AD = 0 RTPS = 0 NRTPS = 0

Compass ID: 271820115 Version 3

19-37

BSR 64000 Command Reference Guide

Release 5.0.0

trafpriority
The trafpriority command specifies the relative priority of service flows that have identical QoS parameters. The no trafpriority command restores the default value.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage trafpriority no trafpriority

Command Syntax
WORD 0-7 the user-defined service class name created with the name command the service flow priority value

Command Default
0

19-38

Compass ID: 271820115 Version 3

Release 5.0.0

Service Class Commands

ugs-stats-window
The ugs-stats-window command sets the UGS Flow Voice Call statistics sample period. The no ugs-stats-window command returns to the default value.

Note: The ugs-stats-window command specifies the sampling time period displayed in the show cable ugs-stats command output.

Group Access
All

Command Mode
Service Class Configuration

Command Line Usage ugs-stats-window [ | ] no ugs-stats-window

Command Syntax
0 5-120 disables UGS Flow Statistics sampling sets the UGS Flow Statistics sampling time interval in minutes

Command Default
60 minutes

Compass ID: 271820115 Version 3

19-39

20
Secure Shell Server Commands

Introduction
Secure Shell server (SSH) is a program that allows remote hosts to login to the BSR over a non-secure network and execute commands in a secure manner. SSH provides strong authentication and secure communications over non-secure networks such as the public Internet. The SSH protocol uses TCP as the transport layer. An SSH server listens for connections from SSH clients on a well-known TCP port. An SSH client is launched from a remote host and connects to the SSH server. The SSH server and SSH client then handle key exchange, encryption, authentication, command execution, and data exchange.

Secure Shell Server Command Descriptions
This chapter contains an alphabetized list and descriptions of the SSH commands supported by the BSR.

Compass ID: 271820115 Version 3

20-1

BSR 64000 Command Reference Guide

Release 5.0.0

password ssh-passphrase
The password ssh-passphrase command establishes a password that must be specified by users attempting to establish an SSH session with the BSR. An SSH session will not be established if the correct password is not specified by the user. The no password ssh-passphrase command removes the password.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage password ssh-passphrase [0 | 7] no password ssh-passphrase

Command Syntax
0 7 WORD specifies an UNENCRYPTED password specifies a HIDDEN password the password (31 character maximum, 78 character maximum for option 7) - enclosed with double quotes if the key contains spaces) the "%" and "!" characters must not be used

20-2

Compass ID: 271820115 Version 3

Release 5.0.0

Secure Shell Server Commands

show ssh config
The show ssh config command displays the following configuration information for an SSH session. SSH2 Secure Shell sshTaskId debugMode the SSH version number the task identifier for this SSH session "0" indicates that SSH debugging is turned off - "1" indicates that SSH debugging is turned on "1" indicates that SSH debugging is turned off - "0" indicates that SSH debugging is turned on the inactivity timeout value (in seconds) for SSH sessions to time out a specified with the ssh timeout command

quiet_mode

idle_timeout

portStr

the defined TCP port number for SSH to listen for incoming connections as specified with the ssh port command the maximum number of allowed, simultaneous SSH sessions specified with the ssh session-limit command the number of authentication attempts that will be allowed for an SSH client attempting a connection as specified with the ssh password-guesses command the message authentication (data integrity) algorithm used for SSH sessions as specified with the ssh message-authentication command the cipher for the encryption of SSH session data as specified with the ssh ciphers command

max_connections

password_guesses

macs

ciphers

Compass ID: 271820115 Version 3

20-3

BSR 64000 Command Reference Guide

Release 5.0.0

subsystemString Private HostKey file Public HostKey file

the type of SSH server the private hostkey authentication filename the public hostkey authentication filename

The following is an example of typical screen output from the show ssh config command:

SSH2 Secure Shell 3.0.4 sshTaskId = 0x0 sshTaskFatalError = 0x0 debugMode = 0 quiet_mode = 1 idle_timeout = 300 portStr = 22 max_connections = 8 password_guesses = 3 macs = any ciphers = any subsystemString = subsystem-sftp sftp-server authenticationString = AllowedAuthentications publickey,password Private HostKey file = NVRAM:hostkey Public HostKey file = NVRAM:hostkey.pub Zlib compression level = 0 accessGroup = 0

Total SSH resources used=0, pty's tied-up=0

Note: To display modifications to the default SSH configuration, use the following command: show running-config | include ssh

20-4

Compass ID: 271820115 Version 3

Release 5.0.0

Secure Shell Server Commands

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ssh config

Compass ID: 271820115 Version 3

20-5

BSR 64000 Command Reference Guide

Release 5.0.0

show ssh hostkey-fingerprint
The show ssh hostkey-fingerprint command displays the fingerprint of a public key.

Note: The SSH server must be disabled to execute this command.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ssh hostkey-fingerprint {nvram: | flash: }

Command Syntax nvram: filename flash: filename display fingerprint of public hostkey file stored in NVRAM display fingerprint of public hostkey file stored in Flash

20-6

Compass ID: 271820115 Version 3

Release 5.0.0

Secure Shell Server Commands

show users ssh
The show users ssh command displays information about active SSH sessions including SSH resource use and active calls.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show users ssh

Compass ID: 271820115 Version 3

20-7

BSR 64000 Command Reference Guide

Release 5.0.0

ssh ciphers
The ssh ciphers command configures a cipher for the encryption of SSH session data.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ssh ciphers [3des-cbc | aes128-cbc | aes192-cbc | aes256-cbc | any | arcfour | blowfish-cbc | cast128-cbc | none | twofish-cbc | twofish192-cbc | twofish256-cbc] no ssh ciphers

Command Syntax
3des-cbc aes128-cbc aes192-cbc aes256-cbc any arcfour blowfish-cbc cast128-cbc none twofish-cbc three-key triple DES in cbc mode, with 168-bit keys Advanced Encryption standard (AES) with 128-bit keys Advanced Encryption standard (AES) with 192-bit keys Advanced Encryption standard (AES) with 256-bit keys attempt all possible Ciphers, none excluded stream cipher with 128-bit keys Blowfish in CBC mode, with 128-bit keys CAST cipher in cbc mode no encryption alias for twofish128-cbc

20-8

Compass ID: 271820115 Version 3

Release 5.0.0

Secure Shell Server Commands

twofish192-cbc twofish256-cbc

Twofish in cbc mode with 192-bit keys Twofish in cbc mode with 256-bit keys

Compass ID: 271820115 Version 3

20-9

BSR 64000 Command Reference Guide

Release 5.0.0

ssh enable
The ssh enable command enables an SSH process. The no ssh enable command disables the SSH process. If SSH is disabled, all existing SSH sessions will be terminated.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ssh enable no ssh enable

20-10

Compass ID: 271820115 Version 3

Release 5.0.0

Secure Shell Server Commands

ssh-keygen2
The ssh-keygen2 tool generates authentication key files for the BSR Secure Shell Server. Host keys are required for the SSH Server and can either be generated in the BSR 64000 or generated on another BSR and copied over.

Note: The SSH Server must be disabled on the BSR 64000 before running the ssh-keygen2 tool.

Caution: The BSR 64000 Secure Shell Server only accepts host key files generated with the ssh-keygen2 tool. Keys files generated using the OpenSSH ssh-keygen tool will not work with the BSR 64000 Secure Shell Server. The ssh-keygen2 tool resolves interoperability problems associated with OpenSSH. A key file must be generated using the ssh-keygen2 tool for the BSR 64000 Secure Shell Server to interoperate properly with OpenSSH Secure Shell clients.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage ssh-keygen2 [bits | hostkeyfile {flash: | nvram: } | passphrase | type {dsa | rsa}]

Command Syntax bits 512-1024 hostkeyfile flash: filename specify the key strength in bits create private hostkey file name stored in Flash

Compass ID: 271820115 Version 3

20-11

BSR 64000 Command Reference Guide

Release 5.0.0

hostkeyfile nvram: filename passphrase WORD

create private hostkey file name stored in NVRAM set a password (31 character maximum,) for SSH connections - the "%" and "!" characters must not be used Digital Signature Algorithm key type Rivest-Shamir-Adleman public-key algorithm key type

type dsa type rsa

Command Default bits = 1024 hostkeyfile = nvram: hostkey type = dsa

20-12

Compass ID: 271820115 Version 3

Release 5.0.0

Secure Shell Server Commands

ssh load-host-key-files
The ssh load-host-key-files command specifies a new private or public hostkey authentication file. The default hostkey authentication file names are “hostkey and hostkey.pub”. These two files must exist and must be valid key files. Use the UNIX ssh-keygen2 tool to generate a new hostkey authentication file.

Note: If the hostkey authentication files are invalid, SSH will not run.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ssh load-host-key-files {flash: | nvram:} {} no ssh load-host-key-files

Command Syntax flash: nvram: specifies Flash memory as the location of the SSH hostkey authentication file specifies Non-volatile Random Access Memory (NVRAM) as the location of the hostkey authentication file filename of the hostkey authentication file stored in Flash or NVRAM

filename

Command Default hostkey = hostkey.pub

Compass ID: 271820115 Version 3

20-13

BSR 64000 Command Reference Guide

Release 5.0.0

ssh logout session-id
The ssh logout session-id command will terminate an SSH session in progress. This command can be used when a user wants to reconnect using new configuration parameters.

Group Access
System Administrator

Command Mode
Privileged EXEC

Command Line Usage ssh logout session-id

Command Syntax
0-7 the session-id number - the session-id is the number displayed with the show users ssh ssh command

20-14

Compass ID: 271820115 Version 3

Release 5.0.0

Secure Shell Server Commands

ssh message-authentication
The ssh message-authentication command specifies the message authentication (data integrity) algorithm used for SSH sessions.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ssh message-authentication [any | hmac-md5 | hmac-md5-96 | hmac-sha1 | hmac-sha1-96 | none] no ssh message-authentication

Command Syntax any hmac-md5 hmac-md5-96 hmac-sha1 hmac-sha1-96 none attempt all possible MAC algorithms except "none" digest length = key length = 20 first 96 bits of HMAC-MD5 (digest length=12, key length=16) digest length = key length = 20 first 96 bits of HMAC-SHA1 (digest length=12, key length=20) no message authentication

Command Default any Compass ID: 271820115 Version 3

20-15

BSR 64000 Command Reference Guide

Release 5.0.0

ssh password-authentication radius
The ssh password-authentication radius command enables RADIUS services to be used for password authentication. The no ssh password-authentication radius command disables this feature.

Group Access
System Administrator

Command Mode
Global Configuration

Command Line Usage ssh password-authentication radius [ local-password ] no ssh password-authentication radius [ local-password ]

Command Syntax local-password authenticate with a locally configured password if there is no response from the RADIUS server

20-16

Compass ID: 271820115 Version 3

Release 5.0.0

Secure Shell Server Commands

ssh password-guesses
The ssh password-guesses command specifies how many authentication attempts (login and password exchange) will be allowed for an SSH client attempting a connection.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ssh password-guesses no ssh password-guesses

Command Syntax
1-5 password guess attempt number

Command Default
3

Compass ID: 271820115 Version 3

20-17

BSR 64000 Command Reference Guide

Release 5.0.0

ssh port
The ssh port command configures SSH to listen for incoming connections on a defined TCP port number.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ssh port no ssh port

Command Syntax
1-65535 port number

Command Default
22

20-18

Compass ID: 271820115 Version 3

Release 5.0.0

Secure Shell Server Commands

ssh session-limit
The ssh session-limit command specifies the maximum number of simultaneous SSH sessions that the BSR accepts.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ssh session-limit no ssh session-limit

Command Syntax
0-8 number of simultaneous SSH sessions

Command Default
8

Compass ID: 271820115 Version 3

20-19

BSR 64000 Command Reference Guide

Release 5.0.0

ssh timeout
The ssh timeout command specifies an inactivity timeout value for SSH sessions to time out. Specifying a value of "0" will disable time-out for SSH sessions.

Group Access
ISP

Command Mode
Global Configuration

Command Line Usage ssh timeout

Command Syntax
0-60 the timeout value in minutes

Command Default
5 minutes

20-20

Compass ID: 271820115 Version 3

21
PacketCable Commands

Overview
The BSR fully supports the Cablelabs® PacketCable™ 1.x and PacketCable Multimedia (PCMM) specifications. PacketCable Multimedia, building on the VoIP capabilities of PacketCable 1.x, provides an IP-based platform for delivering Quality-of-Service (QoS)-enhanced multimedia services over DOCSIS 1.1 and 2.0 HFC networks. Using PacketCable Multimedia, cable operators can offer subscribers, in addition to the VoIP telephony services available through PacketCable 1.x, additional services that include interactive gaming, streaming media, video telephony, and video conferencing.

Command Descriptions
This chapter contains an alphabetized list and descriptions of PacketCable and PacketCable Multimedia commands used with the BSR.

Compass ID: 271820115 Version 3

21-1

BSR 64000 Command Reference Guide

Release 5.0.0

cable dynamic-service authorization-mode
The cable dynamic-service authorization-mode command allows the cable interface to accept dynamic service. The no cable dynamic-service command rejects dynamic service on the cable interface.

Group Access
All

Command Mode
Interface Configuration (cable interface only)

Command Line Usage cable dynamic-service authorization-mode {auth_no_ecn02064 | authorize | disable | unauthorize}

Command Syntax auth_no_ecn02064 authorize authorize Dynamic Service based on DQoS gates without PacketCable ECN 2064 support authorize CM initiated Dynamic Service based on DQoS gates, which only accepts DOCSIS DSX MAC management message types (DSA-REQ, DSC-REQ, DSD-REQ) from the CM that is authorized through DQoS. This argument is required when DQoS is enabled. reject all Dynamic Service accept all Dynamic Service

disable unauthorize

Note: ECN 2064 (dqos-n-02064) places additional requirements on the authorization of dynamic service requests by an MTA. Set this value if the MTAs connected to the cable interface do not support this ECN.

21-2

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

Command Default
Disabled

Compass ID: 271820115 Version 3

21-3

BSR 64000 Command Reference Guide

Release 5.0.0

cable dynamic-service active-timeout
CMs dynamically allocate resources such as service identifiers (SIDs) and bandwidth by using a Dynamic Service Addition (DSA) transaction. If the CM fails to issue a Dynamic Service Deletion Request (DSD-REQ) to the cable interface or the DSD-REQ is being dropped for any reasons (e.g. due to noise), these resources could be held by the cable interface indefinitely. For this reason, an active timeout interval could be configured on the cable interface so that the cable interface can remove the dynamic service flows by issuing the DSD-REQs to the CM when the timer expires. The cable dynamic-service active-timeout command specifies an active timeout for dynamic service flows. The active timeout is the time since the dynamic service was used. As long as the dynamic service continues to receive at least one packet within this interval, the service is not deleted.

Group Access
All

Command Mode
Interface Configuration (cable interface)

Command Line Usage cable dynamic-service active-timeout no cable dynamic-service active-timeout

Command Syntax
0-65535 active timeout value in seconds - "0" disables the active timer

Note: If the CM requests an active timeout for that dynamic service flow in the DSA-REQ, this active timer starts using the timeout value specified in the DSA-REQ.

Command Default
0
21-4 Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

clear configuration
The clear configuration command resets the Dynamic QoS, event message, electronic surveillance, or PacketCable Multimedia configuration parameters to the default settings.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage clear configuration [cops | dqos | em | es | mm]

Command Syntax cops dqos em es mm set all COPS configuration parameters to their default values set all DQoS configuration parameters to their default values set all event message configuration parameters to their default values set the electronic surveillance feature to the default value. set all PacketCable Multimedia configuration parameters to their default values

Compass ID: 271820115 Version 3

21-5

BSR 64000 Command Reference Guide

Release 5.0.0

clear cops pdp-ip all
The clear cops pdp-ip all command removes all Policy Decision Point (PDP) IP addresses.

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage clear cops pdp-ip all

21-6

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

clear counters ipsec
The clear counters ipsec command clears the IPSec statistical counters.

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage clear counters ipsec

Compass ID: 271820115 Version 3

21-7

BSR 64000 Command Reference Guide

Release 5.0.0

clear packet-cable cops
The clear packet-cable statistics command clears specific, inactive, or all COPS connections.

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage clear packet-cable cops { | all | inactive}

Command Syntax
0-99 all inactive shutdown specific COPS connection shutdown all active COPS connections clear inactive COPS connections

21-8

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

clear packet-cable gate
The clear packet-cable gate command releases reserved or committed DQoS and Multimedia gates.

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage clear packet-cable gate {all | cops | dqos | identifier | mm | modem | slot | subscriber }

Command Syntax all cops 0-99 dqos identifier 0x00000000-0xffffffff mm modem mac slot NUM subscriber A.B.C.D releases all gates releases a gate for a specified COPS Client handle releases all DQoS gates Gate Identifier in hexadecimal notation releases all Multimedia gates CM MAC address releases all gates associated with a specified BSR slot number MTA or Client IP address.

Compass ID: 271820115 Version 3

21-9

BSR 64000 Command Reference Guide

Release 5.0.0

clear packet-cable statistics
The clear packet-cable statistics command clears event messages, gate, or electronic surveillance statistical counters.

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage clear packet-cable statistics [em | gate | es identifier {}]

Command Syntax em gate es 0x00000000-0xffffffff event message statistics specify gate statistics ES duplicated packet and byte counts clear a specific ES identifier

21-10

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

cmts-ip
The cmts-ip command specifies the network or loopback interface IP address used for the PacketCable protocols.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage cmts-ip no cmts-ip

Command Syntax
A.B.C.D network or loopback interface IP address

Command Default
Any network or loopback IP address

Compass ID: 271820115 Version 3

21-11

BSR 64000 Command Reference Guide

Release 5.0.0

cops client-timer
If the show packet-cable statistics gate command output for the Client-Open Sent field in the COPS Statistics section is incrementing, the network and the PDP server need to be examined to determine the reason for the COPS Client timeouts. The COPS Client Timer (which is the response timer for sending the COPS Client-Open message) can be specified if COPS connections time out before receiving a Client-Accept message. The cops client-timer command specifies the time permitted for the BSR to receive the Client-Accept message from the PDP before terminating the COPS connection. The no cops client-timer command restores the default setting.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage cops client-timer no cops client-timer

Command Syntax
1-3600000 COPS Client timer value in milliseconds

Command Default
3000 milliseconds

21-12

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

cops pdp-ip
The cops pdp-ip command restricts COPS connections to a specific Policy Decision Point (PDP). A PDP is either the Call Management Server in the PacketCable architecture or the Policy Server in the PacketCable Multimedia architecture where a Client/MTA policy request is either serviced or rejected. The no cops pdp-ip command removes an IP address from the list. Note: If one or more PDP IP addresses are configured, only connections from these PDP IP addresses are accepted. Up to 100 “trusted” PDP IP addresses can be configured.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage cops pdp-ip no cops pdp-ip

Command Syntax
A.B.C.D PDP IP address

Command Default
Any PDP IP address is allowed to make a COPS connection.

Compass ID: 271820115 Version 3

21-13

BSR 64000 Command Reference Guide

Release 5.0.0

cops pep-id
The cops pep-id command specifies the default Policy Enforcement Point (PEP) text string, that is used in COPS messaging, to uniquely identify the BSR within the PacketCable/PacketCable Multimedia domain The no cops pep-id command restores the default value.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage cops pep-id [] no cops pep-id []

Command Syntax
WORD COPS PEP ID string that is between 1 and 32 characters.

Command Default
"Motorola CMTS"

21-14

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

cops status-trap-enable
The cops status-trap-enable command enables or disables the COPS status SNMP trap through the DQoSCopsTrap SNMP MIB object. If the COPS status SNMP trap is enabled, the BSR generates an SNMP trap when one or more of the following conditions are occur:
■ ■ ■ ■ ■

a keep alive timeout the COPS connection is disconnected a failure to establish a TCP connection a COPS connection is established an unauthorized PDP attempt to establish a COPS connection

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage cops status-trap-enable {disable | enable}

Command Syntax disable enable disables COPS status SNMP trap (if previously enabled). enables COPS status SNMP trap. The default is disabled.

Command Default
Disabled

Compass ID: 271820115 Version 3

21-15

BSR 64000 Command Reference Guide

Release 5.0.0

dqos emergency-preempt
The dqos emergency-preempt command is used to select one or all of three emergency pre-emption options for admitting additional normal voice bandwidth for high-priority “911” calls. The no dqos emergency-preempt command returns the command default.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage dqos emergency-preempt [most-recent | oldest | random] no dqos emergency-preempt [most-recent | oldest | random]

Command Syntax most-recent oldest random admits bandwidth from the most recent active normal voice calls admits bandwidth from the oldest active normal voice calls. admits bandwidth from random normal voice calls.

Command Default
Disabled

21-16

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

dqos emergency-trap-enable
The dqos emergency-trap-enable command enables or disables an SNMP trap for Emergency Calls through the rdnPktDQoSEmergencyTrapEnable SNMP MIB object. If the Emergency Call SNMP trap is enabled, the BSR generates an SNMP trap if an Emergency Call is initiated.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage dqos emergency-trap-enable {disable | enable}

Command Syntax disable enable disable Emergency Call SNMP trap (if previously enabled) enable Emergency Call SNMP trap

Command Default
Disabled

Compass ID: 271820115 Version 3

21-17

BSR 64000 Command Reference Guide

Release 5.0.0

dqos res-req-trap-enable
The dqos res-req-trap-enable command enables or disables a Resource Request SNMP trap through the DQoSResReq SNMP MIB object. If the Resource Request SNMP trap is enabled, the BSR generates an SNMP trap if a Resource Request from an MTA is invalid. This would include one or more of the following conditions:
■ ■ ■

an invalid gate ID (DSA-REQ contains an unknown gate ID) a missing gate ID (DSA-REQ is missing gate ID) requested resources are exceeded

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage dqos res-req-trap-enable {disable | enable}

Command Syntax disable enable disable Resource Request SNMP trap (if previously enabled) enable Resource Request SNMP trap

Command Default
Disabled

21-18

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

dqos shutdown
The dqos shutdown command disables Dynamic QoS (DQoS) and COPS operation on the BSR.The no dqos shutdown command enables DQoS and the COPS operation on the BSR.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage dqos shutdown [vrf ] no dqos shutdown [vrf ]

Command Syntax vrf WORD the name of a specific VPN

Command Default
Disabled

Compass ID: 271820115 Version 3

21-19

BSR 64000 Command Reference Guide

Release 5.0.0

dqos t0-timer/t1-timer
If T0 and T1 timeouts are being counted in the show packet-cable statistics gate command output, the network and the PDP server need to be examined. T0 and T1 timers may need to be increased from their default values to avoid T0 and T1 timeouts. The dqos t0-timer and dqos t1-timer commands configure the T0 and T1 timers. The T0 timer specifies the period of time that a gate is allocated without being authorized. The T1 timer specifies the time that can elapse between the authorization and commit. The no dqos t0-timer and no dqos t1-timer commands restore the default values.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage dqos {t0-timer | t1-timer}

Command Syntax t0-timer time, in seconds, that a gate ID can remain allocated without any specified gate parameters time, in seconds, that an authorization for a gate can remain valid number of seconds

t1-timer 1-3600

Command Default t0-timer = 30 t1-timer = 250

21-20

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

em element-number
The em element-number command specifies a unique event message Element ID for the BSR. The no em element-number command restores the default setting.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage em element-number no em element-number

Command Syntax
0-99999 Element ID number

Command Default
0

Compass ID: 271820115 Version 3

21-21

BSR 64000 Command Reference Guide

Release 5.0.0

em event-disable-mask
The em event-disable-mask command specifies a hexidecimal mask to disable event messages. The no em event-disable-mask command restores the default setting. The following table describes the QoS event message bit definitions. These hexidecimal values can also be combined. For example, QoS_Release and QoS_Commit event messages can be disabled by entering the hexidecimal number: 0x00040080.

Event Message
QoS_Reserve QoS_Release Time_Change QoS_Commit

Bit Definition (1 Based)
7 8 17 19

Hexidecimal value
0x00000040 0x00000080 0x00010000 0x00040000

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage em event-disable-mask

Command Syntax
0x00000000-0xffffffff set bits correspond to event message IDs being disabled

Command Default
0x00000000 (which is no mask)

21-22

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

em event-priority
The em event-priority command specifies the priority of event messages generated from the BSR relative to other events. The no em event-priority command restores the default setting.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage em event-priority no em event-priority

Command Syntax
0-255 event message priority value

Command Default
128

Compass ID: 271820115 Version 3

21-23

BSR 64000 Command Reference Guide

Release 5.0.0

em flag-override
The Call Management Server directs the BSR (for PacketCable only) to send event messages to the Record Keeping Server in either batch mode (putting event messages together in a packet) or in realtime mode (sending event messages in packets as they come). The event flag, which tells the BSR to send event messages to the Record Keeping Server can be overridden. The em flag-override command forces the BSR to use realtime mode or batch mode regardless of what the Call Manager Server directs the BSR to do. The no em flag-override command disables event flag override.

Note: PacketCable Multimedia supports realtime mode only.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage em flag-override {batch | realtime} no em flag-override

Command Syntax batch realtime send the event message in batch mode send the event message in realtime mode

Command Default
Disabled

21-24

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

em max-batch-events
Event messages are batched together before being sent to the Record Keeping Server. The em max-batch-events command specifies the amount of event messages that are batched. The no em max-batch-events command restores the default setting. The collected messages are sent when the em max-batch-time parameter expires.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage em max-batch-events no em max-batch-events

Command Syntax
2-32 maximum number of batched event messages

Command Default
6

Compass ID: 271820115 Version 3

21-25

BSR 64000 Command Reference Guide

Release 5.0.0

em max-batch-time
The hold-time for batched event messages can be specified to allow more time so that multiple event messages are combined into one packet to reduce network traffic. The em max-batch-time command specifies the interval that the batched event messages are held before they are sent to the Record Keeping Server. The no em max-batch-time command restores the default setting.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage em max-batch-time no em max-batch-time

Command Syntax
1-60 maximum time in seconds

Command Default
10

21-26

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

em qos-descriptor-disable
The QoS Descriptor attribute can be disabled if an MSO administrator decides it does not need it because it wants to reduce the event message size for network traffic management purposes. The QoS descriptor attribute contains the Service Class profile name and QoS parameters. The em qos-descriptor-disable command disables the QoS Descriptor attribute. The no em qos-descriptor-disable command enables the QoS Descriptor.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage em qos-descriptor-disable no em qos-descriptor-disable

Command Default
Enabled

Compass ID: 271820115 Version 3

21-27

BSR 64000 Command Reference Guide

Release 5.0.0

em retry-count
If an Accounting-Response event message is not received by the BSR from the Record Keeping Server, the BSR sends the event message again. Once all retries are exhausted, the BSR tries an alternate Record Keeping Server (if one is available). The network and the Record Keeping Server should be examined to determine the reason for these timeouts. The event message retry count can be specified depending on the amount of network congestion and the distance between the BSR and the Record Keeping Server. For example, if network congestion causes reported timeouts in the Account Request Failure field in the show packet-cable statistics command output, the event message retry count may need to be changed. The em retry-count command specifies the number of retries that should occur before the BSR tries an alternate Record Keeping Server. The no em retry-count command restores the default setting.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage em retry-count no em retry-count

Command Syntax
0-16 maximum number of retransmissions for each Record Keeping Server

Command Default
3

21-28

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

em retry-interval
The event message retry interval can be configured depending on the amount of network congestion and the distance between the BSR and the Record Keeping Server. For example, if the distance caused a time delay, the event message retry interval can be extended from the default value to allow more time for the BSR to receive an Accounting-Response message. The network and the Record Keeping Server should be examined to determine the reason for these timeouts. In most cases the em retry-count command parameter should be increased before the em retry-interval command parameter is modified. The em retry-interval command specifies the event message retry interval for receiving an Accounting Response. The no em retry-interval command restores the default value.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage em retry-interval no em retry-interval

Command Syntax
1-3600 retry interval in seconds

Command Default
2

Compass ID: 271820115 Version 3

21-29

BSR 64000 Command Reference Guide

Release 5.0.0

em rks-failure-trap-enable
The em rks-failure-trap-enable command enables/disables PacketCable EM RKS Failure traps. PacketCable EM RKS Failure traps are generated if an Accounting-Response event message is not received by the BSR from the Record Keeping Server (RKS) after the BSR sends the RKS an Accounting-Request event message. The RKS stores event messages which are used by applications for billing, settlements, network usage monitoring, and fraud detection purposes. If an Accounting-Response event message from the RKS is not received by the BSR , the BSR re-sends the Accounting-Request event message according to a pre-configured retry count. If the retry count is exceeded without a returned Accounting-Response event message, the BSR tries an alternate (secondary) RKS if one is available. A PacketCable EM RKS Failure trap is generated if the Accounting-Request event mesage retry count has been exceeded for both the Primary RKS and the optional Secondary RKS. The event message retry count is specified on the BSR with the em retry-count command. If PacketCable EM RKS Failure traps are being generated, the event message retry count may need to be increased. Repeated Accounting-Request event message failures may indicate too much network congestion and/or distance between the BSR and the RKS. The number of Accounting-Request event message failures can be viewed through the Account Request Failure field in the show packet-cable statistics em command output.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage em rks-failure-trap-enable { disable | enable } no em rks-failure-trap-enable { disable | enable }

21-30

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

Command Syntax

disable enable

disables the PacketCable EM RKS Failure trap enables the PacketCable EM RKS Failure trap

Command Default
Disabled

Compass ID: 271820115 Version 3

21-31

BSR 64000 Command Reference Guide

Release 5.0.0

em shutdown
The em shutdown command disables event messages generated from the BSR if they are not needed. The no em shutdown command enables event messages.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage em shutdown no em shutdown

Command Default
Enabled

21-32

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

em udp-port
If the default UDP port is already in use, another UDP port can be specified for PacketCable event messages. A different UDP port can also be specified for event messages because of security reasons. The em udp-port command specifies a UDP port number for event messages. The no em udp-port command restores the default setting.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage em udp-port no em udp-port

Command Syntax
1-65535 UDP port number for event messages.

Command Default
1813

Compass ID: 271820115 Version 3

21-33

BSR 64000 Command Reference Guide

Release 5.0.0

es
The no es shutdown command enables electronic surveillance. The es shutdown command disables electronic surveillance. The es ccc-source-port command specifies the UDP source port number for Electronic Surveillance Call Content Connections. Changes made to the ccc-source-port configuration are displayed with the show packet-cable configuration es and show running-config commands. The no es ccc-source-port command removes a non-default ccc-source-port configuration and re-establishes the default ccc-source-port configuration of 60000. The es trap-enable enable command enables the electronic surveillance SNMP trap. The no es trap-enable disable command disables the electronic surveillance SNMP trap.

Note: Electronic surveillance conforms to Communications Assistance for Law Enforcement Act (CALEA) requirements.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage es {ccc-source-port | shutdown | trap-enable {disable | enable}} no es {ccc-source-port | shutdown | trap-enable {disable | enable}}

21-34

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

Command Syntax ccc-source-port 0-65535 shutdown trap-enable {disable | enable} the UDP source port number for Electronic Surveillance Call Content Connections Shutdown electronic surveillance functionality Enable/disable the electronic surveillance SNMP trap

Command Default
Electronic Surveillance = disabled

Compass ID: 271820115 Version 3

21-35

BSR 64000 Command Reference Guide

Release 5.0.0

ike client-addr
The ike client-addr command specifies the IP address used by the BSR for its source address during IKE protocol exchanges.

Group Access
All

Command Mode
IPSec Configuration

Command Line Usage ike client-addr

Command Syntax
A.B.C.D host IP address used for IKE

21-36

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

ike phase1
The IKE Phase 1 Lifetime Interval and IKE Phase 1 Lifesize can be specified to enhance security. These settings determine how long the key is exposed. For example, an MSO administrator can decide to update this key on a regular basis to prevent successful hacking. The ike phase1 command specifies the IKE phase 1 lifetime value and the lifesize value that can either trigger or prevent the expiration of the IKE security association:

Group Access
All

Command Mode
IPSec Configuration

Command Line Usage ike phase1 [lifetime | lifesize ]

Command Syntax
0, 300-2592000 0, 10240-4190000 lifetime interval value in seconds - "0" indicates an unlimited lifetime lifesize value in kilobytes - "0" indicates an unlimited lifesize

Command Default
Lifetime is 28800. Lifesize is 0, which indicates an unlimited size in kilobytes.

Compass ID: 271820115 Version 3

21-37

BSR 64000 Command Reference Guide

Release 5.0.0

ike phase2
The IKE Phase 2 Lifetime Interval and IKE Phase 2 Lifesize can be specified to enhance security. These settings determine how long the key is exposed. For example, an MSO administrator can decide to update this key on a regular basis to prevent successful hacking. The ike phase2 command specifies the IKE phase 2 lifetime value and lifesize value for the lifetime:

Group Access
All

Command Mode
IPSec Configuration

Command Line Usage ike phase2 [lifetime | lifesize ]

Command Syntax
300-2592000 0, 10240-4190000 lifetime interval value in seconds lifesize value in kilobytes - "0" indicates an unlimited lifesize

Command Default
Lifetime is 28800 Lifesize is 0, which indicates an unlimited size in kilobytes.

21-38

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

ike retries
The number of IKE retries can be specified for network problems. Observe the number of IKE retries in the show ipsec ike command output. If the number of IKE retries is increasing, then the network and server should be examined to determine the reason for the excessive number of IKE retries. The ike retries command specifies the number of IKE retries.

Group Access
All

Command Mode
IPSec Configuration

Command Line Usage ike retries

Command Syntax
1-10 number of retransmissions

Command Default
3

Compass ID: 271820115 Version 3

21-39

BSR 64000 Command Reference Guide

Release 5.0.0

ike timeout
The IKE retransmission timeout interval can be specified for network problems. Observe the number of IKE timeouts in the show ipsec ike command output. If the number of IKE timeouts is increasing, then the network and server should be examined to determine the reason for the excessive number of IKE timeouts. The ike timeout command specifies the IKE retransmission timeout interval.

Group Access
All

Command Mode
IPSec Configuration

Command Line Usage ike timeout

Command Syntax
1-20 timeout value in seconds

Command Default
10

21-40

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

ipsec
The ipsec command accesses IPSec Configuration mode from Global Configuration mode.

Group Access
All

Command Mode
Global Configuration

Command Line Usage ipsec Compass ID: 271820115 Version 3

21-41

BSR 64000 Command Reference Guide

Release 5.0.0

ipsec shutdown
The ipsec shutdown command disables IPSecIKE for the BSR.The no ipsec shutdown command enables IPSec/IKE for the BSR. Note: For the initial configuration of IPSec/IKE, the IPSec configurable parameters should be configured, before IPSec is enabled. At a minimum, the ike client-addr command should be configured prior to enabling IPSec.

Group Access
All

Command Mode
IPSec Configuration

Command Line Usage ipsec shutdown no ipsec shutdown

Command Default
Disabled

21-42

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

mm shutdown
The mm shutdown command disables PacketCable Multimedia and COPS operation on the BSR. The no mm shutdown command enables PacketCable Multimedia and COPS operation on the BSR.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage mm shutdown no mm shutdown

Command Default
Disabled (shut down)

Compass ID: 271820115 Version 3

21-43

BSR 64000 Command Reference Guide

Release 5.0.0

mm t1-timer
The mm t1-timer command specifies the Multimedia Gate Timer T1 interval that elapses between authorizing and reserving a PacketCable Multimedia gate. The multimedia T1 timer starts when a gate is authorized. The Multimedia T1 timer is stopped when an operation is performed (e.g. The gate state is switched). On expiration of this timer, the BSR deletes the gate. The no mm t1-timer command restores the default setting.

Group Access
All

Command Mode
PacketCable Configuration

Command Line Usage mm t1-timer no mm t1-timer

Command Syntax
1-3600 T1 timer in seconds

Command Default
200 seconds

21-44

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

packet-cable
The packet-cable command is used to access PacketCable Configuration mode from Global Configuration mode.

Group Access
All

Command Mode
Global Configuration

Command Line Usage packet-cable Compass ID: 271820115 Version 3

21-45

BSR 64000 Command Reference Guide

Release 5.0.0

show cable dynamic-service
The show cable dynamic-service command displays the dynamic service configuration status for the cable interfaces. The following provides typical screen output from the show cable dynamic-service command:

Cable dynamic-service auth-mode: authorize Cable dynamic-service active-timeout: 0 Cable dynamic-service loadbalance: disable

Group Access
All

Command Mode
Interface Configuration

Command Line Usage show cable dynamic-service

21-46

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

show ipsec
The show ipsec command displays the configuration of IKE, IPSec, Security Association Database (SADB), Security Policy Database (SPD), SPD preshared-keys, or SPD Policies. The following is an example of typical screen output from the show ipsec sadb policy command:

SADB: Initialized = false Outbound DB Outbound Tunnel DB Inbound ESP DB Inbound AH DB Inbound Other Protocol DB

The following is an example of typical screen output from the show ipsec spd policy command:

Index Source Address Processing Indicator 1 150.31.40.10 Apply 2 150.31.50.10 Apply 3 0.0.0.0:0.0.0.0 ByPass 4 0.0.0.0-255.255.255.255 ByPass 5 0.0.0.0-255.255.255.255 Discard

Destination Address IPsec Mode 150.31.50.10 Transport Mode 150.31.40.10 Transport Mode 0.0.0.0:0.0.0.0 0.0.0.0-255.255.255.255 0.0.0.0-255.255.255.255

SPort Proto 0 0 0 0 0 0 500 17 0 0

DPort Handle 0 3 0 4 0 5 500 1 0 2

The following is an example of typical screen output from the show ipsec ike command:

Compass ID: 271820115 Version 3

21-47

BSR 64000 Command Reference Guide

Release 5.0.0

IKE: Initialized = false Timeout in seconds = 0 Number of retries = 0 IKE Client IP Address = 150.31.50.10 IKE Phase1 Lifetime in Seconds = 28800 IKE Phase1 Lifesize in Kilobytes = 0 IKE Phase2 Lifetime in Seconds = 28800 IKE Phase2 Lifesize in Kilobytes = 0

The following is an example of typical screen output from the show ipsec ipsec command:
IPsec: Initialized = false IPsec Retain DF bit = disabled IPsec IPsec IPsec IPsec Bypass : Outbound Ah : Outbound ESP : Output(total): 0 0 0 0 Ipsec IPsec IPsec IPsec Discard : Inbound Ah : Inbound ESP : Input(total): 0 0 0 0

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show ipsec {ike | ipsec | sadb | spd [policy | preshared-key]}

21-48

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

Command Syntax ike ipsec sadb spd policy preshared-key display IKE-specific configuration display IPSec-specific configuration display the Security Association Database (SADB) configuration display SPD-specific configuration display SPD policy configuration display SPD preshared-key and IP address configuration

Compass ID: 271820115 Version 3

21-49

BSR 64000 Command Reference Guide

Release 5.0.0

show packet-cable configuration
The show packet-cable configuration command displays COPS, DQoS, event messaging, electronic surveillance, and PacketCable Multimedia configuration information. The following provides typical screen output and output field descriptions for the show packet-cable configuration command:

PacketCable Configuration ------------------------CMTS IP address: 150.31.50.10 COPS Configuration -----------------PEP ID: Motorola CMTS Client Timer: 4000 milliseconds Status trap: disabled Dynamic QoS Configuration ------------------------DQoS is enabled T0 Timer: 30 seconds T1 Timer: 60 seconds Resource Request trap: disabled Emergency trap: disabled Multimedia Configuration -----------------------MM is enabled T1 Timer: 300 seconds

PacketCable Configuration COPS Configuration

display the cable (CMTS) interface IP address. display the PEP ID, Client Timer, and if the Status SNMP trap is enabled or disabled.

21-50

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

PDP IP Address

display the Policy Decision Point (PDP) for one or more Call Management Servers (PacketCable architecture) or Policy Server(s) (PSs) (PacketCable Multimedia architecture)

Dynamic QoS Configuration displays if DQoS is enabled or disabled, T0 and T1 timer parameters, and whether the COPS status and Resource Request SNMP traps are enabled or disabled. Multimedia Configuration displays if PacketCable Multimedia is enabled or disabled and the configured T1 Timer interval. displays if event messages are enabled or disabled and other event message configuration parameters displays if ES is enabled or disabled and if the ES status SNMP trap is enabled or disabled.

Event Message Configuration Electronic Surveillance Configuration

The following is an example of typical screen output from the show packet-cable configuration cops command:

COPS Configuration -----------------PEP ID: Motorola CMTS Client Timer: 4000 milliseconds Status trap: disabled

Compass ID: 271820115 Version 3

21-51

BSR 64000 Command Reference Guide

Release 5.0.0

The following is an example of typical screen output from the show packet-cable configuration dqos command:

Dynamic QoS Configuration ------------------------DQoS is enabled T0 Timer: 30 seconds T1 Timer: 60 seconds Resource Request trap: disabled Emergency trap: disabled

The following is an example of typical screen output from the show packet-cable configuration em command:

Event Message Configuration --------------------------EM is enabled UDP Port Number: 1813 Element Number: 0 Event Priority: 128 Retry Interval: 2 seconds Retry Count: 3 Maximum Batch Events: 6 Maximum Batch Time: 10 seconds Event Disable Mask: 0x00000000 Flag Override: None QoS Descriptor: enabled

The following is an example of typical screen output from the show packet-cable configuration es command:

21-52

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

MOT:7A#show packet-cable configuration es Electronic Surveillance Configuration ------------------------------------ES is disabled ES trap: disabled

The following is an example of typical screen output from the show packet-cable configuration mm command:

Multimedia Configuration -----------------------MM is enabled T1 Timer: 300 seconds

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show packet-cable configuration [cops | dqos | em | es | mm]

Command Syntax cops dqos em display the COPS configuration and status information display DQoS configuration and status information display event message configuration and status information

Compass ID: 271820115 Version 3

21-53

BSR 64000 Command Reference Guide

Release 5.0.0

es mm

display electronic surveillance configuration and status information display PacketCable Multimedia T1 timer interval and PacketCable Multimedia status information.

21-54

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

show packet-cable cops
The show packet-cable cops command display all COPS connections, which includes the COPS Client handle, PDP IP address, port number, keep-alive timeout, and duration time. The following provides typical screen output from the show packet-cable cops command and output field descriptions:

COPS Connection Information ---------------------------------------------------------------------------| Handle | Type | IP Address | Port | Keep-Alive Timeout | Connected Time | ---------------------------------------------------------------------------0 DQoS 172.50.1.100 52287 60 01:05:02 1 MM 150.31.1.143 46351 30 01:05:02 4 MM 150.31.1.140 59970 60 00:49:25

Handle CMS IP Address Port Number Keep-Alive Timeout

COPS handle ID PDP IP address Socket connection port number. Keep-Alive timeout interval between when a Keep-Alive packet is sent and received for a COPS connection. time (days and hours) the COPS connection has been active. If a COPS handle has been disconnected it display "disconnected".

Duration Time

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show packet-cable cops [inactive]

Compass ID: 271820115 Version 3

21-55

BSR 64000 Command Reference Guide

Release 5.0.0

Command Syntax inactive specify the COPS Client(s) that are inactive

21-56

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

show packet-cable gate
The show packet-cable gate command displays currently allocated packet cable DQoS and Multimedia gates. The following table provides the show packet-cable gate command output field descriptions:
GateID (0x) Modem MAC Address Subscriber IP Address CMTS SFID display the gate Identifier in hexadecimal notation cable modem (CM) MAC address the client IP address cable slot number display the upstream (Up) SFID number, and the downstream (Dn) Service Flow Identifier (SFID) number. gate priority, which is either high or low. gate status time at which the gate was committed

Pri Status Committed Time

The following is an example of typical screen output from the show packet-cable gate command:

Compass ID: 271820115 Version 3

21-57

BSR 64000 Command Reference Guide

Release 5.0.0

p g DQoS Gates: 2 -------------------------------------------------------------------------------GateID | Modem | Subscriber |CM| SFID |Pri| Status |Committed (0x) | MAC Address | IP Address |TS| Up | Dn | | | Time -------------------------------------------------------------------------------00000D3C 0011.8065.f57a 150.31.55.101 9 57 58 Low Committed 00:21:58 00000E86 0011.8065.f580 150.31.55.102 9 55 56 Low Committed 00:21:58 Multimedia Gates: 8 -------------------------------------------------------------------------------GateID | Modem | Subscriber |CM| SFID |Pri| Status |Committed (0x) | MAC Address | IP Address |TS| Up | Dn | | | Time -------------------------------------------------------------------------------010004E5 000e.5c6c.98f2 150.31.56.5 9 0 37 Low Committed 00:24:20 010005CA 000e.5c6c.98f2 150.31.56.5 9 39 0 Low Committed 00:24:19 01000600 000e.5c6c.98f2 150.31.56.5 9 0 41 Low Committed 00:24:19 0100077E 000e.5c6c.98f2 150.31.56.5 9 43 0 Low Committed 00:24:19 0100084A 000e.5c6c.9810 150.31.56.103 9 0 45 Low Committed 00:24:19 010009E5 000e.5c6c.9810 150.31.56.103 9 47 0 Low Committed 00:24:19 01000A4C 000e.5c6c.9810 150.31.56.103 9 0 49 Low Committed 00:24:19 01000BBA 000e.5c6c.9810 150.31.56.103 9 51 0 Low Committed 00:24:19

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show packet-cable gate [am-tag | application-type | cops | dqos | identifier | mm | modem | not-committed | slot | subscriber | summary ]

21-58

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

Command Syntax am-tag 0-65535 application-type 0-65535 cops 0-99 dqos identifier 0x00000000-0xffffffff mm modem mac not-committed slot NUM subscriber A.B.C.D summary Application Manager tag application type specify a COPS connection and COPS handle to display specify all DQoS gates Gate Identifier in hexadecimal notation to display detailed information about the DQoS or Multimedia gate. specify all Multimedia gates specify a cable modem MAC address to display only display gates not in COMMITTED state cable slot number to display specify a CPE (subscriber) IP address to display display summary information

Compass ID: 271820115 Version 3

21-59

BSR 64000 Command Reference Guide

Release 5.0.0

show packet-cable statistics
The show packet-cable statistics command displays COPS statistics, DQoS gate statistics, PacketCable Multimedia gate statistics, event message statistics, DQoS event message statistics, electronic surveillance event message statistics, and PacketCable Multimedia event message statistics. The following is an example of typical screen output from the show packet-cable statistics em command:

Event Message Statistics -------------------------------------------------------------------------Account Request Sent: 3 Account Response Received: 3 Account Request Failure: 0 Account Response Discarded: 0 DQoS Event Message Statistics -------------------------------------------------------------------------QoS_Reserve Count: 0 Primary RKS Retries: 0 QoS_Commit Count: 0 Primary RKS Exhausted: 0 QoS_Release Count: 0 Secondary RKS Retries: 0 Time_Change Count: 0 Secondary RKS Exhausted: 0 Electronic Surveillance Event Message Statistics -------------------------------------------------------------------------QoS_Reserve Count: 0 DF Retries: 0 QoS_Commit Count: 0 DF Exhausted: 0 QoS_Release Count: 0 Multimedia Event Message Statistics -------------------------------------------------------------------------QoS_Reserve Count: 1 Primary RKS Retries: 0 QoS_Commit Count: 1 Primary RKS Exhausted: 0 QoS_Release Count: 1 Secondary RKS Retries: 0 Time_Change Count: 0 Secondary RKS Exhausted: 0

The following is an example of typical screen output from the show packet-cable statistics gate command:

21-60

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

COPS Statistics -------------------------------------------------------------------------COPS Established: COPS Terminated: COPS Unauthorized: Keep-Alive Sent: Keep-Alive Received: Keep-Alive Timeout: Del-Req-State Sent: 1 0 0 7 7 0 0 Client-Open Sent: Client-Accept Received: Request Sent: Client-Close Received: Client-Close Sent: Sync-State-Req Received: Sync-State-Comp Sent: 1 1 1 0 0 0 0

DQoS Gate Statistics -------------------------------------------------------------------------Gate-Alloc Count: Gate-Alloc-Ack Count: Gate-Alloc-Err Count: Gate-Set Count: Gate-Set-Ack Count: Gate-Set-Err Count: Gate-Delete Count: Gate-Delete-Ack Count: Gate-Delete-Err Count: Gate-Info Count: Gate-Info-Ack Count: Gate-Info-Err Count: 0 0 0 8 8 0 0 0 0 0 0 0 Gate-Open Count: Gate-Close Count: T0 Timeout: T1 Timeout: T7 Timeout: T8 Timeout: CM Delete: CM Dereg: Admin Delete: Resource Reassign: 8 8 0 0 0 0 6 0 0 2

Multimedia Gate Statistics -------------------------------------------------------------------------Gate-Set Count: Gate-Set-Ack Count: Gate-Set-Err Count: Gate-Delete Count: Gate-Delete-Ack Count: Gate-Delete-Err Count: Gate-Info Count: Gate-Info-Ack Count: Gate-Info-Err Count: 0 0 0 0 0 0 0 0 0 Gate-Report-State Count: T1 Timeout: T2 Timeout: T3 Timeout: T4 Timeout: Volume Limit: CM Dereg: Admin Delete: 0 0 0 0 0 0 0 0

Compass ID: 271820115 Version 3

21-61

BSR 64000 Command Reference Guide

Release 5.0.0

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show packet-cable statistics [em | gate [ cops []]]

Command Syntax em gate cops 0-99 display event message statistics display gate statistics specify a COPS connection and COPS handle to display

21-62

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

The following is an example of typical screen output from the show packet-cable statistics gate command:

COPS Statistics -------------------------------------------------------------------------COPS Established: 6 Client-Open Sent: 6 COPS Terminated: 3 Client-Accept Received: 6 COPS Unauthorized: 0 Request Sent: 6 Keep-Alive Sent: 519 Client-Close Received: 0 Keep-Alive Received: 519 Client-Close Sent: 0 Keep-Alive Timeout: 0 Sync-State-Req Received: 0 Del-Req-State Sent: 0 Sync-State-Comp Sent: 0 DQoS Gate Statistics -------------------------------------------------------------------------Gate-Alloc Count: 3 Gate-Open Count: 4 Gate-Alloc-Ack Count: 3 Gate-Close Count: 2 Gate-Alloc-Err Count: 0 T0 Timeout: 0 Gate-Set Count: 4 T1 Timeout: 0 Gate-Set-Ack Count: 4 T7 Timeout: 0 Gate-Set-Err Count: 0 T8 Timeout: 0 Gate-Delete Count: 1 CM Delete: 2 Gate-Delete-Ack Count: 1 CM Dereg: 0 Gate-Delete-Err Count: 0 Admin Delete: 0 Gate-Info Count: 0 Gate-Info-Ack Count: 0 Gate-Info-Err Count: 0

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show packet-cable statistics [em | es identifier | gate [ cops []]]

Command Syntax

Compass ID: 271820115 Version 3

21-63

BSR 64000 Command Reference Guide

Release 5.0.0

em es identifier 0x00000000-0xffffffff gate cops 0-99

display event message statistics

display electronic surveillance statistics
Gate Identifier in hexadecimal notation to display detailed information about the DQoS or Multimedia gate display gate statistics specify a COPS connection and COPS handle to display

21-64

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

spd allow-dynamic-rsp
The spd allow-dynamic-rsp command allows a dynamic response from a peer to negotiate Internet Key Exchange (IKE) even though the SPD policy setting is other than the "APPLY" policy setting. The no spd allow-dynamic-rsp command is used to return the default setting.

Group Access
All

Command Mode
IPSec Configuration

Command Line Usage spd allow-dynamic-rsp no spd allow-dynamic-rsp

Command Default
BSR strictly follows the configured SPD.

Compass ID: 271820115 Version 3

21-65

BSR 64000 Command Reference Guide

Release 5.0.0

spd override
The spd override command is used to override IP addresses, ports, or protocols that are configured in the IPSec Security Policy Database (SPD). The no spd override is used to remove the address, port, or protocol override.

Group Access
All

Command Mode
IPSec Configuration

Command Line Usage spd override [addr-selector | port-selector | protocol-selector] no spd override [addr-selector | port-selector | protocol-selector]

Command Syntax addr-selector SPD overrides a specific IP address within a range of IP addresses or a wild card IP address set in the SPD. SPD overrides a specific port with a range of port(s) or wild card set in the SPD. SPD overrides a specific protocol with a range of protocol or wild card of protocol set in the SPD.

port-selector protocol-selector

Command Default
No SPD override address selector is configured. SPD override port selector is configured. SPD override protocol selector is configured.

21-66

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

spd policy
The spd policy command specifies a security policy for the given peers IPSec Security Policy Database (SPD). The SPD policy is priority based. The lower number index has a higher priority. Data packets are compared against rules in the SPD policy, starting with the first index. When a match is found, that rule is applied and no further comparisons are made against the SPD policy for that data packet. When deleting entries, a single rule or all the rules in the table can be deleted at once.

Group Access
All

Command Mode
IPSec Configuration

Command Line Usage spd policy {apply | bypass | discard} transport [after ] no spd policy { | all}

Command Syntax ipAddr{-ipAddr2|:ipMask} source network IP address followed by a colon and subnetwork mask. If a hyphen is used between ipAddr and ipAddr2, this specifies a range of source network IP addresses. destination network IP address followed by a colon and subnetwork mask. If a hyphen is used between ipAddr and ipAddr2, this specifies a range of destination network IP addresses.

ipAddr{-ipAddr2|:ipMask}

Compass ID: 271820115 Version 3

21-67

BSR 64000 Command Reference Guide

Release 5.0.0

num

transport protocol number which is the IP protocol from the IP protocol header. The format is a decimal number. A value of “0” represents any protocol. For example, the Call Management Server/Gate Controller or Call Management Server/Policy Server can use TCP Port 6 and the Record Keeping Server can use UDP Port 17. source TCP/UDP port number. “0” represents any port. destination TCP/UDP port number. “0” represents any port used if the packet matches the rule for this policy (i.e., ipAddr, ipAddr2, num, source port, or destination port matches the packet being processed), then apply transport mode IPSEC to the IP Packet. used if the packet matches the rule for this policy (i.e., ipAddr, ipAddr2, num, source port, or the destination port matches the packet being processed), then the IPSEC processing is bypassed and the IP packet is processed. used if the packet matches the rule for this policy (i.e., ipAddr, ip Addr2, num, source port, or destination port matches the packet being processed), then discard this IP packet. allows a rule to be inserted after an existing rule in the SPD. If the after is not present, the new rule is added to the first index. policy security index number from the show ipsec spd policy command. The index numbering begins at “1”.

0-65535 0-65535 apply transport

bypass

discard

after

num

21-68

Compass ID: 271820115 Version 3

Release 5.0.0

PacketCable Commands

spd preshared-key
The spd preshared-key command specifies the Pre-shared Key IP address to allow a Pre-shared secret key to be passed between parties in a communication flow to authenticate their mutual identities. The no spd preshared-key removes the Pre-shared Key IP address.

Group Access
All

Command Mode
IPSec Configuration

Command Line Usage spd preshared-key no spd preshared-key

Command Syntax
A.B.C.D string cable interface IP address Pre-shared Key name which is between 1 to 128 characters

Compass ID: 271820115 Version 3

21-69

22
VLAN Tagging Commands

Introduction
This chapter describes the commands used to configure and manage the VLAN Tagging feature on the BSR. VLAN Tagging allows the BSR to forward traffic received from a CPE connected to a bridging CM to a uniquely numbered VLAN using the 802.1Q industry-standard trunking encapsulation on a selected "bridge mode trunk" port.

VLAN Tagging Command Descriptions
This section contains an alphabetized list and descriptions of the VLAN Tagging commands supported by the BSR.

Compass ID: 271820115 Version 3

22-1

BSR 64000 Command Reference Guide

Release 5.0.0

bridge cable intercept
The bridge cable intercept command creates a cable intercept on a specified bridging CM as a respone to a CALEA request from law enforcement for traffic regarding a specific user. The no bridge cable intercept command deletes a bridge cable intercept on a specified bridging CM. Note: The bridge cable intercept command is only available to a user logged in as securityuser - refer to Configuring Cable Intercepts in the BSR 64000 CMTS Configuration and Management Guide.

Group Access
All

Command Mode
Global Configuration

Command Line Usage bridge cable intercept modem no bridge cable intercept modem

Command Syntax mac the intercept source, which is the MAC address from which traffic is intercepted. Packets with a source or destination MAC address that matches this address are copied and forwarded to the data collection server - this MAC address is always the user's CPE device (such as a PC or VoIP phone), and not the MAC address of the user's CM. The MAC address of the user's CM.

modem mac

22-2

Compass ID: 271820115 Version 3

Release 5.0.0

VLAN Tagging Commands

A.B.C.D

Specifies the destination IP address for the data collection server that receives copies of the forwarded traffic. The destination User Datagram Port (UDP) port number, which is used exclusively by the data collection server. A default UDP port number is not provided.

0-65535

Compass ID: 271820115 Version 3

22-3

BSR 64000 Command Reference Guide

Release 5.0.0

bridge cable modem
The bridge cable modem command designates a particular cable modem as a bridging CM and associates its CPE traffic to a specified VLAN.

Group Access
All

Command Mode
Global Configuration

Command Line Usage bridge cable modem [stackable] no bridge cable modem [stackable]

Command Syntax mac 2-4094 stackable cable modem MAC Address in the form xxxx.xxxx.xxxx the VLAN ID allows stacking of multiple IEEE 802.1Q tags

Note: VLAN ID 1 is reserved for use by the attached Layer 2 switch/router for management purposes and as the default "native" VLAN for that equipment. VLAN ID 1 may not be configured on the BSR for Ethernet port tagged routing or for cable modem Layer 2 bridging.

22-4

Compass ID: 271820115 Version 3

Release 5.0.0

VLAN Tagging Commands

bridge mode trunk
The bridge mode trunk command enables VLAN tagged bridging on a network interface. Only the ports of a Gigabit Ethernet Network Interface Module are permitted to be configured for VLAN Tagging.

Group Access
All

Command Mode
Interface Configuration

Command Line Usage bridge mode trunk [priority ] no bridge mode trunk [priority ]

Command Syntax

priority 0-255

the optional priority value for the "bridge mode trunk "port - if multiple network ports are configured with bridge mode trunk command, the BSR selects the port with the highest priority value with its link state up for forwarding VLAN tagged layer 2 packets. If not specified, the default priority value is 128

Compass ID: 271820115 Version 3

22-5

BSR 64000 Command Reference Guide

Release 5.0.0

cable privacy mandatory
The cable privacy mandatory command allows a cable operator to enable the encryption of all routed broadcasts and routed unmapped multicast traffic. The cable privacy mandatory command encrypts otherwise unencrypted downstream routed non-unicasts and only gives the key to decrypt these messages to routing cable modems. Bridging cable modems will discard all downstream routed broadcasts or routed multicasts. The no cable privacy mandatory disables the encryption of routed broadcasts and routed unmapped multicast traffic. Note: The cable privacy mandatory feature requires that all cable modems have BPI enabled in order to register. If a cable modem does not have BPI enabled and cable privacy mandatory is turned on, the cable modem will not be able to register. With cable privacy mandatory enabled, routed broadcasts are not received by VLAN Tagging CM's. Therefore, VLAN tagging cable modems will not be able to respond to broadcast pings. Warning: After enabling the cable privacy mandatory feature, the cable operator must issue the clear cable modem all reset command to re-register all cable modems and allow non-unicast traffic (including ARPs) to function correctly.

Group Access
All

Command Mode
Global Configuration

Command Line Usage cable privacy mandatory no cable privacy mandatory

22-6

Compass ID: 271820115 Version 3

Release 5.0.0

VLAN Tagging Commands

clear bridge vlan counters
The clear bridge vlan counters command clears all receive and transmit statistics for all VLANs associated with a VLAN cable modem. These are the same statistics displayed with the show bridge vlan counters command.

Group Access
All

Command Mode
Privileged EXEC

Command Line Usage clear bridge vlan counters []

Command Syntax
2-4094 the VLAN ID - if omitted, all VLAN counters are cleared

Compass ID: 271820115 Version 3

22-7

BSR 64000 Command Reference Guide

Release 5.0.0

encapsulation dot1q
The encapsulation dot1q command configures VLAN tagged routing. This means that all layer 3 packets routed by the BSR that egress the port are tagged with a particular 802.1Q VLAN ID tag. The no encapsulation dot1q disables VLAN tagged routing. The encapsulation dot1q command associates a sub-interface with a unique 802.1q tag that must be configured in the sub-interface shell. The no encapsulation dot1q command removes the sub-interface.

Group Access
ISP

Command Mode
Interface Configuration

Command Line Usage encapsulation dot1q no encapsulation dot1q

Command Syntax
1-4094 the VLAN ID for routed traffic

22-8

Compass ID: 271820115 Version 3

Release 5.0.0

VLAN Tagging Commands

show bridge vlan
The show bridge vlan command display the bridging cable modem MAC addresses for all VLANS or a specific VLAN. The following is typical screen output from the show bridge vlan command:

Selected Network Bridge Port: gigaether 15/2 Vlan CM Stackable ---- -------------- --------400 0008.0e10.39be disabled 900 000b.0643.33fc disabled 910 0020.409a.24c8 disabled

The show bridge vlan counters command displays statistical counters for all VLANs or a specific VLAN. The following is typical screen output from the show bridge vlan counters command:

VLAN ID ---2 3

Upstream Packets -------714 50

Upstream Discards ------------23 0

Downstream Packets ---------922 45

Downstream Discards ---------34 0

Group Access
All

Command Mode
All modes except User EXEC

Command Line Usage show bridge vlan [] show bridge vlan counters []

Compass ID: 271820115 Version 3

22-9

BSR 64000 Command Reference Guide

Release 5.0.0

Command Syntax

counters 2-4094

display statistical counters for all VLANs or a specific VLAN the VLAN ID - if omitted, all VLANs are displayed

Note: VLAN ID 1 is reserved for use by the attached Layer 2 switch/router for management purposes and as the default "native" VLAN for that equipment. VLAN ID 1 may not be configured on the BSR for Ethernet port tagged routing or for cable modem Layer 2 bridging.

22-10

Compass ID: 271820115 Version 3

23
DSG Commands

Introduction
This chapter describes the commands used to configure the DOCSIS Digital Set-top Gateway (DSG) feature on the BSR. DSG allows the BSR CMTS to provide out-of-band (OOB) cable services over a DOCSIS network. DSG allows MSOs to merge both set-top box and DOCSIS operations into a single, open network without having to re-configure their existing network or cable modems.

Command Descriptions
This section contains an alphabetized list and descriptions of the DSG commands supported by the BSR.

Compass ID: 271820115 Version 3

23-1

BSR 64000 Command Reference Guide

Release 5.0.0

cable downstream dsg
The cable downstream dsg command associates a channel list, timer, or vendor parameter with a downstream channel. The no cable downstream dsg command disassociates a channel list, timer, or vendor parameter with a downstream channel.

Group Access
MSO

Command Mode
Interface Configuration (cable interface only)

Command Line Usage cable downstream dsg {channel-list | timer | vendor-param} no cable downstream dsg {channel-list | timer | vendor-param}

Command Syntax
NUM channel-list timer vendor-param 1-4294967295 the downstream port number (default=0) associates a channel list with a downstream cable channel associates a DSG timer with a downstream cable channel associates a DSG vendor parameter list with a downstream cable channel the channel list, timer, or vendor-param index

23-2

Compass ID: 271820115 Version 3

Release 5.0.0

DSG Commands

cable downstream dsg enable
The cable downstream dsg enable command enables or disables DSG Downstream Channel Descriptor (DCD) messages on a downstream channel. The no cable downstream dsg enable command disables DSG DCD messages on a downstream channel.

Group Access
MSO

Command Mode
Interface Configuration (cable interface only)

Command Line Usage cable downstream dsg enable no cable downstream dsg enable

Command Syntax
NUM the downstream port number

Command Default
Enabled

Compass ID: 271820115 Version 3

23-3

BSR 64000 Command Reference Guide

Release 5.0.0

cable dsg
The cable dsg command accesses DOCSIS Set-top Gateway Configuration mode. DOCSIS Set-top Gateway Configuration Mode allows you to configure or modify various DSG configurations including channel lists, classifiers, client lists, group maps, timers and DSG tunnels. The no cable dsg command disables the DSG configuration.

Group Access
MSO

Command Mode
Global Configuration

Command Line Usage cable dsg no cable dsg

23-4

Compass ID: 271820115 Version 3

Release 5.0.0

DSG Commands

channel-list
The channel-list command creates or modifies a channel list. A channel list is a list of one or multiple downstream frequencies that are carrying DSG tunnels. The appropriate DSG Channel List will be included in the DCD messages on the associated downstream channel. The DSG Client uses the channel list to determine which downstream frequencies have DSG Tunnels present. The no channel-list command deletes a channel list. Note: Configuring a DSG channel list is optional. A DSG channel list provides a faster means of searching for DSG Tunnels but is not a mandatory configuration.

Group Access
MSO

Command Mode
DOCSIS Set-top Gateway Configuration

Command Line Usage channel-list channel {delete | ds-freq } no channel-list channel ds-freq

Command Syntax
1-4294967295 specifies a channel list index

channel 1-4294967295 specifies a channel index delete ds-freq 91000000-857000000 removes this channel list specifies the downstream channel frequency (s)

Compass ID: 271820115 Version 3

23-5

BSR 64000 Command Reference Guide

Release 5.0.0

classifier
The classifier command provides parameters for classifying DSG packets. The DSG Agent applies the DSG classifier parameters to DSG packets transmitted from the BSR to assign the DSG packet to the appropriate DSG tunnel. The DSG Agent can also include the classifier configuration in the DCD messages on the downstream channels to which the classifiers apply. The no classifier command deletes a classifier.

Group Access
MSO

Command Mode
DOCSIS Set-top Gateway Configuration

Command Line Usage classifier {delete | destination | destination-port | include-in-dcd | priority | source } no classifier {destination | destination-port | include-in-dcd | priority | source }

Command Syntax
1-65535 delete destination A.B.C.D the classifier number removes this classifier the destination IP address to be matched for this classifier Note: Specifying a destination IP address is required for the operation of this DSG classifier the low and high end destination port range to be matched for this classifier specifies the inclusion of this DSG classifier in DCD messages

destination-port 0-65535 0-65535 include-in-dcd

23-6

Compass ID: 271820115 Version 3

Release 5.0.0

DSG Commands

priority 0-255 source A.B.C.D A.B.C.D

the priority of this classifier - the default value of 0 indicates the lowest priority the IP address and network mask of the DSG server

Command Default priority = 0 include-in-dcd = false

Compass ID: 271820115 Version 3

23-7

BSR 64000 Command Reference Guide

Release 5.0.0

client-list
The client-list command creates a new DSG client list or modifies an existing DSG client list. A DSG client terminates the DSG tunnel and receives transmission from the CMTS. There may be more than one DSG Client within a Set-top Device. Configuring a DSG client involves specifying the matching parameters for the DSG clients for which the DSG rules applies. A DSG client ID uniquely identifies each DSG client. The same DSG client can exist in multiple Set-top Devices. In DSG Advanced Mode, the DSG client ID can be a 6 byte MAC address or may additionally be a 2 byte Application ID, a 2 byte CA_system_ID, or a broadcast ID. The Set-top Device has a fixed MAC address that must be matched by the DSG tunnel. The no client-list command deletes a client list.

Group Access
MSO

Command Mode
DOCSIS Set-top Gateway Configuration

Command Line Usage client-list client-id {application-id | broadcast [] | ca-id | delete | mac-address | vendor-param } no client-list client-id {application-id | broadcast [] | ca-id | mac-address | vendor-param }

Command Syntax
1-4294967295 1-4294967295 application-id line the client list number the client identifier specifies an application ID in 2-byte hex string (e.g. 12ab) - indicating a numeric ID for an application running on the Set-top Device

23-8

Compass ID: 271820115 Version 3

Release 5.0.0

DSG Commands

broadcast 1-4

specifies the broadcast ID which identifies what types of data streams are provided through the Broadcast Tunnel - the following list provides Broadcast ID data stream type values and definitions: 1 = contains SCTE-65 [SCTE-65] delivery as defined in Annex D 2 = contains SCTE-18 [SCTE-18] delivery as defined in Annex D 3 = contains OCAP Object Carousel [OC-SP-OCAP1.0 4 = contains OpenCable Common Download Carousel

ca-id line

specifies a CA ID in 2-byte hex string (e.g. 12ab) - indicating the type of CA system applicable for the associated embedded Cable Modem (ECM) streams delete this DSG client specifies a DSG client MAC address in the form of xxxx.xxxx.xxxx - this refers to the MAC address of the DSG Client within the Set-top Device the index of the vendor parameter list specifying the vendor specific DSG parameters

delete mac-address mac

vendor-param 1-4294967295

Compass ID: 271820115 Version 3

23-9

BSR 64000 Command Reference Guide

Release 5.0.0

group-map
The group-map command associates groups of tunnels to one or more downstream channels. A DSG group map contains the downstream port number, DSG rule priority, UCID range, and vendor parameter identifications. At least one tunnel must be configured before a tunnel group can be mapped to a downstream channel through a group map. The no group-map command deletes a DSG group map.

Group Access
MSO

Command Mode
DOCSIS Set-top Gateway Configuration

Command Line Usage group-map tunnel-group {delete | interface cable downstream | priority | ucid [...] | vendor-param } no group-map tunnel-group {interface cable downstream | priority | ucid [...] | vendor-param }

Command Syntax
1-4294967295 1-4294967295 delete interface cable X/Y downstream NUM priority 0-255 specifies a group map number specifies the tunnel group number delete this group map the cable interface slot and MAC domain and the downstream port number specifies a DSG rule priority level - DSG rule priority determines the order of which the channel and its associated UCIDs should be applied by the DSG client

23-10

Compass ID: 271820115 Version 3

Release 5.0.0

DSG Commands

ucid 1-255...1-255... vendor-param 1-4294967295

specifies the upstream channel ID (UCID) for which the DSG rule applies specifies the index of the vendor parameter specifying the vendor specific DSG parameters

Compass ID: 271820115 Version 3

23-11

BSR 64000 Command Reference Guide

Release 5.0.0

show cable dsg
The show cable dsg command displays all DSG configuration information provided with the following show commands:
■ ■ ■ ■ ■ ■ ■ ■ ■

show cable dsg channel-list show cable dsg classifier show cable dsg client-list show cable dsg downstream show cable dsg group-map show cable dsg timer show cable dsg tunnel show cable dsg tunnel-group show cable dsg vendor-param

Additionally, the show cable dsg command displays tunnel group associations to one or more downstream channels. The following is typical screen output from the show cable dsg for tunnel group associations to one or more downstream channels.

Cable DSG GroupChan 1 1: Downstream ifIndex: 32769 (cable 0/0 D0) Priority: 1 Ucid list: 1 2 3 4 Vendor Param Id: 1 Mapped slot/dsPort (slot