Professional Documents
Culture Documents
DOC-3010-01
Document Revision 08.02.02
March 2017
© 2017 Casa Systems, Inc.
All rights reserved. Licensed software products are owned by Casa Systems or its suppliers and are protected
by United States copyright laws and international treaty provisions.
The information regarding the product in this manual is subject to change without notice. All statements,
information, and recommendations in this manual are believed to be accurate but are presented without
warranty of any kind, express of implied. Users must take full responsibility for their application of the product.
In no event shall Casa or its suppliers be liable for any indirect, special, consequential, or incidental damages,
including, without limitation, lost profits or loss or damage to data arising out of the use or inability to use this
manual, even if Casa or its suppliers have been advised of the possibility of such damages.
iii
Contents
Preface
Index
Preface
Revision history
This guide supports Casa CMTS software releases up to Release 6.5.2. See the Casa
Systems – CMTS Release Notes and the Casa Systems – CMTS Release 6.5 Features
Guide for information on new functionality not yet covered in this guide.
• 01.00.00 — Initial version; January 2014
• 01.01.00 — Chapter 7 update; added load balancing policy processing.
• 01.02.00 — Update to Casa software releases through 6.5.2.5.
• 01.03.00 — Update to Casa software releases through 7.1.2.
• 01.03.01 — Update to Casa software releases through 7.1.3.
• 01.03.02 — Update to Casa software releases through 7.1.4.
• 01.04.01 — Update to Casa software releases through 7.2.
• 01.04.02 through 7.02.03 not used — Revision level restructured; January 2017.
• 07.02.04 — February 2017; updated to Release 7.2.4.
• 08.02.02 — March 2017; updated to Release 8.2.2.1 build 5389.
Contacting Casa
Corporate facility
Casa Systems, Inc.
100 Old River Road
Andover, MA 01810
Tel.: 978-688-6706
World Wide Web: www.casa-systems.com
Technical Support
In the United States: Tel: 978-699-3045
E-mail: support@casa-systems.com
Technical documentation
Casa Systems provides the following documentation set in PDF format, viewable
using Adobe Reader 5.0 or later. These PDF files are available from the Casa FTP site
at ftp://support.casa-systems.com.
• Casa Systems – C1G CMTS Quick Installation
• Casa Systems – C1G CMTS Hardware Installation Guide
• Casa Systems – C10G/C10200 CMTS Quick Installation
• Casa Systems – C10G CMTS Hardware Installation Guide
• Casa Systems – C40G CMTS Hardware Installation Guide
• Casa Systems – C100G CMTS Quick Installation
• Casa Systems – C100G CMTS Hardware Installation Guide
• Casa Systems – CMTS Operations and Administration Guide (this guide)
• Casa Systems – CMTS Network Solutions Guide
• Casa Systems – NSI Configuration Guide and Command Reference
• Casa Systems – RF Cable Configuration Guide and Command Reference
• Casa Systems – CCAP Video Edge User Guide
• Casa Systems – SNMP MIBs and Traps Reference
• Casa Systems – CMTS Troubleshooting and Diagnostics Guide
Note: Casa Systems provides updates to the manuals on a regular basis. Log
on to the Casa Systems Web site at www.casa-systems.com for the latest files
in PDF format. Select customer login and enter your username and
password. If you do not have a Casa-assigned username and password, send
e-mail to support@casa-systems.com.
Acronyms
Casa Systems manuals contain the following industry-standard and product-specific
acronyms:
3DES Triple Data Encryption Standard (IPsec)
ABR Area Border Router (OSPF)
AES Advanced Encryption Standard
ARP Address Resolution Protocol
AS Autonomous System
ASN Autonomous System Number
ATDMA Asynchronous Time Division Multiple Access
BDR Backup Designated Router (OSPF)
BFD Bidirectional Forwarding Detection (RFC 5880)
BGP Border Gateway Protocol
BKPM Baseline Privacy Key Management
BPI[+] Baseline Privacy Interface [Plus]
BSR Bootstrap Router (PIM)
BW Bandwidth
CCAP Converged Cable Access Platform
CE Customer Edge
CIDR Classless Inter-Domain Routing
PE Provider Edge
PID Packet ID (interfaces)
PIM-SM Protocol Independent Multicast in Sparse Mode
PME Privacy Mode Encryption (video)
PMT Program Mapping Table
PPS Packets per second
PS Portal Server
PSK Pre-Shared Key (IPsec)
QAM Quadrature Amplitude Modulation
QoS Quality of Service (policies)
QPSK Quadrature Phase Shift Keying
RADIUS Remote Authentication Dial In User Service
RAM Random Access Memory
RCP Receive Channel Profile
RCS Receive Channel Set
RD Route Distinguisher (VRF)
REG-REQ Registration Request (message)
REG-RSP Registration Response (message)
RFI Radio Frequency Interface
RIP Routing Information Protocol
RKS Record Keeping Server
RLBG Restricted Load Balancing Group
RNG-RSP Ranging Response (message)
RP Rendezvous Point (PIM-SM)
RPC Remote Procedure Call (SNMP)
RSA Rivest, Shamir and Adleman cryptographic algorithm (SSH)
RT Route target (BGP)
SAMIS Subscriber Account Management Interface Specification
SAV Source Address Verification
SG Service Group
SHA Secure Hash Algorithm
SI Service Information (QAM)
Topic Page
Figure 1-1. Example D1.0 cable network topology with Casa CMTS
downstream
upstream channel Forward channel lineup
channels
Note: The topology illustrated in Figure 1-1 uses the Casa C3200 CMTS as
an example. Other CMTS platforms, such and the Casa C2200, C10200,
C10G, C100G, and future Casa platforms also fit into this topology.
The Casa CMTS provides both a network side interface (NSI) and a radio frequency
interface (RFI). On the NSI, the CMTS provides Ethernet 10/100 Mbps (for system
management), GigE, and 10GigE (C10G) interfaces to routing gateways and servers.
On the RFI, the CMTS provides both upstream and downstream interfaces for
transmission and reception of digitized content and data services over fiber network
trunks and coaxial cable to and from the subscriber distribution areas.
Residing between the NSI and the RFI is the CMTS forwarding engine that resides in
the CMTS Switch and Management Module (SMM). As data, voice, and video traffic
is processed over both the NSI and the RFI, the forwarding engine selectively directs
the traffic over the correct interface for transmission and delivery to a destination.
Upstream Hypertext Transfer Protocol (HTTP) requests to the Internet from a
customer PC, for example, are transmitted by the cable modem (CM) over the fiber
network to the upstream CMTS channels before being forwarded to the NSI and
routing gateway to the Internet. The HTTP response (and Web page) from the Internet
destination is then returned to the CMTS and forwarded over a downstream channel to
that customer’s CM for transmission and presentation at the PC.
• DOCSIS 1.0 (D1.0) — One downstream and multiple upstream channels in 1xN
configuration. Baseline privacy interface (BPI); CM identification by service
identifier (SID).
• DOCSIS 1.1 (D1.1) — One downstream and multiple upstream channels in 1xN
configuration. Baseline Privacy Interface Plus (BPI+); CM identification by
service flow. Quality of Service (QoS) provisioning services for reliable voice and
video streaming. Quadrature Phase Shift Keying (QPSK) modulation only.
• DOCSIS 2.0 (D2.0) — One downstream and multiple upstream channels in 1xN
configuration. QAM64 modulation with downstream channel width at 6.4 MHz.
Improved performance and speed at 30 Mbps on the upstream channels.
• DOCSIS 3.0 (D3.0) — Multiple downstream and upstream channels in MxN
configuration. Channel bonding for up to 24 channels for increased downstream
bandwidth; logical bonding from the MAC domain to compatible D3.0 CMs
supporting multiple transmitters and receivers. (See Figure 1-2.)
C3000 CCASA
ASA
ALM 0 1 2
Multiple
Forward channel lineup
upstream
channels
Television and
Diplexer/filter Forward combiner channel lineup
LOW | HIGH
5 to 42 MHz 50 MHz to 1 GHz
MPEG-2 Set-top box
Fiber network and transport stream
amplifier CH 851
DS
US PC
Coaxial cable D3.0 cable modem
- Multiple tranmitters
and receivers
- Channel bonding
Phone
transmissions from the CMTS downstream channels, and then by learning how to
transmit to the CMTS over the upstream channels.
Once the CM can listen for and receive the MPEG-2 transport streams that are
modulated on the downstream carrier signals, the CM begins the initial ranging
process over the upstream channels.
In large networks with many CMs trying to register with the CMTS at the same time,
initial ranging requests are subject to collisions with requests from other CMs. Each
initial ranging request is considered an initial ranging opportunity. Because of the high
probability of collisions, the MAC domain uses a ranging backoff algorithm to tell the
CM how long to wait before retransmitting another initial ranging request. The
ranging backoff algorithm reschedules and increases initial ranging transmissions at
random intervals to provide a better opportunity for CMs to avoid collisions.
Ranging backoff values are expressed as an exponential value to set the number of
ranging opportunities per retry, such as 23, 24, 25, and 26. For example, configuring a
value of 3 specifies 23, or eight ranging opportunities on the first attempt. Configuring
a value of 4 specifies 24, or 16 ranging opportunities on the second attempt, and so on.
The Casa CMTS allows up to sixteen initial ranging retry attempts. When the CM
receives an upstream transmission grant from the CMTS, the MAC domain adjusts the
CM for frequency, power, and delay. Two-way CM communication with the CMTS is
then established.
After the initial ranging request has completed, the CM is then provisioned using the
Dynamic Host Configuration Protocol (DHCP) and Trivial File Transfer Protocol
(TFTP) to complete the initialization process, as described in the next section. When
the initialization process has completed, the CM requests registration with the CMTS.
The CM can then receive transmissions on the downstream channels and transmit to
the CMTS over the upstream channels.
Figure 1-3 shows the cable modem initialization and configuration process.
188-byte
MPEG-2 transport
stream (42 Mbps)
ALM 0 1 2 downstream
channel UCD1
Modem initial UCD2
ranging
UCD3
and registration
Forward UCD4
combiner SYNC
Diplexer/filter
LOW | HIGH MAP1
5 to 42 MHz 50 MHz to 1 GHz
MAP2
QAM64 or QAM256 MAP3
Fiber network and modulation
amplifier MAP4
Coaxial cable
DS
US
Cable modem frequency,
power, and delay adjustments.
1. Modem performs an initial ranging request with the CMTS. Transmission interval is
determined and modem is adjusted for frequency, power and delay. Modem sends
a registration request to the CMTS for two-way communication with the MAC domain.
2. Modem DCHP DISCOVER, OFFER, REQ, ACK packets exchanged with DHCP server.
4. Modem receives modem config file from TFTP server and configures itself. Optional
time-of-day packet exchange.
The CMTS MAC domain sends one UCD for every upstream channel. If there are
four upstream channels configured at the CMTS MAC domain, the MPEG-2 transport
stream contains four UCDs, as illustrated in Figure 1-3. The CM selects one UCD at
random to instruct the CM on “how” to transmit.
• Frequency
• Width
• Burst profile—A set of burst descriptors, where:
– Each descriptor can be one of five burst types: initial ranging, periodic ranging,
long data, short data, and request.
– Each burst type can have up to twelve parameters, such as modulation type,
forward error correction (FEC), scrambler, preamble, and long/short data.
Each UCD has one associated MAP that instructs the CM on “when” to transmit over
an upstream timeline. Figure 1-4 illustrates the association between the UCD and the
MAP, where:
• UCD1 is the CMTS upstream channel, frequency, width and burst profile.
• MAP1 is when time zero (t0) begins on the upstream timeline, along with the
32-byte service identifier (SID) field that describes “who” is transmitting.
• IUC indicates “what” type of transmission, and the timing offset from t0 that
indicates “when” to begin the upstream transmission.
Upstream timeline
The upstream timeline is comprised of intervals and minislots, where a single group of
minislots makes up one interval. These intervals vary in size starting at time zero (t0)
until the end of the interval where t0 begins again. Time Division Multiplexing (TDM)
scheduling is used to set both long and short intervals in the timeline where the
interval size is based on traffic conditions. Each minislot in each interval is 6.25
microseconds.
Figure 1-5 illustrates the upstream channel timeline, intervals, and minislots in the
network context.
Multiple 1FFE
upstream Casa CMTS Single
channels SYNC
CASA SYSTEMS
C3000 CCASA
ASA
SYS 3 4 5
ALM 0 1 2 downstream
channel UCD1
One upstream
channel selected UCD2
from UCD
UCD3
Forward UCD4
UCD1
combiner SYNC
Diplexer/filter
LOW | HIGH MAP1
5 to 42 MHz 50 MHz to 1 GHz
MAP2
QAM64 or QAM256 MAP3
modulation
MAP4
Upstream timeline
Intervals Large and small intervals in timeline
IUC interval
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Minislots
(6.2 ms per minislot) 0
t0 0
MAP1
MAP
Elements 32 14 4 14 14 4 14
header
“Who” “When”
Service ID (SID) t0 offset
“What”
Interval Usage Code (IUC)
Figure 1-6 illustrates a sample network with eight downstream channels. Even though
the CM only supports four downstream and four upstream channels, the CM learns
how to receive traffic across all eight CMTS downstream channels. The CMTS
dynamically creates a channel bonding group using four of the channels (based on
current traffic load) and creates a downstream service group (DS-SG) associated with
the assigned CM channel set. A service group (SG) is simply a group of channels.
C3000 CCASA
ASA
ALM 0 1 2
A
B Forward channel lineup
C
D
Forward combiner
Multicast bus
Similarly, the set of upstream channels is called the upstream service group (US-SG).
Collectively, the upstream and downstream SGs make up the cable modem service
group (CM-SG). All upstream and downstream channels originating from the same
MAC domain are known as a MAC domain CM service group (MD-CM-SG). Note
that the CM in Figure 1-6 at the “D” distribution area endpoint uses a two-channel
upstream SG. This means that upstream traffic from the CM is assigned to one of two
channels from the MAC domain-assigned US-SG for this CM.
Cable service providers deliver voice, data, and video traffic over fiber optic trunks to
subscriber distribution areas, physical distribution areas known as physical fiber
nodes, as shown in Figure 1-6. A DOCSIS fiber node refers to a CM-SG, comprising
the upstream and downstream SGs described in the previous section.
While cable providers around the world today use the term fiber node to describe the
physical cable infrastructure to the distribution areas, it is important to understand that
the term DOCSIS fiber node is associated with a CM SG and not the physical network.
The Casa CMTS supports two types of load balancing: general load balancing and
restricted load balancing, which are separated into groups:
• General load balancing group (GLBG) — Uses the complete set of upstream and
downstream channels in that CM’s CM-SG.
• Restricted load balancing group (RLBG) — Uses a configured subset of channels
in a CM’s SG. This means that the channels available for load balancing are
interactively selected and saved in the CMTS running configuration file.
Note: A single CM cannot belong to more than one load balancing group at
any given time.
At CM registration, the CMTS attempts to assign the CM to one of the two load
balancing groups. If a restricted load balancing group does not exist in the CMTS
configuration file, the CM is assigned by default to the general load balancing group
using the channels in the MD-CM-SG for that CM.
• A single CM can belong to only one load balancing group using only the upstream
and downstream channels in that group.
• Load balancing does not take place if the CMTS cannot determine the load
balancing group to which a registered CM belongs.
Dynamic channel change (DCC) and dynamic bonding change (DBC) messages from
the MAC domain instruct CMs on when to change channels or an upstream or
downstream bonding group. DCC and DBC can occur during traffic load balancing at
the CMTS when the CM has access to multiple upstream or downstream channels.
DCC moves legacy and current D3.0 CMs (not operating with a multiple receive
channel set) from one downstream channel to another using the MD-CM-SG for that
CM. On the upstream side, DCC also instructs CMs to move from one transmit
channel to another from the MD-CM-SG. DBC moves D3.0 CMs downstream service
flows to different channels in the CM’s receive channel set. It also moves D3.0
upstream service flows to different channels in the current transmit channel set.
A load balancing policy is a set of rules that govern load balancing operations. There
are two types of rules that the CMTS uses when load balancing takes place: basic
rules and execution rules. The CMTS uniquely identifies each policy using an ID.
• Basic rule — Sets the time of day when the CMTS is to perform load balancing.
The configured time is during predictable traffic periods when congestion over the
downstream and upstream channels is most likely to occur. Multiple basic rules
are supported in a load balancing policy. A basic rule is a DOCSIS requirement.
• Execution rule — Defines the specific traffic conditions or parameters that enable
the load balancing algorithms of the CMTS regardless of the time of day (as set in
a basic rule). The execution rule can specify when load balancing is to occur and
to which CMs, the time interval, or how often certain CMs participate in DCC or
DBC load balancing operations, as well as other parameter settings such as static
and dynamic load balancing. Unlike basic load balancing rules, execution rules
are vendor-specific and are not mandated by DOCSIS.
The CMTS performs load balancing in one of two ways, or a combination of the two:
• Static load balancing — Takes place when a CM sends its initial ranging request
message to the CMTS. For D1.0, 1.1 and 2.0 CMs, the CMTS responds with a
RNG-RSP message that includes either a Downstream Frequency Override or an
Upstream Channel ID Override field that instructs the CM which channels it
should use. For D3.0 CMs, when a CM sends its REG-REQ messages, the CMTS
responds with a REG-RSP to instruct the CM to select the channels.
• Dynamic load balancing — Moves CMs among upstream and downstream
channels in the same SG when the difference between two channels exceeds a
defined percentage. The CMTS uses downstream and upstream channel change
messages to move CMs with single upstream/downstream channels, and DBC
messages to move CMs with bonded upstream/downstream channels to different
bonding groups.
Note: For DOCSIS and EuroDOCSIS 3.0 CMs, the dynamic load balancing
software generates a downstream channel set with a minimum load to fit the
CM‘s receive channel profile (RCP). This prevents rejection of the new
channel set so that load balancing is not canceled when the assigned CM is
under load.
The CMTS does not move CMs to disconnected (idle) downstream channels where
there are no registered online CMs.
An exclusion list disables one or more CMs from load balancing across CMTS
downstream and upstream channels in situations where it is not feasible to load
balance particular CMs. For example, there might be cases where an older D1.0 or 2.0
CM from a specific vendor might not be a good candidate for load balancing, as well
as CMs that process particular types of traffic where moving those CMs to other
channels introduces risks. CMs in the exclusion list are specified by MAC address.
burst profile — The set of burst descriptors carried by UCD packets in the MPEG-2
transport stream as sent by the CMTS to a target CM. A burst profile supports up to
five upstream burst types to describe an upstream channel.
burst type — One of five possible upstream burst types that describe an upstream
channel as carried in the burst profile portion of a UCD packet. Possible upstream
burst types include initial-ranging, periodic-ranging, request, long data, and short data.
Each burst type is one burst descriptor with up to twelve burst descriptor parameters.
cable modem service group (CM-SG) — The combination of upstream (US-SG) and
downstream channels (DS-SG) at the CMTS to which a CM has access.
channel bonding — The D3.0 CM feature that allows the CMTS to link a group of
channels based on the number of channels supported by the target CM. If the CMTS
creates a bonding group for a CM that has four physical downstream receivers, the
CM can receive over the four channels simultaneously in a downstream channel set.
downstream channel — The CMTS 50-MHz to 1-GHz channel over which the CMTS
sends MPEG-2 transport streams over the cable infrastructure to the one more
distribution areas. The downstream channel operates with the forward combiner to
deliver modulated content on carrier signals to target cable subscribers.
dynamic channel change (DCC) — The MAC management message from the CMTS
that instructs a CM to move from one channel to another within the CM-SG.
dynamic bonding change (DBC) — The MAC management that moves D3.0 CM
downstream service flows to different channels in the CM’s receive channel set
(RCS). DBC also moves D3.0 upstream service flows to different channels in the
current transmit channel set (TCS).
dynamic host configuration protocol (DHCP) — The IETF protocol for dynamically
assigning an IPv4 or IPv6 address to a requesting device, such as a CM. The CMTS
forwards a DHCP request from a CM to a dedicated DHCP server. The CMTS then
forwards the DHCP response message containing the IP address to the requesting CM.
dynamic load balancing — The CMTS traffic balancing method that moves CMs
among upstream and downstream channels within the same service group after their
initial difference between two channels exceeds a defined percentage.
exclusion list — A list of one or more CMs that the CMTS purposely excludes from
load balancing across CMTS downstream and upstream channels.
execution rule — A load balancing metric the defines the specific traffic conditions or
parameters that trigger load balancing operations at the CMTS.
fiber node — The physical cable infrastructure that links the cable headend to one or
more geographical distribution areas.
forward channel lineup — Modulated digital content, such as local and satellite
television, news and sports feeds, and streaming video, that is carried on CMTS
downstream MPEG-2 transport streams to cable distribution areas.
forward combiner — The cable headend device that places modulated digital content,
such as the downstream channel lineup, onto CMTS downstream carrier signals to
cable distribution areas.
forwarding engine — The set of CMTS processes that reside between the CMTS NSI
and RFI for controlling how CMTS traffic is forwarded “through” one or more MAC
domains or routed “to” network destinations.
general load balancing group (GLBG) — The complete set of upstream and
downstream channels in a CM-SG that are available for load balancing operations.
initial ranging — The upstream burst type carried by the upstream channel descriptor
in the MPEG-2 transport stream that enables a CM to request an upstream
transmission grant from the CMTS so that the CM can register with the CMTS.
interval usage code (IUC) — The CMTS-assigned code that schedules the initial
ranging interval in the upstream time line to the CMTS. Once a transmission interval
is set, the MAC domain then adjusts CM frequency, power, and delay for two-way
communication. IUCs are carried by MAP packets in the MPEG-2 transport stream.
load balancing — The CMTS process that enables CMs to move from one channel to
another so that traffic load is redistributed for improved bandwidth utilization and
reduced consumption of CMTS resources. See dynamic channel change and dynamic
bonding change.
MAC domain — The Open Systems Interconnect (OSI) Layer 2 device through which
radio frequency traffic is forwarded to CMs over downstream channels, and received
over CMTS upstream channels. The minimum MAC domain contains one upstream
and one downstream channel. The Casa CMTS is an integrated Layer 2 MAC domain
and a Layer 3 physical routing device supported by an internal forwarding engine.
Casa CMTS systems can support up to 96 MAC domains.
MAC domain descriptor (MDD) — The D3.0 packet carried by the MPEG-2 transport
stream that defines the receive channel set for CMs that support multiple receivers and
transmitters, such as a D3.0 CM with four downstream and four upstream channels.
MAC management message (MMM) — The CMTS message that carries the MPEG-2
transport stream that includes MAC time synchronization packets, UCD and MAP
packets, and the MDD.
MAP — Bandwidth Allocation Map packet carried by the MPEG-2 transports stream
that instructs the CM when to transmit over an upstream timeline by specifying when
time zero (t0) begins. The MAP carries a 32-byte field to indicate the service identifier
(SID) to declare “who” is transmitting, the interval usage code (IUC) that indicates
“what” type of transmission, and the t0 timing offset to indicate “when” to begin the
upstream transmission interval from t0 on the timeline.
minislot — A series or group of time components that make up one upstream time
interval. These intervals vary in size starting at time zero (t0) until the end of the
interval where t0 begins again. Time Division Multiplexing (TDM) scheduling sets
both long and short intervals in the timeline where the interval size is based on traffic
conditions. Each minislot in each interval is 6.25 microseconds.
MPEG-2 transport stream — The 188-byte packet carried in the MMM that includes
MAC time synchronization packets, UCD and MAP packets, and the MDD. An
MPEG-2 transport stream with a program identifier (PID) of 1FEE indicates that the
stream originates from a MAC domain. The MPEG-2 transport stream carries
modulated digital content signals to cable distribution areas.
network side interface (NSI) — The OSI Layer 3 routing side of the CMTS. The NSI
supports the IP routing protocols such as OSPF, RIP, BGP, and IS-IS to support
routing between neighbor routers. The CMTS uses 10/100 Fast Ethernet for
out-of-band remote management, as well as GigE and 10GigE interfaces for voice,
data, and video traffic routing. The NSI uses the CMTS forwarding engine to route
network protocol traffic to network destinations.
QAM64 — A 64-state modulation method that combines phase angle and amplitude
signals over downstream channels, operating over 6-MHz channels at 30 Mbps.
QAM256 — A 256-state modulation method that combines phase angle and amplitude
signals over downstream channels, operating over 6-MHz channels at 42 Mbps.
radio frequency interface (RFI) — The combination of at least one upstream and one
downstream channel to form the DOCSIS MAC domain. The CMTS provides both
upstream and downstream interfaces for transmission and receipt of digitized content
and data services over fiber network trunks and coaxial cable to and from the
subscriber distribution areas.
ranging backoff algorithm — The CMTS process that tells a CM how long to wait
before retransmitting another initial ranging request. The algorithm reschedules and
increases initial ranging transmissions at random intervals for CMs to avoid collisions.
Ranging backoff values are expressed exponentially, such that a value of 3
corresponds to 23 (or eight retry attempts).
receive channel set (RCS) — The downstream channels over which a CM receives
traffic from the MAC domain. The MDD in the MPEG-2 transport stream informs the
CM about the receive-channel configuration and the RCS to be used by that CM.
service group (SG) — The group of downstream channels over which a CM receives
traffic from the MAC domain, or the group of upstream channels over which the CM
transmits to the CMTS. The combination of both upstream and downstream SGs is
known as the CM-SG or DOCSIS fiber node.
service identifier (SID) — The 14-byte portion of the 32-byte packet carried in the
MAP that identifies a particular CM attempting to transmit upstream to the CMTS.
static load balancing — The traffic balancing method that instructs the CM which
channels to use after initial ranging. For D3.0 CMs, when a CM sends its REG-REQ,
the CMTS responds with a REG-RSP to instruct the CM to select the channels.
transmit channel set (TCS)— The CMTS 5-MHz to 42-MHz upstream channels over
which a CM transmits traffic to the CMTS MAC domain. Upstream channel
information is determined by the UCD and MAP packets carried in the MPEG-2
transport stream from the CMTS.
trivial file transfer protocol (TFTP) — The IETF protocol used by the CMTS to
transfer a CM configuration file from a dedicated TFTP server to a target CM, so that
the CM can properly configure itself for two-way communication with the CMTS.
upstream channel descriptor (UCD) — The packet carried in the MPEG-2 transport
stream that describes the upstream channels over the which a CM transmits to the
CMTS. Each UCD describes a frequency, width, and burst profile with a set of burst
descriptors. Each UCD has one associated MAP that instructs the CM on “when” to
transmit over an upstream timeline.
upstream service group (US-SG) — The group of CMTS upstream channels over
which a CM transmits traffic to the CMTS over a transmit channel set (TCS); the
group of upstream channels to which a CM has access.
Topic Page
You access the Casa CLI locally from a system console (serial connection) or
remotely over Telnet or SSH.
Perform the following steps for accessing the Casa CLI over a system console
attached to Casa CMTS:
1. Connect a PC to the CMTS by connecting one end of the RJ45 cable to the serial
RJ45 console port.
— On C2200 CMTS systems, connect the other end of the cable to the
RJ-45-to-DB-9 adapter, then connect the adapter to the serial port on the PC
or terminal to complete the console port cable connection.
— On C1G, C3200, C10G, C100G, and C40G CMTS systems using the supplied
RJ45 to DB-9 serial cable, connect the DB-9 end to the serial port on the PC
or terminal to complete the console port cable connection.
5. Log in using the user name root and the password casa.
CASA login: root
password: casa
Perform the following steps to access the CLI over a Telnet or SSH connection.
1. With the CMTS enabled on a network, connect a network cable from Ethernet
port 0 (eth 0) on the CMTS to a network patch panel, Ethernet switch, or device
such as a PC or laptop computer.
2. For Telnet, start the Telnet client. The default Telnet port is 23. At the Telnet
prompt, enter open ipaddress, then specify the IP address of the CMTS Ethernet
port. The Casa-assigned default management port IP address is 192.168.2.100
If you are using a program such as PuTTY, set the Connection Type to Telnet to
automatically change the port number to 23, then enter the management port IP
address in the Host Name block and select Open.
3. For SSH, start the SSH client and specify the host name or address for the system.
The default SSH port is 22 and default management port IP address is
192.168.2.100. If using the password authentication method, the system prompts
you for a password. If you use a valid public key or no authentication is required,
you automatically connect to the system.
If you are using a program such as PuTTY, set the Connection Type to SSH to
change the port number to 22 automatically, then enter the management port IP
address in the Host Name block and select Open.
4. Log in using the user name root and the password casa.
login as: root
root@192.168.2.100 password: casa
CASA#
Other SSH clients may work. However, Casa has not tested all possible SSH clients
with the Casa CMTS.
Before you can make changes to the CMTS configuration, you must initiate privileged
mode using the enable command and by specifying a password. On new systems, the
default password is casa.
CASA> enable
Password: casa
CASA#
CASA# exit
CASA>
Use the config command to enter CMTS configuration mode. Configuration mode
allows you to make changes to the running CMTS configuration file.
CASA> enable
Password: casa
CASA# config
CASA(config)#
To exit the current CLI session with the CMTS, use the exit command to revert back
to the top level prompt, then execute the logout command to close the session.
CASA> enable
password: casa
CASA# exit
CASA> logout
Startup configuration
The default CMTS bootup configuration is provided in the file named startup-config.
You can have any number of startup configuration files in the main CMTS directory
from which you can boot the system. Once the system has booted and is fully
operational, the startup configuration becomes the running configuration during
editing sessions, as described in the next section.
Running configuration
The running configuration controls the current operational state of the CMTS. As you
open system configuration objects and edit specific parameters, the CMTS applies the
new settings to the system immediately. When you are finished with the editing
session, you need to save the most recent settings to the default startup-config file (or
to a uniquely named file). By default, the CMTS uses the startup-config file at the next
system restart or reboot.
To save the latest configuration settings from the running configuration to the default
startup-config file, use the following command:
To display the running configuration at any time, use the following command:
Element Description
• router bgp
• interface vlan
• router rip
parameter A parameter is a value used by an object. Parameters are available at all
configuration levels of the CLI. For example, the BGP configuration object
includes parameters such as:
• distance
• neighbor
• redistribute
Element Description
command A command is a mechanism for applying an immediate action to the CMTS
configuration. Commands are available throughout all levels of the CLI.
Global commands are those commands that are available throughout the
CLI and can operate at one or more levels. Some example commands are:
• clear
• config
• copy
• del(ete)
• ping
• show
CLI hierarchies
The CLI prompt always indicates your location in the CLI hierarchy. It does not show
a complete object path hierarchy; instead it shows the object (and instance, if
applicable) in which you are located, as covered in Table 2-2.
Description Example
The exit and end commands allow you to navigate back to the previous level of the
CLI. Entering the exit command closes the current CLI session.
CASA(config-router-bgp)# exit
CASA(config)# exit
CASA# exit
CLI operations
The following sections describe usage techniques for working with Casa CMTS
configurations at the command line.
At any point in the CLI you can enter the question mark character (?) to display a
listing of commands that you can execute at the current object hierarchy as well as a
list of global commands. Note that you can also type just the command, a space, and
press [TAB] to get the same result. Refer to Table 2-3.
Command Function
Command Function
CASA(config-router-bgp)# distance ?
<1-255> Administrative distance
bgp BGP distance
Entering parameters
The CLI parameters, both required and optional, can be either a variable or one of
multiple predefined options or settings.
The following example takes a variable, a value that you supply, such as the unique IP
address 192.168.0.150:
The following example takes a predefined option from a list of displayed options:
CASA(config)# logging ?
facility facilityCode
host logging server vrf
non-volatile logging level for local log on non-volatile memory
(flash memory)
source-interface specify source interface
syslog logging level for syslog receiver
system logging level for console output
trap logging level for trap
volatile logging level for local log on volatile memory
(RAM FS)
CASA(config)# logging host ?
<ip-address> A.B.C.D, <port #> default is 514
<ipv6_addr> xxxx:xxxx:xxxx:...:xxxx <port #> default is 514
vrf specify the vrf name for logging host
CASA(config)# logging host 192.168.8.232
<cr>
CASA(config)# logging syslog ?
alerts emergencies and alerts events
critical emergencies, alerts and critical events
…
CASA(config)# logging syslog alerts ?
<cr>
You can display the list of available command options and global commands from
your current position in the CLI. Use the question mark (?) to display a brief summary
of the objects or parameters available to you. For example, to show what you can
configure under the IS-IS protocol, as well as display the global commands, enter the
router isis configuration context and type the question mark character. The
predefined options are also followed by brief descriptions.
The CMTS show commands provide a mechanism for displaying all aspects of the
running configuration. When you use the show ? command from the top-level prompt
or from the config prompt, the system displays a list of objects from the running
configuration.
Table 2-4 summarizes the show command usage at the Casa CMTS.
Command Function
Command Function
Some CMTS show commands accept output modifiers that filter the display so that
only desired information appears. Use this feature when a particular show command
output might be excessively long and when you need unique aspects. Filter the output
by entering the pipe or vertical bar (|) character followed by a specified operator and
filter in a quoted string (if a space character is included) or regular expression (regex).
Pipes can also be used in the quoted string or regex to indicate multiple entries. The
following example filters an OSPF configuration by certain parameters. Only the valid
matching entries appear, while others (such as “Other settings”) are ignored.
The specified filter uses operators that control how the information is filtered from the
display. For show commands that support the output modifiers, the following
operators are available:
• begin — Displays all lines that begin with the specified filter.
• include — Displays lines containing the specified filter. You can specify multiple
entries separated by pipes in the quoted (or dotted) string itself. If an entry is
invalid, it is omitted in the output, as indicated in the previous example.
• exclude — Omits lines containing the specified filter. Extended pipes can be used
in the quoted (or dotted) string to exclude multiple entries.
• count — Displays a count of the number of lines containing the specified filter at
the very end of the output.
• count-only — Displays a count of the number of lines containing the specified
filter while suppressing output.
The CLI uses a command completion feature that automatically completes typing an
object or parameter name. Pressing the keyboard [TAB] executes the completion.
• You must type an entry until it is minimally unique on the command line before
pressing [TAB] auto-completes the entry. If there are two commands that begin
with the same spelling, the CLI cannot differentiate between the two until you
type enough letters to distinguish one from the other.
• The entry must be a valid object or parameter.
• The CLI does not auto-complete user-configured instances or values.
CASA# con[TAB]
config entering config mode
console-password change console login password
CASA# conf[ENTER]
CASA(config)#
Pressing [TAB] after entering just co or con, which are not minimally unique, results
in prompting for further characters to make the entry unique. Pressing [TAB] after
entering the full conf completes the command line so that you can press [ENTER] to
enter configuration mode.
The CLI maintains a history of commands that you entered in the current editing
session. Use the [UP-ARROW] key on your keypad to re-display commands starting
from the most recent to the least recent entry with each key press. Once the desired
command is displayed, you can edit the command line and then re-execute the
command without re-entering the entire line.
When a parameter requires a string, such as user names, locations, and contact names,
the following rules apply:
Several configuration objects and actions require setting a date (such as a calendar day
and month) or time interval that reflects a number of hours, minutes, and seconds
(such as a system reboot timer). The CLI accepts multiple entry formats for setting
these intervals.
• hhh or hh — Hours, usually 0 to 23 for a single day, or 0 to 168 for hours over
multiple days
• mmm or mm— Minutes, usually 0 to 59 within a single hour, or 0 to 999 for
minutes over multiple hours.
• day — Numeric day in a calendar month in the range 1–31 depending on the
actual month.
• month — Month as a text string from January through December.
• YYYY-MM-DD — Specifies a date in the format year-month-day, such as
2015-05-20 (same as May 20, 2015).
The following command example sets a CMTS “upgrade” reboot for 11:00 p.m. on
April 30 with a reminder set for 30 minutes prior to the reboot.
Table 2-5 explains the some of the more common messages that the CLI returns in
response to user input:
Message Meaning
Syntax error The specified input is incorrect. Check for any typos.
% Command incomplete. The specified command requires additional input or
parameters. Use the ? character to display the valid
option(s) for the command.
Doesn’t match current Too many parameters were specified. Check the format
mode. of the command for the expected input.
% Unknown command. The specified command is not valid or the command does
not operate at the current level of the CLI.
% There is no matched An invalid command, followed by the ? character, was
command. entered on the command line. Check for typos.
Incomplete command. The command requires additional input or parameters.
Use the ? character to display the valid option(s).
Ambiguous command. The command was attempted at the incorrect level of the
CLI or is incomplete. Check to see if you are in
configuration mode and retry the command.
Invalid date format. The required date was not entered as expected. The date
format is YYYY:MM:DD to represent year:month:day.
Invalid metric value. The specified metric value was not in the accepted range.
Use the ? character after the metric parameter to display
the accepted input.
Note that once you create an alias, the command completion feature in the CLI
displays the alias preceded by the asterisk (*) character.
For example, to remove a previously set command alias, simply precede the command
with the word no. The alias will no longer appear in the list of options.
Topic Page
Topic Page
Note: Login for non-superusers is enabled to the active Switch and Management
Module (SMM) only.
The Fast Ethernet interface (eth0) has the following default IP address and subnet
mask: 192.168.2.100 255.255.255.0.
To change the default IP address and subnet mask, perform the following steps:
1. Log in to the CLI using the root login and the casa password.
2. Enable CMTS privileged (enable) mode to configure the CMTS, with the default
password casa.
3. Enable configuration mode using the config command.
4. Enter the show interface eth command to show the IP addresses of the Ethernet
interfaces.
5. Enter the interface eth 6/0 command to change the default IP address and
network mask of the CMTS management port.
CASA> enable
Password: casa
CASA# config
CASA> enable
Password: casa
To revert to the default password (casa), use the reset password command from a
locally attached console. (See the appropriate hardware installation guide for the
CMTS system you are using.) You cannot reset the password over a network
connection.
Encrypting passwords
By default, the CMTS does not encrypt passwords. To encrypt the privileged (enable)
mode password, use the password command with the encrypted option.
CASA> enable
Password: casa
modified. Users are assigned a privilege level during creation that can be modified
later. The privilege level is a number from 1 through 15, with 1 being the lowest and
15 the highest level. The users with privilege level 15 are called superusers.
While user management allows valid users to gain access to the system and maintain
the status of the users, security control governs the specific actions performed by
users.
The root user is a special superuser that cannot be deleted. The system always has the
user root and the password of this user can be changed by a superuser. Only a
superuser can perform all user management. An exception is resetting the password of
user root to a default password. This operation is permitted only from the console of
the CMTS and can be executed by any user. See the section “Changing the default
CMTS password”.
The following CLI session creates the user named fred at privilege level 8. This user
must specify the configured password for access to the CMTS. A password must
contain between five and eight characters using a combination of upper and lower
case letters and number. If the privilege level is omitted, the configured user defaults
to privilege level 1.
User fred’s allowed command execution are set based on his assigned privilege level.
Command execution can be separate for exec and configuration CLI commands. The
command for this is the privilege command, with the following example:
To display the current list of users configured at the CMTS where you are logged on,
execute the show user command. In this case, the user fred password is plain text.
If you choose to disable SSH using the no form of the command, copy the running
configuration to the startup configuration and then reboot the CMTS to disable SSH
by default. For information on copying the system configuration file, see Chapter 4,
“Managing the CMTS configuration file.”
To reconfigure, enable, and display the Telnet port number at the CMTS:
CASA# config
CASA(config)# telnet port 23
The line vty command sets the maximum number of concurrent Telnet sessions to the
CMTS. The default setting is the maximum 31 sessions.
CASA# config
CASA(config)# line vty 12
By default, there is no expiration time for Telnet and SSH sessions. The
telnet timeout command sets the expiration time for Telnet or SSH sessions that have
become inactive. The timeout range is 1–1440 minutes (maximum 24 hours).
The following CLI session closes an inactive Telnet session after 60 minutes.
CASA# config
CASA(config)# telnet timeout 60
1. Configure the TACACS+ server host IP address string and set the encryption key
to be sent in authentication messages to the TACACS+ server. Specify 0 to send
the key in clear text, or specify 7 to send the key as encrypted.
2. Set a timeout value in seconds in the range 1–60. The session between the
TACACS+ server and the CMTS times out when there is no activity detected
during this time period.
3. Configure TACACS+ login and password authentication.
4. Optional: Configure ASCII clear text authentication.
The following CLI session sets the TACACS+ server host IP address and server
access encrypted keyword, with encrypted indicated by the trailing 7 value.
The following CLI session enables password and login authentication at the
TACACS+ server:
Clear text authentication transmits user names and passwords as unencrypted. The
following CLI session enables TACACS+ ASCII clear text authentication:
1. Configure the RADIUS server host IP address string and the UDP authentication
port for RADIUS UDP messages. The known UDP port for RADIUS
authentication is 1812.
2. Set the RADIUS encryption key to be sent in UDP messages to the RADIUS
server. Specify 0 to send the key in clear text, or specify 7 to send the key as
encrypted.
3. Set maximum number of connection retries to the RADIUS server (up to five) and
a server timeout value in seconds (up to 60) if no transmission activity is detected.
4. Configure RADIUS login and password authentication.
5. Optional. Configure ASCII clear text authentication in which usernames and
passwords are transmitted as unencrypted.
Note: One loopback interface can be configured for both TACACS+ and
RADIUS concurrently.
The following CLI session sets the IP address and network mask for loopback
interface 10. The interface is the source interface for both TACACS+ and RADIUS
authentication messages.
The following CLI session creates separate loopback interfaces for TACACS+ and
RADIUS authentication messages.
The tftp-enforce command enables the CMTS to reject registration requests from
CMs that did not download their DOCSIS configuration files from a TFTP server.
This TFTP requirement is set on a per DOCSIS MAC domain.
When TFTP is enforced, only those CMs that have had their configuration files
downloaded from a TFTP server are allowed to register with the CMTS. The default
configuration setting for tftp-enforce is disabled.
The following CLI session sets TFTP enforce for all CMs registering on the DOCSIS
MAC 2 domain.
For additional information on configuring TFTP hosts and TFTP proxy services, see
Chapter 5, “Configuring DHCP, TFTP, NTP, DNS, and logging services.”
Once an option for TFTP proxies is configured, the CMTS adds the corresponding
address to the TFTP message. The corresponding address can be hw-addr (hardware
address), net-addr (network address), both, or none.
The following CLI session configures both the hardware address and the network
address into the TFTP message:
You can ensure that CPEs are on the same Virtual Routing and Forwarding (VRF)
instance as the CM using the cable sec cm-vrf-enforce command in the IP bundle and
sub-bundle configurations. This addresses situations where CMs in different
sub-bundles than their multimedia terminal adapter (MTA) devices cannot come
online with the CMTS. IPv4 and IPv6 CMs are supported with this change. The cable
sec cm-vrf-enforce command change does not take effect until CMs are reset.
When enabled, CPEs are enforced to the same VRF as the CM where packets are
allowed to pass and packets from other VRFs are blocked. When the
cable sec cm-vrf-enforce parameter is not configured or is disabled (by default), all
packets will pass.
Example:
CASA(conf)# interface ip-bundle 5
CASA(ip-bundle-5)# cable sec cm-vrf-enforce
For details on VRF, see the “Virtual routing and forwarding” chapter in the Casa
Systems – NSI Configuration Guide and Command Reference.
The CMTS uses DHCP to request IP addresses from a DHCP server for CMs and CPE
devices that register with the CMTS. DHCPDISCOVER, DHCPOFFER,
DHCPREQUEST, and DHCPACK messages are exchanged between the DHCP client
and server.
When DHCP authorization is enabled at the CMTS, CPE devices behind the CM get
their IP addresses from the DHCP server IP configured at the CMTS. By default, the
dhcp-authorization parameter under the DOCSIS MAC domain is set to enabled so
that unauthorized IP addresses are not allowed. When dhcp-authorization is set to
disabled, users can create their own IP addresses, which can result in IP address
conflicts, as well as IP and MAC address spoofing.
Once a CM has an assigned IP address, the CMTS uses TFTP to download the CM
configuration file from the TFTP server to the CM. Using the configuration file, the
CM configures itself with the correct parameters to operate with the CMTS.
DHCP authorization, when enabled on a MAC domain, prevents IP address and MAC
address spoofing. The dhcp-authorization property is enabled by default so that
unauthorized IP addresses are not allowed at the CMTS.
For details on DHCP leasequery and configuring DHCP hosts using the cable
helper-address in the MAC domain IP-bundle, see Chapter 5, “Configuring DHCP,
TFTP, NTP, DNS, and logging services.”
The CMTS provides commands that enforce the Baseline Privacy Interface (BPI) and
Baseline Privacy Interface Plus (BPI+) security protocols running between the CMTS
and CMs. BPI authentication protocols protect CM data traffic by preventing
upstream and downstream eavesdropping by other users who are connected over the
same cable. Traffic between the CMTS and the CMs is encrypted using an
encapsulation protocol, as well as a key management protocol called Baseline Privacy
Key Management (BKPM) for processing authentication and authorization key
exchanges between the CM and CMTS.
BPI+ is required on all DOCSIS 1.1 (and later) compliant CMs. Earlier CMs use BPI.
Note: When the bpi-plus-enforce setting is enabled at the CMTS, BPI CMs
running DOCSIS 1.1 or higher that are not running BPI+ cannot register with
the CMTS. However, non-BPI CMs are allowed to register.
Note that the bpi-enforce and bpi-plus-enforce parameters can be set concurrently in
the CMTS configuration, as each setting operates on different CM types.
The Casa CMTS supports three encryption algorithms: 40-bit Data Encryption
Standard (DES), 56-bit DES, and 128-bit Advanced Encryption Standard (AES). CMs
that do not support at least 40-bit DES encryption cannot complete BPI.
The following CLI session sets encryption algorithms with priorities, where the first
algorithm assumes the highest priority followed by the subsequent ones. The CMTS
chooses the highest priority algorithm that the CM supports for data traffic encryption.
The cable sa-des-tlvlen-2 command sets the security association type-length value
(TLV) length to two bytes as required by some BPI-authenticated CMs. These CMs
might not be able to register with the CMTS using a one-byte descriptor. Use the no
form of the command to reset the two-byte SA descriptor TLV to one byte.
Because DOCSIS configuration files from an authorized TFTP server provide critical
quality of service (QoS) definitions and other data for CMs, security measures must be
applied to protect the configuration file from unauthorized intercept, theft,
substitution, and potential modification.
configured, these passwords calculate the CMTS Message Integrity Check (MIC)
field that is attached to all DOCSIS configuration files.
The CMTS supports a maximum of 198 shared secrets (primary, secondary, and
primary/secondary extended), including those shared secrets defined under the
interface docsis-mac configuration.
The following CLI session displays the shared secret options, then sets the primary
authentication shared-secret encryption key for non-encrypted messages or encrypted
messages:
CASA(config)# shared-secret ?
0 Specifies that an unencrypted message (clear text)
will follow
7 Specifies that an encrypted message will follow
<mic_string> authentication shared-secret encryption key
To set the shared-secret MIC for the extended TLVs received from Reg-Req message:
To set the shared-secondary-secret MIC for the extended TLVs received from
Reg-Req messages:
{
UsServiceFlowRef 1;
QosParamSetType 7;
}
DsServiceFlow
{
DsServiceFlowRef 2;
QosParamSetType 7;
}
/* CmMic 49b9d8d459f9a9119f43188372a00422; */
/* CmtsMic 0dc1e7ce52cb806a57f13d9eea9c4db8; */
/*EndOfDataMkr*/
)
In the previous configuration file, the TLV value for SAV Group Name Subtype is
merlin (in hex format: 6d65726c696e). When the CM registers with the CMTS, the
CMTS does note the SAV for the CM. The CMTS must be configured as:
192.168.7.77 is the static IP used by the CPE. The 32-bit mask specifies only this IP.
Use a mask to allow a contiguous range of IP addresses. The number “1” after the
“merlin” string is the SAV Group Name Subtype.
To authorize an individual MAC address without changing the CM config file, use the
following command by specifying the CPE MAC and IP addresses:
Topic Page
Before you can make changes to the CMTS configuration, you must initiate privileged
mode using the enable command and specifying a password. On new systems, the
default password is casa.
CASA> enable
Password: casa
CASA#
CASA# exit
CASA>
For information on adding users and user privileges, see Chapter 3, “Administering
CMTS security.”
The default CMTS boot configuration is provided in the file named startup-config.
You can have any number of startup configuration files in the main CMTS directory
from which you can boot the system. Once the system has booted and is fully
operational, the startup configuration becomes the running configuration during
editing sessions.
The running configuration controls the current operational state of the CMTS. As you
open system configuration objects and edit specific parameters, the CMTS applies the
new settings to the system immediately. When you are finished with the editing
session, you need to save the most recent settings to the default startup-config file (or
to a uniquely named file). By default, the CMTS uses the startup-config file at the
next system restart or reboot.
To save the latest configuration settings from the running configuration to the default
startup-config file, use the following command:
If you attempt to copy the running configuration to the startup configuration when a
module is not in the running state, the following message is displayed:
One or more modules are not in running state. You might lose part of
your startup-config if you save now. You can wait or use 'copy run
start unconditional' to save your config anyway.
You can wait for the module to boot up or you can force the reboot by retyping the
command and adding the unconditional argument.
The following CLI session displays the copy running-config command options:
The following example copies the current startup-config file to the file named
configfile1 in NVRAM.
To transfer a Casa software image (or any file) from a TFTP server, use the copy tftp
command as follows:
Where:
• <host_ip> is the IP address of the host computer or server where the update image
is presently stored.
• <file> is the name of file to be transferred to the CMTS.
• <device> is the CMTS software storage device. On the C10200 or C3200 CMTS,
the storage device is flash1 or flash2. On Casa C10G and C100G systems, the
storage device is nvram or fdsk2.
The following CLI session copies the file named C10g.gz.rel6.1.3_build31 file from
host at IP address 192.168.3.10 to NVRAM:
The following CLI session copies the file named casa_6000.gz.rel6.1.3_build31 from
the host at 192.168.3.10 to flash1:
The following example copies the stored startup-config file into the current running
configuration. The startup-config material is merged with the running-config material,
while any conflicting values are overwritten by the startup-config values.
The following example restores the previously saved configuration named configfile1
from NVRAM to the destination startup-config file in NVRAM.
Displaying configurations
To display the running configuration at any time, use the following command:
On a new system, or from a system that you just rebooted, there is no difference in the
displayed output.
Topic Page
Cable helper addresses specify the IP destinations of one or more DHCP servers for
UDP broadcasts from both CMs and CPE devices. These cable helper addresses are
specified in the IP bundle configuration in a DOCSIS MAC domain.
The following CLI session opens the ip-bundle instance identifier and context,
displays the cable helper-address command options, and sets the IPv4 server address
to which all DHCP requests are forwarded. Note that the command options following
the DHCP server address enable filtering of DHCP broadcasts to specific device types
(CMs, MTAs, and so on). In this example, the DHCP server forwards all IP addresses
to all requesting devices:
1. Configure the ip-bundle primary address using the ip address command. If only
the primary IP is configured (no secondary IP or DHCP address), all
DHCPDISCOVER messages (CM, MTA and CPE) are relayed to the DHCP
server with a source IP address of the specified primary IP.
2. Configure the ip-bundle secondary address using the ip address command with
the secondary option. If the primary IP and at least one secondary IP are
configured (with no DHCP gateway interface address GIADDR), the
DHCPDISCOVER message from the CM is relayed to the DHCP server with a
source IP address of the primary while the DHCP discovery from the MTA and
CPE is relayed to the DHCP server with a source IP address of the first secondary
IP. If more than one secondary IP address is configured, the DHCP server assigns
the IP addresses in the different subnets to the CPE or MTA.
3. Configure unique cable helper addresses to destination DHCP servers as needed.
4. Create the DOCSIS MAC domain and include this ip-bundle interface in that
domain. Use the DOCSIS MAC ip bundle command to specify the instance
identifier. For details, see Chapter 6, “Creating a new CMTS configuration.”
5. Ensure that DHCP authorization is enabled on the DOCSIS MAC interface using
the dhcp-authorization property. For details on DHCP authorization, see
Chapter 3, “Administering CMTS security.”
1. If the device’s IP address is in the primary, secondary, or host range as set for the
IP bundle, the leasequery request is sent to all cable helper-addresses (except
those marked with the cable-modem keyword).
2. If the device’s IP address matches a CPE class or multimedia terminal adapter
(MTA) range, the leasequery request is sent to all the specific cable
helper-addresses that are an exact match. Otherwise, Rule 1 applies.
The device’s IP address is in the primary, secondary, or host address range configured
in the IP bundle, with one or more cable helper-addresses. The request is sent to all
cable helper-addresses except the one marked cable-modem.
The device’s IP address is in CPE class b2. The request is sent to the cable
helper-address marked b2, and to any cable helper-address for an IP address matching
the host or secondary address range.
/etc/dhcpd.conf
allow leasequery; <---- Enables DHCP leasequery on the DHCP server
host cpe_lab {
}
subnet 10.10.9.0 netmask 255.255.255.0 {
You can also enable DHCPv6 lease synchronization at reboot by using the
dhcpv6 leasequery bulk command. The dhcpv6 leasequery sync-leases command
manually synchronizes leases using bulk transmission.
If dhcpv6 leasequery is set, a leasequery is sent to the DHCP server when a packet
with a source IPv6 address (that is not present in the ARP and local DHCPv6 CPE
lease table) is received.
If dhcpv6 leasequery enforce is set, a leasequery is sent when a packet with a source
IPv6 address (that is not present in the ARP table) is received.
The messages returned from the DHCP server have the following default values:
• 30 — query
• 31 — unassigned
• 32 — unknown
• 33 — active
The following CLI session changes the default coding for query, unassigned,
unknown, and active to 35, 45, 55, and 65 respectively.
Press the [TAB] key to get 1-query and enter a value (up to two digits) for the message
type and a space. Again, press the [TAB] key to get 1-unassigned and type (up to two
digits) and a space. Repeat this process for 1-unknown and 1-active.
The show dhcp leasequery configuration command displays the revised settings.
Use the tftp-proxy command on the DOCSIS-MAC interface to allow CMs to get the
CM configuration file from a TFTP server.
The tftp-enforce command enables the CMTS to reject registration requests from
CMs on the specific MAC domain. CMs must first download their configuration files
from a TFTP server before the CMs are allowed to register with the CMTS.
The following CLI session enables the CMTS as the TFTP proxy for the DOCSIS
MAC interface and enforces CMs registering with this CMTS at this DOCSIS MAC
domain to use TFTP to get their configuration files.
Optionally, the source interface (“from” address) over which a TFTP request is sent
can be either an IP bundle interface assigned to the MAC domain or a CMTS
loopback interface in the range 0–255.
The following CLI session configures and synchronizes the remote NTP server at IP
address 192.168.4.200.
Optionally, set the CMTS source interface for NTP client traffic in the range 0–15. A
warning message is returned to the console if the loopback interface has not yet been
configured with an interface number and IP address under the interface loopback
configuration.
The following CLI session configures the IPv4 address for the DNS server at
192.168.4.30 and CMTS loopback interface 12 as the source interface for DNS traffic.
Logging levels determine the severity of the information collected in the log file. The
user can set the logging levels as needed. Table 5-1 lists and briefly describes the
logging levels and corresponding keywords used to set the logging levels for these
types of messages. Level 0, emergencies, is the lowest level and logs only the most
serious errors. Level 7, debugging, is the highest level, which includes the most
messages, because these logs include messages from all levels.
System and console logging is Errors by default. Non-volatile and SYSLOG logging
is Warnings by default. Volatile and trap logging is off by default.
The following CLI session configures logging levels for messages reported to the
CMTS console and SYSLOG hosts.
The following CLI session configures the target SYSLOG host at IP address
192.168.46.200. The IPv6 address can alternatively be specified.
1. Enter the CLI show logging all command to display the current logging settings at
the CMTS.
2. The logging facility command can be specified to configure the codes for
well-known SYSLOG services or the type of application programs that log
messages. The following local0 through local7 options are currently supported:
• local0 — PostgreSQL
• local1 — (not supported)
• local2 — Sudo
• local3 — Versions of SpamAssassin
• local4 — SLADP (OpenLDAP server)
• local5 — Snort IDS
• local7 — Boot messages on Fedora 12
3. The user log exclusion-list can be used to selectively disable logging of certain
message levels from specified users. Messages associated with the specified log
level (and all lower severity levels) for the specified user are disabled and are not
logged. This functionality keeps unnecessary messages from filling up the log file.
4. The logging source-interface loopback command specifies the loopback
interface in the range 0–255 from which log messages are forwarded to a logging
target.
The following CLI session enables cable event reporting configures the target
SYSLOG server for cable events.
You can also use the cable event <id> delivery command to enable forwarding of
major cable event messages to the SYSLOG server.
Use the show running-config | include syslog command to display and verify the
current SYSLOG server for DOCSIS events.
Priority Description
emergency Sets the event reporting flag for emergency system error
messages. (Emergency messages indicate that the system
has become unusable and requires immediate attention. This
problem might also be affecting other parts of the network.)
alert Sets the event reporting flag for alert system error messages.
(Alert messages indicate that some type of system or
connection failure has occurred and requires immediate
attention.)
critical Sets the event reporting flag for critical system error
messages. (Critical messages indicate that an error occurred
which requires immediate attention to avoid system or
connection failure.)
error Sets the event reporting flag for error system error messages.
(Error messages indicate that an error condition occurred that
requires attention to resolve. Failure to address this problem
results in some type of system or connection failure in the
near future.)
Priority Description
warning Sets the event reporting flag for warning system error
messages. (Warning messages indicate that a condition
occurred that indicates attention is needed in near future to
avoid potential problems. Failure to address this problem
could result in some type of system or connection failure later
on.)
notice Sets the event reporting flag for notice system error
messages. (Notice messages indicate that a situation
occurred that is normal but is significant enough that system
administrators might want to notice.)
informational Sets the event reporting flag for informational system error
messages. (Informational messages might or might not be
significant to the system administrators.)
debug Sets the event reporting flag for debug system error
messages. (Debug messages appear only when debugging
has been enabled.)
flags Sets the event reporting flags value, in hex, which specifies
how this particular type of event message should be reported.
The first value relates to the non-volatile log while the second
(optional) value relates to the volatile log and can only be
either 0x00 or 0x80. The valid values are shown as follows:
The following CLI session sets DOCSIS event reporting priority to emergency and
sets the SYSLOG server and trap receivers flag (0x60) along with the local volatile
log reporting flag (0x80).
The following CLI session enables logging of DOCSIS event messages to a SYSLOG
server:
1. Execute the CLI show cable event notification policy command to display the
current cable event logging and priority flags.
2. To configure how the CMTS throttles the SNMP traps and SYSLOG messages it
generates for DOCSIS event messages, use the cable event throttle-adminStatus
command in global configuration mode.
3. To specify the throttle interval, which controls how often the CMTS generates
SNMP traps and SYSLOG messages for DOCSIS event messages, use the
cable event throttle-interval command in global configuration mode.
4. To set the maximum number of SNMP traps and SYSLOG messages that the
CMTS can generate for DOCSIS event messages during the throttle interval, use
the cable event throttle-threshold command in global configuration mode.
The following CLI session copies the file named logfile.bak to the TFTP host at IP
address 192.168.3.10.
Use the CMTS dir fdsk2 command to display the current list of files.
Topic Page
1. Properly installing the CMTS hardware in the cable headend according to the
specific hardware installation guide:
• Casa Systems – C1G CMTS Hardware Installation Guide
• Casa Systems – C2200 CMTS Hardware Installation Guide
• Casa Systems – C3200 CMTS Hardware Installation Guide
• Casa Systems – C10200 CMTS Hardware Installation Guide
• Casa Systems – C10G CMTS Hardware Installation Guide
• Casa Systems – C100G CMTS Hardware Installation Guide
2. Connecting a local or remote network management system over Telnet or SSH to
the default Ethernet management port (eth0) at default IP address 192.168.2.100.
See Chapter 3, Administering CMTS security for information on connecting to
the CMTS management port.
For direct console connections, see the matching Casa hardware installation guide
for information on connecting a console to the CMTS serial console port.
3. Installing all required headend networking equipment to include gateways to the
Internet, as well as connections to provisioning servers (DHCP, TFTP, ToD, DNS,
SYSLOG). See Chapter 5, Configuring DHCP, TFTP, NTP, DNS, and logging
services for information on configuring these provisioning services.
4. Enabling CM and customer premises equipment (CPE) compatibility with the
CMTS IP network and DOCSIS RF services.
5. Preparing a channel plan for assigning upstream and downstream channel
frequencies.
If you are running the Simple Network Management Protocol (SNMP) to manage the
CMTS configuration from a remote management, see the Casa Systems – SNMP MIBs
and Traps Reference for information on configuring the SNMP agent at the CMTS.
The following CLI session creates the IP bundle with group ID 1. Up to 16 IP bundle
group IDs can be configured. If the primary IP address is configured (with no
secondary IP or DHCP gateway address), all DHCPDISCOVER messages (CM,
MTA and CPE) are relayed to the DHCP server with a source IP address of the
primary IP.
If the primary IP and at least one secondary IP is configured (with no DHCP gateway
address), the DHCPDISCOVER from the CM is relayed to the DHCP server with a
source IP address of the primary. The DHCPDISCOVER from the MTA and CPE is
relayed to the DHCP server with a source IP address of the first secondary IP. If more
than one secondary IP address is configured, the DHCP server assigns the IP
addresses in the different subnets to the CPE or MTA.
While CMs request an IP address from the same DHCP server, CPE requests are sent
to a different server. The DHCPDISCOVER from the CPE depends on the CM IP
address, where the CPE has an IP address from the subnet associated with the CM IP
address.
Example
The following CLI session creates the IP bundle subinterface 1.1 and the primary and
secondary IP addresses for CMs and CPEs.
Casa CMTS systems can support up to 96 DOCSIS MAC domains depending on the
CMTS model.
Upstream and downstream channels operate in a shutdown state unless they are
bounded in a DOCSIS MAC domain. A MAC domain cannot be enabled without IP
address, helper address, and at least one downstream and upstream channel. As
covered in the previous sections, IP addresses must be configured in the IP bundle
interface that is assigned to the DOCSIS MAC domain.
The following CLI session creates DOCSIS MAC domain 10. On C10G and C100G
systems, a DOCSIS MAC domain can be configured in the number range 1–96.
Each DOCSIS MAC must include one previously configured IP bundle interface
containing primary and secondary IP addresses, along with the cable helper addresses
to DHCP servers. Otherwise, CMs cannot download their configuration files and
register with the CMTS over the channel bindings in the DOCSIS MAC domain. The
following CLI session uses the ip bundle command to bind the previously configured
IP bundle 6 to MAC domain 10.
With Release 6.1.x and earlier, modules are set to use the channels-per-port number. If
your company purchases and licenses four channels per port on QAM 8x8 card, you
cannot use the fifth channel on any of the ports. With Release 6.4.1, each upstream or
downstream module is limited by the total number of channels per module.
On the QAM 8x8 with four licensed channels per port, you can configure a total of
4 (channels) * 8 (ports) to equal the total 32 channels across the eight ports. You can
also choose to configure eight channels on the first four ports, or randomly pick
channels across the eight ports to form a total of 32.
Flexible channel licensing applies to all upstream and downstream modules, including
the UPS 16x8 and the QAM 8x96 and QAM 8x192.
The number of downstream channels is limited only by the specific QAM module you
are configuring and whether a certain number of channels less than that module’s
capacity was licensed to you. See the “Binding channels to the MAC domain” section
in this chapter for information.
The downstream port is defined in the following format when issuing the
downstream or interface qam command:
X/Y/Z — Where X is the system slot number, Y is the system port number, and Z is
the channel number.
Depending on the specific CMTS model you are configuring, slot, port, and channel
numbers will vary. For example, on the C100G CMTS, valid slot numbers for a
QAM 8x192 module would be in the range 0–5 or 8–13, port numbers in the range
0–7, and narrowcast channel numbers in the range 0–79.
• QAM 8x8—Eight QAM modules with each eight channels. QAM 8x8 modules
have two modes of operation: normal and high frequency. Normal mode requires
all channels on a given QAM module to be contained in the range 47–860 MHz.
High frequency mode requires all channels on a module in the range 295–
999 MHz. Each QAM module is completely independent of other modules in the
same chassis; some modules can be in high-frequency mode, while others are in
normal mode. The center frequencies for channels on the same port are correlated.
When any one is set, the others change accordingly. The center frequency of each
Casa QAM modules have two modes of operation: normal and high frequency.
Normal mode requires all channels on a given QAM module to be contained in the
range 47–860 MHz. High frequency mode requires all channels on a module to be in
the range 295–999 MHz.
To change the channel frequency from one mode to the other, if the module starts with
port 0 at 100 MHz, then all other ports are set at 500 MHz with the module in normal
mode. If you attempt to set port 3 to 900 MHz, the module does not accept the setting
because it requires high-frequency mode (295-999 MHz). Because port 0 is currently
in normal mode, you must first set it to at least 295 MHz before attempting to set
port 3 to 900 MHz. This means that if any channel frequency is greater than 860 MHz,
then all ports must be greater than 300 MHz.
Each QAM module is completely independent of other modules in the same chassis.
That means some modules can be in high-frequency mode and others in normal mode.
The center frequencies for channels on the same port are correlated. When any one is
set, the others change accordingly. The center frequency of each channel is separated
by 6 to 8 MHz, depending on whether the QAM port is configured as Annex type B,
C, or A. Annex B channels are separated by 6 MHz.
Example
CASA(config-if-qam 11/0)# channel 1 frequency 555000000
CASA(config-if-qam 11/0)# show interface qam 11/0
interface qam 11/0
no spectral inversion on
annex B
modulation 256qam
interleave 128x1
power 510
channel 0 frequency 549000000
channel 0 shutdown
channel 1 frequency 555000000
channel 1 shutdown
…
channel 7 frequency 591000000
channel 7 shutdown
shutdown
The QAM 8x96 and QAM 8x192 modules support both narrowcast and shared
channels, where each of the eight ports consists of 36 unicast channels and 12 shared
channels. Shared channels are RF channels that operate over any or all eight physical
ports, totaling 96 channels.
To configure shared channels in extra narrowcast mode, use the module command in
the following format:
This command sets the total number of narrowcast channels on the module RF
downstream ports. If the number of narrowcast channels is more than 32 as specified
by the command, the system places a set of shared channels in extra narrowcast mode
to meet the assigned number. The maximum value for narrowcast channels is 48,
which is the default setting.
• When module <id> narrowcast-channels is set to 48, all 96 channels are equally
allocated to the eight RF ports, and there is no multi-port shared channel available.
• When set to 36, all 96 shared channels are available for multi-port shared
channels. However, the number of QAM channels per RF port cannot exceed 128.
Example
CASA(config)# module 0 narrowcast-channels 44
This command creates 44 narrowcast channels. Use the no form of the command to
remove the current narrowcast channels configuration setting and revert to the default
setting of 48 narrowcast channels.
In multi-port shared channel mode, the content of the channel can be replicated to all
eight RF ports. The set of downstream ports on each shared channel can be selected to
allow a subset of RF ports for shared channel replication. The RF frequency of the
shared channels must be the same on all outgoing RF ports.
The optional range 1–32 is the number of channels to which the frequency applies
using a single command.
Example
CASA(config)# interface qam 0/0
CASA(config-if-qam 0/0)# shared-channel 0 frequency 555000000
Once a shared channel on one of the QAM 8x192 ports is created, this channel can
then be shared across one or more ports (up to seven additional) on the same module.
The following CLI session configures the video-only multi-port shared channels on
port 0 and shares them with port 1:
Example
CASA(config)# module 4 narrowcast-channels 64
CASA(config)# show narrowcast-channels
module 4 narrowcast-channels 64
PORT CHAN SH_CH FREQ(MHz) BINDP BINDC BINDM ANNEX MOD SYMB REPL-P P_MASK BLK_OFF
STATUS
0 0 0 47000000 0 64 ff A 256qam 6952 255 00 0 0 up
0 1 1 55000000 0 65 ff A 256qam 6952 255 00 0 1 up
0 2 2 63000000 0 66 ff A 256qam 6952 255 00 0 2 up
0 3 3 71000000 0 67 ff A 256qam 6952 255 00 0 3 up
0 4 4 79000000 0 68 ff A 256qam 6952 255 00 0 4 up
0 5 5 87000000 0 69 ff A 256qam 6952 255 00 0 5 up
0 6 6 95000000 0 70 ff A 256qam 6952 255 00 0 6 up
0 7 7 103000000 0 71 ff A 256qam 6952 255 00 0 7 up
0 8 8 111000000 0 72 ff A 256qam 6952 255 00 0 8 up
0 9 9 119000000 0 73 ff A 256qam 6952 255 00 0 9 up
0 10 10 127000000 0 74 ff A 256qam 6952 255 00 0 10 up
0 11 11 135000000 0 75 ff A 256qam 6952 255 00 0 11 up
0 12 12 143000000 0 76 ff A 256qam 6952 255 00 0 12 up
0 13 13 151000000 0 77 ff A 256qam 6952 255 00 0 13 up
0 14 14 159000000 0 78 ff A 256qam 6952 255 00 0 14 up
0 15 15 167000000 0 79 ff A 256qam 6952 255 00 0 15 up
5. Add multi-port shared channels to the video QAM domain and QAM group. The
qam-group command in the video qam-domain configuration supports the range
of narrowcast and multi-port shared channels.
Example
CASA(config)# video qam-domain 1
CASA(conf-qam-domain 1)# qam-group <id> shared-channel
<first> <last>
where id is the QAM group ID in the range 1–8, and first and last are the first and
last QAM channels in the block of multi-port shared channels.
CASA(config)# video qam-domain 1
CASA(conf-qam-domain 1)# qam-group 2 shared-channel 0/0 0/15
To use the maximum number of narrowcast channels per port (>64), use the
video channel-id-offset <n> command so that the number of narrowcast video
channels per port is less than or equal to 64. The command excludes DOCSIS
channels from the video channel numbering space. The specified offset indicates the
number of reserved DOCSIS channels. Video channel numbering begins following
the offset, with the first video channel number beginning at 0.
Example
CASA(config)# show narrowcast-channels
module 2 narrowcast-channels 40
module 12 narrowcast-channels 70
Release 7.2 supports Multiple Program Transport Stream (MPTS) processing over
QAM 8x192 ports 0–7 where one input MPTS can be output to one QAM multi-port
shared channel. Note that PID replacement (drop and add) is supported with broadcast
video.
Perform the follow steps to configure the QAM for broadcast video:
Create a video pass-through session on one QAM 8x192 module, then repeat the
command for additional QAM 8x192 modules. In the following example, the MPTS
broadcast video stream is configured on shared channel 4/0. The MPTS is destined for
the multicast group address at IP 227.0.0.0 and the video source IP address for the
MPTS is 17.56.102.2.
Example
CASA(config)# video session 1 pass-through ip-address 227.0.0.0
qam-channels shared-channel 4/0 src-ip 17.56.102.2
Once a shared channel on one of the QAM ports is created, it can then be shared
across one or more ports (up to seven additional) on the same module.
Figure 6-1 shows a sample mapping of the eight QAM 8x96 ports where port 0 shares
12 SDV0 channels with 1, port 2 shares SDV1 channels with port 3, and so on.
The following CLI session configures the shared channels on port 0 and shares them
with port 1 using the following steps:
where <group_id> is the qam group ID in the range 1–8, and <first_schannel> and
<last_ schannel> specify the block of multiport shared channels in the range 0–44.
5. Run the show docsis channel utilization command to display multi-port shared
channel statistics.
CASA(config)# module 0 narrowcast-channels 32
CASA(config)# show narrowcast-channels
module 0 narrowcast-channels 32
Figure 6-2. QAM 8x96 channel time line frequency blocks (Annex B, C; 128 ch.)
Dynamic system-assigned default frequencies
• In Annex A mode, at the 8-MHz channel width, the maximum number of channels
on a single block is 24. The maximum number of Annex A channels on each
physical port is 96 RF channels (4 blocks x 24 channels). See Figure 6-3.
Figure 6-3. QAM 8x96 channel time line frequency blocks (Annex A; 96 ch.)
Dynamic system-assigned default frequencies
Example
C10G-181(config-if-qam 0/0)# show interface qam 0/0 block
schan_id:
0 1 2 3 4 5 6 7 8 9 10 11
<<<<==== 12 multiport shared-channels added
255 255 255 255 255 255 255 255 255 255 255 255
255 255 255 255 255 255 255 255 255 255 255 255
255 255 255 255 255 255 255 255 255 255 255 255
255 255 255 255 255 255 255 255 255 255 255 255
255 255 255 255 255 255 255 255 255 255 255 255
255 255 255 255 255 255 255 255 255 255 255 255
255 255 255 255 255 255 255 255 255 255 255 255
shutdown channels:
DOCSIS channels are configured with the interface qam command by specifying the
CMTS slot where a QAM module is installed and a port number on that module.
Each port on the QAM supports up to 32 narrowcast channels. With Annex B (6 MHz
channel offset), each port is comprised of four 192-MHz blocks totaling 768 MHz.
Figure 6-4 shows the four 192-MHz blocks and the default starting frequencies over
the channel time line.
Example
CASA(config) interface qam 0/7
CASA(config-if-qam 0/7)# channel 0 frequency 405000000 32
CASA(config-if-qam 0/7)# end
no channel 4 shutdown
channel 5 frequency 435000000
no channel 5 shutdown
channel 6 frequency 441000000
no channel 6 shutdown
channel 7 frequency 447000000
no channel 7 shutdown
channel 8 frequency 453000000
no channel 8 shutdown
channel 9 frequency 459000000
no channel 9 shutdown
channel 10 frequency 465000000
no channel 10 shutdown
channel 11 frequency 471000000
no channel 11 shutdown
channel 12 frequency 477000000
no channel 12 shutdown
channel 13 frequency 483000000
no channel 13 shutdown
channel 14 frequency 489000000
no channel 14 shutdown
channel 15 frequency 495000000
no channel 15 shutdown
channel 16 frequency 501000000
no channel 16 shutdown
channel 17 frequency 507000000
no channel 17 shutdown
channel 18 frequency 513000000
no channel 18 shutdown
channel 19 frequency 519000000
no channel 19 shutdown
channel 20 frequency 525000000
no channel 20 shutdown
channel 21 frequency 531000000
no channel 21 shutdown
channel 22 frequency 537000000
no channel 22 shutdown
channel 23 frequency 543000000
no channel 23 shutdown
channel 24 frequency 549000000
no channel 24 shutdown
channel 25 frequency 555000000
no channel 25 shutdown
channel 26 frequency 561000000
no channel 26 shutdown
channel 27 frequency 567000000
no channel 27 shutdown
channel 28 frequency 573000000
no channel 28 shutdown
channel 29 frequency 579000000
no channel 29 shutdown
Blocks 0 and 3 have no channels assigned and are available if channels are to be
moved to higher or lower frequencies. Each block indicates the suggested starting
frequency, which is dynamically assigned by the CCAP.
The offset value in the display indicates the frequency width from the starting
(default) frequency for a given block. For example, an offset of 30 indicates the
starting frequency is 30 x 6 MHz, or 180 MHz from the system-assigned start. In the
CLI output, the channel 11 frequency is offset by 180 MHz (where
291000000+180000000=471000000).
Example
CASA(config)# show interface qam 0/7 block
interface qam 0/7 block 0
block frequency 99000000 block map 00000000
port status: up
shutdown channels:
CASA(config)#
In the following CLI session, channels 16–23 were interactively moved to new
frequencies in block 2. Similarly, channels 24–31 were also interactively moved to
new frequencies in block 3. Note that the channel command in each instance specifies
the total number of channels to move. In each case, eight channels have moved.
Use the show interface qam <slot>/<port> block command to verify the moved
channels.
Example
C10G(config-if-qam 0/7)# channel 16 frequency 609000000 8
C10G(config-if-qam 0/7)# channel 24 frequency 801000000 8
The QAM 8x8 module provides eight channels per port where the eight channels are
configured in two contiguous or non-contiguous banks of four channels in the 47–
999 MHZ frequency range. As in previous releases supporting four channels per port,
the software automatically adjusts the frequencies on channels 0–3 and on channels 4–
7 based on the configured Annex (A, B, or C) for frequency separation. This means
that if you specify the frequency for channel 1 (with Annex A separation at 8 MHz),
channels 0, 2 and 3 are correctly separated by 8 MHz based on the specified channel 1
frequency setting. The same applies to channels 4–7.
Example
In the following example, the two four-channel banks (0–3 and 4–7) are contiguous
across the frequency spectrum using Annex A separation at 8 MHz in the range 547–
603 MHz.
Example
In the following example, the channel command updates the channel 0 frequency to
470 MHz. Consequently, channels 0–3 were revised based on the 470 MHz frequency
and the Annex B 6 MHz separation.
Example
In the following example, the two four-channel banks are non-contiguous across the
frequency spectrum due to a frequency change at channel 7. The range 470–494 MHz
applies to channels 0–3, and 591 MHz to 609 MHz applies to channels 4–7. Each
four-channel bank still maintains Annex B 6-MHz frequency separation.
channel 3 shutdown
channel 4 frequency 591000000
channel 4 shutdown
channel 5 frequency 597000000
channel 5 shutdown
channel 6 frequency 603000000
channel 6 shutdown
channel 7 frequency 609000000
channel 7 shutdown
shutdown
The [no] shutdown command enables and disables the specified QAM port. The
default state for all QAM ports and channels is shutdown. This prevents interference
with existing cable-channel configurations. If the QAM port remains disabled,
enabling the individual channel has no effect until the QAM port is enabled.
The following CLI session displays the QAM downstream port parameters:
Example
CASA(config)# interface qam 2/0
CASA(config-if-qam 2/0)# ?
annex set annex type
channel channel
interface interface command
interleave channel interleave
modulation channel modulation
power power management
shared-channel video session on shared channel
shutdown shutdown the interface
spectral QAM spectrum
spectrum-tilt spectrum tilt
• annex — Sets the MPEG framing format for a QAM channel: Annex A @ 8-MHz
channel separation (in Europe), Annex B @ 6-MHz channel separation (in North
America), and Annex C @ 6-MHz channel separation (in Japan).
• channel — Sets the channel properties, as described elsewhere.
• interface — Sets another QAM interface.
• interleave — Sets the QAM interleave level to minimize the effect of burst noise
by spreading data over time. The valid values are 8, 16, 32, 64, 128x1, 128x2,
128x3, 128x4, 128x5, 128x6, 128x7, and 128x8. The default is 128x1 which is the
highest amount of interleaving; 8 is the lowest. When set, all channels on the port
are set to the same interleave level automatically.
• modulation — Sets the QAM modulation scheme. Valid values are 64qam,
128qam, 256qam, and off. The default is 256qam. QAM modulation is a port
property that applies to all channels on the port. When the modulation type is set
to off, no modulation signal is transmitted to the QAM port. The RF output of the
port is a continuous wave.
• power — Sets the QAM channel downstream power output level in one tenth of
dBmV. The range is 450–620. The default setting is 510.
This power setting is for the RF output port that is also the sum of all enabled QAM
channels on the same port. The actual QAM channel output level depends on how
many QAM channels are enabled on that port. For example, a setting of 550
(55 dBmV for the port) with one channel enabled sets the QAM channel level to
55 dBmv. A setting of 550 with two channels enabled sets each QAM channel to an
output level of 52 dBmV. A setting of 550 with four channels enabled sets each QAM
channel to an output level of 49 dBmV.
The maximum output level (sum total of all channels) per QAM 8x8 is:
The maximum output level (sum total of all channels) per QAM 8x96 is:
The maximum output level per QAM channel per the DOCSIS Downstream Radio
Frequency Interface (DRFI) specification is:
The CMTS configuration allows adjustment and override of QAM power output
levels based on real measurements. Because an actual power level can vary +/- 1 dB,
the power setting can be adjusted either higher or lower to compensate for the actual
reading. If the actual reading is 1 dB lower, then the QAM power setting in the CLI
can be increased by 1 dB.
Note: Both DOCSIS and Casa Systems specify the maximum QAM power
level for four channels at 580 (58 dBmV). However, the Casa CMTS allows
you to override the setting to 620. This setting can occasionally cause bit
errors or a slight increase in adjacent channel distortion. Some customers find
this an acceptable trade-off if they need to overcome a highly attenuated cable
plant. But unless such an overdrive is necessary, Casa recommends not
exceeding the 580 setting.
Setting the QAM power level higher than 580 is not recommended unless:
1. A measurement shows the actual CMTS output is slightly lower than what is
requested in CLI, or
2. A determination is made that the cable plant is highly attenuated, and the only
solution is to force the CMTS to overdrive its output level (as opposed to
removing attenuation in the cable plant).
X/Y.Z/C — Where X is the module slot number, Y is the port number, Z is the
physical channel number, and C is the logical channel number.
Depending on the specific CMTS model you are configuring, slot, port, and channel
numbers will vary. For example, the C10G and C100G CMTS valid slot numbers for a
QAM 8x8 module would be in the range 0–5 and 8–13, port numbers in the range 0–7,
and channel numbers in the range 0–7.
Example
The following CLI session shows the upstream channel format when the
show upstream command is executed on a C10G CMTS. The upstream interface in
system slot 11 specifies physical channel 0 at 11/0.0/0 and 11/0.0/1, and physical
channel 1 at 11/0.1/0 and 11/0.1/1.
• channel-width — Sets the total bandwidth of the specified channel in Hertz using
the actual units. Valid values are 200000, 400000, 800000, 1600000, 3200000,
and 6400000, where 6400000 is 6.4 MHz.
• description — Specifies the optional and arbitrary text string that provides
information about the upstream channel. Up to 64 alphanumeric characters can be
specified. If the string includes embedded blank spaces, then the text string must
be enclosed in quotation marks (“”).
• frequency — Sets the upstream channel frequency in the range 5–85 MHz per the
DOCSIS specification. In the United States, 5–42 MHz is used; other countries
use up to 65 MHz.
For example, map-advance dynamic 200 sets the look-ahead time to 200
microseconds more than the time calculated by the dynamic MAP advance
algorithm for the farthest CM on that port.
— Static MAP advance uses a fixed look-ahead time specified by the user. (For
reference, a mile of coax cable has a delay of about 7 microseconds; a mile of
fiber has a delay of about 8 microseconds.) The minimum value is 200
microseconds; the maximum is 4000 microseconds.
• partial-service — Sets the discrete Forward Error Correction (FEC) and
Signal-to-Noise Ratio (SNR) percentage thresholds to put the upstream channel in
partial service mode. See the Casa Systems – RF Cable Configuration Guide and
Command Reference for details on cable partial service.
• power-adjustment — Sets the input power threshold which determines whether
the CMTS sends power adjustments to the CM. If the CM transmits power is
within the threshold, the CMTS sends no adjustment. If it is beyond the threshold,
the CMTS sends a power adjustment. After 16 failed attempts, the CMTS stops
sending ranging and the CM remains offline. For normal operation, use the default
value of 1 dBmV. The command is helpful during troubleshooting when a CM
fails to complete ranging due to attenuation in the cable plant.
The CMTS can be set to continue to adjust the CM power output during ranging
response. If the power offset is within the power set by the
power-adjustment continue command, then the CM is properly ranged in
transmit power. If it is beyond this power, the CMTS continues to send power
adjust messages. The default setting is 2 dBmV.
• power-level — Sets CM output power levels to meet the desired upstream input
power level. The nominal input power level for the upstream RF carrier is in
decibels per millivolt (dBmV). The default setting of 0 dBmV is the optimal
setting for the upstream power-level. The power-level supported range is -16–
34 dBmV.
• rate-limit — Enforces the rate limit defined in the CM configuration file. The
default is enabled; use the no rate-limit command to disable rate limiting.
• shutdown — Shuts down or (in its no form) restarts the upstream port.
• spectrum-rule — Applies a previously configured spectrum rule to a service flow
over an upstream channel. With a spectrum rule assigned to an upstream interface,
the actions defined in the rule take place in the specified (or default) order of
priority if:
— Plant noise level exceeds SNR threshold defined explicitly in the commands
or by default.
— Percentage of correctable Forward Error Correction (FEC) errors of total
packets received on the upstream (during the polling period) exceeds the
defined or default threshold.
— Percentage of uncorrectable FEC errors of total packets received on the
upstream (during polling period) exceeds the defined or default threshold.
A rule can be assigned to any number of upstream interfaces. However, only one
rule assignment per upstream interface is allowed.
• voice-bw-reserve — Percentage of reserved bandwidth dedicated for voice calls
on upstream channels. When the configured percentage threshold is reached, no
new voice calls are accepted on that channel. Any unused portion of the
configured percentage is available for data sessions. However, new voice calls
assumes priority and preempts any data sessions. You can also reserve a portion of
the configured voice bandwidth percentage for emergency calls.
The CMTS supports dynamic channel width switching between logical upstream
channels (0 and 1) using the same center frequency. This feature allows legacy D1.x
CMs to transmit upstream at 3.2 MHz over one logical channel, while the second
logical channel is available for D2.0 (and later) CMs to transmit upstream at 6.4 MHz.
Note: Earlier Casa software releases support one logical channel only, where
the physical channel is present in the configuration as logical channel 0.
Time-division multiplexing provides the switching between the logical channels, with
CM upstream transmission taking place over one logical channel at a time.
Supported upstream channel widths per upstream logical channel are configurable at
0.2, 0.4, 0.8, 1.6, 3.2, and 6.4 MHz. Depending on the configured upstream channel
width, a logical channel provides an SNR increase for higher QAM modulation, a
reduction of integrated noise, and an increase in total bandwidth for improved
efficiency within the same spectrum. For example, dividing one 6.4-MHz logical
channel in half increases SNR by 3 dB.
Example
The following CLI session shows an upstream interface configuration with the logical
channels set at frequencies for CMs operating on this interface. Logical channel 0 is
set 6.4 MHz, and logical channel 1 is set at 3.2 MHz. The CMTS dynamically
performs Time Division Multiplexing (TDM) switching between the logical channels
when the CMTS sends upstream transmission grants to the CMs. Channel selection is
based on the requirements of the requesting CM.
no shutdown
In addition to the dynamic channel width switching between the logical channels, an
upstream power offset level setting (relative to the physical channel power) can be
configured independently on each logical channel in the range -10–10 dB.
Note: Earlier Casa software releases support one logical channel only, where
the physical channel is present in the configuration as logical channel 0. There
is no logical channel 1.
• channel-width — Sets the total bandwidth of the specified channel in hertz using
the actual units. Valid values are 200000, 400000, 800000, 1600000, 3200000,
and 6400000, where 6400000 is 6.4 MHz.
• class-id — Specifies the ranging hold-off upstream channel description (UCD)
TLV 19 bit field identifier in the range 0x0–0xFFFFFFFF. Specifying 0x0
disables the identifier.
• data-backoff, ranging-backoff — Specifies the DOCSIS-specified method of
contention resolution for CMs requesting to transmit on the upstream channel,
truncated as a binary exponential backoff value, with the initial backoff window
and the maximum backoff window controlled by the CMTS. The CMTS specifies
backoff window values for data transmission and initial ranging. It sends these
values downstream as part of the Bandwidth Allocation Map MAC message.
The values are configurable and are “power-of-two” values. For example, a value
of 4 indicates a window between 0 and 15; a value of 10 indicates a window
between 0 and 1023. You can set fixed start and end values for data backoff on the
upstream ports, or set the upstream ports for automatic data backoff. The user has
the same options for ranging backoff. For both backoff windows, the default start
value is 0; the default end value is 4. Valid values are 0–15.
• description — Specifies the optional and arbitrary text string that provides
information about the upstream channel. Up to 64 alphanumeric characters can be
specified. If the string includes embedded blank spaces, then the text string must
be surrounded by quotation marks (“”).
• frame — Sets the Synchronous-Code Division Multiple Access (SCDMA) frame
settings on the upstream channel. SCDMA in DOCSIS 3.0 improves the
maximum upstream bandwidth by allowing the same physical upstream channel
to receive multiple bursts simultaneously using a time and code data transmission
technique. Multiple CMs can send simultaneously using their own codes in the
same upstream time slot without interfering with each other. Data is sent using up
to 128 spreading codes. Parameters are: number of spreading intervals, codes per
minislot, and maximum number of active codes.
• minislot — Set the upstream minislot size on the channel in ticks (1, 2,4,8,16,32,
64, and 128). The minislot is a series or group of time components that make up
one upstream time interval. These intervals vary in size starting at time-zero (t0)
until the end of the interval where t0 begins again. Time-division multiplexing
(TDM) scheduling sets both long and short intervals in the time line where the
interval size is based on traffic conditions. Each minislot within each interval is
6.25 microseconds.
• power-offset — Specifies an upstream power offset level setting relative to the
physical channel power independently on each logical channel in the range -10–
10 dB. The default setting is 0, no power offset.
• pre-equalization — When enabled, this parameter compensates for the difference
in delays between the signal on the lower part of the 6-MHz channel spectrum and
the higher part caused by imperfections in the cable plant. The default state is
disabled, but Casa recommends that it be enabled.
• profile — Modulation profile identifier to be used on this logical channel. A
modulation profile is a collection of burst profiles that are sent to CMs in
Note: When specifying a secondary profile, both the primary and secondary
profiles must match the upstream channel type. Casa Spectrum Management
(CSM) will not change to a mismatched profile. The secondary profile also
must be less bandwidth-efficient than the primary profile.
When plant signal quality deterioration causes threshold hits, CSM changes to
the secondary modulation profile. The show running-config command shows
the transmit configuration using the secondary-profile. When signal quality
satisfies the primary profile’s SNR plus 3 dB (or to the default SNR threshold if
the threshold is not defined in the rule), CSM changes the modulation profile
back to the primary.
Example
CASA(config-if-ups 13/0.0)# logical-channel 0 profile 3
secondary-profile 12,20,33
Where:
1. Modulation profile 12, 20 and 33 have compatible channel types.
2. The order of 12, 20, and 33 specifies the priority which CSM tries to use the
profiles.
3. Lower priority suggests a less bandwidth efficient modulation profile.
• prov-attr-mask — Set the provisioning attribute mask on this logical channel.
When the CMTS receives a service flow request from a CM, the CMTS compares
a TLV integer received in the service flow request with the attribute masks of all
of the available channels it manages. The CMTS assigns a requesting CM to the
channel specified by the attribute mask that represents the attributes presented in
the TLV included in the service flow request. The mask can be user-defined in the
range 0x0–0xFFFFFFFF (default 0x0), or can be set for bonding,
high-availability, or the low latency provisioning attribute masks, or all of the
above. To disable the mask, specify the default setting of 0x0.
• ranging-priority — Specifies the ranging hold-off priority bit TLV in the value
range 0x0–0xFFFFFFFF. The hold-off priority is the maximum time that a CM
can prevent transmissions on an upstream channel in response to its ranging class
ID matching a bit value in the ranging hold-off priority field in the CM
configuration file. The default timer value of 300 seconds (five minutes) per
DOCSIS 3.0 MAC and Upper Layer Protocols Interface Specification cannot be
changed. To disable the hold-off priority bit TLV, specify the default setting of
0x0.
• shutdown — Shuts down or (in its no form) restarts the logical channel.
• spectrum-rule — Applies a previously configured spectrum rule to a service flow
over an upstream logical channel, much like for a physical channel, as described
earlier.
The following CLI session binds a set of upstream and downstream channels to the
DOCSIS-MAC domain 30. Upstream channels are configured on CMTS slot 13,
ports 0 to 7, channel 0; downstream channels are configured on CMTS slot 11, port 0,
channels 0 to 7.
After binding channels to the MAC domain, you need to create one or more service
groups, which constitute a subset of the channels supported in the MAC domain. See
the section “Configuring service groups” for information.
service groups is known as the cable modem service group (CM-SG), or DOCSIS
fiber node that supports a given service area. In most cases, one or more configured
service groups contain a subset of the same channels declared in a specific DOCSIS
MAC domain.
Note: Service groups are required for cable traffic load balancing and for
channel bonding over D3.0 CMs. Service groups are NOT required for CMs to
register and come only as long as upstream and downstream channels are
configured in the DOCSIS-MAC domain. See “Binding channels to the MAC
domain.” See also the Casa Systems – RF Cable Configuration Guide and
Command Reference for information about the RF over Glass (RFoG)
upstream scheduler feature, where the CMTS limits the number of
simultaneous upstream transmitters coupled to the same optical fiber splitter
to a single transmitter. RFoG is enabled for a service group using the
upstream rfog-scheduler property.
Service groups are created at the top level configuration mode at the CMTS.
The following CLI session creates the service group Andover and adds (or binds)
previously configured upstream and downstream channels to it. In the example,
upstream channels on CMTS module 13 and downstream channels in slot 11 are
configured for Andover. An optional description is also configured. The
show service group command displays the service group configuration.
qam 11/0/0
qam 11/0/1
qam 11/0/3
qam 11/0/4
qam 11/0/5
qam 11/0/6
qam 11/0/7
upstream 13/4.0
upstream 13/5.0
upstream 13/6.0
upstream 13/7.0
In networks where traffic from a particular CM or service area must use a specific
downstream or upstream channel, upstream and downstream bonding groups can be
configured using the bonding-group configuration object to direct traffic streams to
specific channels configured at the CMTS. This means that the CMTS uses a
configured bonding group and only the specific channels defined in the group. The
CMTS does not make the channel selection dynamically from a group of available
channels at the MAC domain.
Casa highly recommends the dynamic service group configuration over the static
bonding-group configuration. The static bonding-group should only be used in very
specific cases where dynamic channel selection is not feasible.
Channel bonding requires the CMTS service group and docsis-mac configurations,
as covered in the previous sections.
This section describes how to configure the CMTS for maximum downstream and
upstream throughput over D3.0 CMs capable of channel bonding. The examples and
recommended settings are based on Casa test cases where maximum throughput was
attained. However, Casa recommends using the recommended settings as a starting
point, as additional tuning may be necessary for your particular network.
The show cable modem bonding command displays the CM MAC address, interface,
and channel set information for each CM transmitting over bonded channels. (You can
also use the show cable modem non-bonding command to show the non-bonded
channels.) The show upstream channel set displays the set of upstream channels
assigned to a CM for D3.0 channel bonding. Likewise, the show downstream
channel set displays the set of downstream channels assigned to a CM for D3.0
channel bonding.
The follow CLI session displays two CMs that are transmitting over D3.0 bonded
channels using the Casa-assigned channel set identifier 256 using the channels
configured in the service group.
Microsoft Windows-based tools such as TCP Optimizer can be used to optimize the
TCP window size on CPE devices by choosing the “optimal settings” option.
Increase the size of the interface queue using the following command:
The CMTS should have the following configuration to get maximum throughput on
channel bonding and non-bonding CMs.
The downstream QAM interface channel modulation type should be set to 256qam
and the channel interleave should be 8. Use the following commands to set these
parameters:
Note: For Annex A, the QAM interleave is set at 12 and cannot be changed.
On the upstream interfaces, set the channel-width to 6.4 MHz and the channel
map-advance to static with a maximum delay of 200 milliseconds:
Making the number of FEC error correction bytes smaller in the modulation profile to
reduce overhead helps increase throughput. This new modulation profile is the same
as the predefined modulation profile 3 with the exception of the reduced number of
FEC error correction bytes. It can be configured as follows:
Execute the show modulation-profile <id> command to display the details of a given
modulation profile:
The upstream channel modulation profiles should then be modified as follows to use
the new modulation profile:
Topic Page
Topic Page
The CMTS performs load balancing in one of two ways, or a combination of the two:
static load balancing or dynamic load balancing.
Static load balancing takes place when a CM sends its initial ranging request message
to the CMTS. For DOCSIS 1.0 1.1 and 2.0 CMs, the CMTS responds with a ranging
response (RNG-RSP) message that includes either a Downstream Frequency Override
or an Upstream Channel ID Override field that instructs the CM which channels it
should use. For DOCSIS 3.0 CMs, when a CM sends its registration request
(REG-REQ) messages, the CMTS responds with a registration response (REG-RSP)
message to instruct the CM to select the channels.
Dynamic load balancing moves CMs among upstream and downstream channels
within the same service group after their initial difference between two interfaces
exceeds a defined percentage. The CMTS uses downstream and upstream dynamic
Note: For DOCSIS and EuroDOCSIS 3.0 CMs, the dynamic load balancing
software generates a downstream channel set with a minimum load to fit the
CM‘s receive channel profile (RCP). This prevents rejection of the new
channel set so that load balancing is not canceled when the assigned CM is
under load.
The CMTS does not move CMs to disconnected (idle) downstream channels where
there are no registered online CMs.
The follow restrictions and limitations apply to traffic load balancing between the
CMTS and registered online CMs:
• Load balancing can only be performed over upstream and downstream interfaces
sharing the same physical connectivity. This means that load balancing can only
be done over upstream and downstream interfaces belonging to the same service
group.
• Load balancing is not restricted to upstream and downstream channels belonging
to the same DOCSIS MAC domain interface. Load balancing crossing different
MAC domains is supported.
• Upstream and downstream interfaces with mixed single upstream/downstream
channel CMs and bonded upstream/downstream channel CMs can be load
balanced. CMs with multiple upstream/downstream channels count as one CM on
each of its upstream or downstream channels.
• Load balancing does not support a load balance group with mixed-annex
downstream channels. Downstream channels must be included in two different
service groups, each having its own annex.
Before configuring the load balancing parameters, ensure that you have edited the
CMTS configuration file to include the following:
By default, the upstream channel has precedence in load balancing across MAC
domains, where the lowest loaded (least busy) upstream channel is selected within the
service group. Then, the lowest loaded downstream channel is selected within the
The CMTS uses downstream frequency override and the upstream channel ID
override in the ranging response message to move a CM to a different MAC domain if
needed. This applies to all DOCSIS 1.0, 1.1, 2.0 and 3.0 CMs. The SID in the ranging
response message is 0x3fff.
connectivity, the upstream and downstream interfaces have to belong to the same
service group.
Both channel bonding and non-channel bonding CMs can participate in load
balancing. Channel bonding CMs count as one CM for each of its channels.
• General load balancing group — The CMTS creates a general load balancing
group for every MAC domain CM service group (MD-CM-SG).
• Restricted load balancing group — The CMTS selects specific upstream and
downstream channels within the MD-CM-SG for a restricted load balancing
group.
The CMTS automatically creates one general load balancing group for each MD-SG
after the service group and MAC domain interface configuration.
In the following example, the CMTS generate a general load balance group with
service group FN_A and MAC domain 1. It contains downstream channels qam 0/0/0,
qam 0/0/1, qam 0/0/2, qam 0/0/3 and upstream channels upstream 4/0.1, upstream 4/
1.1, upstream 4/2.1, and upstream 4/3.1. When a general load balance group is
created, it uses load balancing parameters from predefined general load balance group
default settings.
To enter the general load balance group default, use the following command in config
mode:
The following commands are available under the general load balancing group
default-settings:
• enable
• initial-tech
• policy-id
To enable or disable the load balancing function on general load balancing groups:
To specify the initial technique that the CMTS uses to load balance and move CMs:
Polices describe the rules to execute when load balancing traffic across CMTS
interfaces. To specify a previously configured policy to apply during load balancing:
Refer to the section, “Configuring policies and rules” for further information.
To enter the general load balance group for a previously configured MAC domain and
service-group, use the following command in config mode:
A restricted load balance group is similar to the general load balance group.
Restricted load balancing groups require that you specify unique upstream and
downstream channel set information that is not specified in the general group.
To enter the load balance restricted-group context in the CLI, use the following
command in config mode:
Specify the group-id parameter in the number range 1–4294967296. This number
uniquely identifies the restricted load balancing group among other groups that you
create. The group ID must be unique within the CMTS.
• docsis-mac
• enable
• initial-tech
• policy-id
• qam
• service-type-id
• upstream
To enable or disable the load balancing function on restricted load balancing groups:
To specify the initial technique that the CMTS uses to load balance and move CMs:
Polices describe the rules to execute when load balancing traffic across CMTS
interfaces. To specify a previously configured policy to apply during load balancing:
The service-type-id parameter specifies the unique string that selectively controls
load balancing to CMs belonging to particular service type in this restricted-group,
such as CM device type, DOCSIS version, and service class. Only CMs that send a
matching service-type-id string to the CMTS during registration are load balancing
and moved to another channel.
Note: Make sure that you appropriately bind each upstream slot/port.channel/
logical channel under the interface docsis-mac configuration.
Note that the logical channel is optional. If omitted, the channel defaults to 0.
CASA(load-bal-restrict 1)# upstream <slot/port/log_chan>
CASA(load-bal-restrict 1)# upstream 4/2/1
The qam parameter allows you to add downstream channels to the restricted-group in
the current MAC domain, as configured with the docsis-mac parameter. Only the
specified downstream channels in the restricted-group are load balanced.
Note: Make sure that you appropriately bind each upstream slot/port/channel
under the interface docsis-mac configuration.
Add CMs to the restricted load balancing group for known CMs that participate in
CMTS upstream and downstream load balancing. CMs are specified by CM MAC
address and an optional network mask. Specify one CM MAC address per
restricted-cm identifier, then specify the referenced restricted-load-balance-group ID
to which this CM is be associated for load balancing.
To enter the load balance restricted-cm context in the CLI, use the following
command in config mode:
Specify the number parameter in the number range 1–4294967296. The number
uniquely identifies the configuration of this CM among other unique CMs.
• mac
• restricted-load-balance-group
• service-type-id
Specify the MAC address of the known CM that belongs to a restricted load balancing
group. Use the show cable modem command to display active CMs and their MAC
addresses. The default mask, if not specified, is ffff.ffff.ffff.
The service-type-id parameter specifies the unique string that selectively controls
load balancing to CMs belonging to particular service type in this restricted group,
such as CM device type, DOCSIS version, and service class.
Use this parameter the same way as specified in the restricted load-balance group
where only CMs that send a matching service-type-id string to the CMTS during
registration are load balanced and moved to another channel. Specifying the
service-type-id for known CMs (by MAC address) allows you to add the service type
to CMs that have already registered with the CMTS (with no service-type-id string)
and are to be made available for load balancing to other channels (using a referenced
load-balance restricted-group, covered in the next section).
Use the show cable modem command to display the active CMs and their MAC
addresses.
• Basic rules — Control the period during the day when the load balancing
operates. The CMTS supports multiple basic rules per policy.
• Execution rules — Control the thresholds for moving CMs to other channels.
The CMTS supports one execution rule per policy at any one time.
To create a load balancing policy, enter the following command and specify a number
in the range 1–4294967295.
This section describes the CMTS decision processing and conditions when load
balancing CMs to other channels using configured policies.
1. If a load balancing group policy is disabled, the CMTS does not perform load
balancing for that group.
2. If a load balancing group policy is enabled, the CMTS checks for channels having
both the highest and the lowest bandwidth utilization.
3. The CMTS then looks for a CM on the channel with the high utilization (most
busy) and then checks the policy for that CM.
4. If the CM configuration file uses TLV43.1, the policy for CM is specified by that
TLV. If the CM does not use TLV 43.1, it uses the load balancing group policy to
which this CM is assigned, if enabled.
5. The CMTS then checks the policy in the CM configuration file to see if the CM
can be load balanced. If the policy is enabled, the CMTS moves that CM to the
most idle channel (lowest utilization). If the policy disabled, the CMTS skips that
CM.
You can create as many basic rules as needed to load balance CMs during high traffic
periods. You then apply these rules to the load-balance policy.
To create a basic rule, enter the following command and specify a number in the range
1–4294967295.
There are two configuration options associated with a basic load balance rule:
• enable
• suspend-load-balance
To enable the basic rule for use in a load-balance policy, specify the following
command:
To specify a period during the day to suspend load balancing over CMTS interfaces,
enter the following command and specify the start and end time (in HH:MM:SS
format) when load balancing does not take place. In the example, load balancing is
suspended from 4:00 a.m. to 5:00 a.m.
To apply a basic rule to a named policy, enter the following command and specify a
number in the range 1–4294967295. The policy can have multiple basic rules.
You can create one execution rule to load balance CMs during high traffic periods.
You then apply this rule to the load-balance policy.
To create an execution rule, enter the following command and specify a number in the
range 1–16.
• enable
• interval
• method {modem | utilization}
• permit multicast-session modem move
• suspicious-channel retry interval
• threshold load
• upstream-interval
• upstream-method {modem | utilization}
• upstream-threshold load
To enable the execution rule for use in a load-balance policy, specify the following
command:
The commands covered in this section allow to define the techniques that the CMTS
uses when making load balance decisions, either by the number of CMs on a channel,
or by a configured percentage of current channel utilization.
The threshold load parameter specifies the actual number of CMs, or the utilization
percentage in the range 0–100. Load value specifies the maximum load difference that
can exist between interfaces in a group before the CMTS performs static load
balancing. Setting the load value to 0 disables static load balancing.
The method command applies to both dynamic and static load balancing, as well as to
both upstream channels and downstream channels if not otherwise specified. Dynamic
load balancing takes place when the load difference between interfaces exceeds a
minimum value.
To specify the threshold for dynamic load balancing, enter the threshold load
command to specify the actual number of CMs, or the utilization percentage in the
range 0–100.
The interval parameter specifies the minimum elapsed time (in seconds) before CMs
can be moved to the load balancing interfaces. Only one CM can be moved after each
elapsed time interval.
To specify the dynamic load balance interval, specify a number in the range 10–3600
seconds.
The following example sets the dynamic load balancing interval to one CM every 60
seconds.
To selectively control or customize load balancing on the upstream channels, use the
following execution rule parameters:
• upstream-method
• upstream-threshold load
• upstream-interval
The upstream-threshold load parameter specifies the actual number of CMs, or the
utilization percentage in the range 0–100. Load value specifies the maximum load
difference that can exist between interfaces in a group before the CMTS performs
static load balancing. Setting the load value to 0 disables static load balancing.
The upstream-interval command allows a custom interval value for upstream load
balancing by specifying the minimum elapsed time (in seconds) before CMs can be
moved to the load balancing interfaces. Only one CM can be moved during each time
interval. When the upstream-interval is configured, the interval setting applies to
downstream load balancing only.
The following example sets the dynamic load balancing upstream-interval to one CM
every 60 seconds.
To apply an execution rule to a named policy, enter the following command and
specify a number in range 1–4294967295.
The load balance policy can have ONLY ONE execution rule.
Under the execution-rule configuration, you can specify whether to load balance
CMTS traffic over channels that currently have no registered CMs. These channels
over which there are no registered CMs are known as suspicious channels. A
suspicious channel might result from a line card redundancy failover, a line card reset,
a redundancy revert, or other reason that creates a condition where a load balancing
interface is available and currently unused. The suspicious-channel command allows
to specify whether to attempt load balancing on empty channels at configured time
intervals.
To specify if the CMTS should retry load balancing to channels where there are no
registered CMs, enter the retry interval in the range 0–86400 seconds. The default
setting is 3600 seconds. Enter 0 to disable load balancing to suspicious channels.
particular customer CMs. For example, there can be cases where an older DOCSIS 1.0
or 2.0 CM from a specific vendor might not be a good candidate for load balancing.
You might also want to exclude CMs that process particular types of traffic where
moving those CMs to other channels might introduce unpredictable results.
CMs in the exclusion list are specified by MAC address, as displayed with the
show cable modem command.
A CM with a MAC address matching the MAC address/mask criteria specified in the
exclusion list are excluded from load balancing. By default, these CMs are disabled
from dynamic load balancing using he following rules:
• If the static parameter is specified, the CMs are disabled from static load
balancing only.
• If the dynamic parameter is specified, the CMs are disabled from dynamic load
balancing only.
• If the both parameter is specified, the listed CMs are disabled from both static and
dynamic load balancing.
CASA(load-bal-exclusion-list)# mac addr xxxx.xxxx.xxxx mask
xxxx.xxxx.xxxx [both | dynamic | static]
CASA(load-bal-exclusion-list)# mac addr 0001.56ff.fefe mask
0000.0000.0000 both
Casa recommends that you use the show load balance static and
show load balance dynamic commands at times when CMTS traffic loads tend to be
higher. The displayed information from the show load balance command allows you
to further tune the load balancing configuration for better channel utilization so that
moving CMs to other channels in the service group occurs less frequently.
Note: The show load balance static command displays log information for
D1.X and D2.0 CMs only. Log information for D3.0 CMs are not included in the
output of this command.
4. Specify the initial technique that the CMTS uses to load balance and move CMs
without performing any type of ranging.
CASA(load-bal-general-default)# initial-tech direct
(Note that the command output is shown in “list” format and not in the format
displayed by the CLI on a computer screen.)
The output shows the MAC address of the CM and the new upstream and
downstream channels to which the CM was moved. The type field shows one of
the following states:
• BAL — Balancing done by the system.
• MLT — DCC by limit replication multicast.
• CLI — Load balancing done manually from the CLI.
• MIB — Load balancing done manually from SNMP.
• CSM — DCC done by CSM per CM.
• DSA — DCC done by voice.
• RSLB — DCC moved a CM into a restricted load-balance group.
• RGLB — General load balancing done until registration.
There might be special cases where you need to restrict load balancing to upstream
and downstream channels over certain docsis-mac interfaces (using the
restricted-group configuration) and or to even exclude some CMs from load
balancing operations all together (using an exclusion list).
For older DOCSIS 1.0 CMs where load balancing is not supported, run the CMTS
show cable modem command to display the D1.0 CMs, and them add them to the
load balance exclusion list.
1. Execute the show cable modem verbose command. Note the MAC Version field.
CASA# show cable modem verbose
MAC Address :0013.f79e.0d6a
IP Address :10.213.1.246
CM-ID :5
Prim Sid :10
MAC Domain :3
Upstream :4/0.0/0
Downstream :0/1/0
…
MAC Version :DOC1.0 <-------------------
3. Add the CM MAC addresses to the exclusion list. Specify both to prevent the
CMs from attempting static and dynamic load balancing.
CASA(load-bal-exclusion-list)# mac addr 0013.f79e.0d6a mask
0000.0000.0000 both
Users who are managing and monitoring the CMTS from an SNMP management
station should refer to the Casa Systems – SNMP MIBs and Traps Reference.
Topic Page
Uptime: 1 d, 14 h, 38 m, 37 s
Note: Enabling all system monitor options can result in excessively large
system log files. Casa Systems suggests that you disable any monitors that
are showing normal activity where only periodic monitoring is sufficient.
In most cases, you only need to enable one of the above options, while other options
allow you to set operating thresholds that would trigger messages to be logged. This is
one way to keep insignificant messages out of the system log, while capturing only
those messages that are more critical based on set thresholds.
For C10G and C100G platforms, use the CLI the show envm command to selectively
display fan, power, and temperature status. If a specific argument is not specified, the
CMTS displays the current status for all arguments.
Note that the C10G uses three fan modules: LEFT, CENTER and RIGHT. Each
module has two fans that are designated as either front or back, as follows:
The system temperature thresholds are summarized in Table 8-1. Any temperatures
below these thresholds are marked as Normal. The system shuts down or reboots
immediately with temperatures exceeding the shutdown/reboot board threshold.
The following messages indicate that the fan module is reporting below normal or has
no operating RPMs. The messages are usually followed by others reporting high
system temperatures (using an exceeded temperature threshold) and possible SNMP
trap messages. An immediate system inspection is necessary.
Fan tray <num> back fan low RPM detected (2200 RPM). Check fan intake
and exhaust for blockage. Replace fan tray if defective.
Fan tray <num> front fan low RPM detected (0 RPM). Check fan intake and
exhaust for blockage. Replace fan tray if defective.
The last message indicates that the specified fan tray is not being detected as present
in the chassis (installed but nonoperational) or is physically missing from the chassis.
Inspect the chassis for a possible missing fan tray. If the reported fan is present and
nonoperational, check the fan tray to ensure that is properly seated in its module slot.
Contact Casa Technical Support for a replacement if necessary. Continue monitory
system temperatures for any over-temperature conditions that could possibly lead to
other failures.
Example
The following CLI session enables monitoring of configured CMTS GigE interfaces:
Use the show interface gige and show interface xgige commands to display traffic
statistics and throughput over the CMTS gigabit Ethernet interfaces. Confirm the
interface and link status and look for error statistics and discarded packets.
IpForwDatagrams 0
IpInReceives 0
IpInDiscards 0
v6IfInReceives 0
v6IfInDiscards 0
:
interface status Administratively DOWN
link status DOWN
auto-negotiation Disabled
interface speed 10000000000
duplex status Full
mac address 0017.1005.39cb
Statistics:
IfInOctets 0
IfInUcastPkts 0
IfInNUcastPkts 0
IfInDiscards 0
IfInErrors 0
IfInUnknownProtos 0
IfOutOctets 0
IfOutUcastPkts 0
IfOutNUcastPkts 0
IfOutErrors 0
IfOutDiscards 0
IpForwDatagrams 0
IpInReceives 0
IpInDiscards 0
v6IfInReceives 0
v6IfInDiscards 0
v6IfInErrors 0
v6IfOutForwDatagrams 0
v6IfOutDiscards 0
Last clearing of interface stat: never
With redundancy-protected C10G and C100G systems with standby line cards, any
line card that goes down fails over to the redundant standby card in slot 5 or 8. Once a
failed card resets and comes back up, the card is placed in standby state until
interactively reverted using the ha revert command or by default during
system reboot. Release 6.5.2 allows both redundant cards to be active when backing
up a primary card on the same side of the redundant card.
information. Add an output modifier by typing the vertical bar (|) character followed
by a specified operator and filter.
Note: In most cases, slots 5 and 8 have one upstream and one downstream
line card available. After a switchover that places the redundant standby card
in the active state, redundancy is no longer available for any additional line
cards in the system, either upstream or downstream. Only one redundancy
failover is permitted at any one time.
To properly assess a module failover, use the show ha log and show log commands to
verify that the system continues to run normally using the redundant module. Use the
show ha log command to display high-availability event history, including the time of
the failover, type of failure, and the affected system slots. Executing the clear ha log
erases the current high-availability logged entries.
If the original module is in the standby state, it is recommended that you schedule a
maintenance window to revert back to original configuration so that continued
redundancy operations are available. However, the ha module revert command can
be used once the original line card is in the standby state and to re-enable system-wide
line card redundancy immediately.
The Casa Systems – CMTS Troubleshooting and Diagnostics Guide guide provide
complete information on all of the show cable modem commands with descriptions
of all fields and statistics.
As part of routine CMTS maintenance, the following show cable modem commands
provide network and connection statistics that can indicate a configuration issue with
a CM, a problem at network side interface, or other issue that might require further
investigation:
For preventive measures, use the cable flap-list command to detect abnormal CMs in
the network. The command lists malfunctioning CMs and might provide information
in helping identify problems.
Caution: DO NOT operate the system for more than a minute without the
air filter installed. The filter is necessary to maintain proper airflow, and
without the air filter present in the chassis, cards will overheat. Casa
Systems recommends that you have a spare filter available for use while
the removed filter is being cleaned.
All installation sites should schedule full air filter replacement annually.
STATUS STATUS
ACTIVE ACTIVE
ALARM ALARM
1. Using two hands, grab the push/pull tabs and slide the air filter out of the chassis.
The filters fits snugly, so use caution as you withdraw the filter from the filter slot.
2. Inspect and clean the filter using a vacuum cleaner or similar device. If the filter
appears damaged upon inspection, install a replacement if available.
If a replacement filter is not available, reinstall the existing filter after cleaning
and order a replacement from Casa Systems for installation later.
2. Using the push/pull tabs, slide the filter into the chassis until it stops. The front
edge of the filter is aligned with the chassis sheet metal. You feel the filter snap
into place.
If connections at the CMTS require removal and reattachment, refer to the Casa
hardware installation guide covering the specific CMTS platform for all electrical and
safety guidelines, warnings, and cautions.
Index
B
history 2-15
binding channels to the MAC domain 6-40
no form of commands 2-19
BPI and BPI+, enforcing 3-13 operations 2-8
parameters 2-9
C privileged mode 2-4
show commands 2-11
cable modem structure 2-6
initial ranging and registration 1-5 configuration conflicts, avoiding 4-3
initialization and learning 1-4
provisioning and configuration 1-6 configuration file learning, enabling 3-16
service group (CM-SG) 1-12 CPE VRFs in an IP bundle, enforcing 3-11
channel bonding 1-11
channel sharing in QAM modules 6-8
D
CMTS administrators and operators 3-2 D3.0 channel bonding 6-43
CMTS configuration DHCP authorization, enabling 3-12
displaying 4-6
DHCP leasequery 5-3
file 4-1
restoring 4-6 DHCP servers 5-1
CMTS hardware, maintaining 8-19 DNS servers 5-8
CMTS installation 1-1 DOCSIS 3.0 (D3.0) 1-3
CMTS management port 3-2 DOCSIS 3.1 (D3.1) 1-4
CMTS monitoring 8-1 DOCSIS MAC domain 1-3
CMTS preconfiguration, ensuring 6-2 downstream port parameters 6-29
command execution privileges 3-5 dynamic bonding change (DBC) 1-13
command line interface (CLI) 2-1 dynamic channel change (DCC) 1-13
accessing 2-2 Dynamic Host Configuration Protocol (DHCP) 5-1
auto-completion 2-15
changing prompt 2-18 E
command aliases 2-18
configuration mode 2-4 enabling and disabling QAM ports and channels 6-28
date/time intervals 2-16
encryption algorithm 3-14
error messages 2-17
exiting and logging off 2-4 event reporting flags for DOCSIS events 5-11
help text 2-11 exclusion lists 1-15
hierarchy 2-7 extra narrowcast channel mode 6-9
F P
files from FTP and TFTP servers, copying 4-5 password
flexible licensing 6-5 default 3-3
encrypted 3-4
G
Q
general load balancing group (GLBG) 1-12
QAM 8x192 6-7
I QAM 8x8 6-6
QAM 8x96 6-7
IP bundle interfaces 6-3 QAM channel frequencies 6-7
QAM downstream channels 6-6, 6-20
L
QAM output power levels 6-30
load balancing 1-12
CM traffic 7-1 R
dynamic 1-14
policy 1-14 radio frequency interface (RFI) 1-2
static 1-14 RADIUS server authentication 3-8
local and remote logging 5-8 restricted load balancing group (RLBG) 1-12
log files from fdsk2, copying 5-13 RF cable security settings 3-10
logging DOCSIS event messages to SYSLOG 5-10 running configuration, copying 4-4
running-config 2-5
M
S
MAC domains 6-4
moving selected QAM channels to other security association descriptor TLV length 3-14
frequencies 6-24
service group (SG) 1-11
MPTS pass-through broadcast video 6-14
service groups 6-41
multiple upstream logical channels 6-35
shared secrets to protect the CM configuration
multi-port shared channel mode 6-10 file 3-14
show commands 2-11
N filtering output 2-13
Source Address Verification (SAV) rules 3-16
network side interface (NSI) 1-2
SSH clients 2-3
network topology 1-1
SSH sessions, enabling 3-6
startup-config 2-5
startup-config file to NVRAM, copying 4-4
T
TACACS+ server authentication 3-7
TACACS+/RADIUS loopback interface 3-9
Telnet port, setting 3-6
terminology 1-15
TFTP options 3-11
TFTP proxy, enabling 5-6
Time-of-day (ToD) server 5-7
U
upstream channel descriptors and MAPs 1-8
upstream channels 6-31
upstream service group (US-SG) 1-12
upstream timeline 1-9
user management and security control 3-4
CMTS
Operations and Administration Guide
© 2017 Casa Systems, Inc.
All rights reserved.
DOC-3010-01