juniper networks g10 cmts · the purpose of this document, juniper networks g10 cmts cli reference,...
TRANSCRIPT
Juniper Networks, Inc.
1194 North Mathilda Avenue
Sunnyvale, CA 94089
USA
408-745-2000
www.juniper.net
Part Number: 530-008006-01, Revision 1
Juniper NetworksG10 CMTS
CLI Reference
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
ii
Copyright © 2002, Juniper Networks, Inc. All rights reserved. Juniper Networks is registered in the U.S. Patent and Trademark Office and in other countries as a trademark of Juniper Networks, Inc. Broadband Cable Processor, G10, Internet Processor, JUNOS, JUNOScript, M5, M10, M20, M40, M40e, M-series, M160, ServiceGuard, T640, and T-series are trademarks of Juniper Networks, Inc. All other trademarks, service marks, registered trademarks, or registered service marks are the property of their respective owners. All specifications are subject to change without notice.
Products made or sold by Juniper Networks (including the M5, M10, M20, M40, M40e, and M160 routers, T640 routing node, and the JUNOS software) or components thereof might be covered by one or more of the following patents that are owned by or licensed to Juniper Networks: U.S. Patent Nos. 5,473,599, 5,905,725, and 5909,440.
Juniper Networks G10 CMTS CLI ReferenceCopyright © 2002, Juniper Networks, Inc.All rights reserved. Printed in USA.
Writer: Jerry Isaac, Jim Stauffer, Dervinn CaldwellIllustrations: Paul GilmanCovers and template design: Edmonds Design
Revision History17 June 2002—First Edition.
Juniper Networks assumes no responsibility for any inaccuracies in this document. Juniper Networks reserves the right to change, modify, transfer, or otherwise revise this publication without notice.
The DOCSIS Module performs encryption that is subject to U.S. Customs and Export regulations. A DOCSIS Module shall not be exported, sold or transferred to a country outside the USA and Canada without an appropriate export license from the U.S. Government. The specific Regulations governing exports of encryption products are set forth in the Export Administration Regulations, 15 C.F.R. (Code of Federal Regulations), Parts 730-774.
••••••••••••••••••••••••••••••••••••••••••••••••
Table of Contents iii
Table of ContentsAbout This Manual
Purpose .................................................................................................................xiOrganization ..........................................................................................................xiDocument Conventions ........................................................................................xiiG10 CMTS Document Set.....................................................................................xiii
Chapter 1Command Summary ................................................................................................1
Chapter 2Command Listing ......................................................................................................9
Management Commands........................................................................................9Common Abbreviations ..........................................................................................9alias ......................................................................................................................10arp ........................................................................................................................10arp timeout...........................................................................................................11auto-negotiation....................................................................................................12banner exec..........................................................................................................13banner incoming ..................................................................................................14banner login .........................................................................................................15banner motd.........................................................................................................16banner show.........................................................................................................17broadcast..............................................................................................................18cable address-verification .....................................................................................18cable arp-verify .....................................................................................................19cable authorize .....................................................................................................20cable broadcast-domain........................................................................................21cable dhcp-giaddr .................................................................................................22cable downstream add..........................................................................................23cable downstream channel-width .........................................................................25cable downstream frequency................................................................................25cable downstream interleave-depth ......................................................................26cable downstream modulation..............................................................................28cable downstream rf-power ..................................................................................28cable downstream show .......................................................................................29cable downstream shutdown ................................................................................30cable drop-unverifiable-addresses .........................................................................31cable filter group...................................................................................................32cable filter show....................................................................................................34cable helper-address .............................................................................................35
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Referenceiv
cable host downstream-filter default-group...........................................................36cable host upstream-filter default-group................................................................37cable insertion-interval .........................................................................................38cable ip-broadcast-echo ........................................................................................39cable ip-multicast-echo .........................................................................................39cable llc-filter index ..............................................................................................40cable llc-filter show...............................................................................................41cable llc-filter unmatched-action ...........................................................................42cable log-invalid-addresses ...................................................................................42cable log-unverifiable-addresses ...........................................................................43cable modem downstream-filter default-group .....................................................44cable modem flap-list ...........................................................................................45cable modem upstream-filter default-group ..........................................................47cable modulation-profile .......................................................................................48cable privacy ........................................................................................................50cable privacy check-cert-validity-periods...............................................................51cable privacy kek life-time ....................................................................................52cable privacy tek life-time.....................................................................................53cable privacy trust-self-signed-cert ........................................................................53cable proxy-arp.....................................................................................................54cable ranging-attempts .........................................................................................55cable relay-agent-option .......................................................................................56cable show............................................................................................................57cable shared-secret ...............................................................................................57cable source-verify................................................................................................58cable subscriber-group..........................................................................................59cable sync-interval ................................................................................................61cable ucd-interval .................................................................................................61cable upstream add ..............................................................................................62cable upstream channel-hopping ..........................................................................63cable upstream channel-width ..............................................................................64cable upstream concatenation ..............................................................................65cable upstream data-backoff.................................................................................66cable upstream force ............................................................................................67cable upstream frequency ....................................................................................68cable upstream-load-balance ................................................................................69cable upstream minislot-size ................................................................................69cable upstream modem flap-list............................................................................70cable upstream modulation-control ......................................................................72cable upstream modulation-profile .......................................................................73cable upstream noise-cancellation ........................................................................74cable upstream-port spare ....................................................................................75cable upstream port..............................................................................................76cable upstream power-level ..................................................................................77cable upstream-pre-equalization ...........................................................................78cable upstream range-backoff...............................................................................79cable upstream show............................................................................................80cable upstream shutdown.....................................................................................81cable upstream width-control ...............................................................................81cable vpn..............................................................................................................82cat ........................................................................................................................83cd .........................................................................................................................84change-password..................................................................................................85chassis environment ambient-temperature...........................................................85clear aborted-modems..........................................................................................86clear alarms..........................................................................................................87clear arp-cache .....................................................................................................88
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Table of Contents v
clear cable modem ...............................................................................................88clear cable modem flap-list ...................................................................................89clock .....................................................................................................................90clock ntp-server ....................................................................................................91clock show............................................................................................................92clock summer-time ...............................................................................................92clock timezone......................................................................................................93configure memory ................................................................................................94configure terminal ................................................................................................95copy......................................................................................................................96cpe-controlled-cable-modem.................................................................................96debug....................................................................................................................97debug cable ..........................................................................................................98debug cable arp ....................................................................................................99debug cable bpkm ................................................................................................99debug cable bwr .................................................................................................100debug cable clear filter........................................................................................101debug cable clear log ..........................................................................................101debug cable dcc ..................................................................................................102debug cable dci...................................................................................................103debug cable dhcp................................................................................................104debug cable dynsrv.............................................................................................105debug cable icmp................................................................................................107debug cable interface cable.................................................................................108debug cable mac-address....................................................................................109debug cable mac-protocol ...................................................................................110debug cable map ................................................................................................111debug cable range...............................................................................................112debug cable registration......................................................................................113debug cable ucc ..................................................................................................114debug cable ucd..................................................................................................115debug cable updis ...............................................................................................116delete..................................................................................................................117description..........................................................................................................117dhcp-giaddr.........................................................................................................118dir.......................................................................................................................118disable ................................................................................................................119duplex.................................................................................................................119echo....................................................................................................................120edit .....................................................................................................................121enable.................................................................................................................122erase startup-config ............................................................................................122exit .....................................................................................................................123ftp.......................................................................................................................123help ....................................................................................................................124helper-address ....................................................................................................125history ................................................................................................................125hostname............................................................................................................126interface cable ....................................................................................................127interface fastEthernet .........................................................................................128interface gigaEthernet.........................................................................................129ip address ...........................................................................................................129ip default-gateway...............................................................................................130ip domain-name .................................................................................................131ip name-server....................................................................................................132ip show...............................................................................................................133kill.......................................................................................................................133
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Referencevi
log-level generate................................................................................................134log-level show.....................................................................................................135logout .................................................................................................................136ls ........................................................................................................................136mkdir..................................................................................................................137more...................................................................................................................138ping ....................................................................................................................139pwd ....................................................................................................................140relay-agent-option...............................................................................................140reload .................................................................................................................141rename...............................................................................................................142reset-slot.............................................................................................................142rmdir ..................................................................................................................143session timeout ..................................................................................................144show cable address-verification ..........................................................................144show cable modem ............................................................................................145show cable modem cpe ......................................................................................148show cable flap-list .............................................................................................149show cable modulation-profile............................................................................151show cable qos profile ........................................................................................152show cable shared-secret....................................................................................153show cable vpn...................................................................................................153show chassis environment..................................................................................154show chassis hardware.......................................................................................155show clock..........................................................................................................156show configuration .............................................................................................156show controller cable..........................................................................................156show cpu ............................................................................................................158show debugging..................................................................................................159show disk ...........................................................................................................159show history .......................................................................................................160show interfaces ..................................................................................................161show ip arp.........................................................................................................162show local-log .....................................................................................................163show memory ....................................................................................................164show privilege ....................................................................................................165show running-config ...........................................................................................165show startup-config ............................................................................................166show tech-support ..............................................................................................167show upgrade-log ...............................................................................................169show usernames.................................................................................................170show users..........................................................................................................170show version ......................................................................................................171show whoami .....................................................................................................171show working-config ..........................................................................................172shutdown............................................................................................................173snmp-server community.....................................................................................174snmp-server host ................................................................................................175speed..................................................................................................................176system apply ......................................................................................................177system auto-rollback...........................................................................................179system commit...................................................................................................179system config-backup .........................................................................................180system config-restore .........................................................................................181telnet ..................................................................................................................181terminal monitor ................................................................................................182terminal page-mode ...........................................................................................183
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Table of Contents vii
terminal speed....................................................................................................183tftp......................................................................................................................184traceroute ...........................................................................................................185username............................................................................................................185who ....................................................................................................................187write memory.....................................................................................................187
Appendix ALogin, Prompts, and Keys ...............................................................................189
Login...................................................................................................................189Prompts..............................................................................................................189Key Commands ..................................................................................................190
Appendix BConfiguration Notes ...........................................................................................191
Slot Numbers ......................................................................................................191Interface, Port and Channel Numbers.................................................................192
Appendix CSecurity ......................................................................................................................197
Groups ................................................................................................................197Privileges ............................................................................................................198Commands .........................................................................................................198Users ..................................................................................................................198
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Referenceviii
••••••••••••••••••••••••••••••••••••••••••••••••
List of Tables ix
List of TablesList of Tables
Table 1: Interleaver Depth Parameters .............................................................27Table 2: Event Priority Correspondence to CCM LEDs......................................87Table 3: Parameters Displayed by ‘show cable modem’ Command ...............147Table 4: Description of Online States .............................................................147Table 5: Description of CM Operational States ...............................................148Table 6: Flap-list Statistics ..............................................................................151Table 7: Local Event Log Headings Displayed.................................................164Table 8: Cable Interface to Ethernet Port Association .....................................192Table 9: Downstream Channel Assignment....................................................193Table 10: Upstream Channel Assignment (8-Channel DOCSIS Module) ............193Table 11: Upstream Channel Assignment (16-Channel DOCSIS Module) ..........194Table 12: Group/Privilege Matrix......................................................................197
List of Tables
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Referencex
••••••••••••••••••••••••••••••••••••••••••••••••
About This Manual xi
About This Manual
This section describes important information about the design of this document.
Purpose
The purpose of this document, Juniper Networks G10 CMTS CLI Reference, is to provide detailed descriptions of the commands used to operate the G10 Cable Modem Termination System (CMTS) through a command line interface (CLI). Instructions to perform specific tasks with commands is covered in the Juniper Networks G10 CMTS Installation and Configuration and the Juniper Networks G10 CMTS Operation and Maintenance manuals. This reference manual lists all commands and describes syntax, variables and other guidance to facilitate their use.
The intended audience for this information is the technicians and engineers who will install, configure, operate and maintain the G10 CMTS.
Organization
This document is organized as follows:
Chapter 1, “Command Summary” – Provides a list of top-level commands and a list of all commands organized by hierarchy.
Chapter 2, “Command Listing” – Provides an alphabetical listing of all commands. Includes syntax, definitions, examples and further guidance where applicable.
Appendix A, “Login, Prompts, and Keys” – Provides information about navigating and general operation of the CLI.
Appendix B, “Configuration Notes” – Provides guidance in determining the slot, interface, port and channel identifiers needed during configuration tasks.
Appendix C, “Security” – Describes the groups and privileges used to implement security and user access in the CLI.
Document Conventions
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Referencexii
Document Conventions
The following document conventions are used in this manual:
Notes, Cautions, and Warnings
GeneralConventions
Italic font Denotes a) emphasis, b) first use of a new term, or c) a document title.
Screen Name font Denotes a) the on-screen name of a window, dialog box or field, or b) keys on a keyboard.
Software Conventions
Computer font Font denotes code or messages displayed on-screen.
Computer Bold font Font denotes literal commands and parameters that you enter exactly as shown.
<Computer Italic> font Font denotes parameter values that require a user-defined input.
The value strings are enclosed in angle brackets <...>.
[parameter] Square brackets denote optional parameters.
{parameter} Braces denote required parameters.
| Vertical bars separate parameters in a group from which you must choose only one.
↵ Return symbol indicates pressing the Enter key at the end of a command line.
A note indicates information that might be helpful in a particular situation, or information that might otherwise be overlooked.
A caution indicates a situation that requires careful attention. Failure to observe a cautionary note could result in injury or discomfort to yourself, or serious damage to the product.
A warning is intended to alert the user of the presence of uninsulated dangerous voltage within the product’s enclosure that may present a risk of electric shock.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
About This Manual xiii
G10 CMTS Document Set
G10 CMTS Document Set
Pre-InstallationGuide
Installation andConfiguration
Getting Started FunctionalDescription
SNMP and Enterprise MIBSpecification
PREPARATION OPERATION REFERENCE
Operation andMaintenance
CLI Reference
530-008003-01
530-008006-01
530-008008-01530-008004-01530-008002-01
530-008007-01530-008005-01
G10 CMTS Document Set
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Referencexiv
••••••••••••••••••••••••••••••••••••••••••••••••
Command Summary 1
Chapter 1Command Summary
This section lists all the CLI commands in hierarchical structure.
The Group–Privilege column denotes the security access levels assigned to the command. Valid CLI groups are ip, rf, ad, and fs. A command that belongs to all four of these groups is designated as having a group of grp. A command that can be executed by all users, including those users not assigned to a group, is designated as having a group of all.
See Appendix C, “Security”, for more details regarding groups and privileges.
Group –Privilege
Top Level Commands Subordinate Commands
all alias <alias> <alias-string>
all broadcast <broadcast-string>
rf-rw cable authorize <filename> <slot>
rf-rw cable upstream slot <slot> channel <channel> force [channel-width <width>] [frequency <frequency>] [minislot-size <minislot-size>] [modulation-profile <profile-id>]
fs-ro cat <file-name>
fs-ro cd [dir-name]
all change-password
rf-rw clear aborted-modems
ad-rw clear alarms [minor] [major] [critical]
ip-rw clear arp-cache
rf-rw clear cable modem {<ip-address>|<mac-address>} [cpe]
rf-rw clear cable modem [<mac-address>] flap-list
ad-rw clock adjust <adjustment>
ad-rw clock set <time> <day-of-month> <month-of-year> <year>
grp-rw configure memory
grp-rw configure terminal
ip-rw arp <ip-address> <mac-address> [vlan-id <vlan-id>]
ip-rw arp timeout <seconds>
ad-rw banner exec <banner-string>
ad-rw banner incoming <banner-string>
ad-rw banner login <banner-string>
ad-rw banner motd <banner-string>
ad-rw banner show
ip-rw cable address-verification <ip-address> <mac-address>
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference2
ip-rw cable arp-verify
ip-rw cable drop-unverifiable-addresses
ip-rw cable filter group <pkt-filter-grp> index <index> match-action {discard|accept}
[src-ip <src-ip-addr>]
[src-mask <src-mask>]
[dest-ip <dest-ip-addr>]
[dest-mask <dest-mask>]
[ip-proto <l4-protocol>]
[ip-tos <tos-byte>]
[ip-tos-mask <tos-mask>]
[src-port <src-port>]
[dest-port <dest-port>]
[tcp-flags <tcp-flags>]
[tcp-flags-mask <tcp-flags-mask>]
grp-rw cable filter show
ip-rw cable host downstream-filter default-group <pkt-filter-grp>
ip-rw cable host upstream-filter default-group <pkt-filter-grp>
ip-rw cable llc-filter index <index> interface <if-index> protocol-type {dsap|ethertype} protocol <l3-protocol>
ip-rw cable llc-filter show
ip-rw cable llc-filter unmatched-action {accept|discard}
ip-rw cable log-invalid-addresses
ip-rw cable log-unverifiable-addresses
ip-rw cable modem downstream-filter default-group <pkt-filter-grp>
rf-rw cable modem flap-list
snr-threshold <snr-threshold>
mer-threshold <mer-threshold>
cer-threshold <cer-threshold>
power-adjust-threshold <power-adjust-threshold>
im-retry-interval <im-retry-interval>
sm-miss-threshold <sm-miss-threshold>
size <size>
age-time <days> [<hours> [<minutes>]]
show
ip-rw cable modem upstream-filter default-group <pkt-filter-grp>
rf-rw cable modulation-profile <profile-id>
request <p1> <p2> <p3> <p4> <p5> <p6> <p7> <p8> <p9> <p10>
reqdata <p1> <p2> <p3> <p4> <p5> <p6> <p7> <p8> <p9> <p10>
initial <p1> <p2> <p3> <p4> <p5> <p6> <p7> <p8> <p9> <p10>
station <p1> <p2> <p3> <p4> <p5> <p6> <p7> <p8> <p9> <p10>
short <p1> <p2> <p3> <p4> <p5> <p6> <p7> <p8> <p9> <p10>
long <p1> <p2> <p3> <p4> <p5> <p6> <p7> <p8> <p9> <p10>
show
rf-rw cable shared-secret <secret-string>
Group –Privilege
Top Level Commands Subordinate Commands
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Summary 3
ip-rw cable source-verify [DHCP]
rf-rw cable upstream-load-balance
rf-rw cable upstream noise-cancellation
rf-rw cable upstream-port slot <slot> port <port> spare center-frequency <frequency> width <width>
rf-rw cable upstream-pre-equalization
ip-rw cable vpn <mac-address> <vpn-id>
ad-rw chassis environment ambient-temperature {user-high-threshold <high-threshold>} | {user-low-threshold <low-threshold>}
ad-rw clock ntp-server <ip-address>
grp-rw clock show
ad-rw clock summer-time <time-zone> <day-start> <month-start> <hour-start> <day-end> <month-end> <hour-end>
ad-rw clock timezone <timezone> <hour-offset> [<min-offset>]
ad-rw hostname <“name”>|show
grp-rw interface cable <slot>/<if>
ip-rw cable broadcast-domain <domain-id>
ip-rw cable dhcp-giaddr <ip-address> [cable-modem|host]
rf-rw cable downstream <channel> add
rf-rw cable downstream <channel> channel-width
rf-rw cable downstream <channel> frequency <frequency>
rf-rw cable downstream <channel> interleave-depth {8|16|32|64|128}
rf-rw cable downstream <channel> modulation {64qam|256qam}
rf-rw cable downstream <channel> rf-power <power-level>
rf-rw cable downstream <channel> show
rf-rw cable downstream <channel> shutdown
ip-rw cable helper-address <ip-address> [<next-hop>] [cable-modem|host]
rf-rw cable insertion-interval <interval>
ip-rw cable ip-broadcast-echo
ip-rw cable ip-multicast-echo
rf-rw cable privacy [enforce]
rf-rw cable privacy check-cert-validity-periods
rf-rw cable privacy kek-life-time <seconds>
rf-rw cable privacy tek-life-time <seconds>
rf-rw cable privacy trust-self-signed-cert
ip-rw cable proxy-arp
rf-rw cable ranging-attempts <number-of-attempts>
ip-rw cable relay-agent-option
grp-rw cable show
ip-rw cable subscriber-group <group-name>
ip-rw dhcp-giaddr <ip-address> [cable-modem|host]
ip-rw helper-address <ip-address> <next-hop> [cable-modem|host]
ip-rw relay-agent-option
rf-rw cable sync-interval <interval>
rf-rw cable ucd-interval <interval>
Group –Privilege
Top Level Commands Subordinate Commands
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference4
rf-rw cable upstream <channel> add
rf-rw cable upstream <channel> channel-hopping
rf-rw cable upstream <channel> channel-width <width>
rf-rw cable upstream <channel> concatenation
rf-rw cable upstream <channel> data-backoff <start> <end>
rf-rw cable upstream <channel> frequency
rf-rw cable upstream <channel> minislot-size <minislot-size>
rf-rw cable upstream <channel> modem flap-list
snr-threshold <snr-threshold>
mer-threshold <mer-threshold>
cer-threshold <cer-threshold>
power-adjust-threshold <power-adjust-threshold>
im-retry-interval <im-retry-interval>
sm-miss-threshold <sm-miss-threshold>
show
rf-rw cable upstream <channel> modulation-control
rf-rw cable upstream <channel> modulation-profile <profile-id>
rf-rw cable upstream <channel> port <port>
rf-rw cable upstream <channel> power-level <power-level>
rf-rw cable upstream <channel> range-backoff <start> <end>
rf-rw cable upstream <channel> show
rf-rw cable upstream <channel> shutdown
rf-rw cable upstream <channel> width-control
rf-rw, ip-rw description <string>
rf-rw, ip-rw shutdown
ip-rw interface fastEthernet <slot>/<if>
ip-rw auto-negotiation {on|off}
ip-rw description <string>
ip-rw duplex {full|half}
ip-rw ip address <ip-address> <mask>
ip-rw show
ip-rw shutdown
ip-rw speed {10|100}
ip-rw interface gigaEthernet <slot>/<if>
ip-rw description <string>
ip-rw show
ip-rw shutdown
ip-rw ip default-gateway <ip-address> management
ip-rw ip domain-name <domain>
ip-rw ip name-server <ip-address>
ip-rw ip show
ad-rw log-level
<level-name> generate [local-log] [local-volatile-log] [syslog] [trap]
Group –Privilege
Top Level Commands Subordinate Commands
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Summary 5
show
ad-rw session timeout <seconds> [console]
ad-rw snmp-server community <community-string> {ro|rw}
ad-rw snmp-server host <ip-address> version {1|2c} [port <port-number>]
show
ad-rw username <name> group {ad|ip|rf|fs} privilege {rw|rd|ro}
ad-rw username <name> password <password>
ad-rw username <name> prompt <prompt-string>
fs-rw copy <source-file> <dest-file>|<dest-dir>
rf-rw cpe-controlled-cable-modem <mac-address>
disable {forever|<time-to-disable>}
reset
grp-rd debug (“no” form only)
grp-rd debug cable
arp
bpkm
bwr
clear filter
clear log
dcc
dci
dhcp
dynsrv
icmp
interface cable
<slot/if> mac-address <mac-address> <mac-mask> [verbose]
<slot/if> sid <sid> [verbose]
<slot/if> [verbose]
mac-address <mac-address> <mac-mask> [verbose]
mac-protocol
map
range
registration
ucc
ucd
updis
fs-rw delete <file-name>
fs-ro dir [directory-name]
all disable
grp-ro echo [<"echo-string"> [<"echo-string"> [<"echo-string">]]]
fs-rw edit <filename>
all enable
ad-rw erase startup-config
Group –Privilege
Top Level Commands Subordinate Commands
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference6
all exit [all]
ad-rw, fs-rw ftp {<hostname>|<ip-address>}
all help [edit-keys] (Available at all levels)
all history (available at all levels)
ad-rw kill <session-id>
all logout
fs-ro ls (same as dir)
fs-rw mkdir <dir-name>
fs-ro more <file-name>
all ping [ip] {<ip-address>|<hostname>}
all ping cable-modem {<ip-address>|<mac-address>}
fs-ro pwd
ad-rw reload [show|cancel]
ad-rw reload at <time>
ad-rw reload in <minutes>
fs-rw rename <source-filename> <dest-filename>
ad-rw reset-slot <slot>
fs-rw rmdir <directory-name>
all show cable address-verification [<ip-address>|<mac-address>|<slot/if>]
all show cable modem [summary [total]]
<slot/if> [upstream <channel>] [summary [total]]
<ip-address>|<mac-address>
all show cable modem [<ip-address>|<mac-address>] cpe
all show cable flap-list
[by-total-flaps]
[by-time]
[by-snr-flaps]
[by-cer-flaps]
[by-mer-flaps]
[by-im-flaps]
[by-sm-flaps]
[by-power-adjust]
by-interface [<slot> [<if>]]
by-upstream [<slot> [<channel>]]
by-mac [<mac-address>]
all show cable modulation-profile [<profile-id> [<iuc>]]
all show cable qos profile [<qos-profile-id>]
all show cable shared-secret
all show cable vpn <vpn-id>
all show chassis environment
all show chassis hardware [detail]
all show clock
all show configuration (same as show startup-config)
Group –Privilege
Top Level Commands Subordinate Commands
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Summary 7
all show controller cable [<slot/if> [downstream <channel> | upstream <channel>]]
all show cpu [<interval> [<repeat>]]
all show debugging
all-ro show disk
all show history
all show interfaces
cable <slot/if> downstream [<channel>]
cable <slot/if> upstream [<channel>]
cable <slot/if> sid [<sid>]
fastEthernet <slot/if>
gigaEthernet <slot/if>
all show ip arp [<ip-address>|<mac-address>|<slot/if>]
all show local-log
all show memory
all show privilege
all show running-config
all show startup-config
all show tech-support
all show upgrade-log
all show usernames
all show users
all show version [normal|failsafe|upgrade]
all show whoami
all show working-config
ad-rw system apply {normal|failsafe|upgrade [<filename>]}
ad-rw system auto-rollback
ad-rw system commit
ad-rw system config-backup <filename>
ad-rw system config-restore {factory|<filename>}
all telnet {<hostname>|<ip-address>}
grp-rd terminal monitor
all terminal page-mode
grp-rd terminal speed <speed>
fs-rw tftp get|put <ip-address> <filename>
all traceroute {<ip-address>|<host-name>}
all who
grp-rw write memory
Group –Privilege
Top Level Commands Subordinate Commands
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference8
••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing 9
Chapter 2Command Listing
This section lists all of the CLI commands in alphabetical order.
Management Commands
The following is a quick-reference list of commands commonly used for general management tasks:e
Common Abbreviations
The following abbreviations are commonly used in this document:
CMTS – Cable Modem Termination System (G10 CMTS)
CM – Cable modem
CPE – Customer premise equipment. Same as cable modem host.
All command parameters, both mandatory and optional, must be entered in the exact order specified in the Syntax section of the command description.
Administration Utility
username (config term mode) copy
clock delete
change-password (config term mode) cd
hostname dir / ls
enable mkdir
disable rmdir
reload pwd
exit more
logout edit
alias
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference10
alias
This command creates an alias for a string of text. A single-character delimiter of " must be used before and after the alias and the alias string if they are greater than one word. The delimiter cannot be used within the body of the string.
alias is a top-level command and is available to all users.
Omitting the alias-string parameter clears the alias.
Syntax
alias <“alias”> <“alias-string”>
Definitions
Examples
G10$root# alias ct “configure terminal”↵G10$root# ct↵G10$root(config)#
Use ct as the alias for configure terminal.
G10$root(config)# exit↵G10$root# alias ct↵
Clear the ct alias.
arp
This command adds static entries (entries that never time out) to the ARP (Address Resolution Protocol) table cache in the CMTS. ARP is used to associate IP addresses to MAC addresses. If a static or dynamic table entry with the specified IP address already exists, then that entry is updated with the given MAC address (if an optional VLAN ID is given, then the IP address and the VLAN ID must match those of an existing entry for that entry to be updated).
arp is a command within the configure terminal mode and requires read-write privilege.
The no form of this command removes static or dynamic entries in the ARP table that match the specified IP address. If the IP address is part of multiple virtual LANs (VLANs), then all entries that match the IP address are removed.
If the optional parameter vlan-id is not specified, this command refers to untagged ARP entries.
alias Specifies the alias to be used.
alias-string Specifies the string to be aliased.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
arp timeout
11
Syntax
arp <ip-address> <mac-address> [vlan-id <vlan-id>]
no arp <ip-address>
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# arp 192.203.56.9 1234.5678.9ABC vlan-id 3↵
A static ARP table entry is created with an IP address of 192.203.56.9, a MAC address of 1234.5678.9ABC, and a VLAN ID of 3.
Related Commands
arp timeoutcable address-verificationcable proxy-arpcable vpnclear arp-cacheshow ip arp
arp timeout
This command defines the timeout duration of a dynamic entry in the ARP (Address Resolution Protocol) table cache. This command applies to all cable interfaces.
arp timeout is a command within the configure terminal mode and requires read-write privilege.
The no form of this command resets the timeout duration to the default of 600 seconds (10 minutes).
Syntax
arp timeout <seconds>
no arp timeout
ip-address The IP address of the ARP table entry. Standard dot-quad notation (xxx.xxx.xxx.xxx).
mac-address The MAC address of the ARP table entry. Specified as xxxx.xxxx.xxxx in hexadecimal.
vlan-id The VLAN ID of the ARP table entry. Valid range is 1–4095. An unspecified VLAN ID is represented in the ARP table as 0.
auto-negotiation
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference12
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# arp timeout 1200↵
The timeout duration for dynamic ARP entries is set to 1200 seconds (20 minutes).
Related Commands
arpcable address-verificationcable proxy-arpcable vpnclear arp-cacheshow ip arp
auto-negotiation
This command enables or disables the automatic negotiation of link speed and duplex setting for the Fast Ethernet interfaces on the DOCSIS Module and the NIC Module.
auto-negotiation is a command within the fastEthernet interface configuration mode and requires read-write privilege.
This command does not have a no form.
The default setting of this command is on.
Syntax
auto-negotiation {on|off}
Definitions
seconds The timeout duration, in seconds, of a dynamic ARP entry. Valid range is 0–4294967295. A value of 0 specifies that dynamic entries do not timeout.
on This option enables the automatic negotiation of link speed and duplex setting for an Ethernet interface.
off This option disables the automatic negotiation of link speed and duplex setting for an Ethernet interface.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
banner exec
13
Examples
G10$root# configure terminal↵G10$root(config)# interface fastEthernet 6/0↵G10$root(config-if-f6/0)# auto-negotiation on↵
Enables auto-negotiation for Fast Ethernet port 0 of the Chassis Control Module in slot 6.
Guidance
When auto-negotiation is enabled, the CMTS ignores any previous setting for link speed or duplicity and tries to negotiate the best possible link speed and duplicity. When auto-negotiation is disabled, the CMTS leaves the Ethernet link’s speed and duplicity unchanged. That is, the Ethernet interface continues to operate with the previously negotiated settings until explicitly changed by the operator.
Related Commands
duplexshowshutdownspeed
banner exec
This command specifies a banner that is displayed after a user successfully logs in and the CMTS enters its command execution mode. A single-character delimiter of " must be used before and after the specified banner if the banner is greater than one word. The delimiter cannot be used within the body of the banner.
banner exec is a command within the configure terminal mode and requires read-write privilege.
no banner exec removes the banner display.
Syntax
banner exec <"banner-string">
no banner exec
Definitions
banner-string Specifies the banner that is displayed. The string is comprised of a sequence of text characters
banner incoming
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference14
Examples
G10$root# configure terminal↵G10$root(config)# banner exec "Exec Banner"↵
The banner displayed will be Exec Banner:
Login: root
Password:
Exec Banner
G10$root#
Related Commands
banner incomingbanner loginbanner motdbanner show
banner incoming
This command specifies a banner that is displayed before the login prompt when connecting to the CMTS through a console session. A single-character delimiter of " must be used before and after the specified banner if the banner is greater than one word. The delimiter cannot be used within the body of the banner.
banner incoming is a command within the configure terminal mode and requires read-write privilege.
no banner incoming removes the banner display.
Syntax
banner incoming <"banner-string">
no banner incoming
Definitions
banner-string Specifies the banner that is displayed. The string is comprised of a sequence of text characters
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
banner login
15
Examples
G10$root# configure terminal↵G10$root(config)# banner login "Incoming Banner"↵
The banner displayed will be Incoming Banner:
Copyright (c) 2000-2002 Juniper Networks, Inc.
G10 CMTS Release 2.0.1.19
Incoming Banner
Login:
Related Commands
banner execbanner loginbanner motdbanner show
banner login
This command specifies a banner that is displayed before the login prompt when connecting to the CMTS through a Telnet session. A single-character delimiter of " must be used before and after the specified banner if the banner is greater than one word. The delimiter cannot be used within the body of the banner.
banner login is a command within the configure terminal mode and requires read-write privilege.
no banner login removes the banner display.
Syntax
banner login <"banner-string">
no banner login
Definitions
banner-string Specifies the banner that is displayed. The string is comprised of a sequence of text characters
banner motd
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference16
Examples
G10$root# configure terminal↵G10$root(config)# banner login "Login Banner"↵
The banner displayed will be Login Banner.
Copyright (c) 2000-2002 Juniper Networks, Inc.
G10 CMTS Release 2.0.1.19
Login Banner
Login:
Related Commands
banner execbanner incomingbanner motdbanner show
banner motd
This command specifies a banner that is displayed before the login prompt when connecting to the CMTS through a Telnet or console session. If an incoming banner or a login banner has been specified, the motd banner is displayed immediately before it. A single-character delimiter of " must be used before and after the specified banner if the banner is greater than one word. The delimiter cannot be used within the body of the banner.
banner motd is a command within the configure terminal mode and requires read-write privilege.
no banner motd removes the banner display.
Syntax
banner motd <"banner-string">
no banner motd
Definitions
banner-string Specifies the banner that is displayed. The string is comprised of a sequence of text characters.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
banner show
17
Examples
G10$root# configure terminal↵G10$root(config)# banner login "Login Banner"↵G10$root(config)# banner motd "MOTD Banner"↵
The motd banner (MOTD Banner) is displayed immediately before the login banner (Login Banner).
Copyright (c) 2000-2002 Juniper Networks, Inc.
G10 CMTS Release 2.0.1.19
MOTD Banner
Login Banner
Login:
Related Commands
banner execbanner incomingbanner loginbanner show
banner show
This command is used to display the exec, incoming, login, and motd banners.
banner show is a command within the configure terminal mode and requires read-write privilege.
Syntax
banner show
Examples
G10$root# configure terminal↵G10$root(config)# banner show↵
Exec banner : This is an exec banner
Incoming banner : This is an incoming banner
login banner : This is a login banner
motd banner : This is an motd banner
Related Commands
banner execbanner incomingbanner loginbanner motd
broadcast
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference18
broadcast
This command sends a broadcast message to all sessions. A single-character delimiter of " must be used before and after the broadcast string if the string is greater than one word. The delimiter cannot be used within the body of the string.
broadcast is a top-level command and is available to all users.
Syntax
broadcast <“broadcast-string”>
Definitions
Examples
G10$root# broadcast “Please logoff now”↵
The broadcast string “Please logoff now” is sent to all sessions.
cable address-verification
This command adds static entries (entries that never time out) to the address verification table in the CMTS. If a static or dynamic table entry with the specified IP address already exists, that entry is updated with the given MAC address.
cable address-verification is a command within the configure terminal mode and requires read-write privilege.
The no form of this command removes static or dynamic entries in the address verification table that match the specified IP address. If the optional parameter ip-address is not specified, the entire address verification table is cleared.
Syntax
cable address-verification <ip-address> <mac-address>
no cable address-verification [<ip-address>]
Definitions
broadcast-string Specifies the broadcast string.
ip-address The IP address of the address verification table entry. Standard dot-quad notation (xxx.xxx.xxx.xxx).
mac-address The MAC address of the address verification table entry. Specified as xxxx.xxxx.xxxx in hexadecimal.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable arp-verify
19
Examples
G10$root# configure terminal↵G10$root(config)# cable address-verification 192.203.56.9 1234.5678.9ABC↵
A static address verification table entry is created with an IP address of 192.203.56.9 and a MAC address of 1234.5678.9ABC.
Related Commands
cable arp-verifycable drop-unverifiable-addressescable source-verifyshow cable address-verification
cable arp-verify
This command enables ARP verification—also referred to as ARP authentication. All ARP packets—requests and responses—are checked against an address verification table that contains the correspondence between a CM’s IP address, MAC address, and internal CM ID. There are three possible outcomes of the address verification check:
1. If the IP address of an ARP packet is found in the address verification table, and the source MAC address and CM ID match those in the table entry, the packet is considered valid and the CMTS appropriately proxies (if enabled) or forwards the packet.
2. If the IP address of an ARP packet is found in the address verification table, and the source MAC address and/or CM ID do not match those in the table entry, the packet is considered invalid and the CMTS unconditionally drops it.
3. If the IP address of an ARP packet is not found in the address verification table, the packet is considered unverifiable. By default, unverifiable ARP packets are forwarded unless the cable drop-unverifiable-addresses command enables the dropping of these packets.
cable arp-verify is a command within the configure terminal mode and requires read-write privilege.
no cable arp-verify disables ARP packet verification. DHCP lease queries are no longer issued, regardless of the previous state of the lease query.
By default, ARP packet verification is disabled.
Syntax
cable arp-verify [DHCP]
no cable arp-verify
cable authorize
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference20
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# cable arp-verify↵
Verify all ARP packets (without DHCP lease query).
Related Commands
arpcable address-verificationcable broadcast-domaincable drop-unverifiable-addressescable ip-broadcast-echocable ip-multicast-echocable proxy-arpcable source-verifyclear arp-cacheshow cable address-verificationshow ip arp
cable authorize
This command is used to upgrade a DOCSIS Module from a 4x8 configuration (four downstream channels and eight upstream channels) to a 4x16 configuration. The upgrade requires you to purchase a software key file that must be transferred to the CMTS prior to executing this command. The ftp or tftp command can be used for the file transfer.
cable authorize is a top-level command and requires read-write privilege.
The DOCSIS Module must be rebooted to enable the usage of the eight new upstream channels.
Execution of the show chassis hardware command displays the upgrade as a separate line item.
Syntax
cable authorize <filename> <slot>
DHCP If DHCP is specified and the source IP address of the ARP packet cannot be found in the address verification table, the CMTS issues DHCP lease queries to attempt to learn the association between the IP address, the MAC address, and the CM. The address verification table is updated accordingly.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable broadcast-domain
21
Definitions
Examples
G10$root# cable authorize myfile 2↵G10$root# reset-slot 2↵
Upgrade the DOCSIS Module in slot 2 from a 4x8 to a 4x16 configuration. Reboot the DOCSIS Module to enable the eight additional upstream channels.
Related Commands
ftpreset-slotshow chassis hardwaretftp
cable broadcast-domain
This command defines the broadcast domain scope for the targeted slot/interface. Multiple slot/interfaces (MAC domains) can belong to the same broadcast domain. However, a MAC domain can only be part of one broadcast domain, so a second instance of this command overrides the previous domain ID. Broadcast domains are implemented using VLAN tags. A corresponding VLAN for the broadcast domain must be configured on the upstream router or switch.
cable broadcast-domain is a command within the interface cable sub-mode and requires read-write privilege.
no cable broadcast-domain resets the broadcast domain to the default (untagged packets).
Syntax
cable broadcast-domain <domain-id>
no cable broadcast-domain
Definitions
filename The name of the software key file.
slot Chassis slot number of the DOCSIS Module to be upgraded. (1 to 4 or 10 to 13). See the diagram in “Slot Numbers” on page 191
domain-id The ID assigned to the broadcast domain for the targeted slot/interface. Valid range is 1–128.
cable dhcp-giaddr
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference22
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 1/0↵G10$root(config-if-c1/0)# cable broadcast-domain 2↵G10$root(config-if-c1/0)# exit↵G10$root(config)# interface cable 1/1↵G10$root(config-if-c1/1)# cable broadcast-domain 2↵
Defines interfaces 0 and 1 of slot 1 to the same broadcast domain, and assigns a broadcast domain ID of 2 for these interfaces.
Related Commands
cable ip-broadcast-echocable ip-multicast-echocable proxy-arp
cable dhcp-giaddr
This command is used to specify the IP address for a cable interface, and is also used by the CMTS while relaying DHCP packets originating from cable modem and CPE devices connected to the cable interface. The GIADDR is a standard option in DHCP requests that is used by the DHCP server to select an IP address pool (also known as the DHCP scope) from which to assign the IP addresses. The G10 CMTS allows you to specify separate GIADDRs for cable modems and for CPE devices to simplify the provisioning scenario where separate IP address pools have been assigned for cable modems and CPEs, but only a single DHCP server is used.
The GIADDR configured for a cable interface is owned by the CMTS. This enables the CMTS to directly receive the DHCP message responses sent by the DHCP server.
Multiple GIADDRs can be configured for the CPE devices, in which case the relay agent uses a round robin algorithm to assign the GIADDR address to CPE device DHCP Discover/Request messages. Multiple GIADDRs are configured to distribute the CPE devices evenly within all of the multiple subnets behind a single cable interface.
Other ways to distinguish DHCP requests from cable modems and CPEs are also supported (refer to the Related Commands section).
cable dhcp-giaddr is a command within the interface cable sub-mode and requires read-write privilege.
no cable dhcp-giaddr removes the configured GIADDR.
Only one GIADDR can be configured for a CM.
A maximum of 16 GIADDRs can be configured for CPE devices.
Any DHCP configuration performed at the interface cable sub-mode level applies to the default subscriber group for that cable interface (refer to the cable subscriber-group command for more details).
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable downstream add
23
Syntax
cable dhcp-giaddr <ip-address> [cable-modem|host]
no cable dhcp-giaddr <ip-address> [cable-modem|host]
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable dhcp-giaddr 192.111.210.88↵
Assigns IP address 192.111.210.88 to slot 4 / interface 1, and configures this address as the GIADDR for CMs and CPE devices. This GIADDR will be used by the relay agent to forward CM and CPE Discover/Request messages to the DHCP server.
G10$root(config-if-c4/1)# cable dhcp-giaddr 192.111.211.7 host↵G10$root(config-if-c4/1)# cable dhcp-giaddr 192.111.212.7 host↵
Configures two GIADDRs for CPE devices, which will be used by the relay agent in a round robin fashion to forward CPE Discover/Request messages to the DHCP server.
Related Commands
cable helper-addresscable relay-agent-optioncable subscriber-groupdhcp-giaddrhelper-addressrelay-agent-option
cable downstream add
This command adds the given downstream channel to the targeted cable interface.
cable downstream add is a command within the interface cable sub-mode and requires read-write privilege.
ip-address The IP address assigned to the cable interface, and the IP address of the relay agent for the DHCP server. Standard dot-quad notation (xxx.xxx.xxx.xxx).
cable-modem Specifies the IP address is for cable modems.
host Specifies the IP address is for hosts (CPE devices).
If neither the cable-modem nor the host keyword is given, the specified dhcp-giaddr is used for both cable modems and CPE devices.
cable downstream add
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference24
no cable downstream add removes the given downstream channel from the targeted cable interface.
Up to four downstream channels can be added to a cable interface.
By default, downstream channels 0–3 of a DOCSIS Module are assigned to the same-numbered cable interfaces 0–3, respectively. Refer to “Configuration Notes” on page 191 for details.
Syntax
cable downstream <channel> add
no cable downstream <channel> add
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 2/0↵G10$root(config-if-c2/0)# cable downstream 1 add↵
Add downstream channel 1 to slot 2 / interface 0.
Related Commands
cable downstream showcable upstream add
Guidance
Each DOCSIS Module contains two downstream processing paths. The traffic through even numbered cable interfaces (0 and 2) is forwarded through Ethernet port 0 on one path, while the traffic through odd numbered cable interfaces (1 and 3) is forwarded through the Ethernet port 1 on the other path. This implies, for example, that all downstream channels that reside in the even interfaces are handled within the same downstream processing path. Therefore, to load balance the traffic, it is recommended that the number of downstream channels assigned to interface 0, plus the number of downstream channels assigned to interface 2, be no greater than two. The same recommendation applies to the odd interfaces.
Refer to the Guidance section below for recommendations on the maximum number of downstream channels per cable interface.
channel The downstream channel (0 to 3) to assign to the cable interface. This is a channel in the slot/if specified by the interface cable command.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable downstream channel-width
25
cable downstream channel-width
This command sets the channel width for a downstream channel in the targeted slot/interface.
cable downstream channel-width is a command within the interface cable sub-mode and requires read-write privilege.
no cable downstream channel-width sets the downstream channel-width to the default value.
The default setting for this command is 6000000 Hz (for DOCSIS) and 8000000 Hz (for EuroDOCSIS).
Syntax
cable downstream <channel> channel-width <width>
no cable downstream <channel> channel-width <width>
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable downstream 1 channel-width 8000000↵
The downstream channel width for channel 1 in slot 4 / interface 1 is set to 8 MHz.
Related Commands
cable downstream show
cable downstream frequency
This command sets the IF-to-RF upconverter output frequency for the specified downstream channel in the DOCSIS Module identified by slot/interface. The DOCSIS Radio Frequency Interface Specification requires that a CMTS must output an RF modulated signal in the downstream with a center frequency from 91 MHz to 857 MHz. However, the upconverter can be programmed within the range of 54 MHz to 1 GHz.
cable downstream frequency is a command within the interface cable sub-mode and requires read-write privilege.
channel The channel (0 to 3) for which the width is being set. This channel is in the slot/if specified in the interface cable command.
width The channel width (in Hz) of the channel being set. Choices are 6000000 (DOCSIS) and 8000000 (EuroDOCSIS).
cable downstream interleave-depth
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference26
no cable downstream frequency resets the upconverter to its default frequency and disables the output of the upconverter.
The default frequencies for the four downstream channels are 531000000, 567000000, 603000000, and 639000000 Hz.
Syntax
cable downstream <channel> frequency <frequency>
no cable downstream <channel> frequency
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable downstream 1 frequency 105000000↵
The center frequency for downstream channel 1 in slot 4 / interface 1 is set to 105000000 Hz (105 MHz).
Related Commands
cable downstream showcable downstream rf-powercable downstream modulation
cable downstream interleave-depth
This command sets the depth of the interleaver for the specified downstream channel. ITU-T Recommendations J.83 requires that convolutional interleaving be employed to facilitate the correction of burst noise induced errors. As the interleave depth is increased, the amount of burst protection increases, but the latency of the data transmission also increases. Table 1 defines the relation between the interleave-depth parameters, the “I” and “J” characteristics of the interleaver, and the latency and burst protection durations for 64QAM and 256QAM.
channel The downstream channel (0 to 3) for which the frequency is being set. This is a channel in the slot/if specified by the interface cable command.
frequency The center frequency, in Hz, for the channel.
DOCSIS: 91000000 to 857000000EuroDOCSIS: 109000000 to 861000000
Unlike specifying the frequency parameter for an upstream channel, the G10 CMTS does not take into account the channel width prior to checking the valid range of the frequency parameter for a downstream channel.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable downstream interleave-depth
27
Where:
I = number of registersJ = symbol increment
Table 1: Interleaver Depth Parameters
cable downstream interleave-depth is a command within the interface cable sub-mode and requires read-write privilege.
no cable downstream interleave-depth resets the interleave depth to the default.
The default interleave depth for a channel is 8.
Syntax
cable downstream <channel> interleave-depth {8|16|32|64|128}
no cable downstream <channel> interleave-depth
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable downstream 1 interleave-depth 64↵
The interleave depth for downstream channel 1 in slot 4 / interface 1 is set to 64.
Related Commands
cable downstream show
interleave-depth I / JLatency / Burst Protection 64QAM
Latency / Burst Protection 256QAM
8 8 / 16 0.22 ms / 5.9 µs 0.15 ms / 4.1µs
16 16 / 8 0.48 ms / 12 µs 0.33 ms / 8.2 µs
32 32 / 4 0.98 ms / 24 µs 0.68 ms / 16 µs
64 64 / 2 2.0 ms / 47 µs 1.4 ms / 33 µs
128 128 / 1 4.0 ms / 95 µs 2.8 ms / 66 µs
channel The downstream channel (0 to 3) for which the interleave depth is being set. This channel is in the slot/if specified in the “interface cable” command.
8|16|32|64|128 The interleaver depth: 8, 16, 32, 64, or 128 (refer to Table 1).
cable downstream modulation
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference28
cable downstream modulation
This command sets the downstream modulation mode for the specified channel to either 64QAM or 256QAM. According to the DOCSIS specification, the nominal symbol rate in 64QAM mode is 5.056941 Msym/sec, where each symbol represents six bits. The nominal symbol rate in 256QAM mode is 5.360537 Msym/sec, where each symbol represents eight bits.
cable downstream modulation is a command within the interface cable sub-mode and requires read-write privilege.
This command does not have a no form.
The default modulation mode for a channel is 64QAM.
Syntax
cable downstream <channel> modulation {64qam|256qam}
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable downstream 1 modulation 64qam↵
The downstream modulation mode for channel 1 in slot 4 / interface 1 is set to 64QAM.
Related Commands
cable downstream showcable downstream frequencycable downstream rf-power
cable downstream rf-power
This command sets the output RF power level of the IF-to-RF upconverter in the DOCSIS Module for the specified channel in the cable interface.
cable downstream rf-power is a command within the interface cable sub-mode and requires read-write privilege.
no cable downstream rf-power resets the output RF power level to the default value.
The default output RF power level is 61 dBmV.
channel The downstream channel (0 to 3) for which the modulation mode is being set. This channel is in the slot/if specified in the “interface cable” command.
64qam | 256qam Select the modulation mode.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable downstream show
29
Syntax
cable downstream <channel> rf-power <power-level>
no cable downstream <channel> rf-power
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable downstream 1 rf-power 55↵
The output RF power level for channel 1 on slot 4 / interface 1 is set to 55 dBmV.
Related Commands
cable downstream showcable downstream frequencycable downstream modulation
cable downstream show
This command displays channel performance information for a specific downstream channel in a given slot/interface.
cable downstream show is a command within the interface cable sub-mode and requires read-write privilege.
This command does not have a no form.
There is no default setting for this command.
Syntax
cable downstream <channel> show
channel The downstream channel (0 to 3) for which the power level is being set. This channel is in the slot/if specified in the “interface cable” command.
power-level The output RF power level in dBmV. Range is 50 to 61 dBmV.
cable downstream shutdown
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference30
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable downstream 1 show↵
Cable 4/1: Downstream Channel 1 is up
458844 packets output, 68363319 bytes, 0 discarded
0 output errors
Channel performance information for downstream channel 1 on slot 4 / interface 1 is displayed.
cable downstream shutdown
This command disables a downstream channel in the specified slot/interface.
cable downstream shutdown is a command within the interface cable sub-mode and requires read-write privilege.
no cable downstream shutdown enables the channel.
The channels are disabled by default.
Syntax
cable downstream <channel> shutdown
no cable downstream <channel> shutdown
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# no cable downstream 1 shutdown↵
Channel 1 in slot 4 / interface 1 is enabled.
channel The channel (0 to 3) for which cable modem information is desired. This channel is in the slot/if specified in the “interface cable” command.
channel The channel (0 to 3) that will be enabled or disabled. This channel is in the slot/if specified in the interface cable command.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable drop-unverifiable-addresses
31
Related Commands
cable upstream shutdownshutdown
cable drop-unverifiable-addresses
This command enables the dropping of IP and ARP packets that are unverifiable. A packet is considered unverifiable if its IP address is not found in the address verification table. IP and ARP verification are enabled with the cable source-verify and cable arp-verify commands, respectively.
cable drop-unverifiable-addresses is a command within the configure terminal mode and requires read-write privilege.
no cable drop-unverifiable-addresses disables the dropping of unverifiable packets.
By default, the dropping of unverifiable packets is disabled.
Syntax
cable drop-unverifiable-addresses
no cable drop-unverifiable-addresses
Examples
G10$root# configure terminal↵G10$root(config)# cable drop-unverifiable-addresses↵
Drop all unverifiable packets.
Related Commands
arpcable address-verificationcable arp-verifycable log-unverifiable-addressescable proxy-arpcable source-verifyclear arp-cacheshow cable address-verificationshow ip arp
cable filter group
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference32
cable filter group
This command creates a packet filter corresponding to the SNMP object docsSubMgtPktFilterEntry and potentially an associated TCP/UDP filter corresponding to the SNMP object docsSubMgtTcpUdpFilterEntry (a TCP/UDP filter is created if one or more of the last four parameters is specified). These objects are defined in the DOCSIS Subscriber Management MIB. Packet filters apply to incoming and outgoing IP packets depending on how packet filter groups are associated with upstream or downstream traffic. Packet filters match based on various fields in the layer 3 packet header. Each packet filter can be associated with a TCP/UDP filter which adds match attributes for certain fields in the layer 4 header and applies if the IP packet is carrying TCP or UDP traffic.
Up to 1024 packet filters, and an equal number of associated TCP/UDP filters, can be created in the packet filter table. Filters are uniquely identified by the packet filter group and the packet filter index. The filters are prioritized within a given packet filter group by the filter index such that a smaller index implies a higher priority. The action taken for a packet depends on the highest priority matching filter. If no filter matches, the packet is accepted.
In the absence of an associated TCP/UDP filter, or for packets that carry neither TCP nor UDP traffic, a packet matches a packet filter when all header fields match the corresponding filter attributes under the match rules defined for that field. If a TCP/UDP filter is associated, and a packet carries TCP or UDP traffic, both the packet filter and the TCP/UDP filter attributes must match. Refer to the DOCSIS Subscriber Management MIB for further details regarding packet and TCP/UDP filters.
cable filter group is a command within the configure terminal mode and requires read-write privilege.
no cable filter group removes a packet filter and its associated TCP/UDP filter (if it exists) from the packet and TCP/UDP filter tables.
Parameters group, index, and match-action are required, and all others are optional. If an optional parameter is not specified, then its default is used for that packet or TCP/UDP filter.
The default values of all optional parameters are given under “Definitions” below.
Syntax
cable filter group <pkt-filter-grp> index <index> match-action {discard|accept} [src-ip <src-ip-addr> src-mask <src-mask> dest-ip <dest-ip-addr> dest-mask <dest-mask> ip-proto <l4-protocol> ip-tos <tos-byte> ip-tos-mask <tos-mask> src-port <src-port> dest-port <dest-port> tcp-flags <tcp-flags> tcp-flags-mask <tcp-flags-mask>]
no cable filter group <pkt-filter-grp> index <index>
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable filter group
33
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# cable filter group 22 index 5 match-action discard ip-proto 27↵
Sets up a packet filter to discard all IP packets carrying RDP traffic.
pkt-filter-grp An integer in the range 1–1024 that identifies an ordered group of filters.
index An integer in the range 1–1024 that describes the ordering of filters within a group. Filters are applied in index order, smallest index first.
discard|accept The action to take when a filter matches.
src-ip-addr The source IP address to match in an IP packet. A packet matches if [src-ip-addr AND src-mask]=[Packet Source IP Address AND src-mask]. Standard dot-quad notation (xxx.xxx.xxx.xxx). The default is 0.0.0.0.
src-mask A bit mask to be applied to the source address of an IP packet prior to matching. Standard dot-quad notation (xxx.xxx.xxx.xxx). The default is 0.0.0.0.
dest-ip-addr The destination IP address to match in an IP packet. A packet matches if [dest-ip-addr AND dest-mask]=[Packet Destination IP Address AND dest-mask]. Standard dot-quad notation (xxx.xxx.xxx.xxx). The default is 0.0.0.0.
dest-mask A bit mask to be applied to the destination address of an IP packet prior to matching. Standard dot-quad notation (xxx.xxx.xxx.xxx). The default is 0.0.0.0.
l4-protocol Layer 4 protocol to match. The valid range is 0–256. The default value of 256 matches all layer 4 protocols.
tos-byte The TOS (Type of Service) value to match in the IP packet. A packet matches on this attribute if [tos-byte AND tos-mask]=[Packet TOS Value AND tos-mask]. The value is specified as a two-digit hexadecimal number (00–FF) as it refers to a field containing multiple bitfields. The default is 00.
tos-mask The two-digit hexadecimal mask to apply against the TOS value to be matched in the IP packet. The default is 00.
src-port The TCP or UDP source port to match. The valid range is 0–65536. The default value of 65536 matches any value in the TCP or UDP source port field.
dest-port The TCP or UDP destination port to match. The valid range is 0–65536. The default value of 65536 matches any value in the TCP or UDP destination port field.
tcp-flags The TCP flags to match in the IP packet. A packet matches on this attribute if [tcp-flags]=[Packet TCP Flags AND tcp-flags-mask]. The value is specified as a two-digit hexadecimal number as it refers to multiple bitfields. The bits in this parameter are mapped to the TCP flags as follows:
80: URG40: ACK20: PSH10: RST08: SYN04: FIN
The least two significant bits must not be set to 1, and the value must always be a subset of tcp-flags-mask. Multiple bits can be set to 1 (for example, C0: URG, ACK). The default is 00.
tcp-flags-mask The mask applied to the TCP flags of a packet before it is compared to the TCP flags of the filter. The value is specified as a two-digit hexadecimal number as it refers to a field containing multiple bitfields. The default is 00.
cable filter show
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference34
G10$root# configure terminal↵G10$root(config)# cable filter group 33 index 7 match-action accept src-port 80 dest-port 80↵
Sets up a packet filter and an associated TCP/UDP filter to accept all TCP/UDP packets carrying HTTP traffic.
G10$root# configure terminal↵G10$root(config)# no cable filter group 33 index 7↵
Removes the packet filter and the associated TCP/UDP filter with index 7 in packet filter group 33.
Related Commands
cable filter showcable host downstream-filter default-groupcable host upstream-filter default-groupcable modem downstream-filter default-groupcable modem upstream-filter default-group
cable filter show
This command displays the current setting for all filters in the packet filter table corresponding to the SNMP object docsSubMgtPktFilterTable and any associated TCP/UDP filters from the TCP/UDP filter table corresponding to SNMP object docsSubMgtTcpUdpFilterTable. These objects are defined in the DOCSIS Subscriber Management MIB.
cable filter show is a command within the configure terminal mode and requires read-write privilege.
Syntax
cable filter show
Examples
G10$root# configure terminal↵G10$root(config)# cable filter show↵
group index action ipSrcAddr ipSrcMask ipDstAddr ipDstMask
ipProt tos tosMask scrPort dstPort tcp tcpMask
----- ----- ------ --------- --------- --------- ---------
------ --- ------- ------- ------- --- -----
22 5 discard 0.0.0.0 0.0.0.0 0.0.0.0 0.0.0.0
27 00 00
33 7 accept 0.0.0.0 0.0.0.0 0.0.0.0 0.0.0.0
256 00 00 80 80 00 00
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable helper-address
35
Displays a list of all filters in the tables corresponding to the Subscriber Management MIB objects docsSubMgtPktFilterTable and docsSubMgtTcpUdpFilterTable. The first entry displayed is a packet filter. The second entry, which displays values for the last four parameters wrapped around on the next line, is a TCP/UDP filter. Default values are displayed for all optional parameters that were not explicitly specified during the creation of the filter.
Related Commands
cable filter group
cable helper-address
This command is used to specify a destination IP address for Dynamic Host Configuration Protocol (DHCP) broadcast packets that are sent by cable modems and CPE devices on the specified slot/interface to a DHCP server. The User Datagram Protocol (UDP) is used as a connectionless transport protocol for carrying DHCP packets.
cable helper-address is a command within the interface cable sub-mode and requires read-write privilege.
no cable helper-address disables the helper-address feature.
There is no default setting for this command.
A maximum of 20 helper addresses can be specified for each cable interface—ten for CMs and ten for CPEs.
Any DHCP configuration performed at the interface cable sub-mode level applies to the default subscriber group for that cable interface (refer to the cable subscriber-group command for more details).
Syntax
cable helper-address <ip-address> [<next-hop>] [cable-modem|host]
Definitions
ip-address The IP address of the DHCP server.
next-hop An optional parameter that specifies the IP address of the next-hop gateway from the CMTS en route to the DHCP server. This parameter is required only if the DHCP server specified by the ip-address parameter is not in one of the IP subnets directly connected to the Ethernet port corresponding to the associated cable interface.
cable-modem Specifies the IP address is for cable modems.
host Specifies the IP address is for hosts (CPE devices).
cable host downstream-filter default-group
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference36
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable helper-address 192.71.25.108 172.168.10.1↵
Enables the forwarding of DHCP broadcast packets from any cable modem and CPE device on slot 4 / interface 1 to the DHCP server at 192.71.25.108. The packet will be sent out with the destination MAC address of a router port that has the IP address 172.168.10.1.
Related Commands
cable dhcp-giaddrcable relay-agent-optioncable subscriber-groupdhcp-giaddrhelper-addressrelay-agent-option
cable host downstream-filter default-group
This command sets the default packet filter group for downstream traffic to the cable hosts behind a cable modem. The specified default filter group is automatically associated with cable modems for which no filter group has been provisioned. Filter groups are defined in the DOCSIS Subscriber Management MIB or by the cable filter group CLI command, and are used to filter IP packets that meet a set of criteria. The modified entity corresponds to the SNMP MIB object docsSubMgtSubFilterDownDefault.
cable host downstream-filter default-group is a command within the configure terminal mode and requires read-write privilege.
no cable host downstream-filter default-group resets the command to its default value.
The default value for this command is 0, indicating no packet filtering for downstream traffic to hosts behind the cable modem.
Syntax
cable host downstream-filter default-group <pkt-filter-grp>
no cable host downstream-filter default-group
If neither the cable-modem nor the host keyword is given, the specified DHCP server is used for both cable modems and CPE devices.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable host upstream-filter default-group
37
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# cable host downstream-filter default-group 7↵
Sets the default cable host downstream packet filter group to 7.
Related Commands
cable filter groupcable host upstream-filter default-groupcable modem downstream-filter default-groupcable modem upstream-filter default-group
cable host upstream-filter default-group
This command sets the default packet filter group for upstream traffic to the cable hosts behind a cable modem. The specified default filter group is automatically associated with cable modems for which no filter group has been provisioned. Filter groups are defined in the DOCSIS Subscriber Management MIB or by the cable filter group CLI command, and are used to filter IP packets that meet a set of criteria. The modified entity corresponds to the SNMP MIB object docsSubMgtSubFilterUpDefault.
cable host upstream-filter default-group is a command within the configure terminal mode and requires read-write privilege.
no cable host upstream-filter default-group resets the command to its default value.
The default value for this command is 0, indicating no packet filtering for upstream traffic from hosts behind the cable modem.
Syntax
cable host upstream-filter default-group <pkt-filter-grp>
no cable host upstream-filter default-group
Definitions
pkt-filter-grp The number of the packet filter group to be used. (0 to 1024)
pkt-filter-grp The number of the packet filter group to be used. (0 to 1024)
cable insertion-interval
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference38
Examples
G10$root# configure terminal↵G10$root(config)# cable host upstream-filter default-group 7↵
Sets the default cable host upstream packet filter group to 7.
Related Commands
cable filter groupcable host downstream-filter default-groupcable modem downstream-filter default-groupcable modem upstream-filter default-group
cable insertion-interval
This command sets the interval between initial maintenance opportunities scheduled by the CMTS for the specified interface. Initial Maintenance opportunities are sent to cable modems within Upstream Bandwidth Allocation Map (MAP) messages that define the time slots in which a cable modem can transmit its initial ranging request (RNG-REQ MAC frame).
cable insertion-interval is a command within the interface cable sub-mode and requires read-write privilege.
no cable insertion-interval resets the Initial Maintenance interval to the default.
The default setting is 10.
Syntax
cable insertion-interval <interval>
no cable insertion-interval
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable insertion-interval 25↵
The initial maintenance interval for the modems on slot 4 / interface 1 is set to 250 milliseconds.
interval The number of 10-millisecond intervals between initial maintenance opportunities. Range is 1 to 200 (10 milliseconds to 2000 milliseconds).
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable ip-broadcast-echo
39
cable ip-broadcast-echo
This command enables echoing of IP broadcast packets from the upstream channels in the targeted slot/interface to the downstream channels in the currently-defined broadcast domain.
cable ip-broadcast-echo is a command within the interface cable sub-mode and requires read-write privilege.
no cable ip-broadcast-echo disables echoing of IP broadcast packets.
By default, IP broadcast echo is disabled.
Syntax
cable ip-broadcast-echo
no cable ip-broadcast-echo
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable ip-broadcast-echo↵
Echo all IP broadcast packets from the upstream channels in slot 4 / interface 1 to the downstream channels in the broadcast domain.
Related Commands
cable broadcast-domaincable ip-multicast-echocable proxy-arp
cable ip-multicast-echo
This command enables echoing of IP multicast packets from the upstream channels in the targeted slot/interface to the downstream channels in the currently-defined broadcast domain.
cable ip-multicast-echo is a command within the interface cable sub-mode and requires read-write privilege.
no cable ip-multicast-echo disables echoing of IP multicast packets.
By default, IP multicast echo is enabled.
Syntax
cable ip-multicast-echo
no cable ip-multicast-echo
cable llc-filter index
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference40
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable ip-multicast-echo↵
Echo all IP multicast packets from the upstream channels in slot 4 / interface 1 to the downstream channels in the broadcast domain.
Related Commands
cable broadcast-domaincable ip-broadcast-echocable proxy-arp
cable llc-filter index
This command creates an LLC filter corresponding to the SNMP object docsDevFilterLLCEntry as defined in the DOCSIS Cable Device MIB (RFC-2669). LLC filters allow the filtering of all packets on ingress based on the interface index of the physical interface they entered, the layer 3 protocol type, and the layer 3 protocol.
Up to 10 LLC filters can be created in the LLC filter table, and each is uniquely identified by its index. There is no prioritization between LLC filters. If any of the LLC filters matches an incoming packet, the opposite of the LLC filter unmatched action is performed and the packet is accepted or discarded accordingly (refer to the cable llc-filter unmatched-action command). If none of the LLC filters matches, the LLC filter unmatched action is performed. If no LLC filters are created, all incoming packets are accepted.
Refer to the DOCSIS Cable Device MIB for further details regarding LLC filters.
cable llc-filter index is a command within the configure terminal mode and requires read-write privilege.
no cable llc-filter index removes the LLC filter from the LLC filter table.
There are no default settings.
Syntax
cable llc-filter index <index> interface <if-index> protocol-type {dsap|ethertype} protocol <l3-protocol>
no cable llc-filter index <index>
Definitions
index An integer in the range 1–2147483647 that is used for the identification of the filter.
if-index An integer in the range 0–2147483647 that is the interface index of a physical interface on the CMTS. If if-index equals 0, the filter applies to all interfaces.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable llc-filter show
41
Examples
G10$root# configure terminal↵G10$root(config)# cable llc-filter index 5 interface 0 protocol-type ethertype protocol 2054↵
Sets up an LLC filter that matches an ARP packet encapsulated in a DIX or SNAP frame on any physical interface.
Related Commands
cable llc-filter unmatched-actioncable llc-filter show
cable llc-filter show
This command displays the current setting for the LLC filter unmatched action and the current LLC filters in the LLC filter table, which correspond to the SNMP objects docsDevFilterLLCUnmatchedAction and docsDevFilterLLCTable, respectively, in the DOCSIS Subscriber Management MIB.
Refer to the DOCSIS Cable Device MIB for further details regarding LLC filters.
cable llc-filter show is a command within the configure terminal mode and requires read-write privilege.
Syntax
cable llc-filter show
Examples
G10$root# configure terminal↵G10$root(config)# cable llc-filter show↵
Displays the current unmatched action and LLC filters.
Unmatched action: accept
llcIdx ifIndex protocolType protocol
------ ------- ------------ --------
5 0 ethertype 2054
dsap|ethertype Selects whether the protocol specified by <l3-protocol> is defined by the 8-bit DSAP field of an 802.3 encapsulated frame, or by the 16-bit Ethertype field of a DIX (EthernetII) or SNAP encapsulated frame.
l3-protocol The layer 3 protocol to which this filter applies. The valid range is 0–65535. If the protocol type is dsap, only values in the range 0–255 should be specified to assure the proper operation of this command. For SNAP frames, filtering is based on ethertype rather than on DSAP.
cable llc-filter unmatched-action
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference42
Related Commands
cable llc-filter indexcable llc-filter unmatched-action
cable llc-filter unmatched-action
This command sets the action to be performed on a packet when there are LLC filters set in the LLC filter table and no LLC filters match the incoming packet. It sets the object corresponding to the SNMP object docsDevFilterLLCUnmatchedAction defined in the DOCSIS Subscriber Management MIB. The value of this object is ignored if no LLC filers are set in the LLC filter table.
Refer to the DOCSIS Cable Device MIB for further details regarding LLC filters.
cable llc-filter unmatched-action is a command within the configure terminal mode and requires read-write privilege.
At initial system startup, the value of the LLC filter unmatched action defaults to accept.
Syntax
cable llc-filter unmatched-action {accept|discard}
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# cable llc-filter unmatched-action accept↵
Sets the action to be performed when there are LLC filters set, but no LLC filters match, to accept.
Related Commands
cable llc-filter indexcable llc-filter show
cable log-invalid-addresses
This command declares invalid IP and ARP packets as events that are conditionally logged and reported to the NMS. A packet is considered invalid if its IP address is found in the address verification table, but with a different MAC address and/or CM ID. IP and ARP verification are enabled with the cable source-verify and cable arp-verify commands, respectively.
accept|discard The action to be performed on a packet when there are LLC filters set, but no LLC filters match the packet. The opposite of this action is performed when LLC filters match the packet.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable log-unverifiable-addresses
43
Refer to the log-level generate command to see how logging and reporting actions are defined for events of various priority levels. Invalid IP and ARP packet events have a priority level of informational. The show local-log command is used to display the local event log.
cable log-invalid-addresses is a command within the configure terminal mode and requires read-write privilege.
no cable log-invalid-addresses prevents invalid IP and ARP packets from being declared as events.
By default, invalid IP and ARP packets are declared as events.
Syntax
cable log-invalid-addresses
no cable log-invalid-addresses
Examples
G10$root# configure terminal↵G10$root(config)# no cable log-invalid-addresses↵
Do not declare invalid IP and ARP packets as events.
Related Commands
arpcable address-verificationcable arp-verifycable log-unverifiable-addressescable proxy-arpcable source-verifyclear arp-cachelog-level generateshow cable address-verificationshow ip arpshow local-log
cable log-unverifiable-addresses
This command declares unverifiable IP and ARP packets as events that are conditionally logged and reported to the NMS. A packet is considered unverifiable if its IP address is not found in the address verification table. IP and ARP verification are enabled with the cable source-verify and cable arp-verify commands, respectively.
Refer to the log-level generate command to see how logging and reporting actions are defined for events of various priority levels. Unverifiable IP and ARP packet events have a priority level of informational. The show local-log command is used to display the local event log.
cable log-unverifiable-addresses is a command within the configure terminal mode and requires read-write privilege.
cable modem downstream-filter default-group
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference44
no cable log-unverifiable-addresses prevents unverifiable IP and ARP packets from being declared as events.
By default, unverifiable IP and ARP packets are not declared as events.
Syntax
cable log-unverifiable-addresses
no cable log-unverifiable-addresses
Examples
G10$root# configure terminal↵G10$root(config)# cable log-unverifiable-addresses↵
Declare unverifiable IP and ARP packets as events.
Related Commands
arpcable address-verificationcable arp-verifycable drop-unverifiable-addressescable log-invalid-addressescable proxy-arpcable source-verifyclear arp-cachelog-level generateshow cable address-verificationshow ip arpshow local-log
cable modem downstream-filter default-group
This command sets the default packet filter group for downstream traffic to cable modems. The specified default filter group is automatically associated with cable modems for which no filter group has been provisioned. Filter groups are defined in the DOCSIS Subscriber Management MIB or by the cable filter group CLI command, and are used to filter IP packets that meet a set of criteria. The modified entity corresponds to the SNMP MIB object docsSubMgtCmFilterDownDefault.
cable modem downstream-filter default-group is a command within the configure terminal mode and requires read-write privilege.
no cable modem downstream-filter default-group resets the command to its default value.
The default value for this command is 0, indicating no packet filtering for downstream traffic to the cable modem.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable modem flap-list
45
Syntax
cable modem downstream-filter default-group <pkt-filter-grp>
no cable modem downstream-filter default-group
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# cable modem downstream-filter default-group 5↵
Sets the default cable modem downstream packet filter group to 5.
Related Commands
cable filter groupcable modem upstream-filter default-groupcable host downstream-filter default-groupcable host upstream-filter default-group
cable modem flap-list
The G10 CMTS maintains a database of CMs along with various modem statistics for each CM. When a CM exhibits behavior that matches pre-defined criteria—referred to as a flap—an entry is added to a table called a flap-list. Each flap-list entry contains the MAC address of the CM, along with additional modem statistics that can assist in determining why the CM flapped (refer to the show cable flap-list command for details).
The flap criteria are defined globally for all cable interfaces by setting various parameters (thresholds) within the cable modem flap-list command. If a parameter is not explicitly set, a flap is defined by its default value. After an entry is added to the flap-list for a CM, any subsequent flap for that CM, whether defined explicitly or by default, updates that flap-list entry with new statistics (including a flap count). Examples of flaps include excessive initial ranging, missed station maintenance opportunities, large upstream power adjustments, and a Signal-to-Noise Ratio (SNR) dropping below a threshold.
The flap-list can be used to assist an operator with troubleshooting and locating CMTS and CM configuration issues, and problems in the HFC plant without impacting throughput and downstream performance, and without creating additional packet overhead throughout the HFC network.
cable modem flap-list is a command within the configure terminal mode and requires read-write privilege.
The cable modem flap-list command applies to all cable interfaces.
The no form of this command restores all parameters, or the specified parameter, to its default value.
pkt-filter-grp The number of the packet filter group to be used. (0 to 1024)
cable modem flap-list
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference46
The cable upstream modem flap-list command can be used on an upstream channel basis to override a global threshold set by the cable modem flap-list command.
Syntax
cable modem flap-list {snr-threshold <snr-threshold>} |{mer-threshold <mer-threshold>} |{cer-threshold <cer-threshold>} |{power-adjust-threshold <power-adjust-threshold>} |{im-retry-interval <im-retry-interval>} |{sm-miss-threshold <sm-miss-threshold>} |{size <size>} |{age-time <days> [<hours> [<minutes>]]} |{show}
no cable modem flap-list [snr-threshold|mer-threshold|cer-threshold|power-adjust-threshold|im-retry-interval|sm-miss-threshold|age-time]
Definitions
snr-threshold A flap occurs when the measured SNR of a CM drops below this threshold (specified in dB). The valid range is 1–100 and the default is 18.
mer-threshold A flap occurs when the measured Modulation Error Rate (MER) of a CM drops below this threshold (specified in dB). The valid range is 1–100 and the default is 18.
cer-threshold A flap occurs when the measured Codeword Error Rate (CER) of a CM rises above this threshold (specified in units of 10-6). The CER is the ratio of the number of codewords received with errors, before error correction is attempted, and the total number of codewords received (with and without errors). The valid range is 1–1000000 and the default is 1 (1 x 10-6).
power-adjust-threshold A flap occurs when the power adjustment sent to the CM during station maintenance is above this threshold (specified in dB). The valid range is 1–100 and the default is 3.
im-retry-interval A flap occurs when the time between two successive initial maintenance attempts by a particular CM is below this threshold (specified in seconds). The valid range is 60–86400 and the default is 180.
sm-miss-threshold A flap occurs when the number of consecutively missed station maintenance opportunities by a particular CM is above this threshold, and the CMTS subsequently receives a successful ranging request from the CM (this latter condition is required to discern whether the CM is missing station maintenance opportunities or is off-line). The valid range is 1–100 and the default is 2.
size The maximum number of CMs that can be displayed in the flap-list. The valid range is 1–8192 and the default is 8192.
days The duration, in days, to maintain an entry in the flap-list, counted from its last flap. The valid range is 0–60 and the default is 1. If specifying a value less than one day, enter 0 for days and use the optional parameters hours and/or minutes. The maximum age-time of a flap is 60 days and the minimum is 60 minutes.
hours The duration, in hours, to maintain an entry in the flap-list, counted from its last flap. The valid range is 0–23 and the default is 0. If specifying a value less than one hour, enter 0 for hours and use the optional parameter minutes. The maximum age-time of a flap is 60 days and the minimum is 60 minutes.
minutes The duration, in minutes, to maintain an entry in the flap-list, counted from its last flap. The valid range is 0–59 and the default is 0. The maximum age-time of a flap is 60 days and the minimum is 60 minutes.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable modem upstream-filter default-group
47
Examples
G10$root# configure terminal↵G10$root(config)# cable modem flap-list snr-threshold 20↵
Set the SNR threshold for all CMs to 20 dB.
G10$root(config)# cable modem flap-list age-time 0 0 45↵
Maintain an entry in the flap-list 45 minutes from its last flap.
G10$root(config)# no cable modem flap-list snr-threshold↵
Restore the SNR threshold for all CMs to its default value.
G10$root(config)# no cable modem flap-list↵
Restore all thresholds for all CMs to their default values.
Related Commands
cable upstream modem flap-listclear cable modem flap-listshow cable flap-list
cable modem upstream-filter default-group
This command sets the default packet filter group for upstream traffic from cable modems. The specified default filter group is automatically associated with cable modems for which no filter group has been provisioned. Filter groups are defined in the DOCSIS Subscriber Management MIB or by the cable filter group CLI command, and are used to filter IP packets that meet a set of criteria. The modified entity corresponds to the SNMP MIB object docsSubMgtCmFilterUpDefault.
cable modem upstream-filter default-group is a command within the configure terminal mode and requires read-write privilege.
no cable modem upstream-filter default-group resets the command to its default value.
The default value for command is 0, indicating no packet filtering for upstream traffic from the cable modem.
show Displays the current value of each flap-list parameter.
Tuning the flap thresholds is recommended to minimize the number of irrelevant entries in the flap-list.
cable modulation-profile
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference48
Syntax
cable modem upstream-filter default-group <pkt-filter-grp>
no cable modem upstream-filter default-group
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# cable modem upstream-filter default-group 6↵
Sets the default cable modem upstream packet filter group to 6.
Related Commands
cable filter groupcable modem downstream-filter default-groupcable host downstream-filter default-groupcable host upstream-filter default-group
cable modulation-profile
This command defines a modulation profile for a specific interval usage code which may be applied to one or more upstream channels. When applied, the modulation profile is used to compose the Burst Descriptor included in that channel's Upstream Channel Descriptor (UCD) message, which is periodically sent to each cable modem. The UCD message configures the modem’s transmission characteristics. A modulation profile is composed of six interval usage codes, where each is followed by ten parameters. However, if the scrambler is disabled, p7 parameter is not used so there are nine parameters to set in this case.
cable modulation-profile is a command within the configure terminal mode and requires read-write privilege.
The no form of this command removes the specified modulation profile.
The default setting is modulation profile ID 8 for all upstream channels. See the example below for the default parameters.
Syntax
cable modulation-profile <profile-id> {request|reqdata| initial|station|short|long} {<p1> <p2> <p3> <p4> <p5> <p6> <p7> <p8> <p9> <p10>}
no cable modulation-profile <profile-id> {request|reqdata| initial|station|short|long} {<p1> <p2> <p3> <p4> <p5> <p6> <p7> <p8> <p9> <p10>}
cable modulation-profile <profile-id> show
pkt-filter-grp The number of the packet filter group to be used. (0 to 1024)
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable modulation-profile
49
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# cable modulation-profile 5 short 5 75 8 5 qpsk scrambler 1 diff 32 shortened↵
The short interval usage code is set for modulation profile #5, which includes 5 FEC T bytes; 75 FEC K bytes; maximum burst size of 8 minislots; guard time between bursts of 5 symbols; QPSK modulation type; enabled scrambler using a seed value of 0001h; enabled differential encoding; preamble length of 32 bits; and a shortened last codeword.
profile-ID The modulation profile identification number (ID). Valid options are numbers from 1 to 256.
{request|reqdata|initial|
station|short|long}
Interval usage code.
request: An upstream interval in which requests may be made for bandwidth for upstream data transmission
reqdata: An interval in which requests for bandwidth or short data packets may be transmitted
initial: An interval in which new stations (cable modems) may join the network
station: An interval in which stations are expected to perform some aspect of routine network maintenance, such as ranging or power adjustment
short: An interval in which a CM transmits one or more upstream Protocol Data Units (PDUs). The interval for a short interval is less than or equal to the Maximum Burst Size defined in the short profile.
long: An interval in which a CM transmits one or more upstream Protocol Data Units (PDUs). The number of mini-slots in the interval is larger than the maximum for short interval transmissions.
p1 FEC T bytes: The number of codeword parity bytes is 2*T. T is the number of bytes that can be corrected per FEC codeword. Values range from 1 to 10, or 0 for no FEC—forward error correction.
p2 FEC K bytes: Codeword information bytes (Not used if no FEC, T=0). Values range from 16 to 253.
p3 maxburst size: The maximum number of mini-slots that can be transmitted during this burst type. Values range from 1 to 255, or 0 for no limit.
p4 guard time: Number of symbol times which must follow the end of this burst. Values range from 0 to 255.
p5 modulation: Upstream modulation type. Options are qpsk or 16qam.
p6 scrambler: Determines if the scrambler is used. Options are scrambler or no-scrambler.
Note: no-scrambler may cause packet loss and should be used only in a lab environment.
p7 scrambler seed: The 15-bit scrambler seed value. Values range from 0 to 7FFF. This parameter is not required if the scrambler is disabled.
p8 diff encoding: Determines if differential encoding is used. Options are diff or no-diff.
p9 preamble length: Defines the length of the preamble in bits. Values range from 0, 2, 4,... 1024 for qpsk modulation and 0, 4, 8, ...1024 for 16qam modulation.
p10 shortened last codeword: Determines whether the last codeword is shortened or not. Options are fixed (fixed length code word) or shortened (shortened code word).
show Displays the parameters for the specified modulation profile ID.
cable privacy
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference50
G10$root# configure terminal↵G10$root(config)# cable modulation-profile 10 initial 3 34 0 5 qpsk no-scrambler diff 52 fixed↵
The initial interval usage code is set for modulation profile #10. This profile does not use the scrambler, so only nine parameters are set.
G10$root# configure terminal↵G10$root(config)# cable modulation-profile 1 show↵
ModId IUC prelen seed mod dif fec data/fec brst guard lstcw scrmb
1 request(1) 68 0x0001 QPSK Y 0 16 0 6 2 Y
1 reqdata(2) 68 0x0001 QPSK Y 3 40 8 6 2 Y
1 initial(3) 52 0x0001 QPSK Y 3 34 0 5 2 Y
1 station(4) 52 0x0001 QPSK Y 3 34 0 5 2 Y
1 short(5) 32 0x0001 QPSK Y 5 75 8 5 1 Y
1 long(6) 32 0x0001 QPSK Y 8 220 0 5 1 Y
Related Commands
show cable modulation-profile
cable privacy
This command affects the manner in which the CMTS responds to a CM registration request based on the Privacy Enable Configuration Setting (BPI or BPI+) within the REG-REQ message. Depending on the variant of the command executed, privacy will be enabled, disabled, or enforced.
cable privacy is a command within the interface cable sub-mode and requires read-write privilege.
Following are descriptions of the effects of the four variants of this command on a CM that resides on the targeted slot/interface:
cable privacy – privacy is enabled. Privacy for a CM is determined by the privacy setting in the REG-REQ message. The CMTS will not reject a REG-REQ message due to the privacy setting.
no cable privacy – privacy is disabled. If a CM attempts to register with privacy enabled, the CMTS will reject the REG-REQ message. A CM that attempts to register without privacy enabled will not be rejected (due to privacy) during registration.
cable privacy enforce – privacy is enforced. If a CM attempts to register without privacy enabled, the CMTS will reject the REG-REQ message. A CM that attempts to register with privacy enabled will not be rejected (due to privacy) during registration.
The no-scrambler option may cause packet loss and should be used only in a lab environment.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable privacy check-cert-validity-periods
51
no cable privacy enforce – privacy is enabled. Privacy for a CM is determined by the privacy setting in the REG-REQ message. The CMTS will not reject a REG-REQ message due to the privacy setting. Note that the effect of this command is identical to the effect of the cable privacy command.
The default setting privacy enabled.
This command only affects CMs during registration attempts. CMs that have already registered are not affected by the parameter specified within this command until they register again (due to other reasons).
Syntax
cable privacy [enforce]
no cable privacy [enforce]
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 2/0↵G10$root(config-if-c2/0)# cable privacy enforce↵
The CMTS will reject any registrations by CMs on slot 2 / interface 0 that attempt to register without privacy enabled.
Related Commands
show cable privacy
cable privacy check-cert-validity-periods
This command instructs the CMTS to check the validity period or the trust of authentication certificates presented by CMs.
cable privacy check-cert-validity-periods is a command within the interface cable sub-mode and requires read-write privilege.
cable privacy check-cert-validity-periods strictly checks the validity of a certificate. The CM is rejected if its certificate has expired.
no cable privacy check-cert-validity-periods ignores the validity of a certificate, but checks the trust status. A CM can register with an expired certificate as long as the trust status is trusted or chained. Otherwise, the CM is rejected.
The default is to check the validity of a certificate for expiration.
cable privacy kek life-time
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference52
Syntax
cable privacy check-cert-validity-periods
no cable privacy check-cert-validity-periods
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 2/0↵G10$root(config-if-c2/0)# cable privacy check-cert-validity-periods↵
The CMTS will check the validity of certificates from CMs on slot 2 / interface 0.
Related Commands
cable privacy kek life-timecable privacy tek life-timecable privacy trust-self-signed-cert
cable privacy kek life-time
This command sets the default lifetime of a Key Encryption Key (KEK). The CMTS assigns this value to all new KEKs.
cable privacy kek life-time is a command within the interface cable sub-mode and requires read-write privilege.
no cable privacy kek life-time restores the default value to 604800 seconds.
Syntax
cable privacy kek life-time <seconds>
no cable privacy kek life-time
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 2/0↵G10$root(config-if-c2/0)# cable privacy kek life-time 500000↵
Sets the KEK lifetime to 500000 seconds for all CMs on slot 2 / interface 0.
seconds Specifies the default lifetime of a KEK (in seconds). Valid range is 1 to 6048000.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable privacy tek life-time
53
Related Commands
cable privacy check-cert-validity-periodscable privacy tek life-timecable privacy trust-self-signed-cert
cable privacy tek life-time
This command sets the default lifetime of a Traffic Encryption Key (TEK). The CMTS assigns this value to all new TEKs.
cable privacy tek life-time is a command within the interface cable sub-mode and requires read-write privilege.
no cable privacy tek life-time restores the default value to 43200 seconds.
Syntax
cable privacy tek life-time <seconds>
no cable privacy tek life-time
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 2/0↵G10$root(config-if-c2/0)# cable privacy tek life-time 50000↵
Sets the TEK lifetime to 50000 seconds for all CMs on slot 2 / interface 0.
Related Commands
cable privacy check-cert-validity-periodscable privacy kek life-timecable privacy trust-self-signed-cert
cable privacy trust-self-signed-cert
This command sets the default trust of new self-signed manufacturer certificates to trusted.
cable privacy trust-self-signed-cert is a command within the interface cable sub-mode and requires read-write privilege.
no cable privacy trust-self-signed-cert sets the default trust of new self-signed manufacturer certificates to untrusted.
seconds Specifies the default lifetime of a TEK (in seconds). Valid range is 1 to 604800.
cable proxy-arp
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference54
The default trust is untrusted.
Syntax
cable privacy trust-self-signed-cert
no cable privacy trust-self-signed-cert
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 2/0↵G10$root(config-if-c2/0)# cable privacy trust-self-signed-cert↵
Sets the default trust of new self-signed manufacturer certificates to trusted for all CMs on slot 2 / interface 0.
Related Commands
cable privacy check-cert-validity-periodscable privacy kek life-timecable privacy tek life-time
cable proxy-arp
This command enables proxying of ARP requests from the upstream channels in the targeted slot/interface. If ARP proxy is enabled, the CMTS checks an ARP request against its ARP table cache for a match. If a match is found, the CMTS sends an ARP response directly to the requestor. If a match is not found (or if ARP proxy is disabled), the CMTS forwards the ARP request to all downstream channels in the currently-defined broadcast domain.
If enabled, ARP verification (authentication) is performed on the source of the ARP packet prior to proxying or forwarding an ARP packet (refer to the cable arp-verify command).
cable proxy-arp is a command within the interface cable sub-mode and requires read-write privilege.
no cable proxy-arp disables proxying of ARP packets.
By default, ARP proxying is enabled.
Syntax
cable proxy-arp
no cable proxy-arp
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable ranging-attempts
55
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable proxy-arp↵
Proxy all verified ARP requests from the upstream channels in slot 4 / interface 1.
Related Commands
arpcable arp-verifycable broadcast-domaincable ip-broadcast-echocable ip-multicast-echoclear arp-cacheshow ip arp
cable ranging-attempts
This command sets the number of ranging attempts the CMTS will make before concluding that a cable modem is non-responsive.
Ranging is the process by which the CM and CMTS establish connectivity and exchange basic physical information under the DOCSIS protocol. The CM sends a ranging request at initialization. The CMTS also prompts the CM for ranging requests periodically. Parameters such as SID, channel ID, timing, frequency and power information are maintained and adjusted during ranging.
cable ranging-attempts is a command within the interface cable sub-mode and requires read-write privilege.
The default value is 16.
no cable ranging-attempts sets the value to default.
Syntax
cable ranging-attempts <number-of-attempts>
no cable ranging-attempts
Definitions
number-of-attempts The number of times the CMTS will attempt to range a modem. Range of values is 0 to 1024. However, large values should only be used for testing purposes. Select a small value for operation.
cable relay-agent-option
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference56
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable ranging-attempts 25↵
The CMTS will attempt to range the cable modems on slot 4 / interface 1 twenty-five times before concluding the modem is non-responsive.
cable relay-agent-option
This command enables the CMTS to insert Dynamic Host Configuration Protocol (DHCP) relay information in DHCP Bootrequest messages forwarded by a CM or CPE to DHCP servers. Specifically, the CMTS inserts the 48-bit MAC address of the CM in the "DHCP Relay Agent Information Option, sub-option Agent Circuit ID" (option 82) field. The DHCP server uses this address and the one in the DHCP Bootrequest message to determine if the original request came from a CM or CPE.
cable relay-agent-option is a command within the interface cable sub-mode and requires read-write privilege.
The default for this command is disabled.
no cable relay-agent-option disables insertion of DHCP relay information.
Any DHCP configuration performed at the interface cable sub-mode level applies to the default subscriber group for that cable interface (refer to the cable subscriber-group command for more details).
Syntax
cable relay-agent-option
no cable relay-agent-option
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable relay-agent-option↵
Enables the insertion of DHCP relay information from any cable modem or CPE device on slot 4 / interface 1.
Related Commands
cable dhcp-giaddrcable helper-addresscable subscriber-groupdhcp-giaddrhelper-addressrelay-agent-option
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable show
57
cable show
This command displays configuration data about the cable interface specified by the interface cable command.
cable show is a command within the interface cable sub-mode and requires read-write privilege.
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 2/1↵G10$root(config-if-c2/1)# cable show↵
IfIndex : 6
Insertion Interval : 10
Ranging Attempts : 16
Sync Interval : 5
Ucd Interval : 1000
Data for the cable interface at slot 2 / interface 1 is displayed.
cable shared-secret
This command is used to specify an authentication string that is shared between a server that provides a cable modem’s configuration file and the CMTS. This string is used by the CMTS during the provisioning to authenticate that the configuration parameters in the cable modem’s Registration Request (REG-REQ) are from a trusted source.
cable shared-secret is a command in the configure terminal mode and requires read-write privilege.
no cable shared-secret disables authentication during cable modem registration.
By default, authentication is disabled during cable modem registration.
Syntax
cable shared-secret <secret-string>
no cable shared-secret
cable shared-secret show
Definitions
secret-string Specifies the authentication string, up to a maximum of 64 text characters
show Displays the shared secret.
cable source-verify
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference58
Examples
G10$root# configure terminal↵G10$root(config)# cable shared-secret xyz*559$2↵
The shared secret authentication string is xyz*559$2.
G10$root(config)# cable shared-secret show↵
Shared-secret is: xyz*559$2
Related Commands
show cable shared-secret
cable source-verify
This command enables IP verification—also referred to as IP authentication. All IP packets are checked against an address verification table that contains the correspondence between a CM’s IP address, MAC address, and internal CM ID. There are three possible outcomes of the address verification check:
1. If the source IP address of an IP packet is found in the address verification table, and the source MAC address and CM ID match those in the table entry, the packet is considered valid and the CMTS forwards it.
2. If the source IP address of an IP packet is found in the address verification table, and the source MAC address and/or CM ID do not match those in the table entry, the packet is considered invalid and the CMTS unconditionally drops it.
3. If the source IP address of an IP packet is not found in the address verification table, the packet is considered unverifiable. By default, unverifiable IP packets are forwarded unless the cable drop-unverifiable-addresses command enables the dropping of these packets.
cable source-verify is a command within the configure terminal mode and requires read-write privilege.
no cable source-verify disables IP packet verification. DHCP lease queries are no longer issued, regardless of the previous state of the lease query.
By default, IP packet verification is disabled.
Syntax
cable source-verify [DHCP]
no cable source-verify
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable subscriber-group
59
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# cable source-verify↵
Verify all IP packets (without DHCP lease query).
Related Commands
arpcable address-verificationcable arp-verifycable broadcast-domaincable ip-broadcast-echocable ip-multicast-echocable proxy-arpclear arp-cacheshow cable address-verificationshow ip arp
Guidance
This command enables address verification for IP packets only. Generally, if IP packet verification is enabled, ARP packet verification should also be enabled (refer to the cable arp-verify command).
cable subscriber-group
This command is used to define a subscriber group that represents a collection of CMs and CPEs. All CMs and CPEs that reside in the same subscriber group use the DHCP-related parameters assigned while in the subscriber group sub-mode. These parameters are assigned with the subscriber group sub-mode commands dhcp-giaddr, helper-address, and relay-agent-option. The basic underlying functionality of these commands is the same as the cable dhcp-giaddr, cable helper-address, and cable relay-agent-option commands, respectively.
Every subscriber group created on a cable interface must be assigned a GIADDR, and the IP address used must be from the same subnet assigned to the CMs in that subscriber group.
DHCP If DHCP is specified and the source IP address of the IP packet cannot be found in the address verification table, the CMTS issues DHCP lease queries to attempt to learn the association between the IP address, the MAC address, and the CM. The address verification table is updated accordingly.
There is a performance impact when IP address verification is enabled.
cable subscriber-group
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference60
Any DHCP configuration performed at the interface cable sub-mode level applies to what is known as the default subscriber group for that slot/interface.
Refer to the Juniper Networks G10 CMTS Operations and Maintenance manual for provisioning examples and more information regarding DHCP-related configuration.
cable subscriber-group is a command within the interface cable sub-mode and requires read-write privilege.
A maximum of four subscriber groups can be created for each cable interface.
no cable subscriber-group removes the subscriber group, including the configuration performed under that group.
Syntax
cable subscriber-group <group-name>
no cable subscriber-group <group-name>
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 2/1↵G10$root(config-if-c2/1)# cable subscriber-group ISP1↵G10$root(config-if-c2/1-sgrp)# dhcp-giaddr 10.22.3.4↵G10$root(config-if-c2/1-sgrp)# helper-address 192.168.23.45 10.22.3.1↵G10$root(config-if-c2/1-sgrp)# relay-agent-option↵
Defines and configures the subscriber group ISP1 under slot 2 / interface 1. A GIADDR of 10.22.3.4 is used for both CMs and CPEs. The DHCP server IP address is 192.168.23.45, but since it is not on the FastEthernet port associated with this cable interface, a next-hop IP address of 10.22.3.1 is specified. The relay agent option is used for DHCP-Bootrequest messages.
G10$root# configure terminal↵G10$root(config)# interface cable 2/1↵G10$root(config-if-c2/1)# no cable subscriber-group ISP1↵
Removes the subscriber group ISP1, including the configuration performed under this group.
Related Commands
cable dhcp-giaddrcable helper-addresscable relay-agent-optiondhcp-giaddrhelper-address
group-name Alphanumeric string that specifies the group name.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable sync-interval
61
relay-agent-option
cable sync-interval
This command sets the DOCSIS Sync Interval for those cable modems on the targeted interface. This interval is defined as the nominal time between the transmission of SYNC messages from the CMTS.
cable sync-interval is a command within the interface cable sub-mode and requires read-write privilege.
no cable sync-interval resets the Sync interval to the default.
The default Sync interval is 5 milliseconds.
Syntax
cable sync-interval <interval>
no cable sync-interval
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable sync-interval 20↵
Set the Sync interval for slot 4 / interface 1 to 20 milliseconds.
Related Commands
show running-config
cable ucd-interval
This command defines the interval between the transmission of Upstream Channel Descriptor (UCD) messages scheduled by the CMTS for the targeted interface. UCD messages must be periodically transmitted by the CMTS to define the channel and burst characteristics of an upstream channel. Examples of channel parameters include symbol rate, frequency, and preamble pattern. Examples of burst parameters include modulation type, differential encoding, maximum burst size, guard time size, and parameters associated with the preamble, forward error correction (FEC), and scrambler.
The cable ucd-interval command is a command within the interface cable sub-mode and requires read-write privilege.
interval Number of milliseconds between 1 and 200, assigned to the Sync interval
cable upstream add
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference62
The default interval is 1000 milliseconds.
no cable ucd-interval resets the interval to the default.
Syntax
cable ucd-interval <interval>
no cable ucd-interval
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable ucd-interval 100↵
Set the interval between UCD messages for slot 4 / interface 1 to 100 milliseconds.
Related Commands
cable modulation-profileshow running-config
cable upstream add
This command adds the given upstream channel to the targeted cable interface.
cable upstream add is a command within the interface cable sub-mode and requires read-write privilege.
no cable upstream add removes the given upstream channel from the targeted cable interface.
Refer to “Configuration Notes” on page 191 for the default upstream channel assignment for 8-channel and 16-channel DOCSIS Modules.
Syntax
cable upstream <channel> add
no cable upstream <channel> add
interval The number of milliseconds (1 to 2000) between UCD messages
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable upstream channel-hopping
63
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 2/0↵G10$root(config-if-c2/0)# cable upstream 4 add↵G10$root(config-if-c2/0)# no cable upstream 4 shutdown↵
Add upstream channel 4 to slot 2 / interface 0, then enable the channel.
Related Commands
cable downstream addcable upstream show
Guidance
After adding a channel to a slot/interface, the channel must be enabled into service by executing the no cable upstream shutdown command.
cable upstream channel-hopping
The G10 CMTS uses its integrated spectrum analyzer to implement a feature called Upstream Channel Monitoring (UCM). UCM allows the G10 CMTS to monitor the noise power for the frequency band allocated to an upstream channel, and automatically adjust the channel location, width, and modulation profile with the intent of maximizing the channel’s throughput. These adjustments—referred to as channel hopping, channel width control, and channel modulation control—are enabled and occur independently of each other.
The cable upstream channel-hopping command enables channel hopping for the specified channel to a new location on the same port defined by the cable upstream-port spare command.
cable upstream channel-hopping is a command within the interface cable sub-mode and requires read-write privilege.
no cable upstream channel-hopping disables channel hopping for the specified channel.
An upstream channel will only exist in its original location or in a spare location. Existing upstream channels will not be swapped.
If channel width control is not enabled, a spare channel can only be used if its width is greater than or equal to the original channel width. If the spare channel width is greater than the original channel width, the resulting frequency of the channel moved into the spare slot is chosen to maximize the signal-to-noise ratio (which may be different than the center frequency specified in the cable upstream-port spare command).
channel The channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) that is assigned to the cable interface. This channel is in the slot/if specified in the interface cable command.
cable upstream channel-width
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference64
Syntax
cable upstream <channel> channel-hopping
no cable upstream <channel> channel-hopping
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable upstream 2 channel-hopping↵
Enables channel hopping for channel 2 on slot 4 / interface 1.
Related Commands
cable upstream-port sparecable upstream modulation-controlcable upstream width-control
cable upstream channel-width
This command sets the channel width for an upstream channel in the targeted slot/interface.
cable upstream channel-width is a command within the interface cable sub-mode and requires read-write privilege.
no cable upstream channel-width sets the upstream channel-width to the default value.
The default settings for this command is 1600000 Hz.
Syntax
cable upstream <channel> channel-width <width>
no cable upstream <channel> channel-width
channel The channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) for which channel hopping is enabled.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable upstream concatenation
65
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable upstream 2 channel-width 400000↵
The upstream channel width for channel 2 in slot 4 / interface 1 is set to 400 KHz.
Related Commands
cable upstream show
cable upstream concatenation
This command enables the deconcatenation of concatenated MAC frames transmitted by CMs on the given upstream channel on the targeted slot/interface. Concatenation allows a CM to transmit multiple MAC frames in a single transmit opportunity. The PHY overhead, such as the preamble, guard time, and any zero-fill bytes, as well as the Concatenation MAC Header occur only once for the concatenated transmission.
cable upstream concatenation is a command within the interface cable sub-mode and requires read-write privilege.
no cable upstream concatenation disables concatenation for the given upstream channel on the targeted cable interface.
By default, concatenation is enabled for all upstream channels.
Syntax
cable upstream <channel> concatenation
no cable upstream <channel> concatenation
Definitions
channel The channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) for which the width is being set. This channel is in the slot/if specified in the interface cable command.
width The channel width (in Hz) of the channel being set. Choices are: 200000, 400000, 800000, 1600000, and 3200000.
channel The channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) for which concatenation is enabled or disabled. This channel is in the slot/if specified in the interface cable command.
cable upstream data-backoff
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference66
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 2/0↵G10$root(config-if-c2/0)# cable upstream 4 concatenation↵
Enable concatenation on upstream channel 4 on slot 2 / interface 0.
Related Commands
cable upstream show
cable upstream data-backoff
This command establishes a range of values a cable modem will use when it needs to defer (back-off) opportunities for transmission of a bandwidth request or packet in a contention region. This information is in the Bandwidth Allocation Map.
The number of times a CM will attempt to transmit a request or packet in contention is fixed at 16. The start and end parameters of this command define intervals between attempts. The CM randomly chooses a value from within a window that defines the number of transmit opportunities it will defer. If the first transmission attempt is not successful, the size of the window is increased for the second attempt, and again for the third attempt, and so forth for the remaining attempts. The values in the window are the number of transmit opportunities that will be deferred.
The window of values always begins with 0. The window for the first attempt stops with the value [2x–1], where X = start parameter. If a second attempt is needed, the window of values stops at [2x+1–1]. The exponent continues to increment by one until it equals the number in the end parameter. The size of the window will not increase for any subsequent transmit attempts.
cable upstream data-backoff is a command within the interface cable sub-mode and requires read-write privilege.
no cable upstream data-backoff allows the CMTS to dynamically vary the upstream data backoff start and stop values.
The default setting is the no form of this command.
Syntax
cable upstream <channel> data-backoff <start> <end>
no cable upstream <channel> data-backoff
Definitions
channel The upstream channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) for which the data backoff parameters are to be set. This channel is in the slot/if specified in the interface cable command.
start Indicates upper limit of the random backoff window for the first attempt (0 to 15).
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable upstream force
67
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable upstream 2 data-backoff 5 10↵
Sets the start and end data-backoff parameters of channel 2 on slot 4 / interface 1 to 5 and 10, respectively.
Guidance
Based on a truncated binary exponential backoff, DOCSIS specifies a method to resolve contention in data and request transmission opportunities. The initial backoff window (start) and final backoff window (end) values are specified as part of the Bandwidth Allocation Map message and controlled by the CMTS. Each value represents a power of two, so that a value of 4 represents a window between 0 and 15 (24 = 16 window).
cable upstream force
When a change is made to an Upstream Channel Descriptor (UCD), the G10 CMTS will normally reject any UCD changes that make it impossible to maintain active service flow guarantees (such as a reduction in the width of a channel). This command allows you to unconditionally change UCD parameters without rejection. Issuing this command may cause service flows to be dropped, including the possibility that some CMs may lose their registration.
cable upstream force is a top-level command and requires read-write privilege.
Any combination of the parameters following the force keyword can be specified (in the order shown).
Syntax
cable upstream slot <slot> channel <channel> force [channel-width <width>] [frequency <frequency>] [minislot-size <minislot-size>] [modulation-profile <profile-id>]
Definitions
end Indicates maximum upper limit of the random backoff window for subsequent attempts (0 to 15). Must be equal to or larger than start value.
slot Chassis slot number of the DOCSIS Module on which the specified channel resides. (1 to 4 or 10 to 13). See the diagram in “Slot Numbers” on page 191.
channel The channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) corresponding to the UCD.
channel-width Specifies that the channel width in the UCD will be changed.
width The channel width (in Hz) of the reserved upstream channel. Choices are: 200000, 400000, 800000, 1600000, and 3200000.
frequency Specifies that the frequency in the UCD will be changed.
cable upstream frequency
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference68
Examples
G10$root# cable upstream slot 4 channel 3 force channel-width 1600000↵
Force the channel width in the UCD for channel 3 on the DOCSIS Module in slot 4 to be 1.6 MHz.
Related Commands
cable upstream channel-widthcable upstream frequencycable upstream minislot-sizecable upstream modulation-profile
cable upstream frequency
This command sets a fixed frequency for a channel in the specified slot/interface.
cable upstream frequency is a command within the interface cable sub-mode and requires read-write privilege.
no cable upstream frequency allows the CMTS to dynamically select the frequency for an upstream channel.
The default setting is the no form of this command.
Syntax
cable upstream <channel> frequency <frequency>
no cable upstream <channel> frequency
Definitions
frequency The center frequency in Hz of the upstream channel to be set.
DOCSIS: 5000000 to 42000000EuroDOCSIS: 5000000 to 65000000
minislot-size Specifies that the minislot-size in the UCD will be changed.
minislot-size The minislot size in time ticks. Valid values are 2, 4, 8, 16, 32, 64, 128.
modulation-profile Specifies that the parameters associated with the specified modulation profile will be used in the UCD.
profile-id The modulation profile ID number that was defined with the cable modulation-profile command. Valid options are numbers from 1 to 256.
channel The channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) for which the frequency is being set. This channel is in the slot/if specified in the interface cable command.
frequency The center frequency in Hz of the upstream channel to be set.
DOCSIS: 5000000 to 42000000EuroDOCSIS: 5000000 to 65000000
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable upstream-load-balance
69
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable upstream 2 frequency 32000000↵
A fixed frequency for channel 2 in slot 4 / interface 1 is set to 32 MHz.
cable upstream-load-balance
This command enables automatic upstream load balancing for cable modems based on channel width and utilization. When a cable modem first ranges, the CMTS has an opportunity to choose the upstream channel to which the cable modem is assigned. With load balancing, the CMTS will attempt to assign an upstream channel in proportion to the available bandwidth amongst available upstream channels.
cable upstream-load-balance is a command within the configure terminal sub-mode and requires read-write privilege.
no cable upstream-load-balance disables automatic load balancing.
The default setting is the no form of this command.
Syntax
cable upstream-load-balance
no cable upstream-load-balance
Examples
G10$root# configure terminal↵G10$root(config)# cable upstream-load-balance↵
Enable upstream load balancing.
cable upstream minislot-size
This command sets the minislot size for a channel in the specified slot/interface.
cable upstream minislot-size is a command within the interface cable sub-mode and requires read-write privilege.
Because the frequency parameter specifies the center frequency of the upstream channel, the G10 CMTS takes into account the channel width prior to checking the valid range of the frequency parameter. For example, specifying a center frequency of 5000000 (5 MHz) will fail the frequency range check because part of the channel would reside below 5 MHz.
cable upstream modem flap-list
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference70
no cable upstream minislot-size allows the CMTS to set the minislot size as appropriate for the configured upstream channel width.
The default setting is the no form of this command.
Syntax
cable upstream <channel> minislot-size <minislot-size>
no cable upstream <channel> minislot-size
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable upstream 2 minislot-size 16↵
The minislot size for channel 2 in slot 4 / interface 1 is set to 16 (which equals 256 symbols at a symbol rate of 2560 Ksym/sec).
cable upstream modem flap-list
This command defines flap criteria for the specified upstream channel on the targeted interface by setting various parameters (thresholds). The thresholds defined by this command override those defined by the cable modem flap-list command, which defines global threshold settings for all cable interfaces. Once a threshold has been set by the cable upstream modem flap-list command, its value is not affected by the cable modem flap-list command.
Refer to the cable modem flap-list command for details regarding the flap-list.
cable upstream modem flap-list is a command within the interface cable sub-mode and requires read-write privilege.
The no form of this command restores all, or the specified parameter, to its current global value.
channel The channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) for which the minislot size is being set. This channel is in the slot/if specified in the interface cable command.
minislot-size The minislot size in time ticks. Valid values are 2, 4, 8, 16, 32, 64, 128.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable upstream modem flap-list
71
Syntax
cable upstream <channel> modem flap-list {snr-threshold <snr-threshold>} |{mer-threshold <mer-threshold>} |{cer-threshold <cer-threshold>} |{power-adjust-threshold <power-adjust-threshold>} |{im-retry-interval <im-retry-interval>} |{sm-miss-threshold <sm-miss-threshold>} |{show}
no cable upstream <channel> modem flap-list [snr-threshold|mer-threshold|cer-threshold|power-adjust-threshold|im-retry-interval|sm-miss-threshold]
Definitions
channel The upstream channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) to which the specified threshold applies. This channel is in the slot/if specified in the interface cable command.
snr-threshold A flap occurs when the measured SNR of a CM drops below this threshold (specified in dB). The valid range is 1–100 and the default is 18.
mer-threshold A flap occurs when the measured Modulation Error Rate (MER) of a CM drops below this threshold (specified in dB). The valid range is 1–100 and the default is 18.
cer-threshold A flap occurs when the measured Codeword Error Rate (CER) of a CM rises above this threshold (specified in units of 10-6). The CER is the ratio of the number of codewords received with errors, before error correction is attempted, and the total number of codewords received (with and without errors). The valid range is 1–1000000 and the default is 1 (1 x 10-6).
power-adjust-threshold A flap occurs when the power adjustment sent to the CM during station maintenance is above this threshold (specified in dB). The valid range is 1–100 and the default is 3.
im-retry-interval A flap occurs when the time between two successive initial maintenance attempts by a particular CM is below this threshold (specified in seconds). The valid range is 60–86400 and the default is 180.
sm-miss-threshold A flap occurs when the number of consecutively missed station maintenance opportunities by a particular CM is above this threshold, and the CMTS subsequently receives a successful ranging request from the CM (this latter condition is required to discern whether the CM is missing station maintenance opportunities or is off-line). The valid range is 1–100 and the default is 2.
show Displays the current value of each flap-list parameter. A value followed by * indicates that the global threshold was overridden by the cable upstream modem flap-list command.
Tuning the flap thresholds is recommended to minimize the number of irrelevant entries in the flap-list.
cable upstream modulation-control
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference72
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable upstream 2 modem flap-list snr-threshold 20↵
Set the SNR threshold for all CMs on channel 2 of slot 4 / interface 1 to 20 dB.
G10$root(config-if-c4/1)# no cable upstream 2 modem flap-list snr-threshold↵
Restore the SNR threshold for all CMs on channel 2 of slot 4 / interface 1 to its previous global value.
G10$root(config-if-c4/1)# no cable upstream 2 modem flap-list↵
Restore all thresholds for all CMs on channel 2 of slot 4 / interface 1 to their previous global values.
Related Commands
cable modem flap-listclear cable modem flap-listshow cable flap-list
cable upstream modulation-control
The G10 CMTS uses its integrated spectrum analyzer to implement a feature called Upstream Channel Monitoring (UCM). UCM allows the G10 CMTS to monitor the noise power for the frequency band allocated to an upstream channel, and automatically adjust the channel location, width, and modulation profile with the intent of maximizing the channel’s throughput. These adjustments—referred to as channel hopping, channel width control, and channel modulation control—are enabled and occur independently of each other.
The cable upstream modulation-control command enables channel modulation control for the specified channel.
cable upstream modulation-control is a command within the interface cable sub-mode and requires read-write privilege.
no cable upstream modulation-control disables channel modulation control for the specified channel.
Syntax
cable upstream <channel> modulation-control
no cable upstream <channel> modulation-control
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable upstream modulation-profile
73
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable upstream 2 modulation-control↵
Enables channel modulation control for channel 2 on slot 4 / interface 1.
Related Commands
cable upstream-port sparecable upstream channel-hoppingcable upstream width-control
cable upstream modulation-profile
This command assigns a modulation profile to a channel in the specified slot/interface. Modulation profiles are defined with the cable modulation-profile command in the configure terminal mode.
cable upstream modulation-profile is a command within the interface cable sub-mode and requires read-write privilege.
no cable upstream modulation-profile assigns the default profile to the channel.
The default setting is the no form of this command.
Syntax
cable upstream <channel> modulation-profile <profile-id>
no cable upstream <channel> modulation-profile
Definitions
channel The channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) for which channel modulation control is enabled.
channel The channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) to which the modulation profile is being assigned. This channel is in the slot/if specified in the interface cable command.
profile-id The modulation profile ID number that was defined with the cable modulation-profile command. Valid options are numbers from 1 to 256.
cable upstream noise-cancellation
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference74
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable upstream 2 modulation-profile 2↵
The modulation profile with ID number 2 is assigned to channel 2 in slot 4 / interface 1.
Related Commands
cable modulation-profile
cable upstream noise-cancellation
This command enables the noise cancellation feature of the Broadband Cable Processor ASIC.
cable upstream noise-cancellation is a command within the configure terminal mode and requires read-write privilege.
no cable upstream noise-cancellation disables noise cancellation.
By default, noise cancellation is enabled.
Syntax
cable upstream noise-cancellation
no cable upstream noise-cancellation
Examples
G10$root# configure terminal↵G10$root(config)# cable upstream noise-cancellation↵
Enables the noise cancellation feature of the Broadband Cable Processor ASIC.
Noise cancellation should always remain enabled under normal operational conditions. The ability to disable noise cancellation is provided to facilitate the evaluation of this feature.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable upstream-port spare
75
cable upstream-port spare
The G10 CMTS uses its integrated spectrum analyzer to implement a feature called Upstream Channel Monitoring (UCM). UCM allows the G10 CMTS to monitor the noise power for the frequency band allocated to an upstream channel, and automatically adjust the channel location, width, and modulation profile with the intent of maximizing the channel’s throughput. These adjustments—referred to as channel hopping, channel width control, and channel modulation control—are enabled and occur independently of each other.
The cable upstream-port spare command reserves spare channels on the specified slot and port that are used to support channel hopping. Channel overlap is checked against existing channels and other spares on the specified port.
cable upstream-port spare is a command within the configure terminal mode and requires read-write privilege.
no cable upstream-port spare can remove a specified spare channel, or remove all spare channels on a specified port.
An upstream channel will only exist in its original location or in a spare location. Existing upstream channels will not be swapped.
If channel width control is not enabled, a spare channel can only be used if its width is greater than or equal to the original channel width. If the spare channel width is greater than the original channel width, the resulting frequency of the channel moved into the spare slot is chosen to maximize the signal-to-noise ratio (which may be different than the center frequency specified in the cable upstream-port spare command).
Syntax
cable upstream-port slot <slot> port <port> spare center-frequency <frequency> width <width>
no cable upstream-port slot <slot> port <port> spare center-frequency <frequency>
Removes the specified spare channel.
no cable upstream-port slot <slot> port <port> spare
Removes all spare channels on the specified port.
Definitions
Once a spare channel is reserved, the G10 CMTS begins monitoring the noise power of that spare channel. Minimize the number of spare channels reserved to ensure that the performance of the CMTS is not severely impacted.
slot Chassis slot number of the DOCSIS Module on which spare channels are reserved. (1 to 4 or 10 to 13). See the diagram in “Slot Numbers” on page 191.
port The US port (0 to 3) on the HFC Connector Module on which spare channels are reserved.
cable upstream port
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference76
Examples
G10$root# configure terminal↵G10$root(config)# cable upstream-port slot 4 port 3 spare center-frequency 19000000 width 1600000↵
Reserve a spare channel on port 3 of the HFC Connector Module in slot 4. Frequency is 19 MHz. Channel width is 1.6 MHz.
Related Commands
cable upstream channel-hoppingcable upstream modulation-controlcable upstream width-control
cable upstream port
This command associates an upstream channel with a physical upstream (US) port on the HFC Connector Module. You may associate more than one channel with any of the four upstream ports. See Appendix B, “Configuration Notes”, for more information.
cable upstream port is a command within the interface cable sub-mode and requires read-write privilege.
On a DOCSIS Module that supports 8 upstream channels, the default association of cable interfaces to US ports and channels is:
frequency The center frequency in Hz of the reserved upstream channel.
DOCSIS: 5000000 to 42000000EuroDOCSIS: 5000000 to 65000000
width The channel width (in Hz) of the reserved upstream channel. Choices are: 200000, 400000, 800000, 1600000, and 3200000.
Cable Interface Upstream Channel Upstream Port
0 0 US 0
1
1 2 US 1
3
2 4 US 2
5
3 6 US 3
7
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable upstream power-level
77
On a DOCSIS Module that supports 16 upstream channels, the default association of cable interfaces to US ports and channels is:
Syntax
cable upstream <channel> port <port>
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable upstream 2 port 2↵
Upstream channel 2 on slot 4 / interface 1 is assigned to upstream port 2.
cable upstream power-level
This command sets the input power level for a channel in the specified slot/interface.
cable upstream power-level is a command within the interface cable sub-mode and requires read-write privilege.
Cable Interface Upstream Channel Upstream Port
0
0
US 01
8
9
1
2
US 13
10
11
2
4
US 25
12
13
3
6
US 37
14
15
channel The channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) that is being associated to a port. This channel is in the slot/if specified in the “interface cable” command.
port The US port (0 to 3) on the HFC Connector Module to which the channel is associated.
cable upstream-pre-equalization
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference78
no cable upstream power-level sets the input power level to the default.
The default is 0 dBmV.
Syntax
cable upstream <channel> power-level <power-level>
no cable upstream <channel> power-level
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable upstream 2 power-level 5↵
The input power level for channel 2 in slot 4 / interface 1 is set to 5 dBmV.
cable upstream-pre-equalization
Upstream pre-equalization is a technique used by the G10 CMTS to compensate for various distortions present in the return path. The DOCSIS 1.1 specification states that CM transmitters must have a symbol (T)-spaced equalizer structure with 8 taps. In response to an initial ranging request and periodic ranging requests from the CM, the CMTS evaluates the distortions in the return path, computes the set of pre-equalizer coefficients, and returns them back to the CM in the ranging response messages.
cable upstream-pre-equalization is a command within the configure terminal mode and requires read-write privilege.
no cable upstream-pre-equalization disables pre-equalization.
The default is disabled.
Syntax
cable upstream-pre-equalization
no cable upstream-pre-equalization
channel The channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) for which the power level is being set. This channel is in the slot/if specified in the “interface cable” command.
power-level The input power level in dBmV. Range is -10 to +25 dBmV.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable upstream range-backoff
79
Examples
G10$root# configure terminal↵G10$root(config)# cable upstream-pre-equalization↵
Enable upstream pre-equalization.
cable upstream range-backoff
This command establishes a range of values a cable modem will use when it needs to defer (back-off) opportunities for transmission of a ranging request in an Initial Maintenance contention region. This information is in the Bandwidth Allocation Map.
The number of times a CM will attempt to transmit a request or packet in contention is fixed at 16. The start and end parameters of this command define intervals between attempts. The CM randomly chooses a value from within a window that defines the number of transmit opportunities it will defer. If the first transmission attempt is not successful, the size of the window is increased for the second attempt, and again for the third attempt, and so forth for the remaining attempts. The values in the window are the number of transmit opportunities that will be deferred.
The window of values always begins with 0. The window for the first attempt stops with the value [2x–1], where X = start parameter. If a second attempt is needed, the window of values stops at [2x+1–1]. The exponent continues to increment by one until it equals the number in the end parameter. The size of the window will not increase for any subsequent transmit attempts.
cable upstream range-backoff is a command within the interface cable sub-mode and requires read-write privilege.
no cable upstream range-backoff allows the CMTS to dynamically vary the upstream range backoff start and stop values.
The default setting is the no form of this command.
Syntax
cable upstream <channel> range-backoff <start> <end>
no cable upstream <channel> range-backoff
Definitions
channel The upstream channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) for which the range backoff parameters are to be set. This channel is in the slot/if specified in the interface cable command.
start Indicates upper limit of the random backoff window for the first attempt (0 to 15).
end Indicates maximum upper limit of the random backoff window for subsequent attempts (0 to 15). Must be equal to or larger than start value.
cable upstream show
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference80
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable upstream 2 range-backoff 5 10↵
Sets the start and end range-backoff parameters of channel 2 on slot 4 / interface 1 to 5 and 10, respectively.
Guidance
Based on a truncated binary exponential backoff, DOCSIS specifies a method to resolve contention in Initial Maintenance transmission opportunities. The initial backoff window (start) and final backoff window (end) values are specified as part of the Bandwidth Allocation Map message and controlled by the CMTS. Each value represents a power of two, so that a value of 4 represents a window between 0 and 15 (24 = 16 window).
cable upstream show
This command displays the upstream channel information for a specified slot/interface.
cable upstream show is a command within the interface cable sub-mode and requires read-write privilege.
This command does not have a no form.
There are no default settings for this command.
Syntax
cable upstream <channel> show
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 2/0↵G10$root(config-if-c2/0)# cable upstream 1 show↵
Cable 2/0: Upstream 1 is up
Received 10 broadcast, 0 multicasts, 14044 unicasts
0 discards, 0 errors, 0 unknown protocol
14054 packets input, 0 uncorrectable
301 noise, 0 microreflections
Cable modem information for channel 1 in slot 2 / interface 0 is displayed.
channel The channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) for which information will be displayed. This channel is in the slot/if specified in the interface cable command.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cable upstream shutdown
81
cable upstream shutdown
This command disables an upstream channel in the specified slot/interface.
cable upstream shutdown is a command within the interface cable sub-mode and requires read-write privilege.
no cable upstream shutdown enables the channel.
The channels are disabled by default.
Syntax
cable upstream <channel> shutdown
no cable upstream <channel> shutdown
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# no cable upstream 2 shutdown↵
Channel 2 in slot 4 / interface 1 is enabled.
Related Commands
cable downstream shutdownshutdown
cable upstream width-control
The G10 CMTS uses its integrated spectrum analyzer to implement a feature called Upstream Channel Monitoring (UCM). UCM allows the G10 CMTS to monitor the noise power for the frequency band allocated to an upstream channel, and automatically adjust the channel location, width, and modulation profile with the intent of maximizing the channel’s throughput. These adjustments—referred to as channel hopping, channel width control, and channel modulation control—are enabled and occur independently of each other.
The cable upstream width-control command enables channel width control for the specified channel. Channel width control typically affects a channel’s width and its frequency. If channel hopping is disabled, any frequency change is limited to the channel’s current slot.
cable upstream width-control is a command within the interface cable sub-mode and requires read-write privilege.
channel The channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) that will be enabled or disabled. This channel is in the slot/if specified in the interface cable command.
cable vpn
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference82
no cable upstream width-control disables channel width control for the specified channel.
If channel width control and channel hopping are enabled, a spare channel can be used even if its width is less than the original channel width.
Syntax
cable upstream <channel> width-control
no cable upstream <channel> width-control
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable upstream 2 width-control↵
Enables channel width control for channel 2 on slot 4 / interface 1.
Related Commands
cable upstream-port sparecable upstream channel-hoppingcable upstream modulation-control
cable vpn
This command assigns the CPE devices behind a CM to a cable Virtual Private Network (VPN). A CPE can only be part of one VPN, so a second instance of this command overrides the previous VPN ID. This command does not ensure the VPN is private, so BPI (or BPI+) must be enabled within the CM’s configuration file if privacy on the VPN is desired.
VPNs are implemented using 802.1Q VLAN tags. Upstream packet normally arrive at the CMTS untagged. However, the CPE may elect to send 802.1Q tagged packets. If the tag does not match the vpn-id assigned to the CPE, the packet is dropped. Otherwise, the packet is forwarded. All downstream packets are always transmitted untagged.
A CM may also be provisioned as a member of a VPN by inclusion of a Juniper Networks TLV in the CM configuration file. Refer to the Juniper Networks G10 CMTS Operations and Maintenance manual for more details.
cable vpn is a command within the configure terminal mode and requires read-write privilege.
no cable vpn removes a specified CM from a VPN.
channel The channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model) for which channel width control is enabled.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
cat
83
By default, a CM does not belong to a VPN unless it is provisioned as such.
Syntax
cable vpn <mac-address> <vpn-id>
no cable vpn <mac-address>
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# cable vpn 1234.5678.9ABC 129↵
Assign the CM with the MAC address of 1234.5678.ABCD to VPN ID 129.
Related Commands
show cable vpn
Guidance
The cable vpn command overrides any VPN provisioning through a CM configuration file.
cat
This command displays the entire contents of a file without stopping until the end of the file is reached.
cat is a top-level command and requires read-only privilege.
Syntax
cat <file-name>
mac-address The MAC address of the CM specified as xxxx.xxxx.xxxx in hexadecimal.
vpn-id The ID used to specify the VPN to which the CM is assigned. This is used to add VLAN tags to the packets. Valid range is 129–4000.
It is important to note that the mac-address specified in this command is the MAC address of the CM (not the MAC address of the CPE).
cd
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference84
Definitions
Examples
G10$root> cat README↵
Displays the entire contents of the file README.
Related Commands
dirmkdirmorepwd
cd
This command changes the current working directory. By default, the current working directory becomes the prefix for all relative paths. For absolute paths, specify the current working directory with a slash.
cd is a top-level command and requires read-only privilege.
This command does not have a no form.
There are no default settings for this command.
Syntax
cd [dir-name]cd ..
Definitions
Examples
G10$root> cd temp↵
The current working directory is changed to the temp directory using a relative path. The temp directory must be under the current location.
file-name Name of the file to be displayed. May include the path to the file.
dir-name The name of the target directory. If omitted, the current working directory will change into the home directory (/home).
.. The target directory is one level up from the current working directory.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
change-password
85
G10$root> cd /home/temp↵
The current working directory is changed to the temp directory using an absolute path.
Related Commands
lsmkdirpwdrmdir
change-password
The command allows the current user to change their password.
change-password is a top-level command and is available to all users.
This command does not have a no form.
Examples
G10$root> change-password↵G10$root> Old password:G10$root> New password:G10$root> New password again:
chassis environment ambient-temperature
This command sets internal chassis temperature thresholds that determine when SNMP messages are sent to the NMS. When the chassis temperature crosses above the high threshold, the CMTS sends a warning message to the NMS. When the chassis temperature crosses below the low threshold, the CMTS sends an informational message to the NMS. SNMP message generation only occurs for unidirectional transitions across a threshold.
chassis environment ambient-temperature is a command within the configure terminal mode and requires read-write privilege.
The high-threshold and low-threshold parameters default to 60°C and 40°C, respectively.
Syntax
chassis environment ambient-temperature {user-high-threshold <high-threshold>} | {user-low-threshold <low-threshold>}
The SNMP message generation produced by this command is independent of the message generation produced by the Chassis Control Module when the temperature crosses its internally-defined thresholds.
clear aborted-modems
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference86
Definitions
Examples
G10$root# chassis environment ambient-temperature user-high-threshold 55↵
Sets the high temperature threshold at 55°C. If the chassis temperature crosses above this threshold, the CMTS sends a warning message to the NMS.
G10$root# chassis environment ambient-temperature user-low-threshold 42↵
Sets the low temperature threshold at 42°C. If the chassis temperature crosses below this threshold, the CMTS sends an informational message to the NMS.
Related Commands
show chassis environmentshow chassis hardware
clear aborted-modems
This command removes all CM entries from the G10 CMTS database that correspond to the operational states destroyed and ranging-aborted as displayed by the show cable modem command. If such a CM attempts to perform initial ranging again, it will be added back to the CMTS database and its status can be determined by the show cable modem command.
clear aborted-modems is a top-level command and requires read-write privilege.
This command has no parameters.
Syntax
clear aborted-modems
Examples
G10$root# clear aborted-modems↵
Remove all destroyed and ranging-aborted CM entries from the CMTS database.
Related Commands
show cable modem
user-high-threshold Indicates the command is setting the high temperature threshold.
high-threshold The high temperature threshold, in degrees C. The default is 60°C.
user-low-threshold Indicates the command is setting the low temperature threshold.
low-threshold The low temperature threshold, in degrees C. The default is 40°C.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
clear alarms
87
clear alarms
This command turns off the Minor, Major, and Crit LEDs on the Chassis Control Module front panel. These LEDs are illuminated when events occur that correspond to these LED levels. Table 2 provides the correspondence between the event priority and the LED that is illuminated. Refer to the log-level show and show local-log commands for more information related to events and their priorities.
Table 2: Event Priority Correspondence to CCM LEDs
clear alarms is a top-level command and requires read-write privilege.
If no optional parameters are specified, then all three event LEDs are turned off.
Any combination of event LEDs can be turned off by specifying one or more optional parameters in the order shown below.
Syntax
clear alarms [minor] [major] [critical]
Definitions
Examples
G10$root# clear alarms↵
Turns off all three event LEDs on the Chassis Control Module front panel.
G10$root# clear alarms minor major↵
Turns off the Minor and Major LEDs on the Chassis Control Module front panel. The Crit LED is not affected.
Event Priority LED
Emergency Crit
Alert Crit
Critical Crit
Error Major
Warning —
Notice —
Informational —
Debug —
minor Turn off the Minor LED of the Chassis Control Module.
major Turn off the Major LED of the Chassis Control Module.
critical Turn off the Crit LED of the Chassis Control Module.
clear arp-cache
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference88
Related Commands
log-level showshow local-log
clear arp-cache
This command removes all dynamic entries from the ARP (Address Resolution Protocol) table. Static ARP entries are not affected by this command (the no arp command must be used to remove static ARP entries individually by IP address).
clear arp-cache is a top-level command and requires read-write privilege.
This command has no parameters.
Syntax
clear arp-cache
Examples
G10$root# clear arp-cache↵
All dynamic entries are removed from the ARP table.
Related Commands
arparp timeoutcable address-verificationcable proxy-arpcable vpnshow ip arp
clear cable modem
If the optional parameter cpe is not specified, this command instructs the CMTS to stop sending periodic station maintenance MAP messages to the specified CM. This causes the CM to timeout within 30 seconds and to reinitialize its MAC. If the optional parameter cpe is specified, this command clears the table of known CPEs associated with the specified CM.
clear cable modem is a top-level command and requires read-write privilege.
Syntax
clear cable modem {<ip-address>|<mac-address>} [cpe]
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
clear cable modem flap-list
89
Definitions
Examples
G10$root> clear cable modem 110.155.27.45↵
Forces the CM at IP address 110.155.27.45 to reinitialize its MAC.
G10$root> clear cable modem 110.155.27.45 cpe↵G10$root> clear cable modem 00D0.59FD.F52F cpe↵
Clears the tables of known CPEs associated with CMs at IP address 110.155.27.45 and MAC address 00D0.59FD.F52F.
Related Commands
clear cable modemcpe-controlled-cable-modemshow cable modem
clear cable modem flap-list
This command removes a single or all CMs from the flap-list. Refer to the cable modem flap-list command for details regarding the flap-list.
clear cable modem flap-list is a top-level command and requires read-write privilege.
If the optional parameter mac-address is not specified, all CM entries are removed from the flap-list.
Syntax
clear cable modem [<mac-address>] flap-list
Definitions
ip-address The IP address of the cable modem. Standard dot-quad notation (xxx.xxx.xxx.xxx).
mac-address The MAC address of the cable modem. Specified as xxxx.xxxx.xxxx in hexadecimal.
cpe Clears the table of known CPEs associated with the specified CM.
mac-address The MAC address of the cable modem to be removed specified as xxxx.xxxx.xxxx in hexadecimal.
clock
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference90
Examples
G10$root# clear cable modem 1234.5678.9ABC flap-list↵
Remove the CM with MAC address 1234.5678.9ABC from the flap-list.
G10$root# clear cable modem flap-list↵
Remove all CM entries from the flap-list.
Related Commands
cable modem flap-listcable upstream modem flap-listshow cable flap-list
clock
This command sets the clock time or adjusts the current time of the system clock. If the usage of the NTP server clock has been enabled, it must be disabled (by executing the no clock ntp-server command) prior to manually setting or adjusting the clock with this command.
clock is a top-level command and requires read-write privilege.
This command does not have a no form.
There are no default settings for this command.
Syntax
clock adjust <adjustment>
clock set <time> <day-of-month> <month-of-year> <year>
Definitions
Examples
G10$root# clock adjust –150↵
Adjusts the clock 2 1/2 minutes backwards.
adjustment Subtract or add time in seconds. Range is –3600 to 3600 seconds.
time Hours, minutes and seconds in 24-hour format: hhmmss
day-of-month Numerical indicator for day. Range is 1 to 31.
month-of-year Numerical indicator for month. Range is 1 to 12.
year Four digit year indicator. Range is 1971 to 2037.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
clock ntp-server
91
Related Commands
clock ntp-serverclock showclock summer-timeclock timezoneshow clock
clock ntp-server
This command specifies the IP address of the Network Time Protocol (NTP) server and enables the usage of this server for setting the CMTS system clock.
clock ntp-server is a command within the configure terminal mode and requires read-write privilege.
The no form of this command disables the usage of the NTP server as the CMTS system clock.
There are no default settings for this command.
Syntax
clock ntp-server <ip-address>
no clock ntp-server
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# clock ntp-server 192.168.201.1↵
The NTP server at IP address 192.168.201.1 is used for setting the CMTS system clock.
G10$root(config)# clock show↵
Tue Dec 11 23:05:42 UTC 2001
Tue Dec 11 15:05:42 PST 2001
ntp-server ip address: 192.168.201.1
Related Commands
clockclock showclock summer-timeclock timezoneshow clock
ip-address IP address of the NTP server to be sampled. Standard dot-quad notation (xxx.xxx.xxx.xxx).
clock show
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference92
clock show
This command displays the current time and date of the CMTS clock. The first line of the display represents the UTC time, the second line represents the local time, and the third line displays the IP address of an NTP server (if configured).
clock show is a command within the configure terminal mode and requires read-write privilege
There are no parameters with this command.
Examples
G10$root# configure terminal↵G10$root(config)# clock show↵
Tue Dec 11 23:05:42 UTC 2001
Tue Dec 11 15:05:42 PST 2001
ntp-server ip address: 192.168.201.1
Related Commands
clockclock ntp-serverclock summer-timeclock timezoneshow clock
clock summer-time
This command sets the beginning and ending dates for daylight savings time. The local clock is adjusted accordingly based the current date. This setting will have to be changed each year.
clock summer-time is a command within the configure terminal mode and requires read-write privilege.
The no form of this command disables daylight savings time.
There are no default settings for this command.
Syntax
clock summertime <time-zone> <day-start> <month-start> <hour-start> <day-end> <month-end> <hour-end>
Definitions
time-zone The name of the local time zone of the CMTS. This parameter must be alphabetic.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
clock timezone
93
Examples
G10$root# configure terminal↵G10$root(config)# clock summer-time MNT 7 4 2 27 10 2↵
Daylight Savings Time for timezone MNT is set to begin 7 April at 2 a.m. and end 27 October at 2 a.m.
Guidance
Here are the beginning and ending dates for the next several years:
2002 – Begin April 7; end October 272003 – Begin April 6; end October 262004 – Begin April 4; end October 312005 – Begin April 3; end October 30
Related Commands
clockclock ntp-serverclock showclock timezoneshow clock
clock timezone
This command adjusts the local time.
clock timezone is a command within the configure terminal mode and requires read-write privilege.
The no form of this command removes the local time setting.
Syntax
clock timezone <timezone> <hour-offset> [<min-offset>]
no clock timezone
day-start
month-start
hour-start
Numerical values for day (1 to 31), month (1 to 12) and hour (0 to 24) when Daylight Saving Time begins. For most of the USA, this is 2 a.m. on the first Sunday of April.
day-end
month-end
hour-end
Numerical values for day (1 to 31), month (1 to 12) and hour (0 to 24) when Daylight Saving Time ends. For most of the USA, this is 2 a.m. on the last Sunday of October.
configure memory
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference94
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# clock timezone PST 8↵
Define PST as the timezone, and subtract 8 hours from UTC. The clock show command would then produce the following output:
Wed Feb 13 19:50:29 UTC 2002
Wed Feb 13 11:50:29 PST 2002
ntp-server ip address:
Related Commands
clockclock ntp-serverclock showclock summer-timeshow clock
configure memory
This command copies the startup-config file to the running-config file.
configure memory is a top-level command and requires read-write privilege.
This command does not have a no form.
There are no default settings for this command.
Syntax
configure memory
timezone The arbitrary name assigned to the time zone to which the time will be adjusted (for example, PST, PDT, Eastern, Central). This parameter must be alphabetic.
hour-offset Hour offset (-12 to 12) from Coordinated Universal Time (UTC).
min-offset Minute offset (0 to 59) from Coordinated Universal Time (UTC). The default value is 0.
Specified offsets are subtracted from UTC. For example, an hour offset of 8 subtracts 8 from than the Coordinated Universal Time. An hour offset of -5 adds 5 hours to the Coordinated Universal Time.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
configure terminal
95
Examples
G10$root# configure memory↵
Copies the startup-config file to the running-config file.
Related Commands
copy
configure terminal
This command enters the configure terminal mode. You must first enter this mode to perform numerous configuration tasks. To exit the configure terminal mode, use the exit command.
configure terminal is a top-level command and requires read-write privilege.
This command does not have a no form.
There are no default settings for this command.
Syntax
configure terminal [<command>]
Definitions
Examples
G10$root# configure terminal↵G10$root(config)#
The CLI is now in the configure terminal mode.
G10$root# conf t↵G10$root(config)#
This example illustrates the usage of an abbreviated form of the command.
G10$root# configure terminal clock show↵
Executes the clock show command, which is a command in the configure terminal mode.
Tue Dec 11 23:05:42 UTC 2001
Tue Dec 11 15:05:42 PST 2001
ntp-server ip address: 192.168.201.1
command Any valid command that can be entered within the configure terminal mode.
copy
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference96
copy
This command copies a data file from a source location to a target location.
copy is a top-level command and requires read-write privilege.
This command does not have a no form.
There are no default settings for this command.
Syntax
copy <source-file> <dest-file>|<dest-dir>
Definitions
Examples
G10$root# copy testa_040101.bin testb_040101.bin↵
The file testa_040101.bin is copied to file testb_040101.bin.
G10$root# copy running-config startup-config↵
The currently-executing configuration is saved to the startup-config file (which is stored in the home directory as Startup.cli).
Related Commands
deletemkdirrenamermdirwrite memory
cpe-controlled-cable-modem
This command instructs a CM to disable its upstream transmission, or to remotely reset its MAC and re-enable its upstream transmission. A CM is disabled or reset by issuing the UP-DIS MAC management message, so the CM must support this message for this command to have any effect.
cpe-controlled-cable-modem is a top-level command and requires read-write privilege.
source-file The name of the source file to be copied. May include the path to the file.
dest-file The name of the target file to be copied to. May include the path to the file.
dest-dir The name of the target directory to be copied to.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
debug
97
Syntax
cpe-controlled-cable-modem <mac-address> disable {forever|<time-to-disable>}
cpe-controlled-cable-modem <mac-address> reset
Definitions
Examples
G10$root# cpe-controlled-cable-modem 1234.5678.9ABC disable 300↵
Disables the CM at MAC address 1234.5678.9ABC for 300 milliseconds.
G10$root# cpe-controlled-cable-modem 1234.5678.9ABC reset↵
Resets the MAC of the CM at MAC address 1234.5678.9ABC and re-enables its upstream transmission.
Related Commands
clear cable modem
debug
This command clears the list of all debug event types—such as arp, range, and ucd—that have been set by the debug commands, which effectively disables debugging. The list of MAC addresses, SIDs, and slot/interfaces to be debugged is not affected by this command. Therefore, if this command is followed by a debug command that defines an event type, then that event type will be debugged. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug is a top-level command and requires read-debug privilege.
The only form of this command is the no form.
This command behaves identically to the no debug cable command (this behavior may change in the future).
mac-address The MAC address of the CM specified as xxxx.xxxx.xxxx in hexadecimal.
disable Specifies that the CM is to be disabled.
forever Immediately and permanently disables the upstream transmitter of the CM until it is re-enabled by a power cycle or by using the reset form of this command.
time-to-disable Immediately disables the upstream transmitter of the CM for a period of time-to-disable milliseconds (valid range is 1–4294967294). After this period has elapsed, the CM reinitializes its MAC.
reset Specifies that the CM is to be reset with its upstream transmission re-enabled.
debug cable
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference98
Syntax
no debug
Examples
G10$root# no debug
Clears the list of all debugging event types.
Related Commands
debug cabledebug cable clear filterdebug cable interface cabledebug cable mac-addressshow debugging
debug cable
This command clears the list of cable debug event types—such as arp, range, and ucd—that have been set by the debug commands, which effectively disables debugging. The list of MAC addresses, SIDs, and slot/interfaces to be debugged is not affected by this command. Therefore, if this command is followed by a debug command that defines an event type, then that event type will be debugged. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable is a top-level command and requires read-debug privilege.
The only form of this command is the no form.
This command behaves identically to the no debug command (this behavior may change in the future).
Syntax
no debug cable
Examples
G10$root# no debug cable
Clears the list of cable debug event types.
Related Commands
debugdebug cable clear filterdebug cable interface cabledebug cable mac-address
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
debug cable arp
99
show debugging
debug cable arp
This command enables the display of debug messages associated with Address Resolution Protocol (ARP) events. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable arp is a top-level command and requires read-debug privilege.
The no form of this command disables debugging for ARP.
Syntax
debug cable arp
no debug cable arp
Examples
G10$root# debug cable arp
Enables debugging for ARP.
ETHERFRAME pktId = 0x00001FD6 frameLen = 60 EthernetII_(DIX)
dstMacAddr = FF:FF:FF:FF:FF:FF srcMacAddr = 00:03:E3:08:41:C9
etherType = 0x0806
ARP hardType = 0x01 protType = 0x800
hardSize = 0x06 protSize = 0x04
op = ARP_REP
sndMacAddr = 00:03:E3:08:41:C9 sndIpAddr = 10.136.2.27
tgtMacAddr = FF:FF:FF:FF:FF:FF tgtIpAddr = 10.136.2.27
crc = 0x18A6B9E3
Related Commands
debug cable dhcpdebug cable interface cabledebug cable mac-addressterminal monitorterminal speed
debug cable bpkm
This command enables the display of debug messages associated with Baseline Privacy Key Management (BPKM) messages. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable bpkm is a top-level command and requires read-debug privilege.
The no form of this command disables debugging for BPKM.
debug cable bwr
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference100
Syntax
debug cable bpkm
no debug cable bpkm
Examples
G10$root# debug cable bpkm
Enables debugging for BPKM.
Related Commands
debug cable interface cabledebug cable mac-addressdebug cable mac-protocolterminal monitorterminal speed
debug cable bwr
This command enables the display of debug messages associated with Request Frame (REQ) messages. The Request Frame is the basic mechanism a CM uses to request bandwidth. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable bwr is a top-level command and requires read-debug privilege.
The no form of this command disables debugging for Request Frames.
Syntax
debug cable bwr
no debug cable bwr
Examples
G10$root# debug cable bwr
Enables debugging for Request Frames.
Related Commands
debug cable interface cabledebug cable mac-addressterminal monitorterminal speed
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
debug cable clear filter
101
debug cable clear filter
This command clears the list of MAC addresses, SIDs, and slot/interfaces to be debugged (known as debug filters). The list of debug event types—such as arp, range, and ucd—that have been set by the debug commands is not affected by this command. Therefore, if this command is followed by a command that defines a new debug filter (such as a SID), then that entity will be debugged. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable clear filter is a top-level command and requires read-debug privilege.
Syntax
debug cable clear filter
Examples
G10$root# debug cable clear filter
Clears the list of debugging filters.
Related Commands
debugdebug cabledebug cable clear logdebug cable interface cabledebug cable mac-addressshow debugging
debug cable clear log
This command clears the current buffer of debug messages. This can be useful if the buffer is filling up with debug messages faster than your terminal can display them, thereby preventing you from seeing later debug messages associated with more recent debug events. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable clear log is a top-level command and requires read-debug privilege.
Syntax
debug cable clear log
If no filters are defined, then all enabled debug event types are monitored, regardless of their associated MAC addresses, SIDs, and slot/interfaces. This can result in a continuous display of debug messages. Refer to the terminal speed command to reduce the debug message output speed.
debug cable dcc
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference102
Examples
G10$root# debug cable clear log
Clears the current buffer of debug messages.
Related Commands
debugdebug cabledebug cable clear filterdebug cable interface cabledebug cable mac-address
debug cable dcc
This command enables the display of debug messages associated with Dynamic Channel Change (DCC) events. DCC is used by the CMTS to change the upstream and/or the downstream channels on which a CM resides.Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable dcc is a top-level command and requires read-debug privilege.
The no form of this command disables debugging for messages related to DCC.
Syntax
debug cable dcc
no debug cable dcc
Examples
G10$root# debug cable dcc
Enables debugging for all messages related to DCC.
Related Commands
debug cable interface cabledebug cable mac-addressdebug cable mac-protocolterminal monitorterminal speed
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
debug cable dci
103
debug cable dci
This command enables the display of debug messages associated with Device Class Identification (DCI) events. A CM may use DCI to identify itself between ranging and establishing IP connectivity. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable dci is a top-level command and requires read-debug privilege.
The no form of this command disables debugging for messages related to DCI.
Syntax
debug cable dci
no debug cable dci
Examples
G10$root# debug cable dci
Enables debugging for all messages related to DCI.
DCI_REQ macFrameLength = 46
fc = 0xC2 macParm = 0x00 len = 0x001E hcs = 0x8E07
da = 00:03:04:D0:02:74 sa = 00:07:E9:01:20:0C msgLen = 0x000C type = 0x1A
contrl = 0x03 version = 0x02
sid = 0x000F
Device Class = 0x00000001
crc = 0x00000000
-------------------------------------------------------------------------------
DCI_RSP macFrameLength = 47
fc = 0xC2 macParm = 0x00 len = 0x001F hcs = 0x0000
da = 00:07:E9:01:20:0C sa = 00:03:04:D0:02:74 msgLen = 0x000D type = 0x1B
contrl = 0x03 version = 0x02
sid = 0x000F
Device Class = 0x00000001
Confirmation Code = 0x00
crc = 0x00000000
-------------------------------------------------------------------------------
Related Commands
debug cable interface cabledebug cable mac-addressdebug cable mac-protocoldebug cable rangedebug cable registrationterminal monitorterminal speed
debug cable dhcp
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference104
debug cable dhcp
This command enables the display of debug messages associated with the Dynamic Host Configuration Protocol (DHCP) events. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable dhcp is a top-level command and requires read-debug privilege.
The no form of this command disables debugging for DHCP.
Syntax
debug cable dhcp
no debug cable dhcp
Examples
G10$root# debug cable dhcp
Enables debugging for DHCP.
ETHERFRAME pktId = 0x00002623 frameLen = 618 EthernetII_(DIX)
dstMacAddr = 00:01:30:E7:C1:00 srcMacAddr = 00:03:E3:08:41:C9
etherType = 0x0800
IP ver = 4 hdrLen = 0x14 tos = 0x00 totLen = 0x025C
id = 0x8369 flags = 0 fragOfs = 0x0000 ttl = 0xFF
protocol = 0x11 hdrChkSum = 0xF527
srcIpAddr = 0.0.0.0 dstIpAddr = 192.168.128.87
UDP srcPort = 0x0044 dstPort = 0x0043
udpLen = 0x0248 udpChkSum = 0x0000
DHCP op = 0x01 htype = 0x01 hlen = 0x06
hops = 0x00 xid = 0x00001DE4 secs = 0x0000
flags = 0x8000
ciAddr = 0.0.0.0 yiAddr = 0.0.0.0
siAddr = 0.0.0.0 giAddr = 0.0.0.0
chAddr = 00:03:E3:08:41:C9
pad
pad
...
[More "pad" entries ...]
...
pad
pad
pad
magicCookie = 0x63825363
dhcpMessageType = DHCPDISCOVER
maxDhcpMessageSize = 0x0480
clientIdentifier = 0x01 0x00 0x03 0xE3 0x08 0x41 0xC9
paramReqeuestList = 0x01 0x02 0x04 0x42 0x80 0x03 0x07
0x43
vendorClassId = docsis1.0
optionOverload = file_and_sname_is_options
end
crc = 0xF96A0698
ETHERFRAME pktId = 0x0000279F frameLen = 342 EthernetII_(DIX)
dstMacAddr = 00:03:04:A0:07:A0 srcMacAddr = 00:01:30:E7:C1:00
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
debug cable dynsrv
105
etherType = 0x0800
IP ver = 4 hdrLen = 0x14 tos = 0x00 totLen = 0x0148
id = 0x7A7B flags = 0 fragOfs = 0x0000 ttl = 0x7E
protocol = 0x11 hdrChkSum = 0x739F
srcIpAddr = 192.168.128.87 dstIpAddr = 10.136.2.3
UDP srcPort = 0x0043 dstPort = 0x0043
udpLen = 0x0134 udpChkSum = 0x43BB
DHCP op = 0x02 htype = 0x01 hlen = 0x06
hops = 0x00 xid = 0x00000A52 secs = 0x0000
flags = 0x8000
ciAddr = 0.0.0.0 yiAddr = 10.136.2.27
siAddr = 192.168.128.81 giAddr = 10.136.2.3
chAddr = 00:03:E3:08:41:C9
sname =
file = nikhil531.cfg
magicCookie = 0x63825363
dhcpMessageType = DHCPOFFER
serverIdentifier = 192.168.128.87
ipAddrLeaseTime = 0x0008A7B3
subNetMask = 255.255.255.0
timeOffset = 36000
timeServer = 192.168.128.81
router = 10.136.2.1
logServer = 192.168.128.81
end
crc = 0xACC7A682
Related Commands
debug cable arpdebug cable interface cabledebug cable mac-addressterminal monitorterminal speed
debug cable dynsrv
This command enables the display of debug messages associated with Dynamic Service Addition messages (creates a new Service Flow), Dynamic Service Change messages (dynamically changes the parameters of an existing Service Flow), and Dynamic Service Deletion messages (deletes an existing Service Flow). Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable dynsrv is a top-level command and requires read-debug privilege.
The no form of this command disables debugging for messages related to Dynamic Service Flow.
Syntax
debug cable dynsrv
no debug cable dynsrv
debug cable dynsrv
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference106
Examples
G10$root# debug cable dynsrv
Enables debugging for all messages related to Dynamic Service Flow.
DSA_REQ macFrameLength = 155
fc = 0xC2 macParm = 0x00 len = 0x008B hcs = 0xFFFF
da = 00:10:95:1D:19:B8 sa = 00:03:04:D0:00:B5 msgLen = 0x0079 type = 0x0F
contrl = 0x03 version = 0x02
Transaction Id = 0x8003
UpstreamClassificationEncoding (t=0x16,l=0x14) =
ClassifierId (t=0x02,l=0x02) = 0x0001
ServiceFlowId (t=0x04,l=0x04) = 0x0100015F
IpPacketClassificationEncoding (t=0x09,l=0x08) =
TcpUdpSourcePortStart (t=0x07,l=0x02) = 0x000A
TcpUdpSourcePortEnd (t=0x08,l=0x02) = 0x000A
DownstreamClassificationEncoding (t=0x17,l=0x14) =
ClassifierId (t=0x02,l=0x02) = 0x0001
ServiceFlowId (t=0x04,l=0x04) = 0x01000160
IpPacketClassificationEncoding (t=0x09,l=0x08) =
TcpUdpSourcePortStart (t=0x07,l=0x02) = 0x001E
TcpUdpSourcePortEnd (t=0x08,l=0x02) = 0x001E
UpstreamServiceFlowEncoding (t=0x18,l=0x2F) =
ServiceFlowId (t=0x02,l=0x04) = 0x0100015F
ServiceIdentifier (t=0x03,l=0x02) = 0x0011
QosSetType (t=0x06,l=0x01) = 0x06
SchedulingType (t=0x0F,l=0x01) = 0x06
RequestTransmissionPolicy (t=0x10,l=0x04) = 0x000001FF
UnsolicitedGrantSize (t=0x13,l=0x02) = 0x0064
NominalGrantInterval (t=0x14,l=0x04) = 0x00002710
ToleratedGrantJitter (t=0x15,l=0x04) = 0x000007D0
GrantsPerInterval (t=0x16,l=0x01) = 0x01
GrantTimeReference (t=0x18,l=0x04) = 0x0000B000
DownstreamServiceFlowEncoding (t=0x19,l=0x12) =
ServiceFlowId (t=0x02,l=0x04) = 0x01000160
QosSetType (t=0x06,l=0x01) = 0x06
TrafficPriority (t=0x07,l=0x01) = 0x07
MaxSustainedTrafficRate (t=0x08,l=0x04) = 0x003D0900
crc = 0xD11D0000
-------------------------------------------------------------------------------
DSA_RSP macFrameLength = 47
fc = 0x0C3 ehLen = 0x04 len = 0x001F
EH_REQ miniSlots = 0x00 sid = 0x0010
hcs = 0x97E0
da = 00:03:04:D0:00:B5 sa = 00:10:95:1D:19:B8 msgLen = 0x0009 type = 0x10
contrl = 0x03 version = 0x02
Transaction Id = 0x8003
Confirmation Code = 0x00
crc = 0x5F090000
-------------------------------------------------------------------------------
DSA_ACK macFrameLength = 43
fc = 0xC2 macParm = 0x00 len = 0x001B hcs = 0x0000
da = 00:10:95:1D:19:B8 sa = 00:03:04:D0:00:B5 msgLen = 0x0009 type = 0x11
contrl = 0x03 version = 0x02
Transaction Id = 0x8003
Confirmation Code = 0x00
crc = 0x2ABB0001
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
debug cable icmp
107
Related Commands
debug cable interface cabledebug cable mac-addressdebug cable mac-protocolterminal monitorterminal speed
debug cable icmp
This command enables the display of debug messages associated with the Internet Control Message Protocol (ICMP) events. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable icmp is a top-level command and requires read-debug privilege.
The no form of this command disables debugging for ICMP.
Syntax
debug cable icmp
no debug cable icmp
Examples
G10$root# debug cable icmp
Enables debugging for ICMP.
ETHERFRAME pktId = 0x00001B56 frameLen = 98 EthernetII_(DIX)
dstMacAddr = 00:02:00:01:29:B2 srcMacAddr = 00:01:30:E7:C1:00
etherType = 0x0800
IP ver = 4 hdrLen = 0x14 tos = 0x00 totLen = 0x0054
id = 0x0000 flags = 2 fragOfs = 0x0000 ttl = 0x3E
protocol = 0x01 hdrChkSum = 0xEDD6
srcIpAddr = 192.168.129.136 dstIpAddr = 10.136.2.26
ICMP type = 0x08 code = 0x00 chkSum = 0x0AE6
ECHO_REQUEST id = 0xFE62 seqNbr = 0x0300
crc = 0xD6EDFE53
Related Commands
debug cable interface cabledebug cable mac-addressterminal monitorterminal speed
debug cable interface cable
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference108
debug cable interface cable
This command defines a list of MAC addresses, Service IDs (SIDs), or slot/interfaces (MAC domains) that are to be monitored for debugging purposes. These are known as debug filters. The debug feature sends informational messages to a Telnet or console session whenever a debug event occurs. Debug event types are defined by other CLI debug commands for events such as ranging, registration, and the transmission of certain MAC messages (such as MAP and UCD messages).
debug cable interface cable is a top-level command and requires read-debug privilege.
The no form of this command removes the specified entity from the debug monitor list.
Debug messages are enabled by performing the following tasks:
1. Define a list of MAC addresses, SIDs, or slot/interfaces to monitor by using the debug cable interface cable command or the debug cable mac-address command.
2. Define the debug event types to be monitored by executing the appropriate debug commands (such as debug cable range and debug cable registration).
3. Enable debug message output for the current Telnet or console session by executing the terminal monitor command.
Syntax
debug cable interface cable <slot/if> mac-address <mac-address> <mac-mask> [verbose]
Adds the specified MAC address to the list of entities to be monitored on the given slot/interface.
debug cable interface cable <slot/if> sid <sid> [verbose]
Adds the specified SID to the list of entities to be monitored on the given slot/interface.
debug cable interface cable <slot/if> [verbose]
All debug events on this interface are to be monitored.
no debug cable interface cable <slot/if> mac-address <mac-address>
Care should be taken when using the debug feature to ensure that the performance of the CMTS is not severely impacted. Restricting the number of CMs and debug events minimizes the resources required to support this feature.
If no debug filters are defined, then all enabled debug event types are monitored, regardless of their associated MAC addresses, SIDs, and slot/interfaces. This can result in a continuous display of debug messages in which case you can enter no terminal monitor (blindly) to stop the display.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
debug cable mac-address
109
no debug cable interface cable <slot/if> sid <sid>
no debug cable interface cable <slot/if>
Definitions
Examples
G10$root# debug cable interface cable 1/0 mac-address 1234.5678.ABCD FFFF.FFFF.0000↵
All MAC addresses in the range of 1234.5678.0000 to 1234.5678.FFFF on slot 1 / interface 0 are monitored.
G10$root# debug cable interface cable 1/0 [verbose]↵
All debug events on slot 1 / interface 0 are monitored using the verbose mode.
Related Commands
debugdebug cable mac-addressterminal monitorterminal speed
debug cable mac-address
This command defines a list of MAC addresses that are to be monitored for debugging purposes. The entry in the list created by this command applies globally to all slot/interfaces in the CMTS. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable mac-address is a top-level command and requires read-debug privilege.
The no form of this command removes the specified MAC address from the debug monitor list.
slot/if The slot number and interface number of the cable interface.
Slot (1 to 4 or 10 to 13) Interface (0 to 3)
mac-address The MAC address of the cable modem or CPE to be monitored specified as xxxx.xxxx.xxxx in hexadecimal. The MAC addresses shown in the debug message output are identified as da (destination address) and sa (source address). CPE debug messages are limited to relevant event types such as ARP, DHCP, and ICMP.
mac-mask The mask used against the mac-address specified as xxxx.xxxx.xxxx in hexadecimal. This allows a block of MAC addresses to be monitored.
sid Service identifier (SID) to be monitored (1–8191). SIDs can be viewed with the show cable modem command.
verbose Toggles between lengthy and brief messages.
debug cable mac-protocol
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference110
Syntax
debug cable mac-address <mac-address> <mac-mask> [verbose]
no debug cable mac-address <mac-address>
Definitions
Examples
G10$root# debug cable mac-address 1234.5678.ABCD FFFF.FFFF.0000↵
All MAC addresses in the range of 1234.5678.0000 to 1234.5678.FFFF on all slot/interfaces are monitored.
Related Commands
debugdebug cable clear filterdebug cable interface cableterminal monitorterminal speed
debug cable mac-protocol
Execution of this command is equivalent to executing all of the following debug commands:
debug cable bpkm
debug cable dcc
debug cable dci
debug cable dynsrv
debug cable range
debug cable registration
debug cable ucc
debug cable updis
mac-address The MAC address of the cable modem or CPE to be monitored specified as xxxx.xxxx.xxxx in hexadecimal. The MAC addresses shown in the debug message output are identified as da (destination address) and sa (source address). CPE debug messages are limited to relevant event types such as ARP, DHCP, and ICMP.
mac-mask The mask used against the mac-address specified as xxxx.xxxx.xxxx in hexadecimal. This allows a block of MAC addresses to be monitored.
verbose Toggles between lengthy and brief messages.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
debug cable map
111
Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable mac-protocol is a top-level command and requires read-debug privilege.
Execution of the no form of this command is equivalent to executing the no form of all of the debug commands associated with the debug cable mac-protocol command.
Syntax
debug cable mac-protocol
no debug cable mac-protocol
Examples
G10$root# debug cable mac-protocol
Enables debugging for all events related to the aforementioned debug commands.
Related Commands
debug cable bpkmdebug cable dccdebug cable dcidebug cable dynsrvdebug cable interface cabledebug cable mac-addressdebug cable rangedebug cable registrationdebug cable uccdebug cable updisterminal monitorterminal speed
debug cable map
This command enables the display of debug messages associated with Upstream Bandwidth Allocation MAP (MAP) messages. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable map is a top-level command and requires read-debug privilege.
The no form of this command disables debugging for MAP messages.
Syntax
debug cable map
no debug cable map
debug cable range
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference112
Examples
G10$root# debug cable map sid 14↵
Enables debugging for all MAP messages containing SID 14.
MAP macFrameLength = 76
fc = 0xC2 macParm = 0x00 len = 0x003C hcs = 0x0000
da = 01:E0:2F:00:00:01 sa = 00:03:04:A0:07:A2 msgLen = 0x002A type = 0x03
usChannelId = 0x20 UcdCnt = 0x0A NumElem = 0x05
AllocStartTime = 0009178D AckTime = 0009173E
RngBackoffStart=0x01 RngBackoffEnd=0x05
DatBackoffStart=0x03 DatBackoffEnd=0x0A
ie = (sid = 0x3FFF iuc = Request (0x1) offset=0x0000)
ie = (sid = 0x3FFF iuc = Initial Maintenance (0x3) offset=0x0008)
ie = (sid = 0x0000 iuc = Undefined (0x0) offset=0x003E)
ie = (sid = 0x0000 iuc = Undefined (0x0) offset=0x0058)
ie = (sid = 0x0000 iuc = Null IE (0x7) offset=0x0072)
crc = 0x03FC0000
Related Commands
debug cable interface cabledebug cable mac-addressterminal monitorterminal speed
debug cable range
This command enables the display of debug messages associated with initial and station maintenance ranging. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable range is a top-level command and requires read-debug privilege.
The no form of this command disables debugging for messages related to ranging.
Syntax
debug cable range
no debug cable range
Examples
G10$root# debug cable range
Enables debugging for all messages related to ranging.
RNG_RSP macFrameLength = 59
fc = 0xC2 macParm = 0x00 len = 0x002B hcs = 0xE9B9
da = 00:02:00:01:29:B2 sa = 00:03:04:A0:07:A2 msgLen = 0x0019 type = 0x05
contrl = 0x03 version = 0x01
sid = 0x0002 usChannelId = 0x20
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
debug cable registration
113
timingAdjust (t=0x01,l=0x04) = 0x00000000
txPowerAdjust (t=0x02,l=0x01) = 0x00
txFreqAdjust (t=0x03,l=0x02) = 0x0000
rangingStatus (t=0x05,l=0x01) = 0x03
crc = 0xCFC02DFF
RNG_REQ macFrameLength = 44
fc = 0xC0 macParm = 0x00 len = 0x001C hcs = 0xEA1D
da = 00:03:04:A0:07:A3 sa = 00:D0:59:FD:F2:92 msgLen = 0x000A type = 0x04
contrl = 0x03 version = 0x01
sid = 0x0004 dsChannelId = 0x21 pendingTillCompl = 0
crc = 0x01000302
Related Commands
debug cable interface cabledebug cable mac-addressdebug cable mac-protocoldebug cable registrationterminal monitorterminal speed
debug cable registration
This command enables the display of debug messages associated with CM registration. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable registration is a top-level command and requires read-debug privilege.
The no form of this command disables debugging for messages related to registration.
Syntax
debug cable registration
no debug cable registration
Examples
G10$root# debug cable registration
Enables debugging for all messages related to registration.
REG_REQ macFrameLength = 118
fc = 0x0C3 ehLen = 0x04 len = 0x0066
EH_REQ miniSlots = 0x00 sid = 0x000B
hcs = 0x520A
da = 00:03:04:A0:07:A2 sa = 00:02:00:01:29:B2 msgLen = 0x0050 type = 0x06
contrl = 0x03 version = 0x01
sid = 0x000B
NetworkAccessControl (t=0x03,l=0x01) = 0x01
DownstreamFrequency (t=0x01,l=0x04) = 0x1FA66AC0
ClassOfServiceConfig (t=0x04,l=0x06) =
ClassId (t=0x01,l=0x01) = 0x01
PrivacyEnabled (t=0x07,l=0x01) = 0x00
debug cable ucc
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference114
MaxCpeQuantity (t=0x12,l=0x01) = 0x04
CmMic (t=0x06,l=0x10) = 0x0C 0x8D 0x51 0xC7 0xAF 0x39 0x37 0x5B 0xB9 0xAE 0x51
0xD3 0xC8 0x08 0x35 0x27
CmtsMic (t=0x07,l=0x10) = 0x53 0x51 0x7B 0x99 0x80 0x35 0x98 0xF0 0xCF 0x12 0x6E
0xB8 0x37 0x50 0x70 0x67
ModemCapabilities (t=0x05,l=0x03) =
ConcatenationSupport (t=0x01,l=0x01) = 0x00
VendorId (t=0x08,l=0x03) = 0x00 0x02 0x00
CmIpAddress (t=0x0C,l=0x04) = 0x0A88021A
crc = 0x1D1D0000
REG_RSP macFrameLength = 62
fc = 0xC2 macParm = 0x00 len = 0x002E hcs = 0xD8D2
da = 00:02:00:01:29:B2 sa = 00:03:04:A0:07:A2 msgLen = 0x001C type = 0x07
contrl = 0x03 version = 0x01
sid = 0x000B response = 0x00
serviceClassData (t=0x01,l=0x07) =
classId (t=0x01,l=0x01) = 0x01
sid (t=0x02,l=0x02) = 0x000C
modemCapabilities (t=0x05,l=0x03) =
ConcatenationSupport (t=0x01,l=0x01) = 0x00
vendorId (t=0x08,l=0x03) = 0x00 0x03 0x04
crc = 0x0C8D0022
Related Commands
debug cable interface cabledebug cable mac-addressdebug cable mac-protocoldebug cable rangeterminal monitorterminal speed
debug cable ucc
This command enables the display of debug messages associated with Upstream Channel Change (UCC) messages. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable ucc is a top-level command and requires read-debug privilege.
The no form of this command disables debugging for Upstream Channel Change messages.
Syntax
debug cable ucc
no debug cable ucc
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
debug cable ucd
115
Examples
G10$root# debug cable ucc
Enables debugging for Upstream Channel Change messages.
Related Commands
debug cable interface cabledebug cable mac-addressdebug cable mac-protocoldebug cable ucdterminal monitorterminal speed
debug cable ucd
This command enables the display of debug messages associated with Upstream Channel Descriptor (UCD) messages. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable ucd is a top-level command and requires read-debug privilege.
The no form of this command disables debugging for Upstream Channel Descriptor messages.
Syntax
debug cable ucd
no debug cable ucd
Examples
G10$root# debug cable ucd
Enables debugging for Upstream Channel Descriptor messages.
UCD macFrameLength = 417
fc = 0xC2 macParm = 0x00 len = 0x0191 hcs = 0x9E1A
da = 01:E0:2F:00:00:01 sa = 00:03:04:A0:07:A2 msgLen = 0x017F type = 0x02
usChannelId = 0x20 confChgCount = 0x0A
miniSlotSize = 0x08 dsChannelId = 0x20
symbolRate (t=0x01,l=0x01) = 0x08
frequency (t=0x02,l=0x04) = 0x006ACFC0
preamblePattern (t=0x03,l=0x80) = 0x0C 0x0F 0xF3 0xCC 0x0C 0x0F 0xF3 0x3F 0x33
0xFC 0xCF 0xC0 0xFF 0xCC 0xC0 0xC3 0xFC 0x03 0xFF 0xCF 0xC0 0xC3 0xC3 0x03 0xCF
0xC3 0xC3 0x03 0xFC 0x3F 0xC0 0xFF 0x0C 0x30 0x0F 0xFC 0x3C 0xC0 0xC0 0xC0 0x0F
0x0C 0x31 0x1D 0x11 0x1D 0xDD 0xD1 0xDD 0x1D 0x11 0x1D 0x11 0x1D 0xDD 0xD1 0xD1
0xDD 0xD1 0xD1 0xDD 0xDD 0x1D 0x1D 0xDD 0x11 0x1D 0xDD 0xDD 0x1D 0x1D 0x11 0x1D
0x11 0xDD 0xDD 0x11 0x11 0xDD 0xDD 0xDD 0x1D 0xDD 0x11 0x1D 0x11 0xDD 0x11 0xD1
0x11 0xDD 0x1D 0xDD 0x11 0xDD 0x11 0xD1 0x11 0xDD 0xDD 0x11 0xDD 0xDD 0x11 0x1D
0xDD 0xD1 0x1D 0x11 0xD1 0x11 0x1D 0xDD 0xDD 0x11 0xDD 0x1D 0x11 0x1D 0x11 0x1D
0x11 0x11 0x1D 0xD1 0x1D 0x11 0xD0
debug cable updis
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference116
BurstDescriptor (t=0x04,l=0x25) =
modulationType (t=0x01,l=0x01) = 0x01
modulationType (t=0x01,l=0x02) = 0x0102
...
[Burst descriptor list ...]
...
guardTimeSize (t=0x09,l=0x01) = 0x08
lastFecCwLength (t=0x0A,l=0x01) = 0x02
isScramblerUsed (t=0x0B,l=0x01) = 0x01
crc = 0x00000000
Related Commands
debug cable interface cabledebug cable mac-addressdebug cable uccterminal monitorterminal speed
debug cable updis
This command enables the display of debug messages associated with Upstream Transmitter Disable (UP-DIS) messages. Refer to the debug cable interface cable command for more details regarding the debug feature.
debug cable updis is a top-level command and requires read-debug privilege.
The no form of this command disables debugging for Upstream Transmitter Disable messages.
Syntax
debug cable updis
no debug cable updis
Examples
G10$root# debug cable updis
Enables debugging for Upstream Transmitter Disable messages.
UP_DIS macFrameLength = 44
fc = 0xC2 macParm = 0x00 len = 0x001C hcs = 0xFFFF
da = 00:07:E9:01:20:0C sa = 00:03:04:D0:02:74 msgLen = 0x000A type = 0x1C
contrl = 0x03 version = 0x02
timeoutInterval = 0x00000000
crc = 0x01000000
Related Commands
debug cable interface cabledebug cable mac-address
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
delete
117
debug cable uccterminal monitorterminal speed
delete
This command deletes a file from the CMTS.
delete is a top-level command and requires read-write privilege.
The default is current directory if a path is not specified.
Syntax
delete <file-name>
Definitions
Examples
G10$root# delete /pbc/myfile↵
Deletes the file named myfile located in directory pbc.
Related Commands
copyerase startup-configmkdirrenamermdir
description
This command adds a description to a Fast Ethernet port, a Gigabit Ethernet port, or a cable interface. Compose any description to assist you in identifying the port. The descriptions are displayed when the show interfaces commands are executed.
description is a command within the interface fastEthernet, the gigaEthernet, and the interface cable sub-modes and requires read-write privilege.
The no form of this command removes the description.
There are no default values for this command.
file-name Name of the file to be deleted. May include the path to the file.
dhcp-giaddr
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference118
Syntax
description <"string">
no description
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface fastEthernet 6/0↵G10$root(config-if-f6/0)# description “First Ethernet Port”↵
Adds the description First Ethernet Port to Fast Ethernet port 0 of the Chassis Control Module in slot 6.
G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# description “Eighth RF Cable”↵
Adds the description Eighth RF Cable to the cable interface at slot 4 / interface 1.
Related Commands
show interfaces
dhcp-giaddr
This command is used to configure a subscriber group under the subscriber group sub-mode. The basic underlying functionality of this command is the same as the cable dhcp-giaddr command. Refer to the cable subscriber-group for more details regarding subscriber groups.
dir
This command displays a list of files and sub-directories that are in the named directory of the CMTS. The command ls performs the same function.
dir is a top-level command and requires read-only privilege.
Default is the current directory if no other path is named.
Syntax
dir [directory-name]
string User-defined text string up to 64 characters enclosed in quotes.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
disable
119
Definitions
Examples
G10$root> dir /logs/userlogs↵
Displays the contents of the directory logs/userlogs in the CMTS. Typical response:
drwx 1024 Dec 12 09:34:16 2001 .
dr-x 1024 Dec 04 15:21:21 2001 ..
-rw- 83 Nov 30 01:27:55 2001 README
-rw- 16671 Nov 30 12:14:36 2001 test.cli
-rw- 17500 Dec 10 14:07:55 2001 Startup.back
Related Commands
cdlsmkdirpwdrmdir
disable
This command returns the user’s privilege level to the level established prior to executing the corresponding enable command. Read-write and read-debug privilege are denoted by # at the end of the prompt string. Read-only access is denoted by > at the end of the prompt string.
disable is a top-level command and is available to all users.
There is no default setting for this command.
Examples
G10$root# disable↵G10$root>
The command prompt changes to indicate read-only privilege since this was the privilege level established prior to executing the enable command.
Related Commands
enable
duplex
This command sets an Ethernet port to either full or half duplex.
directory-name Optional - Path and name of the directory to be displayed.
echo
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference120
duplex is a command within the interface fastEthernet sub-mode and requires read-write privilege.
Default is full duplex.
Syntax
duplex {full|half}
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface fastEthernet 6/0↵G10$root(config-if-f6/0)# duplex full↵
Sets Fast Ethernet port 0 of the Chassis Control Module in slot 6 to full duplex.
Related Commands
auto-negotiationshowshutdownspeed
echo
This command echoes up to three words or strings to the screen. A single-character delimiter of " must be used before and after the specified string if it is greater than one word. The delimiter cannot be used within the body of the string.
echo is a top-level command and requires read-only privilege.
Syntax
echo [<"echo-string"> [<"echo-string"> [<"echo-string">]]]
full Set interface to full duplex mode allowing simultaneous two-way data flow.
half Set interface to half duplex mode invoking alternating transmit/receive data flows.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
edit
121
Definitions
Examples
G10$root> echo “This is the first string” Word2 Word3↵
This is the first string Word2 Word3
Related Commands
banner incomingbanner loginbanner motdbanner show
edit
This command opens the specified file in the current directory using the vi editor.
edit is a top-level command and requires read-write privilege.
Syntax
edit <filename>
Definitions
Examples
G10$root# edit myfile↵
Opens the file myfile using the vi editor.
Related Commands
cdcopydeletelsmore
echo-string Specifies the word or string that is echoed. The string is comprised of a sequence of text characters
filename The name of the file to edit.
enable
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference122
enable
This command sets the user’s privilege level to the root level. You will be prompted for the root-level password.
enable is a top-level command and is available to all users.
There are no parameters with this command.
Syntax
enable
Examples
G10$newuser# enable↵password: changeme↵
Sets the session for newuser to root level access privileges. This example assumes the initial root password of changeme is still valid.
Related Commands
disable
erase startup-config
This command deletes the startup configuration file (Startup.cli). This command is identical to executing delete /home/Startup.cli (the Startup.cli file is created by executing the write memory or copy running-config startup-config commands). If the startup.cli file is deleted, the CMTS uses the default configuration on the next reboot.
erase startup-config is a top-level command and requires read-write privilege.
Syntax
erase startup-config
Examples
G10$root# erase startup-config↵
Erases the Startup.cli file.
Related Commands
copydeletewrite memory
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
exit
123
exit
This command takes you out of the current mode, or any of the sub-modes, to the next highest level. If the optional parameter all is specified, you will be taken to the top-level prompt. This command has no effect at the top-level prompt.
exit can be entered at any command level and is available to all users.
Syntax
exit [all]
Definitions
Examples
G10$root(config-if-c4/1)# exit↵G10$root#(config)# exit↵G10$root#
Exiting from a configure interface sub-mode then from the configure terminal mode.
Related Commands
Ctrl-Z (key command that exits to the top level)
ftp
This command opens an FTP (File Transfer Protocol) session to the specified hostname or IP address. The current CLI directory is the target directory for any file transfers between the CMTS and the FTP host.
ftp is a top-level command and requires read-write privilege.
Syntax
ftp {<hostname>|<ip-address>}
Definitions
all Unconditionally takes you to the top-level prompt regardless of the current mode or sub-mode.
hostname The hostname to which the ftp session is established.
ip-address The IP address of the host to which the ftp session is established. Standard dot-quad notation (xxx.xxx.xxx.xxx).
help
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference124
Examples
G10$root# ftp 192.163.25.8↵login: user1↵password: mypassword↵ftp> bin↵ftp> get myfile↵ftp> bye↵
Establish an ftp session with the host at IP address 192.163.25.8, login to the host, download the binary file myfile into the current CLI directory of the CMTS, then close the ftp session. Executing the ls command shows that myfile has been downloaded, in this case, to the home directory.
G10$root# ls↵drwx 1024 Apr 05 12:12:32 2002 .
drwx 1024 Apr 01 07:24:07 2002 ..
-rw- 99 Apr 15 14:32:44 2002 myfile
-rw- 83 Nov 30 01:27:22 2001 README
-rw- 10211 Apr 05 10:22:28 2002 Startup.cli
drwx 1024 Jan 08 22:24:37 2002 CVS
Related Commands
telnettftp
help
This command displays a list of valid commands that can be executed within the current mode or sub-mode. Help— or equivalently a question mark—may be entered at any command level. The usage of the question mark, either as a standalone command or as described below, does not require a carriage return. Following is a list of the various help modes:
1. A list of valid commands displays when you type help, help help, or a question mark at the command prompt.
2. A list of valid parameters displays when you type a question mark after a command. If there are no additional parameters, or if all additional parameters are optional, a carriage return abbreviation <cr> will also be displayed.
3. If you type a question mark after one or more characters of a parameter, the valid parameters that contain those characters leading up to the question mark will be displayed.
4. Typing help followed by the edit-keys parameter displays the available editing keystrokes.
5. Typing help followed by the commands parameter displays a list of commands
help (or ?) can be entered at any command level and is available to all users.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
helper-address
125
Syntax
help [edit-keys|help]
?
<command> ?
<command> <abbreviated-parameter>?
Definitions
Examples
G10$root# help↵
Displays a list of all valid commands in the current mode or sub-mode.
G10$root# show ?
Displays a list of parameters available for the show command. Notice that a carriage return is not needed.
G10$root# show us?G10$root# show user
Displays a list of all parameters under the show command that begin with us. Notice in this example that the system has expanded the parameter to user immediately after entering ? to facilitate command entry since the two possible parameters are usernames and users.
helper-address
This command is used to configure a subscriber group under the subscriber group sub-mode. The basic underlying functionality of this command is the same as the cable helper-address command. Refer to the cable subscriber-group for more details regarding subscriber groups.
history
This command is used to display a list of previously-executed commands, including the history command just executed. To execute any of the commands displayed, enter ! followed by the number of the command displayed.
history can be entered at any command level and is available to all users.
edit-keys Displays a list of available editing keystrokes.
help Specifying help as a parameter to the help command displays a list of valid commands.
command Any valid command for the current mode, sub-mode, group, and privilege
abbreviated-parameter One or more letters in a valid parameter for the command specified.
hostname
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference126
This command does not have a no form.
Syntax
history
Examples
G10$root# history↵
Execute configure terminal by entering !1.
1 configure terminal
2 interface fastEthernet 6/0
3 show
4 exit
5 interface cable 2/0
6 ip show
7 history
G10$root# !1↵G10$root(config)#
Related Commands
show history
hostname
This command sets a name for the host CMTS. The host name defines the prompt that appears on the screen.
hostname is a command in the configure terminal mode and requires read-write privilege.
The default hostname is G10.
The no form of this command deletes any existing hostname.
Syntax
hostname <"name">|show
no hostname
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
interface cable
127
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# hostname "My CMTS"↵My CMTS$root#
Sets the CMTS hostname to My CMTS and defines a new prompt.
interface cable
This command enters a sub-mode under the configure terminal mode where you configure a given cable interface. See Chapter 1, “Command Listing”, for a hierarchal display of modes, sub-modes and commands.
A cable interface is a logical configuration that encompasses upstream (US) and downstream (DS) ports in a specified slot (DOCSIS Module/HFC Connector Module). Each slot/interface corresponds to a DOCSIS MAC domain. See also Appendix B, “Configuration Notes”.
interface cable is a sub-mode within the configure terminal mode and requires read-write privilege.
The default is four cable interfaces defined for each slot. Refer to Appendix B, “Configuration Notes”.
Syntax
interface cable <slot/if>
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 3/1↵G10$root(config-if-c3/1)#
This puts you in the interface cable sub-mode for slot 3 / interface 1. All subsequent commands in this sub-mode implicitly refer to this slot/interface.
name A text string enclosed in quotation marks.
show Displays the current host name.
slot Chassis slot number of the DOCSIS Module to be configured. (1 to 4 or 10 to 13). See the diagram in “Slot Numbers” on page 191.
if An existing interface number that includes the US and DS ports to be configured. A maximum of four interfaces per slot are allowed. {0 to 3}
interface fastEthernet
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference128
Related Commands
configure terminalshow interfaces cableshow running-configshow startup-config
interface fastEthernet
This command enters a sub-mode under the configure terminal mode where you configure the Fast Ethernet ports in the DOCSIS Module, the Chassis Control Module, and the NIC Module. Defined parameters for these ports are auto-negotiate, speed and duplex.
interface fastEthernet is a sub-mode within the configure terminal mode and requires read-write privilege.
There are no defaults for this command.
Syntax
interface fastEthernet <slot/if> [show]
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface fastEthernet 6/0↵G10$root(config-if-f6/0)#
This puts you in the sub-mode to configure Fast Ethernet port 0 of the Chassis Control Module in slot 6.
slot Chassis slot number:
DOCSIS Module: 1 to 4 and 10 to 13.
Chassis Control Module: 6 and 7.
NIC Module: 5 and 9.
if Port number of the Fast Ethernet ports to be configured:
DOCSIS Module: 0 and 1
Chassis Control Module: 0
NIC Module: 0–11
show Displays configuration information for the slot/if. The system remains in the configure terminal mode.
FastEthernet ports 0–11 on the NIC Module correspond to the RJ-45 connectors labeled PORT 1–PORT 12 on the NIC Access Module cable plugged into connector “2” on the NIC Access Module.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
interface gigaEthernet
129
Related Commands
show interfaces fastEthernetshutdown
interface gigaEthernet
This command enters a sub-mode under the configure terminal mode where you enable or disable the Gigabit ports on the NIC Module.
interface gigaEthernet is a sub-mode within the configure terminal mode and requires read-write privilege.
There are no defaults for this command.
Syntax
interface gigaEthernet <slot/if> [show]
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface gigaEthernet 5/0↵G10$root(config-if-g5/0)#
This puts you in the sub-mode to configure Gigabit port 0 of the NIC Module in slot 5.
Related Commands
show interfaces gigaEthernetshutdown
ip address
This command sets the IP address for the fastEthernet interface of the Chassis Control Modules, which serves as the IP address for the CMTS. The Chassis Control Modules are in slots 6 and 7 and always use interface 0. All IP packets transmitted by the G10 CMTS will include the IP address as the source IP address.
ip address is a command within the interface fastEthernet sub-mode and requires read-write privilege.
slot Chassis slot number of the NIC Module: 5 or 9
if Gigabit port number of the NIC Module: 0 or 1
show Displays configuration information for the slot/if. The system remains in the configure terminal mode.
ip default-gateway
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference130
The no form of the command removes the IP address.
Syntax
ip address <ip-address> <mask>
no ip address <ip-address>
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# interface fastEthernet 6/0↵G10$root(config-if-f6/0)# ip address 192.168.20.101 255.255.255.0↵
Assigns the IP address 192.168.20.101 with mask 255.255.255.0 to the Chassis Control Module at slot 6 / interface 0.
Related Commands
cable dhcp-giaddrip default-gatewayshow interfaces
ip default-gateway
This command is used to specify the IP address of the default router. The default router is used as the next-hop router for all Chassis Control Module management port traffic.
ip default-gateway is a command within the configure terminal mode and requires read-write privileges.
no ip default-gateway removes the default gateway setting.
ip-address The IP address to assign to the interface. Standard dot-quad notation (xxx.xxx.xxx.xxx).
mask The subnet mask corresponding to the IP address. Standard dot-quad notation (xxx.xxx.xxx.xxx).
The ip address command is not used to assign IP addresses to cable interfaces.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
ip domain-name
131
Syntax
ip default-gateway <ip-address> management
no ip default-gateway management
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# ip default-gateway 192.111.168.101 management↵
The default gateway for all Chassis Control Module management port traffic is set to 192.111.168.101.
Related Commands
ip address
ip domain-name
This command sets a domain name for the CMTS. Any hostname specified without a dot-extension in a command is then assumed to belong to this domain.
ip domain-name is a command within the configure terminal mode and requires read-write privileges.
no ip domain-name removes the domain name setting.
Syntax
ip domain-name <domain>
no ip domain-name
Definitions
ip-address The IP address to assign as the default gateway. Standard dot-quad notation (xxx.xxx.xxx.xxx).
domain The domain name for the CMTS.
ip name-server
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference132
Examples
G10$root# configure terminal↵G10$root(config)# ip domain-name mydomain.com↵G10$root(config)# exit↵G10$root# ping myCPE↵
The domain name mydomain.com is set for the CMTS. Then, the equipment named myCPE.mydomain.com is pinged.
Related Commands
ip name-server
ip name-server
This command specifies the IP address of a domain name system (DNS) server. A DNS server is consulted to resolve host names and their related IP addresses. Use this command to store up to five distinct DNS server addresses. The CMTS will seek the servers in the order they are provided.
ip name-server is a command within configure terminal mode and requires read-write privilege.
no ip name-server removes all, or one, server(s) from the list.
Syntax
ip name-server <ip-address>
no ip name-server [<ip-address>]
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# ip name-server 192.16.90.1↵G10$root(config)# ip name-server 192.16.90.2↵
Adds the DNS servers at addresses 192.16.90.1 and192.16.90.2. The CMTS will then consult these addresses, in that order, when resolving a host name.
G10$root(config)# no ip name-server↵
Removes all DNS server addresses.
ip-address The address of the DNS server in standard dot-quad notation (xxx.xxx.xxx.xxx). Five addresses may be specified by repeating this command.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
ip show
133
G10$root(config)# no ip name-server 192.16.90.1↵
Removes the specified DNS server address.
Related Commands
ip domain-name
ip show
This command displays the IP addresses that have been assigned at the current command level.
ip show is a command in the configure terminal mode and requires read-write privilege.
This is a display command that has no defaults and requires no parameters.
Examples
G10$root# configure terminal↵G10$root(config)# ip show↵
Default gateway (Management Interface): 192.168.201.1
kill
This command terminates the specified Telnet session.
kill is a top-level command and requires read-write privilege.
Syntax
kill <session-id>
Definitions
Examples
G10$root# show users↵
SessionId Login Connection
0 root 192.168.201.137
1 u1 192.168.200.12
G10$root# kill 1↵
Terminates the Telnet session with ID 1 (user u1).
session-id The ID of the Telnet session to be terminated. Valid range is 0–9. Executing the show users command displays the associated session IDs.
log-level generate
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference134
Related Commands
session timeoutshow userswho
log-level generate
This command provides access to the docsDevEvControlTable within the DOCSIS Cable Device MIB (RFC-2669). This table controls how events of various priority levels are logged and reported.
The CMTS maps events, such as a registration authentication failure, to one of eight priority levels. These priorities correspond to the level-name parameter of this command, and to the priorities defined in the docsDevEvPriority object of RFC-2669. When an event occurs, the logging and reporting actions taken are determined by the parameters specified after the generate keyword of this command, and correspond to the bits defined in the docsDevEvReporting object of RFC-2669. Refer to RFC-2669 and the DOCSIS OSSI specifications for more details. The Juniper Networks G10 CMTS Operations and Maintenance manual provides a list of Juniper Networks-specific log events.
log-level generate is a command in the configure terminal mode and requires read-write privilege.
no log-level generate resets the specified bits in the docsDevEvReporting object for the specified priority level, in which case the specified logging and reporting actions are not taken.
The local log corresponds to the docsDevEventTable of RFC-2669.
For each priority level, four different actions, or combinations thereof, can be specified (in the order shown after the generate keyword). Three combinations not allowed:
syslog
trap
syslog, trap
This command is cumulative in that it will only enable or disable those actions specified, and will not affect unspecified actions.
Syntax
log-level <level-name> generate [local-log] [local-volatile-log] [syslog] [trap]
no log-level <level-name> generate [local-log] [local-volatile-log] [syslog] [trap]
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
log-level show
135
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# log-level alert generate local-log local-volatile syslog trap↵
Events occurring with an alert priority will be logged in the local non-volatile log and the local volatile log, will cause a syslog message to be sent, and will cause a trap to be generated.
G10$root(config)# log-level information generate local-log↵
Events occurring with an information priority will be logged in the local non-volatile log.
Related Commands
log-level showshow local-log
log-level show
This command displays the logging and reporting actions defined for each of the event priority levels set by the log-level generate command, or by SNMP. These priority levels correspond to the priorities in the docsDevEvPriority object within the DOCSIS Cable Device MIB (RFC-2669). Refer to RFC-2669 for more details.
log-level show is a command in the configure terminal mode and requires read-write privilege.
Syntax
log-level show
level-name One of eight event priorities: emergency, alert, critical, error, warning, notice, information, debug. These are presented from most critical to least.
local-log Specifies that the event will be written to the local non-volatile log on the CMTS (corresponds to localNonVolatile(0) in docsDevEvReporting).
local-volatile-log Specifies that the event will be written to the local volatile log on the CMTS (corresponds to localVolatile(3) in docsDevEvReporting).
syslog Specifies that the event will cause a syslog message to be sent (corresponds to syslog(2) in docsDevEvReporting).
trap Specifies that the event will cause a trap to be generated (corresponds to traps(1) in docsDevEvReporting).
logout
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference136
Examples
G10$root# configure terminal↵G10$root(config)# log-level show↵
Displays the logging and reporting actions for each of the event priority levels in the docsDevEvPriority object.
evPriority evReporting
------------ -------------
emergency local-log
alert local-log, local-volatile-log
critical local-log, local-volatile-log, syslog, trap
error local-volatile-log, syslog, trap
warning local-volatile-log, syslog, trap
notice local-volatile-log, syslog, trap
information local-volatile-log
debug local-volatile-log
Related Commands
log-level generateshow local-log
logout
This command ends the Telnet session when entered within any mode or sub-mode.
logout can be entered at any command level and is available to all users.
There are no parameters with this command.
Examples
G10$user1> logout↵
Logout from the non-privileged top-level prompt.
G10$user1# logout↵
Logout from the privileged top-level prompt.
ls
This command displays a list of files and sub-directories that are in the named directory of the CMTS. The command dir performs the same function.
ls is a top-level command and requires read-only privilege.
Default is the current directory if no other path is named.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
mkdir
137
Syntax
ls [directory-name]
Definitions
Examples
G10$root> ls /home↵
Displays the contents of the directory home in the CMTS. Typical response:
drwx 1024 Dec 12 09:34:16 2001 .
dr-x 1024 Dec 04 15:21:21 2001 ..
-rw- 83 Nov 30 01:27:55 2001 README
-rw- 16671 Nov 30 12:14:36 2001 test.cli
-rw- 17500 Dec 10 14:07:55 2001 Startup.cli
Related Commands
cddirmkdirpwdrmdir
mkdir
This command creates the specified directory. The parent directory of the created directory must already exist.
mkdir is a top-level command and requires read-write privilege.
There are no default settings for this command.
Syntax
mkdir <dir-name>
Definitions
directory-name Optional - Path and name of the directory to be displayed.
dir-name Name of the directory being created.
more
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference138
Examples
G10$root# cd /samples/data↵G10$root# mkdir logs↵G10$root# cd /logs↵
Creates a new directory named logs in the path sample/data.
Related Commands
cddirlspwdrmdir
more
This command causes the contents of a file to display one screen at a time. After a screen has been displayed, pressing Enter will advance the display one line, and pressing the space bar will advance the display one screen. Pressing q or Q will quit this command.
more is a top-level command and requires read-only privilege.
Syntax
more <file-name>
Definitions
Examples
G10$root> cd /samples/data↵G10$root> more sample.txt↵
Displays one screen of the data in the file named sample.txt in the directory samples/data.
Related Commands
catcddir
file-name Name of the file to be displayed. May include the path to the file.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
ping
139
ping
This command verifies a network connection between the CMTS and the target device.
The ping and ping ip commands send ICMP echo requests to the specified target and display a response if the target is reached, or it times out if the target is not reached.
The ping cable-modem command instructs the CMTS to schedule a station maintenance opportunity in a MAP message to the specified CM. If the CM uses this opportunity to transmit a RNG-REQ message, and the CMTS receives it within 5 seconds (the timeout period), then the ping cable-modem command is considered successful. Otherwise, it is considered a failure.
ping is a top-level command and is available to all users.
Syntax
ping {<ip-address>|<hostname>}
ping [ip] <ip-address>
ping cable-modem {<ip-address>|<mac-address>}
Definitions
Examples
G10$root# ping 10.1.1.35↵
Verifies the connection between the CMTS and the device at IP address 10.1.1.35 using ICMP.
PING 10.1.1.35 (10.1.1.35) from 192.168.21.49 : 56(84) bytes of data.
--- 10.1.1.35 ping statistics ---
5 packets transmitted, 5 packets received, 0% packet loss
round-trip min/avg/max/mdev = 8.630/10.937/14.091/1.900 ms
ip-address IP address of the device being pinged. Standard dot-quad notation (xxx.xxx.xxx.xxx).
hostname Hostname of the device being pinged.
ip This parameter is optional and is supported for industry-standard compatibility.
cable-modem The ping is directed to the IP address or MAC address on the cable interface.
mac-address The MAC address of the cable modem specified as xxxx.xxxx.xxxx in hexadecimal.
pwd
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference140
G10$root# ping cable-modem 1234.5678.9ABC↵
Verifies the connection between the CMTS and the CM at MAC address 1234.5678.9ABC using the DOCSIS MAP message.
Received RNG-REQ from the modem
Timing OffSet (1/64 Tick): 0
Power OffSet (1/4 DB) : 2
Freq OffSet (Hz) : -5
pwd
This command displays the current directory.
pwd is a top-level command and requires read-only privilege.
There are no parameters with this command.
Syntax
pwd
Examples
G10$root# pwd↵/home
Related Commands
cddirlsmkdirrmdir
relay-agent-option
This command is used to configure a subscriber group under the subscriber group sub-mode. The basic underlying functionality of this command is the same as the cable relay-agent-option command. Refer to the cable subscriber-group for more details regarding subscriber groups.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
reload
141
reload
This command causes the G10 CMTS to initiate a restart (reboot). Optional parameters allow a user to restart the system at a specific time of day, or after a given duration of time has elapsed.
reload is a top-level command and requires read-write privilege.
Executing reload without any optional parameters unconditionally restarts the CMTS.
Syntax
reload [show|cancel]
reload at <time>
Restarts the CMTS at a specific time of day.
reload in <minutes>
Restarts the CMTS after the given duration of time has elapsed.
Definitions
Examples
G10$root# reload↵
Restart the CMTS unconditionally.
G10$root# reload at 23:30↵
Restart the CMTS at the next occurrence of 11:30 pm.
Related Commands
reset-slot
This action will disrupt service to all subscribers supported by the G10 CMTS.
show Shows if a reload command is pending.
cancel Cancels a pending reload command.
time Hours and minutes in 24-hour format (hh:mm).
minutes Integer number of minutes. Valid range is 0–65535.
rename
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference142
rename
This command renames a file in the CMTS. The parent directory
rename is a top-level command and requires read-write privilege.
Syntax
rename <source-filename> <dest-filename>
Definitions
Examples
G10$root# rename log.txt log_8-17.txt↵
The file log.txt is renamed to log_8-17.txt in the same directory.
G10$root# rename log.txt home/usr/log_8-17.txt↵
The file log.txt is renamed to log_8-17.txt and moved to the home/usr directory.
Related Commands
cdcopydir
reset-slot
This command causes the DOCSIS Module in the specified slot to be restarted (rebooted).
reset-slot is a top-level command and requires read-write privilege.
Syntax
reset-slot <slot>
source-filename The current file name. May include the path to the file.
dest-filename The new file name to which the current file name will be changed. May include the path to the file. The parent directory of the new file must already exist.
This action will disrupt service to the subscribers on the specified DOCSIS Module.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
rmdir
143
Definitions
Examples
G10$root# reset-slot 1↵
Restart the DOCSIS Module in slot 1 unconditionally.
Related Commands
cable authorizereload
rmdir
This command removes an existing directory in the G10 CMTS. If the current directory no longer exists as a result of this command, then the current directory will be reset to /home.
rmdir is a top-level command and requires read-write privilege.
Syntax
rmdir <directory-name>
Definitions
Examples
G10$root# cd home/usr↵G10$root# rmdir temp↵
Removes the directory named temp in the home/usr path.
Related Commands
cddirlsmkdirpwd
slot The CMTS slot number in which the DOCSIS Module resides.
Slot {1,2,3,4,10,11,12,13}
directory-name The name of the directory to be removed.
session timeout
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference144
session timeout
This command sets the timeout duration for all Telnet sessions into the CMTS, and optionally, the timeout duration for the console session. A timeout is defined as a period of time in which no CLI commands have been entered.
session timeout is a command within the configure terminal mode and requires read-write privilege.
The default timeout period is 300 seconds (5 minutes).
Setting the timeout to 0 disables timeouts.
This command affects the current session, as well as any sessions started afterwards. Previously-running sessions are not affected.
Syntax
session timeout <seconds> [console]
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# session timeout 600 console↵
Sets the timeout period for Telnet and console sessions to 600 seconds (10 minutes).
Related Commands
kill
show cable address-verification
This command displays specified entries of the address verification table. If no optional parameters are specified, the entire address verification table is displayed.
The Timeout value displayed indicates the DHCP lease timeout for dynamic entries (in seconds). This value cannot be set from within the CLI. A timeout of -1 indicates the entry is static.
show cable address-verification is a top-level command and is available to all users.
seconds The duration of the timeout in seconds. Valid range is 0–36000.
console Specifies that the timeout duration also applies to the console session.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
show cable modem
145
Syntax
show cable address-verification [<ip-address>|<mac-address>|<slot/if>]
Definitions
Examples
G10$root> show cable address-verification 10.131.2.100↵
Display the address verification table entry that has an IP address of 10.131.2.100.
IP Address MAC Address Timeout
10.131.2.100 00D0.59FD.F53D 596558
G10$root> show cable address-verification↵
Display the entire address verification table.
Related Commands
cable arp-verifycable address-verificationcable drop-unverifiable-addressescable source-verify
show cable modem
This command optionally displays the number of CMs that exist in various operational states, or displays individual modem information. The command can apply to all CMs, to those CMs in a slot/interface or an upstream channel, or to individual CMs specified by their IP or MAC address.
show cable modem is a top-level command and is available to all users.
Syntax
show cable modem [summary [total]]
Displays all CMs supported by the CMTS.
ip-address The IP address of the address verification table entry. Standard dot-quad notation (xxx.xxx.xxx.xxx).
mac-address The MAC address of the address verification table entry. Specified as xxxx.xxxx.xxxx in hexadecimal. Multiple entries may be displayed for a MAC address.
slot/if The slot number and interface number of the cable interface. Multiple entries may be displayed for a slot/interface.
Slot (1 to 4 or 10 to 13) Interface (0 to 3)
show cable modem
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference146
show cable modem <slot/if> [upstream <channel>] [summary [total]]
Displays all CMs in the given slot/interface, or optionally, only those CMs in the specified upstream channel in the given slot/interface.
show cable modem <ip-address>|<mac-address>
Displays the CM registered with the given address.
Definitions
Examples
G10$root> show cable modem 2/1 upstream 2↵
Display individual information for each CM in upstream channel 2 in slot 2 / interface 1. Refer to Table 3 for a description of the parameters displayed
Interface Prim Online Timing Rec QoS IP address MAC address Ver
Sid State Offset Power
C2/1/U2 39 init(rc) 2566 0.0 1 0.0.0.0 0010.9517.92EC 1.0
G10$root> show cable modem 192.168.27.110↵
Display individual information for the CM with an IP address of 192.168.27.110.
Interface Prim Online Timing Rec QoS IP address MAC address Ver
Sid State Offset Power
C2/0/U0 29 online 2302 -3.1 1 192.168.27.110 0001.0327.DCAA 1.0
G10$root> show cable modem summary total↵
Display the counts and totals for various operational states of all CMs supported by the CMTS. Refer to Table 5 on page 148 for a description of the operational states displayed.
Cable Modem
Interface US Dstry Dclr Rng Rng Rng IP Reg Access
Total Abort Compl Compl Denied
Cable2/0/U0 230 10 30 10 5 20 10 100 50
summary A summary of the number of CMs that exist in various operational states is displayed.
total A row is displayed that provides the total number of CMs as displayed by the summary option.
slot/if The CMTS slot and interface number, which will display all of the cable modems in that interface.
Slot {1,2,3,4,10,11,12,13} Interface {0 to 3}
upstream Only information associated with CMs on the specified upstream channel is displayed.
channel The upstream channel number (0 to 7 or 0 to 15, depending on the DOCSIS Module model).
ip-address The IP address of the cable modem to be displayed. Standard dot-quad notation (xxx.xxx.xxx.xxx).
mac-address The MAC address of the cable modem to be displayed specified as xxxx.xxxx.xxxx in hexadecimal.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
show cable modem
147
Cable2/0/U1 230 10 30 10 5 20 10 100 50
Cable2/0/U2 230 10 30 10 5 20 10 100 50
Cable2/0/U3 230 10 30 10 5 20 10 100 50
Cable3/0/U0 230 10 30 10 5 20 10 100 50
Cable3/0/U1 230 10 30 10 5 20 10 100 50
Cable3/0/U2 230 10 30 10 5 20 10 100 50
Cable3/0/U3 230 10 30 10 5 20 10 100 50
Totals 1840 80 240 80 40 160 80 800 400
G10$root> show cable modem 2/0 upstream 0 summary↵
Display the counts for various operational states of all CMs in upstream channel 0 in slot 2 / interface 0.
Cable Modem Operational States
Interface CM Dstry Dclr Rng Rng Rng IP Reg Access
Qty Abort Compl Compl Denied
C2/0/U0 9 0 0 0 0 0 0 9 0
Table 3: Parameters Displayed by ‘show cable modem’ Command
Table 4: Description of Online States
Parameter Description
Interface The interface specified as Cslot/if/Uchannel.
Prim SID The primary Service ID (SID) of the CM.
Online State The state of the CM. Refer to Table 4 for a list of these states, then refer to Table 5 for the correspondence to the CM operational states that can be displayed with the summary option of the show cable modem command.
Timing Offset The timing adjustment provided by the CMTS in a ranging response. Units are (6.25µs/64).
Rec Power The receive power (dBmV) of the CM as detected by the CMTS.
QoS The Quality of Service (QoS) profile ID.
IP address The IP address of the CM.
MAC address The MAC address of the CM.
Ver The DOCSIS version of the CM.
State Description
init(r1) The CM has entered the declared state (see Dclr in Table 5).
init(r2) The CM has entered the ranging state (see Rng in Table 5).
init(rc) The CM has entered the ranging-complete state (see Rng Compl in Table 5).
init(i) The CM has entered the IP-complete state (see IP Compl in Table 5).
online The CM has entered the registration-complete state (see Reg in Table 5).
offline The CM is entered the destroyed or ranging-aborted state (see Dstry or Rng Abort, respectively, in Table 5).
reject The CM has entered the access-denied state (see Access Denied in Table 5).
show cable modem cpe
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference148
Table 5: Description of CM Operational States
Related Commands
show cable modem cpeshow cable qos profile
show cable modem cpe
This command displays a table of known CPEs behind a specified cable modem, or optionally, behind all cable modems supported by the G10 CMTS. For each CPE, the MAC address and, if known, the IP address are shown. CPE MAC and IP addresses are learned by the CMTS when CPEs send upstream traffic.
show cable modem cpe is a top-level command and is available to all users.
Syntax
show cable modem [<ip-address>|<mac-address>] cpe
Definitions
Operational State Description
Dstry Number of CMs in destroyed operational state. If a CM goes offline for more than 24 hours, it will be removed from the CMTS. A CM is briefly in this state during the removal process.
Dclr Number of CMs in declared operational state. A CM is in this state right after the CMTS receives the CM’s initial ranging request.
Rng Number of CMs in ranging operational state. A CM is in this state during its initial ranging.
Rng Abort Number of CMs in ranging-aborted operational state. A CM is in this state right after the CMTS aborts the ranging (initial or periodic) in its ranging response.
Rng Compl Number of CMs in ranging-complete operational state. A CM is in this state after it has completed its initial ranging.
IP Compl Number of CMs in IP-complete operational state. A CM is in this state right after the CMTS receives a registration request from the CM containing an IP address (TLV Type 12 or 20). The CM can transition from this state only from the ranging-completed state.
Reg Number of CMs in registration-complete operational state. A CM is in this state right after the CMTS sends an Okay registration response (DOCSIS 1.0) or receives an error-free registration acknowledgment (DOCSIS 1.1) from the CM.
Access Denied Number of CMs in access-denied operational state. A CM is in this state after one of several conditions occurs:
– A CM timed out before responding to an upstream channel change request– The CMTS responds to a DCI-REQ message with a DCI-RSP message containing a
confirmation code set to reject-permanent– The CM’s registration process failed
ip-address The IP address of the cable modem for which the associated CPEs are to be displayed. Standard dot-quad notation (xxx.xxx.xxx.xxx).
mac-address The MAC address of the cable modem for which the associated CPEs are to be displayed. Specified as xxxx.xxxx.xxxx in hexadecimal.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
show cable flap-list
149
Examples
G10$root> show cable modem 10.11.124.5 cpe↵
Display a table of known CPEs associated with the CM at IP address 10.11.124.5.
cpeMacAddr cpeIpAddr
-------------- ---------------
0000.0000.0051 10.11.124.151
0000.0000.0052 10.11.124.152
0000.0000.0053
0000.0000.0054 10.11.124.154
0000.0000.0055 10.11.124.155
G10$root> show cable modem cpe↵
Display a table of known CPEs associated with all CMs.
cmMacAddr cpeMacAddr cpeIpAddr
-------------- -------------- ---------------
0030.D002.1B6F 0000.0001.3001 10.132.2.201
0030.D002.1B6F 0000.0001.3002 10.132.2.202
0030.D002.1B6F 0000.0001.3003 10.132.2.203
0030.D002.1B6F 0000.0001.3004 10.132.2.204
0050.DAA7.6E12 0000.0001.3201 10.132.2.210
0050.DAA7.6E12 0000.0001.3202 10.132.2.211
0050.DAA7.6E12 0000.0001.3203 10.132.2.212
0050.DAA7.6E12 0000.0001.3204 10.132.2.213
Related Commands
clear cable modemshow cable modem
show cable flap-list
This command displays the flap-list sorted by the specified criteria. Refer to the cable modem flap-list command for details regarding the flap-list.
show cable flap-list is a top-level command and is available to all users.
Syntax
show cable flap-list {by-total-flaps|by-time|by-snr-flaps|by-cer-flaps|by-mer-flaps |by-im-flaps|by-sm-flaps|by-power-adjust|by-interface [<slot> [<if>]] |by-upstream [<slot> [<channel>]] | by-mac [<mac-address>]}
Definitions
by-total-flaps Sorts the flap-list in descending order of the Total column.
by-time Sorts the flap-list from most recent (top) to least recent (bottom) i.n the LTime column.
by-snr-flaps Sorts the flap-list in descending order of the SNR column.
show cable flap-list
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference150
Examples
G10$root# show cable flap-list by-total-flaps↵
Display the entire flap-list sorted by the total number of flaps (under the column labeled Total).
MacAddr CableIF IM SM PAdj SNR MER CER LTime
LEvnt Total SNRavg MERavg CERavg
0002.0001.2C28 C02/0 U00/0 0 0 72 0 0 0 May 06 15:
18:21 PADJ FLAP 72 34 27 0
0000.CA25.1C4A C02/0 U00/0 0 0 59 0 0 0 May 06 15:
10:42 PADJ FLAP 59 34 28 0
0020.40A7.278C C02/0 U00/0 45 0 3 0 1 0 May 06 15:
23:12 IM FLAP 49 34 12 72
00E0.6F03.1061 C02/0 U00/0 0 0 48 0 0 0 May 06 15:
21:40 PADJ FLAP 48 34 27 0
0050.DAA7.6E12 C02/0 U00/0 1 0 41 0 0 0 May 06 15:
20:11 PADJ FLAP 42 34 27 0
0030.D002.1B6F C02/0 U00/0 0 0 35 0 0 0 May 06 15:
19:57 PADJ FLAP 35 34 28 0
0020.407E.F330 C02/0 U00/0 0 0 16 0 0 0 May 06 15:
25:15 PADJ FLAP 16 34 28 0
Total checked entries 7
Table 6 explains each statistic provided in the flap-list. All thresholds cited in Table 6 are parameters within the cable modem flap-list and cable upstream modem flap-list CLI commands.
by-cer-flaps Sorts the flap-list in descending order of the CER column.
by-mer-flaps Sorts the flap-list in descending order of the MER column.
by-im-flaps Sorts the flap-list in descending order of the IM column.
by-sm-flaps Sorts the flap-list in descending order of the SM column.
by-power-adjust Sorts the flap-list in descending order of the PAdj column.
by-interface If the slot and if parameters are not specified, the flap-list is sorted in ascending order of slot, interface, and port in the CableIF column. Refer to slot and if to see their effect on the sorting.
slot If specified, only the flap-list entries associated with CMs on the DOCSIS Module slot are displayed.
Slot (1 to 4 or 10 to 13)
if If specified, only the flap-list entries associated with CMs on the slot and if are displayed.
Interface (0 to 3)
by-upstream If the sort and channel parameters are not specified, the flap-list is sorted in ascending order of slot, channel, and port in the CableIF column. Refer to slot and channel to see their effect on the sorting.
channel If specified, only the flap-list entries associated with CMs on the slot and channel are displayed.
The upstream channel (0 to 7 or 0 to 15, depending on the DOCSIS Module model)
by-mac If specified, only the flap-list entries associated with the CM that has a MAC address of mac-address are displayed.
mac-address MAC address of CM specified as xxxx.xxxx.xxxx in hexadecimal.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
show cable modulation-profile
151
Table 6: Flap-list Statistics
Related Commands
cable modem flap-listcable upstream modem flap-listclear cable modem flap-list
show cable modulation-profile
This command displays the configuration parameters of a cable modulation profile.
show cable modulation-profile is a top-level command and is available to all users.
Syntax
show cable modulation-profile [<profile-id> [<iuc>]]
Definitions
Statistic Description
MacAddr The MAC address of the CM that flapped.
CableIF The slot/interface and upstream channel/port on which the flapping CM resides, in the form: Cslot/interface Uchannel/port
IM This counter is incremented when the time between two successive initial maintenance attempts (ranging) by the CM is below the threshold im-retry-interval.
SM This counter is incremented when the number of consecutively missed station maintenance opportunities (ranging) by the CM is above the threshold sm-miss-threshold, and the CMTS subsequently receives a successful ranging request from the CM (this latter condition is required to discern whether the CM is missing station maintenance opportunities or is off-line).
PAdj This counter is incremented when the power adjustment sent to the CM during station maintenance is above the threshold power-adjust-threshold.
SNR This counter is incremented when the measured Signal-to-Noise Ratio (SNR) of the CM drops below threshold snr-threshold.
MER This counter is incremented when the measured Modulation Error Rate (MER) of the CM drops below threshold mer-threshold.
CER This counter is incremented when the measured Codeword Error Rate (CER) of the CM rises above cer-threshold.
LTime The timestamp that indicates when the CM flapped.
LEvnt A description of the type of flap that occurred.
Total This counter represents the total number of flaps that have occurred for the CM.
SNRavg The average SNR for the CM.
MERavg The average MER for the CM.
CERavg The average CER for the CM.
profile-id The modulation profile ID number of the profile to be displayed. Valid options are numbers from 1 to 256.
iuc DOCSIS interval usage code: request, reqdata, initial, station, short, long
show cable qos profile
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference152
Examples
G10$root> show cable modulation-profile 1↵
ModId IUC prelen seed mod dif fec data/fec brst guard lstcw scrmb
1 request(1) 68 0x0001 QPSK Y 0 16 0 6 2 Y
1 reqdata(2) 68 0x0001 QPSK Y 3 40 8 6 2 Y
1 initial(3) 52 0x0001 QPSK Y 3 34 0 5 2 Y
1 station(4) 52 0x0001 QPSK Y 3 34 0 5 2 Y
1 short(5) 36 0x0001 QPSK Y 3 40 8 5 1 Y
1 long(6) 36 0x0001 QPSK Y 3 100 0 5 1 Y
G10$root> show cable modulation-profile↵
Displays all profiles and interval usage codes.
G10$root> show cable modulation-profile 1 long↵
Only displays the long interval usage code parameters for profile ID 1.
Related Commands
cable modulation-profile
show cable qos profile
This command displays the details of the QoS (quality of service) profile in the CMTS.
show cable qos profile is a top-level command and is available to all users.
Syntax
show cable qos profile [<qos-profile-id>]
Definitions
Examples
G10$root> show cable qos profile 1↵
Display QOS profile 1.
Service Prio Max Guarantee Max Max tx Create Baseline
class upstream upstream downstream burst by privacy
bandwidth bandwidth bandwidth enable
1 0 1000000 0 10000000 0 cmts no
qos-profile-id The QOS profile ID number of the profile to be displayed. Valid options are numbers from 0 to 65535. If not specified, all defined QOS profiles are displayed.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
show cable shared-secret
153
show cable shared-secret
This command is used to display the specified authentication string shared between the provisioning server that provides a cable modem’s configuration file and the CMTS.
show cable shared-secret is a top-level command and is available to all users.
This command does not have a no form.
The default shared secret is DOCSIS.
Syntax
show cable shared-secret
Examples
G10$root> show cable shared-secret↵G10$root> Shared-secret is: DOCSIS
The shared secret authentication string (DOCSIS) is displayed.
Related Commands
cable shared-secret
show cable vpn
This command displays a list of active (registered) CMs and their associated CPE devices that are assigned to the specified VPN. If a CM is not registered, then the CM and its associated CPE devices are not displayed by this command, even if they have been previously assigned to a VPN. Active members of a VPN are displayed regardless of the manner in which they were assigned to the VPN (by the cable vpn command, or by configuration file provisioning).
show cable vpn is a top-level command and is available to all users.
Syntax
show cable vpn <vpn-id>
Definitions
vpn-id Displays all CMs and associated CPEs assigned to this VPN ID. Valid range is 129–4000.
show chassis environment
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference154
Examples
G10$root> show cable vpn 129↵
Display all CMs and associated CPEs assigned to VPN ID 129.
1234.1234.1234 cm
abcd.abcd.abcd cpe
Related Commands
cable vpn
show chassis environment
This command displays the status of various environmental parameters in the G10 CMTS chassis, including the temperature of each installed DOCSIS Module, fan speeds, power supply status, and the user notification temperature thresholds.
show chassis environment is a top-level command and is available to all users.
Syntax
show chassis environment
Examples
G10$root> show chassis environment↵
Displays the status of various environmental parameters.
Class Item Status Measurement
Temp DOCSIS Module Slot 2 OK 28 degrees C / 82 degrees F
Fans Left Fan Tray Fan 0 OK 4740 RPM
Left Fan Tray Fan 1 OK 4680 RPM
Left Fan Tray Fan 2 OK 5040 RPM
Left Fan Tray Fan 3 OK 4860 RPM
Left Fan Tray Fan 4 OK 4860 RPM
Left Fan Tray Fan 5 OK 4860 RPM
Right Fan Tray Fan 0 OK 5160 RPM
Right Fan Tray Fan 1 OK 5220 RPM
Right Fan Tray Fan 2 OK 5160 RPM
Right Fan Tray Fan 3 FAIL 0 RPM
Right Fan Tray Fan 4 FAIL 0 RPM
Right Fan Tray Fan 5 FAIL 0 RPM
Rear Fan Tray Fan 0 OK 4020 RPM
Rear Fan Tray Fan 1 OK 4020 RPM
Rear Fan Tray Fan 2 OK 4020 RPM
Rear Fan Tray Fan 3 OK 5760 RPM
Rear Fan Tray Fan 4 OK 5820 RPM
Rear Fan Tray Fan 5 OK 5820 RPM
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
show chassis hardware
155
Power Power Supply Normal
Temp User Notify High Threshold 60 degrees C / 140 degrees F
User Notify Low Threshold 40 degrees C / 104 degrees F
Related Commands
chassis environment ambient-temperatureshow chassis hardware
show chassis hardware
This command displays a list of all DOCSIS Modules, Chassis Control Modules, and NIC Modules installed in the CMTS, including (where applicable) the module version, part number, and serial number.
show chassis hardware is a top-level command and is available to all users.
Syntax
show chassis hardware [detail]
Definitions
Examples
G10$root> show chassis hardware↵
Displays a list of all modules installed in the CMTS.
Item Version Part Number Serial Number UpTime
CCM in slot 6 5.16 D Unknown 0 days 01:08:46
DM in slot 2 0.0 750-006610 012345 0 days 01:08:17
Related Commands
cable authorizechassis environment ambient-temperatureshow chassis environment
detail Specifies that more hardware details will be displayed.
show clock
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference156
show clock
This command displays the current time and date of the CMTS clock, and the NTP server IP address. The first line of the display represents the UTC time, the second line represents the local time, and the third line displays the IP address of an NTP server (if configured).
show clock is a top-level command and is available to all users.
Syntax
show clock
Examples
G10$root> show clock↵
Tue May 14 19:53:52 UTC 2002
Tue May 14 19:53:52 UTC 2002
ntp-server ip address: 192.168.72.55
Related Commands
clockclock ntp-serverclock showclock summertimeclock timezone
show configuration
This command is a synonym for show startup-config. Refer to show startup-config on page 166 for details.
show controller cable
This command displays DOCSIS channel statistics at the CMTS level, the slot/interface level, or for a single channel. The downstream channel statistics displayed include channel status, frequency, channel width, modulation, symbol rate, RF power, and interleaver depth. The upstream channel statistics displayed include channel status, frequency, channel width, symbol rate, modulation, SNR, input power, timing offset values, backoff window values, modulation profile group, and minislot size.
show controller cable is a top-level command and is available to all users.
Syntax
show controller cable [<slot/if> [downstream <channel> | upstream <channel>]]
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
show controller cable
157
Definitions
Examples
G10$root> show controller cable 2/0 downstream 0↵
This displays statistics for downstream channel 0 on slot 2 / interface 0.
C2/0/D0 is up
Frequency 531.000 Mhz, Channel Width 6 MHz, QAM256, Symbol Rate 5.360537 Msps
RF Power 61.0 dBmv
FEC ITU-T J.83 Annex B, R/S Interleave I=8, J=16
G10$root> show controller cable 2/0 upstream 0↵
This displays statistics for upstream channel 0 on slot 2 / interface 0.
C2/0/U0 is up
Frequency 14.000 MHz, Channel Width 0.200 MHz, Symbol Rate 160 Msps
Long Grant: QAM16, Short Grant: QAM16
SNR 3750 dB
Nominal Input Power Level 80 dBmV, Tx Timing Offset 19352
Ranging Backoff Start 1, Ranging Backoff End 5
Tx Backoff Start 3, Tx Backoff End 10
Modulation Profile Group 8
Minislot Size in number of Timebase Ticks is = 64
Minislot Size in Symbols = 64
G10$root> show controller cable 2/0↵
This displays statistics for all downstream and upstream channels on slot 2 / interface 0.
G10$root> show controller cable↵
This displays statistics for all downstream and upstream channels in the CMTS.
Related Commands
show interfaces
slot/if The slot number and interface number of the cable interface.
Slot (1 to 4 or 10 to 13) Interface (0 to 3)
downstream Specifies that a downstream interface will be displayed.
upstream Specifies that an upstream interface will be displayed.
channel The downstream channel number (0 to 3) or the upstream channel number (0 to 7 or 0 to 15, depending on the DOCSIS Module model).
show cpu
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference158
show cpu
This command displays the average Central Processing Unit (CPU) usage of the Chassis Control Module since the system was booted up, and during the latest specified interval. You can optionally instruct the CMTS to repeatedly display the CPU usage within this interval a specified number of times. The command displays the total usage, the percentage used by the current user, and the percentage used by the system (non-user usage).
show cpu is a top-level command and is available to all users.
The interval defaults to one second.
If repeat is not specified, the command displays the CPU usage since the system was booted, and the usage within one elapsed interval.
Syntax
show cpu [<interval> [<repeat>]]
Definitions
Examples
G10$root> show cpu↵
Displays the CPU usage since the system was booted, and the usage within the last second.
CPU average usage since the system was up:
Total Time: 28.8%
User Time: 4.0%
System Time: 24.7%
CPU current usage within latest 1 seconds:
Total Time: 0.0%
User Time: 0.0%
System Time: 0.0%
G10$root> show cpu 10 2↵
Displays the CPU usage since the system was booted, and the usage within the last 10 seconds. Because the repeat parameter was given (2), the CPU usage within the next two 10-second intervals is also displayed.
CPU average usage since the system was up:
Total Time: 24.6%
User Time: 3.4%
System Time: 21.1%
interval Specifies the window, in seconds, in which to measure the CPU usage. The window begins when the Enter key is pressed, and ends when <interval>seconds have elapsed. The default is one second.
repeat Specifies that the CPU usage during each interval is to be displayed repeatedly, <repeat> number of times. The default is 0.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
show debugging
159
CPU current usage within latest 10 seconds:
Total Time: 0.1%
User Time: 0.0%
System Time: 0.1%
CPU current usage within latest 10 seconds:
Total Time: 0.0%
User Time: 0.0%
System Time: 0.0%
CPU current usage within latest 10 seconds:
Total Time: 0.0%
User Time: 0.0%
System Time: 0.0%
Related Commands
show memory
show debugging
This command displays a list of debug filters—MAC addresses, Service IDs (SIDs), and slot/interfaces—that are currently being monitored for each debug event type (such as arp, range, and ucd).
show debugging is a top-level command and is available to all users.
Syntax
show debugging
Examples
G10$root> show debugging↵
Displays a list of debug filters that are currently being monitored for each debug event type.
Related Commands
debugdebug cabledebug cable clear filterdebug cable interface cable
show disk
This command displays usage information for user-accessible region in the CMTS local storage.
show disk is a top-level command and is available to all users.
show history
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference160
Syntax
show disk
Examples
G10$root> show disk
Displays usage information for user-accessible region.
Filesystem 1k-blocks Used Available Use% Mounted on
/dev/disk 63454 5520 54645 10% /
Related Commands
show memory
show history
This command is used to display a list of previously-executed commands, including the show history command just executed. To execute any of the commands displayed, enter ! followed by the number of the command displayed.
show history is a top-level command and is available to all users.
This command does not have a no form.
Syntax
show history
Examples
G10$root# show history
Execute configure terminal by entering !1.
1 configure terminal
2 interface fastEthernet 6/0
3 show
4 exit
5 interface cable 2/0
6 ip show
7 show history
G10$root# !1↵G10$root(config)#
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
show interfaces
161
Related Commands
history
show interfaces
This command displays packet and link statistics for all cable, fastEthernet, and gigaEthernet interfaces.
show interfaces is a top-level command and is available to all users.
Syntax
show interfaces cable <slot/if> downstream [<channel>]
show interfaces cable <slot/if> upstream [<channel>]
show interfaces cable <slot/if> sid [<sid>]
show interfaces fastEthernet <slot/if>
show interfaces gigaEthernet <slot/if>
Definitions
cable Specifies an interface cable in a DOCSIS Module.
slot/if The slot number and interface number of either the cable interface, the fastEthernet port, or the gigaEthernet port.
Slot (1 to 4 or 10 to 13) Interface (0 to 3)
slot Chassis slot number:
DOCSIS Module: 1 to 4 and 10 to 13.
Chassis Control Module: 6 and 7.
NIC Module: 5 and 9.
if Interface number to be configured:
DOCSIS Module: cable interfaces 0 to 3, Fast Ethernet ports 0 and 1
Chassis Control Module: Fast Ethernet port 0
NIC Module: Fast Ethernet ports 0–11, Gigabit Ethernet port 0 and 1
downstream Specifies that a downstream interface will be displayed.
upstream Specifies that an upstream interface will be displayed.
channel The downstream channel number (0 to 3) or the upstream channel number (0 to 7 or 0 to 15, depending on the DOCSIS Module model).
sid Specifies that the interface will be displayed based on the Service identifier.
sid Service identifier. (1–8191)
SIDs can be viewed with the show cable modem command.
fastEthernet Specifies a Fast Ethernet interface in a DOCSIS Module, a Chassis Control Module, or a NIC Module.
gigaEthernet Specifies a Gigabit Ethernet interface in a NIC Module.
show ip arp
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference162
Examples
G10$root> show interfaces cable 2/0 downstream↵
This displays statistics for the entire downstream interface at slot 2 / interface 0.
Cable 2/0: Downstream Channel 0 is up
2891025 packets output, 56183081 bytes, 3 discarded
0 output errors
G10$root> show interfaces cable 2/0 upstream 0↵
This displays statistics for upstream channel 0 at slot 2 / interface 0.
Cable 2/0: Upstream 0 is up
Received 6524 broadcast, 176840 multicasts, 795547 unicasts
2 discards, 1395 errors, 0 unknown protocol
978911 packets input, 53014 uncorrectable
377 noise, 37 microreflections
Cable 2/0: Upstream 1 is down
Received 6488 broadcast, 621 multicasts, 15615 unicasts
0 discards, 35 errors, 0 unknown protocol
22724 packets input, 0 uncorrectable
0 noise, 0 microreflections
G10$root> show interfaces cable 2/0 sid 4394↵
This displays statistics for service identifier 4394 operating through slot 2 / interface 0.
G10$root> show interfaces fastEthernet 6/0↵
Displays statistics for Fast Ethernet port 0 of the Chassis Control Module in slot 6.
FastEthernet 6/0
------------------
Name : FastEthernet6/0
Description : ""
Ip addr/mask : 192.168.21.49 255.255.255.0
Link Configuration:
Auto negotiation : on
Speed : 100
Duplex : full
AdminState : up
Current Link State :
Speed : 100
Duplex : full
OpState : up
show ip arp
This command displays specified entries or the entire ARP (Address Resolution Protocol) table. If no optional parameters are specified, the entire ARP table is displayed.
The Timeout value displayed indicates the timeout for dynamic entries (in seconds). The timeout duration can be set by the arp timeout command. A timeout of -1 indicates the entry is static.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
show local-log
163
show ip arp is a top-level command and is available to all users.
Syntax
show ip arp [<ip-address>|<mac-address>|<slot/if>]
Definitions
Examples
G10$root# show ip arp 10.131.2.1↵
Display any ARP table entries that have an IP address of 10.131.2.1.
IP Address MAC Address VLAN Id Timeout
10.131.2.1 0001.309F.2800 0 588
G10$root# show ip arp↵
Display the entire ARP table.
Related Commands
arparp timeoutcable address-verificationcable proxy-arpcable vpn
show local-log
This command displays the local event log of the CMTS that corresponds to the docsDevEventTable within the DOCSIS Cable Device MIB (RFC-2669). This log can assist with troubleshooting various issues. Refer to the DOCSIS OSSI specification and RFC-2669 for more details. The Juniper Networks G10 CMTS Operations and Maintenance manual provides a list of Juniper Networks-specific log events.
show local-log is a top-level command and is available to all users.
Syntax
show local-log
ip-address The IP address of the ARP table entry. Standard dot-quad notation (xxx.xxx.xxx.xxx). Multiple entries are displayed if an IP address is part of multiple VLANs.
mac-address The MAC address of the ARP table entry. Specified as xxxx.xxxx.xxxx in hexadecimal. Multiple entries may be displayed for a MAC address.
slot/if The slot number and interface number of the cable interface. Multiple entries may be displayed for a slot/interface.
Slot (1 to 4 or 10 to 13) Interface (0 to 3)
show memory
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference164
Examples
G10$root> show local-log↵
Displays the local event log of the CMTS. Table 7 provides the correspondence between the display headings and the RFC-2669 objects.
Time shown as : YYYY:MM:DD:HH:MM:SS:DS
Index Date/Time Level Id Description
----- ---------------------- ----------- ---------- ----------------------
1915 2002:05:08:18:36:36:03 warning 73000500 Registration rejected authen
tication failure: CMTS MIC invalid. MAC Addr: 00:50:DA:A7:6E:12
1916 2002:05:08:18:36:48:02 warning 73000500 Registration rejected authen
tication failure: CMTS MIC invalid. MAC Addr: 00:20:40:7E:F3:30
1917 2002:05:08:18:36:49:00 warning 73000500 Registration rejected authen
tication failure: CMTS MIC invalid. MAC Addr: 00:20:40:7E:F3:30
Table 7: Local Event Log Headings Displayed
Related Commands
log-level generatelog-level show
show memory
This command displays the memory usage of the Chassis Control Module, including the total, shared, free, buffer, and cached memory.
show memory is a top-level command and is available to all users.
Syntax
show memory
Display Headings RFC-2669 Object Meaning
Index docsDevEvIndex Relative ordering in the event log.
Date/Time docsDevEvFirstTime The time the entry was created.
Level docsDevEvLevel The priority level of the event.
Id docsDevEvId Unique identifier used by the G10 CMTS for the event type.
Description docsDevEvText A text description of the Id.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
show privilege
165
Examples
G10$root> show memory↵
Displays the memory usage of the CMTS.
Memory Usage
MemTotal: 253576 kB
MemFree: 186780 kB
MemShared: 0 kB
Buffers: 560 kB
Cached: 34628 kB
Related Commands
show disk
show privilege
This command displays the privilege levels of the current session’s user.
show privilege is a top-level command and is available to all users.
Syntax
show privilege
Examples
G10$root> show privilege↵
User root has the following access privilege:
Admin group access level : rw
Ip group access level : rw
Rf group access level : rw
Related Commands
show usernamesshow usersshow whoamiusernamewho
show running-config
This command displays the current CMTS configuration parameters being used. Information is not displayed for empty DOCSIS Module slots (refer to the show working-config command).
show running-config is a top-level command and is available to all users.
show startup-config
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference166
Syntax
show running-config
Examples
G10$root> show running-config↵
cable modulation-profile 1 initial 3 34 0 5 qpsk scrambler 1 diff 52 fixed
cable modulation-profile 1 long 3 100 0 5 qpsk scrambler 1 diff 36 shortened
cable modulation-profile 1 reqdata 3 40 8 6 qpsk scrambler 1 diff 68 fixed
cable modulation-profile 1 request 0 16 0 6 qpsk scrambler 1 diff 68 fixed
cable modulation-profile 1 short 3 40 8 5 qpsk scrambler 1 diff 36 shortened
cable modulation-profile 1 station 3 34 0 5 qpsk scrambler 1 diff 52 fixed
cable modulation-profile 2 initial 3 34 0 5 16qam scrambler 1 diff 104 fixed
cable modulation-profile 2 long 3 100 0 5 16qam scrambler 1 diff 64 shortened
continued...
cable shared-secret DOCSIS
clock timezone PST 0 0
hostname myhost-7
interface
cable 3/0
cable dhcp-giaddrcable downstream 0 channel-width 6000000cable downstream 0 frequency 531000000cable downstream 0 interleave-depth 8cable downstream 0 modulation 64qamcable downstream 0 rf-power 61no cable downstream 0 shutdowncable helper-address 192.168.200.5 cable-modem
continued...
Related Commands
show configurationshow startup-configshow working-config
show startup-config
This command displays the CMTS configuration parameters that will be used at the next start-up.
show startup-config is a top-level command and is available to all users.
Syntax
show startup-config
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
show tech-support
167
Examples
G10$root> show startup-config↵
cable modulation-profile 1 initial 3 34 0 5 qpsk scrambler 1 diff 52 fixed
cable modulation-profile 1 long 3 100 0 5 qpsk scrambler 1 diff 36 shortened
cable modulation-profile 1 reqdata 3 40 8 6 qpsk scrambler 1 diff 68 fixed
cable modulation-profile 1 request 0 16 0 6 qpsk scrambler 1 diff 68 fixed
cable modulation-profile 1 short 3 40 8 5 qpsk scrambler 1 diff 36 shortened
cable modulation-profile 1 station 3 34 0 5 qpsk scrambler 1 diff 52 fixed
cable modulation-profile 2 initial 3 34 0 5 16qam scrambler 1 diff 104 fixed
cable modulation-profile 2 long 3 100 0 5 16qam scrambler 1 diff 64 shortened
continued...
cable shared-secret DOCSIS
clock timezone PST 0 0
hostname myhost-7
interface
cable 3/0
cable dhcp-giaddrcable downstream 0 channel-width 6000000cable downstream 0 frequency 531000000cable downstream 0 interleave-depth 8cable downstream 0 modulation 64qamcable downstream 0 rf-power 61no cable downstream 0 shutdowncable helper-address 192.168.200.5 cable-modem
continued...
Related Commands
show configurationshow running-configshow working-config
show tech-support
This command displays the following useful information to assist technical support with troubleshooting:
The current time
The current software version and the names of upgrade, normal, and failsafe software packages
The Chassis Control Module and DOCSIS Module error logs
The chassis hardware details (equivalent to the show chassis hardware detail command)
Chassis Control Module memory usage (equivalent to the show memory command)
The local event log (equivalent to the show local-log command)
Internal warning and error status logs
Running configuration (equivalent to the show running-config command)
show tech-support
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference168
show startup-config is a top-level command and is available to all users
Syntax
show tech-support
Examples
G10$root> show tech-support↵
Current Time: Sat May 25 15:12:21 2002
====================== SW version ========================Software Version 2.1.1.11a (built on May 24 2002)Current Image : Normal
Upgrade Mode package: GX-v211-r11a_bahia_us
Normal Mode package: GX-v211-r11_bahia_us
FailSafe Mode Package: GX-v211-r11_bahia_us
============ CCM Fatal Error Log History =================<none>
======== Docsis Module Fatal Error Log History ===========<none>
================ Chassis Hardware =======================Hardware inventory:Item Version Part Number Serial Number Description
CCM in slot 6 5.16 D Unknown CCM Module 6 FastEthernet 0 N/A N/A N/A FastEthernet Port 0 FastEthernet 1 N/A N/A N/A FastEthernet Port 1continued...
================ Chassis Environment ====================Class Item Status Measurement
Temp DOCSIS Module Slot 2 OK 28 degrees C / 82 degrees F
Fans Left Fan Tray Fan 0 FAIL 0 RPM Left Fan Tray Fan 1 FAIL 0 RPM Left Fan Tray Fan 2 FAIL 0 RPMcontinued...
================ CCM Memory Usage ======================Memory UsageMemTotal: 253576 kBMemFree: 172620 kBMemShared: 0 kBBuffers: 656 kBCached: 44312 kB
===================== Local Log ==========================
Time shown as : YYYY:MM:DD:HH:MM:SS:DS
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
show upgrade-log
169
Index Date/Time Level Id Description----- ---------------------- ----------- ---------- ----------------------1 2002:05:24:20:30:04:04 error 66060510 Map Reject - Downstream Traffic Flow Not Mapped to BPI+ SAID (EC=8). MAC addr: 00:10:95:1D:18:432 2002:05:24:20:30:06:07 error 66060510 Map Reject - Downstream Traffic Flow Not Mapped to BPI+ SAID (EC=8). MAC addr: 00:10:95:1C:A7:8Acontinued...
========== Internal Warnig/Errror Status Logs ===========
Fri May 24 20:29:00 2002 , Status 0 File /homes/xxu/cmts_main/ccm/src/modules/mn
m/cmmf/mo/nicModule.cpp Line 267 Msg NIC-addInterface :: Object already exist
Fri May 24 20:29:00 2002 , Status 0 File /homes/xxu/cmts_main/ccm/src/modules/mn
m/cmmf/mo/nicModule.cpp Line 267 Msg NIC-addInterface :: Object already exist
continued...
================== Running Config =======================
arp timeout 600
no cable arp-verify
no cable drop-unverifiable-addresses
cable host downstream-filter default-group 0
cable host upstream-filter default-group 0
continued...
Related Commands
show chassis environmentshow chassis hardwareshow local-logshow memoryshow running-configshow version
show upgrade-log
This command displays all of the software upgrade log messages produced during the last four system reboots.
show usernames is a top-level command and is available to all users.
Syntax
show upgrade-log
Examples
G10$root> show upgrade-log↵
Displays the software upgrade log messages produced during the last four system reboots.
Related Commands
system applysystem auto-rollback
show usernames
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference170
show usernames
This command displays all usernames known to the CMTS, including those users that are not currently logged into the CMTS, along with their associated prompts and privileges.
show usernames is a top-level command and is available to all users.
Syntax
show usernames
Examples
G10$root> show usernames↵
Username : guest
Prompt : guest
Access rights : RF - rw
Username : root
Prompt : root
Access rights : AD - rw IP - rw RF - rw
Related Commands
show privilegeshow usersshow whoamiusernamewho
show users
This command displays all users currently logged into the CMTS.
show users is a top-level command and is available to all users.
Syntax
show users
Examples
G10$root> show users↵
SessionId Login Connection
0 root Console
1 usr1 172.17.19.61
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
show version
171
Related Commands
show privilegeshow usernamesshow whoamiusernamewho
show version
If an optional parameter is not specified, this command displays the version of software currently running in the CMTS and a copyright banner. If one of the optional parameters is specified, then the version of that specified software image is displayed. Refer to the system apply command for definitions of the software image types in the CMTS.
show version is a top-level command and is available to all users.
Syntax
show version [normal|failsafe|upgrade]
Definitions
Examples
G10$root> show version↵
Displays the version of the software currently running in the CMTS.
G10$root> show version normal↵
Displays the version of the normal software image.
Related Commands
system applysystem commit
show whoami
This command displays your current username.
show whoami is a top-level command and is available to all users.
normal Specifies that the version of the normal software image is to be displayed.
failsafe Specifies that the version of the failsafe software image is to be displayed.
upgrade Specifies that the version of the upgrade software image, if present in the archive, is to be displayed.
show working-config
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference172
Syntax
show whoami
Examples
G10$root> show whoami↵
root
Related Commands
show privilegeshow usernamesshow usersusernamewho
show working-config
This command displays the current CMTS configuration parameters being used. Information is displayed for empty DOCSIS Module slots that have been previously configured.
show working-config is a top-level command and is available to all users.
There are no parameters for this command.
Syntax
show working-config
Examples
G10$root> show working-config↵
cable modulation-profile 1 initial 3 34 0 5 qpsk scrambler 1 diff 52 fixed
cable modulation-profile 1 long 3 100 0 5 qpsk scrambler 1 diff 36 shortened
cable modulation-profile 1 reqdata 3 40 8 6 qpsk scrambler 1 diff 68 fixed
cable modulation-profile 1 request 0 16 0 6 qpsk scrambler 1 diff 68 fixed
cable modulation-profile 1 short 3 40 8 5 qpsk scrambler 1 diff 36 shortened
cable modulation-profile 1 station 3 34 0 5 qpsk scrambler 1 diff 52 fixed
cable modulation-profile 2 initial 3 34 0 5 16qam scrambler 1 diff 104 fixed
cable modulation-profile 2 long 3 100 0 5 16qam scrambler 1 diff 64 shortened
continued...
A DOCSIS Module can be configured using the CLI prior to its actual installation into the G10 CMTS.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
shutdown
173
cable shared-secret DOCSIS
clock timezone PST 0 0
hostname myhost-7
interface
cable 3/0
cable dhcp-giaddrcable downstream 0 channel-width 6000000cable downstream 0 frequency 531000000cable downstream 0 interleave-depth 8cable downstream 0 modulation 64qamcable downstream 0 rf-power 61no cable downstream 0 shutdowncable helper-address 192.168.200.5 cable-modem
continued...
Related Commands
show configurationshow running-configshow startup-config
shutdown
This command disables a cable interface, a Fast Ethernet interface, or a Gigabit interface. All upstream and downstream channels within a cable interface are affected by this command.
shutdown is a command within the interface cable, the interface fastEthernet, and the interface gigaEthernet sub-modes and requires read-write privilege.
Then no form of this command enables the targeted interface.
The cable interfaces, the Fast Ethernet interfaces, and the Gigabit interfaces are disabled by default.
Syntax
shutdown
no shutdown
Examples
G10$root# configure terminal↵G10$root(config)# interface cable 1/0↵G10$root(config-if-c1/0)# no shutdown↵
Enable all upstream and downstream channels on slot 1 / interface 0.
G10$root# configure terminal↵G10$root(config)# interface fastEthernet 6/0↵G10$root(config-if-f6/0)# no shutdown↵
Enable Fast Ethernet port 0 of the Chassis Control Module in slot 6.
snmp-server community
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference174
G10$root# configure terminal↵G10$root(config)# interface gigaEthernet 5/0↵G10$root(config-if-g5/0)# no shutdown↵
Enable Gigabit port 0 of the NIC Module in slot 5.
G10$root# configure terminal↵G10$root(config)# interface fastEthernet 6/0↵G10$root(config-if-f6/0)# shutdown↵
Disable Fast Ethernet port 0 of the Chassis Control Module in slot 6.
Related Commands
auto-negotiationduplexshowspeed
snmp-server community
This command specifies the read-only and read-write SNMP password community strings.
snmp-server community is a command within the configure terminal mode and requires read-write privilege.
no snmp-server community deletes all community strings.
Syntax
snmp-server community <community-string> {ro|rw}
no snmp-server community <community-string>
snmp-server show
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# snmp-server community myrwpw rw↵
Establishes myrwpw as the read-write SNMP password community string.
community-string Alphabetic string that will be used by all SNMP hosts to gain access to the CMTS.
ro Specifies the string is for read-only access.
rw Specifies the string is for read-write access.
show Displays the community strings.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
snmp-server host
175
Related Command
snmp-server host
snmp-server host
This command specifies the destination hosts that will receive SNMPv1 and SNMPv2c traps from the CMTS. Up to 10 SNMPv1 and up to 10 SNMPv2c destinations may be specified. An alternative way to specify trap destinations for SNMPv1, SNMPv2c, and SNMPv3 is to use the SNMP-TARGET-MIB tables. Those tables are distinct from the tables acted upon by the snmp-server host command. To avoid confusion, it may be advantageous to set up SNMP trap destination hosts either via the SNMP-TARGET-MIB tables or the snmp-server host command, but not both.
snmp-server host is a command within the configure terminal mode and requires read-write privilege.
There is no default setting for this command.
The no form of this command deletes the existing host address.
Syntax
snmp-server host <ip-address> version {1|2c} [port <port-number>]
no snmp-server host <ip-address> version {1|2c}
snmp-server show
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# snmp-server host 205.15.128.132 version 2c↵
Specify an IP address of 205.15.128.132 for the SNMP server. The SNMP version that will be used to send traps is 2c. The UDP port to which traps will be sent on this host is 162.
ip-address The IP address of the host that will receive SNMP traps. Standard dot-quad notation (xxx.xxx.xxx.xxx).
1|2c Identifies the version of SNMP to use during communication with the destination host.
show Displays the IP address, SNMP version, and trap port for each destination host that has been configured. Also displays the community strings that were set using the snmp-server community command.
port-number Optional UDP port number to which SNMP traps are sent. If not specified, the port number defaults to 162.
speed
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference176
G10$root(config)# snmp-server host 205.15.128.177 version 1 port 2345↵
Specify an IP address of 205.15.128.177 for the SNMP server. The SNMP version that will be used to send traps is 1. The UDP port to which traps will be sent on this host is 2345.
G10$root(config)# no snmp-server host 205.15.128.177 version 1↵
Removes the entry for the SNMP server with an IP address of 205.15.128.177 and SNMP version 1.
G10$root(config)# snmp-server show↵
Displays the IP address, SNMP version, and trap port for all configured SNMP servers.
NMS nodes table
----------------------------------------------------------------------
ipAddress: 205.15.128.177 SNMP version: 1 trap port: 2345
ipAddress: 205.15.128.132 SNMP version: 2 trap port: 162
Community string (r/o): public
Community string (r/w): private
Related Commands
snmp-server community
speed
This command specifies the speed when configuring Fast Ethernet ports.
speed is a command in the interface fastEthernet sub-mode, which is under the configure terminal mode, and requires read-write privilege.
There is not a no form to this command.
The default speed setting is 100.
Syntax
speed {10|100}
Definitions
10|100 Set the Ethernet port speed as 10Base-T or 100Base-T.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
system apply
177
Examples
G10$root# configure terminal↵G10$root(config)# interface fastEthernet 6/0↵G10$root(config-if-f6/0)# speed 100↵
Sets the speed for Fast Ethernet port 0 of the Chassis Control Module in slot 6 to 100Base-T.
system apply
This command instructs the CMTS to use either the normal, failsafe, or upgrade software images for the next system reboot. An image is defined as normal if it has been declared as such by the system commit command. The failsafe image is the image that was initially supplied by the factory and is never replaced. An upgrade image is a new software release that the CMTS has accepted for a trial by executing the system apply upgrade command (with the name of the upgrade image file).
system apply is a top-level command and requires read-write privilege.
system apply normal is used to instruct the CMTS to move to the committed image for the next bootup (refer to the system commit command). This command may also be used to cancel a system apply upgrade.
system apply failsafe instructs the CMTS to use the image and configuration that was initially supplied by the factory for the next bootup. The configuration file Startup.cli is renamed to Startup.cli.old to preserve the current configuration.
system apply upgrade with a filename instructs the CMTS to check the provided upgrade image file for compatibility, create a copy of it in its internal archive, and use the internal copy for the next bootup. If no filename is specified, the CMTS checks its internal archive for a previously-accepted upgrade image. If no image is found, an error is returned.
Software upgrade monitoring messages are displayed on the serial console, and are logged to /log/Upgrade.log. After each system reboot, the /log/Upgrade.log file is renamed to /log/Upgrade.log.1, and a new /log/Upgrade.log file is created. This cycling of log files keeps a history of up to four system reboots (up to /log/Upgrade.log.3). In addition, software upgrade messages are logged in the local event log, and the corresponding SNMP traps are generated (if enabled).
The no form of this command cancels any pending system apply command.
Syntax
system apply {normal|failsafe|upgrade [<filename>]}
no system apply
Definitions
normal Specifies that the normal software image is to be used for the next bootup.
system apply
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference178
Examples
G10$root# system apply failsafe↵G10$root# reload↵
The CMTS will reboot using the failsafe image and configuration. The Startup.cli file is renamed to Startup.cli.old.
G10$root# system apply failsafe↵G10$root# no system apply↵G10$root# reload↵
The CMTS will not use the failsafe image upon reboot, but will reboot using the committed image in its internal archive.
G10$root# system apply upgrade /GX_v12r11↵G10$root# reload↵
The CMTS will reboot using the upgrade image GX_v12r11 in the home directory.
Related Commands
show upgrade-logshow versionsystem auto-rollbacksystem commit
failsafe Specifies that the failsafe software image and the initial factory configuration file are to be used for the next bootup.
upgrade Specifies that the upgrade software image specified by filename is to be used for the next bootup.
filename The absolute path and filename of the upgrade software image.
The filename parameter must be specified with an absolute path.
After the CMTS has been rebooted following the execution of the system apply upgrade command, the system commit command must be executed to make the currently-executing image the normal image. Thereafter, this new normal image will be used for subsequent bootups.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
system auto-rollback
179
Guidance
It is recommended that you retain all upgrade image files (the files can be renamed or moved to any directory of your choice). This allows you the option of applying any of those retained upgrade images to the CMTS in the future. Although an upgrade image is copied to the G10 CMTS internal archive when the system apply upgrade command is executed, the archive should be considered a precaution against failures, and not a repository for multiple upgrade images. Any image files not needed can be deleted in the future.
system auto-rollback
This command enables an automatic recovery feature where the CMTS will rollback to a previous version of software if the system is unable to start the CLI and SNMP interfaces at bootup. If the system cannot boot up an upgrade image of software, the system is rolled back to the normal image. If the system cannot boot up a normal image of software, the system is rolled back to the failsafe image. Refer to the system apply command for definitions of the software image types in the CMTS.
system auto-rollback is a top-level command and requires read-write privilege.
Auto-rollback monitoring messages are displayed on the serial console, and are logged to /log/Upgrade.log. After each reboot following an auto-rollback, the /log/Upgrade.log file is renamed to /log/Upgrade.log.1, and a new /log/Upgrade.log file is created. This cycling of log files keeps a history of up to four reboots (up to /log/Upgrade.log.3).
The no form of this command disables the automatic recovery feature.
Syntax
system auto-rollback
Examples
G10$root# system auto-rollback↵
Enables the automatic recovery feature.
Related Commands
show versionsystem applysystem commit
system commit
This command is used to define the currently-executing software image as the normal image. It is typically used after the CMTS has been rebooted following the execution of the system apply upgrade command. Using system commit replaces the previously-committed image in the internal archive with the currently-running image. This command has no effect if the CMTS had used the normal image for bootup. Refer to the system apply command for definitions of the software image types in the CMTS.
system config-backup
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference180
system commit is a top-level command and requires read-write privilege.
Syntax
system commit
Examples
G10$root# system apply upgrade upgrade1.rpm↵G10$root# reload↵G10$root# system commit↵
The CMTS will reboot using the upgrade image upgrade1.rpm. This new image will be defined as the normal image and replaces the previously-committed image in the internal archive.
Related Commands
show versionsystem applysystem auto-rollback
system config-backup
This command stores all persistent configuration data—including the user database, the CLI configuration, and the SNMPv3 configuration—in the specified file. This command does not implicitly save the running-config file as the startup-config file. This can be accomplished with the write memory or copy running-config startup-config commands.
system config-backup is a top-level command and requires read-write privilege.
The system config-restore command can be used to restore the configuration that is save by the system config-backup command.
Syntax
system config-backup <filename>
Definitions
Examples
G10$root# system config-backup mycfg.cli↵
Saves the current configuration in mycfg.cli in the current directory.
filename The name of the file in which the current configuration is saved.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
system config-restore
181
Related Commands
system config-restore
system config-restore
This command stores all persistent configuration data—including the user database, the CLI configuration, and the SNMPv3 configuration—in file /home/backup, and resets the CMTS to either the factory configuration, or the configuration defined by the given filename, after the next reboot. The current running configuration and operation of the CMTS is not affected. Refer to the system config-backup command to see how to create a configuration backup file.
system config-restore is a top-level command and requires read-write privilege.
Syntax
system config-restore {factory|<filename>}
Definitions
Examples
G10$root# system config-restore factory↵
Saves the current configuration in /home/backup, and resets the CMTS to the factory configuration after the next reboot.
Related Commands
system config-backup
Guidance
To cancel the effect of this command, execute system config-restore /home/backup.
telnet
This command opens a Telnet session to the specified hostname or IP address.
telnet is a top-level command and is available to all users.
factory Specifies that the configuration is reset to the factory configuration after the next reboot.
filename Specifies that the configuration is reset to the configuration defined by this file after the next reboot.
terminal monitor
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference182
Syntax
telnet {<hostname>|<ip-address>}
Definitions
Examples
G10$root> telnet 192.163.25.8↵
Establish a Telnet session with the host at IP address 192.163.25.8.
Related Commands
ftptftp
terminal monitor
This command enables debug message output for the current Telnet or console session.
terminal monitor is a top-level command and requires read-debug privilege.
The no form of this command disables debug message output.
By default, debug message output is disabled.
Syntax
terminal monitor
no terminal monitor
Examples
G10$root# terminal monitor↵
Enables debug message output for the current session.
Related Commands
debug cable interface cabledebug cable mac-addressterminal speed
hostname The hostname to which the Telnet session is established.
ip-address The IP address of the host to which the Telnet session is established. Standard dot-quad notation (xxx.xxx.xxx.xxx).
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
terminal page-mode
183
terminal page-mode
This command enables the pagination of the display output.
terminal page-mode is a top-level command and is available to all users.
The no form of this command disables display pagination.
By default, display pagination is enabled.
Syntax
terminal page-mode
no terminal page-mode
Examples
G10$root# no terminal page-mode↵
Disables display pagination.
Related Commands
terminal monitorterminal speed
terminal speed
This command sets the maximum debug message output speed in characters per second for the current session. This command does not affect the display output speed attributed to non-debug CLI commands.
terminal speed is a top-level command and requires read-debug privilege.
The no form of this command sets the maximum terminal speed to the default of 128.
Syntax
terminal speed <speed>
no terminal speed
It is recommended that the debug message output speed be set conservatively for a console session to ensure that the performance of the CMTS is not severely impacted (Telnet sessions are not subject to this restriction). The appropriate maximum value to use is dependent on your particular environment.
tftp
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference184
Definitions
Examples
G10$root# terminal speed <200>↵
Set the maximum debug message output speed to 200 characters per second for the current session.
Related Commands
debug cable clear logdebug cable interface cabledebug cable mac-addressterminal monitor
tftp
This command uses TFTP (Trivial File Transfer Protocol) to copy a file from the specified server to the CMTS (or from the CMTS to the specified server). The current CLI directory is the target directory for any file transfers between the CMTS and the TFTP server.
tftp is a top-level command and requires read-write privilege.
Syntax
tftp get|put <ip-address> <filename>
Definitions
Examples
G10$root# tftp get 192.163.25.8 myfile↵
Copies the file myfile from the TFTP server at IP address 192.163.25.8 to the current directory of the CMTS.
speed The maximum debug message output speed in characters per second. There is no range checking performed on this parameter. A value of 0 sets the speed to the default (128).
get Copies the file from the server to the current directory of the CMTS.
put Copies the file from the current directory of the CMTS to the server.
ip-address The IP address of the server. Standard dot-quad notation (xxx.xxx.xxx.xxx).
filename The filename to transfer.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
traceroute
185
Related Commands
ftptelnet
traceroute
This command traces the connection to a given IP address or host name.
traceroute is a top-level command and is available to all users.
There is not a no form to this command.
There are no default settings for this command.
Syntax
traceroute {<ip-address>|<host-name>}
Definitions
Examples
G10$root# traceroute 192.168.201.104↵
traceroute to 192.168.201.104 (192.168.201.104), 30 hops max, 38 byte packets 1 192.168.201.104 (192.168.201.104) 0.271 ms
username
This command sets various values for establishing user access.
username is a command within the configure terminal mode and requires read-write privilege.
no username password removes the user’s password (a password is not required for the user).
no username group privilege removes the user’s privilege from the specified group.
no username name deletes the user from the CMTS.
There are no default settings for this command.
ip-address The IP address to be traced. Standard dot-quad notation (xxx.xxx.xxx.xxx).
host-name The host name corresponding to the address to be traced. Include the domain: xxxhost.yyydomain.com.
username
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference186
Syntax
username <name> password <password>
no username <name> password
username <name> group {ad|ip|rf|fs} privilege {rw|rd|ro}
no username <name> group {ad|ip|rf} privilege
username <name> prompt <prompt-string>
no username <name>
Definitions
Examples
G10$root# configure terminal↵G10$root(config)# username myname password myword↵
Define a username myname and assign a password of myword.
G10$root(config)# username myname group rf privilege rw↵
Assign username myname to the rf group with read-write privilege.
G10$root(config)# username myname prompt myprompt↵
Assign a prompt of myprompt for username myname. When user myprompt logs in, the prompt will appear as follows:
G10$myprompt(config)#G10$root(config)# no username myname↵
Delete username myname from the CMTS.
name The assigned user name for an individual or group.
password The password associated with the user name.
group Command groups:
ad – administration
ip – Network-side interface
rf – HFC network
fs – file system (only fs-rw and fs-ro are valid)
privilege Privilege levels:
rw – read-write
rd – read-debug
ro – read-only
prompt-string Unique prompt string for the user name.
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Command Listing
who
187
Related Commands
show privilegeshow usernamesshow usersshow whoamiwho
Guidance
In the event the password for username root is lost, you can reset the password to the default of changme by performing the following procedure on the console port (not supported within a Telnet session):
1. Reboot the CMTS by executing the reload command or by power cycling the system.
2. When you see the following messages displayed on the console, type passwordreset:
Waiting for system to start-up ...Waiting for completion of system initialization ...
3. When prompted, log into the CMTS as user root with a password of changeme.
who
This command is a synonym for show users. Refer to show users on page 170 for details.
write memory
This command sets the startup-config file to be a duplicate of the current running-config file. Use this command if you are going to reboot the CMTS and want it to reload with the configuration currently in the running-config file. This command produces the same result as the command copy running-config startup-config. The startup-config file is stored in the home directory as Startup.cli.
write memory is a top-level command and requires read-write privilege.
There is not a no form of the command.
There are no parameters for this command.
Examples
G10$root# write memory
Copy the running-config file to the startup-config file.
Related Commands
copy
write memory
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference188
••••••••••••••••••••••••••••••••••••••••••••••••
Login, Prompts, and Keys 189
Appendix ALogin, Prompts, and Keys
This appendix provides information about navigating and general operation of the Command Line Interface (CLI).
Login
Upon initial installation, before user names and passwords have been established, use these factory defaults:
Username: root
Password: changeme
Prompts
The factory default prompt is:
G10$root#
The examples in this manual use this default prompt.
The prompt is derived from the CMTS host name (G10) and the logged in user name (root). Both of these can be changed with the hostname and username commands, respectively.
The last character of the prompt denotes whether you have privileged access (read-write and read-debug) or non-privileged access (read-only):
Privileged access: #
Non-privileged access: >
Login, Prompts, and Keys
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference190
Key Commands
The list of key commands can be displayed by entering the help edit-keys command.
Enter Execute command
This command is denoted with the ↵ symbol in this manual.
Tab Word completion
Backspace Erase before cursor. Same as Delete.
Delete Erase before cursor. Same as Backspace.
? List available options (context-sensitive help)
Ctrl-d Delete current character
Ctrl-u Delete text up to cursor
Ctrl-k Delete from cursor to end of line
Ctrl-a Move to the beginning of the line
Ctrl-e Move to the end of the line
Ctrl-p Get prior command from buffer
Ctrl-n Copy next command from buffer
Ctrl-f Move forward a character
Ctrl-b Move cursor left
Ctrl-f Move cursor right
Ctrl-w Delete word up to cursor
Ctrl-t Transpose current and previous character
Ctrl-z Enter command and return to top-level prompt
Ctrl-l Clear screen, retain command line input
Ctrl-c Clear current command line input
Esc-b Move back one word
Esc-f Move forward one word
Esc-c Convert rest of word to uppercase
Esc-l Convert rest of word to lowercase
Esc-d Delete remainder of word
••••••••••••••••••••••••••••••••••••••••••••••••
Configuration Notes 191
Appendix BConfiguration Notes
When configuring an interface cable or an interface fastEthernet, you must provide slot and interface numbers. For the interface cable, you must also provide port and channel numbers.
Slot Numbers
DOCSIS Module
DOCSIS Module
DOCSIS Module
DOCSIS Module
DOCSIS Module
DOCSIS Module
DOCSIS Module
DOCSIS Module
NIC Module
Chassis Control Module
Chassis Control Module
HFC Connector Module
HFC Connector Module
HFC Connector Module
HFC Connector Module
HFC Connector Module
HFC Connector Module
HFC Connector Module
HFC Connector Module
CHASSISTOP VIEW
Midplane
Fro
ntR
ear
NIC Access Module 5
6
4
3
2
1
7
8
9
10
11
12
13
with logical slot numbers
NIC Module
NIC Access Module
CCM Access Module
CCM Access Module
Use the logical slot numbers shown in this illustration for configuration tasks.
Configuration Notes
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference192
Interface, Port and Channel Numbers
Interface
A cable interface is a logical entity that consists of at least one upstream and one downstream port. A cable interface is the same as a MAC domain. The traffic through even numbered cable interfaces (0 and 2) is forwarded through the Ethernet port 0 on the HFC Connector Module, while traffic through odd numbered cable interfaces (1 and 3) is forwarded through the Ethernet port 1 on the HFC Connector Module. This relationship is summarized in Table 8.
Table 8: Cable Interface to Ethernet Port Association
Interface is also used describe the Fast Ethernet and the Gigabit Ethernet ports, which are also configurable. Here, the interface number is the port number.
Port
A port is a physical connector.
Use the numerical part of the connector label for the port ID during configuration tasks.
Channel
A channel is a logical entity. There are four downstream channels and 8 or 16 upstream channels (depending on the DOCSIS Module model) routed through each HFC Connector Module / DOCSIS Module pair.
Downstream channels are assigned one-each to the DS ports. Channels are enumerated 0 – 3.
Upstream channels can be assigned to any US port. Channels are enumerated 0 – 7 or 0 – 15, depending on the DOCSIS Module model.
Cable Interface Associated Ethernet Port
0 Eth0
1 Eth1
2 Eth0
3 Eth1
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Configuration Notes 193
Configuration Notes
Defaults
Table 9 through Table 11 on page 194 summarize the various assignments described above. Note that the downstream and upstream channel to cable interface assignments and the upstream channel to upstream port assignments specified in these tables are the factory defaults, and can be changed through the CLI or the startup-config file. The default assignments are used if the startup-config file does not assign any downstream or upstream channels to a MAC domain. Refer to Figure 1 on page 195 to view the ports on the HFC Connector Module and the Chassis Control Module.
Table 9: Downstream Channel Assignment
Table 10: Upstream Channel Assignment (8-Channel DOCSIS Module)
Cable Interface Downstream Channel Downstream Port
0 0 DS 0
1 1 DS 1
2 2 DS 2
3 3 DS 3
Cable Interface Upstream Channel Upstream Port
0 0 US 0
1
1 2 US 1
3
2 4 US 2
5
3 6 US 3
7
Configuration Notes
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference194
Table 11: Upstream Channel Assignment (16-Channel DOCSIS Module)
Cable Interface Upstream Channel Upstream Port
0
0
US 01
8
9
1
2
US 13
10
11
2
4
US 25
12
13
3
6
US 37
14
15
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Configuration Notes 195
Configuration Notes
Figure 1: HFC Connector Module and Chassis Control Module
Eth0
Eth1
US 3
US 2
US 1
US 0
DS 3
DS 2
DS 1
DS 0
Eth0
HFC Connector Module Chassis Control Module
Configuration Notes
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference196
••••••••••••••••••••••••••••••••••••••••••••••••
Security 197
Appendix CSecurity
This appendix describes the groups and privileges used to implement security and user access in the Command Line Interface (CLI).
Access to CLI commands is granted to users based on their assigned group and privilege. This matrix is shown in Table 12.
Table 12: Group/Privilege Matrix
Groups
Groups are associated with commands in the following manner:
IP – Those commands that relate to network-side functions. Examples are Ethernet port and IP configuration.
RF – Those commands that relate to hybrid fiber/coax-side functions. Examples are interface cable configuration and modulation profile set-up.
AD – Those commands limited to basic administration functions.
FS – Those commands limited to functions that affect the file system.
Some commands belong to multiple groups.
RW (Read-Write) RD (Read-Debug) RO (Read-Only)Group
IP (Network Side) ip-rw ip-rd ip-ro
RF (HFC Side) rf-rw rf-rd rf-ro
AD (Administration) ad-rw ad-rd ad-ro
FS (File System) fs-rw — fs-ro
Security
••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
Juniper Networks G10 CMTS CLI Reference198
Privileges
Each command in the CLI is associated with all the privileges that may be needed to operate that command as follows:
RW – Read-write allows a user to obtain a display from a command, and to input parameters to the command.
RD – Read-debug allows access to the series of debug commands. It also limits access to some of the show commands.
RO – Read-only allows a user to obtain a display from a command.
The three categories of privileges are hierarchical:
Commands
Each command in the CLI hierarchy of commands has one or more group-privileges associated with it. You cannot change this association. See “Command Summary” on page 1 for associations, which are shown with abbreviations such as ip-ro, rf-rw and so forth.
Users
Each user can be assigned to multiple groups and privileges with the username command:
username <name> group {ad|ip|rf|fs} privilege {rw|ro|rd}
root is a username built in to the G10 CMTS that is assigned to all group-privileges.
A user that is not assigned to a group has access to a limited set of commands (refer to those commands that have a group of all in the “Command Summary” on page 1).
This Level Can Also Access This Level
RW RD, RO
RD RO
RO —