Beruflich Dokumente
Kultur Dokumente
DOC-3022-01
Document Revision 01.00.05
April 2015
2015 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
reg-rsp-original-upstream-action ...............................................................3-91 .
cm-ctrl ........................................................................................................4-23
.
load-balance ..............................................................................................10-4 .
modulation-profile ......................................................................................11-2 .
a-long ...................................................................................................11-7.
a-short .................................................................................................11-9 .
initial ..................................................................................................11-10
.
long ....................................................................................................11-11.
request ...............................................................................................11-12 .
short ...................................................................................................11-13.
station ................................................................................................11-14 .
ugs .....................................................................................................11-15.
channel-utilization-interval .........................................................................18-6 .
spectrum ....................................................................................................18-9 .
adduser ......................................................................................................21-4.
video ........................................................................................................21-12
.
Preface
Cable network administrators and operators who are integrating and configuring the
CMTS RF cable interfaces in the cable headend with their existing network
infrastructure should have experience with the following:
Internet Layer 2 and Layer 3 networking technologies and transports
Frequency management on upstream and downstream interfaces.
Note: The additional Casa Systems CMTS NSI Configuration Guide and
Command Reference covers the IETF routing protocols that are supported on
CMTS network side interfaces.
Revision history
This guide supports Casa CMTS software releases up to Release 6.5. See the Casa
Systems CMTS Release Notes for information on new or late features not yet
covered in this guide.
1.00.00 August 2014; initial review draft
1.00.01 September 2014; added QAM8x96 interface chapter
1.00.02 September 2014; initial release
1.00.03 October 2014; updated released version with latest functionality
1.00.04 January 2015; updated 6.4.3 released version with latest functionality
1.00.05 April 2015; updated to Release 6.5.2
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 C2200 CMTS Quick Installation
Casa Systems C2200 CMTS Hardware Installation Guide
Casa Systems C3200 CMTS Quick Installation
Casa Systems C3200 CMTS Hardware Installation 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)
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)
FIB Forwarding Information Base
CAS Conditional Access System (SimulCrypt)
CCAP Converged Cable Access Platform
CE Customer Edge
CIDR Classless Inter-Domain Routing
CM Cable Modem
CMTS Cable Modem Termination System
CNR Carrier-to-noise ratio
COPS Common Open Policy Service
CPD Control Point Discovery (PacketCable)
CPE Customer Premises Equipment
CSM Casa Spectrum Management
CSMA Carrier Sense Multiple Access
DAD Duplicate Address Detection (interfaces)
DBC Dynamic Bonding Change
DBG Downstream Bonding Group
DCC Dynamic Channel Change
IP Internet Protocol
IPC Inter-process communication (error)
IPDR IP Detail Record
IPsec Internet Protocol Security
IPTV Internet Protocol Television (policies)
IS-IS Intermediate System-to-Intermediate System routing protocol
KEK Key Encryption Key (BPI)
L2VPN Layer 2 Virtual Private Network
LACP Link Aggregation Control Protocol
LDP Label Distribution Protocol
LSA Link State Advertisement
LSP Link-State Packet (IS-IS)
LSR Label-Switched Router (LDP)
MAC Media Access Code
MD5 Message Digest 5 algorithm
MDD MAC Domain Descriptor (DOCSIS MAC)
MED Multi-Exit Discriminator (BGP)
MGMD Multicast Group Membership Discovery (DOCSIS MAC)
MGPI Multiple Grants Per Interval (PacketCable)
MIB Management Information Base
MIC Message Integrity Check (DOCSIS MAC)
MLD Multicast Listener Discovery (interfaces)
MMS Maximum message size (SNMP)
MPLS Multi-Protocol Label Switching
MPTS Multiple Program Transport Stream
MTA Multimedia Terminal Adapter (interfaces)
MTDMA Modified Time Division Multiple Access
MTU Minimum transfer unit (interfaces)
NET Network Entity Title (IS-IS)
NGOD Next Generation on Demand (video)
NLS Network Layer Signaling (PacketCable)
NSAP Network Service Access Point (IS-IS)
Topic Page
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 as the Casa C10G 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 receipt 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. 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 HTTP requests to the Internet from a customer PC, for example, is
transmitted by the cable modem 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 customers cable modem for
transmission and presentation at the PC.
Note: All DOCSIS versions are backward compatible with each other. This
means that a DOCSIS 3.0 modem is fully compatible with the prior versions,
2.0, 1.1, and 1.0. A DOCSIS 1.0 cable modem will not be able to take
advantage of DOCSIS 3.0 channel bonding capabilities if the CMTS is
configured with multiple downstream channels.
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
Modem initialization begins when the modem is connected to the cable providers
network and powered on. The modem listens for MAC management message (MMM)
broadcasts from the CMTS. Using QAM modulated signals, the MMM carries the
188-byte MPEG-2 transport stream for modem synchronization with the MAC
domain, as well as the upstream channel descriptors (UCDs) and their associated
MAP packets for establishing upstream transmissions, and a MAC domain description
(MDD) for D3.0 modems capable of channel bonding.
Once the cable modem is able to listen for and receive the MPEG-2 transport streams
that are modulated on the downstream carrier signals, the modem begins the initial
ranging process over the upstream channels.
In large networks with many cable modems attempting to register with the CMTS at
the same time, initial ranging requests are subject to collisions with requests from
other modems. 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 modem 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 cable modems to avoid
collisions.
Ranging backoff values are expressed as an exponential value to set the number of
ranging opportunities per retry, such 23, 24, 25, and 26. For example, configuring a
value of 3 specifies 23, or 8 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 cable
modem receives an upstream transmission grant from the CMTS, the MAC domain
adjusts the cable modem for frequency, power, and delay. Two-way modem
communication with the CMTS is then established.
After the initial ranging request has completed, the cable modem is then provisioned
using DHCP and TFTP to complete the initialization process, as described in the next
section. When the initialization process has completed, the cable modem requests
registration with the CMTS. The cable modem can then receive transmissions on the
downstream channels and transmit to the CMTS over the upstream channels.
3. Optionally, the cable modem may request time information from a time-of-day
(ToD) server. In most cases, time information is returned to the cable modem
using DOCSIS time synchronization packets from the MAC domain that are
carried in the MAC management messages.
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.
In the upstream, you should not see any power difference, regardless of the number of
channels enabled.
Frequency
Width
Burst profile
1. Each burst profile can be one of five burst types: initial ranging, periodic ranging,
long data, short data, and request. (See Chapter 11, Modulation profiles.)
2. Each burst type can have one or more burst descriptors with up to twelve burst
description parameters, such as modulation type, forward error correction (FEC),
scrambler, preamble, long/short data, and others.
Each UCD has one associated MAP that instructs the modem on when to transmit
over an upstream timeline.
Figure 1-4 illustrates the association between the UCD and the MAP, where:
UCD1 specifies the CMTS upstream channel, frequency, width and burst profile.
MAP1 specifies when time-zero (t0) begins on the upstream timeline, as well as
the 32-byte field that carries the service identifier (SID) that describes 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.
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 within each interval is 6.2
microseconds. Figure 1-5 illustrates the upstream channel timeline, intervals, and
minislots in the network context. (See Chapter 20, Upstream interface.)
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 modem only supports 4 downstream and 4 upstream channels, the modem 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, or DS-SG associated
with the assigned modem channel set. A service group 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, or
US-SG. Collectively, the upstream and downstream service groups make up the cable
modem service group, or CM-SG. All upstream and downstream channels originating
from the same MAC domain are known as a MAC domain cable modem service
group, or MD-CM-SG.
Note that the cable modem in Figure 1-6 at the D distribution area endpoint uses a
two-channel upstream service group. This means that upstream traffic from the cable
modem will be assigned to one of two channels from the MAC domain-assigned
US-SG for this modem.
A DOCSIS fiber node refers to a cable modem service group (CM-SG), which is made
up of the upstream and downstream service groups 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 cable modem service group and not
the physical network.
The Casa CMTS supports two types of load balancing: general load balancing and
restricted load balancing.
The general load balancing group (GLBG) uses the complete set of upstream and
downstream channels in that modems cable modem service group (CM-SG).
Note: A single cable modem cannot belong to more than one load balancing
group at any given time.
Both general and restricted load balancing groups have the following characteristics,
with
At cable modem registration time, the CMTS attempts to assign the modem either to a
restricted load balancing group (if it exists), or to a general load balancing group. If a
restricted load balancing group does not exist in the CMTS configuration file, the
cable modem is then assigned by default to the general load balancing group using the
channels in the MD-CM-SG for that modem.
A single cable modem can belong to only one load balancing group using only the
upstream and downstream channels within that group.
Load balancing does not take place if the CMTS cannot determine the load
balancing group to which a registered cable modem belongs.
Dynamic channel change (DCC) and dynamic bonding change (DBC) messages from
the MAC domain instruct cable modems on when to change channels, or when to
change an upstream or downstream bonding group. Both DCC and DBC can occur
during traffic load balancing at the CMTS when the cable modem has access to
multiple upstream or downstream channels.
DCC moves legacy and current DOCSIS 3.0 modems (not operating with a multiple
receive channel set) from one downstream channel to another using the MD-CM-SG
for that modem. On the upstream side, DCC also instructs cable modems to move
from one transmit channel to another from the MD-CM-SG.
DBC moves DOCSIS 3.0 modems downstream service flows to different channels in
the modems receive channel set. DBC 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 load balancing policy
using a policy ID.
A basic rule sets the time of day when the CMTS is to perform load balancing. The
configured time will be 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 specification
requirement.
An 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
modems, the time interval, or how often certain modems 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 the DOCSIS specification.
At cable modem registration time, the CMTS assigns a load balancing policy ID to the
cable modem based on the default policy of the general load balancing group or the
restricted load balancing group for this cable modem.
The CMTS performs load balancing in one of two ways, or a combination of the two:
Static load balancing takes place when a cable modem sends its initial ranging request
message to the CMTS. For DOCSIS 1.0, 1.1 and 2.0 modems, 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 cable
modem which channels it should use. For DOCSIS 3.0 modems, when a cable modem
sends its registration request (REG-REQ) messages, the CMTS responds with a
registration response (REG-RSP) message to instruct the cable modem to select the
channels.
Dynamic load balancing moves cable modems among upstream and downstream
channels within the same service group when the difference between two channels
exceeds a defined percentage. The CMTS will use dynamic channel change messages
(DCC) to move cable modems with single upstream/downstream channels, and
dynamic bonding change (DBC) messages to move cable modems with bonded
upstream/downstream channels to different bonding groups.
Note: For DOCSIS and EuroDOCSIS 3.0 modems, the dynamic load
balancing software generates a downstream channel set with a minimum load
to fit the modems receive channel profile (RCP). This prevents rejection of the
new channel set so that load balancing is not canceled when the assigned
modem is under load.
The CMTS does not move modems to disconnected (idle) downstream channels
where there are no registered online cable modems.
An exclusion list disables one or more modems from load balancing across CMTS
downstream and upstream channels in situations where it is not feasible to load
balance particular modems. For example, there may be cases where an older DOCSIS
1.0 or 2.0 modem from a specific vendor may not be a good candidate for load
balancing, as well as modems that process particular types of traffic where moving
those modems to other channels introduces risks. Cable modems 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 cable modem. 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 parameters.
cable modem service group (CM-SG) The combination of upstream (US-SG) and
downstream channels (DS-SG) at the CMTS to which a cable modem has access.
channel bonding The DOCSIS 3.0 cable modem feature that allows the CMTS to
link a group of channels based on the number of channels supported by the target
cable modem. When the CMTS creates a bonding group for a cable modem that has
four physical downstream receivers, the modem can receive over the four channels
simultaneously over a downstream channel set.
DOCSIS fiber node A cable modem service group (CM-SG) made up of the
upstream service group (US-SG) and the downstream service group (DS-SG).
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 cable modem to move from one channel to another within the cable
modem service group (CM-SG).
dynamic bonding change (DBC) The MAC management that moves DOCSIS 3.0
modem downstream service flows to different channels in the modems receive
channel set (RCS). DBC also moves D3.0 upstream service flows to different
channels in the current transmit channel set (TCS).
dynamic host control protocol (DHCP) The IETF protocol for dynamically
assigning an IPv4 or IPv6 address to a requesting device, such as a cable modem. The
CMTS forwards a DHCP request from a cable modem to a dedicated DHCP server.
The CMTS then forwards the DHCP response message containing the IP address to
the requesting cable modem.
dynamic load balancing The CMTS traffic balancing method that moves cable
modems 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 modems 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 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.
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.
forwarding engine The set of CMTS processes that reside between the CMTS
network side interface (NSI) and radio frequency interface (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 cable modem service group (CM-SG) that are available for
load balancing operations.
initial ranging The upstream burst type that is carried by the upstream channel
descriptor in the MPEG-2 transport stream that enables a cable modem to request an
upstream transmission grant from the CMTS so that the modem 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 cable modem frequency, power, and delay for
two-way communication. IUC are carried by MAP packets in the MPEG-2 transport
stream.
load balancing The CMTS process that enables modems 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 cable modems 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 64 MAC domains. (See
Chapter 8, DOCSIS MAC interface.)
MAC domain cable modem service group (MD-CM-SG) All cable modem
upstream and downstream channels originating from a single MAC domain.
MAC domain descriptor (MDD) The DOCSIS 3.0 packet carried by the MPEG-2
transport stream that defines the receive channel set for cable modems that support
multiple receivers and transmitters, such as a D3.0 cable modem 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 The packet carried by the MPEG-2 transports stream that instructs the
modem 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 within each interval is 6.2 microseconds.
MPEG-2 transport stream The 188-byte packet carried in the MAC management
message 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. QAM64 modulation over 6 MHz channels
operates at 30 Mbps.
QAM256 A 256-state modulation method that combines phase angle and amplitude
signals over downstream channels. QAM256 modulation over 6 MHz channels
operates 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 cable modem 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 cable modems to avoid collisions with other
modems. Ranging backoff values are expressed as an exponential value to set the
number of ranging opportunities per retry, such 23, 24, 25, and 26.
receive channel set (RCS) The downstream channels over which a cable modem
receives traffic from the MAC domain. The MAC domain descriptor (MDD) in the
MPEG-2 transport stream informs the modem about the receive-channel configuration
and the receive channel set to be used by that modem.
service group (SG) The group of downstream channels (DS-SG) over which a
cable modem receives traffic from the MAC domain, or the group of upstream
channels (US-SG) over which the cable modem transmits to the CMTS. The
combination of both upstream and downstream service groups is known as the cable
modem service group (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 cable modem attempting to transmit upstream to the
CMTS.
static load balancing The CMTS traffic balancing method that instructs the cable
modem which channels it should use after initial ranging. For DOCSIS 3.0 modems,
when a cable modem sends its registration request (REG-REQ) messages, the CMTS
transmit channel set (TCS) The CMTS 5 MHz to 42 MHz upstream channels over
which a cable modem 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 for
transferring a cable modem configuration file from a dedicated TFTP server to a target
cable modem, allowing the modem to properly configure itself for two-way
communication with the CMTS.
upstream channel The CMTS 5 MHz to 42 MHz channel over which a cable
modem transmits traffic to the CMTS over a transmit channel set (TCS). Upstream
channel information is determined by the UCD and MAP packets carried in the
MPEG-2 transport stream from the CMTS. (See Chapter 20, Upstream interface.)
upstream channel descriptor (UCD) The packet carried in the MPEG-2 transport
stream that describes the upstream channels over the which a cable modem transmits
to the CMTS. Each UCD describes an upstream channel with frequency, width, and
burst profile (set of burst descriptors). Each UCD has one associated MAP that
instructs the modem on when to transmit over an upstream timeline.
upstream service group The group of CMTS upstream channels over which a cable
modem transmits traffic to the CMTS over a transmit channel set (TCS); the group of
upstream channels to which a cable modem has access.
Configuration examples
This section contains two sample configuration files: basic and general. The basic
configuration allows the CMs to register. The general configuration demonstrates how
to configure advanced features, such as Spectrum Management, Channel Bonding,
and Load Balancing.
Basic configuration
The following sample configuration provides basic settings for registering CMs.
hostname CASA-CMTS
interface eth 0
ip address 192.168.2.215 255.255.255.0
interface gige 0
ip address 192.168.3.106 255.255.255.0
ip igmp
no shutdown
no logical-channel 0 shutdown
interface upstream 1/1
no shutdown
no logical-channel 0 shutdown
interface upstream 1/2
no shutdown
no logical-channel 0 shutdown
interface upstream 1/3
no shutdown
no logical-channel 0 shutdown
interface upstream 1/4
no shutdown
no logical-channel 0 shutdown
interface upstream 1/5
no shutdown
no logical-channel 0 shutdown
interface upstream 1/6
no shutdown
no logical-channel 0 shutdown
interface upstream 1/7
no shutdown
no logical-channel 0 shutdown
channel-utilization-interval 10
interface ip-bundle 1
ip address 192.168.7.1 255.255.255.0
cable helper-address 192.168.3.7
interface docsis-mac 1
no shutdown
ip bundle 1
downstream 1 interface qam 0/0/0
upstream 1 interface upstream 1/0/0
General configuration
hostname CASA-CMTS
interface eth 0
ip address 192.168.2.215 255.255.255.0
spectrum rule 35
action modulation frequency channel-width
channel-width 3200000 1600000
interface gige 0
ip address 192.168.3.106 255.255.255.0
ip igmp
no shutdown
interface ip-bundle 1
ip address 192.168.6.1 255.255.255.0
ip address 122.8.74.1 255.255.254.0 secondary
cable helper-address 192.168.3.7
service group 1
qam 0/0/0
qam 0/0/1
qam 0/0/2
qam 0/0/3
qam 0/1/0
qam 0/1/1
qam 0/1/2
qam 0/1/3
upstream 1/0.0
upstream 1/1.0
upstream 1/2.0
upstream 1/3.0
upstream 1/4.0
upstream 1/5.0
upstream 1/6.0
upstream 1/7.0
interface docsis-mac 1
no shutdown
ip bundle 1
downstream 1 interface qam 0/0/0
downstream 2 interface qam 0/0/1
downstream 3 interface qam 0/0/2
downstream 4 interface qam 0/0/3
downstream 5 interface qam 0/1/0
downstream 6 interface qam 0/1/1
downstream 7 interface qam 0/1/2
downstream 8 interface qam 0/1/3
upstream 1 interface upstream 1/0.0
upstream 2 interface upstream 1/1.0
upstream 3 interface upstream 1/2.0
upstream 4 interface upstream 1/3.0
upstream 5 interface upstream 1/4.0
upstream 6 interface upstream 1/5.0
upstream 7 interface upstream 1/6.0
upstream 8 interface upstream 1/7.0
channel-utilization-interval 10
BPI authentication protocols protect cable modem 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 cable modems. Earlier cable
modems use BPI.
Note: Enabling BPI reduces performance and can cause fluctuations in the
upstream throughput rates.
Configuration summary
Table 2-1 lists and briefly describes the objects related to BPI and BPI+.
cable privacy Sets the privacy mode for, and enforces, BPI.
cable sa-des-tlvlen-2 Sets the security association TLV length as required by
some BPI-authenticated cable modems.
privacy hotlist Adds entries to the privacy hotlist to mark a CMs or
manufacturers certificate as distrusted.
shared-secondary-secret Configures an authentication shared secondary encryption
key.
shared-secret Configures an authentication shared primary encryption
key.
cable privacy
Purpose
The cable privacy command sets the privacy mode for, and enforces, BPI or BPI+.
The bpi-enforce and the bpi-plus-enforce parameters can be set concurrently in the
CMTS configuration, because each setting operates on different modem types.
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to disable the cable privacy setting.
Mode
(config)#
Syntax
[no] cable privacy 40-bit-des
[no] cable privacy add-certificate {manufacturer | root} <string>
[no] cable privacy bpi-enforce [mandatory]
[no] cable privacy bpi-plus-enforce [mandatory]
[no] cable privacy test-edrca-certificate
Properties
Property name Description
Example:
Example:
Properties
Property name Description
Example:
Example:
Example:
CASA(config)# cable
test-edrca-certificate
CASA(config)#
no cable test-edrca-certificate
interface docsis-mac
privacy
Configures Key Encryption Key (KEK) or Traffic Encryption Key (TEK) lifetime on
a MAC domain interface for BPI. Each lifetime is from 1 through 604800 seconds.
(See the DOCSIS MAC interface privacy {kek | tek} life-time <1:604800>
property.)
qos-profile
The qos-profile command includes a property for specifying whether BPI is used in a
quality of service (QOS) profile, either true or false.
Shows the possible BPI MAC state status values on cable modems:
init(rc) CM ranging to the CMTS completed. Check the cable helper address
configuration and IP connectivity to the DHCP server. Use the debug cable dhcp
command for information. Note: It is also possible that the upstream is at capacity
and has no additional bandwidth for the CM to finish registration and come
online. If this is the case, make sure load balancing is enabled.
init(ua) Upstream channel adjustment (for DOCSIS 3.0 modems).
init(d) The CMTS received the DHCP discover message; the first IP broadcast
packet was received from the CM.
init(i) The CM received the DHCPOFFER reply from the DHCP server, but
the CM has not yet replied with a DHCPREQUEST message, nor has it sent an IP
packet with its assigned IP address. It is possible that the CM received the
DHCPOFFER reply from the DHCP server, but the reply might have invalid
options for that particular CM.
init(e) Early authentication and encryption started (D3.0 modems). Check the
modem certificate if stuck in this state.
init(t) Time-of-day (TOD) exchange on the configuration file download has
started.
init(o) The configuration file download has started.
init(r) The CMTS received a register-request from the CM, but has not yet
received a reg-ack. If stuck, check the modem config file. Use the debug cable
registration command to debug the registration request received.
init(bpi) Starts baseline privacy. If stuck in this state, check the modem
certificate and ensure that the CM is synchronized with the BPI server.
resetting The CM is being reset; the registration process is restarting.
cc(r1) The CM previously registered and was online, but the CMTS sent a
Dynamic Channel Change (DCC) or Upstream Channel Change (UCC) request
message to the CM. The CM started moving to the new channel, sending an initial
ranging request on the new downstream or upstream channel to the CMTS. At the
MAC layer, the CM is not yet passing traffic to the new channel and is considered
in the off-line state. This state does not trigger the flap-list counters.
cc(r2) This state normally follows cc(r1) and indicates that the CM finished its
initial ranging on the new channel, and is currently performing continuous
ranging on the new channel. At the MAC layer, the CM is not yet passing traffic to
the new channel and is considered in the off-line state. This state does not trigger
the flap-list counters.
offline The CM is detected as off-line, disconnected, or powered off.
online The CM has registered; the CM is ready to pass data on the network.
online(d) The CM is registered. However, network access for CPE devices
using this CM was disabled by the DOCSIS configuration file. The CMTS
continues to communicate with the CM using DOCSIS messages and IP traffic
(such as SNMP) but the CM does not forward traffic to or from the CPE devices.
Note: If BPI was enabled in the DOCSIS configuration file sent to the CM, the
CM is using BPI encryption unless other messages indicate that the BPI
negotiation and key assignments failed.
online(pk) BPI is enabled and the key-encrypting key (KEK) is assigned.
online(pkd) BPI is enabled and the KEK is assigned, but network access for
CPE devices using this CM was disabled.
online(pt) BPI is enabled and the traffic-encrypting key (TEK) is assigned.
online(ptd) BPI is enabled and the TEK is assigned, but network access for
CPE devices using this CM was disabled.
expire(pk) BPI is enabled and the KEK was assigned, but the current KEK
expired before the CM could successfully renew a new KEK value.
expire(pke) Equivalent to the online(d) and expire(pk) states except that
network access for CPE devices using this CM was disabled.
expire(pt) BPI is enabled and the TEK was assigned, but the current TEK
expired before the CM could successfully renew a new TEK value.
expire(ptd) Equivalent to the online(d) and expire(pt) states except that
network access for CPE devices using this CM was disabled.
bpi(wait) BPI wait state in which the affected modem is flapping and cannot
fully come back up, thus not forwarding data. If stuck in this state, reboot the
modem.
reject(pk) The KEK assignment is rejected and BPI encryption was not
established.
reject(pkd) The KEK assignment is rejected and BPI encryption was not
established, but network access for CPE devices using this CM was disabled.
reject(pt) TEK assignment is rejected with BPI encryption not established.
reject(ptd) The TEK assignment is rejected and BPI encryption was not
established, but network access for CPE devices using this CM was disabled.
# show cable modem
MAC Address IP Address US DS MAC Prim RxPwr
Intf Intf Status Sid (dB)
7cb2.1b42.x 10.200.0.154 2/0.0/0 0/0/3* online(pt) 1 -0.5
e448.c7ba.x 10.200.0.155 2/2.3/0* 0/1/6* online(pt) 1 -0.2
Timing Num BPI
Offset CPEs Enb
2429 0 yes
2382 0 yes
online cm 2 ; offline cm 0 ; ranging cm 0
Shows the capabilities, whether BPI is enabled, and the BPI encryption algorithm for
each MAC address.
Shows the lifetime settings on the DOCSIS MAC interface for the Key Encryption
Key (KEK) and Traffic Encryption Key (TEK) required for BPI.
cable sa-des-tlvlen-2
Purpose
The cable sa-des-tlvlen-2 command sets the security association (SA) TLV length to
two bytes as required by some BPI-authenticated cable modems. These modems may
not register with the CMTS using a one-byte descriptor. The sa-des-tlvlen-2 value is
the default.
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to reset the two-byte SA descriptor TLV to one byte.
Mode
(config)#
Syntax
[no] cable sa-des-tlvlen-2
privacy hotlist
Purpose
The privacy hotlist command adds entries to the privacy hotlist to mark a CMs or
manufacturers certificate as distrusted and prevent those CMs from registering.
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to disable the hotlist.
Mode
(config)#
Syntax
[no] privacy hotlist cm <mac_addr>
[no] privacy hotlist manufacturer <serial_num>
Properties
Property name Description
Example:
Properties
Property name Description
Example:
shared-secondary-secret
Purpose
In the Casa configuration mode, using the command leaves you in configuration
mode. Use the no form of the command to remove the secondary secret.
Mode
(config)#
Syntax
shared-secondary-secret <1|2> <0|7> <key> [extend]
no shared-secondary-secret <1|2> [extend]
Properties
Property name Description
Example:
CASA(config)# shared-secondary-secret 1
0 DOCSIS extend
shared-secret
Purpose
The CMTS supports up to 198 shared secrets (primary, secondary, and extended),
including those defined under the interface docsis-mac configuration.
In the Casa configuration mode, using the command leaves you in configuration
mode. Use the no form of the command to remove the shared secret.
Mode
(config)#
Syntax
shared-secret <0|7> <key> [extend]
no shared-secret <0|7> [extend]
Properties
Property name Description
Properties
Property name Description
Example:
Provisioning servers at the headend are necessary for the CM to properly complete the
initialization process. The CM initiates a request to a DHCP server for an IPv4 or IPv6
address assignment. Once the CM is assigned an IP address, it submits a request to a
target TFTP server for the DOCSIS modem configuration file. The configuration file
provides operational information to the modem using parameters that are set by the
cable service provider, including program identification to the CMTS MAC domain.
The TFTP server responds to the request by forwarding and loading the configuration
file to the modem at the DHCP-assigned address. Optionally, the CM may request
time information from a time-of-day (ToD) server.
Configuration summary
Table 3-1 lists and briefly describes the objects related to cable commands.
cable admission-control
Purpose
The cable admission-control command enables (and sets global parameters for)
admission control, a mechanism that manages the service flow admission requests
when resources are not available to support the incoming service flow. It allows
mapping different service flow types into different application classes with defined
attribute rules. If the bandwidth resource for the application class is not available for
the upstream or downstream channel, the new service flow request is rejected.
In the Casa configuration mode, the command keeps you in that mode. Use the no
form of the command to remove the admission control.
Mode
(config)#
Syntax
[no] cable admission-control
[no] cable admission-control cm-registration
[no] cable admission-control dynamic-service [exceed {dcc | reject}]
[no] cable admission-control multicast
[no] cable admission-control preempt priority-voice
Properties
Property name Description
Example:
Example:
Example:
Properties
Property name Description
preempt priority-voice Gives bandwidth priority to certain voice flows over all
other traffic, known as high-priority call preemption.
Example:
Example
CASA(config)# cable admission-control cm-registration
CASA(config)# cable admission-control dynamic-service exceed dcc
CASA(config)# cable admission-control preempt priority-voice
CASA(config)# application class 4
CASA(conf-app-class 4)# downstream-bandwidth exclusive 100
CASA(conf-app-class 4)# upstream-bandwidth exclusive 100
CASA(conf-app-class 4)# include BE
CASA(conf-app-class 4)# include packetcable emergency
CASA(conf-app-class 4)# include pcmm app-id 1
CASA(conf-app-class 4)# include service-class SVCLASS1
The cable arp filter command sets the number of ARP response packets to accept
from the CM and CPE in a configured time window.
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to remove the ARP filter.
Mode
(config)#
Syntax
cable arp filter <0:20> <1:60>
no cable arp filter
Properties
Property name Description
Example:
The cable dhcp filter command sets the number of DHCP response packets to accept
from the CM and CPE in a configured time window.
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to revert to the default settings.
Mode
(config)#
Syntax
cable dhcp filter <0:255> <1:60>
no cable dhcp filter
Properties
Property name Description
Example:
The cable dhcp-leasequery filter command sets the number of DHCP leasequery
packets to send to the CM and CPE in a configured time window.
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to remove the DHCP leasequery filter.
Mode
(config)#
Syntax
cable dhcp-leasequery filter <0:20> <1:4>
no cable dhcp-leasequery filter
Properties
Property name Description
Example:
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to remove the DHCPv6 leasequery filter.
Mode
(config)#
Syntax
cable dhcpv6-leasequery filter <0:20> <1:4>
no cable dhcpv6-leasequery filter
Properties
Property name Description
Example:
cable diaglog
Purpose
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to remove the diagnostic log.
Mode
(config)#
Syntax
[no] cable diaglog
[no] cable diaglog ranging
cable diaglog reg-detail-mask <0x0:0xffff>
cable diaglog reg-time-interval <60:86400>
[no] cable diaglog registration
Properties
Property name Description
Example:
Example:
Properties
Property name Description
Example:
Example:
The cable dsx authorization command checks all DSX messages (DSA, DSC and
DSD) for a valid gate ID authorization value. If the DSX message is invalid, the
CMTS rejects the message.
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to disable DSX authorization.
Mode
(config)#
Syntax
[no] cable dsx authorization
cable dynamic-service-flow
Purpose
In the Casa configuration mode, using the command keeps you in that mode. There is
no no form of the command.
Mode
(config)#
Syntax
cable dynamic-service-flow bonding
cable dynamic-service-flow non-bonding
cable dynamic-service-flow primary
Properties
Property name Description
Example:
CASA(config)# cable
dynamic-service-flow bonding
Example:
CASA(config)# cable
dynamic-service-flow non-bonding
Properties
Property name Description
Example:
CASA(config)# cable
dynamic-service-flow primary
The cable ecn 770 command enables CableLabs Engineering Change Notice (ECN)
770 to help keep modems from getting into the upstream partial service state when
there are a large number of modems attempting to register with the CMTS while the
CMTS is assigning and bonding channels to D3.0 modems. This feature is enabled by
default.
Some cable modems end up in upstream partial service mode if there are collisions
followed by no additional attempts to range on the assigned upstream channels.
Configuring unicast ranging as the initial technique instead of the default broadcast
ranging in interface docsis-mac configuration, by using the initial-tech
unicast-ranging command, avoids any collisions and helps prevent modems from
getting into upstream partial service mode.
By enabling ECN 770, UCD encodings are included in the transmit channel
configuration (TCC) in the CMTS registration response to the prevent the partial
service problem. However, modems that are already in partial service mode must be
reset.
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to disable ECN 770.
Mode
(config)#
Syntax
[no] cable ecn 770
cable event
Purpose
The cable event command enables generating and dispatching DOCSIS cable event
message notifications. This function is enabled by default. The cable event <id>
command controls the dispatching of DOCIS cable event messages by event ID. By
default, all cable event messages except 82010100 and 82010400 are enabled. Use the
show cable event running-config command to display the list of cable event IDs.
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to disable cable event generation.
Mode
(config)#
Syntax
[no] cable event
[no] cable event <0:4294967295>
[no] cable event <0:4294967295> delivery
[no] cable event priority {alert | critical | debug | emergency | error
| informational | notice | warning} <flags>
[no] cable event syslog-server <ip_addr>
[no] cable event throttle-adminStatus {inhibited |
maintainBelowThreshold | stopAtThreshold | unconstrained}
[no] cable event throttle-interval <1:2147483647>
[no] cable event throttle-threshold <num>
Properties
Property name Description
Example:
Properties
Property name Description
Example:
priority {alert | critical Configures the event reporting flags for DOCSIS
| debug | emergency | error event messages, which determines how the CMTS
| informational | notice | reports these events. The reporting flags can be
warning} <flags> alert, critical, debug, emergency, error,
informational, notice, or warning. The flag values
(in hex) designate how messages are handled:
Example:
Properties
Property name Description
Example:
Example:
Properties
Property name Description
Example:
Example:
Clears all cable events. This command is available in configuration mode only.
cable flap-list
Purpose
The cable flap-list command enables detecting abnormal CMs in the network and
providing a list of malfunctioning ones to help identify the problem.
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to disable the flap list.
Mode
(config)#
Syntax
cable flap-list add {<mac_addr> | all | downstream <slot>/<port>/
<chan> | upstream <slot>/<port>.<pchan>/<lchan>}
cable flap-list aging {<15:86400> | default}
cable flap-list check-interval {<1:1200> | default}
[no] cable flap-list insertion-time {<1:120> | default}
[no] cable flap-list miss threshold {<3:12> | default}
[no] cable flap-list power-adjust threshold {<1:20> | default}
[no] cable flap-list trap
Properties
Property name Description
add {<mac_addr> | all | Adds a flap list to a specific MAC address, all
downstream <slot>/<port>/ modems, or a specific downstream or upstream
<chan> | upstream <slot>/ interface. There is no no form of the command.
<port>.<pchan>/<lchan>}
Example:
Properties
Property name Description
Example:
check-interval {<1:1200> | Interval for the CMTS to scan the flap list table,
default} default 120 minutes (2 hours). If the CMTS finds any
CM that reached the aging limit, the CMTS removes
it from the flap list table. When the CM is removed,
the user cannot check the CMs flap-list information.
There is no no form of the command.
Example:
Example:
Properties
Property name Description
miss threshold {<3:12> | When the CMs do not reply to the maintenance
default} message sent from the CMTS after the specified
number of times, they are put in the flap list table for
observation. The default is 6 times.
Example:
power-adjust threshold After the CMs come online and the status is stable, if
{<1:20> | default} the power adjustment from the CMTS to the CMs is
greater than the specified unit of dB, the CMs are
moved to the flap list table for observation. The
default is 2 dB.
Example:
Example:
Clears all cable flap lists. The optional delete modifier deletes all flap list CM records,
and the reset modifier resets all flap list counters.
Shows the cable flap list. A number of sort options are available.
The cable host authorization command enables cable modem host authorization
address without changing the CM config file.
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to disable host authorization.
Mode
(config)#
Syntax
[no] cable host authorization <mac_addr> {<ip_addr> | <ip6_addr>} [vrf
<name>]
Properties
Property name Description
<mac_addr> {<ip_addr> | MAC address and the IPv4 or IPv6 address of the
<ip6_addr>} [vrf <name>] CM, with the optional VRF name.
Example:
The cable icmp filter command sets the number of ICMP response packets to accept
from the CM and CPE in a configured time window.
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to remove the ICMP filter.
Mode
(config)#
Syntax
[no] cable icmp filter <0:255> <1:60>
Properties
Property name Description
Example:
The cable igmp filter command sets the number of Internet Group Management
Protocol (IGMP) response packets to accept in a configured time window.
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to remove the IGMP filter.
Mode
(config)#
Syntax
[no] cable igmp filter <1:5000> <1:60>
Properties
Property name Description
Example:
The cable igmp static-group command creates a static multicast session for IGMP
any-source-multicast.
In the Casa configuration mode, creating the static group takes you to IGMP
static-group configuration mode. Use the no form of the command to remove the
IGMP static group.
Modes
(config)#
(conf-igmp-static-group <addr>)#
Syntax
(config)#
[no] cable igmp static-group {<ip_addr> | ipv6 <v6_addr>} [source
<ip_addr>][dsid <85689:86688>]
(conf-igmp-static-group x)#
[no] description <text>
[no] qam <slot>/<port>/<chan>
Properties
Property name Description
Example:
Properties
Property name Description
Example:
Example:
Example:
CASA(conf-igmp-static-group 224.0.0.0)#
description First static group
CASA(conf-igmp-static-group 224.0.0.0)#
no description
Example:
CASA(conf-igmp-static-group 224.0.0.0)#
qam 2/0/0
CASA(conf-igmp-static-group 224.0.0.0)#
no qam 2/0/0
The cable igmp vrf command creates a Virtual Routing and Forwarding (VRF) static
group instance for IGMP.
In the Casa configuration mode, creating the static group takes you to IGMP
static-group configuration mode. Use the no form of the command to remove the
IGMP VRF static group.
Modes
(config)#
(conf-igmp-static-group x)#
Syntax
(config)#
[no] cable igmp vrf <vpn_id> static-group <ip_addr> [source <ip_addr>]
[dsid <85689:86688>]
(conf-igmp-static-group x)#
[no] description <text>
[no] qam <slot>/<port>/<chan>
Properties
Property name Description
Properties
Property name Description
Example:
CASA(conf-igmp-static-group 224.0.0.0)#
description First static group
CASA(conf-igmp-static-group 224.0.0.0)#
no description
Example:
CASA(conf-igmp-static-group 224.0.0.0)#
qam 2/0/0
CASA(conf-igmp-static-group 224.0.0.0)#
no qam 2/0/0
cable mdd
Purpose
The cable mdd command enables the CMTS to inform registered cable modems
through the MAC Domain Descriptor (MDD) that it supports extended transmission
power over upstream channels, or fragmented RCC/RCP TLV packet transmissions if
the RCP length exceeds 255.
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to disables the settings.
Modes
(config)#
Syntax
[no] cable mdd cm-status-ack support
[no] cable mdd extended tx-power support <0|1>
[no] cable mdd rcp {fragment | verbose} support
Properties
Property name Description
Example:
Properties
Property name Description
Example:
Example:
Shows the extended transmission power support. With extended transmission power
support enabled, debug output shows Extended Upstream Transmit Power
Capability(40):f4.
Shows the MDD messages for a downstream channel, including the decoding.
cable mirror
Purpose
The cable mirror command mirrors traffic from specified devices by setting the cable
modem or CPE MAC address being mirrored and destination IPv4 address and UDP
port to which the mirrored traffic is sent. The command takes effect immediately.
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to disables the settings.
Modes
(config)#
Syntax
[no] cable mirror <mac_addr> <ip_addr> <1:65535>
Properties
Property name Description
Example:
cable modem
Purpose
Modes
#
(config)#
cable monitor-period
Purpose
The cable monitor-period command sets the cable monitoring period. Casa Spectrum
Management (CSM) monitors the quality of all upstream channels by periodically
polling measured parameters of signal-to-noise ratio (SNR), correctable Forward
Error Corrections (FECs), and uncorrectable FECs. (This command may be replaced
by the cable spectrum monitor-period command.)
In the Casa enable or configuration mode, using the command keeps you in that mode.
There is no no form of the command.
Mode
(config)#
Syntax
cable monitor-period <5:3600>
Properties
Property name Description
Example:
cable partial-service
Purpose
In the Casa enable or configuration mode, using the command keeps you in that mode.
Use the no form of the command to unset the partial-service property.
Mode
(config)#
Syntax
[no] cable partial-service continue-ranging
[no] cable partial-service dbc
[no] cable partial-service reset-legacy-cm
[no] cable partial-service upstream-impairment [margin <1:10>]
Properties
Property name Description
Example:
Example:
Example:
Properties
Property name Description
Example:
Shows cable modems in partial-service mode. Note that the show cable modem
command shows modems in partial-service mode with a hash mark (#). Output can
also be filtered by MAC address, downstream or upstream, or service-group.
cable privacy
Purpose
The cable privacy command enables privacy settings for the cable modem.
The cable proxy-arp unknown command is implemented for fixed IP remote host
deployments in which the CMTS does not have an ARP binding to an IP address in
the ARP table. When configured, the CMTS responds to the ARP request (for the
unknown IP address in the ip-bundle subnets) with the proxy ARP gateway MAC
address.
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to disable the property (the default).
Mode
(config)#
Syntax
[no] cable proxy-arp unknown
cable qos
Purpose
The cable qos command sets quality of service (QoS) options for the CM. The class
property defines the service classes based on bandwidth priority for downstream and
upstream traffic. Normally, bandwidth is assigned in strict priority based on one of 10
priority levels assigned in the configuration file for the cable modem. Weighted fair
queuing (WFQ) takes one or more of the lower eight priority service classes and
assigns a weight to each one, such that the block of available bandwidth for those
classes is fairly and proportionally assigned among them. The method is described
in more detail in the Weighted fair queuing section.
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to disable the QoS setting.
Mode
(config)#
Syntax
[no] cable qos class {ds | us} <0:7> {flow-wfq {enable | max-rate
<1000:2147483647>} | weight <1:100>}
cable qos ds scheduler mode {guaranteed-plus | normal}
[no] cable qos temp-us-sf <svclass_name>
cable qos us scheduler mode {guaranteed-plus | normal}
Properties
Property name Description
class {ds | us} <0:7> Sets the QoS class for the downstream or upstream
{flow-wfq {enable | service. The DOCSIS priority is from 0 through 7,
max-rate <1000:2147483647>} with 7 the default highest priority. The Weighted Fair
| weight <1:100>} Queuing (WFQ) scheduling algorithm prioritizes
weighted multiple traffic queues that share the same
link capacity (Release 6.4) and the US and DS
service flows within a single queue (Release 6.5.).
The weight is the bandwidth allocation, in ticks. (See
Weighted fair queuing for details.) The flow-wfq is
service flow WFQ, which can be enabled and its
maximum traffic rate set, in bits per second. For
details on service flow WFQ, see Service flow
weighted fair queuing.
Example:
Example:
Properties
Property name Description
Example:
Example:
In best-effort (BE) weighted fair queuing (using the weight property), the WFQ
scheduler allows contention bandwidth to be allocated across different queues at their
levels based on assigned weights. The CMTS essentially treats all the classes with
WFQ weights assigned with the same block of available remaining bandwidth and
proportions them fairly among the classes. All the service flows in each class
assume the aggregated weight from the service class and are treated equally.
For example, if QOS classes 2,3,4,5 have a weight configured, the scheduler services
the DOCSIS MAC (9) and guaranteed bandwidth (8) classes, then classes 7, 6, 1, and
0 in a strict priority fashion. It then services WFQ classes 5, 4, 3, and 2 round-robin
until they either exhaust their quota or it finds the queue empty. Each of the WFQ
classes is assigned a weight from 0 through 100, which determines the bandwidth
proportion for each class. The effective bandwidth assigned to each service class then
becomes a percentage in terms of the ratio of its weight to the total of all the weights
assigned with the WFQ policy.
Service flow level WFQ (using the flow-wfq property) supports finer grained
bandwidth allocation control than BE WFQ in that it can address individual service
flows in a single queue. If enabled for a particular queue level and when there is
bandwidth contention, bandwidth will be allocated to different service flows within
the queue based on the service flows assigned maximum sustained rate.
The service flow WFQ mechanism must be explicitly enabled using cable qos class
{ds | us} <priority> flow-wfq enable. If the maximum sustained rate is not set for the
service flow in the cable modems configuration file, a default maximum traffic rate
for each flow can be set with the max-rate property (in bits per second). If neither
rates are set, the flow assumes the default maximum traffic rate defined for the class.
The maximum sustained rate can be determined with the show cable modem qos
command.
Scheduler modes
The default normal scheduling mode satisfies the minimum and maximum
guaranteed rate service flows, and does best-effort round-robin scheduling once the
minimum rate is fulfilled. For example, if there are two service flows (SFs) on a
channel (at maximum 38 Mbps), when 50 Mbps is sent on both streams, they each get
38/2 = 19 Mbps:
Shows the cable QoS downstream or upstream weight (bandwidth allocation) using
the Weighted Fair Queuing (WFQ) scheduling algorithm. In the example, the CMTS
uses the strict priority until it reaches priorities 4, 3, and 2, when it uses the WFQ
algorithm based on the weights set, with priority 4 having the largest weight.
7 Strict Priority -
6 Strict Priority -
5 Strict Priority -
4 Weighted Fair Queue 80
3 Weighted Fair Queue 40
2 Weighted Fair Queue 20
1 Strict Priority -
0 Strict Priority -
Shows the cable QoS downstream or upstream weight (bandwidth allocation) using
the service flow WFQ scheduling algorithm. In this example, only priority 7 is
enabled to use the algorithm. If a maximum sustained traffic rate is not set for a
service flow in that class, it uses the defined default maximum rate.
7 Enabled 20000000
6 Disabled Not Set
5 Disabled Not Set
4 Disabled Not Set
3 Disabled Not Set
2 Disabled Not Set
1 Disabled Not Set
0 Disabled Not Set
cable rcp-select
Purpose
The cable rcp-select command sets the Receive Channel Profile (RCP) selection for
the CM. (See also the rcp command in Chapter 5, Channel bonding.)
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to disable the RCP select.
Mode
(config)#
Syntax
[no] cable rcp-select <string> priority <1:100>
Properties
Property name Description
Example:
cable sa-des-tlvlen-2
Purpose
The cable sa-des-tlvlen-2 command sets the security association TLV length to two
bytes as required by some BPI-authenticated cable modems. These modems may not
be able to register with the CMTS using a one-byte descriptor. The sa-des-tlvlen-2
value is the default.
cable sec
Purpose
The cable sec command sets the following modem security properties:
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to remove the cable security setting.
Mode
(config)#
Syntax
[no] cable sec cert-revocation-list {refresh-interval <1:524160> | url
<utl_addr>}
[no] cable sec cert-revocation-method {crl | crlAndOcsp | none | ocsp}
[no] cable sec config-file-learning
[no] cable sec eae-exclusion <1:4294967295> <mac_addr> [<mask>]
cable sec encrypt_alg_priority {aes128CbcMode | des40CbcMode |
des56CbcMode}
[no] cable sec modem-cert check
[no] cable sec ocsp {protocol-url <url> | signature-bypass}
[no] cable sec sav-auth-enable
[no] cable sec sav-cfg-list <name> <1:4294967295> {<ip4_addr>/<mask> |
ipv6 <ip6_addr>/<prefix>} [vrf <name>]
cable sec tftp-options {both | hw-addr | net-addr | none}
Properties
Property name Description
Example:
Example:
Properties
Property name Description
Example:
Example:
Example:
Properties
Property name Description
Example:
Example:
Properties
Property name Description
Example:
Example:
Shows the CMs OCSP properties. Output can also be filtered by protocol-url or
signature-bypass.
Shows the CMs Source Address Verification (SAV) configuration rules. Output can
also be filtered by name or rule ID.
Shows the CMs TFTP proxy configuration. Note that during a CMTS reset, the TFTP
option should be set to none when downloading the config file.
Mode
(config)#
Syntax
[no] cable service attribute withold-TLVs peak-rate
Shows any peak traffic rate settings. Output can also be brief or verbose.
cable service-class
Purpose
The cable service-class command sets parameters for DOCSIS 1.1 cable service
classes. Service classes support the QoS profile number, traffic priority, maximum
upstream bandwidth, guaranteed upstream bandwidth, maximum downstream
bandwidth, maximum transmit burst length, baseline privacy enable/disable, and type
of service (ToS) overwrite byte. The service class requires an ID and a name.
In the Casa configuration mode, defining a service class changes the command mode
to service-class configuration (conf-service-class) mode. Use the no form of the
command to remove the service class configuration.
Modes
(config)#
(conf-service-class <id>)#
Syntax
(config)# [no] cable service-class {<1:1024> | default_ugs}
(conf-service-class x)#
(conf-default-ugs)#
name <name>
activity-timeout <0:65535>
admission-timeout <0:65535>
app-id <0:4294967295>
attr-aggr-rule-mask <0x0:0xffffffff>
downstream
ds-resequencing {noResequencingDsid | resequencingDsid}
dscp-overwrite <-1:63>
forbidden-attr-mask <0x0:0xffffffff>
grant-interval <0:4294967295>
grant-jitter <0:4294967295>
grant-size <0:65535>
grants-per-interval <0:127>
max-buff-size <0:4294967295>
max-concat-burst <0:65535>
max-latency <0:4294967295>
max-outstanding-bytes-per- sid-cluster <0:4294967295>
max-req-per-sid-cluster <0:255>
max-time-in-sid-cluster <0:65535>
max-tot-bytes-req-per- sid-cluster <0:4294967295>
max-traffic-burst <1522:4294967295>
max-traffic-rate <0:4294967295>
min-buff-size <0:4294967295>
min-packet-size <0:65535>
min-reserved-rate <0:4294967295>
multiplier-bytes-req <bytes>
multiplier-contention-req- window <4:12>
peak-traffic-rate <0:4294967295>
poll-interval <0:4294967295>
poll-jitter <0:4294967295>
priority <0:7>
req-trans-policy <0x0:0xffffffff>
required-attr-mask <0x0:0xffffffff>
sched-type {bestEffort | nonRealTimePollingService |
realTimePollingService | undefined | unsolicitedGrantService
| unsolicitedGrantServiceWithAD}
storage-type {nonVolatile | other | permanent | readOnly |
volatile}
tar-buff-size <0:4294967295>
tos-overwrite <0x0:0xff>
upstream
Properties
Property name Description
{<1:1024> | default_ugs} Service class ID, or the default QOS for the
Unsolicited Grant Service (UGS). This takes
you into service-class configuration mode.
Example:
CASA(config)# cable
service-class 1
CASA(conf-service-class 1)#
CASA(config)#
no cable service-class 1
Example:
Properties
Property name Description
Example:
CASA(conf-service-class 1)#
activity-timeout 600
Example:
CASA(conf-service-class 1)#
admission-timeout 600
Example:
CASA(conf-service-class 1)#
app-id 21345
Example:
CASA(conf-service-class 1)#
attr-aggr-rule-mask 0x0
Example:
CASA(conf-service-class 1)#
downstream
Properties
Property name Description
CASA(conf-service-class 1)#
ds-resequencing
noResequencingDsid
Example:
CASA(conf-service-class 1)#
dscp-overwrite -1
Example:
CASA(conf-service-class 1)#
forbidden-attr-mask 0x0
Example:
CASA(conf-service-class 1)#
grant-interval 0
Example:
CASA(conf-service-class 1)#
grant-jitter 0
Properties
Property name Description
Example:
CASA(conf-service-class 1)#
grant-size 0
Example:
CASA(conf-service-class 1)#
grants-per-interval 0
Example:
CASA(conf-service-class 1)#
max-buff-size 0
Example:
CASA(conf-service-class 1)#
max-concat-burst 40000
Example:
CASA(conf-service-class 1)#
max-latency 0
Properties
Property name Description
Example:
CASA(conf-service-class 1)#
max-outstanding-bytes-per-sid-
cluster 0
CASA(conf-service-class 1)#
max-req-per-sid-cluster 0
CASA(conf-service-class 1)#
max-time-in-sid-cluster 0
Example:
CASA(conf-service-class 1)#
max-tot-bytes-req-per-sid-cluster
0
CASA(conf-service-class 1)#
max-traffic-burst 40000
Properties
Property name Description
Example:
CASA(conf-service-class 1)#
max-traffic-rate 0
Example:
CASA(conf-service-class 1)#
min-buff-size 0
Example:
CASA(conf-service-class 1)#
min-packet-size 0
Example:
CASA(conf-service-class 1)#
min-reserved-rate 0
Example:
CASA(conf-service-class 1)#
multiplier-bytes-req 4
Properties
Property name Description
Example:
CASA(conf-service-class 1)#
multiplier-contention-req-window
8
Example:
CASA(conf-service-class 1)#
peak-traffic-rate 0
Example:
CASA(conf-service-class 1)#
poll-interval 0
Example:
CASA(conf-service-class 1)#
poll-jitter 0
Example:
CASA(conf-service-class 1)#
priority 0
Properties
Property name Description
Example:
CASA(conf-service-class 1)#
req-trans-policy 0x0
Example:
CASA(conf-service-class 1)#
required-attr-mask 0x0
CASA(conf-service-class 1)#
storage-type nonVolatile
Example:
CASA(conf-service-class 1)#
tar-buff-size 0
Properties
Property name Description
Example:
CASA(conf-service-class 1)#
tos-overwrite 0xff 0x0
Example:
CASA(conf-service-class 1)#
upstream
To apply the service class parameters, specify the service class name in TLV 24/25.4.
For example:
Main
{
NetworkAccess 1;
UsServiceFlow
{
UsServiceFlowRef 1;
QosParamSetType 7;
ServiceClassName "test"; >specify name here
SchedulingType 2;
}
DsServiceFlow
{
DsServiceFlowRef 3;
ServiceClassName "test-ds"; >specify name here; suppose you defined a
service class name "test-ds "on cmts
QosParamSetType 7;
}
MaxCPE 8;
GlobalPrivacyEnable 0;
/* CmMic 1be76c7df4777d078f76a3eb45d650d5; */
/* CmtsMic 6cf3523752bbd5bd627bb05460f1ff27; */
/* EndOfDataMkr*/
/* Pad */
}
Shows the cable service class activity. Output can also be filtered by service-class ID
or default Unsolicited Grant Service (UGS) data grant.
In Casa configuration mode, using the command leaves you in configuration mode.
Use the no form of the command to remove the service flow setting.
Mode
(config)#
Syntax
cable service-flow active-timeout <0:600> [force-delete]
no cable service-flow active-timeout
Properties
Property name Description
Example:
cable service-type-id
Purpose
The cable service-type-id command moves D2.0 cable modems between two CMTS
platforms. The command configures up to 128 frequency entries. Traffic on these
downstream frequencies that are not matched to a service-group on the local CMTS
are moved to the other CMTS.
In Casa configuration mode, using the command leaves you in configuration mode.
Use the no form of the command to remove the service flow setting.
Mode
(config)#
Syntax
[no] cable service-type-id <id> ds-frequency <47000000:999000000>
Properties
Property name Description
cable spectrum
Purpose
The cable spectrum command sets spectrum management properties for the cable
modem.
In Casa configuration mode, using the command leaves you in configuration mode.
Use the no form of the command to remove the cable spectrum setting.
Mode
(config)#
Syntax
cable spectrum cm-mode-monitor-period <5:3600>
cable spectrum hop-period <5:3600>
cable spectrum monitor-period <5:3600>
[no] cable spectrum trap
Properties
Property name Description
Example:
Example:
Properties
Property name Description
Example:
Example:
The cable subscriber over-consume trap command sets a trap for subscribers who
exceeded the maximum allowed bandwidth.
In Casa configuration mode, using the command leaves you in configuration mode.
Use the no form of the command to remove the trap.
Mode
(config)#
Syntax
[no] cable subscriber over-consume trap
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to re-enable TCC bonding.
Mode
(config)#
Syntax
[no] cable tcc us-bonding-disable
cable traffic-policy
Purpose
In the Casa configuration mode, creating the STM traffic policy takes you to
traffic-policy configuration (traffic-policy) mode. Use the no form of the command to
remove the traffic policy.
Modes
(config)#
(traffic-policy <name>)#
Syntax
(config)# [no] cable traffic-policy <name>
(traffic-policy x)#
downstream
duration <10:1440> [sample-interval <5:60>] [avg-rate
<1:4294967295>]
[no] enable
enforce {max-traffic-rate <1:4294967295> | percentage <1:100>}
[no-persistence] | priority <0:7>}
max-traffic-rate <0:4294967295>
[no] peak-time1 {daily | weekday | weekend} <0:23> duration
<60:1440>
[no] peak-time2 {daily | weekday | weekend} <0:23> duration
<60:1440>
[no] peak-time3 {daily | weekday | weekend} <0:23> duration
<60:1440>
[no] peak-time4 {daily | weekday | weekend} <0:23> duration
<60:1440>
penalty-enforce {all-day | peak-only}
penalty-period <5:10080>
upstream
Properties
Property name Description
Example:
Example:
Example:
Example:
Properties
Property name Description
Example:
Example:
CASA(traffic-policy TRPOL1)#
max-traffic-rate 600
Properties
Property name Description
peak-time1 {daily | Sets the first peak time in a day, and can be set daily,
weekday | weekend} weekdays, or weekends, followed by the hour start
<0:23> duration time and duration in minutes, with the duration not
<60:1440> crossing midnight. There is no no form of the
command.
Example:
peak-time2 {daily | Sets the second peak time in a day, and can be set
weekday | weekend} daily, weekdays, or weekends, followed by the hour
<0:23> duration start time and duration in minutes, with the duration
<60:1440> not crossing midnight.
Example:
peak-time3 {daily | Sets the third peak time in a day, and can be set
weekday | weekend} daily, weekdays, or weekends, followed by the hour
<0:23> duration start time and duration in minutes, with the duration
<60:1440> not crossing midnight.
Example:
Properties
Property name Description
peak-time4 {daily | Sets the fourth peak time in a day, and can be set
weekday | weekend} daily, weekdays, or weekends, followed by the hour
<0:23> duration start time and duration in minutes, with the duration
<60:1440> not crossing midnight.
Example:
Example:
CASA(traffic-policy TRPOL1)#
penalty-enforce all-day
Example:
CASA(traffic-policy TRPOL1)#
penalty-period 1440
upstream Binds the traffic policy to the physical upstream port.
If used, this replaces the downstream setting. There
is no no form of the command.
Example:
Shows the cable subscriber usage, which depends on a traffic policy being defined.
The optional over-consume modifier shows only those subscribers who exceeded
their maximum allowed bandwidth. Output can also be filtered by MAC address,
DOCSIS MAC, or service-group.
This command shows an asterisk (*) in the Prio (priority) or MaxSusRate (maximum
sustain rate) columns for those cable modems under traffic priority enforcement
penalty based on the subscriber traffic management (STM) rule. A penalized modem
exceeds the average rate for the configured duration period and where the enforce
priority setting is applied when setting the cable traffic-policy.
cable upstream
Purpose
In the Casa configuration mode, using the command leaves you in configuration
mode. Use the no form of the command to remove the property.
Mode
(config)#
Syntax
cable upstream hi-power <0:6>
cable upstream snr-interval <0:600>
Properties
Property name Description
Example:
Example:
Shows the cable upstream and downstream channel throughput or utilization, or the
throughput for upstream channels only.
Shows the power setting and SNR for upstream traffic, if enabled.
The default cable modem vendor command sets the system default vendor.
In the Casa configuration mode, using the command leaves you in that mode. There is
no no form of the command.
Mode
(config)#
Syntax
default cable modem vendor <vendor_id>
Properties
Property name Description
Example:
reg-rsp-original-upstream-action
Purpose
Mode
(config)#
Syntax
[no] reg-rsp-original-upstream-action
Initial ranging is a scheduled event that allows a cable modem to request an upstream
transmission grant from the CMTS. Initial ranging requests are carried in the UCD
burst profile with an associated MAP containing the CMTS-assigned interval usage
code (IUC). The IUC schedules the initial ranging interval in the upstream time line to
the CMTS. Once a transmission interval is set, the MAC domain then adjusts cable
modem frequency, power, and delay for two-way communication. In large networks
with many cable modems attempting to register with the CMTS at the same time,
initial ranging requests are subject to collisions with requests from other modems.
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 modem how long to wait before retransmitting another initial ranging
request.
Configuration summary
Table 4-1 lists and briefly describes the objects related to Cable modem commands.
cable modem
Purpose
The cable modem commands set various cable modem properties. Some require
specifying the MAC address of the cable modem, others do not. Some of the
commands are executable in enable or configuration mode, others only in
configuration mode. Use the no form of the command to remove the CM properties.
The Dynamic Bonding Change (DBC) and Dynamic Channel Change (DCC) methods
include a choice of the initial technique for moving a cable modem to a new channel.
The initial-tech options are as follows:
See the Other related commands for the clear cable modem commands.
Modes
#
(config)#
The cable modem <mac_addr> dbc command changes a CMs upstream and
downstream channels using the Dynamic Bonding Change (DBC) method. DBC
moves a DOCSIS 3.0 modems downstream service flows to different channels in the
modems receive channel set. DBC also moves D3.0 upstream service flows to
different channels in the current transmit channel set. The DBC configuration is for
the downstream or upstream list, or sets Receive Channel Profile (RCP) properties.
In the Casa enable or configuration mode, using the command keeps you in that mode.
There is no no form of the command.
Modes
#
(config)#
Syntax
cable modem <mac_addr> dbc downstream-list <list> initial-tech
{broadcast-ranging | direct | period-ranging | reinitialize-mac
| unicast-ranging}
cable modem <mac_addr> dbc downstream-list <list> upstream-list <list>
initial-tech {broadcast-ranging | direct | period-ranging |
reinitialize-mac | unicast-ranging}
cable modem <mac_addr> dbc rcp-id <id> rcc-id <1:255> [upstream-list
<list>] initial-tech {broadcast-ranging | direct |
period-ranging | reinitialize-mac | unicast-ranging}
cable modem <mac_addr> dbc upstream-list <list> initial-tech
{broadcast-ranging | direct | period-ranging | reinitialize-mac
| unicast-ranging}
Properties
Property name Description
Properties
Property name Description
Example:
dbc downstream-list <list> Sets the DBC downstream list for the CM followed by
upstream-list <list> the upstream list and initial technique (as described
initial-tech for the cable modem command). The downstream
{broadcast-ranging | direct list defines the downstream channels as a
| period-ranging | comma-separated list, such as 1,2,3. The upstream
reinitialize-mac | list defines the upstream channels in the same way.
unicast-ranging}
Example:
Properties
Property name Description
dbc rcp-id <id> rcc-id Sets Dynamic Bonding Change (DBC) Receive
<1:255> [upstream-list Channel Profile (RCP) properties for channel
<list>] initial-tech bonding. The properties are as follows:
{broadcast-ranging | direct
| period-ranging | rcp-id <id> Defines the RCP ID, in the format
reinitialize-mac | xx:xx:xx:xx:xx. (See the channel bonding rcp
unicast-ranging} command.)
rcc-id <1:255> Defines the Receive Channel
Configuration (RCC) based on the MAC domain
ID. (See the channel bonding rcc command.)
upstream-list <list> Optionally defines the
upstream channels as a comma-separated list,
such as 1,2,3.
initial-tech Sets the initial technique to use for
moving cable modems, as described for the
cable modem command.
Example:
dbc upstream-list <list> Sets the DBC upstream list for the CM followed by
initial-tech the initial technique (as described for the cable
{broadcast-ranging | direct modem command). The upstream list defines the
| period-ranging | upstream channels as a comma-separated list, such
reinitialize-mac | as 1,2,3.
unicast-ranging}
Example:
The cable modem <mac_addr> dcc command changes a CMs upstream and
downstream channels using the Dynamic Channel Change (DCC) dynamic service
flow method. The DCC configuration sets the change frequency or initial technique
for the upstream channel.
In the Casa enable or configuration mode, using the command keeps you in that mode.
There is no no form of the command.
Modes
#
(config)#
Syntax
cable modem <mac_addr> dcc change-frequency <50000000:999000000>
[upstream <chan_id>] initial-tech {broadcast-ranging | direct |
period-ranging | reinitialize-mac | unicast-ranging}
cable modem <mac_addr> dcc upstream <1:255>} initial-tech
{broadcast-ranging | direct | period-ranging | reinitialize-mac
| unicast-ranging}
Properties
Property name Description
Properties
Property name Description
Example:
dcc upstream <1:255>} Sets the Dynamic Channel Change (DCC) upstream
initial-tech channel ID (see the interface upstream command),
{broadcast-ranging | direct along with the required initial-tech setting, as
| period-ranging | described for the cable modem command.
reinitialize-mac |
unicast-ranging} Example:
The cable modem <mac_addr> l2vpn-map command maps a modem MAC address
to a VLAN for Layer 2 VPN (L2VPN).
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to remove the CM properties.
Mode
(config)#
Syntax
cable modem <mac_addr> 12vpn-map <1:4094> [vpnid <id>]
no cable modem <mac_addr> l2vpn-map
Properties
Property name Description
Example:
The cable modem <mac_addr> mpls vpnid command maps a MAC address to a
Multi-Protocol Label Switching (MPLS) VPN.
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to remove the CM properties.
Modes
(config)#
Syntax
cable modem <mac_addr> mpls vpnid <id>
no cable modem <mac_addr> mpls
Properties
Property name Description
Example:
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to remove the CM properties.
Mode
(config)#
Syntax
[no] cable modem <mac_addr> qos-override {ds-service-class |
us-service-class} <name>
Properties
Property name Description
Example:
In the Casa enable or configuration mode, using the command keeps you in that mode.
There is no no form of the command.
Modes
#
(config)#
Syntax
cable modem <mac_addr> ucc upstream <1:255>
Properties
Property name Description
Example:
The cable modem authorization command sets cable modem authorization for a
specific modem based on a Source Address Verification (SAV) configuration rule.
Note that the command can override DOCSIS MAC dhcp-authorization and allow
CPEs behind specific CMs to be configured with specific IP addresses to access the
network.
The command is executable in configuration mode. Use the no form of the command
to remove the CM properties.
Mode
(config)#
Syntax
cable modem authorization <mac_addr> <sav_cfg_list_name>
no cable modem authorization <mac_addr>
Properties
Property name Description
Example:
The cable modem deny command denies service to a specific modem. Up to 512
cable modems can be specified in a list that denies certain modems from registering
with the CMTS.
The command is executable in configuration mode. Use the no form of the command
to remove the CM properties.
Mode
(config)#
Syntax
[no] cable modem deny <mac_addr>
Properties
Property name Description
Example:
The command is executable in configuration mode. Use the no form of the command
to remove the CM properties.
Mode
(config)#
Syntax
cable modem excessive-request detection grant-assigned <100:65535>
packet-recv <1:32767>
no cable modem excessive-request detection
Properties
Property name Description
Example:
The cable modem offline aging command clears modems that have previously
registered with the CMTS but have been off line for a specified number of hours. If set
to 0 (the default), the modem maintains an off-line state indefinitely and is not cleared.
If set to a value in the range 1 to 8760 hours (1 year), the CMTS clears all modems
that have been offline for the specified number of hours.
Mode
(config)#
Syntax
cable modem offline aging <0:8760>
Properties
Property name Description
Example:
The cable modem remote-query command sets the remote query polling interval.
The command is executable in configuration mode. Use the no form of the command
to remove the CM properties. Remote query is not enabled by default.
Mode
(config)#
Syntax
[no] cable modem remote-query {<0 | 30:1800> [<snmp_comm>] | loopback
[0:15]}
Properties
Property name Description
Example:
The command is executable in configuration mode. Use the no form of the command
to remove the CM properties.
Mode
(config)#
Syntax
[no] cable modem rip authentication-bypass <mac_addr> <mask>
Properties
Property name Description
Example:
The cable modem vendor command adds user-defined cable modem vendor
information or modifies the system default CM vendor. (See also the default cable
modem vendor command.)
The command is executable in configuration mode. Use the no form of the command
to remove the CM properties.
Mode
(config)#
Syntax
cable modem vendor <oui> <name>
no cable modem vendor <oui>
Properties
Property name Description
Example:
Polls on the fly to show details on all cable modems. (See also the Related show
commands in Chapter 2, Baseline Privacy Interface.)
Shows cable modem statistics, including pending upstream byte statistics (best-effort,
guarantee, total). Use this option when there is high upstream utilization, but with low
throughput. This may indicate a modem that is receiving upstream transmission
grants, but is not sending upstream data.
Shows cable modem maintenance ranging information. Ensure that there are no
differences in internal clock times.
Shows downstream cable total and used bytes per downstream channel.
cm-ctrl
Purpose
Modes
#
(config)#
Syntax
cm-ctrl <mac_addr> {cm-reinit | disable-forwarding {0|1} |
event_ds_mask <1:255> | event_mask <0:ffff> | event_us_mask
<1:255> | mute <0:255> <1:65535>}
Properties
Property name Description
Properties
Property name Description
Example:
The default cable modem vendor command sets a system default vendor.
In the Casa configuration mode, using the command leaves you in that mode. There is
no no form of the command.
Mode
(config)#
Syntax
default cable modem vendor <oui>
Properties
Property name Description
Example:
In the example of a network with eight downstream channels, even though the modem
supports only four downstream and four upstream channels, the modem 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
modem channel set. A service group is simply a group of channels.
Similarly, the set of upstream channels is called the upstream service group (US-SG).
Collectively, the upstream and downstream service groups 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 cable modem service group
(MD-CM-SG).
In order for the Casa CMTS to operate in channel bonding mode, the DOCSIS MAC
interface must be configured, as well as a service group with at least one downstream
channel and one upstream channel. For cable modems that support channel bonding
operation, the Casa CMTS automatically creates channel bonding groups with
channels that belong to the same service group, and the same DOCSIS MAC
interface. The Casa CMTS supports channel bonding in the same line card module.
The maximum number of downstream channels per QAM module is 32, and the
maximum number of upstream channels per DOCSIS Control and Upstream (DCU)
module is 32.
Configuration example
In the following example, one service group is formed with 16 downstream and 8
upstream channels from the same downstream/upstream modules, with two MAC
domain interfaces created within the service group. Each domain contains 8
downstream and 4 upstream channels. The channel bonding then occurs inside each of
the domains, or 8 downstream and 4 upstream channels.
Configuration summary
Table 5-1 lists and briefly describes the objects related to channel bonding.
bonding-group
Purpose
In networks where traffic from a particular modem or service area must use a specific
downstream or upstream channel, upstream and downstream bonding groups can be
configured using the bonding-group object to direct traffic streams to specific
channels configured at the CMTS. This means that the CMTS uses the 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. Up to 480 upstream bonding groups can be configured.
Casa highly recommends the dynamic service group configuration over the static
bonding group configuration, which should only be used in very specific cases where
dynamic channel selection is not feasible.
Note: Service groups are required for cable traffic load balancing and for channel
bonding over D3.0 modems. Service groups are not required for cable modems
to register and come up only as long as upstream and downstream channels are
configured in the DOCSIS MAC domain.
In the Casa configuration mode, using the command takes you to downstream
(bond-ds-mac-x-group-x) or upstream (bond-us-mac-x-group-x) bonding-group
configuration mode. Use the no form of the command to remove the bonding group.
Modes
(config)#
(bond-ds-mac-x-group-x)#
(bond-us-mac-x-group-x)#
Syntax
(config)#
[no] bonding-group downstream mac-domain <1:96> group-id <1:65535>
[no] bonding-group upstream mac-domain <1:96> group-id <1:65535>
(bond-ds-mac-x-group-x)#
prov-attr-mask <0x0:0xFFFFFFFF>
[no] qam <slot>/<port>/<chan>
reseq wait-time <255 | 0:180>
reseq warn-thrshld <255 | 0:179>
(bond-us-mac-x-group-x)#
prov-attr-mask <0x0:0xFFFFFFFF>
[no] upstream <slot>/<port>.<chan>/<log_chan>
Properties
Property name Description
Example:
upstream mac-domain <1:96> Adds a static upstream CM bonding group, with the
group-id <1:65535> MAC domain and group IDs, with a maximum 480
upstream groups.
Example:
Properties
Property name Description
Example:
CASA(bond-ds-mac-30-group-100)#
prov-attr-mask 0x0
Example:
CASA(bond-ds-mac-30-group-100)#
qam 0/2/1
CASA(bond-ds-mac-30-group-100)#
no qam 0/2/1
Example:
CASA(bond-ds-mac-30-group-100)#
reseq wait-time 255
Properties
Property name Description
Example:
CASA(bond-ds-mac-30-group-100)#
reseq warn-thrshld 255
Example:
CASA(bond-us-mac-30-group-100)#
upstream 13/0.0/0
CASA(bond-us-mac-30-group-100)#
no upstream 13/0.0/0
interface docsis-mac
upstream channel bonding
downstream channel bonding
initial-tech
max sid-cluster per-service-flow
sid-cluster
interface qam
interleave 8
modulation 256qam
The CMTS should have the interface qam configurations to get maximum throughput
on channel bonding and non-bonding cable modems. The downstream QAM interface
channel interleave should be 8 and the channel modulation type should be set to
256qam.
Shows the configured bonding groups. Output can also be for downstream or
upstream (and optionally filtered by group-id) or a particular MAC domain.
dbg_id_set qam
Purpose
The dbg_id_set qam command configures a downstream bonding group (DBG) for a
CM. The properties require entering, in succession, a QAM slot number, CM number,
and DBG ID.
In the Casa configuration mode, using the command leaves you in configuration
mode. Use the no form of the command to remove the DBG from the CM.
Mode
(config)#
Syntax
dbg_id_set qam <slot> cm <0:16384> dbg <17:48>
no dbg_id_set qam <slot> cm <0:16384>
Properties
Property name Description
Example:
CASA(config)# dbg_id_set
qam 0 cm 1 dbg 17
CASA(config)# no dbg_id_set qam 0 cm 1
rcc
Purpose
The rcc command sets up the Receive Channel Configuration (RCC) for downstream
channel bonding to the CM. RCC is used for downstream channel bonding of 16
channels in earlier Casa releases that do not support channel bonding.
In the Casa configuration mode, using the command with the three entries puts you in
RCC configuration (conf-mac rcc) mode. Use the no form of the command to remove
the properties.
Modes
(config)#
(conf-mac <id> rcc <id>)#
Syntax
(config)#
[no] rcc mac <1:96> rcp-id <string> <1:4294967295>
Properties
Property name Description
Example:
Example:
Properties
Property name Description
Example:
Example:
rcp
Purpose
The rcp command sets up the Receive Channel Profile (RCP) for downstream channel
bonding to the CM.
In the Casa configuration mode, using the command puts you in RCP configuration
mode. Use the no form of the command to remove the profile.
Mode
(config)#
(rcp xx:xx:xx:xx:xx)#
Syntax
[no] rcp <string>
(rcp xx:xx:xx:xx:xx)#
rc <1:32> {primary | secondary} connect <1:16>
no rc <1:32>
[no] rcp <string>
[no] rcp-description [<text>]
rm <1:16> channels <0:64> [min-freq <111000000:999000000> max-freq
<111000000:999000000>]
no rm <1:16>
vendor-specific {spacing6 | spacing8}
Properties
Property name Description
Example:
Properties
Property name Description
Example:
Example:
CASA(rcp 00:10:00:10:02)#
rcp-description spacing 6
CASA(rcp 00:10:00:10:02)#
no rcp-description
Example:
Properties
Property name Description
Example:
CASA(rcp 00:10:00:10:02)#
vendor-specific spacing6
show rcp-list
service group
Purpose
The service group command configures a service group for channel bonding. A
service group is a collection of upstream and downstream channels that is allocated to
a single fiber node that supports a given service area. A service group can be bound to
an upstream or downstream interface.
Creating a service group puts you in the Casa service-group configuration mode.
Note: Service groups are required for cable traffic load balancing and for channel
bonding over D3.0 modems. Service groups are NOT required for cable
modems to register and come up only as long as upstream and downstream
channels are configured in the DOCSIS MAC domain.
Modes
(config)#
(conf-svc-grp <name>)#
Syntax
(config)# [no] service group <name>
(conf-svc-grp x)#
[no] description <text>
[no] downstream channel bonding
[no] qam <slot>/<port>/<chan>
[no] upstream <slot>/<port>.<pchan>
[no] upstream channel bonding
Properties
Property name Description
Example:
Example:
Example:
Example:
Properties
Property name Description
Example:
upstream channel bonding Enables upstream channel bonding from the service
group configuration. Channel bonding must be
enabled from both the Related show commands
and service group configurations.
Example:
Note: If service groups are configured or changed while the modems are online, the
CMTS can lose track of them and it will be necessary to reset them (or reboot
the CMTS). When the CMTS does not know which service group a modem
belongs to, it writes the following messages to the ddm_log:
show md-ds-sg
Shows the service group information for a specific MAC domain upstream service
group.
Configuration summary
Table 6-1 lists and briefly describes the objects related to channel blocks.
In the Casa configuration mode, creating the channel block takes you to channel-block
configuration mode identifying the MAC domain and block ID. Use the no form of
the command to remove the channel block.
Modes
(config)#
(chan-block-mac-x-block-y)#
Syntax
(config)#
[no] channel-block downstream mac-domain <1:96> block-id <1:65535>
(chan-block-mac-x-block-y)#
prov-attr-mask <0x0:0xffffffff>
[no] qam <slot>/<port>/<chan>
Properties
Property name Description
<1:96> block-id <1:65535> Creates the channel block with a MAC domain ID and
block ID. This sets you in channel block configuration
mode.
Example:
Properties
Property name Description
Example:
CASA(chan-block-mac-1-block-1)#
prov-attr-mask 0x0
Example:
CASA(chan-block-mac-1-block-1)#
qam 1/7/4
CASA(chan-block-mac-1-block-1)#
no qam 1/7/4
Shows the channel block configuration. The output can be filtered by downstream,
MAC domain ID, or block ID.
channel-utilization-interval
Purpose
The channel-utilization-interval command sets the interval over which the channel
utilization information is collected and averaged.
In the Casa configuration mode, creating the interval leaves you in that mode. There is
no no form of the command.
Mode
(config)#
Syntax
channel-utilization-interval <0:86400>
Properties
Property name Description
Example:
CASA(config)#
channel-utilization-interval 86400
show channel-utilization-interval
Configuration summary
Table 7-1 lists and briefly describes the objects related to CPE classes.
cpe-class
Purpose
The cpe-class command defines a CPE class grouping by specifying any number of
DHCP option 60 strings that the CMTS will match to configured DHCP server IPs.
In the Casa configuration mode, creating the CPE class puts you in CPE configuration
(conf-cpe-class) mode. Use the no form of the command to remove the CPE class.
Modes
(config)#
(config-cpe-class <name>)#
Syntax
(config)# [no] cpe-class <name>
(config-cpe-class <name>)#
[no] dhcp option 60 <text>
Properties
Property name Description
Example:
Properties
Property name Description
Example:
Example
In the following CLI session, the cpe-class command defines two CPE classes,
setTopBoxes and computers. In the example, stbUser1 and pcUser1 are the
expected DHCP option 60 strings from the CPEs. The CMTS will check the IP bundle
and cable helper address (DHCP server address) CPE classes for the matching strings.
The CPE device with DHCP option 60 string stbUser1 gets its IP address from the
DHCP server at IP 192.168.3.16. Similarly, the CPE device with DHCP option 60
string pcUser1 gets its IP address from the DHCP server at 192.168.3.17.
show cpe-class
cpe-class "computers"
dhcp option 60 "pcUser1"
cpe-class "setTopBoxes"
dhcp option 60 "stbUser1"
Configuration summary
Table 8-1 lists and briefly describes the objects related to DOCSIS MAC interface.
interface docsis-mac
Purpose
Note: The maximum number of available DOCSIS MAC interfaces depends on the
Casa CMTS system, but the absolute maximum number across all systems is 96.
In the Casa configuration mode, using the command moves you into DOCSIS MAC
interface configuration (conf-if-mac) mode for the specific MAC domain number. Use
the no form of the command or its subcommand to remove the DOCSIS MAC
interface or its corresponding secondary object.
Modes
(config)#
(conf-if-mac <num>)#
Syntax
(config)# [no] interface docsis-mac <1:96>
(conf-if-mac x)#
[no] battery backup
[no] cable cm-status {event <1:11> {max-timer <1:1310> max-number
<0:255>} | report event-list <list>}
[no] cm trap [interval <0:86400> | online-offline-only]
[no] cm-status event report
[no] description <text>
[no] dhcp-authorization
[no] dhcp-giaddr-primary
[no] dhcp-insert {circuit-id upstream-description |
downstream-description | hostname | service-class |
upstream-description | upstream-description-mac}
[no] downstream <1:255> interface qam <slot>/<port>/<0:3>
[secondary]
[no] downstream channel bonding
Properties
Property name Description
Example:
battery backup Enables DBC to make the modem enter 1x1 mode
when operating on battery backup.
Example:
Properties
Property name Description
cable cm-status {event Sets parameters for showing cable events based on
<1:11> {max-timer event codes, or a comma-separated report event list.
<1:1310> max-number There is no no form of the parameter settings. The
<0:255>} | report event parameters and codes are as follows:
event-list <list>}
max-timer <1:1310> Maximum event timer, in
seconds.
max-number <0:255> Maximum number of
events; 0 means no limit.
1 Secondary channel MDD timeout.
2 QAM/FEC lock failure.
3 Sequence out-of-range.
4 Secondary channel MDD recovery.
5 QAM/FEC lock recovery.
6 T4 timeout.
7 T3 retries exceeded.
8 Successful ranging after T3 retries
exceeded.
9 CM operating on battery backup.
10 CM returned to AC power.
11 MAC address removed.
Example:
Properties
Property name Description
cm trap [interval Enables CMTS trap generation any time there are
<0:86400> | changes to the cable modem (CM) status over a
online-offline-only] DOCSIS-MAC interface. An optional time interval
controls the minimum time to elapse between CMTS
trap notifications, or you can set an option to set traps
only when the CM goes online or offline within the
interval. The default is 600 seconds (10 minutes).
Example:
cm-status event report Enables showing the status of a CMTS event report.
Example:
Example:
Properties
Property name Description
Example:
Example:
CASA(conf-if-mac 1)#
dhcp-giaddr-primary
CASA(conf-if-mac 1)#
no dhcp-giaddr-primary
Properties
Property name Description
Example:
Properties
Property name Description
Example:
Example:
Properties
Property name Description
Example:
CASA(conf-if-mac 1)#
early-authentication-encryption
capability
CASA(conf-if-mac 1)#
no early-authentication-encryption
Properties
Property name Description
Example:
broadcast-ranging [ranging-parameters]
Instructs D3.0 modems to move to new channels
during broadcast ranging (the default).
direct Instructs D3.0 CMs to move to new
channels directly.
period-ranging Instructs D3.0 modems to
move to new channels during period ranging.
unicast-ranging Instructs D3.0 modems to
move to new channels during unicast ranging.
Example:
Example:
Properties
Property name Description
Example:
CASA(conf-if-mac 1)#
invited-ranging-attempts 100
CASA(conf-if-mac 1)#
no invited-ranging-attempts
Example:
Example:
CASA(conf-if-mac 1)#
ip-provisioning-mode ipv4-only
Properties
Property name Description
Example:
mdd interval <0:2000> Interval for the MAC Domain Descriptor (MDD) that
includes the downstream service groups in the MAC
domain and the upstream ambiguity resolution
channel, in milliseconds, with 0 disabling the MDD.
Example:
Properties
Property name Description
Example:
Properties
Property name Description
Example:
CASA(conf-if-mac 1)#
multicast-dsid-forward wb-cm-only
CASA(conf-if-mac 1)#
no multicast-dsid-forward
CASA(conf-if-mac 1)#
no multicast-dsid-forward dsg
privacy {kek | tek} Key Encryption Key (KEK) or Traffic Encryption Key
life-time <1:604800> (TEK) lifetime on MAC domain interfaces for the
Baseline Privacy Interface (BPI). The lifetime is in
seconds.
Example:
Properties
Property name Description
Example:
CASA(conf-if-mac 1)#
router-advertisement enable
CASA(conf-if-mac 1)#
no router-advertisement enable
Properties
Property name Description
Example:
Properties
Property name Description
Example:
CASA(conf-if-mac 1)#
shared-secondary-secret 1 7 3155ff
CASA(conf-if-mac 1)#
no shared-secondary-secret 1
Properties
Property name Description
shared-secret <0|7> With the shared secret configured, the cable modem
<mic_string> [extend] must authenticate using either the primary or
secondary password for the modem to register and
come online. The CMTS supports a maximum of 198
shared secrets (primary, secondary, and primary/
secondary extended). The required parameters are
as follows:
Example:
Example:
Properties
Property name Description
Example:
Example:
Properties
Property name Description
Example:
Example:
Example:
Properties
Property name Description
Example:
Example:
Properties
Property name Description
upstream drop classifier Enables the Upstream Drop Classifier (UDC), which
has a set of matching criteria applied by the CMs to
packets to determine if a packet should be dropped
on upstream traffic.
Example:
Example:
Shows the utilization rates of all the downstream channels in the system.
Shows all downstream channel sets. You can also filter by id and mac-domain.
1. Set up the tunnel group. This defines the mapping between a tunnel to
downstream channels and DSG rule-related data.
2. Define the DSG tunnel ID.
3. Define the tunnel destination MAC address.
4. Define the service class, if any.
5. Define the client list for DCD messages.
6. Define the classifier.
7. Configure the DCD parameters.
8. Configure the DSD message configuration and enable it on a QAM interface.
Configuration steps
To use the DSG feature, first complete the basic CMTS configuration and then
configure the DSG feature, as follows:
6. Set up the tunnel group. This defines the mapping between a tunnel to
downstream channels and DSG rule-related data.
CASA(config)# dsg tunnel-group 1
CASA(conf-dsg-tunnel-grp-1)# dsg chan 1 qam 0/0/0 rule-priority 20
CASA(conf-dsg-tunnel-grp-1)# dsg chan 2 qam 0/0/1 rule-priority 20
CASA(conf-dsg-tunnel-grp-1)# dsg chan 3 qam 0/0/2 rule-priority 11
CASA(conf-dsg-tunnel-grp-1)# dsg chan 4 qam 0/0/3 rule-priority 11
13. Configure the DSD message configuration and enable it on a QAM interface.
CASA(config)# interface qam 0/0
CASA(conf-if-qam 0/0)# channel 0 dsg channel-list 1
CASA(conf-if-qam 0/0)# channel 0 dsg timer-id 1
CASA(conf-if-qam 0/0)# channel 0 dsg vendor-param-id 1
CASA(conf-if-qam 0/0)# channel 0 dsg interval 5
CASA(conf-if-qam 0/0)# channel 0 dsg dcd-enable
Configuration summary
Table 9-1 lists and briefly describes the objects related to DSG.
dsg channel-list
Purpose
The dsg channel-list command creates a DOCSIS Set-Top Gateway (DSG) channel
list. This channel list can then be assigned to a downstream channel.
In the Casa configuration mode, defining the command leaves you in configuration
mode. Use the no form of the command to remove the channel list.
Mode
(config)#
Syntax
dsg channel-list <1:4294967295> channel <1:4294967295> frequency
<0:1000000000>
no dsg channel-list <1:4294967295> channel <1:4294967295>
Properties
Property name Description
Example:
interface qam
dsg channel <id> channel-list <id>
Assigns a DSG channel list to a downstream channel. (See the interface qam
command.)
dsg client-list
Purpose
The dsg client-list command creates a DSG client list. This client list can then be
assigned to a DSG tunnel.
In the Casa configuration mode, defining the command leaves you in configuration
mode. Use the no form of the command to remove the client list.
Mode
(config)#
Syntax
dsg client-list <1:4294967295> client <1:4294967295> id-type {appId
id-value <0:65535> | broadcast id-value <1:65535> | caSysId
id-value <0:65535> | macAddr id-value <mac_addr}
[vendor-param-id <1:4294967295>]
no dsg client-list <1:4294967295> client <1:4294967295>
Properties
Property name Description
Example:
Properties
Property name Description
Example:
dsg dcd-global-enable
Purpose
In the Casa configuration mode, defining the command leaves you in configuration
mode. Use the no form of the command to disable the property.
Mode
(config)#
Syntax
[no] dsg dcd-global-enable
dsg timer-id
Purpose
The dsg timer-id command sets the DSG timer. The DSG timer entry is linked with
the downstream channel and is encoded into the DCD message.
In the Casa configuration mode, defining the command leaves you in configuration
mode. Use the no form of the command to remove the timer setting.
Mode
(config)#
Syntax
dsg timer-id <1:4294967295> t1 <1:65535> t2 <1:65535> t3 <1:65535>
t4 <1:65535>
no dsg timer-id <1:4294967295>
Properties
Property name Description
Example:
dsg tunnel
Purpose
The dsg command creates a DSG tunnel. The number of supported DSG replications
per chassis is 8192. Each QAM line card can have up to 1638 DSG replications.
In the Casa configuration mode, defining the command leaves you in configuration
mode. Use the no form of the command to remove the DSG tunnel.
Modes
(config)#
(conf-dsg-tunnel <id>)#
Syntax
(config)# [no] dsg tunnel <1:4294967295>
(conf-dsg-tunnel x)#
classifier <1:65535> <0:255> {<src_ip4/mask> | ipv6 <src_ip6/mask>}
<dst_ip> [indcd [<0:65535> <0:65535>]]
no classifier <1:65535>
[no] client-list <1:4294967295>
dst-address <mac_addr>
no dst-address
group <1:4294967295>
no group
service-class <name>
no service-class
Properties
Property name Description
Example:
Properties
Property name Description
Example:
Properties
Property name Description
dst-address <mac_addr> Destination MAC address for the DSG tunnel, in the
form xxxx.xxxx.xxxx.
Example:
Example:
Example:
Shows the cable DSG tunnel configuration. Output can also be filtered by ID, and then
by DSG classifier (CFRS), clients, interface, or verbose.
dsg tunnel-group
Purpose
The dsg tunnel-group command creates a DSG tunnel group. A DSG tunnel can then
be added to the tunnel group and you can associate a downstream channel with a DSG
tunnel group.
In the Casa configuration mode, defining the command leaves you in configuration
mode. Use the no form of the command to remove the DSG tunnel group.
Modes
(config)#
(conf-dsg-tunnel-grp <id>)#
Syntax
(config)# [no] dsg tunnel-group <1:4294967295>
(conf-dsg-tunnel-grp x)#
channel <1:4294967295> qam <slot>/<port>/<chan> [rule-priority
<0:255>] [ucid-list <string>] [vendor-param-id
<1:4294967295>]
no channel <1:4294967295>
Properties
Property name Description
Example:
Properties
Property name Description
dsg unicast-port
Purpose
In the Casa configuration mode, defining the command leaves you in configuration
mode. There is no no form of the command.
Mode
(config)#
Syntax
dsg unicast-port <1:65535>
Properties
Property name Description
Example:
Shows the DSG running configuration that includes the unicast port value.
dsg vendor-param-id
Purpose
In the Casa configuration mode, defining the command leaves you in configuration
mode. Use the no form of the command to remove the vendor parameters.
Mode
(config)#
Syntax
dsg vendor-param-id <1:4294967295> vendor <1:4294967295> oui <oui>
value <val>
no dsg vendor-param-id <1:4294967295> vendor <1:4294967295>
Properties
Property name Description
Example:
Each of the methods can further be operated in two types: static or dynamic.
Static Load balancing is done at ranging request time. When a cable modem
sends its initial ranging request message, the CMTS responds with a ranging
response message that includes either a Downstream Frequency Override or an
Upstream Channel ID Override field that instructs the cable modem which
channels it should use.
Dynamic A form of load balancing in which cable modems are moved among
upstream and downstream channels within the same service group after their
initial difference between two interfaces exceeds a user-defined percentage. The
CMTS will use DCC/UCC messages to move CMs with single upstream/
downstream channels and DBC (dynamic bonding change) messages to move
CMs with bonding upstream/downstream channels to different bonding groups.
For DOCSIS and EuroDOCSIS 3.0 modems, the dynamic load-balancing software
generates a downstream channel set with a minimum load to fit the modems RCP.
This prevents rejection of the new channel set so that load balancing is not canceled
when the assigned modem is under load. The Casa CMTS supports both methods and
types to load balance upstream and downstream channels. You can configure a Casa
CMTS using static load balancing only, or using static load balancing and dynamic
load balancing together.
Because load balancing can only be done to upstream and downstream interfaces
sharing the same physical connectivity, the upstream and downstream interfaces have
to belong to the same service group. Both channel bonding and non-channel bonding
modems can participate in load balancing. Channel bonding modems will count as one
CM for each of its channels.
To apply a load balancing policy globally, apply it to the default group. To apply
different load balancing policies to different MAC Domain/Service Groups, first
define the rules and the policies. Then create a restricted load balance group, and
assign it to the MAC Domain/Service group.
Configuration summary
Table 10-1 lists and briefly describes the objects related to load balancing.
load-balance
Purpose
The load-balance command configures load balancing for the CMTS. Configuring
load balancing requires the following steps:
In the Casa configuration mode, using the command brings you into a variety of
configuration modes depending on the context. These contexts are described in the
following commands.
Modes
(config)#
(load-bal-basic-rule x)#
(load-bal-exclusion-list)#
(load-bal-exe-rule x)#
(load-bal-general-mac-x-sg-x)#
(load-bal-policy x)#
(load-bal-restrict-cm x)#
(load-bal-restrict x)#
Shows the load balancing static configuration, the equivalent of the show static
load-balance command.
load-balance basic-rule
Purpose
The load-balance basic-rule command sets the basic rules for load balancing. The
DOCS-LOADBAL3-MIB defines the load balance basic rules. To configure the basic
rules, do the following:
In the Casa configuration mode, using the command takes you into load balancing
basic-rule configuration mode. Use the no form of the command to remove the basic
rule.
Modes
(config)#
(load-bal-basic-rule <id>)#
Syntax
(config)# [no] load-balance basic rule <1:4294967295>
(load-bal-basic-rule x)#
[no] enable
suspend-load-balance from <start_time> to <end_time>
Properties
Property name Description
Example:
Properties
Property name Description
Example:
suspend-load-balance Sets a basic rule for a time period (from and to) to
from <start_time> to suspend load balancing, in H:MM:SS or HH:MM:SS
<end_time> format. There is no no form of the command.
Example:
CASA(load-bal-basic-rule 1)#
suspend-load-balance from 12:30:00 to
15:00:00
load-balance basic-rule 1
suspend-load-balance from 12:30:00 to 15:00:00
load-balance enable
Purpose
The load-balance enable command enables the load balancing function globally.
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
MAC domain of the selected upstream channel. If the downstream precedence is
configured, then the downstream channel is selected first.
The CMTS uses downstream frequency override and the upstream channel ID
override in the ranging response message to move modems to a different MAC
domain if needed. This applies to all DOCSIS 1.0, 1.1, 2.0 and 3.0 modems. The SID
in the ranging response message is 0x3fff.
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to disable load balancing globally.
Mode
(config)#
Syntax
[no] load-balance enable
[no] load-balance enable across-mac [downstream]
Properties
Property name Description
Example:
Properties
Property name Description
Example:
load-balance enable
load-balance basic-rule 1
suspend-load-balance from 12:30:00 to 13:00:00
The load-balance exclusion list command sets exclusions for load balancing.
In the Casa configuration mode, using the command takes you into load balancing
exclusion-list configuration mode. Use the no form of the command to remove the
exclusion list.
Modes
(config)#
(load-bal-exclusion-list)#
Syntax
(config)# [no] load balance exclusion list
(load-bal-exclusion-list)#
[no] mac addr <mac_addr> mask <mask> [both | dynamic | static]
Properties
Property name Description
mac addr <mac_addr> mask MAC address and mask for the exclusion list, in
<mask> [both | dynamic | xxxx.xxxx.xxxx hex format, to apply the exclusion list
static] to modems from a particular modem vendor. One of
the optional modifiers excludes the cable modem
from both dynamic and static load balancing, from
just dynamic load balancing, or from just static load
balancing.
Example:
load-balance execution-rule
Purpose
The load-balance execution-rule command sets execution rules for load balancing,
with up to 16 execution rules allowed. Note that an execution rule is always enabled;
there is no command to disable it. Define execution rules as follows:
In the Casa configuration mode, using the command takes you into load balancing
execution-rule configuration mode. Use the no form of the command to remove the
execution rule.
Modes
(config)#
(load-bal-exe-rule <id>)#
Syntax
(config)# [no] load-balance execution-rule <1:16>
(load-bal-exe-rule x)#
cable modem rebalance-interval <60:3600>
no cable modem rebalance-interval
cable modem retry-interval first <0:4294967295> second
<0:4294967295>
no cable modem retry-interval
[no] enable
interval <10:3600>
method {modem | utilization} [dynamic]
no method [dynamic]
suspicious-channel retry interval <0:86400>
threshold load <0:100> [enforce <0:100>] [dynamic minimum <2:500> |
minimum <2:500>]
no threshold
upstream-interval <10:3600>
no upstream-interval
upstream-method {modem | utilization} [dynamic]
no upstream-method [dynamic]
upstream-threshold load <0:100> [enforce <0:100>] [dynamic minimum
<2:500> | minimum <2:500>]
no upstream-threshold
Properties
Property name Description
Example:
CASA(config)# load-balance
execution-rule 5
CASA(config)#
no load-balance execution-rule 5
Example:
Example:
Properties
Property name Description
Example:
Example:
Example:
Properties
Property name Description
Example:
CASA(load-bal-exe-rule 5)#
suspicious-channel retry interval 3600
threshold load <0:100> Load difference between interfaces to start static load
[enforce <0:100>] balancing, the number of modems on the modem
[dynamic minimum <2:500> method or the percentage on the utilization method,
| minimum <2:500>] default 10. The optional additional modifiers are as
follows:
Example:
Properties
Property name Description
Example:
CASA(load-bal-exe-rule 5)#
upstream-interval 60
CASA(load-bal-exe-rule 5)#
no upstream-interval 60
Example:
CASA(load-bal-exe-rule 5)#
upstream-method modem dynamic
CASA(load-bal-exe-rule 5)#
no upstream-method dynamic
CASA(load-bal-exe-rule 5)#
no upstream-method
CASA(load-bal-exe-rule 5)#
upstream-threshold load 100
CASA(load-bal-exe-rule 5)#
no upstream-threshold
load-balance execution-rule 1
method modem
threshold load 100 dynamic minimum 2
load-balance general-group
Purpose
In the Casa configuration mode, using the command takes you into either load
balancing general default or MAC service-group configuration mode. Use the no form
of the command to remove the load balancing general group.
Modes
(config)#
(load-bal-general-default)#
(load-bal-general-mac-<id>-sg-<name>)#
Syntax
(config)#
load-balance general-group default-settings
(load-bal-general-default)#
[no] enable
initial-tech {broadcast-ranging | direct [frequency-limit <0:60>] |
period-ranging | reinitialize-mac | unicast-ranging}
policy-id <0:4294967295>
(config)#
[no] load-balance general-group mac-domain <1:96> service-group <name>
(load-bal-general-mac-x-sg-y)#
[no] enable
initial-tech {broadcast-ranging | direct [frequency-limit <0:60>] |
period-ranging | reinitialize-mac | unicast-ranging}
policy-id <0:4294967295>
Properties
Property name Description
Example:
CASA(config)# load-balance
general-group default-settings
CASA(load-bal-general-default)#
Example:
CASA(load-bal-general-default)# enable
CASA(load-bal-general-default)#
no enable
Properties
Property name Description
Example:
CASA(load-bal-general-default)#
initial-tech broadcast-ranging
Properties
Property name Description
policy-id <0:4294967295> Sets the load-balance policy for the load balancing
general group. The default for the load-balance
general-group is no policy-id. There is no no form of
the command.
Example:
CASA(load-bal-general-default)#
policy-id 2
Example:
CASA(config)# load-balance
general-group mac-domain 1
service-group FN_A
CASA(config)# no load-balance
general-group mac-domain 1
service-group FN_A
CASA(load-bal-general-mac-1-sg-FN_A)#
Example:
CASA(load-bal-general-mac-1-sg-FN_A)#
enable
CASA(load-bal-general-mac-1-sg-FN_A)#
no enable
Properties
Property name Description
Example:
CASA(load-bal-general-mac-1-sg-FN_A)#
initial-tech broadcast-ranging
Example:
CASA(load-bal-general-mac-1-sg-FN_A)#
policy-id 2
In the Casa configuration mode, using the command keeps you in that mode. Use the
no form of the command to disallow DBC for load balancing.
Mode
(config)#
Syntax
[no] load-balance permit dbc-chg-prim-ds
load-balance policy
Purpose
The load-balance policy command sets policies for load balancing. To set a policy:
In the Casa configuration mode, using the command takes you into load balancing
policy configuration mode. Use the no form of the command to remove the load
balancing policy.
Modes
(config)#
(load-bal-policy <id>)#
Syntax
(config)# [no] load-balance policy <1:4294967295>
(load-bal-policy x)#
[no] rule basic <1:4294967295>
rule execution <1:16>
no rule execution
Properties
Property name Description
Example:
Properties
Property name Description
Example:
Example:
CASA(load-bal-policy 1)#
rule execution 1
CASA(load-bal-policy 1)#
no rule execution
load-balance policy 1
rule execution 1
rule basic 1
rule basic 2
load-balance restricted-cm
Purpose
In the Casa configuration mode, using the command takes you into load balancing
restrict-CM configuration mode. Use the no form of the command to remove the CM
restriction.
Modes
(config)#
(load-bal-restrict-cm <id>)#
Syntax
(config)# [no] load-balance restricted-cm <1:4294967295>
(load-bal-restrict-cm x)#
mac addr <addr> [mask <mask>]
restricted-load-balance- group <1:4294967295>
no restricted-load-balance-group
service-type-id <name>
no service-type-id
Properties
Property name Description
Example:
CASA(config)# load-balance
restricted-cm 1
CASA(load-bal-restrict-cm 1)# exit
CASA(config)#
no load-balance restricted-cm 1
mac addr <addr> [mask MAC address of the modem, in 48-bit xxxx.xxxx.xxxx
<mask>] format, and optional mask (if omitted, defaults to
FFFF.FFFF.FFFF). There is no no form of the
command.
Example:
CASA(load-bal-restrict-cm 1)#
restricted-load-balance-group 1
CASA(load-bal-restrict-cm 1)#
no restricted-load-balance-group
Example:
CASA(load-bal-restrict-cm 1)#
service-type-id plant1
CASA(load-bal-restrict-cm 1)#
no service-type-id
load-balance restricted-cm 1
mac addr 0022.2d77.fc56
load-balance restricted-group
Purpose
In the Casa configuration mode, using the command takes you into load balancing
restricted-group configuration mode. Use the no form of the command to remove the
group restriction.
Modes
(config)#
(load-bal-restrict <id>)#
Syntax
(config)# [no] load-balance restricted-group <1:4294967295>
(load-bal-restrict x)#
docsis-mac <1:96>
[no] enable
initial-tech {broadcast-ranging | direct [frequency-limit <0:60>] |
period-ranging | reinitialize-mac | unicast-ranging}
policy-id <0:4294967295>
[no] qam <slot>/<port>/<chan>
[no] service-type-id <name>
[no] upstream <slot>/<port>.<chan>/<log_chan>
Properties
Property name Description
Example:
CASA(config)# load-balance
restricted-group 1
CASA(load-bal-restrict 1)# exit
CASA(config)#
no load-balance restricted-group 1
Example:
Example:
Properties
Property name Description
Example:
policy-id <0:4294967295> Sets the load-balance policy for the load balancing
restricted group. There is no no form of the
command.
Example:
Properties
Property name Description
Example:
Example:
CASA(load-bal-restrict 1)#
service-type-id plant1
CASA(load-bal-restrict 1)#
no service-type-id plant1
Example:
Configuration summary
Table 11-1 lists and briefly describes the objects related to modulation profiles.
modulation-profile
Purpose
There are five Predefined modulation profiles. This means that any new ones added
have an ID of 6 or higher. The predefined profiles are recommended. However, you
can use the predefined profiles to create profiles in auto mode, which is by simply
specifying the operation mode and modulation type when creating the profile. For
example, specifying qpsk creates a profile the same as predefined modulation profile
1; specifying 16qam creates a profile the same as predefined modulation profile 2.
In the Casa configuration mode, using the command takes you to modulation-profile
configuration mode. Use the no form to remove the modulation profile.
If all modems are running DOCSIS 2.0 or 3.0, use Asynchronous Time Division
Multiple Access (ATDMA) mode.
If the upstream interface has 1.1 or 1.0 modems and 2.0 or 3.0 modems, use
Modified Time Division Multiple Access (MTDMA) mode.
If all modems are 1.0 or 1.1, use Time Division Multiple Access (TDM) mode.
Mode
(config)#
Syntax
(config)#
[no] modulation-profile <6:1024> [<operation_mode>]
[<modulation_type>]
(config-mod-profile-<id>)#
a-long
a-short
initial
long
request
short
station
ugs
Properties
Property name Description
Example:
CASA(config)# modulation-profile 10
CASA(config-mod-prof-10)# exit
CASA(config)# no modulation-profile 10
Properties
Property name Description
Example:
CASA(config)#
modulation-profile 10 tdma
CASA(config-mod-prof-10)#
Properties
Property name Description
Example:
CASA(config)#
modulation-profile 10 tdma qpsk
CASA(config-mod-prof-10)#
modulation-profile 2
-->> Similar to profile 1 except uses 16qam for short and long data
burst types for TDMA upstream channels.
request tdma qpsk off 64 0 16 338 0 16 fixed on
initial tdma qpsk off 640 5 34 338 0 48 fixed on
station tdma qpsk off 384 5 34 338 0 48 fixed on
short tdma 16qam off 168 6 75 338 7 16 shortened on
long tdma 16qam off 192 8 220 338 0 16 shortened on
modulation-profile 3
-->> ATDMA type profile; uses QPSK for management bursts, 64qam for
data traffic.
request atdma qpsk off 64 0 16 338 0 16 fixed on 1 1536 qpsk0
initial atdma qpsk off 640 5 34 338 0 48 fixed on 1 1536 qpsk0
station atdma qpsk off 384 5 34 338 0 48 fixed on 1 1536 qpsk0
a-short atdma 64qam off 104 12 75 338 6 16 shortened on 1 1536 qpsk1
a-long atdma 64qam off 104 16 220 338 0 16 shortened on 1 1536 qpsk1
modulation-profile 4
-->> MTDMA type profile; uses QPSK for management bursts, 16qam for
TDMA data traffic, 64qam for ATDMA data traffic.
request mtdma qpsk off 64 0 16 338 0 16 fixed on 1 1536 qpsk0
initial mtdma qpsk off 640 5 34 338 0 48 fixed on 1 1536 qpsk0
station mtdma qpsk off 384 5 34 338 0 48 fixed on 1 1536 qpsk0
short mtdma 16qam off 168 6 75 338 7 16 shortened on 1 1536 qpsk1
long mtdma 16qam off 192 8 220 338 0 16 shortened on 1 1536 qpsk1
a-short mtdma 64qam off 104 12 75 338 6 16 shortened on 1 1536 qpsk1
a-long mtdma 64qam off 104 16 220 338 0 16 shortened on 1 1536 qpsk1
modulation-profile 5
-->> SCDMA type profile; uses QPSK for management bursts, 128qam for
SCDMA data traffic.
request scdma qpsk off 64 0 16 338 1 0 fixed on qpsk0 on 2 1 off
initial scdma qpsk off 640 5 34 338 0 0 fixed on qpsk0 off 2 1 off
station scdma qpsk off 512 5 34 338 0 0 fixed on qpsk0 off 2 1 off
a-short scdma 128qam off 64 5 33 338 12 0 shortened on qpsk0 on 128 1
on
a-long scdma 128qam off 64 10 156 338 0 0 shortened on qpsk0 on 128 1
on
a-long
Purpose
The a-long command configures a modulation profile for an a-long data grant used
for transmitting large upstream data in DOCSIS 2.0 and 3.0.
Mode
(config-mod-profile-<id>)#
Syntax
a-long <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
atdma
mtdma
scdma
<modulation_type> One of the modulation types described in the
<modulation_type> property.
{on | off} Diff encoding, either on or off.
<1:1024> Preamble length. Cable modem burst preambles are
a known data pattern sent to all cable modems by the
CMTS through the Upstream Channel Descriptor
(UCD).
<0:16> FEC-T bytes.
<16:255> FEC-K bytes, where FEC-T and FEC-K cannot add
up to more than 255 bytes.
Example
CASA(config)# modulation-profile 6
CASA(config-mod-prof-6)# a-long atdma 64qam off 104 4 220 338 0 8 fixed
on 1 1536 qpsk1
a-short
Purpose
The a-short command configures an a-short data grant used for transmitting smaller
upstream data in DOCSIS 2.0 and 3.0.
See the a-long command for a description of the properties. The a-short modulation
profile has the following operation modes, as recommended:
atdma
mtdma
scdma
Mode
(config-mod-profile-<id>)#
Syntax
a-short <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config)# modulation-profile 7
CASA(config-mod-prof-7)# a-short atdma 64qam off 104 4 75 338 6 8 fixed
on 1 1536 qpsk1
initial
Purpose
The initial command defines an initial data grant used for transmitting upstream data
when, an interval in which new cable modems can join the network.
See the a-long command for a description of the properties. The initial modulation
profile has the following operation modes, as recommended:
atdma
mtdma
scdma
tdma
Mode
(config-mod-profile-<id>)#
Syntax
initial <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config)# modulation-profile 8
CASA(config-mod-prof-8)# initial atdma qpsk off 640 5 34 338 0 48 fixed
on 1 1536 qpsk0
long
Purpose
The long command defines a long data grant used for transmitting large upstream data
in DOCSIS 1.0 and 1.1. The number of minislots in the interval is larger than the
maximum for short interval transmissions.
See the a-long command for a description of the properties. The long modulation
profile has the following operation modes, as recommended:
mtdma
tdma
Mode
(config-mod-profile-<id>)#
Syntax
long <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config)# modulation-profile 9
CASA(config-mod-prof-9)# long tdma qpsk off 640 5 34 338 0 48 fixed on
request
Purpose
The request command defines a request data grant used for transmitting upstream
data, an interval in which requests can be made for bandwidth for upstream data
transmission.
See the a-long command for a description of the properties. The request modulation
profile has the following operation modes, as recommended:
atdma
mtdma
scdma
tdma
Mode
(config-mod-profile-<id>)#
Syntax
request <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config)# modulation-profile 10
CASA(config-mod-prof-10)# request atdma qpsk off 64 0 16 338 0 16 fixed
on 1 1536 qpsk0
short
Purpose
The command defines a short data grant used for transmitting shorter upstream data in
DOCSIS 1.0 and 1.1. The interval for a short interval is less than or equal to
maximum-burst-size defined in the short profile.
See the a-long command for a description of the properties. The short modulation
profile has the following operation modes, as recommended:
mtdma
tdma
Mode
(config-mod-profile-<id>)#
Syntax
short <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config)# modulation-profile 11
CASA(config-mod-prof-11)# short mtdma qpsk off 64 0 16 338 0 16 fixed
on 1 1536 qpsk0
station
Purpose
The station command defines a station data grant used for transmitting upstream data,
an interval in which cable modems are expected to perform some aspect of routine
network maintenance, such as ranging or power adjustment.
See the a-long command for a description of the properties. The station modulation
profile has the following operation modes, as recommended:
atdma
mtdma
scdma
tdma
Mode
(config-mod-profile-<id>)#
Syntax
station <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config)# modulation-profile 12
CASA(config-mod-prof-12)# station atdma qpsk off 384 5 34 338 0 48
fixed on 1 1536 qpsk0
ugs
Purpose
The ugs command defines an Unsolicited Grant Service (UGS) data grant used for
transmitting upstream data.
See the a-long command for a description of the properties. The UGS modulation
profile has the following operation modes, as recommended:
atdma
mtdma
scdma
Mode
(config-mod-profile-<id>)#
Syntax
ugs <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
<16:255> <0:32767> <0:255> <4:255> {fixed | shortened} {on |
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config)# modulation-profile 13
CASA(config-mod-prof-13)# ugs atdma qpsk off 384 5 34 338 0 48 fixed on
1 1536 qpsk0
Shows the modulation profile configuration. The additional table modifier renders the
output in table form.
0 to 1 0 0
1 to 3 65 0
3 to 10 35 0
10 to 50 0 0
50 to 500 0 0
500 to 2000 0 0
2000 to 10000 0 0
10000 to 50000 0 0
> 50000 0 0
You can identify limited multicast sessions by using the application ID. The
application ID is an attribute that can be configured into a group QoS configuration.
Currently, it has no significance to the CMTS. An application policy is a new object
that is used to store application attributes, such as limiting replication for multicast
sessions. The procedure for identifying a limited multicast session is:
1. Configure a multicast group table with matching group-address and QOS ID.
2. Configure the multicast group QOS with a specified application ID.
3. Configure the application ID with limit replication and maximum IPTV channels.
Configuration summary
Table 12-1 lists and briefly describes the objects related to multicast operations.
mcast-classifier ds_chan
Purpose
In the Casa configuration mode, using the command leaves you in configuration
mode. Use the no form of the command to remove the classifier.
Mode
(config)#
Syntax
mcast-classifier ds_chan <slot>/<port>/<chan> cl_id <1:4092> sf_id
<1:4092> [dst-ip <ip_addr> <mask> | pri <0:24> | protocol
<0:257> | src-ip <ip_addr> <mask> | tos <0:255> <0:255> <0:255>
no mcast-classifier ds_chan <slot>/<port>/<chan> cl_id <1:4092>
Properties
Property name Description
Example:
Properties
Property name Description
Example:
protocol <0:257> Optional IP protocol number, 256 for all protocols and
257 for TCP/UDP, which can be followed by the tos
value.
Example:
src-ip <ip_addr> <mask> Optional source IP address and mask values, which
can be followed by the dst-ip, protocol, or tos value.
Example:
tos <0:255> <0:255> <0:255> Optional Type of Service (TOS), with the low, high,
and mask values, as the last of the command values.
Example:
mcast-service-flow ds_chan
Purpose
A multicast service flow is a specific type of flow where the packets comprising the
flow require particular treatment by the network forwarding devices along the path to
the packets destination.
In the Casa configuration mode, using the mcast-service-flow command leaves you in
configuration mode. Use the no form of the command to remove the service flow.
Mode
(config)#
Syntax
mcast-service-flow ds_chan <slot>/<port>/<chan> sf_id <1:4092> dsid
<1:4092> pri <0:7> gu_rate <Bps> gu_buf_sz <bytes> mx_rate <Bps>
mx_buf_sz <bytes> [default]
no mcast-service-flow ds_chan <slot>/<port>/<chan> sf_id <1:4092>
Properties
Property name Description
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1
CASA(config)# no mcast-service-flow
ds_chan 2/0/0 sf_id 1
Properties
Property name Description
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1 dsid 1
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1 dsid 1 pri 7
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1 dsid 1 pri 7
gu_rate 24
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1 dsid 1 pri 7
gu_rate 24 gu_buf_sz 8
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1 dsid 1 pri 7
gu_rate 24 gu_buf_sz 8 mx_rate 32
Properties
Property name Description
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1 dsid 1 pri 7
gu_rate 24 gu_buf_sz 8 mx_rate 32
mx_buf_sz 64
Example:
CASA(config)# mcast-service-flow
ds_chan 2/0/0 sf_id 1 dsid 1 pri 7
gu_rate 24 gu_buf_sz 8 mx_rate 32
mx_buf_sz 64 default
multicast authorization
Purpose
Modes
(config)#
(conf-auth-file <name>)#
Syntax
(config)#
multicast authorization default-action {deny | permit}
[no] multicast authorization enable
[no] multicast authorization match-profile <name>
multicast authorization max-session-num <0:65535>
Properties
Property name Description
Example:
Properties
Property name Description
Example:
Example:
Example:
Properties
Property name Description
Example:
Example:
Properties
Property name Description
Example:
CASA(conf-auth-file MYPROF)#
session-rule 1234 accept 192.168.6.6/24
224.168.5.5/24 priority 255
CASA(conf-auth-file MYPROF)#
no session-rule 1234
Shows the multicast authorization profile configuration with the session rule.
In the Casa configuration mode, using the command leaves you in configuration
mode. Use the no form of the command to remove the multicast property.
Mode
(config)#
Syntax
multicast default grp-service-class-name <name>
no multicast default grp-service-class-name
Properties
Property name Description
Example:
multicast group
Purpose
The multicast group command configures a multicast group and its properties.
In the Casa configuration mode, using the command leaves you in configuration
mode. Use the no form of the command to remove the multicast group. There are no
no forms of the group configuration command.
Modes
(config)#
(conf-grp-config <id>)#
Syntax
(config)#
[no] multicast group config <1:4294967295>
(conf-grp-config x)#
encryption-id <0:65535>
group-address {<ip_addr>/<mask> | ipv6 <v6_addr>/<prefix>}
phs-id <0:65535>
priority <0:255>
qos-id <0:65535>
source-address {<ip_addr>/<mask> | ipv6 <v6_addr>/<prefix>}
tos-high <0:255>
tos-low <0:255>
tos-mask <0:255>
vrf <id>
(config)#
multicast group encryption <1:65535> algorithm {aes128 | cmts | des40 |
des56}
no multicast group encryption <1:65535>
multicast group qos <1:65535> <class_name> {aggregate max-sess
<1:65535> | single} [app-id <1:32>}
no multicast group qos <1:65535>
Properties
Property name Description
Example:
Example:
Example:
Example:
Properties
Property name Description
Example:
Example:
Example:
Example:
Properties
Property name Description
Example:
tos-mask <0:255> Mask value bitwise and with a TOS byte value to be
defined in a packet classifier.
Example:
Example:
Example:
Properties
Property name Description
Example:
Shows the multicast VRF replication. An asterisk (*) indicates that Multicast DSID
Forwarding (MDF) is enabled for the module. The optional module packet flow
statistics can also be specified.
Multicast Session
Module ReplID DSID(hex) SFID Type Chan(s)
<232.177.2.1::177.1.2.10>
qam 2 15 8000f* 2 DEF 2/0/11
qam 2 14 8000e* 13 IPTV 2/0/11
The multicast load-balance initial-tech command sets the initial ranging technique
for load balancing. In the Casa configuration mode, using the command leaves you in
configuration mode. There is no no form of the command.
Mode
(config)#
Syntax
multicast load-balance initial-tech broadcast-ranging
multicast load-balance initial-tech direct
multicast load-balance initial-tech period-ranging
multicast load-balance initial-tech reinitialize-mac
multicast load-balance initial-tech unicast-ranging
Properties
Property name Description
Example:
Example:
Properties
Property name Description
Example:
Example:
Example:
The multicast max channel-util command sets the maximum percentage threshold
for multicast streams per channel. Once the channel reaches the configured threshold,
no further multicast sessions are allowed on that channel. If the threshold percentage
is too low, bandwidth may be wasted (unusable for multicast), or the channel will be
used entirely for unicast traffic. If the threshold percentage is too high, the channel
may become congested with multicast traffic. Casa recommends that you monitor the
default configuration setting of 60 and then tune the value for best performance.
In the Casa configuration mode, using the command leaves you in configuration
mode. There is no no form of the command.
Mode
(config)#
Syntax
multicast max channel-util <1:100>
Properties
Property name Description
Example:
multicast single_said
Purpose
In the Casa configuration mode, using the command leaves you in configuration
mode. Use the no form of the command to remove the multicast property.
Mode
(config)#
Syntax
[no] multicast single_said
The multicast switch over time command sets the time to switch over from multicast
to unicast.
In the Casa configuration mode, using the command leaves you in configuration
mode. Use the no form of the command to remove the multicast property.
Mode
(config)#
Syntax
[no] multicast switch over time <100:10000>
Properties
Property name Description
Example:
interface docsis-mac
multicast-dsid-forward
Enables multicast Downstream Service Identifier (DSID) forwarding that allows CMs
to filter multicast traffic before forwarding the traffic to CPE devices. (See the
multicast-dsid-forward [wb-cm-only] property for details.)
interface docsis-mac
no mgmd ipv4 shutdown
interface vlan
rate-limit multicast
Performs a rate limit on the multicast upstream for the VLAN, in maximum number of
packets permitted per second (default no limit).
ip pim
ip pim rp-address
ip pim rp-candidate
The ip pim ip-address command configures the PIM rendezvous point (RP) address.
PIM-SM requires a static RP address of the router interface that accepts multicast
traffic from other hosts before forwarding the traffic to members of the multicast
group. The ip pim rp-candidate command configures the RP candidate, which can be
either a GigE interface or a loopback interface at the CMTS. The configured RP
candidate advertises itself at a specified interval setting and priority for possible
election as the router over which all sources distribute traffic to the multicast group.
You can set multiple candidates.
Sets packet-per-second (PPS) rate limits that the system uses for Layer 2 destination
lookup failure (DLF) for multicast packets.
group-address 192.168.7.7/24
tos-low 255
tos-high 255
tos-mask 255
qos-id 124
encryption-id 1
phs-id 1
priority 255
Shows the multicast traffic stream. You can also filter the output by group address,
docsis, or video.
show ip mroute
Configuration summary
Table 13-1 lists and briefly describes the objects related to PacketCable.
packetcable
Purpose
In the Casa configuration mode, using the command leaves you in configuration
mode. Use the no form of the command to disable PacketCable operations.
Mode
(config)#
Syntax
[no] packetcable <cr>
packetcable cops ip dscp <0:63>
[no] packetcable dscp check
packetcable elemid <0:99999>
[no] packetcable ftp {newuser <name> | user password <pwd>}
packetcable inactive call aging <0:24> [minimum traffic <0:1000>]
[no] packetcable max {emerg | normal} call <0:8000>
[no] packetcable media alive time <hh:mm>
[no] packetcable mgpi
[no] packetcable multimedia [T1 <1:1000>]
[no] packetcable myaddress <ip_addr>
[no] packetcable nls {agid <0:4294967295> key <key> | cpd |
source-interface loopback <0:15>}
packetcable pepid <text>
[no] packetcable rks batchfile {max {msg <1:1000> | size <1024:65535>}
| sendmode {ftp | udp} | time <1:200>}
[no] packetcable rks retry <1:10>
[no] packetcable rks timeout <1:30>
[no] packetcable t0 <1:65535>
[no] packetcable t1 <1:65535>
[no] packetcable vrf <name>
Properties
Property name Description
Example:
CASA(config)# packetcable
CASA(config)# no packetcable
cops ip dscp <0:63> Sets the Differentiated Services Code Point (DSCP)
priority for the Common Open Policy Service
(COPS). There is no no form of the command.
Example:
Example:
Example:
Properties
Property name Description
ftp {newuser <name> | user Configures an FTP user for PacketCable, with a
password <pwd>} username and password, default casa.
Example:
inactive call aging <0:24> Inactive call aging controls freeing of PacketCable
[minimum traffic <0:1000>] gates when service flows become inactive.
Previously, PacketCable gates remained active and
calls were not being torn down after a call ended,
consuming system resources and bandwidth. This
command sets the number of hours to pass before
tearing down a call, as well as setting an optional
minimum voice downstream throughput threshold (in
kilobits) to determine if the call session should be torn
down. There is no no form of the command.
Example:
max {emerg | normal} call Configures maximum emergency or normal calls for
<0:8000> the CMTS, default 0 (disabled).
Example:
Properties
Property name Description
media alive time <hh:mm> Media Alive Time is an EM message. To set the
media alive time, set the hours and minutes in the
form hh:mm.
Example:
Example:
Example:
Properties
Property name Description
Example:
Example:
Properties
Property name Description
Example:
rks batchfile {max {msg A batch file can be sent to the Record Keeping
<1:1000> | size Server (RKS) by UDP or FTP. The batchfile property
<1024:65535>} | sendmode sets the following parameters:
{ftp | udp} | time <1:200>}
max msg <1:1000> Maximum number of
messages in a batch file, default 20 messages.
max size <1024:65535> Maximum size, in
bytes, of the event message batch file, default
65535.
sendmode {ftp | udp} Specified FTP or UDP
as the send mode.
time <1:200> Time intervals to send the batch
file to the RKS server, default 200 seconds.
Example:
Properties
Property name Description
rks retry <1:10> Set the RKS retry count, the number of times that a
RADIUS request is resent to a RKS server, default 3
retries.
Example:
rks timeout <1:30> Sets the RKS timeout, the time interval that the router
waits for the RKS server to reply before
retransmitting, default 5 seconds.
Example:
Example:
CASA(config)# packetcable t0 30
CASA(config)# no packetcable t0
Example:
Example:
Shows the packet cable global parameters. Note that in release 6.5 the PacketCable
Multimedia (PCMM) version is set to 5.0 by default.
Shows the Common Open Policy Service (COPS) server IP address and listen port.
Shows the multiple grants per interval (MGPI), if enabled by the packetcable mgpi
command, with the option of specifying a particular cable modem.
Casa has commands in configuration mode for setting classes and policies.
Configuration summary
Table 14-1 lists and briefly describes the objects related to classes and policies.
application
Purpose
In the Casa configuration mode, using the command takes you to application-class
(conf-app-class) or application-policy (conf-app-policy) configuration mode. Use the
no form of the command to remove the application class or policy.
Mode
(config)#
Syntax
[no] application class <1:16>
[no] application policy <1:32>
Properties
Property name Description
Example:
Example:
class
Purpose
An application class needs to have a defined name and can have up to eight child
classes that can be configured for availability when the parent application class
reaches its maximum bandwidth. A parent include rule statement must precede adding
a child class. A child class preempts another one from the same parent using the
exclusive and non-exclusive bandwidth percentage settings, although the sum of all
child class exclusive settings cannot exceed that of the parent. For emergency and
normal calls, one child class can be set for normal calls with exclusive set to zero and
non-exclusive set to the maximum normal calls allowed, while another child class can
be set for emergency calls with exclusive set to the maximum voice calls allows and
non-exclusive set to zero.
Mode
(conf-app-class <index>)#
Syntax
name <name>
[no] child-class <1:8> {name <name> | downstream-bandwidth exclusive
<0:100> [non-exclusive <0:100>] | include <val> |
upstream-bandwidth exclusive <0:100> [non-exclusive <0:100>]}
downstream-bandwidth exclusive <1:100> [non-exclusive <0:100>]
[no] include {BE | multicast application-id <1:65535>... | packetcable
[emergency | normal] | pcmm {app-id <0:65535>... | gate-priority
<0:7>...} | sched-type {be | nrtps | rtps | ugs | ugs-ad} |
service-class <name>...}
upstream-bandwidth exclusive <1:100> [non-exclusive <0:100>]
Properties
Property name Description
Example:
child-class <1:8> {name Child class ID, which requires a name and an
<name> | include rule set for the parent class. There can be up
downstream-bandwidth to eight child classes per application class.The child
exclusive <0:100> should have a related include rule and its own
[non-exclusive <0:100>] | bandwidth values, with the limitation that the sum of
include <val> | exclusive bandwidth percentages of all the children
upstream-bandwidth cannot exceed that of the parent.
exclusive <0:100>
[non-exclusive <0:100>]} Example:
Properties
Property name Description
Example:
CASA(conf-app-class 1)#
downstream-bandwidth exclusive 16
non-exclusive 20
Properties
Property name Description
include {BE | multicast Binds a rule to the application class or child class.
application-id <1:65535>... Required for a parent class when defining child
| packetcable [emergency | classes. The rules, which are evaluated in the order
normal] | they are defined, are as follows:
pcmm {app-id <0:65535>... |
gate-priority <0:7>...} | BE Best effort (BE) service flow with a
sched-type {be | nrtps | non-zero committed information rate (CIR).
rtps | ugs | ugs-ad} | multicast application-id <0:65535> Applica-
service-class <name>...} tion ID or space-separated IDs of the multicast
service flow.
packetcable [emergency | normal] Packet-
Cable call class, with the optional emergency or
normal service type. The emergency service pre-
empts the normal service once the parent class
reaches its maximum bandwidth. For emergency
calls, the exclusive threshold should be set to the
maximum voice calls allowed and the non-exclu-
sive threshold set to zero.
pcmm {app-id <0:65535> | gate-priority <0:7>}
PacketCable Multimedia (PCMM), with the
application ID or gate priority. The parent class
can list all the child application IDs separated by
spaces, up to eight IDs. Gate priority can also
take multiple values. Set a low gate priority value
for priority services such as multicast streaming.
sched-type {be | nrtp | rtp | ugs | ugs-ad}
Quality of service (QoS) class schedule type, as
best-effort (be), non-real-time polling (nrtp),
real-time polling (rtp), Unsolicited Grant Service
(ugs), or Unsolicited Grant Service with Activity
Detection (ugs-ad).
service-class <name> Cable service class
name.
Example:
Properties
Property name Description
Example:
CASA(conf-app-class 1)#
upstream-bandwidth exclusive 16
non-exclusive 20
Examples
The following example shows an application class with exclusive and non-exclusive
downstream bandwidth thresholds adding up to 30%. The subsequently defined child
class combined bandwidths exceeded this amount, resulting in an error.
In the following example, the parent class thresholds add up to 30%, the individual
child class thresholds add up to no more then 30%, and the totaled child exclusive
thresholds add up to no more than the 10% defined for the parent. This is acceptable.
The non-exclusive thresholds do not have this limitation and can be higher. The count
values show that no modem has yet come online.
In the following example, two identical application classes are defined. The CMTS
evaluates the include rules in order and picks the service-class definitions from the
first class. In so doing, it pegs the accept count to 14 (the two downstream flows times
the seven modems coming online) for the first application class only, and not for the
second. The additional show cable modem qos output shows the upstream and
downstream service-classes for one of the modems that were used in the evaluation.
application class 2
name Wave3
include service-class STMrule_DWN.2 STMrule_DWN.1
include pcmm app-id 5
include BE
downstream-bandwidth exclusive 29 non-exclusive 29
child-class 1 name Wave3_CC_1
child-class 1 include pcmm app-id 1 5
child-class 1 downstream-bandwidth exclusive 5 non-exclusive 0
child-class 2 name Wave3_CC_2
child-class 2 include pcmm app-id 2 3
child-class 2 downstream-bandwidth exclusive 20
child-class 3 name Wave3_CC_3
child-class 3 include pcmm app-id 3
child-class 3 downstream-bandwidth exclusive 1
child 1 : accept 0, deny 0, dcc 0, force free 0
child 2 : accept 0, deny 0, dcc 0, force free 0
child 3 : accept 0, deny 0, dcc 0, force free 0
total : accept 0, deny 0, dcc 0, force free 0
cable traffic-policy
Shows the configured application classes. See the Examples above. The child and
total accept and deny counts at the bottom of the output are for currently active calls
(that can be synced with admission-control).
policy
Purpose
The application policy command defines application policy properties in the Casa
application-policy configuration mode. An application policy is an object that stores
application attributes, such as limiting replication for multicast group sessions. Up to
32 application policies are supported. Use the no form of the command to remove the
property.
Mode
(conf-app-policy <id>)#
Syntax
[no] limit replication [override]
max iptv channel <0:2>
[no] monitor threshold min-rate-ratio <1:100>
Properties
Property name Description
Example:
Properties
Property name Description
max iptv channel <0:2> Sets the optional maximum Internet Protocol
Television (IPTV) channels the CM is allowed to join,
with 0 disabling the feature. There is no no form of
the command.
Example:
Example:
Example
The following commands configure identifying multicast sessions that match group
address 230.0.1.0/24 as limited multicast sessions. (See also Chapter 12, Multicast
operations.)
application policy 1
class-map
Purpose
The class-map command defines a class map and assigns it to a quality of service
(QoS) policy.
In the Casa configuration mode, using the command puts you in class-map
configuration mode. Use the no form of the command to remove the class map.
Modes
(config)#
(config-class-map <name>)#
Syntax
(config)# [no] class-map <name>
(config-class-map x)#
[no] match access-group <acl_name>
[no] set-dscp <0:63>
Properties
Property name Description
<name> Creates the required class map name. This puts you
in class-map configuration mode.
Example:
Properties
Property name Description
Example:
Shows the class map in the running configuration. The name option shows the
properties set.
policy-map
Purpose
In the Casa configuration mode, using the command puts you in policy-map
configuration mode to add the class. Use the no form of the command to remove the
policy map or class.
Modes
(config)#
(conf-policy-map <name>)#
Syntax
(config)# [no] policy-map <name>
(config-policy-map x)# [no] class <name>
Properties
Property name Description
Example:
Example:
show policy-map
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 through 860 MHz. High frequency mode requires all channels on a module
in the range 295 through 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 channel is separated by 6 to 8 MHz, depending on whether the
QAM port is configured as Annex type B, C, or A.
Configuration summary
Table 15-1 lists and briefly describes the objects related to the QAM 8x8 interface.
interface qam
Purpose
The interface qam command is executed in the Casa configuration mode. Once a
viable QAM slot and port are defined, the commands enter QAM interface
configuration mode. There is no no form of the command, except for some of the
properties.
Modes
(config)#
(config-if-qam <slot>/<port>)#
Syntax
(config)# interface qam <slot>/<port>
(config-if-qam X/Y)#
annex {A [symbol rate <1:6952>] [channel spacing <6000000:8000000>]
| B | C}
[no] channel <0:7> [description <text>]
[no] channel <0:7> dsg {channel-list <1:4294967295> | dcd-enable |
interval <2:10> | timer-id <1:4294967295> | vendor-param-id
<1:4294967295>}
channel <0:7> frequency <47000000:999000000>
channel <0:7> interleave <level>
channel <0:7> prov-attr-mask {<0x0:0xffffffff> | bonding |
highavailability | lowlatency}
[no] channel <0:7> replicate-port <ports_list>
[no] channel <0:7> shutdown
[no] channel <0:7> transport stream <0:65535>
interface qam <slot>/<port>.<pchan>
interleave <level>
modulation {128qam | 256qam | 64qam | off}
power <250:620> [per-channel]
[no] shared-channel <0:7> {annex {A [symbol rate <1:6952>] [channel
spacing <6000000:8000000>] | B | C} | frequency
<47000000:999000000> | interleave <level> | modulation
{128qam | 256qam | 64qam | off} | shutdown | transport stream
<0:65535>}
[no] shutdown
[no] spectral inversion on
spectrum-tilt <0:50>
Properties
Property name Description
Example:
annex {A [symbol rate Sets the QAM channel annex. There is no no form of
<1:6952>] [channel the command. There are three MPEG framing
spacing formats for a QAM channel, Annex A (Europe),
<6000000:8000000>] | B | Annex B (North America), and Annex C (Japan),
C} described as follows:
Example:
Properties
Property name Description
Example:
Example:
Properties
Property name Description
channel <0:7> frequency Sets the QAM channel frequency specified in Hz. The
<47000000:999000000> default for channel 1 is 549000000 Hz (549 MHz).
The center frequencies for the 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
the annex {A [symbol rate <1:6952>]
[channel spacing <6000000:8000000>] | B
| C} type specified. In the example, assuming the
channel bandwidth is 6 MHz, the center frequency of
QAM channel 0 is then automatically adjusted to 549
MHz, channel 2 to 561 MHz, channel 3 to 567 MHz,
and so on. Changing the frequency requires shutting
down the channel first. There is no no form of the
command.
Example:
channel <0:7> interleave Sets the QAM channel interleave level to minimize
<level> the effect of burst noise by spreading data over time,
with the possible values 8, 16, 32, 64, 128x1, 128x2,
128x3, 128x4, 128x5, 128x6, 128x7, or 128x8.
128x1 is the default and highest amount of
interleaving, with 8 the lowest. All channels on the
port are automatically set to the same interleave level
(see the interleave <level> property). There is
no no form of the command.
Example:
Properties
Property name Description
Example:
Example:
Properties
Property name Description
channel <0:7> shutdown Shuts down the channel. Use the no form to restart.
Example:
CASA(config-if-qam 0/0)#
no channel 1 shutdown
Example:
interface qam <slot>/ Opens a QAM interface slot, port, and channel. There
<port>.<pchan> is no no form of the command.
interleave <level> Sets the QAM port interleave level to minimize the
effect of burst noise by spreading data over time, with
the possible values 8, 16, 32, 64, 128x1, 128x2,
128x3, 128x4, 128x5, 128x6, 128x7, or 128x8.
128x1 is the default and highest amount of
interleaving, and 8 is the lowest. All channels on the
port are automatically set to the same interleave
level. The interleave level can also be set for a
specific channel (see the channel <0:7>
interleave <level> property). For Annex A, the
interleave is fixed at 12 and cannot be changed.
There is no no form of the command.
Example:
Properties
Property name Description
modulation {128qam | Sets the modulation rate for all QAM output channels
256qam | 64qam | off} on the selected QAM port. The possible modulation
rates are 64qam, 128qam, 256qam, and off, the
default 256qam. A modulation type is required. There
is no no form of the command.
Example:
power <250:620> Sets the output power level for all QAM channels on
[per-channel] a QAM port. The power is measured in tenths of a
decibel, default 510. The power setting is the sum of
all enabled QAM channels on the same port. The
actual channel output level depends on how many
channels are enabled on that port. The optional
per-channel modifier indicates that the power
applies to the specified channel only, otherwise the
power setting is the total power across all enabled
channels. There is no no form of the command.
60 dBmV at 1-channel/port
56 dBmV at 2-channels/port
52 dBmV at 4-channels/port
49 dBmv at 8-channels/port
Example:
Properties
Property name Description
Example:
shutdown Shuts down the QAM port. This command can also
be performed for a specific channel (see the
channel <0:7> shutdown) command. The
default state for all QAM ports and channels is
shutdown. This prevents interference with existing
cable-channel configurations. If the QAM port is
disabled, enabling the individual channel will have no
effect until the QAM port is enabled. The no form of
the command restarts the interface.
Example:
Properties
Property name Description
spectral inversion on Turns on spectral inversion for the QAM interface. All
parts of the command are required. Spectral
inversion is reversing the orientation of the signal
bandwidth with respect to the carrier frequency, a
feature that is turned off by default. Turning spectral
inversion off requires the no form of the command.
Example:
spectrum-tilt <0:50> Sets the spectrum-tilt level to assign the power per
channel. There is no no form of the command.
Example:
Shows the QAM interfaces and their channel frequencies and shutdown status. The
full version of the command also shows the associated properties, which the brief
version of the command does not. A specific module/slot can also be specified.
The QAM 8x96 module supports 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. The QAM 8x96 module supports 352 QAM channels in Annex B and
Annex A modes 256 channels are capable of both DOCSIS and video traffic, plus
96 video channels capable of broadcasting over any of the RF ports.
Configuration summary
Table 16-1 lists and briefly describes the objects related to the QAM 8x96 interface.
In extra narrowcast channel mode, a shared channel emulates one of the narrowcast
channels on a port. The content of this channel does not replicate to any other port.
This mode is useful in cable environments that do not require replication, where the
shared channels are used to increase the channel density of a port. With 96 shared
channels, each RF port (up to 8) can get up to 12 extra narrowcast channels. Each RF
port has up to 48 narrowcast channels.
The number of narrowcast channels per port can range from 36 through 48. The
following conditions apply with the 48 channels-per-port configuration:
In this mode, the content of the channel can be replicated to all 8 RF ports. The set of
downstream ports on each shared channel may be selected to allow a subset of RF port
for shared channel replication. The RF frequency of the shared channel must be the
same on all the outgoing RF ports. The system allows a combination of these modes
over an RF port, where some shared channels are in the extra narrowcast channel
mode, and some shared channels are configured in multi-port shared channel mode.
Example
CASA(config)# module 0 narrowcast-channels 35
This command creates 35 narrowcast channels. Use the no form of the command
remove the current narrowcast-channels configuration setting and to revert to the
default setting of 44 narrowcast channels. Use the show narrowcast-channels
command display the current narrowcast channels.
CASA(config)# no module narrowcast-channels
Example
CASA(config)# show narrowcast-channels
module 4 narrowcast-channels 44
module 10 narrowcast-channels 44
Example
CASA(config)# interface qam 0/0
CASA(config-if-qam 0/0)# shared-channel 0 frequency 555000000
CASA(config-if-qam 0/0)# shared-channel 0 transport stream id 125
Note: If some of the shared channels are assigned to the narrowcast channel
mode, there will be less shared channels available for multiport shared
channel mode.
Once a shared channel on one of the QAM 8x96 ports is created, it can then be shared
across one or more ports (up to 7 additional) on the same module.
Figure 16-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 through 8, and first_schannel
and last_ schannel specify the block of multi-port shared channels in the range 0
through 44.
5. Run the show docsis channel utilization command to display multi-port shared
channel statistics.
Example
CASA(config)# module 0 narrowcast-channels 32
CASA(config)# show narrowcast-channels
module 0 narrowcast-channels 32
Figure 16-2. QAM 8x96 channel time line frequency blocks (Annex B, C; 128 ch.)
Dynamic system-assigned default frequencies
Figure 16-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:
interface qam
Purpose
In the Casa configuration mode, using the command moves you into interface QAM
configuration mode and identifies the QAM slot/port number. There is no no form of
the interface qam command, except for some of its properties.
Modes
(config)#
(config-if-qam <slot>/<port>)#
Syntax
(config)# interface qam <slot>/<port>
(config-if-qam X/Y)#
annex {A [spectral-inversion] | B | C [spectral-inversion]}
[no] channel <num> [description <text>]
channel <num> annex {A [spectral-inversion] [symbol rate <1:6952>]
| B | C [spectral-inversion]}
[no] channel <num> dsg {channel-list <1:4294967295> | dcd-enable |
interval <2:10> | timer-id <1:4294967295> | vendor-param-id
<1:4294967295>}
channel <num> frequency <0 | 47000000:999000000>
channel <num> interleave <level>
channel <num> modulation {128qam | 256qam | 64qam | off}
channel <num> power-attenuation <0:100>
channel <num> prov-attr-mask {<0x0:0xFFFFFFFF> | bonding |
highavailability | lowlatency}
[no] channel <num> replicate-port <ports_list> [<1:36>]
[no] channel <num> shutdown [<1:36>]
[no] channel <num> transport stream id <0:65535>
interface qam <slot>/<port>
interleave <level>
modulation {128qam | 256qam | 64qam | off}
power <250:620> [per-channel]
Properties
Property name Description
Example:
Properties
Property name Description
annex {A Annex for all channels on the port. There are three
[spectral-inversion] | B MPEG framing formats for a QAM channel, Annex A
| C (Europe), Annex B (North America), and Annex C
[spectral-inversion]} (Japan), described as follows:
Example:
Example:
Properties
Property name Description
channel <num> annex {A Annex for the particular channel, in addition to the
[spectral-inversion] annex set at the port level. The QAM 8x96 port can
[symbol rate <1:6952>] | have up to two different sets of symbol rates
B | C assigned to different channels because of the
[spectral-inversion]} different RF requirements of CMs and STBs. Spectral
inversion can be applied to Annex A and Annex C.
There is no no form of the command.
Example:
Properties
Property name Description
channel <num> dsg DOCSIS Set-Top Gateway (DSG) properties for the
{channel-list QAM channel. One of the following modifiers is
<1:4294967295> | required:
dcd-enable | interval
<2:10> | timer-id channel-list <1:4294967295> Assigns DSG
<1:4294967295> | channel-list to a downstream channel, with the
vendor-param-id channel-list ID specified. A channel-list is config-
<1:4294967295>} ured using the dsg channel-list command in
configuration mode.
dcd-enable Assigns a Downstream Channel
Descriptor (DCD) ENABLE to a downstream
channel.
interval <2:10> Sets a downstream time inter-
val in ticks (100 milliseconds per tick).
timer-id <1:4294967295> Assigns a DSG
timer ID to the channel. A timer-id is configured
using the dsg timer-id command in configuration
mode.
vendor-param-id <1:4294967295> Assigns a
DSG vendor parameter ID to the downstream
channel. A vendor-param-id is configured using
the dsg vendor-param-id command in configura-
tion mode.
Example:
Properties
Property name Description
channel <num> frequency QAM channel frequency. The default for channel 1 is
<0 | 47000000:999000000> 549000000 Hz (549 MHz). The center frequencies for
the four 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 the annex type
specified. Changing the frequency requires shutting
down the channel first. There is no no form of the
command, so narrowcast and shared channels can
be configured with a frequency of 0 for unused or
disabled channels (shutdown) to avoid possible
unexpected frequencies.
Example:
channel <num> interleave QAM channel interleave level, with the possible
<level> values 8, 16, 32, 64, 128x1 (default), 128x2, 128x3,
128x4, 128x5, 128x6, 128x7, or 128x8. (See also the
interleave <level> command.) There is no no form
of the command.
Example:
channel <num> modulation Modulation rate for the specific QAM output channel
{128qam | 256qam | 64qam on the selected QAM 8x96 port. The possible
| off} modulation rates are 64qam, 128qam, 256qam
(default), and off. A modulation type is required.
There is no no form of the command.
Example:
Properties
Property name Description
Example:
Properties
Property name Description
Example:
channel <num> shutdown Shuts down the channel. The optional number of
[<1:36>] channels designation applies to QAM 8x96 boards
only.
Example:
Example:
Properties
Property name Description
Example:
Example:
modulation {128qam | Modulation rate for all QAM output channels on the
256qam | 64qam | off} selected QAM port. The possible modulation rates
are 64qam, 128qam, 256qam, and off, the default
256qam. There is no no form of the command.
Example:
Properties
Property name Description
power <250:620> Output power level for all QAM channels on a QAM
[per-channel] port. The power is measured in tenths of a decibel,
default 510. The power setting is the sum of all
enabled QAM channels on the same port. The actual
channel output level depends on how many channels
are enabled on that port. The optional per-channel
modifier indicates that the power applies to the
specified channel only, otherwise the power setting is
the total power across all enabled channels. There is
no no form of the command.
60 dBmV at 1-channel/port
56 dBmV at 2-channels/port
52 dBmV at 4-channels/port
49 dBmv at 8-channels/port
Example:
Properties
Property name Description
shared-channel <id> Shared channel ID for the QAM interface, with the
{annex {A [symbol rate following properties:
<1:6952>]
[spectral-inversion] | B annex {A [spectral-inversion] | B | C [spec-
| C tral-inversion]}
[spectral-inversion]} | frequency <47000000:999000000> Narrow-
frequency <0 | cast and shared channels can also be configured
47000000:999000000> | with a frequency of 0 for unused or disabled
interleave <level> | (shutdown) channels to avoid possible unex-
modulation {128qam | pected frequencies.
256qam | 64qam | off} |
interleave <level>
shutdown | transport
stream <0:65535>} modulation {128qam | 256qam | 64qam | off}
shutdown
transport stream <0:65535> An ID of 0
removes the transport stream.
Example:
shutdown Shuts down the QAM port. This command can also
be performed for a specific channel (see the channel
<num> shutdown [<1:36>]) command. The default
state for all QAM ports and channels is shutdown.
This prevents interference with existing
cable-channel configurations. If the QAM port is
disabled, enabling the individual channel will have no
effect until the QAM port is enabled. The no form of
the command restarts the interface.
Example:
Properties
Property name Description
spectral inversion on Turns on spectral inversion for the QAM interface. All
parts of the command are required. Spectral
inversion reverses the orientation of the signal
bandwidth with respect to the carrier frequency, a
feature that is turned off by default. Turning spectral
inversion off requires the no form of the command.
Example:
Example:
si generator tot
Generates a Service Information (SI) table for the Time Offset Table (TOT). The
Time Offset Table (TOT) carries the UTC time and date information as well as the
local time offset. It is transmitted in TS packets with a PID value of 0x0014 and a
table ID of 0x73. The command can take the following additional parameters:
Shows the QAM interfaces and their channel frequencies and shutdown status. The
full version of the command also shows the associated properties, which the brief
version of the command does not. A specific module/slot can also be specified.
module
Purpose
The module command defines a module and configures shared channels in extra
narrowcast mode, where a shared channel emulates one of the narrowcast channels on
a port and the content of this channel does not replicate to any other port.
In the Casa configuration mode, using the command leaves you in configuration
mode. Use the no form of the command to remove the narrowcast module.
Mode
(config)#
Syntax
[no] module <id> narrowcast-channels {<32:44> | <36:48>}
Properties
Property name Description
Example:
CASA(config)# module 0
narrowcast-channels 48
CASA(config)#
no module 0 narrowcast-channels
show narrowcast-channels
The DOCSIS QAM Module (DQM) provides QoS support through a two-level
hierarchical scheduler. The top level is priority based, and the second level is a fair
scheduler based on round robin. Each packet destined for a downstream interface is
assigned a service flow through classification by the DOCSIS forwarding engine. The
scheduler in the DQM module supports a minimum guaranteed rate and a maximum
transmitted rate. Packets are serviced in the order of priority specified by the service
flow. A service flow that is within minimum guaranteed rate is served first. Within the
same priority, round robin is used to schedule between different service flows, unless
service flow weighted fair queuing (WFQ) is enabled.
If the service flow has minimum guaranteed rate and the current rate is within the
specified rate, the packet is queued in the guaranteed class that has the highest
priority. The packet is subsequently rate limited through a token bucket to conform to
the maximum transmitted rate specified for the service flow. Packets that exceed the
maximum transmitted rate are rate-shaped by deferring their transmission. Packets are
dropped only if the buffer utilization is high and the buffer usage by the service flow is
above the drop threshold.
In the DOCSIS Control and Upstream (DCU) module, the upstream scheduler handles
modem transmission opportunities. In addition to providing minimum guaranteed rate
and rate limiting support, it also provides jitter guarantees for jitter-sensitive services,
such as unsolicited grant service (UGS). The hierarchical upstream scheduler serves
upstream service flows based on priority. Jitter-sensitive service flows are serviced
first, followed by service flows that are within its guaranteed rate. Best effort service
flows are then serviced in the order of priority. Within each priority, the service flows
are serviced by a round robin scheduler.
For best effort services, the minimum guaranteed rate is checked first. If the
transmission rate of the service flow is within its specified guaranteed rate, the request
is placed in the guaranteed queue, which is serviced before other best effort queues. A
token bucket is used to rate-limit the service flow within its configured maximum
transmission rate and maximum burst size. Requests that exceed the maximum
transmission rate are deferred. Requests that conform to the maximum transmission
rate are placed into the queue determined by the priority of the service flow.
For service flows that are serviced by upstream channel bonding, the service flow is
inserted into multiple queues, one for each of the upstream channels in the bonding
channel set. The service flow is serviced by each of the upstream channels until all the
outstanding bytes requested are served.
The switch fabric connects to the RF modules and Gigabit Ethernet interfaces. Each of
the fabric ports supports eight classed-based queues. The scheduler in the switch
fabric is straight priority. For packets entering the switch fabric from the DCU
module, the priority is determined by the priority value in the upstream service flow.
For packets entering the switch fabric from Gigabit Ethernet interfaces, the priority is
from the 802.1p field if the packet is VLAN-tagged. For untagged packets, the DSCP
value in the IP header is used to determine the priority. The filtering engine can be
used to overwrite the DSCP value using access list. The priority value can also be
modified based on access lists.
To prevent head-of-line blocking, the switch fabric keeps track of the outstanding
buffer count and packet count for each of the ingress ports and each of the classes.
When an egress port on the switch fabric becomes congested, a packet is discarded at
ingress if the outstanding buffer count or packet count from the ingress port exceeds
the discard threshold for the class it belongs to.
Configuration summary
Table 17-1 lists and briefly describes the objects related to QoS.
cops pdp-ip
Purpose
The cops pdp-ip command sets the address of the Policy Decision Point (PDP) for the
Common Open Policy Service (COPS). The COPS protocol is part of the internet
protocol suite as defined by RFC 2748. COPS specifies a simple client/server model
for supporting policy control over Quality of Service (QoS) signaling protocols (such
as RSVP). Policies are stored on servers, and acted upon by PDPs and are enforced on
clients, known as Policy Enforcement Points (PEPs). There are two models of COPS:
the Outsourcing Model and the Provisioning Model, considered from the view of the
client or PEP.
In the Casa configuration mode, creating the PDP leaves you in that mode. Use the no
form of the command to remove the PDP. The show packetcable cms server
command shows the COPS server IP address and listen port.
Mode
(config)#
Syntax
[no] cops pdp-ip <ip_addr>
Properties
Property name Description
Example:
qos-profile
Purpose
The qos-profile command creates a QoS profile with upstream and downstream
bandwidth settings.
In the Casa configuration mode, using the command leaves you in configuration
mode. Use the no form of the command to remove the QoS profile.
Mode
(config)#
Syntax
[no] qos-profile <1:10000> <0:7> <0:100000000> <0:100000000>
<0:100000000> {true|false} <0:65535>
Properties
Property name Description
Example:
cable qos
The cable qos command sets QoS options for the CM.
show qos-profile
5. If the configured channel width differs from the starting high channel width in a
spectrum rule, the high channel width governs in the rule. For example, if the
configured channel width is 3.2MHz and chan-width 6400000 800000 is in the
rule, when a channel width adjustment occurs, it changes to 1.6 MHz (anything
less is unsupported for upstream 16x8 modules). When it recovers, it tries from
6.4 MHz (the high end) first, then the lower width.
6. The show interface upstream x/y and show running-config commands show
configurations, but not necessarily the current configuration of an upstream
interface. If CSM is in use, use show interface upstream x/y current and show
spectrum hop-history upstream x/y[.lchan-1].
7. CSM has a built-in default SNR threshold for each modulation type. To view
them, use the show spectrum snr-threshold-default command. CSM can work
without an SNR threshold for a modulation profile specified in a spectrum rule;
that is, using the default SNR threshold. However, a corrective action will not take
place due to low polled SNR.
8. There can be up to three action command items in the spectrum rule, unless CM
mode is in effect, where only one of two, channel-width or modulation, can be
specified. There is no default action. CSM will attempt a corrective (or
improvement) action in the order specified in the command. However, this does
not guarantee the action takes place. It is important to know how the action helps
before performing it. If an action does not help, it attempts the next one. The most
common reason for an action not helping is that the calculated SNR for that action
does not satisfy the SNR threshold for a modulation profile.
9. A spectrum rule can be Fast Fourier Transform (FFT) or CM mode. An FFT mode
rule can be applied on an upstream physical channel, which means that it
functions on logical channel 0. An FFT rule cannot be applied specifically on
logical channel 0; it can be applied specifically on logical channel 1, but it does
not allow for frequency hops, because the frequency is shared between the logical
channels. A CM mode spectrum rule can be applied (and takes effect) on a logical
channel only. If both physical and logical channels of an interface have spectrum
rules applied, the logical channel rule takes priority.
10. If you want to change configuration based on modulation profile or channel width
(whatever you want CSM to manage), remove the spectrum rule from the channel
first, and put the spectrum rule back in the channel list after the configuration
change. This avoids a conflict between the manual change and CSM control.
If CSM cannot find a frequency to hop to, it will not hop, even if the current frequency
is too noisy to support modems. For example, if there is noise at 31 MHz on interface
5/1/0, then it should perform a frequency hop. There can be multiple steps in the
hopping. However, if the spectrum map is as follows:
There is nowhere to hop to avoid the noise. The three bands (0-2) are too narrow to
escape the noise. When CSM tries a hop (frequency, modulation, or channel width), it
checks if the calculated SNR at the destination (new freq, etc.) is good enough to
accommodate the SNR threshold (280, in this case). If so, hopping is performed.
Otherwise, it tries the next action. In this example, there is no other action.
However, if the 8/4 frequency is moved to 45MHz (away from 25+1.6=26.6 MHz) to
give channel 8/1 more room, as in the following:
spectrum rule 2
frequency band 26000000 42000000
action frequency
Then move channel 8/1 back to 30 MHz (resetting the CSM state machine at channel
8/1), and apply the rule 2 to upstream 8/1, to acquire:
When the CSM poll reaches a threshold, the channel hops to freq 27.6 MHz, as
indicated by the following debug message:
Configuration summary
Table 18-1 lists and briefly describes the objects related to spectrum management.
channel-utilization-interval
Purpose
The channel-utilization-interval command sets the interval over which the channel
utilization information is collected and averaged.
In the Casa configuration mode, creating the interval leaves you in that mode. There is
no no form of the command.
Mode
(config)#
Syntax
channel-utilization-interval <0:86400>
Properties
Property name Description
Example:
CASA(config)#
channel-utilization-interval 86400
show channel-utilization-interval
hop period
Purpose
The hop period command sets a time period between two consecutive frequency
hops. This period allows new channels to stabilize before making a frequency hopping
decision to assign the traffic to cleaner upstream channels. The default hop period is
every 30 seconds. (This command may be replaced by the cable spectrum
hop-period command.)
In the Casa configuration mode, using the command leaves you in configuration
mode. There is no no form of the command.
Mode
(config)#
Syntax
hop period <5:3600>
Properties
Property name Description
Example:
CASA(config)# hop-period 30
Shows the spectrum hop history. The Code column shows the abbreviations M
(modulation), C (channel-width), or F (frequency). Filtering can also be by upstream
interface. The last column in the example shows that CM mode is in effect. CM 16
(15) means that 16 modems suffered a hop-down, based on a tolerance-count
threshold (15). CM 7 (15-3) shows a subsequent hop-back of seven modems, which is
less than 12, the tolerance-count (15) minus the backhop-count (3).
Shows the spectrum hop statistics for a service group. Additional qualifiers can be
channel-width, modulation, and time-info. Channels without spectrum management
rules or where monitoring is not active appear simply as the channel and logical
channel (such as 10/8.1/1: in the example). The associated MIB is the
clabTopoFiberNodeCfgNodeName object type in the DOCSIS CLAB-TOPO-MIB.
spectrum
Purpose
Casa Spectrum Management (CSM) allows the Casa CMTS to monitor the quality of
upstream paths and automatically perform corrective actions when upstream plant
impairments are detected. The monitored upstream plant impairments include Signal
to Noise Ratio (SNR), correctable Forward Error Corrections (FECs), and
uncorrectable FECs. The automatic corrections include frequency hopping, upstream
channel-width adjustment, and dynamic upstream modulation profile changes. CSM
also provides a means to report the configurations, actions, and some test facilities.
In the Casa configuration mode, using the command either leaves you in configuration
mode or moves you to rule or scheduler configuration mode. Use the no form of the
command to remove the spectrum management property.
Modes
(config)#
(conf-rule x)#
(conf-sched x)#
spectrum analysis
Purpose
The spectrum analysis command Casa CMTS is Spectrum Measurement DOCSIS 3.0
compliant. A CLI command is used to show the measured results. Note that the
measurement must be triggered through a MIB setting by creating a table entry for the
docsIf3CmtsSpectrumAnalysisMeasTable for an upstream channel.
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to remove the full spectrum analysis.
Mode
(config)#
Syntax
[no] spectrum analysis full-spectrum
spectrum analysis measurement-interval <5:30>
Properties
Property name Description
Example:
Properties
Property name Description
Example:
Shows spectrum measurement results for a specified upstream channel. It shows the
data in the same MIB entry and format, which, in turn, can be used for the same
purpose. Note that the command always displays results for channel center frequency
40960000 Hz. The measurement must be triggered through a MIB setting by creating
a table entry for docsIf3CmtsSpectrumAnalysisMeasTable for an upstream channel.
FC 66 FE C0 F6 52 F6 52 F6 52 F6 52 F6 52 F6 52 F6 52 F6 52 F6 52 F6 52
F6
spectrum rule
Purpose
Casa Spectrum Manager (CSM) uses the Fast Fourier Transform (FFT) technique to
monitor signal quality on the return path. The FFT screening results, signal-to-noise
ratio (SNR) and Forward Error Correction (FEC) errors in particular, are the main
error events monitored to determine whether plant noise exists and corrective actions
are necessary. Corrective actions can be one, two or all three of frequency hopping,
channel width adjustment, and dynamic modulation profile change.
CSM also provides cable modem (CM) mode management in place of FFT mode
management, if specified via the cm-mode property. CM mode uses the upstream
SNR of a group of cable modems to determine the overall quality of the upstream
channel. The CSM approach is tolerance control, that is, how many cable modems to
tolerate on a particular channel that suffer low signal quality. CSM polls the CMs,
counts how many on a logical channel have a lower-than-threshold SNR, and may
perform a channel hop when this count is exceeded. In CM mode, roll-back (hopback)
provisions are also included based on the tolerance. FFT mode and CM mode
spectrum rules can be applied to upstream interfaces in any valid combination, except
that CM mode rules must be applied on logical channels.
The following rules apply to using FFT and CM mode spectrum rules on physical and
logical upstream interface channels:
CSM maintains a list of discrete channel frequencies and/or one or more frequency
bands for each upstream interface as frequency hopping targets. This is called a
spectrum map. CSM scans through the spectrum map to select the cleanest channel.
The spectrum map is updated when a hop is performed. CSM uses spectrum rules to
manage the corrective actions. A spectrum rule consists of a set of thresholds and a
sequential list of actions. An action can be frequency hopping, channel width
adjustment, or modulation profile. An FFT or CM mode procedure is triggered when a
monitored indicator to an upstream interface hits a defined or default threshold.
The actions take place in an order defined by the operator in the action commands. If
plant signal quality is maintained within the thresholds due to one or more actions, the
subsequent actions in a rule are not performed, because they are not necessary. If the
upstream channel signal with corrected modulation and/or adjusted channel width
returns to 3 dB above normal, the spectrum manager may roll back the settings to their
original channel width or modulation profile setting. The hopback threshold can also
be specified in the CLI. To activate CSM on specified upstream interfaces, spectrum
rules need to be defined and assigned on the interfaces.
In the Casa configuration mode, using the spectrum rule command either leaves you
in configuration mode or moves you to rule or scheduler configuration mode. Use the
no form of the command, when available, to remove the spectrum rule property.
Modes
(config)#
(conf-rule x)#
Syntax
(config)# [no] spectrum rule <1:64>
(conf-rule x)#
action {channel-width | frequency | modulation | scheduler <1:16>}
back-hop-limit <1:16> <1:144> [channel-width | modulation]
no back-hop-limit
channel-width <high> <low>
no channel-width
[no] cm-hop
cm-mode [backhop-count <3:10> | backhop-delay <1:100> |
tolerance-count <1:100>
no cm-mode
correctable-fec threshold <0:100>
[no] description <text>
[no] frequency <5000000:100000000>
[no] frequency band <5000000:99800000> <5200000:100000000>
profile <1:1024> snr-threshold <.1dB> [<.1dB>]
no profile <1:1024>
uncorrectable-fec threshold <0:30>
Properties
Property name Description
Example:
channel-width
frequency (FFT mode only)
modulation
Example:
Properties
Property name Description
Example:
Example:
Properties
Property name Description
Example:
Properties
Property name Description
Example:
Example:
Properties
Property name Description
frequency Sets a discrete frequency for the rule, in Hz. After the
<5000000:100000000> spectrum rule is assigned to an upstream interface,
the discrete frequency becomes a frequency band
with the same width as that of the upstream interface.
Example:
frequency band Sets a frequency band for the rule, in Hz, with a value
<5000000:99800000> for the left edge and a value for the right edge of the
<5200000:100000000> spectrum.
Example:
Example:
Properties
Property name Description
Example:
interface upstream
spectrum-rule
interface qam
spectral inversion on
The spectral inversion on property of the interface qam command turns on spectral
inversion for the QAM interface
Shows the cable spectrum settings and spectrum rules, including any CM mode
settings. Filtering can be by rule ID or more brief output.
spectrum rule 1
cm-hop
correctable-fec threshold 5
uncorrectable-fec threshold 3
spectrum rule 35
cm-mode
cm-mode tolerance-count 15
cm-mode backhop-count 3
cm-mode backhop-delay 1
Shows the spectrum SNR threshold defaults. CSM has a built-in default SNR
threshold for each modulation type and for each modulation profile. The default SNR
threshold takes effect for a spectrum rule if there is no threshold specified in a
spectrum rule for a particular modulation profile.
spectrum scheduler
Purpose
The spectrum scheduler command applies a start and end time to spectrum rules.
When enabled, the spectrum rule is in effect to applied channels over the scheduled
time period. When disabled, the rule is not in effect over the specified time periods,
but the rule is enabled during the other configured times. By default, and without any
start and end time, the spectrum rule is scheduled at all times for the applicable
channels.
In the Casa configuration mode, using the command moves you to scheduler
configuration mode. Use the no form of the command to remove the spectrum
scheduler property.
Modes
(config)#
(conf-sched x)#
Syntax
[no] spectrum scheduler <1:16>
(conf-sched x)#
[no] description <text>
time-action <1:8> {always | {{mon | tue | wed | thu | fri | sat |
sun} <hh:mm>} {mon | tue | wed | thu | fri | sat | sun}
<hh:mm>}} {channel width | frequency | modulation}
no time-action <1:8>
Properties
Property name Description
Example:
Properties
Property name Description
Example:
The test cable hop upstream command tests the upstream cable hop for a particular
interface. The command is available only in Casa diagnostic mode.
In the Casa diagnostic mode, using the command leaves you in that mode. There is no
no form of the command.
Mode
(diag)#
Syntax
test cable hop upstream <slot>/<port>.<chan>/<lchan>
Properties
Property name Description
Example:
CASA# diag
Password:
CASA(diag)# test cable hop upstream
13/0.0/0
no spectrum rule on the channel or less
than hop period since last hop on
13/0.0/0
The test cable hop-cm-mode upstream command tests the upstream cable hop for a
CM mode spectrum rule for a particular interface by simulating an upstream poll
based on the polled number of low SNR modems and the corresponding spectrum rule
at the channel. The command is available only in Casa diagnostic mode.
In the Casa diagnostic mode, using the command leaves you in that mode. There is no
no form of the command.
Mode
(diag)#
Syntax
test cable hop-cm-mode upstream <slot>/<port>.<chan>/<lchan> <1:100>
<1:64>
Properties
Property name Description
Example:
CASA# diag
Password:
CASA(diag)# test cable hop-cm-mode
upstream 13/0.0/0 10 3
a simulated threshold hit in cm-mode is
sent to 13/0.0/0
Configuration summary
Table 19-1 lists and briefly describes the objects related to subscriber management.
The docsis submgt default command sets the subscriber management default settings
from the CMTS if the modem configuration file does not specify otherwise. The
packet filter group ID in each case refers to the docsis submgt ip-filter <1:65535>
value.
In the Casa configuration mode, using the command leaves you in that mode. There is
no no form of this command.
Mode
(config)#
Syntax
docsis submgt default active {off | on}
docsis submgt default cm-filter-downstream <0:65535>
docsis submgt default cm-filter-upstream <0:65535>
docsis submgt default cpe-filter-downstream <0:65535>
docsis submgt default cpe-filter-upstream <0:65535>
docsis submgt default learnable {off | on}
docsis submgt default max-ip <0:1023>
docsis submgt default max-ipv6-prefix <0:1023>
docsis submgt default mta-filter-downstream <0:65535>
docsis submgt default mta-filter-upstream <0:65535>
docsis submgt default ps-filter-downstream <0:65535>
docsis submgt default ps-filter-upstream <0:65535>
docsis submgt default stb-filter-downstream <0:65535>
docsis submgt default stb-filter-upstream <0:65535>
Properties
Property name Description
Example:
Properties
Property name Description
Example:
Example:
Example:
Example:
learnable {off | on} Allows the cable modem to learn its IP address. The
default is ON.
Example:
Properties
Property name Description
Example:
Example:
Example:
Example:
Properties
Property name Description
Example:
Example:
Example:
Example:
Shows the cable subscriber usage. This command depends on a cable traffic-policy
being defined. (See Chapter 3, Cable commands.)
The docsis submgt filters clear-all command removes all subscriber management IP
and TCP/UDP filters in the system. The command requires a confirmation response.
In the Casa configuration mode, using the command leaves you in that mode. There is
no no form of the command.
Mode
(config)#
Syntax
docsis submgt filters clear-all
Are you sure? (yes/no)
Clearing all submgt filters...
The docsis submgt ip-filter command sets a filter rule for DOCSIS subscriber
management to control IP packet forwarding to and from each cable modem, at the
CMTS. Each modem can be afforded a different subscriber management treatment.
Filtering criteria are maintained through SNMP at the CMTS.
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to disable the filter rule.
Mode
(config)#
Syntax
docsis submgt ip-filter <1:65535> <1:65535> {accept | deny}
docsis submgt ip-filter <1:65535> <1:65535> {accept | deny}
[src-ip <ip_addr> <mask>] [dst-ip <ip_addr> <mask> | dst-ipv6
<ipv6_addr>] [tos <0:255> <0:255> <0:255> [cm-intf-mask
<0:ffffff> | dst-port <0:65535> <0:65535> | protocol <0:257> |
src-port <0:65535> <0:65535>]] [protocol <0:257>] [src-port
<0:65535> <0:65535>] [dst-port <0:65535> <0:65535>]
[cm-intf-mask <0:ffffff>]
no docsis submgt ip-filter <1:65535> <1:65535>
Properties
Property name Description
Properties
Property name Description
Example:
Properties
Property name Description
Shows the IP filters for DOCSIS subscriber management. An accept appears as the
number 1 in the output.
Configuration summary
Table 20-1 lists and briefly describes the objects related to the upstream interface.
interface upstream
Purpose
In the Casa configuration mode, using the command moves you into interface
upstream configuration mode and identifies the upstream interface number.
Modes
(config)#
(config-if-ups X/Y.C)#
Syntax
(config)# interface upstream <slot>/<port>.<pchan>
(config-if-ups X/Y.C)#
channel-width <Hz>
description <text>
no description
frequency <5000000:100000000>
ingress-cancellation [<10:1000>]
no ingress-cancellation
interface upstream <slot>/<port>.<pchan>
logical-channel {0|1} [description <text>]
no logical-channel {0|1} description
logical-channel {0|1} channel-width <Hz>
logical-channel {0|1} class-id <0x0:0xffffffff>
logical-channel {0|1} data-backoff {<0:15> <0:15> | automatic}
no logical-channel {0|1} data-backoff
logical-channel {0|1} frame <1:32> <2:32> <64:128>
logical-channel {0|1} minislot <size>
logical-channel {0|1} power-offset <-10:10>
[no] logical-channel {0|1} pre-equalization [auto-reset]
logical-channel {0|1} profile <1:1024> [secondary-profile
<id_list>]
logical-channel {0|1} prov-attr-mask {<0x0:0xffffffff> | bonding |
highavailability | lowlatency}
Properties
Property name Description
Example:
Example:
CASA(config-if-ups 13/1.0)#
channel-width 6400000
Properties
Property name Description
Example:
Example:
Example:
CASA(config-if-ups 13/1.0)#
ingress-cancellation 500
CASA(config-if-ups 13/1.0)#
no ingress-cancellation
Example:
Properties
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 1
CASA(config-if-ups 13/1.0)#
no logical-channel 1
CASA(config-if-ups 13/1.0)#
no logical-channel 1 description
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 1 channel-width 6400000
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 1 class-id 0xFFFFFFFF
Properties
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 data-backoff 2 8
CASA(config-if-ups 13/1.0)#
no logical-channel 0 data-backoff
Properties
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 frame 24 12 64
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 minislot 64
Properties
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 power-offset 0
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 pre-equalization
CASA(config-if-ups 13/1.0)#
no logical-channel 0 pre-equalization
Properties
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 profile 3
secondary-profile 12,20,33
Properties
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 prov-attr-mask 0x0
logical-channel {0|1} Logical channels ranging data backoff start and end
ranging-backoff <0:15> values. As described for the logical channel
<0:15> data-backoff property, the CMTS specifies backoff
window values for both data transmission and initial
ranging.
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 ranging-backoff 2 8
CASA(config-if-ups 13/1.0)#
no logical-channel 0 ranging-backoff
Properties
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 ranging-priority 0x0
logical-channel {0|1} Shuts down the logical channel. The no form of the
shutdown command restarts the logical channel.
Example:
CASA(config-if-ups 13/1.0)#
logical-channel 0 shutdown
CASA(config-if-ups 13/1.0)#
no logical-channel 0 shutdown
CASA(config-if-ups 13/1.0)#
logical-channel spectrum-rule 1
CASA(config-if-ups 13/1.0)#
no logical-channel spectrum-rule
Properties
Property name Description
Example:
Properties
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
partial-service fec-threshold 3
CASA(config-if-ups 13/1.0)#
partial-service srn-threshold -1
Example:
CASA(config-if-ups 13/1.0)#
power-adjustment threshold 1
CASA(config-if-ups 13/1.0)#
no power-adjustment continue
Properties
Property name Description
power-level <-16:34> Output power level of the interface. The Casa CMTS
controls the output power levels of CMs 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 optimal setting is 0
dBmV. There is no no form of this command.
Example:
CASA(config-if-ups 13/1.0)#
power-level 0
Example:
Example:
Properties
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
small-signal-compensation
CASA(config-if-ups 13/1.0)#
no small-signal-compensation
Properties
Property name Description
Example:
Properties
Property name Description
Example:
CASA(config-if-ups 13/1.0)#
voice-bw-reserve max-calls 100
CASA(config-if-ups 13/1.0)#
no voice-bw-reserve
modulation-profile <id>
This command in configuration mode creates a modulation profile with the necessary
Forward Error Correction (FEC) bytes to help increase throughput when applied to a
downstream logical channel.
frequency 20000000
channel-width 3200000
ingress-cancellation
logical-channel 0 profile 2
logical-channel 0 minislot 2
logical-channel 0 pre-equalization
no logical-channel 0 shutdown
logical-channel 1 profile 2
logical-channel 1 minislot 2
logical-channel 1 pre-equalization
logical-channel 1 shutdown
no shutdown
Shows the Unsolicited Grant Service (UGS) statistics for the upstream interfaces.
Shows the upstream interface status for the controller, including the modulation
profile and SNR.
In the Casa configuration mode, using the upstream igmp filter command sets the
number of Internet Group Management Protocol (IGMP) packets to accept and the
number of seconds in a window. Use the no form of the command to remove the
upstream IGMP filter.
Mode
(config)#
Syntax
upstream igmp filter <0:5000> <1:5>
no upstream igmp filter
Properties
Property name Description
Example:
In the Casa configuration mode, using the upstream map size command sets the
minimum upstream MAP size. Use the no form of the command to remove the
upstream map size.
Mode
(config)#
Syntax
[no] upstream map size <2:10>
Properties
Property name Description
Example:
Shows the upstream interface configuration in a brief form. You can also use the
current modifier to get the current configuration.
frequency 20000000
channel-width 3200000
ingress-cancellation
logical-channel 0 profile 2
logical-channel 0 minislot 2
logical-channel 0 pre-equalization
no logical-channel 0 shutdown
logical-channel 1 profile 2
logical-channel 1 minislot 2
logical-channel 1 pre-equalization
logical-channel 1 shutdown
no shutdown
Shows the upstream interface status for the controller, including the modulation
profile and SNR.
Shows the upstream channel sets. The added | count-only / output modifier returns the
number of count lines only (the slash is a regular expression) to determine the number
of channel sets in use.
Shows the average signal-to-noise ratio (SNR) of the upstream channels in dB units.
modulation-profile
Configuration summary
Table 21-1 lists and briefly describes the objects related to video.
video qam export Sets the video QAM export configuration slot.
configuration slot
video session Sets the video QAM export configuration slot.
video signaling-mode Sets the signaling mode to either EDIS or NGOD.
video simulcrypt Sets the video DVB SimulCrypt algorithm.
video table Sets the system-wide Video On Demand (VOD) table
mode.
video Sets the time to elapse before detecting unicast VOD
unicast-session-loss-tim session loss.
eout
See the Casa Systems CCAP Video Edge User Guide for more details.
adduser
Purpose
The adduser command adds a user to the CMTS configuration. The command can be
used in the Casa enable or configuration mode. The users password is encrypted by
default. There is no no form of the command.
Modes
#
(config)#
Syntax
adduser <login_id> [privilege <0:15>]
New password: <pwd>
Reenter password: <pwd>
Properties
Property name Description
Properties
Property name Description
Example:
show user
Shows the user configuration. The same result can be achieved with the show run |
include user command.
interface video
Purpose
In the Casa configuration mode, using the command moves you into interface video
configuration mode and identifies the video interface number. Use the no form of the
command to remove the video interface or its property.
Modes
(config)#
(conf-if-video <id>)#
Syntax
(config)# [no] interface video <1:16>
(conf-if-video x)#
bandwidth <0:80000000>
description <text>
no description
edis control-source loopback <0:15>
no edis control-source
[no] gige <slot>/<port>
input-group-name <name>
no input-group-name
input-port-id <8|65535>
no input-port-id
ip {address <ip_addr> <mask> | igmp [version <1:3>]}
no ip {address | igmp}
[no] trunk <1:20>
vlan <1:4094>
no vlan
vrf forwarding <name>
no vrf forwarding
[no] xgige <slot>/<port>
Properties
Property name Description
Example:
Example:
Example:
Example:
Properties
Property name Description
gige <slot>/<port> Gige interface slot and port for the voice interface.
Example:
Example:
input-port-id <8|65535> Maximum input port ID, for EDIS the value is 8, for
Next Generation on Demand (NGOD) the value is
65535.
Example:
Example:
Properties
Property name Description
Example:
Example:
Example:
xgige <slot>/<port> XGigE interface slot and port for the voice interface.
Example:
Example
The following set of commands creates a video interface that operates in routing mode
and configures the GigE and XGigE interfaces. Note the absence of GigE or XGigE
ports configured for the video interface and the presence of IP addresses on the GigE
and XGigE interfaces.
video
Purpose
The video command sets video properties. Most commands are in Casa configuration
mode, although two commands are in enable mode. Some commands spawn other
configuration modes.
In the Casa configuration mode, using the command leaves you in that mode or moves
to a lower configuration mode. Use the no form of the command, where available, to
remove the video property.
Modes
#
(config)#
(conf-video-edis x)#
(conf-video-erm x)#
(conf-qam-domain x)#
(conf-video-session x)#
video cat-interval
Purpose
The video cat-interval command sets the maximum time in milliseconds between
adjacent conditional access tables (CATs). A CAT manages cypher keys for
decrypting restricted video streams used for maintaining regular key updates.
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to remove the property. There is no no form of the
command.
Mode
(config)#
Syntax
video cat-interval {<50:1000> | default}
Properties
Property name Description
Example:
video clk-drift-correction
Purpose
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to remove the property.
Mode
(config)#
Syntax
[no] video clk-drift-correction
video dejitter-interval
Purpose
The video dejitter-interval command sets the dejitter buffer size. Jitter is the
deviation from true periodicity of a presumed periodic signal, often in relation to a
reference clock source.
In the Casa configuration mode, using the command leaves you in that mode. There is
no no form of the command.
Mode
(config)#
Syntax
video dejitter-interval {<10:500> | default}
Properties
Property name Description
Example:
video edis
Purpose
The video edis command configures the Edge Device Interface Specification (EDIS)
index in the QAM domain that defines the session resource manager (SRM). Using
the EDIS protocol, the SRM controls video interfaces and QAM channels in the QAM
domain. One SRM could be from a source such as the Cisco Universal Session and
Resource Manager (USRM), or from another vendor. The EDIS index becomes part
of the video qam-domain definition. Using EDIS, the video runs in SRM mode.
In the Casa configuration mode, using the command puts you in video EDIS
configuration mode. Use the no form of the command to remove the property.
Modes
(config)#
(conf-video-edis <index>)#
Syntax
(config)# [no] video edis <1:8>
(conf-video-edis x)#
[no] announce
[no] description <text>
[no] ip-address <ip_addr>
[no] reset-indication
reset-interval <1:60>
[no] srm-type {bbnd-cvex | casa | cisco-usrm}
Properties
Property name Description
Example:
Properties
Property name Description
Example:
Example:
Example:
Properties
Property name Description
Example:
CASA(conf-video-edis 5)#
reset-indication
CASA(conf-video-edis 5)#
no reset-indication
Example:
Example:
video edis 2
ip-address 98.19.16.55
srm-type casa
reset-interval 5
announce
no reset-indication
video erm
Purpose
The video erm command configures Edge Resource Manager (ERM) properties.
ERM is part of the Next Generation On Demand (NGOD) specification and provides
reliable and optimized access to Edge QAM (EQAM) device resources. The ERM
interface is designed to manage the resource allocation of various EQAM resources
for DOCSIS and VoD activities. In addition, the EQAM device supports a
Registration Interface to ERM with the purpose of maintaining an accurate inventory
of resources availability in the EQAM devices. (See the Casa Systems CCAP Video
Edge User Guide for details.)
In the Casa configuration mode, using the command puts you in video ERM
configuration mode. Use the no form of the command to remove the property.
Modes
(config)#
(conf-video-erm <id>)#
Syntax
(config)#
[no] video erm <1:8>
(conf-video-erm x)#
connect-retry-time <1.0:60.0>
hold-timeout <30:300>
[no] host-address <addr> [port <1:65535>]
keepalive-timeout <1:120>
Properties
Property name Description
Example:
Properties
Property name Description
Example:
CASA(conf-video-erm 1)#
connect-retry-time 7.5
Example:
Properties
Property name Description
Example:
Example:
CASA(conf-video-erm 1)#
keepalive-timeout 20
video error-threshold
Purpose
The video error-threshold command sets the number of errors to occur before
detecting video degradation.
In the Casa configuration mode, using the command leaves you in that mode. There is
no no form of the command.
Mode
(config)#
Syntax
video error-threshold {<1:65535> | default}
Properties
Property name Description
Example:
video error-window
Purpose
The video error-window command sets the time period when sampling for degraded
video.
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to remove the property.
Mode
(config)#
Syntax
[no] video error-window {<1:30> | default}
Properties
Property name Description
Example:
video logging
Purpose
The video logging command selects one or more logging levels for capturing video
event messages to the system log file. By default, the system logs messages are
classified at the Warning, Informational, and Errors event levels. All other levels must
be interactively enabled with the command.
Before starting a video configuration, ensure that NTP, logging (IPv4 or IPv6), and
SNMP trap server IP addresses have been configured on the system. These services
are important for capturing and monitoring video session activity and for keeping
synchronized with NTP and other servers operating in the video network.
Note: It is recommended that you keep the debugging level disabled unless you are
actively troubleshooting a video problem. Keeping it enabled may impact
system performance when debugging processes are running.
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to remove the property.
Mode
(config)#
Syntax
[no] video logging {announce | d6-keep-alive | debugging | edis-ping |
edis-raw | edis-text | errors | informational | ngod-raw |
ngod-text | trace | warning}
Properties
Property name Description
Shows a video diagnostic session, if present. (The video mirror command is currently
available in diagnostic mode only.)
video module
Purpose
The video module command edits the QAM_8x96 video module per the specified
chassis slot. Only QAM_8x96 (NGOD) modules are supported for this command.
In the Casa configuration mode, using the command puts you in video module
configuration mode. Use the no form of the command to remove the property.
Modes
(config)#
(conf-video-module <id>)#
Syntax
[no] video module <0:13>
(conf-video-module x)#
bandwidth-update-threshold <0:2147483647>
cost <0:255>
[no] d6-enable
[no] description <text>
[no] edge-name <name>
[no] erm <1:8>
[no] location <state>.<city>.<loc_id>.<hub_name>
[no] ngod control-source loopback <0:15> [port <1:65535>]
[no] shutdown
[no] streaming-zone <name>
Properties
Property name Description
Example:
Properties
Property name Description
Example:
CASA(conf-video-module 10)#
bandwidth-update-threshold 0x70000000
Example:
Example:
Example:
Properties
Property name Description
edge-name <name> Edge name (instance ID) for the module, three digits
identifying the edge devices in a location, maximum
50 characters.
Example:
Example:
Example:
Properties
Property name Description
Example:
Example:
Example:
CASA(conf-video-module 10)#
streaming-zone SZNAME
CASA(conf-video-module 10)#
no streaming-zone
video module 10
d6-enable
no shutdown
no erm
no streaming-zone
location MA.Andover.01810.HUB1
edge-name 001
description "This video module is in Andover"
cost 1
bandwidth-update-threshold 0
video multicast-session-loss-timeout
Purpose
In the Casa configuration mode, using the command leaves you in that mode. There is
no no form of the command.
Mode
(config)#
Syntax
video multicast-session-loss-timeout {<1:172800> | default}
Properties
Property name Description
Example:
CASA(config)# video
multicast-session-loss-timeout 30
video ngod
Purpose
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to remove the property.
Mode
(config)#
Syntax
video ngod control-source bind
no video ngod control-source bind
video ngod vendor-string <name>
no video ngod vendor-string
Properties
Property name Description
Example:
Example:
video pat-interval
Purpose
The video pat-interval command defines the maximum time between adjacent
program association tables (PATs).
In the Casa configuration mode, using the command leaves you in that mode. There is
no no form of the command.
Mode
(config)#
Syntax
video pat-interval {<50:1000> | default}
Properties
Property name Description
Example:
video pid-remapping-mode
Purpose
In the Casa configuration mode, using the command leaves you in that mode. There is
no no form of the command.
Mode
(config)#
Syntax
video pid-remapping-mode {auto [start-pid <16:7900>] | pg-num-based}
Properties
Property name Description
{auto [start-pid <16:7900>] Sets the PID remapping mode to either automatic or
| pg-num-based} program-number-based, default auto. All elementary
PIDs from all input programs are multiplexed into the
same MPTS for a given QAM channel. The PIDs
must be unique for proper demultiplexing when the
MPTS reaches a QAM set-top box. For multiplexed
video QAM, there are two modes of operation:
Example:
video pktloss-window
Purpose
The video pktloss-window command sets the number of seconds to allow when
checking for loss of video packets.
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to remove the property.
Mode
(config)#
Syntax
video pktloss-window {<1:60> | default}
no video pktloss-window
Properties
Property name Description
Example:
video pme
Purpose
The video pme command sets the Privacy Mode Encryption (PME) properties. PME
is a proprietary protocol for video on demand (VOD) services that are widely
supported and implemented in North America. PME includes a conditional access
systems (CAS), edge QAMs, or Converged Cable Access Platform (CCAP)
equipment to provide program encryption to authorized subscribers. The C100G
CCAP provides full support for PME services, including software support for data
path, signaling and management. The encryption of the video stream is completed by
the C100G CCAP hardware.
Note that the separately described video pme certificate command is available only
in enable mode.
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to remove the property.
Mode
(config)#
Syntax
video pme contact <name>
no video pme contact
video pme device-id [2] <id> password [2] <pwd>
no video pme device-id
[no] video pme on
video pme proxy server <addr> [port <0:65535>]
no video pme proxy server
video pme proxy server keepalive <10:3600>
no video pme proxy server keepalive
video pme proxy server master [port <0:65535>]
no video pme proxy server master
video pme retry-time <1:1440>
no video pme retry-time
video pme source-interface loopback <0:15>
no video pme source-interface
video pme url <url>
no video pme url
Properties
Property name Description
contact <name> Contact email address for the PME device, as a text
string up to 64 characters. The configuration is
mapped to HTTP headers.
Example:
Example:
Example:
Properties
Property name Description
proxy server <addr> [port PME server IP address on the client side of the
<0:65535>] network. The specified IP address must be the
loopback IP. The default port is 50010. Ensure that
the port is unique to this application.
Example:
Example:
proxy server master [port PME proxy server to be the master server in the
<0:65535>] cluster. The default port is 50010; ensure that the
port is unique to this application.
Example:
Example:
Properties
Property name Description
Example:
url <url> URL of the ERS. Specify the URL as a text string of
up to 128 characters. The default URL is the
licensing ERS. Use the no form of the command to
revert to the current URL setting.
Example:
Shows filtered packet statistics (unicast, multicast, or both) from the active video
sessions. The rows argument sets the number of rows to show, with the starting and
ending row numbers, or shows the numerical count of the output rows.
Shows the file synchronization between the active and standby SMM.
The video pme certificate command installs an existing ERS certificate. Use the copy
command to install the certificate file to NVRAM before issuing the video pme
certificate command to install the certificate in the system.
This command is available only in Casa enable mode and using the command leaves
you in that mode. Use the no form of the command to deinstall the certificate.
Mode
#
Syntax
[no] video pme certificate
video pmt-interval
Purpose
The video pmt-interval command sets the maximum time between adjacent program
mapping tables (PMTs).
In the Casa configuration mode, using the command leaves you in that mode. There is
no no form of the command.
Mode
(config)#
Syntax
video pmt-interval {<50:10000> | default}
Properties
Property name Description
Example:
video qam-domain
Purpose
The video qam-domain command edits the QAM parameters for the Converged
Cable Access Platform (CCAP) device. A QAM domain is the equivalent of a video
service group in deployment.
In the Casa configuration mode, using the command puts you in video QAM domain
configuration mode. Use the no form of the command to remove the property.
Modes
(config)#
(conf-qam-domain <index>)#
Syntax
([no] video qam-domain <1:128>
(conf-qam-domain x)#
description <text>
no description
[no] edis <1:8>
[no] interface video <1:16>
qam-group <1:8> {<start_qam> <end_qam> | shared-channel <slot>/
<port>}
no qam-group <1:32>
video service group <0:4294967295>
no video service group
Properties
Property name Description
Example:
Properties
Property name Description
Example:
Example:
Example:
Properties
Property name Description
Example:
video service group Configures the video service group for the QAM
<0:4294967295> domain, default 0.
Example:
The video qam export configuration slot command sets the video QAM export
configuration slot to allow you to export the video topology into a vendor-specific
format. A file is generated for each EDIS assigned to a QAM domain on the selected
modules to the active SMMs /tftpboot/ directory in the format edisip.slot.srmtype.
Then copy the file using TFTP to NVRAM, usually from the loopback interface.
This command is available only in the Casa enable mode and using the command
leaves you in that mode. There is no no form of the command.
Modes
#
Syntax
video qam export configuration slot <list> [in-service-state]
[filename <file>] [srm-num <1:8>]
Properties
Property name Description
Example:
video session
Purpose
The video session command adds a video session on a given QAM channel without
the presence of a Session Resource Manager (SRM) external signaling (EDIS) server.
In the Casa enable mode, using the command puts you in video session configuration
mode. Use the no form of the command to remove the session, session ID, or PID
remapping property. The no video sessions command removes the channel, port, or
shared-channel from the session.
Modes
#
(conf-video-session <index>)#
Syntax
# video session <1:9999>
(conf-video-session x)#
bitrate <bps>
in-program-number <0:65535>
input-port <1:8>
ip-address <ip_addr> [<src_1>] [<src_2>] [<src_3>]
out-program-number {<1:65535> | data}
[no] pid-remapping
qam-channel <slot>/<port>/<chan>
qam-channels {all | channel-list <qam_chan_list> | module <slot> |
port <slot>/<port>}
shared-channel <slot>/<s_chan>
udp-port <1:65535>
[no] video session [id] <id>
Properties
Property name Description
Example:
Example:
Example:
CASA(conf-video-session 1)#
in-program-number 0
Example:
Properties
Property name Description
Example:
Example:
CASA(conf-video-session 1)#
out-program-number data
Example:
CASA(conf-video-session 1)#
pid-remapping
CASA(conf-video-session 1)#
no pid-remapping
Example:
Properties
Property name Description
Example:
CASA(conf-video-session 1)#
qam-channels all
Example:
CASA(conf-video-session 1)#
shared-channel 0
Example:
Properties
Property name Description
video session [id] <id> Defines another session ID. The no form of the
command can be used if combined with the id
keyword.
Example:
Examples
Shows summary information for a particular video session. The ID must be the full
20-character hex value.
Input Stream:
Uptime : 0 days 01:56:27
Data State : On
Packets Detected : Yes
PSI Detected : Yes
Bitrate Requested : 9081000 bps
Bitrate Detected Avg: 9080000 bps
Bitrate Detected Max: 9108000 bps
Jitter Detected Avg : 2 ms
Jitter Detected Max : 25 ms
Stream Type : SPTS
Destination IP : 199.175.2.1
Destination UDP : 1025
Input Port : xgige 6/5
ContinuityErrors : 0 SyncLossPackets : 0
PcrIntervalExceeds : 19
Shows brief information for all current video sessions. per service group information
for the current video session. The rows argument sets the number of rows to show,
with the starting and (optional) ending row numbers. With the <end> number omitted,
the output shows the starting row through the remaining rows.
Shows per service group information for the current video session.
Shows filtered packet statistics (unicast, multicast, or both) from the active video
sessions. The rows argument sets the number of rows to show, with the starting and
(optional) ending row numbers, or shows just the numerical count of the rows. With
the <end> number omitted, the output shows the starting row through the remaining
rows.
video signaling-mode
Purpose
The video signaling-mode command sets the signaling mode to either Edge Device
Interface Specification (EDIS) or Next Generation on Demand (NGOD).
In the Casa configuration mode, using the command leaves you in that mode. There is
no no form of the command.
Mode
(config)#
Syntax
video signaling-mode {edis | ngod}
Properties
Property name Description
Example:
video simulcrypt
Purpose
In the Casa configuration mode, using the command leaves you in that mode, except
defining the Entitlement Control Message Generator (ECMG) enters ECMG
configuration mode. Use the no form of the command to remove each property.
Modes
(config)#
(config-ecmg <name>)#
Syntax
(config)#
video simulcrypt cp <10:86400>
no video simulcrypt cp
[no] video simulcrypt ecmg <name>
(config-ecmg x)#
access-criteria <hex_string>
ip-address <ip_addr>
priority <1:8>
protocol-version <2:3>
subsystem-id <0:65535>
system-id <1:65535>
tcp-port <1:65535>
(config)#
video simulcrypt ecmg-retries <1:5>
no video simulcrypt ecmg-retries
video simulcrypt ecmg-timeout <1:60>
no video simulcrypt ecmg-timeout
video simulcrypt eis tcp-port <1024:65535>
no video simulcrypt eis tcp-port
video simulcrypt {session-mode | tier-mode}
[no] video simulcrypt source-interface loopback <0:15>
Properties
Property name Description
Example:
Example:
Properties
Property name Description
access-criteria Sets the access criteria for the ECMG, which applies
<hex_string> only to SimulCrypt tier-mode encryption and has no
effect in session-mode encryption. The hex string
should omit the 0x prefix, such as 0123, which
requires the leading 0 and is maximum length 64.
There is no no form of the command.
Example:
CASA(config-ecmg E1)#
access-criteria 0123
Example:
CASA(config-ecmg E1)#
ip-address 192.168.8.8
Example:
Example:
CASA(config-ecmg E1)#
protocol-version 2
Properties
Property name Description
Example:
Example:
tcp-port <1:65535> TCP port for ECMG, which cannot be one of the
well-known ports. There is no no form of the
command.
Example:
ecmg-retries <1:5> Sets the retry time for ECMG communication. Use
the no form of the command to revert to the default
3 retries.
Example:
Properties
Property name Description
Example:
eis tcp-port <1024:65535> Sets the TCP port for EIS-SCS communication. The
configuration applies only to session-mode
encryption. The configuration cannot use the
well-known ports in the range used by other
applications. For example, PCMM port 3918 and
IPDR port 4737 cannot be used.
Example:
Example:
Properties
Property name Description
Example:
ECMG ECMG1:
System Id : 1
Subsystem Id : -1
IP Address : 192.168.8.8
TCP Port : 0
Priority : 7
Protocol Version : 3
Connection Status : Not connected
video table
Purpose
The video table command sets the system-wide Video On Demand (VOD) table
mode. Unlike external mode, table mode VOD does not require any EDIS signaling.
The eQAM simply parses the destination UDP port of the incoming unicast SPTS to
decide what QAM channel and program number to use. The eQAM can be configured
to operate in one of four table modes: mode0, mode1, mode2, and mode3:
In the Casa configuration mode, using the command leaves you in that mode. Use the
no form of the command to remove the property.
Mode
(config)#
Syntax
video table {mode0 | mode1 | mode2 | mode3}
no video table
Properties
Property name Description
{mode0 | mode1 | mode2 | Sets the system-wide VOD table mode to mode0
mode3} (qqqqqqqq qqqppppp), mode1 (1qqqqqqq
qqqppppp), mode2 (1qqqqqqq qqqpppp0), or mode3
(qqqqqqqq pppppppp). If omitted, sessions are
exclusively managed by the SRM. Both table mode
and SRM mode can coexist.
Example:
video unicast-session-loss-timeout
Purpose
In the Casa configuration mode, using the command leaves you in that mode. There is
no no form of the command.
Mode
(config)#
Syntax
video unicast-session-loss-timeout {<1:172800> | default}
Properties
Property name Description
Example:
CASA(config)# video
unicast-session-loss-timeout 60
video edis 1
!end of video edis configurations
!video ngod configurations begin
!end of video ngod configurations
!video module configurations begin
video module 4
video module 10
!end of video module configurations
interface video 1
video qam-domain 1
video service group 1
interface video 1
video qam-domain 56
CMTS
RF Cable Configuration Guide and
Command Reference
2015 Casa Systems, Inc.
All rights reserved.
DOC-3022-01