juniper networks g10 cmts · about this manual ix about this manual this section describes...

Juniper Networks, Inc.

1194 North Mathilda Avenue

Sunnyvale, CA 94089

USA

408-745-2000

www.juniper.net

Part Number: 530-006437-01, Revision 2

Juniper NetworksG10 CMTS

CLI Reference

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

ii

This product includes the Envoy SNMP Engine, developed by Epilogue Technology, an Integrated Systems Company. Copyright © 1986–1997, Epilogue Technology Corporation. All rights reserved. This program and its documentation were developed at private expense, and no part of them is in the public domain.

This product includes memory allocation software developed by Mark Moraes, copyright © 1988, 1989, 1993, University of Toronto.

This product includes FreeBSD software developed by the University of California, Berkeley, and its contributors. All of the documentation and software included in the 4.4BSD and 4.4BSD-Lite Releases is copyrighted by The Regents of the University of California. Copyright © 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994. The Regents of the University of California. All rights reserved.

GateD software copyright © 1995, The Regents of the University. All rights reserved. Gate Daemon was originated and developed through release 3.0 by Cornell University and its collaborators. Gated is based on Kirton’s EGP, UC Berkeley’s routing daemon (routed), and DCN’s HELLO routing protocol. Development of Gated has been supported in part by the National Science Foundation. Portions of the GateD software copyright © 1988, Regents of the University of California. All rights reserved. Portions of the GateD software copyright © 1991, D. L. S. Associates.

This product includes software developed by Maker Communications, Inc., Copyright © 1996, 1997, Maker Communications, Inc.

Juniper Networks is registered in the U.S. Patent and Trademark Office and in other countries as a trademark of Juniper Networks, Inc. G10, Internet Processor, Internet Processor II, JUNOS, JUNOScript, M5, M10, M20, M40, M40e, and M160 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.

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 History28 February 2002—Second Edition.

The information in this document is current as of the date listed in the revision history.

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.

Products made or sold by Juniper Networks (including the G10 CMTS, M5 router, the M10 router, the M20 router, the M40 router, the M40e router, the M160 router, and the JUNOS software) or components thereof may be covered by one or more of the following patents which are owned by or licensed to Juniper Networks: U.S. Patent Nos. 5,473,599, 5,905,725, 5,909,440.

YEAR 2000 NOTICE

Juniper Networks hardware and software products are Year 2000 compliant. The JUNOS software has no known time-related limitations through the year 2038. However, the NTP application is known to have some difficulty in the year 2036.

Export Restrictions

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 .................................................................................................................ixOrganization ..........................................................................................................ixDocument Conventions ..........................................................................................xG10 CMTS Document Set.......................................................................................xi

Chapter 1Commands Summary .............................................................................................1

Chapter 2Commands Listing ...................................................................................................5

Management Commands........................................................................................5Common Abbreviation............................................................................................5auto-negotiation......................................................................................................6banner exec............................................................................................................7banner incoming ....................................................................................................7banner login ...........................................................................................................8banner motd...........................................................................................................9cable dhcp-giaddr .................................................................................................10cable downstream frequency................................................................................11cable downstream interleave-depth ......................................................................12cable downstream modulation..............................................................................13cable downstream rf-power ..................................................................................13cable downstream show .......................................................................................14cable downstream shutdown ................................................................................15cable helper-address .............................................................................................16cable host downstream-filter default-group ...........................................................17cable host upstream-filter default-group................................................................18cable insertion-interval .........................................................................................18cable ip-broadcast-echo ........................................................................................19cable ip-multicast-echo .........................................................................................20cable modem downstream-filter default-group .....................................................20cable modem upstream-filter default-group ..........................................................21cable modulation-profile .......................................................................................22cable ranging-attempts .........................................................................................24cable relay-agent-option........................................................................................25cable shared-secret ...............................................................................................25cable show............................................................................................................26cable sync-interval ................................................................................................27cable ucd-interval..................................................................................................27

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

Juniper Networks G10 CMTS CLI Referenceiv

cable upstream channel-width ..............................................................................28cable upstream data-backoff.................................................................................29cable upstream frequency ....................................................................................30cable upstream-load-balance ................................................................................31cable upstream minislot-size ................................................................................31cable upstream modulation-profile .......................................................................32cable upstream port..............................................................................................33cable upstream power-level ..................................................................................33cable upstream range-backoff...............................................................................34cable upstream show............................................................................................35cable upstream shutdown.....................................................................................36cat ........................................................................................................................37cd .........................................................................................................................37change-password..................................................................................................38clock.....................................................................................................................38clock ntp-server ....................................................................................................39clock show............................................................................................................40clock summer-time...............................................................................................41clock timezone .....................................................................................................42configure memory ................................................................................................43configure terminal ................................................................................................43copy .....................................................................................................................44delete ...................................................................................................................44description............................................................................................................45dir.........................................................................................................................46disable ..................................................................................................................47duplex ..................................................................................................................47enable...................................................................................................................48exit .......................................................................................................................48help ......................................................................................................................49hostname .............................................................................................................50interface cable ......................................................................................................51interface fastEthernet ...........................................................................................51ip address .............................................................................................................52ip default-gateway ................................................................................................53ip domain-name ...................................................................................................54ip name-server .....................................................................................................55ip show.................................................................................................................56logout ...................................................................................................................56mkdir....................................................................................................................56ls ..........................................................................................................................57more.....................................................................................................................58ping ......................................................................................................................59pwd ......................................................................................................................59reload ...................................................................................................................60rename.................................................................................................................60rmdir ....................................................................................................................61show cable modem ..............................................................................................62show cable modulation-profile..............................................................................62show cable qos profile ..........................................................................................63show cable shared-secret......................................................................................64show clock............................................................................................................64show history .........................................................................................................65show interfaces ....................................................................................................66show privilege ......................................................................................................67show running-config .............................................................................................67show startup-config ..............................................................................................68

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

Table of Contents v

show usernames...................................................................................................69show users............................................................................................................69show version ........................................................................................................70show whoami .......................................................................................................70shutdown..............................................................................................................70snmp-server community.......................................................................................71snmp-server host .................................................................................................72speed....................................................................................................................73traceroute .............................................................................................................73username..............................................................................................................74write memory.......................................................................................................75

Appendix ALogin, Prompts, and Key ...................................................................................77

Login.....................................................................................................................77Prompts................................................................................................................77Key Commands ....................................................................................................78

Appendix BConfiguration Notes .............................................................................................79

Slot Numbers ........................................................................................................79Interface, Port and Channel Numbers...................................................................80

Appendix CSecurity ........................................................................................................................83

Groups ..................................................................................................................83Privileges ..............................................................................................................83Commands ...........................................................................................................84Users ....................................................................................................................84

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

Juniper Networks G10 CMTS CLI Referencevi

••

List of TablesList of Tables
••••••••••••••••••••••••••••••••••••••••••••••
Table 1: Interleaver Depth Parameters .............................................................12Table 2: Cable Interface to Ethernet Port Association .......................................80Table 3: Cable Interface to Downstream Channel and Port Association............81Table 4: Default Cable Interface to Upstream Channel Association...................81Table 5: Group/Privilege Matrix........................................................................83

List of Tables vii

List of Tables

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

viii
Juniper Networks G10 CMTS CLI Reference

••••••••••••••••••••••••••••••••••••••••••••••••

About This Manual ix

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, “Commands Summary” – Provides a list of top-level commands and a list of all commands organized by hierarchy.

Chapter 2, “Commands Listing” – Provides an alphabetical listing of all commands. Includes syntax, definitions, examples and further guidance where applicable.

Appendix A, “Login, Prompts, and Key” – 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 Referencex

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 xi

G10 CMTS Document Set


Pre-InstallationGuide

Installation andConfiguration

Getting Started FunctionalDescription

SNMP and Enterprise MIBSpecification

PREPARATION OPERATION REFERENCE

Operation andMaintenance

CLI Reference

530-006434-01

530-006437-01

530-006461-01530-006435-01530-006433-01

530-006459-01530-006436-01


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

Juniper Networks G10 CMTS CLI Referencexii

••

Chapter 1Commands Summary
••••••••••••••••••••••••••••••••••••••••••••••
This section lists all the CLI commands in hierarchical structure.

The Group–Privilege column denotes the security access levels assigned to the command. See Appendix C, “Security”, for details.

Group –Privilege

Top Level Commands Subordinate Commands

all-ro cat cat <file_name>

all-ro cd cd <dir-name>

change-password

ad-rw clock clock adjust <adjustment>

ad-rw clock set <time> <day_of_month> <month_of_year> <year>

ad-rw configure memory

all-rw configure terminal (mode)

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 host downstream-filter default-group <pkt-filter-grp>

ip-rw cable host upstream-filter default-group <pkt-filter-grp>

ip-rw cable modem downstream-filter default-group <pkt-filter-grp>

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>

Commands Summary 1

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

2

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>

ad-rw cable upstream-load-balance

ad-rw clock ntp-server <ip-address>

all-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>]

ip-rw hostname <name>

all-rw hostname show

rf-rw interface cable <slot>/<if>

ip-rw cable dhcp-giaddr <ip-address> [cable-modem|host]

rf-rw cable downstream <channel> frequency <freq>

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 ranging-attempts <number-of-attempts>

ip-rw cable relay-agent-option

rf-rw cable show

rf-rw cable sync-interval <interval>

rf-rw cable ucd-interval <interval>

rf-rw cable upstream <channel> channel-width <width>

rf-rw cable upstream <channel> data-backoff <start> <end>

rf-rw cable upstream <channel> frequency

rf-rw cable upstream <channel> minislot-size {2|4|8|16|32|64|128}

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

Group –Privilege



••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

rf-rw cable upstream <channel> shutdown

rf-rw description <string>

ip-rw ip address <ip-address> <mask>

ip-rw ip show

all-rw interface fastEthernet <slot>/<if>

ip-rw auto-negotiation {on|off}

ip-rw description

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 ip default-gateway <ip-address> [management]

ip-rw ip domain-name <domain>

ip-rw ip name-server <ip-address>

ip-rw ip route <dest-prefix> <prefix-mask> <gateway-addr> [<distance>]

ip-rw ip show

ip-rw snmp-server community <community-string> {ro|rw}

ip-rw snmp-server host <ip-address> version {1|2c} [port <port_number>]

ad-rw username <name> group {ad|ip|rf} privilege {rw|rd|ro}

ad-rw username <name> password <password>

ad-rw username <name> prompt <prompt-string>

all-rw copy copy <source-file> <dest-file>

all-rw delete delete <file-name>

all-ro dir dir [directory-name]

all-rw disable disable

all-ro enable enable

all-ro exit exit (Available only at configure terminal mode and sub-modes)

all-ro help help (Available at all levels)

all-ro logout logout

all-ro ls same as dir

all-rw mkdir mkdir <name>

Group –Privilege


Commands Summary 3

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

4

all-ro more more <file_name>

all-ro ping ping [ip] {<ip-address>|<hostname>}

ping cable-modem {<ip-address>|<mac-address>}

all-ro pwd pwd

all-rw reload reload

all-rw rename rename {[path] source-filename [path] dest-filename}

all-rw rmdir rmdir <directory-name>

all-ro show show cable modem {<ip-address>|<mac-addr>|<slot>/<if>}

all-ro show cable modulation-profile [<profile-id> [<iuc>]]

all-ro show cable qos profile

all-ro show cable shared-secret

all-ro show clock

all-ro show history

all-rw show interfaces {cable|fastEthernet} {<slot>/<if>}

all-ro show privilege

all-rw show running-config

all-rw show startup-config

all-rw show usernames

all-ro show users

all-ro show version

all-ro show whoami

ip-ro traceroute traceroute {<ip-address>|<host-name>}

all-rw write memory

Group –Privilege



••

Chapter 2Commands 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:

Common Abbreviation

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.

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

Commands Listing 5

auto-negotiation

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

6

auto-negotiation

This command enables or disables the automatic negotiation of link speed and duplex setting for the Ethernet interfaces in an HFC Connector Module or Chassis Control 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

Examples

G10$root# configure terminal↵G10$root(config)# interface fastEthernet 4/1↵G10$root(config-if-f4/1)# auto-negotiation on↵

Auto-negotiation is enabled for the Ethernet interfaces of the HFC Connector Module populated in slot 4 / interface 1 of the CMTS.

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

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.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

banner exec

banner exec

This command specifies a message that is displayed in the password field after a user successfully logs in. 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.

no banner exec removes the banner display.

Syntax

banner exec <"banner-string">

Definitions

Examples

G10$root# configure terminal↵G10$root(config)# banner exec "Exec Banner"↵

The banner displayed will be Exec Banner:

user: rootpassword: Exec Banner

Related Commands

banner incomingbanner loginbanner motdbanner show

banner incoming

This command specifies a banner that is displayed below the header when the Telnet session is first established. 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.

no banner incoming removes the banner display.

banner-string Specifies the banner that is displayed. The string is comprised of a sequence of text characters

Commands Listing 7

banner login

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

8

Syntax

banner incoming <"banner-string">

Definitions

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.1.0.14

Incoming BannerWed Feb 20 15:05:54 2002

Related Commands

banner execbanner loginbanner motdbanner show

banner login

This command is used to specify the message that is displayed when a user logs in. 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 terminal configuration mode.

no banner login removes the banner display.

Syntax

banner login <"banner-string">

Definitions




••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

banner motd

Examples

G10$root# configure terminal↵G10$root(config)# banner login "Login Banner"↵

The banner displayed will be Login Banner.

Related Commands

banner execbanner incomingbanner motdbanner show

banner motd

This command is used to specify a message that is displayed when a session is first started. 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 terminal configuration mode.

no banner motd removes the banner display.

Syntax

banner motd <"banner-string">

Definitions

Examples

G10$root# configure terminal↵G10$root(config)# banner motd "MOTD Banner"↵

The banner displayed will be MOTD Banner.

Related Commands

banner execbanner incomingbanner loginbanner show

banner-string Specifies the banner that is displayed. The string is comprised of a sequence of text characters.

Commands Listing 9

cable dhcp-giaddr

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

10

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 two separate GIADDR's—one for cable modems and the other 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. 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 disables the giaddr-address feature.

Syntax

cable dhcp-giaddr <ip-address> [cable-modem|host]

no cable dhcp-giaddr <ip-address>

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↵

An IP address of 192.111.210.88 is inserted into the GIADDR field of broadcast DHCP packets received on slot 4 / interface 1.

Related Commands

cable helper-addresscable relay-agent-option

ip-address The 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 frequency

cable downstream frequency

This command sets the IF-to-RF upconverter output frequency for the specified downstream channel in the HFC Connector 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.

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 <freq>

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 if-powercable downstream modulation

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.

freq The center frequency, in Hz, for the channel. The valid range is 54000000 (54 MHz) to 1000000000 (1 GHz), inclusive.

Commands Listing 11

cable downstream interleave-depth

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

12

cable downstream interleave-depth

This command sets the depth of the interleaver for the specified downstream channel in an HFC Connector Module. 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.

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}

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.

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

Related Commands

cable downstream show

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.


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.

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.

Commands Listing 13


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

14

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.

Syntax

cable downstream <channel> rf-power <power-level>

Definitions

Examples

G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable downstream 1 rf-power 550↵

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


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.


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 tenths of dBmV. Range is 500 to 610 (50 to 61 dBmv).


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

cable downstream shutdown

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 up4233 packets output, 267044 bytes, 0 discarded0 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.

Commands Listing 15

cable helper-address

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

16

Related Commands

cable upstream shutdownshutdown

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 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.


Syntax

cable helper-address <ip-address> <next-hop> [cable-modem|host]

Definitions

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.

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).

If neither the cable-modem nor the host keyword is given, the specified DHCP server is used for both cable modems and CPE devices.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

cable host downstream-filter default-group

Related Commands

cable dhcp-giaddrcable relay-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. 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 manually provisioned. Filter groups are defined in the SNMP MIB and are used to filter IP packets that meet a set of criteria. The modified entity corresponds to the SNMP MIB object docsSubMgtSubFilterDownDefault.

You must change the default value of this command to enable filtering.

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

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 host upstream-filter default-groupcable modem downstream-filter default-groupcable modem upstream-filter default-group

pkt-filter-grp The number of the packet filter group to be used. (0 to 1024)

Commands Listing 17

cable host upstream-filter default-group

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

18

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. This command sets the default packet filter group for upstream traffic to cable modems. The specified default filter group is automatically associated with cable modems for which no filter group has been manually provisioned. Filter groups are defined in the SNMP MIB 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

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 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 opportunties 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 ip-broadcast-echo

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>

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 25 milliseconds.


This command enables the upstream IP broadcast echo for the specified slot/interface.

cable broadcast-echo is a command within the interface cable sub-mode and requires read-write privilege.

no cable ip-broadcast-echo disables the upstream IP broadcast echo.

There are no user-defined parameters in this command.

By default, broadcast echo is enabled.

Syntax


Examples

G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable ip-broadcast-echo↵

interval The number of milliseconds between initial maintenance intervals. Range is 1 to 200.

Commands Listing 19

cable ip-multicast-echo

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

20

Forward all upstream IP broadcast packets on slot 4 / interface 1.

Related Commands



This command enables the upstream IP multicast echo for the specified slot/interface.

cable multicast-echo is a command within the interface cable sub-mode and requires read-write privilege.

no cable ip-multicast-echo disables the upstream IP multicast echo.

There are no user-defined parameters in this command.

By default, multicast echo is enabled.

Syntax


Examples

G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable ip-multicast-echo↵

Forward all upstream IP multicast packets on slot 4 / interface 1.

Related Commands


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 manually provisioned. Filter groups are defined in the SNMP MIB 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.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

cable modem upstream-filter default-group

The default value for this command is 0, indicating no packet filtering for downstream traffic to the cable modem.

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 modem upstream-filter default-groupcable host downstream-filter default-groupcable host upstream-filter default-group

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 manually provisioned. Filter groups are defined in the SNMP MIB 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.

Syntax

cable modem upstream-filter default-group <pkt-filter-grp>

no cable modem upstream-filter default-group


Commands Listing 21

cable modulation-profile

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

22

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 modem downstream-filter default-groupcable host downstream-filter default-groupcable host upstream-filter default-group


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 terminal configuration 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

no cable modulation-profile



••••••••••••••••••••••••••••••••••••••••••••••••••••••••••


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 bytes of FEC error correction; FEC codeword size of 75 bytes; maximum burst length 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 shortened FEC for the last codeword.

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.

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: interval in which requests for bandwidth may be transmitted.

Reqdata: interval in which requests for bandwidth or short data packets may be transmitted.

Initial: interval in which new stations may perform initial ranging.

Station: interval in which stations may perform periodic ranging.

Short: interval in which CM may transmit upstream PDUs.

Long: interval in which CM may transmit upstream PDUs.

p1 The FEC error correction level (T). Values range from 1 to 10, or 0 for no FEC coding

p2 The FEC codeword information bytes (k). Values range from 16 to 253.

p3 The maximum burst length in minislots. Values range from 1 to 255, or 0 for no limit.

p4 The guard time (in symbols) between bursts. Values range from 0 to 255.

p5 The modulation type. Options are qam16, qpsk.

p6 Enables or disables the upstream transmission scrambler. Options are scrambler or no-scrambler

Note: no-scrambler may cause packet loss and should be used only in a lab environment.

p7 The 15-bit seed value (in hexidecimal) used to calculate the scrambler bits for the upstream modulator scrambler (randomizer). Values range from 0 to 7FFF. This parameter is not required if the scrambler is disabled.

p8 Enables or disables differential encoding. Options are diff or no-diff.

p9 Preamble length in bits for the preamble prepend. Values range from 0, 2, 4,... 1024 for QPSK and 0, 4, 8, ...1024 for QAM16.

p10 Defines how FEC for the last code word is addressed. Options are fixed (fixed length code word) or shortened (shortened code word)

show Displays the parameters for the specified modulation profile ID.

Commands Listing 23

cable ranging-attempts

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

24

G10$root# configure terminal↵G10$root(config)# cable modulation-profile 8 show↵ModId IUC prelen seed mod dif fec data/fec brst guard lstcw scrmb 8 request(1) 64 0x0152 QPSK N 0 16 1 8 2 Y 8 reqdata(2) 64 0x0152 QPSK N 0 16 1 8 2 Y 8 initial(3) 128 0x0152 QPSK N 4 34 0 48 2 Y 8 station(4) 128 0x0152 QPSK N 4 34 0 48 2 Y 8 short(5) 144 0x0152 QAM16 N 3 78 7 8 1 Y 8 long(6) 160 0x0152 QAM16 N 3 220 0 8 1 Y

Related Commands

show cable modulation-profile

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

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.

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


This command enables the CMTS to insert Dynamic Host Configuration Protocol (DHCP) relay information in 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 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.

Syntax


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 on slot 4 / interface 1.

Related Commands

cable helper-addresscable dhcp-giaddr

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.

Commands Listing 25

cable show

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

26

Syntax

cable shared-secret <secret-string>

no cable shared-secret

cable shared-secret show

Definitions

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# configure terminal↵G10$root(config)# cable shared-secret show↵

Shared-secret is: xyz*559$2

Display the shared secret.

Related Commands

show cable shared-secret

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.

There are no defaults or parameters for this command.

Examples

G10$root# configure terminal↵G10$root(config)# interface cable 2/1↵G10$root(config-if-c2/1)# cable show↵

IfIndex : 6Insertion Interval : 10Ranging Attempts : 16

secret-string Specifies the authentication string, up to a maximum of 64 text characters

show Displays the shared secret.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

cable sync-interval

Sync Interval : 5Ucd Interval : 1000

Data for the cable interface at slot 2 / interface 1 is displayed.

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 10 milliseconds.

Syntax

cable sync-interval <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

Commands Listing 27

cable upstream channel-width

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

28

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 channel-width

This command sets the channel width for an upstream channel in a specified 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 <width>

Definitions

interval The number of milliseconds (1 to 2000) between UCD messages

channel The channel (0 to 7) for which the width is being set. This channel is in the slot/if specified in the "interface cable" command.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

cable upstream data-backoff

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.

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

width The channel width (in Hz) of the channel being set. Choices are: 200000, 400000, 800000, 1600000, 3200000

channel The upstream channel (0 to 7) 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).

Commands Listing 29

cable upstream frequency

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

30

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 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.


Syntax

cable upstream <channel> frequency <frequency>

no cable upstream <channel> frequency <frequency>

Definitions

Examples

G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable upstream 2 frequency 32000000↵

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.

channel The channel (0 to 7) for which the frequency is being set. This channel is in the slot/if specified in the "interface cable" command.

frequency The fixed frequency in Hz (5000000 to 42000000) of the upstream channel to be set.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

cable upstream-load-balance

A fixed frequency for channel 2 in slot 4 / interface 1 is set to 32 MHz.


This command enables automatic ranging-time upstream load balancing for cable modems. 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 upstreams.

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.


Syntax


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.

no cable upstream minislot-size allows the CMTS to set the minislot size as appropriate for the configured upstream channel width.


Syntax

cable upstream <channel> minislot-size {2|4|8|16|32|64|128}

Commands Listing 31

cable upstream modulation-profile

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

32

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 (256 symbols).

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.


Syntax

cable upstream <channel> modulation-profile <profile-id>

no cable upstream <channel> modulation-profile <profile-id>

Definitions

Examples

G10$root# configure terminal↵G10$root(config)# interface cable 4/1↵G10$root(config-if-c4/1)# cable upstream 2 modulation-profile 7↵

The modulation profile with ID number 7 is assigned to channel 2 in slot 4 / interface 1.

channel The channel (0 to 7) for which the minislot size is being set. This channel is in the slot/if specified in the "interface cable" command.

2|4|8|16|32|64|128 The minislot size in time ticks.

channel The channel (0 to 7) 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 set with the “cable modulation-profile” command.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

cable upstream port

Related Commands


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.

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 (in dBmV) 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.

no cable upstream power-level sets the input power level to the default.

The default is 0 dBmV.

Cable Interface 0 1 2 3

US Channel 0 1 2 3 4 5 6 7

US Port 0 0 1 1 2 2 3 3

channel The channel (0 to 7) 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.

Commands Listing 33

cable upstream range-backoff

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

34

Syntax

cable upstream <channel> power-level <power-level>

no cable upstream <channel> power-level <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 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.


Syntax

cable upstream <channel> range-backoff <start> <end>

channel The channel (0 to 7) for which the power level is being set. This channel is in the slot/if specified in the “interface cable” command.

power-level The range is from -10 to +25 dBmV


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

cable upstream show

no cable upstream <channel> range-backoff

Definitions

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.


There are no default settings for this command.

Syntax

cable upstream <channel> show

Definitions

channel The upstream channel (0 to 7) 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.

channel The channel (0 to 7) for which information will be displayed. This channel is in the slot/if specified in the "interface cable" command.

Commands Listing 35

cable upstream shutdown

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

36

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 upReceived 10 broadcast, 0 multicasts, 14044 unicasts0 discards, 0 errors, 0 unknown protocol14054 packets input, 0 uncorrectable301 noise, 0 microreflections

Cable modem information for channel 1 in slot 2 / interface 0 is displayed.

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

channel The channel (0 to 7) that will be enabled or disabled. This channel is in the slot/if specified in the "interface cable" command.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

cat

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-write privilege.

Syntax

cat <file_name>

Examples

G10$root# cat README↵

Displays the entire contents of the file README.

Related Commands

dirmkdirmorepwd

cd

This command changes the directory location of the command prompt. By default, the current directory becomes the prefix for all relative paths. For absolute paths, specify the current directory with a slash.

cd is a top level command and requires read-write privilege.



Syntax

cd <dir_name>cd ..

Definitions

dir-name The name of the target directory.

.. The target directory is one level up from the current directory.

Commands Listing 37

change-password

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

38

Examples

G10$root# cd temp↵

The command prompt location is changed to the temp directory using a relative path. The temp directory must be under the current location.

G10$root# cd/home/temp↵

The command prompt location is changed to the temp directory using an absolute path.

Related Commands

dirlsmkdirpwdrmdir

change-password

The command allows the current user to change their password.

change-password is a top level command that requires read-write privilege level.


There are no user-defined parameters for this command.

Examples

G10$root# change-password↵G10$root# Old password:G10$root# New password:G10$root# New password again:

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.




••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

clock ntp-server

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.

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.


Syntax

clock ntp-server <ip-address>

no clock ntp-server

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 2999.

Commands Listing 39

clock show

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

40

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.

Related Commands

clockclock showclock summer-timeclock timezoneshow clock

clock show

This command displays the current time and date of the CMTS clock.

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 2001Tue Dec 11 23:05:42 PST 2001ntp-server ip address:

Related Commands

clockclock ntp-serverclock summer-timeclock timezoneshow clock

ip-address IP address of the NTP server to be sampled. Standard dot-quad notation (xxx.xxx.xxx.xxx).


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

clock summer-time

clock summer-time

This command sets the daylight savings time offset for the system clock. Use this command if you set the system clock manually, rather than having it synchronized to an NTP server clock. 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.

There is not a no form to this command.


Syntax

clock summertime <time-zone> <day-start> <month-start> <hour-start> <day-end> <month-end> <hour-end>

Definitions

Examples

G10$root# configure terminal↵G10$root(config)# clock summer-time MNT 7 4 2 27 10 2↵

Daylight Savings Time for Mountain Time (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

time-zone The name of the local time zone of the CMTS.

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.

Commands Listing 41

clock timezone

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

42

Related Commands

clockclock ntp-serverclock showclock timezoneshow clock

clock timezone

This command adjusts the system clock for the specified time zone.

clock timezone is a command within the configure terminal mode and requires read-write privilege

Syntax

clock timezone <timezone> <hour_offset> [<min_offset>]

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 2002Wed Feb 13 11:50:29 PST 2002ntp-server ip address:

Related Commands

clockclock ntp-server

timezone The arbitrary name assigned to the time zone to which the time will be adjusted (for example, PST, Pacific).

hour_offset Hour offset (-12 to 12) from Coordinated Universal Time (UTC).

min_offset Minute offset (0 to 59) from Coordinated Universal Time (UTC).

Specified offsets are subtracted from UTC. For example, an hour offset of 8 substracts 8 from than the Coordinated Universal Time. An hour offset of -5 adds 5 hours to the Coordinated Universal Time.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

configure memory

clock showclock summer-timeshow clock

configure memory

This command copies the start-config file to the running-config file.

configure memory is a top-level command and requires read-write privilege.



Syntax

configure memory

Examples

G10$root# configure memory↵

The start-config file is copied.

Related Commands

copy

configure terminal

This command enters the terminal configuration mode. You must first enter this mode to perform numerous configuration tasks. To exit the terminal configuration mode, use the exit command.

configure terminal is a top-level command and requires read-write privilege.



Syntax

configure terminal

Examples

G10$root# configure terminal↵G10$root(config)#

Commands Listing 43

copy

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

44

The CLI is now in the terminal configuration mode.

G10$root# conf t↵G10$root(config)#

This example illustrates the usage of an abbreviated form of the command.

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.



Syntax

copy <source-file> <dest-file>

Definitions

Examples

G10$root# copy testa_040101.bin testb_040101.bin↵

The file testa_040101.bin is copied to file testb_040101.bin

Related Commands

deletemkdirrenamermdirwrite memory

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.

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.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

description

Syntax

delete <file-name>

Definitions

Examples

G10$root# delete /pbc/myfile↵

Deletes the file named myfile located in directory pbc.

Related Commands

copymkdirrenamermdir

description

This command adds a description to a Fast Ethernet port or 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 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.

Syntax

description <"string">

no description

Definitions

Examples

G10$root# configure terminal↵

file-name Name of the file to be deleted. May include the path to the file.

string User-defined text string up to 64 characters enclosed in quotes.

Commands Listing 45

dir

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

46

G10$root(config)# interface fastEthernet 6/0↵G10$root(config-if-f6/0)# description “First Ethernet Port”↵

Adds the description First Ethernet Port to the Fast Ethernet port at slot 6 / port 0.

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 / port 1.

Related Commands

show interfaces

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]

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

directory-name Optional - Path and name of the directory to be displayed.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

disable

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 requires read-write privilege.


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.

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 the Ethernet interface at slot 6 / port 0 to full duplex.

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.

Commands Listing 47

enable

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

48

Related Commands

auto-negotiationshowshutdownspeed

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 requires read-only privilege.


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

exit

This command takes you out of the current mode, or any of the sub-modes, to the next highest level. This command has no effect at the top-level prompt.

exit requires read-only privilege.

There is no default value for this command.


Syntax

exit

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.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

help

Related Commands

Ctrl-Z (key command that exits to the root level)

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. There are four modes of help:

1. A list of valid commands displays when you type 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 parameter displays the available editing keystrokes.

help (or ?) can be entered at any command level and requires read-only privilege.

There are no defaults for this command.

Syntax

help [edit]

?

command ?

command <abbreviated-parameter>?

Definitions

Examples

G10$root# help↵

Displays a list of all valid commands in the current mode or sub-mode.

command Any valid command for the current mode, sub-mode, group, and privilege

abbreviated-parameter One or more letter in a valid parameter for the command specified.

Commands Listing 49

hostname

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

50

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.

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">

hostname show

no hostname

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.

name A text string enclosed in quotation marks.

show Displays the current host name.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

interface cable

interface cable

This command enters a sub-mode under the configure terminal mode where you configure a given cable interface. See Chapter 1, “Commands 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.

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 HFC Connector Module and the Chassis Control 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.

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 79.

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}

Commands Listing 51

ip address

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

52

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.

Related Commands

show interfaces fastEthernetshutdown

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.

The no form of the command removes the IP address.

Syntax

ip address <ip-address> <mask>

no ip address <ip-address> <mask>

slot Chassis slot number:

HFC Connector Module: 1 to 4 and 10 to 13.

Chassis Control Module: 6 and 7.

if Port number of the Fast Ethernet ports to be configured:

HFC Connector Module: 0 and 1

Chassis Control Module: 0

show Displays configuration information for the slot/if. The system remains in the configure terminal mode.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

ip default-gateway

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 IP packets. This command allows an optional argument management which is significant only for layer 3 systems. For a layer 2 system, the behavior of this command with or without the optional argument is identical.

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.

Syntax

ip default-gateway <ip-address> [management]

no ip default-gateway [management]

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.

Commands Listing 53

ip domain-name

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

54

Definitions

Examples

G10$root# configure terminal↵G10$root(conf)# ip default-gateway 192.111.168.101 management↵

The default gateway for the management port of the Chassis Control Module 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

Examples

G10$root# configure terminal↵G10$root(conf)# ip domain-name mydomain.com↵G10$root(conf)# exit↵G10$root# ping myCPE↵

The domain name mydomain.com is set for the CMTS. Then, the equipment named myCPE.mydomain.com is pinged.

ip-address The IP address to assign as the default gateway. Standard dot-quad notation (xxx.xxx.xxx.xxx).

management The default gateway assignment is for the management port on the Chassis Control Module.

domain The domain name for the CMTS.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

ip name-server

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# configure terminal↵G10$root(config)# no ip name-server↵

Removes all DNS server addresses.

G10$root# configure terminal↵G10$root(config)# no ip name-server 192.16.90.1↵

Removes the specified DNS server address.

Related Commands

ip domain-name

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.

Commands Listing 55

ip show

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

56

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 in the interface cable sub-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: 192.168.201.1Default gateway (Management Interface): 192.168.201.1

G10$root# configure terminal↵G10$root(config)# interface cable 2/0↵G10$root(config-if-c2/0)# ip show↵

Primary IP address:------------------ addr: 172.16.96.1 mask: 255.255.255.0

Secondary IP addresses:---------------------- no secondary IP address configured

logout

This command ends the Telnet session when entered within any mode or sub-mode.

logout requires read-only privilege.


Examples

pbcCMTS> logout↵

Logout from the non-privileged top-level prompt.

pbcCMTS# logout↵

Logout from the privileged top-level prompt.

mkdir

This command creates a new directory under the current directory in the Chassis Control Module.

mkdir is a top-level command and requires read-write privilege.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

ls


Syntax

mkdir <name>

Definitions

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

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.

Syntax

ls [directory-name]

Definitions

name Name of the directory being created.

directory-name Optional - Path and name of the directory to be displayed.

Commands Listing 57

more

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

58

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

more

This command causes the contents of a file to display one screen at a time. After a screen has displayed, pressing Enter will advance the display one line, and pressing the space bar will advance the display one screen.

more is a top-level command and requires read-only privilege.

Syntax

more <file_name>

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


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

ping

ping

This command verifies a network connection between the CMTS and the target device. It sends an ICMP echo request to the specified target and displays a response if the target is reached, or it times-out if the target is not reached.

ping is a top-level command and requires read-only privilege level.

Syntax

ping {<ip-address>|<hostname>}

ping [ip] <ip-address>

ping cable-modem {<ip-address>|<mac-address>}

Definitions

Examples

G10$root# ping 100.205.50.150↵

Verifies the connection between the CMTS and the device at IP address 100.205.50.150.

pwd

This command displays the current directory. This command is only available at the top-level prompt in privileged mode.

pwd is a top-level command and requires read-write privilege.


Syntax

pwd

Examples

G10$root# pwd↵/home

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 on the cable interface specified as xxxx.xxxx.xxxx.

Commands Listing 59

reload

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

60

Related Commands

cddirlsmkdirrmdir

reload

This command causes the G10 CMTS to initiate a cold restart (reboot).

reload is a top-level command and requires read-write privilege.


Syntax

reload

Examples

G10$root# reload↵

rename

This command renames a file in the CMTS.

rename is a top-level command and requires read-write privilege.

Syntax

rename {[path] source-filename [path] dest-filename}

Definitions

This action will disrupt service.

path Specify the path if the source or destination files will be in a directory other than the current directory.

source-filename The current file name.

dest-filename The new file name to which the current file name will be changed.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

rmdir

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

rmdir

This command removes an existing directory in the G10 CMTS. Execute the command from the level above the directory to be removed.

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

directory-name The name of the directory to be removed.

Commands Listing 61

show cable modem

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

62

show cable modem

This command displays information for registered modems. You may choose to display all cable modems in a network, all cable modems assigned to a particular CMTS, or a single cable modem.

show cable modem is a top-level command and requires and requires read-only privilege.

Syntax

show cable modem

Displays all cable modems in the network.

show cable modem {<ip-address>|<mac-address>|<slot/if>}

Displays the cable modem registered with the given address, or all cable modems at the given slot/interface.

Definitions

Examples

G10$root> show cable modem 2/0↵

Display the cable modem statistics for slot 2 / interface 0.

Interface Us Prim Online Timing Rec QoS IP address MAC address Sid State Offset PowerCable2/0 0 0 offline 2311 3 0 0.0.0.0 0050.DAA7.6E3ECable2/0 0 0 offline 2081 -6 0 0.0.0.0 0000.CA25.1C4ACable2/0 0 0 offline 1728 2 0 0.0.0.0 0030.D002.1B6DCable2/0 1 4214 init(rc) 1984 -33 1 0.0.0.0 0010.9501.0CF9Cable2/0 0 0 offline 2502 0 0 0.0.0.0 0020.40BF.C3F6Cable2/0 0 0 offline 2504 3 0 0.0.0.0 0020.407F.503ECable2/0 0 0 offline 2505 0 0 0.0.0.0 0002.0001.29AECable2/0 0 0 offline 2629 -3 0 0.0.0.0 00D0.59FD.F52FCable2/0 0 0 offline 1438 -19 0 0.0.0.0 0001.0370.B226

show cable modulation-profile

This command displays the configuration parameters of a cable modulation profile.

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.

slot/if The CMTS slot and interface number, which will display all of the cable modem in that interface.

Slot {1,2,3,4,10,11,12,13} Interface {0 to 3}


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

show cable qos profile

show cable modulation-profile is a top-level command and requires read-only privilege.

Syntax

show cable modulation-profile [<profile-id> [<iuc>]]

Definitions

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



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 requires read-only privilege.

There are no user-defined values with this command.

profile-id The modulation profile ID number of the profile to be displayed.

iuc DOCSIS interval usage code:

request

reqdata

initial

station

short

long

Commands Listing 63


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

64

Syntax


Examples

G10$root> show cable qos profile↵

Service Prio Max Guarantee Max Max tx Create Baselineclass upstream upstream downstream burst by privacy bandwidth bandwidth bandwidth enable 1 0 1000000 0 10000000 0 cmts no


This command is used to display the specified authentication string shared between the server that provides a cable modem’s configuration file and the CMTS.

show cable shared-secret is a top-level command and requires read-write privilege.



Syntax


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 clock

This command displays the current time and date of the CMTS clock.

show clock is a top-level command and requires read level.



••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

show history

Examples

G10$root> show clock↵

Date: 04-14-2001Time: 16:05:45

Related Commands

clockclock ntp-serverclock showclock summertimeclock timezone

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 can be entered at any command level and requires read-only privilege.


Syntax

show history

history

Examples

G10$root# show history↵

1 configure terminal2 interface fastEthernet 6/03 show4 exit5 interface cable 2/06 ip show7 history

G10$root# !1↵G10$root(config)#

Execute configure terminal by entering !1.

Commands Listing 65

show interfaces

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

66

show interfaces

This command displays statistics for all cable or Fast Ethernet interfaces.

show interfaces is a top-level command and requires read-write privilege.

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>

Definitions

Examples

G10$root# show interfaces cable 2/0 downstream↵

This displays statistics for the entire downstream interface at slot 2 / interface 0.

G10$root# show interfaces cable 2/0 upstream 0↵

This displays statistics for upstream channel 0 at slot 2 / interface 0.

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↵

This displays statistics for the Fast Ethernet port in the module at slot 6 / interface 0.

cable Specifies an interface cable in a DOCSIS Module.

slot/if The slot number and interface number of either the cable modem interface or the Fast Ethernet port.

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).

sid Specifies that the interface will be displayed based on the Service identifier.

sid Service identifier. (1 and 8191)

SIDs can be viewed with the show cable modem command.

fastEthernet Specifies a Fast Ethernet interface in a DOCSIS Module or a Chassis Control Module.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

show privilege

show privilege

This command displays the privilege levels of the current session’s user.

show privilege is a top-level command and requires read-write privilege.

There are no parameters for this command.

Examples

G10$root# show privilege↵

User root has the following access privilege:Admin group access level : rwIp group access level : rwRf group access level : rw

Related Commands

show usernamesshow usersshow whoamiusername

show running-config

This command displays the current CMTS configuration parameters being used.

show running-config is a top-level command and requires read-write privilege.


Examples

G10$root# show running-config↵

cable modulation-profile 1 initial 3 34 0 5 qpsk scrambler 1 diff 52 fixedcable modulation-profile 1 long 3 100 0 5 qpsk scrambler 1 diff 36 shortenedcable modulation-profile 1 reqdata 3 40 8 6 qpsk scrambler 1 diff 68 fixedcable modulation-profile 1 request 0 16 0 6 qpsk scrambler 1 diff 68 fixedcable modulation-profile 1 short 3 40 8 5 qpsk scrambler 1 diff 36 shortenedcable modulation-profile 1 station 3 34 0 5 qpsk scrambler 1 diff 52 fixedcable modulation-profile 2 initial 3 34 0 5 16qam scrambler 1 diff 104 fixedcable modulation-profile 2 long 3 100 0 5 16qam scrambler 1 diff 64 shortenedcontinued...

cable shared-secret DOCSISclock timezone PST 0 0hostname myhost-7interface

cable 3/0 cable dhcp-giaddrcable downstream 0 channel-width 6000000cable downstream 0 frequency 531000000cable downstream 0 interleave-depth 8

Commands Listing 67

show startup-config

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

68

cable downstream 0 modulation 64qamcable downstream 0 rf-power 610no cable downstream 0 shutdowncable helper-address 192.168.200.5 cable-modem

continued...

Related Commands

show startup-config

show startup-config

This command displays the CMTS configuration parameters used during initial start-up.

show startup-config is a top-level command and requires read-write privilege.


Examples

G10$root# show startup-config↵

cable modulation-profile 1 initial 3 34 0 5 qpsk scrambler 1 diff 52 fixedcable modulation-profile 1 long 3 100 0 5 qpsk scrambler 1 diff 36 shortenedcable modulation-profile 1 reqdata 3 40 8 6 qpsk scrambler 1 diff 68 fixedcable modulation-profile 1 request 0 16 0 6 qpsk scrambler 1 diff 68 fixedcable modulation-profile 1 short 3 40 8 5 qpsk scrambler 1 diff 36 shortenedcable modulation-profile 1 station 3 34 0 5 qpsk scrambler 1 diff 52 fixedcable modulation-profile 2 initial 3 34 0 5 16qam scrambler 1 diff 104 fixedcable modulation-profile 2 long 3 100 0 5 16qam scrambler 1 diff 64 shortenedcontinued...

cable shared-secret DOCSISclock timezone PST 0 0hostname myhost-7interface

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 610no cable downstream 0 shutdowncable helper-address 192.168.200.5 cable-modem

continued...

Related Commands

show running-config


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

show usernames

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 requires read-write privilege.


Examples

G10$root# show usernames↵

Username : guestPrompt : guestAccess rights : RF - rw

Username : rootPrompt : rootAccess rights : AD - rw IP - rw RF - rw

Related Commands

show privilegeshow usersshow whoamiusername

show users

This command displays all users currently logged into the CMTS.

show users is a top-level command and requires read-only privilege.


Examples

G10$root> show users↵

root user1user2 user3

Related Commands

show privilegeshow usernamesshow whoamiusername

Commands Listing 69

show version

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

70

show version

This command displays the version of software currently running in the CMTS and a copyright banner.

show version is a top-level command and requires read-only privilege.

There are no user-defined values for this command.

Examples

G10$root> show version↵

show whoami

This command displays your current username.

show whoami is a top-level command and requires read-only privilege.


Examples

G10$root# show whoami↵root

Related Commands

show privilegeshow usernamesshow usersusername

shutdown

This command disables a Fast Ethernet interface.

shutdown is a command within the interface fastEthernet sub-mode and requires read-write privilege.

Then no form of this command enables a Fast Ethernet interface.

The Fast Ethernet interfaces are disabled by default.

Syntax

shutdown

no shutdown


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

snmp-server community

Examples

G10$root# configure terminal↵G10$root(config)# interface fastEthernet 6/0↵G10$root(config-if-f6/0)# no shutdown↵

Enable the Fast Ethernet port at slot 6 / interface 0.

G10$root# configure terminal↵G10$root(config)# interface fastEthernet 6/0↵G10$root(config-if-f6/0)# shutdown↵

Disable the Fast Ethernet port at slot 6 / interface 0.

Related Commands

auto-negotiationduplexshowspeed


This command specifies the SNMP password community string and sets the access to read-only or read-write.

snmp-server community is a command within the configure terminal mode and requires read-write privilege.

The default setting is read-only for this command.

The no form of this command deletes the existing community string.

Syntax

snmp-server community <community-string> {ro|rw}

no snmp-server community <community-string> {ro|rw}

snmp-server show

Definitions

community-string Alphabetic string that will be used by all SNMP hosts to gain access to the server.

ro Read-only access.

rw Read/write access.

show Displays the community strings.

Commands Listing 71

snmp-server host

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

72

Examples

G10$root# configure terminal↵G10$root(config)# snmp-server community server_A rw↵

Establishes “server_A” as the SNMP password and sets read/write privileges.

Related Command

snmp-server host

snmp-server host

This command specifies the destination hosts that will receive SNMP traps from the CMTS. A minimum of one destination must be specified, and a maximum of four destinations may be specified. The SNMP server must be configured with the snmp-server community command before traps will be sent. The SNMP client in the hosts must be set with the same community string as the SNMP server.

snmp-server host is a command within the configure terminal mode and requires read-write privilege.


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} [port <port_number>]

snmp-server show

Definitions

Examples

G10$root# configure terminal↵G10$root(config)# snmp-server host 205.15.128.132 version 2c port 168↵

Specify an IP address of 205.15.128.132 for the SNMP server. The SNMP version that will be used is 2c. SNMP traps will be sent to UDP port 168.

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 community strings.

port_number Optional UDP port number to which SNMP traps are sent. If not specified, the port number defaults to 162.


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

speed

Related Commands


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.


The default speed setting is 100.

Syntax

speed {10|100}

Definitions

Examples

G10$root# configure terminal↵G10$root(config)# interface fastEthernet 6/0↵G10$root(config-if-c6/0)# speed 10↵

Set the speed for Fast Ethernet slot 6 / interface 0 to 10Base-T.

Related Commands

auto-negotiationduplexshowshutdown

traceroute

This command traces the connection to a given IP address or host name.

traceroute is a top-level command and requires read-only privilege.



10|100 Set the Ethernet port speed as 10Base-T or 100Base-T.

Commands Listing 73

username

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

74

Syntax

traceroute {<ip-address>|<host-name>}

Definitions

Examples

G10$root# traceroute 172.164.70.13↵

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.

The no form of this command deletes the username from the CMTS.


Syntax

username <name> password <password>

username <name> group {ad|ip|rf} privilege {rw|rd|ro}

username <name> prompt <prompt-string>

no username <name>

Definitions

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.

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


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

write memory

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.

Related Commands

show privilegeshow usernamesshow usersshow whoami

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

write memory is a top-level command and requires read-only privilege.

There is not a no form of the command.


Examples

G10$root> write memory

Copy the running-config file to the startup-config file.

privilege Privilege levels:

rw – read-write

rd – read-debug

ro – read-only

prompt-string Unique prompt string for the user name.

Commands Listing 75

write memory

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

76

Related Commands

copy


••

Appendix ALogin, Prompts, and Key
••••••••••••••••••••••••••••••••••••••••••••••
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 Key 77

Login, Prompts, and Key

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

78

Key Commands

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 root 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


••

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








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 79

Configuration Notes

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

80

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 flowing through even numbered cable interfaces (0 and 2) is forwarded through the Ethernet port 0 on the HFC Connector Module, while traffic flowing 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 2.

Table 2: Cable Interface to Ethernet Port Association

Interface is also used describe the Fast 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 upstream channels routed through each HFC Connector Module / DOCSIS Module.

Upstream channels can be grouped in any manner and routed through the US ports. Channel IDs are 0 – 7.

Downstream channels are assigned one-each to the DS ports. Channel IDs are 0 – 3.

Cable Interface Associated Ethernet Port

0 Eth0

1 Eth1

2 Eth0

3 Eth1


••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

Configuration Notes

Defaults

Table 3 and Table 4 summarize the various associations described above. Note that the upstream channel to upstream port mapping specified in these tables is just the factory default, and can be changed through the cable upstream port command. Refer to Figure 1 on page 82 to view the ports on the HFC Connector Module and the Chassis Control Module.

Table 3: Cable Interface to Downstream Channel and Port Association

Table 4: Default Cable Interface to Upstream Channel Association

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 81

Configuration Notes

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

82

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


••

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 5.

Table 5: 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 routing 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.

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.

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

Security 83

Security

••••••••••••••••••••••••••••••••••••••••••••••••••••••••••

84

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 “Commands Summary” on page 1 for associations, which are shown with abbreviations such as ip-ro, rf-rw and so forth.

Users

Each user is assigned to at least one group-privilege with this command:

username <name> group {ad|ip|rf} privilege {rw|ro|rd}

Users may be assigned to multiple group-privileges.

root is a username built in to the G10 CMTS that is assigned to all group-privileges.

This Level Can Also Access This Level

RW RD, RO

RD RO

RO —


juniper networks g10 cmts · about this manual ix about this manual this section describes...

Documents