CMTS RF Config - GD - CMD - Reference - R6.5.2 - 04 - 10 - 2015 PDF

CMTS
RF Cable Configuration Guide

and Command Reference
For Casa Software Releases to 6.5.2
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
Chapter 1. RF cable operations overview

About this chapter ............................................................................................. 1-1
.
CMTS installation in the network topology ........................................................ 1-2 .
Cable modem initialization and learning ........................................................... 1-6 .
Cable modem initial ranging and registration .................................................... 1-6 .
Cable modem provisioning and configuration ................................................... 1-7 .
Cable modem power considerations ................................................................. 1-9 .
Upstream channel descriptors and MAPs ......................................................... 1-9 .
UCD and MAP operations ................................................................................. 1-9 .
Channel bonding and service group operations ............................................. 1-13 .
Physical fiber node vs. DOCSIS terminology .................................................. 1-14 .
Load balancing CMTS traffic ........................................................................... 1-14 .
Terminology covered in this chapter ............................................................... 1-18 .
Configuration examples .................................................................................. 1-23 .
Chapter 2. Baseline Privacy Interface

BPI commands description ............................................................................... 2-1 .
cable privacy ............................................................................................... 2-3

.
cable sa-des-tlvlen-2 ................................................................................. 2-10 .
privacy hotlist ............................................................................................ 2-11

.
shared-secondary-secret .......................................................................... 2-13 .
shared-secret ............................................................................................ 2-14 .
Casa Systems CMTS

iv RF Cable Configuration Guide and Command Reference
Contents
Chapter 3. Cable commands

Cable commands description ............................................................................ 3-1 .
cable admission-control .............................................................................. 3-5 .
cable arp filter ............................................................................................. 3-8

.
cable dhcp filter ........................................................................................... 3-9.
cable dhcp-leasequery filter ...................................................................... 3-10 .
cable dhcpv6-leasequery filter .................................................................. 3-12 .
cable diaglog ............................................................................................. 3-14 .
cable dsx authorization ............................................................................. 3-16 .
cable dynamic-service-flow ....................................................................... 3-17 .
cable ecn 770 ............................................................................................ 3-19 .
cable event ................................................................................................ 3-20.
cable flap-list ............................................................................................. 3-26

.
cable host authorization ............................................................................ 3-30 .
cable icmp filter ......................................................................................... 3-31 .
cable igmp filter ......................................................................................... 3-32 .
cable igmp static-group ............................................................................. 3-33 .
cable igmp vrf ............................................................................................ 3-36 .
cable mdd ................................................................................................. 3-38 .
cable mirror ............................................................................................... 3-41.
cable modem ............................................................................................ 3-42 .
cable monitor-period ................................................................................. 3-43 .
cable partial-service .................................................................................. 3-44 .
cable privacy ............................................................................................. 3-47 .
cable proxy-arp unknown .......................................................................... 3-48 .
cable qos ................................................................................................... 3-49

.
cable rcp-select ......................................................................................... 3-55 .
cable sa-des-tlvlen-2 ................................................................................. 3-56 .
cable sec ................................................................................................... 3-57

.
cable service attribute withold-TLVs peak-rate ......................................... 3-64 .
cable service-class .................................................................................... 3-65 .
cable service-flow active-timeout .............................................................. 3-76 .
Casa Systems CMTS

RF Cable Configuration Guide and Command Reference v
Contents
cable service-type-id ..................................................................................3-77 .
cable spectrum ..........................................................................................3-78 .
cable subscriber over-consume trap .........................................................3-80 .
cable tcc us-bonding-disable .....................................................................3-81 .
cable traffic-policy ......................................................................................3-82 .
cable upstream ..........................................................................................3-88 .
default cable modem vendor .....................................................................3-90 .
reg-rsp-original-upstream-action ...............................................................3-91 .
Chapter 4. Cable modem commands

Cable modem commands description ...............................................................4-1 .
cable modem ...............................................................................................4-3 .
cable modem <mac_addr> dbc ...................................................................4-4 .
cable modem <mac_addr> dcc ...................................................................4-7 .
cable modem <mac_addr> l2vpn-map ........................................................4-9 .
cable modem <mac_addr> mpls vpnid ......................................................4-10 .
cable modem <mac_addr> qos-override ...................................................4-11 .
cable modem <mac_addr> ucc upstream .................................................4-12 .
cable modem authorization .......................................................................4-13 .
cable modem deny ....................................................................................4-14 .
cable modem excessive-request detection ...............................................4-15 .
cable modem offline aging .........................................................................4-16 .
cable modem remote-query .......................................................................4-17 .
cable modem rip authentication-bypass ....................................................4-18 .
cable modem vendor .................................................................................4-19 .
cm-ctrl ........................................................................................................4-23
.
default cable modem vendor .....................................................................4-25 .
Casa Systems CMTS

vi RF Cable Configuration Guide and Command Reference
Contents
Chapter 5. Channel bonding

Channel bonding commands description .......................................................... 5-1 .
bonding-group ............................................................................................. 5-5 .
dbg_id_set qam ........................................................................................ 5-11 .
rcc ............................................................................................................. 5-12

.
rcp ............................................................................................................. 5-15

.
service group ............................................................................................ 5-18 .
Chapter 6. Channel blocks

Channel block commands description .............................................................. 6-1 .
channel-block downstream mac-domain .................................................... 6-2 .
channel-utilization-interval .......................................................................... 6-4 .
Chapter 7. Customer premises equipment classes

CPE classes commands description ................................................................. 7-1 .
cpe-class ..................................................................................................... 7-2 .
Chapter 8. DOCSIS MAC interface

DOCSIS MAC interface commands description ............................................... 8-1 .
interface docsis-mac ................................................................................... 8-2 .
Chapter 9. DOCSIS Set-Top Gateway

DSG commands description ............................................................................. 9-1 .
dsg channel-list ........................................................................................... 9-4 .
dsg client-list ............................................................................................... 9-6 .
dsg dcd-global-enable ................................................................................. 9-8 .
dsg timer-id ................................................................................................. 9-9 .
dsg tunnel ................................................................................................. 9-11 .
dsg tunnel-group ....................................................................................... 9-15 .
dsg unicast-port ........................................................................................ 9-17 .
dsg vendor-param-id ................................................................................. 9-18 .
Casa Systems CMTS

RF Cable Configuration Guide and Command Reference vii
Contents
Chapter 10. Load balancing

Load balancing commands description ...........................................................10-1 .
load-balance ..............................................................................................10-4 .
load-balance basic-rule .............................................................................10-6 .
load-balance enable ..................................................................................10-8 .
load-balance exclusion list .......................................................................10-10 .
load-balance execution-rule ....................................................................10-12 .
load-balance general-group .....................................................................10-18 .
load-balance permit dbc-chg-prim-ds ......................................................10-24 .
load-balance policy ..................................................................................10-25 .
load-balance restricted-cm ......................................................................10-27 .
load-balance restricted-group ..................................................................10-30 .
Chapter 11. Modulation profiles

Modulation profile commands description ....................................................... 11-1 .
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.
Chapter 12. Multicast operations

Multicast operation commands description .....................................................12-1 .
mcast-classifier ds_chan ...........................................................................12-3 .
mcast-service-flow ds_chan ......................................................................12-5 .
multicast authorization ...............................................................................12-8 .
multicast default grp-service-class-name ................................................12-13 .
multicast group ........................................................................................12-14 .
Casa Systems CMTS

viii RF Cable Configuration Guide and Command Reference
Contents
multicast load-balance initial-tech ........................................................... 12-21 .
multicast max channel-util ....................................................................... 12-23 .
multicast single_said ............................................................................... 12-24 .
multicast switch over time ....................................................................... 12-25 .
Chapter 13. PacketCable

PacketCable commands description ............................................................... 13-1 .
packetcable ............................................................................................... 13-2 .
Chapter 14. Policy commands

Policy commands description ......................................................................... 14-1 .
application ................................................................................................. 14-2.
class .................................................................................................... 14-3

.
policy ................................................................................................. 14-11.
class-map ................................................................................................ 14-14 .
policy-map ............................................................................................... 14-16 .
Chapter 15. QAM 8x8 configuration

QAM 8-channel configuration ......................................................................... 15-1 .
interface qam ............................................................................................ 15-2 .

QAM 96-channel configuration ....................................................................... 16-1 .
interface qam .......................................................................................... 16-11 .
module .................................................................................................... 16-26 .
Chapter 17. Quality of service

QoS commands description ............................................................................ 17-1 .
cops pdp-ip ............................................................................................... 17-4 .
qos-profile ................................................................................................. 17-5 .
Casa Systems CMTS

RF Cable Configuration Guide and Command Reference ix
Contents
Chapter 18. Spectrum management

Spectrum management commands description ..............................................18-1 .
channel-utilization-interval .........................................................................18-6 .
hop period ..................................................................................................18-7 .
spectrum ....................................................................................................18-9 .
spectrum analysis ....................................................................................18-10 .
spectrum rule ...........................................................................................18-14 .
spectrum scheduler .................................................................................18-23 .
test cable hop upstream ..........................................................................18-25 .
test cable hop-cm-mode upstream ..........................................................18-26 .
Chapter 19. Subscriber management

Subscriber management commands description ............................................19-1 .
docsis submgt default ................................................................................19-2 .
docsis submgt filters clear-all ....................................................................19-7 .
docsis submgt ip-filter ................................................................................19-8 .
Chapter 20. Upstream interface

Upstream interface commands description .....................................................20-1 .
interface upstream .....................................................................................20-2 .
upstream igmp filter .................................................................................20-20 .
upstream map size ..................................................................................20-21 .
Chapter 21. Video

Video commands description ..........................................................................21-1 .
adduser ......................................................................................................21-4.
interface video ...........................................................................................21-6 .
video ........................................................................................................21-12
.
video cat-interval .....................................................................................21-13 .
video clk-drift-correction ..........................................................................21-14 .
video dejitter-interval ...............................................................................21-15 .
video edis ................................................................................................21-16 .
video erm .................................................................................................21-20 .
Casa Systems CMTS

x RF Cable Configuration Guide and Command Reference
Contents
video error-threshold ............................................................................... 21-23 .
video error-window .................................................................................. 21-24 .
video logging ........................................................................................... 21-25 .
video module ........................................................................................... 21-27 .
video multicast-session-loss-timeout ...................................................... 21-32 .
video ngod .............................................................................................. 21-33 .
video pat-interval ..................................................................................... 21-35 .
video pid-remapping-mode ..................................................................... 21-36 .
video pktloss-window .............................................................................. 21-38 .
video pme ............................................................................................... 21-39 .
video pme certificate ............................................................................... 21-44 .
video pmt-interval .................................................................................... 21-45 .
video qam-domain .................................................................................. 21-46 .
video qam export configuration slot ........................................................ 21-51 .
video session .......................................................................................... 21-53 .
video signaling-mode .............................................................................. 21-61 .
video simulcrypt ...................................................................................... 21-62 .
video table ............................................................................................... 21-68

.
video unicast-session-loss-timeout ......................................................... 21-70 .
Casa Systems CMTS

xi
Preface
About this guide

The Casa Systems CMTS NSI Configuration Guide and Command Reference guide
is intended for system administrators, support engineers, and operators who are
responsible for configuring and managing Casa CMTS products. Specifically, this
manual covers the commands that operate on the DOCSIS RF cable side of the
CMTS, such as configuring upstream and downstream channels, spectrum
management, modulation profiles, PacketCable, quality of service policies, subscriber
management, and video.
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.
The following topics are covered in this guide:
For information about See
Overview of RF cable operations Chapter 1.

Baseline Privacy Interface Chapter 2.
Cable and related commands Chapter 3.
Casa Systems CMTS

xii RF Cable Configuration Guide and Command Reference
Preface
For information about See
Cable modem and related commands Chapter 4.

Channel bonding commands Chapter 5.
Channel blocks and channel utilization commands Chapter 6.
CPE classes commands Chapter 7.
DOCIS MAC interface commands Chapter 8.
DOCSIS Set-Top Gateway commands Chapter 9.
Load balancing commands Chapter 10.
Modulation profiles commands Chapter 11.
Multicast operations commands Chapter 12.
PacketCable commands Chapter 13.
Policy commands (application, class-maps) Chapter 14.
QAM8x8 interface commands Chapter 15.
QAM8x96 interface commands Chapter 16.
Quality of service (QoS) commands Chapter 17.
Spectrum management commands Chapter 18.
Subscriber management commands Chapter 19.
Upstream interface commands Chapter 20.
Video commands Chapter 21.
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
Casa Systems CMTS

RF Cable Configuration Guide and Command Reference xiii
Preface
Supported software releases

The following software releases are supported in this latest revision:
5.4.21, 6.1.2, 6.1.3, 6.4.1, 6.4.2, 6.4.3, and 6.5
1G.1 (for Casa C1G systems with customized functionality; see the Casa Systems
C1G CMTS Release Notes for information)
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 CMTS

xiv RF Cable Configuration Guide and Command Reference
Preface
Casa Systems C10G/C10200 CMTS Quick Installation

Casa Systems C100G CMTS Quick Installation
Casa Systems CMTS Operations and Administration Guide
Casa Systems SNMP MIBs and Traps Reference
Casa Systems CCAP Video Edge User Guide
Casa Systems CMTS Network Solutions Guide
Casa Systems CMTS NSI Configuration Guide and Command Reference
Casa Systems CMTS RF Cable Configuration Guide and Command Reference
(this manual)
Casa Systems CMTS Troubleshooting and Diagnostics Guide
Casa Systems CMTS Release 6.5 Features Guide
Casa Systems C1G CMTS Release Notes
Casa Systems CMTS Release Notes
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.
Effective September 1, 2013, technical documentation CD-ROMs are no

longer shipped with Casa CMTS hardware.
Casa Systems CMTS

RF Cable Configuration Guide and Command Reference xv
Preface
Conventions used in Casa documentation

Key Convention Function Example
boldface font Commands and keywords are in Enter abc

boldface.
Italic font Emphasized terminology is in italics. burst profile
brackets [ ] Elements in square brackets are [<ip_addr>]
optional.
braces {x | y | z} Indicates a required argument with a {enabled | disabled}
choice of values; choose one.
brackets [x | y | z] Indicates an optional argument with a [abc | 123]
choice of values; choose one.
vertical bar | Separates parameter values. Same as {TCP | TLS}
or.
string A non-quoted set of characters. Do not abc
use quotation marks () around the
string as the string will include the
quotation marks.
screen font CLI sessions and information the CASA(config)#
system displays are in screen font.
boldface screen font Information you must enter is in
boldface screen font.
<variable> Arguments for which you supply values <as_number>
are enclosed in angle brackets.
Multi-word arguments are indicated
with underscore-separated words.
<value:value> Arguments may include a range of <0:65535>
values, with the minimum and
maximum values separated by a colon.
Casa Systems CMTS

xvi RF Cable Configuration Guide and Command Reference
Preface
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
Casa Systems CMTS

RF Cable Configuration Guide and Command Reference xvii
Preface
DCD Downstream Channel Descriptor (QAM)

DCTS Digital Cable Termination System
DCU DOCSIS Control and Upstream module
DES Data Encryption Standard
DNS Domain Name System/Server
DHCP Dynamic Host Configuration Protocol
DLF Destination lookup failure (packets)
DQM DOCSIS QAM Module
DSA Digital Signature Algorithm (SSH)
DSCP Differentiated Services Code Point
DSG DOCSIS Set-Top Gateway specification (QAM)
DSID Downstream Service Identifier (DOCSIS MAC)
DSX Dynamic Service Change (DSA, DSC, and DSD)
DVB Digital Video Broadcasting
EAE Early Authentication Encryption (DOCSIS MAC)
EAM Emergency Alert Messsage
eBGP External Border Gateway Protocol
ECMG Entitlement Control Message Generator
EDIS Edge Device Interface Specification
EDRCA EuroDOCSIS Root Certificate Authority
EIS Event Information Scheduler (SimulCrypt)
EQAM Edge QAM Module
ERM Edge Resource Manager (NGOD)
ERS Encryption Renewal System (PME)
FEC Forward Error Correction; Forwarding Equivalence Class (LDP)
FFT Fast Fourier Transform
FSM Finite State Machine
GigE Gigabit Ethernet
GRE Generic Routing Encapsulation (upstream interface)
IGMP Internet Group Management Protocol (interfaces)
IGP Interior Gateway Protocol
IKE Internet Key Exchange (IPsec)
Casa Systems CMTS

xviii RF Cable Configuration Guide and Command Reference
Preface
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)
Casa Systems CMTS

RF Cable Configuration Guide and Command Reference xix
Preface
NSEL NSAP Selector (IS-IS)

NSF Non-Stop Forwarding (OSPF)
NSI Network System Interface
NSM Network and System Management
NTP Network Time Protocol
OSPF Open Shortest Path First routing protocol
OUI Organizational Unique Identifier
PAP Password Authentication Protocol (AAA)
PAT Program Association Table (video)
PCMM PacketCable Multimedia (policies)
PDP Policy Decision Point (COPS)
PDU Protocol data unit (interfaces)
PE Provider Edge
PEP Policy Enforcement Point (COPS)
PID Packet ID (interfaces)
PIM-SM Protocol Independent Multicast in Sparse Mode
PME Privacy Mode Encryption (video)
PMT Program Mapping Table
PPS Packets per second
PS Portal Server
PSK Pre-Shared Key (IPsec)
QAM Quadrature Amplitude Modulation
QoS Quality of Service
QPSK Quadrature Phase Shift Keying
RADIUS Remote Authentication Dial In User Service
RCP Receive Channel Profile
RD Route Distinguisher (VRF)
RIP Routing Information Protocol
RKS Record Keeping Server
RP Rendezvous Point (PIM-SM)
RPC Remote Procedure Call (SNMP)
SRM Session Resource Manager
Casa Systems CMTS

xx RF Cable Configuration Guide and Command Reference
Preface
RSA Rivest, Shamir and Adleman cryptographic algorithm (SSH)

RT Route target (BGP)
SA Security Association (BPI)
SAV Source Address Verification
SCDMA Synchronous Code Division Multiple Access (upstream)
SCS SimulCrypt Synthesizer
SDV Switched Digital Video
SHA Secure Hash Algorithm
SI Service Information (QAM)
SID Service identifier (DOCSIS MAC)
SMM Switch and Management Module
SNP Sequence Number PDU
SNR Signal-to-noise ratio
SOO Site-of-origin (BGP)
SPD Security Policy Database (IPsec)
SPF Shortest Path First algorithm
SPI Security Policy Index (IPsec)
SPT Shortest Path Tree (PIM-SM)
SRM Session Resource Manager
SSH Secure Shell
SSM Source-Specific Multicast (PIM-SM)
STM Subscriber Traffic Management
TACACS Terminal Access Controller Access Control System
TCP Transmission Control Protocol
TDMA Time Division Multiple Access
TEK Traffic Encryption Key (BPI)
TLV Type-length-value encoding scheme
TOS Type of service
TPID Tag Protocol Identifier (VLAN)
UCC Upstream Channel Change
UCD Upstream Channel Descriptor (DOCSIS MAC)
UDC Upstream Drop Classifier (DOCSIS MAC)
Casa Systems CMTS

RF Cable Configuration Guide and Command Reference xxi
Preface
UGS Unsolicited Grant Service (policies)

URL Uniform Resource Locator
USM User-based Security Model (SNMP)
VLAN Virtual Local Area Network
VLSM Variable Length Subnet Mask
VOD Video On Demand
VPLS Virtual Private LAN Service
VRF Virtual Routing and Forwarding
WFQ Weighted Fair Queuing QoS algorithm
XGigE XGigabit Ethernet
Casa Systems CMTS

1-1
Chapter 1. RF cable operations

overview
About this chapter

This chapter provides information on how the CMTS operates in the cable headend
network. It covers the following topics:
Topic Page
CMTS installation in the network topology 1-2

About the Casa CMTS as a headend device 1-4
Understanding the CMTS as a DOCSIS MAC domain 1-4
Cable modem initialization and learning 1-6
Cable modem initial ranging and registration 1-6
Cable modem provisioning and configuration 1-7
Cable modem initialization and configuration process 1-8
Cable modem power considerations 1-9
UCD and MAP operations 1-9
Channel bonding and service group operations 1-13
Physical fiber node vs. DOCSIS terminology 1-14
Load balancing CMTS traffic 1-14
Dynamic channel and bonding changes 1-14
Load balancing policies 1-14
Static vs. dynamic load balancing 1-17
Applying exclusion lists 1-17
Casa Systems CMTS

1-2 RF Cable Configuration Guide and Command Reference
CMTS installation in the network topology
Topic Page
Terminology covered in this chapter 1-18

Configuration examples 1-23
Basic configuration 1-24
General configuration 1-25

Figure 1-1 illustrates a sample cable headend network and a typical cable topology.
This example shows a Casa C3200 CMTS DOCSIS MAC domain with one
downstream interface and multiple upstream interfaces to a fiber network, network
accessible servers, routing to the Internet, content networks providing modulated
signals downstream, and a distribution area topology with a single cable modem
customer with attached customer premises equipment (CPEs).
Casa Systems CMTS

RF cable operations overview 1-3
Figure 1-1. Example D1.0 cable network topology with Casa CMTS
Cable headend network Servers

TFTP DHCP ToD Content networks
Internet - Streaming video/
video-on demand
servers
- News and sports feeds
- Network and satelite TV
Network edge router/ - Local TV
gateway to Internet
Hub
Modulated digital signals
Casa CMTS
CASA SYSTEMS SYS 3 4 5
Single
Multiple C3000 CCASA
ASA
ALM 0 1 2
downstream
upstream channel Forward channel lineup
channels
DOCSIS MAC domain (1 x N)

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
Coaxial cable Cable modem

DS
US
D3.0, 2.0, PC
1.1, 1.0
Phone
Distribution over cable access
network to home subscribers
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.
Casa Systems CMTS

About the Casa CMTS as a headend device
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.
Understanding the CMTS as a DOCSIS MAC domain
The Casa CMTS comprises up to 64 DOCSIS MAC domains depending on the

particular model of CMTS you are integrating. The RFI, which consists of at least one
downstream channel and multiple upstream channels, is the DOCSIS Media Access
Control (MAC) domain. Todays cable networks and cable modems support the
various implementations of DOCSIS since its acceptance by cable providers in the
late 1990s, including:
DOCSIS 1.0 One downstream, multiple upstream channels in 1xN

configuration. Baseline privacy interface (BPI); cable modem identification by
service ID (SID).
configuration. Baseline privacy interface plus (BPI+); cable modem identification
by service flow. QoS provisioning services for reliable voice and video streaming.
QPSK modulation only.
Casa Systems CMTS


configuration. QAM64 modulation with downstream channel width at 6.4 MHz.
Improved performance and speed at 30 Mbps on the upstream channels.
DOCSIS 3.0 Multiple downstream channels, multiple upstream channels in
MxN configuration. Channel bonding of up to 24 channels for increased
downstream bandwidth; logical bonding of channels from the MAC domain to
compatible DOCSIS 3.0 cable modems supporting multiple transmitters and
receivers. See Figure 1-2.
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.
Figure 1-2. DOCSIS 3.0 topology with multiple downstream channels
DOCSIS 3.0 Multiple Modulated digital signals

MAC domain (M x N) downstream from content providers
channels
CASA SYSTEMS SYS 3 4 5
C3000 CCASA
ASA
ALM 0 1 2
Multiple
Forward channel lineup
upstream
channels
Television and
Diplexer/filter Forward combiner channel lineup
LOW | HIGH
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
Casa Systems CMTS

Cable modem initialization and learning
Cable modem initialization and learning

In order for cable modems in the subscriber distribution areas to establish two-way
communication with the CMTS, cable modems must first initialize by listening and
learning how to receive transmissions from the CMTS downstream channels, and then
by learning how to transmit to the CMTS over the upstream channels.
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.
Cable modem initial ranging and registration

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.
Casa Systems CMTS

Cable modem provisioning and configuration
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.

Provisioning servers at the headend are necessary for the cable modem to properly
complete the initialization process, as follows:
1. The cable modem initiates a request to a dynamic host configuration protocol

(DHCP) server for an IPv4 or IPv6 address assignment. DHCP DISCOVER,
OFFER, REQUST, and ACKNOWLEDGMENT packets are exchanged between
the modem and the DHCP server. The DHCP acknowledgment message returns
the offered IP configuration to the requesting cable modem.
2. Once the cable modem is assigned an IP address, the modem 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.
Casa Systems CMTS

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.
Figure 1-3. Cable modem initialization and configuration process

TFTP DHCP
Modem IP config MAC management message

config file to cable modem
188-byte
MPEG-2 transport
stream (42 Mbps)
Multiple Hub PID 1FFE MAC domain

upstream source
Casa CMTS Single
channels SYNC
CASA SYSTEMS
C3000 CCASA
ASA
SYS 3 4 5
ALM 0 1 2 downstream
channel UCD1
Modem initial UCD2
ranging
UCD3
and registration
Forward UCD4
combiner SYNC
Diplexer/filter
LOW | HIGH MAP1
MAP2
QAM64 or QAM256 MAP3
Fiber network and modulation
amplifier MAP4
Coaxial cable
DS
US
Cable modem frequency,
power, and delay adjustments.
Modem self-configuration using

file from TFTP server
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.
3. IP configuration downloaded to cable modem.
4. Modem receives modem config file from TFTP server and configures itself. Optional
time-of-day packet exchange.
Casa Systems CMTS

Cable modem power considerations
Cable modem power considerations

In the downstream, if you have eight channels turned on instead of four, the
per-channel power should be 3 dB less than if you had four channels on. The power
setting is total output power from the port (the sum of all channels power). If you
double the number of channels, their per-channel power must drop by 3 dB. Note also
that the DOCSIS specification lowers the maximum required per-channel output
power by 3 dB for every doubling of channels above 4.
In the upstream, you should not see any power difference, regardless of the number of
channels enabled.
Upstream channel descriptors and MAPs

As cable modems continually listen for downstream MAC management messages
from the CMTS, the MPEG-2 transport stream carries the information that instructs
the modem on how to transmit over the upstream channels. A cable modem uses
upstream channel descriptors (UCDs) and associated MAPs carried in the MPEG-2
transport stream to tell the modem how and when to transmit to the CMTS.
UCD and MAP operations

The CMTS MAC domain sends one upstream channel descriptor (UCD) for every
upstream channel. If there are four upstream channels configured at the CMTS MAC
domain, the MPEG-2 transport stream will contain four UCDs, as illustrated in
Figure 1-3. The cable modem will select one UCD at random to instruct the modem
on how to transmit.
Each UCD describes an upstream channel with the following information:
Frequency
Width
Burst profile
Casa Systems CMTS

The burst profile is a set of burst descriptors, where:
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.
Figure 1-4. UCD and MAP components

188-byte
MPEG-2 transport stream
1FFE
SYNC
How to transmit UCD1 Upstream channel selection, frequency, width, burst profile
UCD2
UCD3
Field of data
UCD4
SYNC
MAP
When to transmit MAP1 Elements 32 14 4 14 14 4 14
header
MAP2
MAP3
MAP4 Who When
Service ID (SID) t0 offset
What
Interval Usage Code (IUC)
Casa Systems CMTS

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.)
Casa Systems CMTS

Figure 1-5. MAP upstream channel timeline, intervals and minislots

188-byte
MPEG-2
transport stream
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
MAP2
QAM64 or QAM256 MAP3
modulation
MAP4
Coaxial cable Cable modem

DS
US
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)
Casa Systems CMTS

Channel bonding and service group operations
Channel bonding and service group operations

Channel bonding, a DOCSIS 3.0 capability, is the CMTS process that logically
combines multiple downstream or upstream channels for extended bandwidth for
modems having multiple transmitters and receivers. For downstream channels, the
MAC domain descriptor in the MPEG-2 transport stream informs the modem about
the receive channel configuration and the receive channel set (RCS) to be used by a
registered modem. (See Chapter 5, Channel bonding.)
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.
Figure 1-6. DOCSIS 3.0 channel bonding to cable modems

Eight
Four upstream Modulated digital signals
DOCSIS 3.0 downstream
channels in two from content providers
MAC domain (M x N) channels
service groups CASA SYSTEMS SYS 3 4 5
C3000 CCASA
ASA
ALM 0 1 2
A
B Forward channel lineup
C
D
Forward combiner
Multicast bus
LOW | HIGH LOW | HIGH LOW | HIGH LOW | HIGH

A B C D Diplexers/filters in
each distribution area
Fiber network 4US x 4DS
and amplifier DS-SG = CM-SG
US-SG
DS
US
D3.0 cable modem

Cable distribution areas - Channel bonding of
four DS channels based
the modems capability.
- Two-channel US service group.
Casa Systems CMTS

Physical fiber node vs. DOCSIS terminology
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.
Physical fiber node vs. DOCSIS terminology

Cable service providers deliver voice, data, and video traffic over fiber optic trunks to
subscriber distribution areas. These physical distribution areas are known as physical
fiber nodes, as illustrated in Figure 1-6.
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.
Load balancing CMTS traffic

Load balancing is the process that enables the CMTS to move a cable modem from
one channel to another so that traffic load is redistributed for improved bandwidth
utilization and reduced consumption of CMTS resources. When the CMTS determines
that a channel is reaching a traffic overload condition, the CMTS then moves the cable
modem to a channel to which that modem has access. This means that load balancing
can only take place only if the affected modem has multiple and available
downstream and upstream channels, restricted only by the MAC domain cable modem
service group (MD-CM-SG) configuration. (See Chapter 10, Load balancing.)
Casa Systems CMTS

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).
A restricted load balancing group (RLBG) uses a configured subset of channels in a

modems cable modem service group. This means that the channels available for load
balancing are interactively selected and saved in the CMTS running configuration file.
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
Downstream and upstream channels belonging to the same MD-CM-SG.

A CMTS policy configuration to control whether a cable modem or service flow
can be moved.
A CMTS priority configuration to select which cable modems to move.
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.
The following load balancing restrictions apply:
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.
Casa Systems CMTS

Dynamic channel and bonding changes
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.
Load balancing policies
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.
Casa Systems CMTS

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.
Static vs. dynamic load balancing
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.
Applying exclusion lists
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
Casa Systems CMTS

Terminology covered in this chapter
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 descriptor The single description of a burst type having up to twelve burst
description parameters, such as modulation type, forward error correction, scrambler,
preamble, long/short data, and others.
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.
Casa Systems CMTS

downstream service group (DS-SG) The group of CMTS downstream channels

over which MPEG-2 transport streams are modulated on carrier signals to a target
cable modem; the group of downstream channels to which a cable modem has access.
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.
Casa Systems CMTS

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
Casa Systems CMTS

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.
Casa Systems CMTS

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.
restricted load balancing group (RLBG) A configured subset of channels in a

modems cable modem service group; the channels available for load balancing are
interactively selected and saved in the CMTS running configuration file.
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
Casa Systems CMTS

Configuration examples
responds with a registration response (REG-RSP) message to instruct the cable

modem to select the channels.
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.
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.
Casa Systems CMTS

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 qam 0/0

no shutdown
no channel 0 shutdown
power 580
interface qam 0/1

no shutdown
power 580
interface qam 0/2

no shutdown
power 580
interface qam 0/3

no shutdown
power 580
interface gige 0
ip address 192.168.3.106 255.255.255.0
ip igmp
no shutdown
route net 0.0.0.0 0 gw 192.168.3.7
igmp client version 2

interface upstream 1/0
no shutdown
Casa Systems CMTS

no logical-channel 0 shutdown
no shutdown
no shutdown
no shutdown
no shutdown
no shutdown
no shutdown
no 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
The following sample configuration includes spectrum management, channel

bonding, and load-balancing 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
snmp traphost 192.168.0.196 community public version 2
Casa Systems CMTS

interface qam 0/0

no shutdown
power 580
interface qam 0/1

no shutdown
power 580
interface qam 0/2

no shutdown
power 580
interface qam 0/3

no shutdown
power 580
interface gige 0
ip address 192.168.3.106 255.255.255.0
ip igmp
no shutdown
route net 0.0.0.0 0 gw 192.168.3.7
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
Casa Systems CMTS

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
no shutdown
ip bundle 1
upstream 1 interface upstream 1/0.0

spectrum-rule 35
no shutdown

no shutdown

no shutdown

no shutdown
Casa Systems CMTS


no shutdown

no shutdown

no shutdown

no shutdown
Casa Systems CMTS

2-1
Chapter 2. Baseline Privacy Interface
BPI commands description

The CMTS provides commands that enforce the Baseline Privacy Interface (BPI) and
Baseline Privacy Interface Plus (BPI+) security protocols running between the CMTS
and the cable modems (CMs). BPI is defined as a set of extended services within the
DOCSIS MAC sub-layer that gives subscribers data privacy across the RF network,
encrypting traffic flows between the CMTS and CM.
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.
Casa Systems CMTS

BPI commands description
Configuration summary
Table 2-1 lists and briefly describes the objects related to BPI and BPI+.
Table 2-1. BPI and BPI+ objects
Object name Description
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.
Casa Systems CMTS

Baseline Privacy Interface 2-3
cable privacy
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.
Note: When the bpi-plus-enforce property is enabled, BPI cable modems

running DOCSIS 1.1 or higher that are not running BPI+ cannot register with
the CMTS. However, non-BPI cable modems are allowed to register.
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
Casa Systems CMTS

cable privacy
Properties
Property name Description
40-bit-des Sets the privacy mode to 40-bit Data Encryption

Standard (DES) encryption. Cable modems that do
not support 40-bit DES encryption cannot complete
BPI. (See also the cable sec encrypt_alg_priority
{aes128CbcMode | des40CbcMode |
des56CbcMode} command.)
Example:
CASA(config)# cable privacy 40-bit-des

CASA(config)# no cable privacy
40-bit-des
add-certificate Adds a manufacturer or root CA certificate to the list

{manufacturer | root} of trusted certificates, defined by the string, enclosed
<string> in quotes if space-separated.
Example:
CASA(config)# cable privacy

add-certificate manufacturer
35c146353431a541463b4133734393833337314
FEF03A8BC7A441313134749A0A592C9C6683141
add-certificate root
35c146353431a541463b4133734393833337314
FEF03A8BC7A441313134749A0A592C9C6683141
Casa Systems CMTS

cable privacy
Properties
bpi-enforce [mandatory] Enforces BPI-authenticated CMs and prohibits traffic

for non-BPI authenticated CMs. Data is not
forwarded before a BPI-enabled CM completes BPI
initialization. The mandatory option prevents all
non-BPI CMs from registering with the CMTS. If
omitted, non-BPI CMs will register and come online
with the CMTS.
Example:

bpi-enforceCASA(config)#
no cable privacy bpi-enforce
bpi-plus-enforce Enforces BPI-plus for DOCSIS 1.1 or later CMs.

[mandatory] When enabled, cable modems running DOCSIS 1.1
or higher that are not running BPI-plus are rejected.
Omitting the mandatory option prevents BPI CMs
from registering; only BPI+ CMs will register.
Example:

bpi-plus-enforce mandatory
bpi-plus-enforce mandatory
test-edrca-certificate Uses a EuroDOCSIS Root Certificate Authority

(EDRCA) for test purposes.
Example:
CASA(config)# cable
test-edrca-certificate
CASA(config)#
no cable test-edrca-certificate
Casa Systems CMTS

cable privacy
Other related commands
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.)
CASA(config)# interface docsis-mac 1

CASA(conf-if-mac 1)# privacy tek life-time 300
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.
CASA(config)# qos-profile 1 7 1000000 1000000 1000000 true 65535
Related show commands
show cable modem
Shows the possible BPI MAC state status values on cable modems:
init(r1) An initial ranging request was sent by the CM to the CMTS.

init(r2) The CMTS received an initial ranging request from the CM. The
CMTS responded and returned RF power information, timing offset, and
frequency adjustments to the CM. The CM and CMTS link is still in the ranging
state, and ranging is not complete. Check the RF attenuations if initial ranging
remains stuck. Use the debug cable ranging command for information.
init(ov) CMTS is static load balancing and is using the upstream channel ID
override and/or downstream frequency override to move the modem to new
channel. Check the modem power if stuck in this state.
Casa Systems CMTS

cable privacy
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.
The following are non-error status conditions:
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.
Casa Systems CMTS

cable privacy
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.
The following are error status conditions:
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.
Casa Systems CMTS

cable privacy
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
show cable modem verbose
Shows the capabilities, whether BPI is enabled, and the BPI encryption algorithm for
each MAC address.
# show cable modem verbose
MAC Address :7cb2.1b42.b1be
Capabilities :{Frag=Y, Concat=Y, PHS=Y, Priv=BPI+}

Optional Filtering Support :{802.1P=N, 802.1Q=N}
BPI Enbld
BPI encrypt algorithm :DES-56
show interface docsis-mac
Shows the lifetime settings on the DOCSIS MAC interface for the Key Encryption
Key (KEK) and Traffic Encryption Key (TEK) required for BPI.
# show interface docsis-mac

privacy kek life-time 604800
privacy tek life-time 43200
Casa Systems CMTS

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.
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
Casa Systems CMTS

privacy hotlist
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.
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
cm <mac_addr> MAC address for the CM certificate to be added to

the hotlist, specified as a hexadecimal string, without
periods or other separators.
Example:
CASA(config)# privacy hotlist cm

0026.24a8.db36
CASA(config)#
no privacy hotlist cm 0026.24a8.db36
Casa Systems CMTS

privacy hotlist
Properties
manufacturer <serial_num> Serial number for the particular manufacturer CA

certificate, specified as a hexadecimal string up to 32
bytes. Enter multiple lines as needed, and use a
blank line to terminate the string.
Example:
CASA(config)# privacy hotlist

manufacturer 12345678
CASA(config)# no privacy hotlist
manufacturer 12345678
Casa Systems CMTS

shared-secondary-secret
shared-secondary-secret
Purpose
The shared-secondary-secret command provides a second password should a cable

modem fail to authenticate with the primary shared-secret. With the secondary secret
configured, the cable modem must authenticate using either the primary or secondary
password so that the modem can register and come online. Using a secondary secret
allows CMTS operators to frequently revise the primary password without
interrupting a currently active and online CM with a primary password update.
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
<1|2> Secondary shared secret index, 1 or 2. If two

secondary secrets, the index determines which
secondary secret password is checked first.
<0|7> Encryption type, either 0 (clear text follows) or 7
(encrypted text follows).
<key> MIC string used to encrypt and decrypt the
configuration file, up to 32 characters.
extend Optional modifier to set the shared-secret MIC for the
extend TLVs received from Reg-Req messages.
Example:
CASA(config)# shared-secondary-secret 1
0 DOCSIS extend
Casa Systems CMTS

shared-secret
shared-secret
Purpose
The shared-secret command configures an authentication shared encryption key to

protect modem configuration files from possible tampering. Because DOCSIS
configuration files from an authorized TFTP server provide critical quality of service
(QoS) definitions and other data for cable modems, security measures must be applied
to protect the configuration file from unauthorized intercept, theft, substitution, and
potential modification. The DOCSIS specification supports the shared-secret and
shared-secondary-secret passwords to protect modem configuration files from
possible tampering. Once configured, these passwords calculate the CMTS Message
Integrity Check (MIC) field that is attached to all DOCSIS configuration files.
The CMTS supports up to 198 shared secrets (primary, secondary, and extended),
including those defined under the interface docsis-mac 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
<0|7> Encryption type, either 0 (clear text follows) or 7

(encrypted text follows). If omitted, sets the shared
secret MIC globally.
<key> MIC string used to encrypt and decrypt the
configuration file, up to 32 characters.
Casa Systems CMTS

shared-secret
Properties
extend Optional modifier to set the shared-secret MIC for the

extend TLVs received from the Reg-Req message.
Example:
CASA(config)# shared-secret 7 DOCSIS

extend
Casa Systems CMTS

3-1
Chapter 3. Cable commands
Cable commands description

Cable modem (CM) initialization begins when the CM is connected to the cable
providers network and powered on. The CM 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.
Initial ranging is a scheduled event that allows a CM to request an upstream

code (IUC). The IUC schedules the initial ranging interval in the upstream timeline to
the CMTS. Once a transmission interval is set, the MAC domain adjusts CM
frequency, power, and delay for two-way communication.
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.
This chapter describes the cable commands necessary for CM configuration.
Casa Systems CMTS

Table 3-1 lists and briefly describes the objects related to cable commands.
Table 3-1. Cable objects
cable admission-control Enables admission control and sets global

parameters.
cable arp filter Sets the number of ARP response packets to
accept from the CM and CPE in a configured
time window.
cable dhcp filter Sets the number of DHCP response packets
to accept from the CM and CPE in a
configured time window.
cable diaglog Configures DOCSIS diagnostic logging.
cable dsx authorization Checks all DSX messages (DSA, DSC and
DSD) for a valid gate ID authorization value.
cable dynamic-service-flow Assigns dynamic service flows to
downstream channels.
cable ecn 770 Enables CableLabs Engineering Change
Notice (ECN) 770
cable event Enables generating and dispatching DOCSIS
cable event message notifications.
cable flap-list Detects abnormal CMs in the network.
cable host authorization Enables cable modem host authorization.
cable icmp filter Sets the number of ICMP response packets
cable igmp filter Sets the number of IGMP response packets
cable igmp static-group Creates a static multicast session for
any-source-multicast.
cable igmp vrf Creates a Virtual Routing and Forwarding
instance for the IGMP static group.
Casa Systems CMTS

Cable commands 3-3
cable mdd Informs registered CMs 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.
cable mirror Mirrors traffic from one device to another.
cable modem See Chapter 4, Cable modem commands.
cable monitor-period Sets the cable monitoring period.
cable partial-service Sets properties for CM partial-service
channels.
cable privacy Enables privacy settings for the cable
modem.
cable proxy-arp unknown Fixes IP remote host deployments in which
the CMTS does not have an ARP binding.
cable qos Sets quality of service (QoS) options for the
CM.
cable rcp-select Sets the Receive Channel Profile (RCP)
selection for the CM.
cable sa-des-tlvlen-2 Sets the security association TLV length.
cable sec Sets cable modem security properties.
cable service attribute Restricts the CMTS from sending peak traffic
withold-TLVs peak-rate rate information to non-DOCSIS 3.0 cable
modems.
cable service-class Sets parameters for DOCSIS 1.1 cable
service classes.
cable service-flow Manages and removes idle upstream service
active-timeout flows.
cable service-type-id Moves D2.0 cable modems between two
CMTS platforms.
cable spectrum Sets cable spectrum management properties.
cable subscriber over-consume Sets a trap for subscribers who exceeded the
trap maximum allowable bandwidth.
cable tcc us-bonding-disable Disables transmit channel configuration
(TCC) bonding to the upstream channel.
Casa Systems CMTS

cable traffic-policy Configures Subscriber Traffic Management

(STM).
cable upstream Sets upstream traffic parameters.
default cable modem vendor Sets the system default vendor.
reg-rsp-original-upstream-action Enables the CMTS to use the ADD action for
the original upstream channel in the
REG-RSP-MP message.
Casa Systems CMTS

Cable commands 3-5
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.
Bandwidth allocation is configured with the exclusive and non-exclusive thresholds of

an application class. The exclusive bandwidth cannot be shared with other application
classes. The sum of exclusive and non-exclusive thresholds indicates the maximum
bandwidth the application class can have.
Perform the following steps to enable and configure admission control:
1. Use the cable admission-control command by itself to enable admission control,

then add any further properties.
2. Use the application class command to create one or more service-flow
application classes to define rules and the bandwidth to be calculated for matching
upstream or downstream traffic.
3. Use the include property of the application class command to add rules and
schedule types.
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
Casa Systems CMTS

Properties
cm-registration Applies admission control to cable modem

registration upstream service flows to the CMTS.
Example:
CASA(config)# cable admission-control

cm-registration
CASA(config)#
no cable admission-control
CASA(config)# no cable
admission-control cm-registration
dynamic-service [exceed Applies admission control to Dynamic Channel

{dcc | reject}] Change (DCC) service flows. Use the optional
exceed modifier with dcc to force DCC service flow
admission if the calculated bandwidth is insufficient,
or with reject to disallow the service-flow.
Example:

dynamic-service exceed dcc
admission-control dynamic-service
multicast Rejects multicast replication of the channel set if

adequate bandwidth is unavailable. Use the no form
of the command to disable multicast admission
control.
Example:

multicast
admission-control multicast
Casa Systems CMTS

Cable commands 3-7
Properties
preempt priority-voice Gives bandwidth priority to certain voice flows over all
other traffic, known as high-priority call preemption.
Example:

preempt priority-voice
CASA(config)#
no cable admission-control preempt
priority-voice
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
show cable admission-control
Shows admission control settings.
CASA(config)# show cable admission-control

cable admission-control dynamic-service exceed dcc
cable admission-control cm-registration
show cable admission-control interface {downstream | upstream}
Shows admission control results for the downstream or upstream interface.
CASA(config)# show cable admission-control interface upstream 13/0.0

App-Class Exclusive Non-Exclusive Curr-Resv Curr-Ovrsb
Casa Systems CMTS

cable arp filter
cable arp filter

Purpose
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
<0:20> <1:60> Number of ARP packets to accept in a window

(default 8) followed by the number of seconds in a
window (default 2).
Example:
CASA(config)# cable arp filter 8 2

CASA(config)# no cable arp filter
show cable filter running-config
Shows the cable filter settings in the running configuration.
CASA(config)# show cable filter running-config

cable arp filter 8 2
cable dhcp filter 100 2
Casa Systems CMTS

Cable commands 3-9
cable dhcp filter
cable dhcp filter

Purpose
The cable dhcp filter command sets the number of DHCP response packets to accept
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
<0:255> <1:60> Number of DHCP packets to accept in a window

(default 20) followed by the number of seconds in a
window (default 2).
Example:
CASA(config)# cable dhcp filter 20 2

CASA(config)# no cable dhcp filter

Casa Systems CMTS

cable dhcp-leasequery filter

Purpose
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.
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
<0:20> <1:4> Number of DHCP leasequery packets to send in a

window (default 8) followed by the number of
seconds in a window (default 2).
Example:
CASA(config)# cable dhcp-leasequery

filter 8 2
CASA(config)#
no cable dhcp-leasequery filter
Casa Systems CMTS

Cable commands 3-11

cable icmp filter 0 2
cable igmp filter 4 2
cable dhcp-leasequery filter 8 2
Casa Systems CMTS

cable dhcpv6-leasequery filter

Purpose
The cable dhcpv6-leasequery filter command sets the number of DHCPv6

leasequery packets to send to the CM and CPE in a configured time window.
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
<0:20> <1:4> Number of DHCPv6 leasequery packets to send in a

window (default 8) followed by the number of
seconds in a window (default 2).
Example:
CASA(config)# cable dhcpv6-leasequery

filter 8 2
CASA(config)#
no cable dhcpv6-leasequery filter
Casa Systems CMTS

Cable commands 3-13

cable dhcp-leasequery filter 8 2
cable dhcpv6-leasequery filter 8 2
Casa Systems CMTS

cable diaglog
cable diaglog
Purpose
The cable diaglog command configures DOCSIS diagnostic logging.
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
ranging Enables the ranging missed flap-list log.
Example:
CASA(config)# cable diaglog ranging

CASA(config)# no cable diaglog ranging
CASA(config)# no cable diaglog
reg-detail-mask Sets the registration detail mask, a user-defined

<0x0:0xffff> value, default 0x0. There is no no form of the
command.
Example:
CASA(config)# cable diaglog

reg-detail-mask 0x0
Casa Systems CMTS

Cable commands 3-15
cable diaglog
Properties
reg-time-interval Sets the registration timeout value, default 90

<60:86400> seconds. There is no no form of the command.
Example:

reg-time-interval 90
registration Enables the registration timeout log.
Example:

registration
CASA(config)#
no cable diaglog registration
Casa Systems CMTS

cable dsx authorization
cable dsx authorization

Purpose
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.
no form of the command to disable DSX authorization.
Mode
(config)#
Syntax
[no] cable dsx authorization
Casa Systems CMTS

Cable commands 3-17
cable dynamic-service-flow
Purpose
The cable dynamic-service-flow command assigns dynamic service flows to bonded

downsteam channels (the default), to any one of the downstream channels
(non-bonding), or to the modems primary downstream channel. For example, to
assign VoIP traffic to the modem's primary downstream channel, use the cable
dynamic-service-flow primary command.
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
bonding Assigns dynamic service flows to bonded

downstream channels. This is the default setting.
Example:
CASA(config)# cable
dynamic-service-flow bonding
non-bonding Assigns dynamic service flows to any one of the

downstream channels.
Example:
CASA(config)# cable
dynamic-service-flow non-bonding
Casa Systems CMTS

Properties
primary Assigns dynamic service flows to the modems

primary downstream channel.
Example:
CASA(config)# cable
dynamic-service-flow primary
Casa Systems CMTS

Cable commands 3-19
cable ecn 770
cable ecn 770

Purpose
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.
no form of the command to disable ECN 770.
Mode
(config)#
Syntax
[no] cable ecn 770
Casa Systems CMTS

cable event
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.
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
<0:4294967295> Valid cable event ID, as determined by the show

cable event running-config command.
Example:
CASA(config)# cable event

CASA(config)# cable event 1
CASA(config)# no cable event 1
CASA(config)# no cable event
Casa Systems CMTS

Cable commands 3-21
cable event
Properties
delivery With the event ID indicated, enables forwarding

major cable event messages to the syslog server.
Use the no form of the command to disable any
previously specified cable events from being
forwarded to the syslog server.
Example:
CASA(config)# cable event 1 delivery

CASA(config)# no cable event 1 delivery
CASA(config)# no cable event delivery
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:
0x00 Not reported.

0x80 Saved to a local non-volatile log (flash).
0xA0 Reported to local log and SYSLOG.
0xC0 Reported to local log and trap receivers.
0xE0 Reported to local log, SYSLOG, and trap
receivers.
0x20 Reported to SYSLOG servers.
0x40 Reported to trap receivers.
0x60 Reported to SYSLOG and trap receivers.
Example:
CASA(config)# cable event priority

alert 0x20
CASA(config)#
no cable event priority alert
Casa Systems CMTS

cable event
Properties
syslog-server <ip_addr> Enables logging of DOCSIS event messages to a

SYSLOG server, identified by IP address.
Example:
CASA(config)# cable event syslog-server

192.168.8.8
CASA(config)#
no cable event syslog-server
throttle-adminStatus Configures how the CMTS throttles the SNMP traps

{inhibited | and SYSLOG messages it generates for DOCSIS
maintainBelowThreshold | event messages, as follows:
stopAtThreshold |
unconstrained} inhibited Causes all trap transmission and
SYSLOG messages to be suppressed.
maintainBelowThreshold Causes trap
transmission and SYSLOG messages to be
suppressed if the number of traps would
otherwise exceed the threshold.
stopAtThreshold Causes trap transmission to
cease at the threshold, and not resume until
directed to do so.
unconstrained Causes traps and SYSLOG
messages to be transmitted without regard to the
threshold settings.
Example:

throttle-adminStatus inhibited
CASA(config)#
no cable event throttle-adminStatus
Casa Systems CMTS

Cable commands 3-23
cable event
Properties
throttle-interval Specifies the throttle interval that controls how often

<1:2147483647> the CMTS generates SNMP traps, in seconds.
Example:

throttle-interval 1200
CASA(config)#
no cable event throttle-interval
throttle-threshold <num> Sets the maximum number of SNMP traps and

SYSLOG messages that the CMTS can generate for
DOCSIS event messages during the throttle interval.
Example:

throttle-threshold 1200
CASA(config)#
no cable event throttle-threshold
clear cable events
Clears all cable events. This command is available in configuration mode only.
CASA(config)# clear cable events
show cable events
Shows all the cable events in reverse chronological order.
Casa Systems CMTS

cable event
show cable event running-config
Shows the list of cable events in the running configuration.
CASA(config)# show cable event running-config

cable event
cable event 66010100
no cable event 83020203
show cable event delivery
Shows the event IDs currently forwarded to the syslog server.
CASA(config)# show cable event delivery

cable event 66010100 delivery
show cable event notification-policy
Shows the event reporting flags for cable event messages.
CASA(config)# show cable event notification-policy
priority flash-log mem-log traps syslog

-------------------------------------------------
emergency yes no no no
alert yes no no no
critical yes no yes yes
error yes no yes yes
warning no yes yes yes
notice no yes yes yes
informational no no no no
debug no no no no
show cable event syslog-server
Shows the syslog host IP address for DOCSIS events.
CASA(config)# show cable event syslog-server

DOCSIS syslog server: 0.0.0.0
Casa Systems CMTS

Cable commands 3-25
cable event
show cable event throttle-config
Shows the cable event throttling configuration.
CASA(config)# show cable event throttle-config

Throttle Admin Status: unconstrained
Throttle Inhibited: false
Throttle Threshold: 0
Throttle Interval: 1
Casa Systems CMTS

cable flap-list
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.
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
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:
CASA(config)# cable flap-list add

downstream 4/0/2
Casa Systems CMTS

Cable commands 3-27
cable flap-list
Properties
aging {<15:86400> | Period in which the CM is maintained in the flap list

default} table, maximum 60 days, default 10080 minutes (one
week). If the time limit is reached, the CM is removed
from the flap-list table. After the CM is removed, the
user cannot get flap list information about this CM.
There is no no form of the command.
Example:
CASA(config)# cable flap-list aging

10080
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.
Example:
CASA(config)# cable flap-list

check-interval 120
insertion-time {<1:120> | Insertion time, if in which period the CM constantly

default} sends out initial ranging requests, it is put in the flap
list table for observation. The default is 60 seconds.
Example:

insertion-time 60
CASA(config)#
no cable flap-list insertion-time
Casa Systems CMTS

cable flap-list
Properties
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:
CASA(config)# cable flap-list miss

threshold 6
CASA(config)#
no cable flap-list miss threshold
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:

power-adjust threshold 2
CASA(config)# no cable flap-list
power-adjust threshold
trap Enables the cable modem flap list trap.
Example:
CASA(config)# cable flap-list trap

CASA(config)# no cable flap-list trap
Casa Systems CMTS

Cable commands 3-29
cable flap-list
clear flap-list {delete | reset}
Clears all cable flap lists. The optional delete modifier deletes all flap list CM records,
and the reset modifier resets all flap list counters.
CASA(config)# clear cable flap-list
show cable flap-list [downstream <slot>/<port>/<chan> | sort-flap | sort-int

| sort-mac | sort-time | upstream <slot>/<port>/<pchan>/<lchan>]
Shows the cable flap list. A number of sort options are available.
CASA(config)# show cable flap-list

MAC Address Us-Int Ins Hit Miss(%) CRC P-Adj ARP-TO Flap Time
0005.caa3.x 10/0.1/0 210 99 10(9.2 %) 0 18 0 228 2014-07-10,14:30:54
0013.f735.x 10/0.0/0 25 207 70(25.3%) 0 61 0 86 2014-07-10,14:06:49
show cable flap-list config
Shows the cable flap list property settings.
CASA(config)# show cable flap-list config

cable flap-list power-adjust threshold 2
cable flap-list miss threshold 6 90
cable flap-list insertion-time 60
cable flap-list aging 10080
cable flap-list check-interval 120
cable diaglog reg-time-interval 90

cable diaglog reg-detail-mask 0x0000
Casa Systems CMTS

cable host authorization
cable host authorization

Purpose
The cable host authorization command enables cable modem host authorization
address without changing the CM config file.
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
<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:
CASA(config)# cable host authorization

0015.f2fe.c904 67.1.8.23
CASA(config)# no cable host
authorization 0015.f2fe.c904 67.1.8.23
show cable host authorization
Shows the cable host authorization settings.
CASA(config)# show cable host authorization

cable host authorization 0015.f2fe.c904 67.1.8.23
Casa Systems CMTS

Cable commands 3-31
cable icmp filter
cable icmp filter

Purpose
The cable icmp filter command sets the number of ICMP response packets to accept
no form of the command to remove the ICMP filter.
Mode
(config)#
Syntax
[no] cable icmp filter <0:255> <1:60>
Properties
<0:255> Maximum number of ICMP response packets to

accept from the CM or CPE within the specified time
window, default 0 (no filter).
<1:60> Seconds to specify the time window for accepting
ICMP packets from the CM or CP, default 2 seconds.
Example:
CASA(config)# cable icmp filter 100 2

CASA(config)# no cable icmp filter

Casa Systems CMTS

cable igmp filter
cable igmp filter

Purpose
The cable igmp filter command sets the number of Internet Group Management
Protocol (IGMP) response packets to accept in a configured time window.
no form of the command to remove the IGMP filter.
Mode
(config)#
Syntax
[no] cable igmp filter <1:5000> <1:60>
Properties
<1:5000> Maximum number of IGMP response packets to

accept from the CM or CPE within the specified time
window, default 100.
<1:60> Seconds to specify the time window for accepting
IGMP packets from the CM or CP, default 2 seconds.
Example:
CASA(config)# cable igmp filter 100 2

CASA(config)# no cable igmp filter

Casa Systems CMTS

Cable commands 3-33
cable igmp static-group

Purpose
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
{<ip_addr> | ipv6 IP multicast group address, which must be a valid

<v6_addr>} multicast address. Adding the address puts you in
static-group configuration mode.
Example:
CASA(config)# cable igmp static-group

224.0.0.0
CASA(conf-igmp-static-group 224.0.0.0)#
CASA(config)#
no cable igmp static-group
CASA(config)#
no cable igmp static-group ipv6 ::1
Casa Systems CMTS

Properties
dsid <85689:86688> Optional Downstream Service Identifier (DSID).
Example:

224.0.0.0 dsid 85689
source <ip_addr> Optional alternative source IP address for the

mullticast session.
Example:

224.0.0.0 source 192.168.0.1
description <text> Descriptive text for the static group, up to 64

characters.
Example:
description First static group
no description
qam <slot>/<port>/<chan> Downsteam channel using the system slot, port

number, and physical downstream channel number.
Use the interface qam command to create the
interface.
Example:
qam 2/0/0
no qam 2/0/0
Casa Systems CMTS

Cable commands 3-35
show cable igmp static-group
Shows the configured IGMP static group.
CASA(config)# show cable igmp static-group
cable igmp static-group 224.0.0.0
cable igmp static-group 224.0.100.100 source 192.168.8.8
Casa Systems CMTS

cable igmp vrf
cable igmp vrf

Purpose
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)#
Syntax
(config)#
[no] cable igmp vrf <vpn_id> static-group <ip_addr> [source <ip_addr>]
[dsid <85689:86688>]
Properties
<vpn_id> VPN ID of the VRF. Requires the static-group

property.
static-group <ip_addr> Static group multicast IP address. Entering this
[source <ip_addr>] [dsid property puts you in static group configuration mode.
<85689:86688>]
Example:
CASA(config)# cable igmp vrf VPN94

static-group 224.0.0.0
exit
CASA(config)# no cable igmp vrf VPN94
static-group 224.0.0.0
Casa Systems CMTS

Cable commands 3-37
cable igmp vrf
Properties
description <text> Descriptive text for the static group, up to 64

characters.
Example:
description First static group
no description
qam <slot>/<port>/<chan> Downsteam channel using the system slot, port

number, and physical downstream channel number.
Use the interface qam command to create the
interface.
Example:
qam 2/0/0
no qam 2/0/0
show cable igmp vrf <id> static-group
Shows the configured IGMP static group for the VRF.
CASA(config)# show cable igmp vrf VPN94 static-group
Casa Systems CMTS

cable mdd
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.
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
cm-status-ack support Enables CM-STATUS-ACK reports per event.
Example:
CASA(config)# cable mdd cm-status-ack

support
CASA(config)#
no cable mdd cm-status-ack support
Casa Systems CMTS

Cable commands 3-39
cable mdd
Properties
extended tx-power support Enables supporting extended transmission power

<0|1> over upstream channels. Specify 1 to support
extended power levels; 0 (the default) disables the
extended transmission power support feature.
Example:
CASA(config)# cable mdd extended

tx-power support 0
CASA(config)#
no cable mdd extended tx-power support
rcp {fragment | verbose} When fragment support is enabled, the CMTS

support informs registered cable modems that it supports
fragmented RCC/RCP TLV packet transmissions if
the RCP length exceeds 255. The default is disabled
(no RCP fragment support).
Example:
CASA(config)# cable mdd rcp fragment

support
CASA(config)# no cable mdd rcp verbose
support
show cable mdd extended tx-power support
Shows the extended transmission power support. With extended transmission power
support enabled, debug output shows Extended Upstream Transmit Power
Capability(40):f4.
CASA(config)# show cable mdd extended tx-power support
cable mdd extended tx-power support 0
Casa Systems CMTS

cable mdd
show cable mdd msg downstream [<slot>/<port>/<chan>]
Shows the MDD messages for a downstream channel, including the decoding.
CASA(config)# show cable mdd msg downstream 2/0/3

Dump primary MDD message,MAC-DOMAIN 1:
01 e0 2f 00 00 01 00 17 10 82 cb c2 01 b6 00 00
03 04 21 00 0d 01 01 04 01 13 01 01 01 02 04 17
d7 84 00 03 01 01 04 01 01 05 02 00 36 01 13 01
...
Decode MDD message
Dest. Address : 01e0.2f00.0001

Source Address: 0017.1082.cbc2
Message Length: 438 (decimal) DSAP: 00 SSAP: 00
Control: 03 Version: 04
Type: mdd(33) RSVD: 00
...
Casa Systems CMTS

Cable commands 3-41
cable mirror
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.
no form of the command to disables the settings.
Modes
(config)#
Syntax
[no] cable mirror <mac_addr> <ip_addr> <1:65535>
Properties
<mac_addr> MAC address of the CM or CPE.

<ip_addr> Destination IP address of the mirror stream.
<1:65535> UDP port to assign the stream.
Example:
CASA(config)# cable mirror

2476.7d98.bd08 10.200.0.150 144
CASA(config)# no cable mirror
2476.7d98.bd08 10.200.0.150 144
show cable mirror
Shows the mirrored CMs or CPEs.
Casa Systems CMTS

cable modem
cable modem
Purpose
The cable modem command sets various cable modem properties.
These commands are described in Chapter 4, Cable modem commands.
Modes
#
(config)#
Casa Systems CMTS

Cable commands 3-43
cable monitor-period
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.
Mode
(config)#
Syntax
cable monitor-period <5:3600>
Properties
<5:3600> Monitor polling interval, starting at 5 seconds and

defaulting to 30 seconds.
Example:
CASA# cable monitor-period 30
Casa Systems CMTS

cable partial-service
Purpose
The cable partial-service command sets the following properties for CM

partial-service channels:
continue-ranging Assigns unicast ranging opportunity to a partial-service

channel.
dbc Instructs the CMTS to send Dynamic Bonding Change (DBC) request
messages to CM when they report partial-service mode while attempting to
acquire affected channels. This functionality is disabled by default. Use this
command only with special case modems. Under normal conditions, when the
CMTS receives ranging request messages on the unusable upstream channels, the
channels are removed from the unusable channel list and the affected modems are
no longer considered in partial-service mode.
reset-legacy-cm Resets the legacy CM if in partial-service mode.
upstream-impairment Handles conditions where a channel impairment
causes modem throughput issues. The optional margin to restore service is in dB,
default 3.
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>]
Casa Systems CMTS

Cable commands 3-45
Properties
continue-ranging Enables assigning a unicast ranging opportunity to a

partial-service channel.
Example:
CASA# cable partial-service

continue-ranging
CASA# no cable partial-service
continue-ranging
dbc Enables sending Dynamic Bonding Change (DBC)

request messages to CM when they report
partial-service mode.
Example:
CASA# cable partial-service dbc

CASA# no cable partial-service dbc
reset-legacy-cm Enables resetting the legacy CM if in partial-service

mode.
Example:

reset-legacy-cm
reset-legacy-cm
Casa Systems CMTS

Properties
upstream-impairment [margin Handles conditions where a channel impairment

<1:10>] causes modem throughput issues. The command
monitors SNR and FEC during normal
communications and triggers partial service when low
SNR or high FEC error count occurs. The threshold
to trigger partial service is an uncorrectable FEC
error rate of 1%, or low SNR. The SNR threshold
depends on the modulation profile used; 20dB for
64QAM, and 14dB for 16QAM. To exit partial service,
the trigger is a resulting good SNR, which is 3dB over
the SNR threshold by default. The optional SNR
margin defaults to 3 dB. With its no form specified,
the CMTS will not use partial service channels for
data traffic. Ranging continues once the SNR for
ranging bursts is sufficient to restore service; the
channel is then re-enabled for data traffic.
Example:

upstream-impairment margin 1
upstream-impairment
show cable modem partial-service
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.
CASA(config)# show cable modem partial-service

MAC Address MAC US DS US DS US/DS CHAN EXCLUDED
id Intf Intf SET SET
001e.69b4.467c 2 10/0.1/0 0/2/2 2 257(1*7) 0/2/4
0024.d145.b9b8 5 11/8.0/0 1/1/3 256 256(2*7) 1/1/4
0024.d145.b9be 5 11/8.0/0 1/1/1 256 256(2*7) 1/1/4
0024.d145.b9c2 5 11/8.1/0 1/1/3 256 256(2*7) 1/1/4
0024.d145.b9c4 5 11/8.0/0 1/1/3 256 256(2*7) 1/1/4
Casa Systems CMTS

Cable commands 3-47
cable privacy
cable privacy
Purpose
The cable privacy command enables privacy settings for the cable modem.
See the cable privacy command in Chapter 2, Baseline Privacy Interface.
Casa Systems CMTS

cable proxy-arp unknown
cable proxy-arp unknown

Purpose
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.
no form of the command to disable the property (the default).
Mode
(config)#
Syntax
[no] cable proxy-arp unknown
show cable proxy-arp config
Shows whether proxy ARP unknown is enabled.
CASA(config)# show cable proxy-arp config

proxy-arp unknown enabled
Casa Systems CMTS

Cable commands 3-49
cable qos
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.
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}
Casa Systems CMTS

cable qos
Properties
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:
CASA(config)# cable qos class ds 7

weight 100
CASA(config)# no cable qos class ds 7
ds scheduler mode Sets the QoS downstream scheduler mode to

{guaranteed-plus | normal} guaranteed-plus or normal (the default). See
Scheduler modes for details. There is no no form of
the command.
Example:
CASA(config)# cable qos ds scheduler

mode normal
Casa Systems CMTS

Cable commands 3-51
cable qos
Properties
temp-us-sf <svclass_name> Matches a temporary upstream service flow using a

pre-defined cable service-class name <name> with
QoS-defined settings before a cable modem registers
with the CMTS. Using the defined service class, this
command enables certain cable modems to come
online with highest priority during high upstream
traffic periods.
Example:
CASA(config)# cable qos

temp-us-sf SVCL1
CASA(config)# no cable qos temp-us-sf
us scheduler mode Sets the QoS upstream scheduler mode to

{guaranteed-plus | normal} guaranteed-plus or normal (the default). See
Scheduler modes for details. No no form.
Example:
CASA(config)# cable qos us scheduler

mode guaranteed-plus
Weighted fair queuing
Normally, bandwidth is assigned downstream and upstream in a strict priority fashion

based on the service priority class defined in the cable modems configuration file.
The service flows in each service class are scheduled round-robin unless there are
traffic shaping constraints on a particular service flow. Strict priority queuing consists
of always giving higher classes traffic priority. That is, it services a particular class
until it is empty from the highest priority to lowest. Each service class can have one of
eight DOCSIS priority levels (labeled 7 through 0) for downstream and upstream
traffic, with additional two system-level priorities (9 and 8) being reserved for MAC
control or real-time and guaranteed bandwidth traffic, where bandwidth should always
be available. The lower eight priority levels determine a priority hierarchy addressing
the remaining available bandwidth in a best-effort (BE) manner. These priority classes
can operate in one of two modes, strict priority (the default) and weight fair queuing
(WFQ).
Casa Systems CMTS

cable qos
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.
Priority Policy Weight Bandwidth in WFQ classes

7 Strict Priority -
6 Strict Priority -
5 Weighted Fair Queue 80 80/200 = 40%
1 Strict Priority -
0 Strict Priority -
Service flow weighted fair queuing
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.
CASA(config)# cable qos class ds 4 flow-wfq enable

CASA(config)# cable qos class ds 4 flow-wfq max-rate 10000
Casa Systems CMTS

Cable commands 3-53
cable qos
Priority: 4 Max-rate: 10000
The maximum sustained rate can be determined with the show cable modem qos
command.
CASA# show cable modem qos

Sfid Dir Curr Sid Sched Prio MaxSusRate MaxBrst...
State Type (kbps) (kbps)...
Mac Addr : c446.199d.fe6d
196613 US act 20 BE 0 25000 64000...
204806 DS act N/A UNDEF 0 25000 64000...
If guaranteed-plus scheduler mode (see below) is also turned on downstream or

upstream, only the traffic that exceeds the minimum reserved rate goes into the BE
queue and is subject to the service flow WFQ algorithm.
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:
SF a 10 Mbps Min-rate, 40 Mbps Max-rate

SF b 0 Min-rate, 40 Mbps Max-rate
With guaranteed-plus mode, the 10 Mbps minimum rate is accounted separately

(38 - 10 Mbps = 28 Mbps). 28 Mbps then becomes available for best-effort
round-robin scheduling, so that each SF can get 28/2 = 14 Mbps. SF a thus gets a
throughput of ~(10 + 14) = 24 Mbps, while SF b gets a throughput of 14 Mbps.
Guaranteed-plus mode must be explicitly enabled.
CASA(config)# cable qos ds scheduler mode guaranteed-plus
show cable qos class {ds | us} weight
Shows the cable QoS downstream or upstream weight (bandwidth allocation) using
the Weighted Fair Queuing (WFQ) scheduling algorithm. In the example, the CMTS
Casa Systems CMTS

cable qos
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.
CASA(config)# show cable qos class ds weight

Downstream QOS Weighted Fair Queue Allocations
----------------------------------------------
Priority: Policy: Weight:
7 Strict Priority -
6 Strict Priority -
5 Strict Priority -
4 Weighted Fair Queue 80
1 Strict Priority -
0 Strict Priority -
show cable qos class {ds | us} flow-wfq
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.
CASA(config)# show cable qos class ds flow-fwq

Downstream QOS Service Flow Weighted Fair Queue Configuration
-----------------------------------------------------------
Priority: Enable: 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
show cable qos scheduler mode
Shows the cable QoS downstream and upstream scheduler mode.
CASA(config)# show cable qos scheduler mode

cable qos ds scheduler mode: normal
cable qos us scheduler mode: normal
Casa Systems CMTS

Cable commands 3-55
cable rcp-select
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.)
no form of the command to disable the RCP select.
Mode
(config)#
Syntax
[no] cable rcp-select <string> priority <1:100>
Properties
<string> RCP hex string (xx:xx:xx:xx:xx).

priority <1:100> RCP ID priority.
Example:
CASA(config)# cable rcp-select

00:10:00:00:02 priority 1
CASA(config)# no cable rcp-select
00:10:00:00:02
show cable rcp-select
Shows the RCP-selected cable modems.
CASA(config)# show cable rcp-select

cable rcp-select 00:10:00:00:02 priority 1
cable rcp-select 00:10:00:10:02 priority 0
Casa Systems CMTS

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.
See the cable sa-des-tlvlen-2 command in Chapter 2, Baseline Privacy Interface.
Casa Systems CMTS

Cable commands 3-57
cable sec
cable sec
Purpose
The cable sec command sets the following modem security properties:
Certification revocation lists and methods

Configuration learning enabling
Early Authentication Encryption (EAE) exclusion
Encryption algorithm priority
CM certification
Online Certification Status Protocol (OCSP)
Source Address Verification (SAV) authorization and configuration
TFTP proxy option
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}
Casa Systems CMTS

cable sec
Properties
cert-revocation-list Applies a certificate revocation list, with a refresh

{refresh-interval interval, set in minutes, or a source URL for the list.
<1:524160> | url
<utl_addr>} Example:
CASA(config)# cable sec

cert-revocation-list refresh-interval
600
cert-revocation-list url revlist.org
CASA(config)# no cable sec
cert-revocation-list refresh-interval
CASA(config)#
no cable sec cert-revocation-list url
cert-revocation-method {crl Applies a certificate revocation method, which can be

| crlAndOcsp | none | ocsp} using a certificate revocation list (CRL), using both a
CRL and the Online Certification Status Protocol
(OCSP), no method, or OCSP only.
Example:

cert-revocation-method crl
CASA(config)#
no cable sec cert-revocation-method
config-file-learning Enables configuration file learning, where the CMTS

records the CMTS-MIC and CM-MIC from the
received configuration file, disabled by default.
Example:

config-file-learning
CASA(config)#
no cable sec config-file-learning
Casa Systems CMTS

Cable commands 3-59
cable sec
Properties
eae-exclusion Configures Early Authentication Encryption (EAE)

<1:4294967295> <mac_addr> exclusion, which includes an ID and the CM MAC
[<mask>] address with an optional mask.
Example:
CASA(config)# cable sec eae-exclusion 1

0026.24a8.db36
CASA(config)# no cable sec
eae-exclusion 1 0026.24a8.db36
encrypt_alg_priority Sets the encryption algorithm priority to one or more

{aes128CbcMode | of the following, specified in the order of preference
des40CbcMode | of the first one supported (there is no no form of the
des56CbcMode} command):
aes128CbcMode 128-bit Advanced

Encryption Standard (AES).
des40CbcMode 40-bit Data Encryption
Standard (DES).
des56CbcMode 56-bit DES.
Example:

encrypt-alg-priority aes128CbcMode
des40CbcMode des56CbcMode
modem-cert check Enables a cable modem certificate check.
Example:
CASA(config)# cable sec modem-cert

check
CASA(config)#
no cable sec modem-cert check
Casa Systems CMTS

cable sec
Properties
ocsp {protocol-url <url> | Enables Online Certification Status Protocol (OCSP),

signature-bypass} with the URL to retrieve the OCSP information, or
signature checking on the OCSP response
messages.
Example:
CASA(config)# cable sec ocsp

protocol-url url.org
CASA(config)# cable sec ocsp
signature-bypass
CASA(config)#
no cable sec ocsp protocol-url
CASA(config)#
no cable sec ocsp signature-bypass
sav-auth-enable Enables Source Address Verification (SAV)

authorization for the cable modem (the default).
When dhcp-authorization is disabled on a DOCSIS
MAC domain, anyone can assign their own IP
address. This may cause conflicts and may not be
desirable by the service provider. One secure way to
allow customers authorized by their ISPs to use static
IP addresses is to enable DHCP authorization and
the sav-auth-enable feature, and set a sav-cfg-list.
Example:
CASA(config)# cable sec sav-auth-enable

CASA(config)#
no cable sec sav-auth-enable
Casa Systems CMTS

Cable commands 3-61
cable sec
Properties
sav-cfg-list <name> Sets the Source Address Verification (SAV)

<1:4294967295> {<ip4_addr>/ configuration rule, defined by a list name (maximum
<mask> | ipv6 <ip6_addr>/ 16 characters), rule ID, IPv4 or IPv6 address and
<prefix>} [vrf <name>] mask (for a contiguous range of addresses), and an
optional VRF name. The sav-cfg-list supports up to
2048 entries. This list is then associated with a
specific modem using the cable modem
authorization commands <sav_cfg_list_name>
property.
Example:
CASA(config)# cable sec sav-cfg-list

list1 1 6.7.8.9/24 vrf localnet
CASA(config)#
no cable sec sav-cfg-list list1 1
tftp-options {both | Configures TFTP proxy. Once an option for TFTP

hw-addr | net-addr | none} proxies is configured, the CMTS adds the
corresponding address in the TFTP message. The
options are as follows (there is no no form of the
command):
both Both the hardware and net address are

added.
hw-addr Only the hardware address is added.
net-addr Only the net address is added.
none Neither the hardware address nor net
address is added.
Example:
CASA(config)# cable sec tftp-options

both
Casa Systems CMTS

cable sec
show cable sec cert-revocation-list
Shows the CMs certification revocation list properties.
CASA(config)# show cable sec cert-revocation-list

cable sec cert-revocation-list refresh-interval 10080
cable sec cert-revocation-list url
show cable sec cert-revocation-method
Shows the CMs certification revocation method properties.
CASA(config)# show cable sec cert-revocation-list

cable sec cert-revocation-method none
show cable sec config-file-learning
Shows whether the CMs configuration file learning is enabled.
CASA(config)# show cable sec config-file-learning

cable sec config-file-learning
show cable sec eae-exclusion
Shows the CMs EAE exclusion properties.
show cable sec encrypt-alg-priority
Shows the CMs encryption algorithm priority.
CASA(config)# show cable sec encrypt-alg-priority

cable sec encrypt-alg-priority des56CbcMode des40CbcMode aes128CbcMode
Casa Systems CMTS

Cable commands 3-63
cable sec
show cable sec ocsp
Shows the CMs OCSP properties. Output can also be filtered by protocol-url or
signature-bypass.
CASA(config)# show cable sec ocsp

cable sec ocsp protocol-url
show cable sec sav-auth-enable
Shows the CMs SAV properties.
CASA(config)# show cable sec sav-auth-enable

cable sec sav-auth-enable
show cable sec sav-cfg-list
Shows the CMs Source Address Verification (SAV) configuration rules. Output can
also be filtered by name or rule ID.
CASA(config)# show cable sec sav-cfg-list

cable sec sav-cfg-list merlin 1 97.64.138.169/29
show cable sec tftp-options
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.
CASA(config)# show cable sec tftp-options

cable sec tftp-options none
Casa Systems CMTS

cable service attribute withold-TLVs peak-rate
cable service attribute withold-TLVs

peak-rate
Purpose
The cable service attribute withold-TLVs peak-rate command allows capping of

the burst rate by restricting the CMTS from sending the TLVs 24.27 and 25.27 for
DOCSIS 3.0 peak traffic rate information to non-DOCSIS 3.0 cable modems. In the
Casa configuration mode, using the command keeps you in that mode. Use the no
form of the command to remove the peak traffic rate restriction.
Mode
(config)#
Syntax
[no] cable service attribute withold-TLVs peak-rate
show cable service-class [brief | verbose]
Shows any peak traffic rate settings. Output can also be brief or verbose.
CASA(config)# show cable service-class verbose

cable service-class 1
peak-traffic-rate 0
show cable modem qos
Shows the maximum burst and peak traffic rate settings.
CASA(config)# show cable modem qos

Sfid Dir Curr Sid Sched Prio MaxSusRate MaxBrst MinRsvRate
State Type (kbps) (kbps)
PeakTrafRate Throughput ServiceClassName
(kbps) (kbps)
Mac Addr : 7cb2.1b42.b1be
16388 US act 3 BE 0 16 3044 12
0 0
Casa Systems CMTS

Cable commands 3-65
cable service-class
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>
Casa Systems CMTS

cable service-class
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
{<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
name <name> Required service class name associated with

the service class instance, 1 through 15
characters.
Example:
CASA(conf-service-class 1)# name

SRVCL1
Casa Systems CMTS

Cable commands 3-67
cable service-class
Properties
activity-timeout <0:65535> Service class activity timeout, in seconds.
Example:
activity-timeout 600
admission-timeout <0:65535> Service class admission timeout, in seconds.

Applies also to the default UGS configuration.
Example:
admission-timeout 600
app-id <0:4294967295> Service class application ID. Applies also to

the default UGS configuration.
Example:
app-id 21345
attr-aggr-rule-mask Service class attribute aggregation rule bit

<0x0:0xffffffff> mask, default 0x0. Applies also to the default
UGS configuration.
Example:
attr-aggr-rule-mask 0x0
downstream Enables the downstream service class.
Example:
downstream
Casa Systems CMTS

cable service-class
Properties
ds-resequencing Sets downstream resequencing, as no

{noResequencingDsid | resequencing or resequencing (the default).
resequencingDsid}
Example:
ds-resequencing
noResequencingDsid
dscp-overwrite <-1:63> Enables Differentiated Services Code Point

(DSCP) overwrite, default -1 (no overwrite).
Example:
dscp-overwrite -1
forbidden-attr-mask Mask for forbidden attributes, default 0x0.

<0x0:0xffffffff> Applies also to the default UGS configuration.
Example:
forbidden-attr-mask 0x0
grant-interval <0:4294967295> Grant interval, in microseconds, default 0.
Example:
grant-interval 0
grant-jitter <0:4294967295> Grant jitter interval, default 0. Applies also to

the default UGS configuration.
Example:
grant-jitter 0
Casa Systems CMTS

Cable commands 3-69
cable service-class
Properties
grant-size <0:65535> Unsolicited grant size, in bytes, default 0,

applies to unsolicitedGrantService and
unsolicitedGrantServiceWithAD only.
Example:
grant-size 0
grants-per-interval <0:127> Grants per interval, default 0.
Example:
grants-per-interval 0
max-buff-size <0:4294967295> Maximum buffer size in bytes, default 0.
Example:
max-buff-size 0
max-concat-burst <0:65535> Maximum concatenated bursts, default

40000 bytes.
Example:
max-concat-burst 40000
max-latency <0:4294967295> Maximum latency, in microseconds, default 0.
Example:
max-latency 0
Casa Systems CMTS

cable service-class
Properties
max-outstanding-bytes-per- Maximum outstanding bytes per SID cluster,

sid-cluster <0:4294967295> default 0.
Example:
max-outstanding-bytes-per-sid-
cluster 0
max-req-per-sid-cluster Maximum requests per SID cluster, default 0.

<0:255>
Example:
max-req-per-sid-cluster 0
max-time-in-sid-cluster Maximum time in the SID cluster, default 0.

<0:65535>
Example:
max-time-in-sid-cluster 0
max-tot-bytes-req-per- Maximum total bytes requested per SID,

sid-cluster <0:4294967295> default 0.
Example:
max-tot-bytes-req-per-sid-cluster
0
max-traffic-burst Maximum traffic bursts, default 40000 bytes.

<1522:4294967295>
Example:
max-traffic-burst 40000
Casa Systems CMTS

Cable commands 3-71
cable service-class
Properties
max-traffic-rate Maximum traffic rate, default 0 (no traffic rate

<0:4294967295> enforced).
Example:
max-traffic-rate 0
min-buff-size <0:4294967295> Minimum buffer size in bytes, default 0.
Example:
min-buff-size 0
min-packet-size <0:65535> Minimum packet size in bytes, default 0.
Example:
min-packet-size 0
min-reserved-rate Minimum reserved rate in bps, default 0 (no

<0:4294967295> bandwidth reserved).
Example:
min-reserved-rate 0
multiplier-bytes-req <bytes> Multiplier bytes requested, as 1, 2, 4, 8, or 16

bytes; default 4.
Example:
multiplier-bytes-req 4
Casa Systems CMTS

cable service-class
Properties
multiplier-contention-req- Multiplier contention request window, default

window <4:12> 8.
Example:
multiplier-contention-req-window
8
peak-traffic-rate Allows capping of the burst rate, in kilobits

<0:4294967295> per second, default 0.
Example:
peak-traffic-rate 0
poll-interval <0:4294967295> Polling interval, in microseconds, default 0.

Example:
poll-interval 0
poll-jitter <0:4294967295> Polling jitter, in microseconds, default 0,

applies to realtimePolllingService and
unsolicitedGrantServiceWithAD only. Applies
also to the default UGS configuration.
Example:
poll-jitter 0
priority <0:7> Priority level.
Example:
priority 0
Casa Systems CMTS

Cable commands 3-73
cable service-class
Properties
req-trans-policy Requested transmit policy bit mask,

<0x0:0xffffffff> default 0x0.
Example:
req-trans-policy 0x0
required-attr-mask Required attribute bit mask, default 0x0.

<0x0:0xffffffff> Applies also to the default UGS configuration.
Example:
required-attr-mask 0x0
sched-type {bestEffort | Scheduler type, default bestEffort, undefined

nonRealTimePollingService | if downstream.
realTimePollingService |
undefined | Example:
unsolicitedGrantService |
unsolicitedGrantServiceWithAD} CASA(conf-service-class 1)#
sched-type bestEffort
storage-type {nonVolatile | Storage type.

other | permanent | readOnly |
volatile} Example:
storage-type nonVolatile
tar-buff-size <0:4294967295> Target or desired buffer size for the service

flow queue in bytes, default 0.
Example:
tar-buff-size 0
Casa Systems CMTS

cable service-class
Properties
tos-overwrite <0x0:0xff> QoS service class TOS AND mask, default

0xFF 0x0. Applies also to the default UGS
configuration.
Example:
tos-overwrite 0xff 0x0
upstream Enables the upstream service class.
Example:
upstream
Applying service classes to modem configuration files
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;
Casa Systems CMTS

Cable commands 3-75
cable service-class
/* CmMic 1be76c7df4777d078f76a3eb45d650d5; */
/* CmtsMic 6cf3523752bbd5bd627bb05460f1ff27; */
/* EndOfDataMkr*/
/* Pad */
}
show cable service-class [<index> | default-ugs]
Shows the cable service class activity. Output can also be filtered by service-class ID
or default Unsolicited Grant Service (UGS) data grant.
CASA# show cable service-class 1

Index Name Dir Sched Prio MaxSusRat MaxBurst MinRsvRate
1 SRVCL1 US BE 0 0 3044 0
show cable service-class brief
Shows a subset of the configured cable service class settings.
CASA# show cable service-class brief

name SRVCL1
min-packet-size 0
activity-timeout 500
admission-timeout 500
tos-overwrite 0xFF 0x0
app-id 500
show cable service-class verbose
Shows the full configured cable service class settings.
CASA# show cable service-class verbose

name SRVCL1
priority 0
max-traffic-rate 0
max-traffic-burst 3044
min-reserved-rate 0
min-packet-size 0
max-concat-burst 1522

Casa Systems CMTS

cable service-flow active-timeout
cable service-flow active-timeout

Purpose
The cable service-flow active-timeout command manages and removes idle

upstream service flows for PacketCable implementations where a policy server is not
used.
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
<0:600> Default timeout period is 60 seconds.

force-delete Optionally overrides the service flow timeout and
deletes the service completely.
Example:
CASA(config)# cable service-flow

active-timeout 60 force-delete
CASA(config)# no cable service-flow
active-timeout
Casa Systems CMTS

Cable commands 3-77
cable service-type-id
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.
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
<id> Service type ID, maximum 16 characters.

ds-frequency Required downstream frequency, in Hz.
<47000000:999000000>
Example:
C10G-164(config)# cable service-type-id

vod ds-frequency 591000000
C10G-164(config)# cable service-type-id
data ds-frequency 639000000
C10G-164(config)# show cable
service-type-id
cable service-type-id vod ds-frequency
591000000
cable service-type-id data ds-frequency
639000000
C10G-164(config)# no cable
service-type-id vod
Casa Systems CMTS

cable spectrum
cable spectrum
Purpose
The cable spectrum command sets spectrum management properties for the cable
modem.
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
cm-mode-monitor-period Sets the CM mode spectrum monitoring polling

<5:3600> interval, default 45 seconds. (See the spectrum rule
command.) There is no no form of the property.
Example:
CASA(config)# cable spectrum

cm-mode-monitor-period 60
hop-period <5:3600> Sets the hop period, in seconds. There is no no form

of the command.
Example:
CASA(config)# cable spectrum hop-period

60
Casa Systems CMTS

Cable commands 3-79
cable spectrum
Properties
monitor-period <5:3600> Sets the spectrum monitoring period, in seconds.

Example:
CASA(config)# cable spectrum

monitor-period 60
trap Enables three traps for spectrum management:

casaCsmModulationChangeNotification,
casaCsmChannelWidthChangeNotification, and
casaCsmFreqHoppingNotification.
Example:
CASA(config)# cable spectrum trap

CASA(config)# no cable spectrum trap
show spectrum rule
Shows the cable spectrum settings at the beginning of the output.
CASA(config)# show spectrum rule

cable spectrum hop period 30
cable spectrum monitor-period 10
cable spectrum cm-mode-monitor-period 60
cable spectrum trap
...
Casa Systems CMTS

cable subscriber over-consume trap
cable subscriber over-consume trap

Purpose
The cable subscriber over-consume trap command sets a trap for subscribers who
exceeded the maximum allowed bandwidth.
Use the no form of the command to remove the trap.
Mode
(config)#
Syntax
[no] cable subscriber over-consume trap
Casa Systems CMTS

Cable commands 3-81
cable tcc us-bonding-disable
cable tcc us-bonding-disable

Purpose
The cable tcc us-bonding-disable command disables transmit channel configuration

(TCC) bonding to the upstream channel.
no form of the command to re-enable TCC bonding.
Mode
(config)#
Syntax
[no] cable tcc us-bonding-disable
Casa Systems CMTS

cable traffic-policy
Purpose
The cable traffic-policy command configures Subscriber Traffic Management

(STM). STM allows CMTS users to monitor and enforce upstream or downstream
transmission rates for subscribers. Subscribers who exceed the enforced maximum
bandwidth are switched automatically to a lower rate quality of service (QoS) during
the peak traffic penalty period (in minutes).
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>
<60:1440>
<60:1440>
<60:1440>
penalty-enforce {all-day | peak-only}
penalty-period <5:10080>
upstream
Casa Systems CMTS

Cable commands 3-83
Properties
<name> Cable traffic policy name, maximum 15 characters.

Entering the name takes you into traffic-policy
configuration mode.
Example:
CASA(config)# cable traffic-policy

TRPOL1
CASA(traffic-policy TRPOL1)#
CASA(config)#
no cable traffic-policy TRPOL1
downstream Binds the traffic policy to the downstream channel. If

used, this replaces the upstream setting. There is no
no form of the command.
Example:
CASA(traffic-policy TRPOL1)# downstream
duration <10:1440> Duration of the traffic policy, default 300 (5 hours).

[sample-interval <5:60>] The optional average rate for the duration is in bits/
[avg-rate second. The optional sample interval defaults to 15
<1:4294967295>] minutes, and can be followed by the average rate
setting. There is no no form of the command.
Example:
CASA(traffic-policy TRPOL1)# duration

300 sample-interval 15 avg-rate 300
enable Enables (or disables) the cable traffic policy.
Example:
CASA(traffic-policy TRPOL1)# enable

CASA(traffic-policy TRPOL1)# no enable
Casa Systems CMTS

Properties
enforce Enforces changing the max-traffic-rate to a new

{max-traffic-rate fixed value, changing it to a percentage of
<1:4294967295> | provisioned value, or setting a priority value. The
percentage <1:100>} percentage property defaults to 50%, with 100% as
[no-persistence] | monitor mode. The optional no-persistence modifier
priority <0:7>} for the percentage indicates that the enforced rule
should not remain enforced when a cable modem
reboots (the default is persistence). The priority
property accommodates networks where changing
the max-traffic-rate is not feasible, and is disabled
by default. Cable modems that match the
max-traffic-rate and exceed the average rate for the
configured duration use the enforce priority setting
under penalty, with 0 being the lowest priority. If the
priority value is higher than the original QoS priority,
no penalty is enforced on the affected service flow.
The enforce priority property is the only one that
takes a no form.
Example:
CASA(traffic-policy TRPOL1)# enforce

priority 7
no enforce priority
max-traffic-rate Maximum traffic rate in bits/second. There is no no

<0:4294967295> form of the command.
Example:
max-traffic-rate 600
Casa Systems CMTS

Cable commands 3-85
Properties
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:
CASA(traffic-policy TRPOL1)# peak-time1

daily 12 duration 120
no peak-time1 daily
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:

no peak-time2 weekend
peak-time3 {daily | Sets the third peak time in a day, and can be set
Example:

no peak-time3 weekday
Casa Systems CMTS

Properties
peak-time4 {daily | Sets the fourth peak time in a day, and can be set
Example:

no peak-time4 daily
penalty-enforce {all-day Time to enforce the penalty, either all-day or

| peak-only} peak-only. There is no no form of the command.
Example:
penalty-enforce all-day
penalty-period <5:10080> Penalty period, default 1440 minutes (one day).

Example:
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:
CASA(traffic-policy TRPOL1)# upstream
Casa Systems CMTS

Cable commands 3-87
clear cable subscriber-usage
Clears all cable subscriber usage data.
CASA(config)# clear cable subscriber-usage
show cable traffic-policy
Shows the cable traffic policy.
CASA(config)# show cable traffic-policy

cable traffic-policy TRPOL1
upstream
enforce percentage 50
penalty-period 1440
penalty-enforce all-day
duration 300 sample-interval 15 avg-rate 10000000
show cable subscriber-usage [over-consume]
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.
show cable modem [<mac_addr>] qos
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.
Casa Systems CMTS

cable upstream
cable upstream
Purpose
The cable upstream command sets certain upstream properties.
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
hi-power <0:6> Sets the cable modem output level to a higher

upstream power level, in decibels per millivolt
(dBmV), default 0 (disabled). There is no no form of
the command.
Example:
CASA(config)# cable upstream hi-power 0
snr-interval <0:600> Sets the time interval for the re-averaging of

signal-to-noise ratio (SNR) graphing statistics when
there are excessive upstream SNR fluctuations over
certain time periods. The CMTS performs the SNR
averaging at the specified time interval in seconds,
default 0 (disabled). There is no no form of the
command.
Example:
CASA(config)# cable upstream

snr-interval 0
Casa Systems CMTS

Cable commands 3-89
cable upstream
show upstream burst-noise
Shows the upstream burst noise, if enabled.
CASA(config)# show upstream burst-noise

upstream channel burst noise rate (events/sec)
12/0.0/0 0.0
12/0.0/1 0.0
12/0.1/0 0.0

show cable [upstream] channel {throughput | utilization}
Shows the cable upstream and downstream channel throughput or utilization, or the
throughput for upstream channels only.
CASA(config)# show cable channel throughput

Upstream Throughput(mbps) Packet-Per-Second
Slot/Port.Channel Total DOCSIS30 Total DOCSIS30
Channel Description
----------------------------------------------------------------------
13/0.0 (21300000 Hz) 0.00 0.00( 0%) 0 0( 0%)
FIRST-LOW-UPSTREAM-CHANNEL-9/0.0
13/0.1 (24900000 Hz) 0.00 0.00( 0%) 0 0( 0%)
SECOND-LOW-UPSTREAM-CHANNEL-9/0.1
13/0.2 (45700000 Hz) 0.00 0.00( 0%) 0 0( 0%)
FIRST-HIGH-UPSTREAM-CHANNEL-9/0.2

show cable modem phy
Shows the power setting and SNR for upstream traffic, if enabled.
CASA(config)# show cable modem phy

MAC Address USIF DSIF Sid USPwr USSNR Timing MReflec DSPwr DSSNR Mode
TX RX (dB) Offset (dBc) (dB) (dB)
0018.4de7.x 11/0.0/0 1/0/0 1 - -0.5 30.8 - - - - tdma
c446.199d.x 11/0.0/0 1/0/0 5 - 0.7 27.4 - - - - tdma
Casa Systems CMTS

default cable modem vendor

Purpose
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
Mode
(config)#
Syntax
default cable modem vendor <vendor_id>
Properties
<vendor_id> Vendor ID for the default vendor, in the form hex

xx:xx:xx, as an Organizational Unique Identifier
(OUI). There is no no form of the command.
Example:
CASA(config)# default cable modem

vendor a4:34:f4
show cable modem vendor default
Shows the default cable vendor database entries.
CASA# show cable modem vendor default

cable modem vendor 00:0f:9f Motorola
cable modem vendor 00:11:1a Motorola

Casa Systems CMTS

Cable commands 3-91
reg-rsp-original-upstream-action
Purpose
The reg-rsp-original-upstream-action command enables the CMTS to use the ADD

action for the original upstream channel in the REG-RSP-MP message. By default, or
if disabled with the no form of the command, the CMTS uses the NO ACTION action
for the original upstream channel in the REG-RSP-MP message.
Mode
(config)#
Syntax
[no] reg-rsp-original-upstream-action
show run | incl reg-rsp
Shows whether the upstream action is enabled.
CASA# show run | incl reg-rsp

Casa Systems CMTS

4-1
Chapter 4. Cable modem commands
Cable modem commands description

In order for cable modems in the subscriber distribution areas to establish two-way
communication with the CMTS, cable modems must first initialize by listening and
learning how to receive transmissions from the CMTS downstream channels, and then
by learning how to transmit to the CMTS over the upstream channels. Modem
initialization begins when the modem is connected to the cable provider's 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.
Initial ranging is a scheduled event that allows a cable modem to request an upstream
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.
Casa Systems CMTS

Cable modem commands description
Table 4-1 lists and briefly describes the objects related to Cable modem commands.
Table 4-1. Cable modem command objects
cable modem General cable modem command.

cable modem <mac_addr> Changes a CMs upstream and downstream channels using
dbc the Dynamic Bonding Change (DBC) method.
cable modem <mac_addr> Changes a CMs upstream and downstream channels using
dcc the Dynamic Channel Change (DCC) method.
cable modem <mac_addr> Maps a MAC address to a VLAN for Layer 2 VPN (L2VPN).
l2vpn-map
cable modem <mac_addr> Maps a MAC address to a Multi-Protocol Label Switching
mpls vpnid (MPLS) VPN.
cable modem <mac_addr> Changes the quality of service (QoS) parameters for
qos-override upstream and downstream primary service flows.
cable modem <mac_addr> Changes an upstream channel using the Upstream
ucc upstream Channel Change (UCC) method.
cable modem Sets authorization for a specific cable modem.
authorization
cable modem deny Denies service to a specific modem.
cable modem Detects interface utilization and prevents granting more
excessive-request requested bandwidth than necessary to an upstream
detection service flow.
cable modem offline Clears modems previously registered with the CMTS but off
aging line for a specified number of hours.
cable modem remote-query Sets the remote query polling interval.
cable modem rip Allows bypass of Router Information Protocol (RIP)
authentication-bypass authentication for specified modems.
cable modem vendor Adds a user-defined cable modem vendor or modifies the
system default CM vendor.
cm-ctrl Triggers a CM control request message (cm_ctrl_req_msg).
default cable modem Sets a system default cable modem vendor.
vendor
Casa Systems CMTS

Cable modem commands 4-3
cable modem
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:
broadcast-ranging The CM broadcasts the full initial ranging request without

going off-line and performing re-registration with the CMTS.
direct The initial technique default setting. The CM moves directly to another
channel without performing any type of ranging.
period-ranging The CM moves to a new channel, but performs periodic
ranging requests for an improved channel opportunity.
reinitialize-mac The CM MAC address is reset, forcing the cable modem
off-line and re-registering with the CMTS on the new channel.
unicast-ranging The CM performs an initial ranging request for a dedicated
channel from the CMTS where there is no other transmission activity.
See the Other related commands for the clear cable modem commands.
Modes
#
(config)#
Casa Systems CMTS

cable modem <mac_addr> dbc

Purpose
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.
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
| unicast-ranging}
Properties
<mac_addr> MAC address of the cable modem, in xxxx.xxxx.xxxx

format, which is required and followed by other
properties.
Casa Systems CMTS

Properties
dbc downstream-list <list> Sets the Dynamic Bonding Change (DBC)

initial-tech downstream list for the CM followed by the initial
{broadcast-ranging | direct technique (as described for the cable modem
| period-ranging | command). The downstream list defines the
reinitialize-mac | downstream channels as a comma-separated list,
unicast-ranging} such as 1,2,3. The first entry is the primary channel.
Example:
CASA# cable modem 0005.caa3.cf6c dbc

downstream-list 1,2,3 initial-tech
broadcast-ranging
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:

downstream-list 1,2,3 upstream-list
1,2,3 initial-tech direct
Casa Systems CMTS

Properties
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:

rcp-id 00:10:00:10:02 1 upstream-list
1,2,3 initial-tech unicast-ranging
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:

upstream-list 1,2,3 initial-tech direct
Casa Systems CMTS

cable modem <mac_addr> dcc

Purpose
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.
Modes
#
(config)#
Syntax
cable modem <mac_addr> dcc change-frequency <50000000:999000000>
[upstream <chan_id>] initial-tech {broadcast-ranging | direct |
cable modem <mac_addr> dcc upstream <1:255>} initial-tech
| unicast-ranging}
Properties

properties.
Casa Systems CMTS

Properties
dcc change-frequency Sets the new Dynamic Channel Change (DCC)

<50000000:999000000> downstream frequency value, from 50000000
[upstream <chan_id>] through 999000000 Hz. The change-frequency is
initial-tech followed by the optional upstream channel ID (see
{broadcast-ranging | direct the interface upstream command) and the required
| period-ranging | initial-tech setting, as described for the cable
reinitialize-mac | modem command.
unicast-ranging}
Note: The reinitialize-mac function is currently for
CMs without channel bonding only. Do not specify the
upstream channel ID here.
Example:
CASA# cable modem 0005.caa3.cf6c dcc

change-frequency 500000000 upstream 1
initial-tech unicast-ranging
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:
CASA# cable modem 0005.caa3.cf6c dcc

upstream 1 initial-tech period-ranging
Casa Systems CMTS

cable modem <mac_addr> l2vpn-map
cable modem <mac_addr> l2vpn-map

Purpose
The cable modem <mac_addr> l2vpn-map command maps a modem MAC address
to a VLAN for Layer 2 VPN (L2VPN).
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

properties.
12vpn-map <1:4094> [vpnid VLAN ID and the optional VPN ID (maximum 32 hex
<id>] characters).
Example:
CASA(config)# cable modem

0111.affd.addf l2vpn-map 4034
CASA(config)#
no cable modem 0111.affd.addf l2vpn-map
Casa Systems CMTS

cable modem <mac_addr> mpls vpnid
cable modem <mac_addr> mpls vpnid

Purpose
The cable modem <mac_addr> mpls vpnid command maps a MAC address to a
Multi-Protocol Label Switching (MPLS) VPN.
Modes
(config)#
Syntax
cable modem <mac_addr> mpls vpnid <id>
no cable modem <mac_addr> mpls
Properties

properties.
mpls vpnid <id> VPN ID, maximum 32 hex characters.
Example:

0111.affd.addf mpls vpnid 40FF
CASA(config)#
no cable modem 0111.affd.addf mpls
Casa Systems CMTS

cable modem <mac_addr> qos-override
cable modem <mac_addr> qos-override

Purpose
The cable modem <mac_addr> qos-override command changes the quality of

service (QoS) parameters for upstream and downstream primary service flows without
unregistering the specified CM. Up to 1024 override entries are supported.
Mode
(config)#
Syntax
[no] cable modem <mac_addr> qos-override {ds-service-class |
us-service-class} <name>
Properties

format, which is required. Note that specifying an
FFFF.FFFF.FFFF MAC address overrides the QoS
parameters for all modems in the applied service
class. The override does not take effect until modems
have re-registered with the CMTS.
qos-override The downstream or upstream cable service-class
{ds-service-class | name <name> is maximum 15 characters.
us-service-class} <name> Downstream and upstream can be specified on the
same command line
Example:

0015.f2fe.ba13 qos-override
us-service-class ups1M
CASA(config)# no cable modem
0015.f2fe.ba13 qos-override
us-service-class
Casa Systems CMTS

cable modem <mac_addr> ucc upstream
cable modem <mac_addr> ucc upstream

Purpose
The cable modem <mac_addr> ucc upstream command changes an upstream

channel using the Upstream Channel Change (UCC) method.
Modes
#
(config)#
Syntax
cable modem <mac_addr> ucc upstream <1:255>
Properties

properties.
ucc upstream <1:255> Sets the new Upstream Channel Change (UCC)
upstream channel ID (see the interface upstream
command).
Example:
CASA# cable modem 0015.f2fe.ba13 ucc

upstream 1
Casa Systems CMTS

cable modem authorization
cable modem authorization

Purpose
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

format.
<sav_cfg_list_name> Source Address Verification (SAV) configuration list
name to apply, up to 16 characters, as defined by the
cable sec commands sav-cfg-list property, to set
the configuration rule for the modem.
Example:
CASA(config)# cable modem authorization

0015.f2fe.ba13 SAVCONF
authorization 0015.f2fe.ba13
CASA(config)#
show cable modem authorization
Casa Systems CMTS

cable modem deny
cable modem deny

Purpose
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.
Mode
(config)#
Syntax
[no] cable modem deny <mac_addr>
Properties

format.
Example:
CASA(config)# cable modem deny

0015.f2fe.ba13
CASA(config)#
no cable modem deny 0015.f2fe.ba13
show cable modem deny
Shows CMs added to the deny list.
CASA# show cable modem deny

cable modem deny 0015.f2fe.cee6
Casa Systems CMTS

cable modem excessive-request detection
cable modem excessive-request detection

Purpose
The cable modem excessive-request detection command detects interface utilization

and prevents granting more requested bandwidth than necessary to an upstream
service flow. The command sets the transmission grant size and packet-receive
thresholds to prevent a service flow from consuming excessive bandwidth. The
detection interval is 10 seconds and the CMTS resets the modem after 60 continuous
transmission grant requests for bandwidth that exceeds the configured threshold
settings. The packet-recv setting should be less than half the grant-assigned setting.
Mode
(config)#
Syntax
cable modem excessive-request detection grant-assigned <100:65535>
packet-recv <1:32767>
no cable modem excessive-request detection
Properties
grant-assigned <100:65535> Number of grants assigned to the service flow in the

10-second detection interval, default 0.
packet-recv <1:32767> Number of packets in 10 seconds from the service
flow, but should be less than half the grant-assigned
value.
Example:

excessive-request detection
grant-assigned 100 packet-recv 45
excessive-request detection
Casa Systems CMTS

cable modem offline aging
cable modem offline aging

Purpose
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.
The command is executable in configuration mode. There is no no form of the

command.
Mode
(config)#
Syntax
cable modem offline aging <0:8760>
Properties
<0:8760> Aging period, maximum 1 year, default 0 hours.
Example:
CASA(config)# cable modem offline

aging 0
Casa Systems CMTS

cable modem remote-query
cable modem remote-query

Purpose
The cable modem remote-query command sets the remote query polling interval.
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
{<0 | 30:1800> The polling interval can be 0 (off) or in seconds,

[<snmp_comm>] | loopback followed by the optional default SNMP community
[0:15]} string to poll the CMs, or the loopback interface.
Example:
CASA(config)# cable modem remote-query

1000 loopback 15
CASA(config)#
no cable modem remote-query
show cable modem remote-query [downstream | immediate | upstream]
Shows the cable remote-query information.
CASA(config)# show cable modem remote-query

MAC Address IP Address S/N US DS TX Time Micro(dB) Modem
Ratio Power Power Offset Reflection State
Casa Systems CMTS

cable modem rip authentication-bypass
cable modem rip authentication-bypass

Purpose
The cable modem rip authentication-bypass command allows bypass of Router

Information Protocol (RIP) authentication for a specified range of modems.
Mode
(config)#
Syntax
[no] cable modem rip authentication-bypass <mac_addr> <mask>
Properties
<mac_addr> <mask> MAC address and mask of a range of cable modems

to set up for RIP authentication bypassing.
Example:
CASA(config)# cable modem rip

authentication-bypass 0005.caa3.cf6c
0000.0000.ffff
CASA(config)# no cable modem rip
authentication-bypass 0005.caa3.cf6c
0000.0000.ffff
Casa Systems CMTS

cable modem vendor
cable modem vendor

Purpose
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.)
Mode
(config)#
Syntax
cable modem vendor <oui> <name>
no cable modem vendor <oui>
Properties
<oui> <name> Vendor Organizational Unique Identifier (OUI), in the

form xx:xx:xx hex, followed by the vendor name,
embedded in quotes if spaces included.
Example:
CASA(config)# cable modem vendor

00:05:ca CMVENDOR
CASA(config)#
no cable modem vendor 00:05:ca
Casa Systems CMTS

show cable modem verbose immediate
Polls on the fly to show details on all cable modems. (See also the Related show
commands in Chapter 2, Baseline Privacy Interface.)
CASA(config)# show cable modem verbose immediate

MAC Address :0005.caa3.cf6c
IP Address :20.160.2.134
CM-ID :67
Prim Sid :2503
MAC Domain :2
Service-Group :2
Upstream :10/0.1/0
Downstream :0/3/6
Unusable channel list :
Timing Offset :2403

show cable modem qos verbose
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.
CASA(config)# show cable modem qos verbose

Pending bytes(Best-Effort/Guarantee/Total): 0/0/0
Pending bytes(Best-Effort/Guarantee/Total):
1040/0/1040
show cable modem docsis-mac <id>
Shows cable modems belonging to the specified DOCSIS MAC interface. An

additional display is the show cable modem docsis-mac <id> service-group <id>
{downstream | upstream} throughput command.
CASA(config)# show cable modem docsis-mac 1

MAC Address IP Address US DS MAC Prim RxPwr Timing Num BPI
Intf Intf Status Sid (dB) Offset CPEs Enb
7cb2.1b42.b1be 10.20.0.15 2/0.1/0* 0/0/2* online(pt) 1 2.0 2391 0 yes
Casa Systems CMTS

show cable modem mac downstream summary
Shows cable modems MAC layer downstream summary information.
CASA(config)# show cable modem mac downstream summary

Mac Version QoS Provision Mode
Interface Total DOC3.0 DOC2.0 DOC1.1 DOC1.0 Register DOC2.0 DOC1.1
DOC1.0
0/0/0 0 0 0 0 0 0 0 0 0
0/0/1 0 0 0 0 0 0 0 0 0
0/0/2 1 1 0 0 0 1 0 1 0
0/0/3 0 0 0 0 0 0 0 0 0
0/0/4 0 0 0 0 0 0 0 0 0
0/0/5 0 0 0 0 0 0 0 0 0
0/0/6 0 0 0 0 0 0 0 0 0
show cable modem maintenance
Shows cable modem maintenance ranging information. Ensure that there are no
differences in internal clock times.
CASA(config)# show cable modem maintenance

MAC Address US Intf Ds Intf Prim SM Fail Active-Time
Sid Count Count
7cb2.1b42.b1be 2/0.1/0 0/0/2 1 38354 0 2014-08-05,14:19:17
e448.c7ba.4576 2/2.2/0 0/1/2 1 38366 0 2014-08-05,14:18:50
show cable modem rogue
Shows cable modem spoof information during ranging.
CASA(config)# show cable modem rogue

MAC Address Vendor US Intf Ds Intf Spoof Count Dynamic Secret
show cable modem errors
Shows cable modem error information.
CASA(config)# show cable modem errors

MAC Address US Intf DS Intf CRC HCS
0008.0d55.da42 1/3/0 0/0/1 0 0
0015.f2fe.bea2 1/3/0 0/0/3 0 0
0050.f112.b764 1/3/0 0/0/1 0 0
Casa Systems CMTS

show cable downstream [<slot>[/<port>]] channel throughput
Shows downstream cable channel throughput.
CASA(config)# show cable downstream 2/0 channel throughput

Downstream Throughput(mbps) Packet-Per-Second Channel
Slot/Port/Channel Total DOCSIS30 Total DOCSIS30
Description
----------------------------------------------------------------------
2/0/0 (400000000 Hz) 0.02 0.00( 0%) 0 0( 0%)
2/0/1 (408000000 Hz) 0.02 0.00( 0%) 0 0( 0%)
2/0/2 (416000000 Hz) 0.02 0.00( 0%) 0 0( 0%)
2/0/3 (424000000 Hz) 0.02 0.00( 0%) 0 0( 0%)
2/0/4 (578000000 Hz) 0.02 0.00( 0%) 0 0( 0%)
2/0/5 (586000000 Hz) 0.02 0.00( 0%) 0 0( 0%)
2/0/6 (594000000 Hz) 0.02 0.00( 0%) 0 0( 0%)
2/0/7 (602000000 Hz) 0.02 0.00( 0%) 0 0( 0%)
show cable downstream channel counter
Shows downstream cable total and used bytes per downstream channel.
CASA(config)# show cable downstream channel counter

Downstream Slot/Port/Channel TotalBytes UsedBytes ExtTotalBytes
ExtUsedBytes
show cable downstream channel utilization
Shows downstream cable utilization statistics.
CASA(config)# show cable downstream channel utilization

Downstream Total-BW Utilization Online Secondary
Slot/Port/Channel (Mb/Sec) Percentage Modems Modems
Channel Description
----------------------------------------------------------------------
2/0/0 (400000000 Hz) 55.6 1 0 0
2/0/1 (408000000 Hz) 55.6 1 0 0
2/0/2 (416000000 Hz) 55.6 1 0 0
2/0/3 (424000000 Hz) 55.6 1 0 0
2/0/4 (578000000 Hz) 55.6 1 0 0
2/0/5 (586000000 Hz) 55.6 1 0 0
2/0/6 (594000000 Hz) 55.6 1 0 0
2/0/7 (602000000 Hz) 55.6 1 0 0
Casa Systems CMTS

cm-ctrl
cm-ctrl
Purpose
The cm-ctrl command triggers a CM control request message (cm_ctrl_req_msg).

The command can be used in the Casa enable or configuration mode. There is no no
form of the command.
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
<mac_addr> Identifies the required CM to which to send the

message by 48-bit MAC address.
Casa Systems CMTS

cm-ctrl
Properties
{cm-reinit | Sends the type of control message request. At least

disable-forwarding {0|1} | one of the following request types are required:
event_ds_mask <1:255> |
event_mask <0:ffff> | cm-reinit Sends a CM reinitialization request.
event_us_mask <1:255> | disable-forwarding {0 | 1} Sends a disable
mute <0:255> <1:65535>} forwarding request. 0 indicates false; 1 indicates
true.
event_ds_mask <1:255> Sends a mask for a
status event request for the downstream channel.
event_mask <0:FFFF> Sends a status event
mask request for the bitmask value.
event_us_mask <1:255> Sends a mask for a
status event request for the upstream channel.
mute <0:255> <1:65535> Sends a mute
request for the channel number, followed by the
length in milliseconds the mute operation is in
effect.
Example:
CASA(config)# cm-ctrl 0026.24a8.db36

mute 1 300
Casa Systems CMTS


Purpose
The default cable modem vendor command sets a system default vendor.
Mode
(config)#
Syntax
default cable modem vendor <oui>
Properties
<oui> Organizational Unique Identifier (OUI) for the default

vendor, in the form hex xx:xx:xx.
Example:
CASA(config)# default cable modem

vendor 00:05:ca
show cable modem vendor default
Shows the default cable vendor database entries.
CASA# show cable modem vendor default

cable modem vendor 00:0f:9f Motorola
cable modem vendor 00:11:1a Motorola

Casa Systems CMTS

clear cable modem {<ip_addr> | <ipv6_addr>}
Clears the cable modem by its IP or IPv6 address.
CASA(config)# clear cable modem 192.168.8.8
clear cable modem <mac_addr>
Clears the cable modem by its MAC address.
CASA(config)# clear cable modem e448.c7b4.ab62
clear cable modem offline
Clears all off-line cable modems.
CASA(config)# clear cable modem offline
clear cable modem counters
Clears all cable modem counters.
CASA(config)# clear cable modem counters
clear cable modem [bonding | non-bonding | partial-service] reset
Resets the cable modems, including specific types.
CASA(config)# clear cable modem bonding reset
Casa Systems CMTS

5-1
Chapter 5. Channel bonding
Channel bonding commands description

Channel bonding, a DOCSIS 3.0 capability, is the CMTS process that logically
combines multiple downstream or upstream channels for extended bandwidth for
modems having multiple transmitters and receivers. For downstream channels, the
MAC domain descriptor in the MPEG-2 transport stream informs the modem about
the receive channel configuration and the receive channel set (RCS) to be used by a
registered modem.
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).
Configuring channel bonding operations
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
Casa Systems CMTS

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.
CASA(config)# service group 1

CASA(config-svc-grp 1)# qam 0/0/0
CASA(config-svc-grp 1)# upstream 1/0
CASA(config-svc-grp 1)# end

CASA(config-if-mac 1)# no shutdown
CASA(config-if-mac 1)# no dhcp-authorization
CASA(config-if-mac 1)# no early-authentication-encryption
CASA(config-if-mac 1)# no tftp-proxy
Casa Systems CMTS

Channel bonding 5-3
CASA(config-if-mac 1)# ip bundle 1

CASA(config-if-mac 1)# downstream 1 interface qam 0/0/0
CASA(config-if-mac 1)# upstream 1 interface upstream 1/0/0
CASA(config-if-mac 1)# end

CASA(config-if-mac 2)# no shutdown
CASA(config-if-mac 2)# no dhcp-authorization
CASA(config-if-mac 2)# no early-authentication-encryption
CASA(config-if-mac 2)# no tftp-proxy
CASA(config-if-mac 2)# ip bundle 1
CASA(config-if-mac 2)# end
CASA(config)#
Casa Systems CMTS

Table 5-1 lists and briefly describes the objects related to channel bonding.
Table 5-1. Channel bonding objects
bonding-group Directs traffic streams to specific channels configured at the

CMTS.
dbg_id_set qam Configures a downstream bonding group (DBG) for a CM.
rcc Sets up the Receive Channel Configuration (RCC) for
downstream channel bonding to the CM.
rcp Sets up the Receive Channel Profile (RCP) for downstream
channel bonding to the CM.
service group Configures a service group for channel bonding.
Casa Systems CMTS

Channel bonding 5-5
bonding-group
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>
reseq wait-time <255 | 0:180>
reseq warn-thrshld <255 | 0:179>
Casa Systems CMTS

bonding-group
(bond-us-mac-x-group-x)#
prov-attr-mask <0x0:0xFFFFFFFF>
[no] upstream <slot>/<port>.<chan>/<log_chan>
Properties
downstream mac-domain Adds a static downstream CM bonding group, with

<1:96> group-id <1:65535> the MAC domain and group IDs.
Example:
CASA(config)# bonding-group downstream

mac-domain 30 group-id 100
CASA(bond-ds-mac-30-group-100)# exit
CASA(config)# no bonding-group
downstream mac-domain 30 group-id 100
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:
CASA(config)# bonding-group upstream

CASA(bond-us-mac-30-group-100)# exit
CASA(config)# no bonding-group upstream
Casa Systems CMTS

Channel bonding 5-7
bonding-group
Properties
prov-attr-mask Sets the provisioned attribute mask in an upstream or

<0x0:0xFFFFFFFF> downstream bonding group. When the CMTS
receives a service flow request from a CM, the CMTS
compares a TLV integer received in the service flow
request with the attribute masks of all of the available
channels it manages. The CMTS assigns a
requesting CM to the channel specified by the
attribute mask that represents the attributes
presented in the TLV included in the service flow
request. The mask can be user-defined in hex, or can
be set for bonding, high-availability, or the low latency
provisioning attribute masks, or all of the above. To
disable the mask, specify the default setting of 0x0.
Example:
CASA(bond-ds-mac-30-group-100)#
prov-attr-mask 0x0
qam <slot>/<port>/<chan> Binds a downstream QAM interface to a bonding

group, with the interface qam slot/port/channel
specified.
Example:
qam 0/2/1
no qam 0/2/1
reseq wait-time <255 | Sets the Downstream Service Identifier (DSID)

0:180> re-sequencing wait time in a downstream bonding
group, in hundred microseconds, or the specific value
255 (the wait time is determined by the CMTS).
Example:
reseq wait-time 255
Casa Systems CMTS

bonding-group
Properties
reseq warn-thrshld <255 Sets the DSID re-sequencing warning threshold in a

| 0:179> downstream bonding group, in hundred
microseconds, or the specific value 255 (the
threshold is determined by the CMTS). A value of 0
disables threshold warnings. There is no no form of
the command.
Example:
reseq warn-thrshld 255
upstream <slot>/ Binds an upstream interface to a bonding group, with

<port>.<chan>/<log_chan> the upstream slot/port.channel/logical channel
specified. (See the interface upstream command.)
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
upstream channel bonding
downstream channel bonding
initial-tech
max sid-cluster per-service-flow
sid-cluster
These commands configure a DOCSIS MAC interface required for upstream or

downstream channel bonding. (See Chapter 8, DOCSIS MAC interface.) The
upstream channel bonding and downstream channel bonding settings are enabled
by default. The initial-tech property modifies the initial technique for bonding D3.0
modems registering on upstream channels assigned by the CMTS. The default
initial-tech setting is broadcast-ranging followed by unicast-ranging,
Casa Systems CMTS

Channel bonding 5-9
bonding-group
period-ranging, and direct ranging. The max sid-cluster per-service-flow property

assigns a type of service flow to each channel in a bonding group. The sid-cluster
property sets parameters for the SID cluster. These settings are reflected in a show
interface docsis-mac command.
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.
CASA(config)# interface qam 0/0

CASA(config-if-qam 0/0)# interleave 8
CASA(config-if-qam 0/0)# modulation 256qam
clear cable modem {bonding | non-bonding | partial-service} reset
This command resets specific groups of modems, including bonding, non-bonding,

and partial-service modems.
CASA(config)# clear cable modem bonding
show bonding-group [downstream | mac-domain | upstream]
Shows the configured bonding groups. Output can also be for downstream or
upstream (and optionally filtered by group-id) or a particular MAC domain.
CASA# show bonding-group

bonding-group downstream mac-domain 1 group-id 1
qam 0/1/0
qam 0/1/1
qam 0/1/2
qam 0/1/3
bonding-group upstream mac-domain 1 group-id 1

upstream 3/0/0
upstream 3/1/0
Casa Systems CMTS

bonding-group
show cable modem bonding
Shows the channel bonding for cable modems.
CASA# show cable modem bonding

MAC Address MAC US DS US DS US/DS CHAN EXCLUDED
id Intf Intf SET SET
e448.c7b4.ab62 1 13/0.2/0 2/0/3 256 256(4*4) 2/0/4,2/0/5,2/0/6,2/0/7
e448.c7c0.ebca 3 13/4.0/0 2/2/3 257 256(3*4) 2/2/4,2/2/5,2/2/6,2/2/7
e448.c7c0.f0dc 2 13/2.0/0 2/1/0 256 256(4*4) 2/1/4,2/1/5,2/1/6,2/1/7
Casa Systems CMTS

Channel bonding 5-11
dbg_id_set qam
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.
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
<slot> QAM slot number. (See the interface qam

command.)
cm <0:16384> Cable modem number.
dbg <17:48> DBG ID, starting at 17 through 48.
Example:
CASA(config)# dbg_id_set
qam 0 cm 1 dbg 17
CASA(config)# no dbg_id_set qam 0 cm 1
Casa Systems CMTS

rcc
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.
Determine the following before configuring the RCC group:
1. The RCP ID to use.

2. How many receive modules (RMs) the RCP ID supports.
3. How many receive channels (RCs) the RCP ID supports.
Modes
(config)#
(conf-mac <id> rcc <id>)#
Syntax
(config)#
[no] rcc mac <1:96> rcp-id <string> <1:4294967295>
(conf-mac x rcc y)#

rc <1:255> downstream <0:255> {primary | secondary} connect <0:255>
no rc <1:255>
rcc-desc <text>
no rcc-desc
rm <1:255> frequency <0:999000000> connect <0:255>
no rm <1:255>
vendor-specific {spacing6 | spacing8}
Casa Systems CMTS

rcc
Properties
mac <1:96> DOCSIS MAC <1:96>. Requires the following

additional rcp-id <string> and <1:4294967295>
properties.
rcp-id <string> Receive Channel Profile (rcp) ID, in the form
xx:xx:xx:xx:xx, which requires the additional RCC
configuration ID property.
<1:4294967295> RCC configuration ID.
Example:
CASA(config)# rcc mac 1 rcp-id

00:11:11:11:11 2
CASA(conf-mac 1 rcc 2)# exit
CASA(config)#
no rcc mac 1 rcp-id 00:11:11:11:11 2
rc <1:255> downstream Receive channel (RC) ID, with the downstream

<0:255> {primary | interface number and the primary or secondary
secondary} connect connectivity ID.
<0:255>
Example:
CASA(conf-mac 1 rcc 2)# rc 1 downstream

0 primary connect 0
CASA(conf-mac 1 rcc 2)# no rc 1
rcc-desc <text> Adds an RCC description, enclosed in quotes if a

space-separated string.
Example:
CASA(conf-mac 1 rcc 2)# rcc-desc

spacing 6
CASA(conf-mac 1 rcc 2)# no rcc-desc
Casa Systems CMTS

rcc
Properties
rm <1:255> frequency Assigns a receive module (RM) to the receive

<0:999000000> connect channel (RC) configuration, per ID. The frequency
<0:255> range is in Hz. An RM connect value of 0 means that
there is no other receive module connected to this
receive module.
Example:
CASA(conf-mac 1 rcc 2)# rm 1 frequency

549000000 connect 0
CASA(conf-mac 1 rcc 2)# no rm 1
vendor-specific Assigns vendor-specific spacing, either spacing6 or

{spacing6 | spacing8} spacing8. There is no no form of the command.
Example:
CASA(conf-mac 1 rcc 2)# vendor-specific

spacing6
show rcc [mac <id>] [rcp-id <id>]
Shows the RCC configuration.
CASA(config)# show rcc

rcc mac 1 rcp-id 10:00:00:00:01 1
vendor-specific spacing6
rcc-desc spacing=6;
rc 1 downstream 1 primary connect 1
rm 1 frequency 549000000 connect 0
Casa Systems CMTS

rcp
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
<string> Receive Channel Profile (RCP) ID, in the form

xx:xx:xx:xx:xx.
Example:
CASA(config)# rcp 00:10:00:10:02

CASA(rcp 00:10:00:10:02)#
CASA(config)# no rcp 00:10:00:10:02
Casa Systems CMTS

rcp
Properties
rc <1:32> {primary | Receive channel (RC) ID, with the primary or

secondary} connect secondary connectivity ID.
<1:16>
Example:
CASA(rcp 00:10:00:10:02)# rc 1 primary

connect 1
CASA(rcp 00:10:00:10:02)# no rc 1
rcp <string> Refines the RCP ID.
Example:
CASA(rcp 00:10:00:10:02)# rcp

00:10:00:10:03
CASA(rcp 00:10:00:10:02)#
no rcp 00:10:00:10:03
rcp-description Adds an RCP description, enclosed in quotes if a

[<text>] space-separated string.
Example:
CASA(rcp 00:10:00:10:02)#
rcp-description spacing 6
CASA(rcp 00:10:00:10:02)#
no rcp-description
rm <1:16> channels Assigns a receive module (RM) to the receive

<0:64> [min-freq channel (RC) configuration, per ID. The frequency
<111000000:999000000> range is in Hz. An RM connect value of 0 means that
max-freq there is no other receive module connected to this
<111000000:999000000>] receive module.
Example:
CASA(rcp 00:10:00:10:02)# rm 1 channels

32 min-freq 549000000 max-freq
649000000
CASA(rcp 00:10:00:10:02)# no rm 1
Casa Systems CMTS

rcp
Properties
vendor-specific Assigns vendor-specific spacing, either spacing6 or

{spacing6 | spacing8} spacing8. There is no no form of the command.
Example:
CASA(rcp 00:10:00:10:02)#
show rcp running-config
Shows the RCP configurations.
CASA(config)# show rcp running-config
show rcp-list
Shows the list of RCP configurations.
CASA(config)# show rcp-list

rcp 00:10:00:00:02
rcp-description CLAB-6M-002
rm 1 channels 10
rc 1 primary connect 1
rc 2 secondary connect 1
...
Casa Systems CMTS

service group
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] downstream channel bonding
[no] upstream <slot>/<port>.<pchan>
[no] upstream channel bonding
Casa Systems CMTS

service group
Properties
<name> Service group name, up to 16 characters. Up to 160

service groups are supported.
Example:
CASA(config)# service group SVGP

CASA(conf-svc-grp SVGP)#
CASA(config)# no service group SVGP
description <text> Optional description for the service group, up to 64

characters, with text including space characters
embedded in quotes.
Example:
CASA(conf-svc-grp SVGP)# description

Primary service group
CASA(conf-svc-grp SVGP)# no description
downstream channel Enables downstream channel bonding from the

bonding service group configuration. Channel bonding must
be enabled from both the Related show commands
and service group configurations.
Example:
CASA(conf-svc-grp SVGP)# downstream

channel bonding
no downstream channel bonding
qam <slot>/<port>/<chan> Downstream binding of the service group to a

specified QAM interface. (See the interface qam
command.)
Example:
CASA(conf-svc-grp SVGP)# qam 0/2/1

CASA(conf-svc-grp SVGP)# no qam 0/2/1
Casa Systems CMTS

service group
Properties
upstream <slot>/ Physical upstream port binding of the service group.

<port>.<pchan> (See the interface upstream command.)
Example:
CASA(conf-svc-grp SVGP)# upstream

13/0.0
no upstream 13/0.0
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:
CASA(conf-svc-grp SVGP)# upstream

channel bonding
no upstream channel bonding
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:
[Fri May 4 22:44:43 2012]-lbm_chgoverstatus_update can not find

mdcmsg by mac 7,mdcmsg 0
Casa Systems CMTS

service group
show service group
Shows the configured service groups.
CASA# show service group

service group 1
qam 2/0/0
qam 2/0/1
qam 2/0/2
qam 2/0/3
qam 2/0/4
qam 2/0/5
qam 2/0/6
qam 2/0/7
upstream 13/0.0
upstream 13/0.1
upstream 13/0.2
upstream 13/0.3
show service group verbose
Shows the configured service groups in more detail.
CASA# show service group verbose

service group 1
qam 2/0/0 400000000 annex A 256qam dmac 1 UP
upstream 13/0.0 24000000 3200000 prof 2 dmac 1 UP
Casa Systems CMTS

service group
show md-ds-sg
Shows the MAC domain downstream service groups.
CASA# show md-ds-sg

docsis-mac 1 service-group 1
qam 0/1/0
qam 0/1/1
qam 0/1/2
qam 0/1/3
qam 0/2/0
qam 0/2/1
qam 0/2/2
qam 0/2/3
show md-us-sg service-group <name>
Shows the service group information for a specific MAC domain upstream service
group.
CASA# show md-us-sg service-group 1

upstream 1/4/0
upstream 1/5/0
upstream 1/6/0
upstream 1/7/0
Casa Systems CMTS

6-1
Chapter 6. Channel blocks
Channel block commands description

DOCSIS channels are configured with the interface qam command by specifying the
CMTS slot where a QAM module is installed along with a port number on that
module. Each port on the 8x96 QAM supports up to 32 narrowcast channels. With
Annex B, each port is comprised of four 192 MHz blocks totaling 768 MHz. The
offset value indicates the frequency width from the starting (default) frequency for a
given block. A typical channel frequency distribution could be as follows:
CASA(config-if-qam 0/7)# channel 16 frequency 609000000 8

CASA(config-if-qam 0/7)# channel 24 frequency 801000000 8
Creating channel blocks better facilitates channel assignment to cable modems by

grouping channels into blocks.
Table 6-1 lists and briefly describes the objects related to channel blocks.
Table 6-1. Channel block objects
channel-block downstream Creates blocks of channels to better facilitate channel

mac-domain assignment to cable modems.
channel-utilization-inte Sets the interval over which the channel utilization
rval information is collected and averaged.
Casa Systems CMTS

channel-block downstream mac-domain

Purpose
The channel-block downstream mac-domain command creates blocks of channels

to better facilitate channel assignment to cable modems.
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>
Properties
<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:
CASA(config)# channel-block downstream

mac-domain 1 block-id 1
CASA(chan-block-mac-1-block-1)#
CASA(config)# no channel-block
downstream mac-domain 1 block-id 1
Casa Systems CMTS

Channel blocks 6-3
Properties
prov-attr-mask Sets the provisioned attribute mask for a channel

<0x0:0xffffffff> block. See the prov-attr-mask <0x0:0xFFFFFFFF>
property of the bonding-group command for details.
Example:
prov-attr-mask 0x0
qam <slot>/<port>/<chan> Binds a QAM interface to a channel block, with the

QAM slot/port/channel specified. (See the interface
qam command.)
Example:
qam 1/7/4
no qam 1/7/4
show channel-block [downstream | mac-domain <id>] [block-id <id>]
Shows the channel block configuration. The output can be filtered by downstream,
MAC domain ID, or block ID.
CASA(config)# show channel-block

channel-block downstream mac-domain 1 block-id 1
qam 1/7/4
prov-attr-mask 0x80000000
Casa Systems CMTS

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
Mode
(config)#
Syntax
channel-utilization-interval <0:86400>
Properties
<0:86400> Channel utilization interval, default 30 seconds.

Setting this value to 0 turns off utilization collection. It
is not advisable to use a value lower than 10 in an
operational system.
Example:
CASA(config)#
show channel-utilization-interval
Shows the channel utilization interval.
CASA(config)# show channel-utilization-interval

channel utilization interval = 30 s
Casa Systems CMTS

7-1
Chapter 7. Customer premises

equipment classes
CPE classes commands description

The CMTS allows you to classify customer premises equipment (CPE) devices, such
as IP phones, personal computers, and set-top boxes so that DHCP requests from
those CPEs for IP addresses are forwarded by the CMTS to specific DHCP servers.
Using the cpe-class command, you can define a named CPE class grouping, and then
specify any number of DHCP option 60 strings that the CMTS will match to
configured DHCP server IPs. When the CMTS receives a DHCP option 60 string from
a vendor CPE device, the CMTS checks the IP-bundle and cable helper addresses for a
matching string. If the string matches, the CMTS forwards the request to the DHCP
server IP address and awaits a DHCP response that the CMTS returns to the
requesting CPE.
Table 7-1 lists and briefly describes the objects related to CPE classes.
Table 7-1. CPE class objects
cpe-class Defines a CPE class grouping
Casa Systems CMTS

cpe-class
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
<name> CPE class name, up to 11 alphanumeric characters.

This puts you in CPE class configuration mode.
Example:
CASA(config)# cpe-class STB

CASA(config-cpe-class STB)# exit
CASA(config)# no cpe-class STB
Casa Systems CMTS

Customer premises equipment classes 7-3
cpe-class
Properties
dhcp option 60 <text> Specifies any number of DHCP option 60 (vendor

class identifier) strings that the CMTS matches to
configured DHCP server IPs. When the CMTS
receives an option 60 string from a vendor CPE
device, it checks the IP-bundle and cable helper
addresses for a matching string. If it matches, the
CMTS forwards the request to the DHCP server and
awaits a DHCP response that the CMTS returns to
the requesting CPE. A message appears if the option
has already been defined.
Example:
CASA(config-cpe-class STB)# dhcp option

60 stbUser1
CASA(config-cpe-class STB)#
no dhcp option 60 stbUser1
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.
CASA(config)# cpe-class setTopBoxes

CASA(config-cpe-class setTopBoxes)# dhcp option 60 stbUser1
CASA(config-cpe-class setTopBoxes)# end
CASA(config)# cpe-class computers
CASA(config-cpe-class computers)# dhcp option 60 pcUser1
CASA(config-cpe-class computers)# end
CASA(config)# interface ip-bundle 1

CASA(ip-bundle 1)# ip address 10.231.1.1 255.255.255.0
CASA(ip-bundle 1)# ip address 10.231.13.1 255.255.255.0 setTopBoxes
CASA(ip-bundle 1)# ip address 10.231.20.1 255.255.255.0 computers
Casa Systems CMTS

cpe-class
CASA(ip-bundle 1)# cable helper-address 192.168.3.16 setTopBoxes

CASA(ip-bundle 1)# cable helper-address 192.168.3.17 computers
CASA(ip-bundle 1)# cable helper-address 192.168.3.6
show cpe-class
Shows the CPE classes configured.
CASA(config)# show cpe-class
cpe-class "computers"
dhcp option 60 "pcUser1"
cpe-class "setTopBoxes"
dhcp option 60 "stbUser1"
Casa Systems CMTS

8-1
Chapter 8. DOCSIS MAC interface
DOCSIS MAC interface commands description

For normal DOCSIS operation, a DOCSIS MAC interface must be configured. Setting
properties with the interface docsis-mac command creates an association between
downstream and upstream channels. A downstream or upstream logic channel can be
associated with only one DOCSIS MAC interface, whose channel ID must be unique.
The most important part of configuring the DOCSIS MAC interface is correctly
defining the ip bundle and participating downstream and upstream channels, and
starting up the interface. Many other parameters can be set, such as for channel
bonding, multicasting, service flows, privacy, and traps.
Table 8-1 lists and briefly describes the objects related to DOCSIS MAC interface.
Table 8-1. DOCSIS MAC interface objects
interface docsis-mac Configures the DOCSIS MAC interface.
Casa Systems CMTS

Purpose
The interface docsis-mac command configures a DOCSIS MAC interface. After

creating one or more IP bundles, you need to apply the configured IP bundles to the
DOCSIS MAC interfaces. This ensures that all primary and secondary IP interfaces,
access groups (using configured ACLs), and helper addresses are associated with a
specific MAC domain.
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] 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
Casa Systems CMTS

DOCSIS MAC interface 8-3
[no] early-authentication-encryption {capability | ranging | total}

[no] energy management
initial-tech {broadcast-ranging [ranging-parameters] | direct |
period-ranging | unicast-ranging}
[no] insertion-interval <10:200>
[no] invited-ranging-attempts <0:1024>
[no] ip bundle <1:16>
ip-provisioning-mode {alternate | dual-stack | ipv4-only |
ipv6-only}
max sid-cluster per-service-flow <1:4>
[no] mdd interval <0:2000>
[no] mgmd {ipv4 | ipv6} [last-member-query-interval <0:31744> |
max-query-response-time <0:31744> | proxy-interface <if> |
query-interval <0:31744> | robustness <1:255> | shutdown |
version <1:3>]
[no] multicast-dsid-forward [wb-cm-only]
[no] privacy {kek | tek} life-time <1:604800>
[no] router-advertisement <modifier>
[no] send udc rules
[no] shared-secondary-secret <1|2> <0|7> <mic_string> [extend]
[no] shared-secret <0|7> <mic_string> [extend]
[no] shutdown
sid-cluster {max-outstanding-bytes <0:4294967295> | max-requests
<0:255> | max-time <0:65535> | max-total-bytes
<0:4294967295>>}
[no] sync-interval <1:200>
[no] tftp-enforce [src-interface {ip-bundle | loopback <0:15>}]
[no] tftp-proxy
[no] ucd-interval <100:2000>
[no] upstream <1:255> interface upstream <slot>/<port>.<pchan>/
<lchan> [ambiguity-exclude]
[no] upstream channel bonding
[no] upstream drop classifier
[no] upstream extended-frequency-range
Casa Systems CMTS

Properties
<1:96> Required identity of the MAC domain, which puts you

in interface docsis-mac mode.
Example:

CASA(conf-if-mac 1)# exit
CASA(config)# no interface docsis-mac 1
battery backup Enables DBC to make the modem enter 1x1 mode
when operating on battery backup.
Example:
CASA(conf-if-mac 1)# battery backup

CASA(conf-if-mac 1)# no battery backup
Casa Systems CMTS

Properties
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:
CASA(conf-if-mac 1)# cable cm-status

event 1 max-timer 60 max-number 0
CASA(conf-if-mac 1)# cable cm-status
report event-list 1,2,3
CASA(conf-if-mac 1)#
no cable cm-status report event-list
Casa Systems CMTS

Properties
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:
CASA(conf-if-mac 1)# cm trap interval

600 online-offline-only
CASA(conf-if-mac 1)# no cm trap
no cm trap interval
no cm trap interval 600
cm-status event report Enables showing the status of a CMTS event report.
Example:
CASA(conf-if-mac 1)# cm-status event

report
no cm-status event report
description <text> Description for the DOCSIS-MAC domain, up to 64

characters, embedded in quotes if space characters
are included.
Example:
CASA(conf-if-mac 1)# description

DOCSIS MAC domain 1
CASA(conf-if-mac 1)# no description
Casa Systems CMTS

Properties
dhcp-authorization Enables Dynamic host configuration (DHCP)

authorization on MAC domain to prevent IP address
and mac-address spoofing. This property is enabled
by default.
Example:
CASA(conf-if-mac 1)# dhcp-authorization

no dhcp-authorization
dhcp-giaddr-primary Enables DHCP discovery messages (CM, MTA and

CPE) to be relayed to the DHCP server with the
source IP address of the dhcp-giaddr. The default
setting is disabled.
Example:
dhcp-giaddr-primary
no dhcp-giaddr-primary
Casa Systems CMTS

Properties
dhcp-insert {circuit-id A dhcp-insert allows users to insert type values in

upstream-description | DHCP packets using Option 82 (DHCP Relay Agent)
downstream-description | to include information about a CM. The DHCP server
hostname | service-class attempts to match the received information to
| upstream-description | determine if the device is a CM or CPE device. One
upstream-description-mac of the following modifiers is required:
}
circuit-id upstream-description
downstream-description
hostname
service-class Inserts DHCP option 82 with the
service-class name to instruct DHCP to treat
CPEs differently than other public IP devices. The
primary service-class name appears in the DHCP
relay message where the provisioned service
class as defined on the CMTS is relayed to the
DHCP server.
upstream-description
upstream-description-mac Combines the
Remote ID (DHCPv4 option 82 suboption 2 or
DHCPv6 option 37) to the Circuit ID field
(DHCPv4 option 82 suboption 1 or DHCPv6
option 18) so that the Circuit ID carries both the
upstream description and the cable modem MAC
address.
Example:
CASA(conf-if-mac 1)# dhcp-insert

downstream-description-mac
CASA(conf-if-mac 1)# no dhcp-insert
Casa Systems CMTS

Properties
downstream <1:255> Binds a downstream interface to a MAC domain. The

interface qam <slot>/ values are as follows:
<port>/<0:3> [secondary]
<chan_id> Required user-defined channel
identifier unique within a MAC domain.
interface qam Required modifier.
<slot> Required module or slot number.
<port> Required port number.
<0:3> Required channel.
secondary Binds a secondary downstream
interface. Since the MAC domain supports a max-
imum of 8,191 service IDs, it is sometimes desir-
able to bind secondary downstream interfaces to
multiple MAC domains. This allows 3.0 modems
to load-balance across several MAC domains
without requiring all the downstream interfaces to
be in the same MAC domain. The secondary
interfaces can be in up to four MAC domains.
Example:
CASA(conf-if-mac 1)# downstream 3

interface qam 0/2/1
CASA(conf-if-mac 1)# no downstream 3
downstream channel Enables downstream channel bonding for the

bonding DOCSIS MAC interface.
Example:
CASA(conf-if-mac 1)# downstream channel

bonding
no downstream channel bonding
Casa Systems CMTS

Properties
early-authentication-enc Early authentication encryption (EAE) allows the

ryption {capability | CMTS to authenticate CMs immediately after ranging
ranging | total} instead of performing the authentication after
modems have registered. When EAE is enabled, the
CMTS does not rely on the REG-REQ message from
the modem to determine whether a CM must perform
authentication. EAE helps prevent unauthorized CMs
from accessing IP provisioning servers and provides
security for IP provisioning messages between the
CM and the CMTS. The CMTS sends early
authentication encryption to the CM in the MAC
Domain Descriptor (MDD) message. When the CM
receives the MDD message with EAE enabled, the
modem initiates EAE during the registration process
just after ranging and just prior to DHCP. Only
authenticated CMs are allowed to continue their
initialization process with the CMTS and may be
subsequently admitted to the network. One of the
following modifiers is required:
capability Specifies EAE for modems with the

EAE flag set in the modem configuration file.
ranging Specifies EAE for modems with the
B_INT_RNG_REQ message set.
total Enforces EAE always for all CMs regis-
tering with the CMTS.
Example:
early-authentication-encryption
capability
no early-authentication-encryption
Casa Systems CMTS

Properties
energy management Enables energy management for the interface.
Example:
CASA(conf-if-mac 1)# energy management

no energy management
initial-tech Ranging technique to be used by D3.0 modems

{broadcast-ranging when moving to new upstream channels associated
[ranging-parameters] | with the MAC domain interface. There is no no form
direct | period-ranging of the command. One of the following modifiers is
| unicast-ranging} required:
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:
CASA(conf-if-mac 1)# initial-tech

broadcast-ranging ranging-parameters
insertion-interval Time interval between consecutive initial ranging

<10:200> slots on an upstream, a MAC domain characteristic.
When set, it applies to all upstream channels bound
to the MAC domain. The interval is between initial
ranging slots in 1/100ths of a second.
Example:
CASA(conf-if-mac 1)# insertion-interval

10
no insertion-interval
Casa Systems CMTS

Properties
invited-ranging-attempts Maximum number of attempts to make on invitations

<0:1024> for ranging requests. A value of zero means the
system tries to range forever.
Example:
invited-ranging-attempts 100
no invited-ranging-attempts
ip bundle <1:16> Applies a configured IP bundle interface to the

DOCSIS MAC interface, which ensures that all
primary and secondary IP interfaces, access groups
(using configured ACLs) and helper addresses are
associated with specific MAC domain.
Example:
CASA(conf-if-mac 1)# ip-bundle 1

CASA(conf-if-mac 1)# no ip-bundle 1
ip-provisioning-mode IP provisioning mode to select the IP addressing

{alternate | dual-stack scheme for a MAC domain interface. There is no no
| ipv4-only | ipv6-only} form of the command. One of the following modifiers
is required:
alternate Attempts IPv6 provisioning; if it

failes, revert to IPv4 provisioning.
dual-stack Attempts IPv4 and IPv6 provision-
ing concurrently with dual IP addressing; if one or
the other fails, the successful provisioning
remains in effect.
ipv4-only IPv4 provisioning only, the default.
ipv6-only IPv6 provisioning only.
Example:
ip-provisioning-mode ipv4-only
Casa Systems CMTS

Properties
max sid-cluster A SID cluster assigns a type of service flow to each

per-service-flow <1:4> channel in a bonding group. The maximum number of
clusters per service flow defaults to 2. There is no no
Example:
CASA(conf-if-mac 1)# max sid-cluster

per-service-flow 2
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:
CASA(conf-if-mac 1)# mdd interval 10

CASA(conf-if-mac 1)# no mdd interval
Casa Systems CMTS

Properties
mgmd {ipv4 | ipv6} Enables the Multicast Group Membership Discovery

[last-member-query-inter (MGMD) protocol on a docsis-mac domain interface,
val <0:31744> | required for IPv4 or IPv6. The optional qualifiers are
max-query-response-time as follows:
<0:31744> |
proxy-interface <if> | last-member-query-interval <time> Last
query-interval <0:31744> member query interval, in tenths of seconds.
| robustness <1:255> | max-query-response-time <time> Maximum
shutdown | version query response time, in tenths of seconds.
<1:3>]
proxy-interface {gige | xgige} <num> Proxy
interface and number, either gige (0 through 7) or
xgige (0 or 1).
query-interval <seconds> Query interval, in
seconds.
robustness <factor> Robustness to packet
losses.
shutdown Shuts down MGMD.
version <1:3> Sets the Internet Group Man-
agement Protocol (IGMP) version for IPv4 to 1, 2,
or 3, or the Multicast Listener Discovery (MLD)
version to 1 or 2, if an IPv6 address is configured.
The MLD process running over a CMTS interface
discovers multicast listeners (or receivers) for dis-
tribution of multicast traffic.
Example:
CASA(conf-if-mac 1)# mgmd ipv4

version 1
no mgmd ipv4 last-member-query-interval
Casa Systems CMTS

Properties
multicast-dsid-forward Enables multicast Downstream Service Identifier

[wb-cm-only] (DSID) forwarding that allows CMs to filter multicast
traffic before forwarding the traffic to CPE devices.
DSIDs uniquely identify multicast streams over a
MAC domain bonding group. The optional
wb-cm-only modifier sets DSID for wide-band CMs
only. The default is no multicast DSID forwarding. Set
this property especially if running DOCSIS 3.0 and
pre-3.0 along with IPv6. The no form of the command
also takes the dsg modifier.
Example:
multicast-dsid-forward wb-cm-only
no multicast-dsid-forward
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:
CASA(conf-if-mac 1)# privacy tek

life-time 300
no privacy tek life-time
Casa Systems CMTS

Properties
router-advertisement Route advertisements must be enabled when a MAC

<modifier> domain has a CM or CPE in IPv6 mode. One of the
following modifiers must be used:
cur-hop-limit <0:255> Maximum hops.

[no] enable Enables router advertisement.
life-time <0:9000> Router lifetime, in seconds,
default 3*max-advert-interval.
link-mtu <512:1500> MTU default 1500 bytes.
managed-flag {true | false}> Managed
address configuration flag, either true or false.
max-advert-interval <4:1800> Maximum
advertised interval, default 600.
min-advert-interval <3:1350> Minimum
advertised interval, default 200 seconds.
[no] multicast-only Only a multicast response
to router solicitation.
other-config-flag {true | false}> Other stateful
configuration flag, either true or false.
[no] prefix suppression Suppresses the pre-
fix option (the default).
reachable-time <0:3600000> Router reach-
able time, in milliseconds, default 0 (unspecified).
retransmit-time <0:65535> Advertisement
retransmit time, in seconds, default 0 (unspeci-
fied).
row-state {0 | 1} Row status, 0 down or 1 up,
default up.
Example:
router-advertisement enable
no router-advertisement enable
Casa Systems CMTS

Properties
send udc rules Enables sending Upstream Drop Classifier (UDC)

rules, which are a set of matching criteria applied by
the CMs to packets to determine if a packet should
be dropped on upstream traffic.
Example:
CASA(conf-if-mac 1)# send udc rules

CASA(conf-if-mac 1)# no send udc rules
Casa Systems CMTS

Properties
shared-secondary-secret The shared-secondary-secret provides a second

<1|2> <0|7> <mic_string> password should a cable modem fail to authenticate
[extend] with the primary shared-secret. With the secondary
secret configured, the cable modem must
authenticate using either the primary or secondary
password for the modem to register and come online.
Using a secondary secret allows CMTS operators to
frequently revise the primary password without
interrupting a currently active and online cable
modem with a primary password update. The CMTS
supports a maximum of 198 shared secrets (primary,
secondary, and primary/secondary extended). The
required parameters are as follows:
<1 | 2> Index number of the secondary secret,

1 or 2. If two secondary secrets are configured,
the index determines which one it checks first.
<0 | 7> Either an unencrypted (0) or encrypted
(7) message will follow.
<mic_string> Message Integrity Check (MIC)
string used to encrypt and decrypt the configura-
tion file, up to 32 characters.
The optional extend modifier sets the shared-secret

MIC for the extended type-length value encoding
schemes (TLVs) received from the Reg-Req
message.
Example:
shared-secondary-secret 1 7 3155ff
no shared-secondary-secret 1
Casa Systems CMTS

Properties
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:
<0 | 7> Either an unencrypted (0) or encrypted

(7) message will follow.
<mic_string> Message Integrity Check (MIC)
string used to encrypt and decrypt the configura-
tion file, up to 32 characters.
The optional extend modifier sets the shared-secret

MIC for the extended type-length value encoding
schemes (TLVs) received from the Reg-Req
message.
Example:
CASA(conf-if-mac 1)# shared-secret 7

3155ff extend
CASA(conf-if-mac 1)# no shared-secret
shutdown Shuts down the DOCSIS-MAC interface. The no

form of the command restarts the interface.
Example:
CASA(conf-if-mac 1)# shutdown

CASA(conf-if-mac 1)# no shutdown
Casa Systems CMTS

Properties
sid-cluster A SID cluster assigns a type of service flow to each

{max-outstanding-bytes channel in a bonding group. There is no no form of
<0:4294967295> | the command. The following parameters set the SID
max-requests <0:255> | cluster properties:
max-time <0:65535> |
max-total-bytes max-outstanding-bytes <0:4294967295>
<0:4294967295>>} Maximum outstanding bytes, default 0.
max-requests <0:255> Maximum number of
requests, default 0.
max-time <0:65535> Maximum time, in milli-
seconds, default 0.
max-total-bytes <0:4294967295> Maximum
total bytes, default 0.
Example:
CASA(conf-if-mac 1)# sid-cluster

max-time 6000
sync-interval <1:200> Interval between successive sync message

transmissions from the CMTS, default 10
milliseconds.
Example:
CASA(conf-if-mac 1)# sync-interval 100

CASA(conf-if-mac 1)# no sync-interval
Casa Systems CMTS

Properties
tftp-enforce Enables the CMTS to reject registration requests

[src-interface from CMs on the specific MAC domain. If set, CMs
{ip-bundle | loopback must first download their DOCSIS configuration files
<0:15>}] from a TFTP server before the modems are allowed
to register with the CMTS. If disabled (by default),
cable modems are allowed to register with the CMTS
and come online without first downloading their
DOCSIS configuration file from a TFTP server. The
optional source interface can be added, with either
the IP bundle or loopback interface specified. The
default setting is disabled.
Example:
CASA(conf-if-mac 1)# tftp-enforce

src-interface ip-bundle
CASA(conf-if-mac 1)# no tftp-enforce
CASA(conf-if-mac 1)# no tftp-enforce
source-interface loopback
tftp-proxy Enables the TFTP proxy on a domain interface so

that the CM can get the DOCSIS configuration file
(see also the tftp-enforce property).
Example:
CASA(conf-if-mac 1)# tftp-proxy

CASA(conf-if-mac 1)# no tftp-proxy
ucd-interval <100:2000> Interval between transmitting upstream channel

descriptor (UCD) messages scheduled by the CMTS
for all CMs on a cable interface, in milliseconds.
Example:
CASA(conf-if-mac 1)# ucd-interval 100

CASA(conf-if-mac 1)# no ucd-interval
Casa Systems CMTS

Properties
upstream <1:255> Binds an interface upstream to a MAC domain. The

interface upstream values and modifiers are as follows:
<slot>/<port>.<pchan>/
<lchan> <chan_id> User-defined channel identifier
[ambiguity-exclude] unique within a MAC domain.
<slot> Module or slot number.
<port> Port number.
<pchan> Physical channel (one of two).
<lchan> Logical channel (one of two).
ambiguity-exclude Optionally excludes the
channel from the upstream-ambiguity-resolution
list in the MAC Domain Descriptor (MDD).
Example:
CASA(conf-if-mac 1)# upstream 5

interface upstream 13/1.1/0
CASA(conf-if-mac 1)# no upstream 5
upstream channel bonding Enables the DOCSIS3.0 CM to bond to more than

one upstream or downstream channel of the MAC
domain.
Example:
CASA(conf-if-mac 1)# upstream channel

bonding
no upstream channel bonding
Casa Systems CMTS

Properties
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:
CASA(conf-if-mac 1)# upstream drop

classifier
no upstream drop classifier
upstream Enables extending the upstream frequency range

extended-frequency-range beyond the standard North American range to
support other cable systems, such as the European
65 MHz and the Japanese
55 MHz top of ranges.
Example:
CASA(conf-if-mac 1)# upstream

extended-frequency-range
no upstream extended-frequency-range
show docsis downstream channel utilization
Shows the utilization rates of all the downstream channels in the system.
CASA(config)# show docsis downstream channel utilization

Downstream Slot/Port/Channel Utilization (%)
2/0/0 2
2/0/1 2
2/0/2 2
2/0/3 2

Casa Systems CMTS

show downstream channel set [id] [mac-domain <id>]
Shows all downstream channel sets. You can also filter by id and mac-domain.
CASA(config)# show downstream channel set

MAC Chan Channel
ID Set List
1 1 0/0/0
1 2 0/0/1
1 3 0/0/2
1 4 0/0/3
1 5 0/0/4
1 6 0/0/5
1 7 0/0/6
1 8 0/0/7
1 256 0/0/0, 0/0/1, 0/0/2, 0/0/3, 0/0/4
2 1 0/1/8
2 2 0/1/9
2 3 0/1/10
2 4 0/1/11
2 5 0/1/12
2 6 0/1/13
2 7 0/1/14
2 8 0/1/15
2 256 0/1/8, 0/1/9, 0/1/10, 0/1/11, 0/1/12
show channelset <1:downstream | 2:upstream> <mac_domain> <id>
Shows channel sets, downstream or upstream, by MAC domain and ID.
CASA(config)# show channelset 1 1 1

channel id list:1
show cable modem <mac_addr> classifiers
Shows classifiers in the configuration file that the CM is using.
CASA(config)# show cable modem 0050.f112.b764 classifiers

CM Mac Address: 0050.f112.b764
Classifier ID: 3
ServiceFlow ID: 514
Direction: Upstream
Rule Priority: 20
Activation State: Active
IP classifiers:
ToS: 0x00 0x00 0x00
Protocol: 17
Casa Systems CMTS

Source Address: 0.0.0.0

Source Mask: 255.255.255.255
Destination Address: 0.0.0.0
Destination Mask: 255.255.255.255
Source Port Start: 0
Source Port End: 65535
Destination Port Start: 0
Destination Port End: 65535
show cable modem cm-status log
Shows the CM status log of the cable modem.
CASA(config)# show cable modem cm-status log

CMAC Address Status_Event Msg Content Time
e448.c7b4.ab62 SEQ_OUT_OF_RNG Dsid: 56 2015-02-05 17:47:43
Casa Systems CMTS

9-1
Chapter 9. DOCSIS Set-Top Gateway
DSG commands description

The CASA CMTS supports the latest DOCSIS Set-Top Gateway (DSG) specification
from CableLabs. DSG offers substantial support for enhanced DOCSIS
implementation in the Broadband Cable environment. The number of supported DSG
replications per chassis is 8192. Each QAM line card can have up to 1638 DSG
replications.
Creating a DSG configuration involves the following steps:
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.
Casa Systems CMTS

Configuration steps
To use the DSG feature, first complete the basic CMTS configuration and then
configure the DSG feature, as follows:
1. Enable the IGMP client.

CASA(config)# igmp client version 3
2. Enable multicast on the GigE interface.

CASA(config)# interface gige 0
CASA(conf-if-gige0)# ip igmp
3. Enable IGMP query on the MAC domain.

CASA(conf-if-mac3)# mgmd ipv4 version 3
CASA(conf-if-mac3)# no mgmd ipv4 shutdown
4. Configure the default service class for multicast.

CASA(config)# multicast default grp-service-class-name xyz
5. Specify the service class to be used.

CASA(conf-service-class1)# name SCNAME
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
7. Define the DSG tunnel ID.

CASA(config)# dsg tunnel 1
8. Define the tunnel destination MAC address.

CASA(conf-dsg-tunnel 1)# dst-address 0013.f735.d38a
9. Define the service class, if any.

CASA(conf-dsg-tunnel 1)# service-class SRVLCL1
10. Define the client list for DCD messages.

CASA(conf-dsg-tunnel 1)# client-list 1
Casa Systems CMTS

DOCSIS Set-Top Gateway 9-3
11. Define the classifier.

CASA(conf-dsg-tunnel 1)# classifier 1 10 192.168.3.6/32 239.1.1.8
CASA(conf-dsg-tunnel 1)# classifier 2 11 0.0.0.0/0 239.1.1.9
12. Configure the DCD parameters.

CASA(config)# dsg vendor-param-id 1 vendor 1 oui 1:1:0 value cj_vid
CASA(config)# dsg channel-list 1 channel 1 frequency 567000000 dsg
channel-list 1 channel 2 frequency 573000000 dsg
channel-list 1 channel 3 frequency 579000000
CASA(config)# dsg timer-id 1 t1 20 t2 30 t3 40 t4 50
13. Configure the DSD message configuration and enable it on a QAM interface.
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
Table 9-1 lists and briefly describes the objects related to DSG.
Table 9-1. DSG objects
dsg channel-list Creates a DOCSIS Set-Top Gateway (DSG) channel list.

dsg client-list Creates a DSG client list.
dsg dcd-global-enable Globally enables the downstream channel descriptor (DCD)
for DSG
dsg timer-id Sets the DSG timer.
dsg tunnel Creates a DSG tunnel.
dsg tunnel-group Creates a DSG tunnel group.
dsg unicast-port Configures DSG unicast.
dsg vendor-param-id Configures DSG vendor parameters.
Casa Systems CMTS

dsg channel-list
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
<1:4294967295> Channel list ID.

channel <1:4294967295> Downstream channel index.
frequency <0:1000000000> Center frequency of the downstream channel. The
actual number must be a multiple of 62500.
Example:
CASA(config)# dsg channel-list 1

channel 1 frequency 526000000
CASA(config)# no dsg channel-list 1
channel 1
Casa Systems CMTS

dsg channel-list
interface qam
dsg channel <id> channel-list <id>
Assigns a DSG channel list to a downstream channel. (See the interface qam
command.)

CASA(conf-qam 0/1)# channel 0 dsg channel-list 3
show dsg channel-list
Shows the DSG channel list configuration.
CASA(config)# show dsg channel-list

dsg channel-list 1 channel 1 frequency 62500
show dsg downstream dcd
Shows a downstream DSG configuration.
CASA(config)# show dsg downstream dcd

ds dcd dcd num of dcd num of dcd num of
i/f state Tx sent change cnt fragment
0/1/0 dis off 0 0 0
0/1/1 dis off 0 0 0
0/1/2 dis off 0 0 0
0/1/3 dis off 0 0 0
show dsg statistics
Shows the DSG statistics.
CASA(config)# show dsg statistics

DS Channel DCD
2/0/0 0
2/0/1 0
Casa Systems CMTS

dsg client-list
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.
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
<1:4294967295> Client list ID.

client <1:4294967295> Client number.
id-type {appId id-value Client list ID type with its value, one of the following:
<0:65535> | broadcast
id-value <1:65535> | appID Application ID.
caSysId id-value <0:65535> broadcast Broadcast address.
| macAddr id-value
<mac_addr} caSysId CA system ID.
macAddr MAC address.
Example:
CASA(config)# dsg client-list 1

client 1 id-type appID id-value 0
CASA(config)#
no dsg client-list 1 client 1
Casa Systems CMTS

dsg client-list
Properties
vendor-param-id Optional dsg vendor-param-id for the

<1:4294967295> vendor-specific parameters, and applied to the
specified vendor group, default 0.
Example:
CASA(config)# dsg client-list 1 client

1 id-type appID id-val 0
vendor-param-id 12222
show dsg client-list
Shows the DSG client list configuration.
CASA(config)# show dsg client-list

dsg client-list 1 client 1 id-type broadcast id-value 2048
vendor-param-id 2
Casa Systems CMTS

dsg dcd-global-enable
dsg dcd-global-enable
Purpose
The dsg dcd-global-enable command globally enables the downstream channel

descriptor (DCD) for DSG.
mode. Use the no form of the command to disable the property.
Mode
(config)#
Syntax
[no] dsg dcd-global-enable
Casa Systems CMTS

dsg timer-id
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.
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
<1:4294967295> Timer ID.

t1 <1:65535> DSG initialization timeout (t1) in seconds.
t2 <1:65535> DSG operational timeout (t2) in seconds.
t3 <1:65535> DSG two-way retry timeout (t3) in seconds.
t4 <1:65535> DSG one-way retry timeout (t4) in seconds.
Example:
CASA(config)# dsg timer-id 1 t1 20 t2

30 t3 40 t4 50
CASA(config)# no dsg timer-id 1
Casa Systems CMTS

dsg timer-id
show dsg timer
Shows the DSG timer configuration.
CASA(config)# show dsg timer

dsg timer-id 1 t1 20 t2 30 t3 40 t4 50
Casa Systems CMTS

dsg tunnel
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.
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
<1:4294967295> DSG tunnel ID. Specifying the tunnel ID puts you in

DSG tunnel configuration mode.
Example:
CASA(config)# dsg tunnel 2

CASA(config)# no dsg tunnel 2
Casa Systems CMTS

dsg tunnel
Properties
classifier <1:65535> Classifier ID, with the following parameters:

<0:255> {<src_ip4/mask>
| ipv6 <src_ip6/mask>} <1:65535> ID.
<dst_ip> [indcd <0:255> Priority.
[<0:65535> <0:65535>]]
<src_ip4/mask> Source IPv4 address and
mask. Multiple sources can be applied to a single
destination.
ipv6 <src_ip6/mask> Alternative source IPv6
address and mask.
<dst_ip> Destination multicast IP address,
such as 224.0.0.1. Multiple sources can be
applied to a single destination.
indcd [<start_dst_pt> <end_dst_pt>] Optional
to include the classifier in the downstream
channel descriptor (DCD) message, with the
optional destination start and end port numbers.
Example:
CASA(conf-dsg-tunnel 2)# classifier 1

20 192.168.0.1/24 224.0.0.100 indcd
6666 6667
CASA(conf-dsg-tunnel 2)#
no classifier 1
client-list Assigns a dsg client-list to the DSG tunnel.

<1:4294967295>
Example:
CASA(conf-dsg-tunnel 2)# client-list

123
CASA(conf-dsg-tunnel 2)# no client-list
Casa Systems CMTS

dsg tunnel
Properties
dst-address <mac_addr> Destination MAC address for the DSG tunnel, in the
form xxxx.xxxx.xxxx.
Example:
CASA(conf-dsg-tunnel 2)# dst-address

1234.2345.3456
CASA(conf-dsg-tunnel 2)# no dst-address
group <1:4294967295> Associates a dsg tunnel-group with the DSG tunnel.
Example:
CASA(conf-dsg-tunnel 2)# group 3

CASA(conf-dsg-tunnel 2)# no group
service-class <name> Assigns a cable service-class name <name> to the

DSG tunnel, up to 16 characters.
Example:
CASA(conf-dsg-tunnel 2)# service-class

private-class
CASA(conf-dsg-tunnel 2)#
no service-class
show dsg tunnel [<id>]
Shows the DSG tunnel configuration, or for a specific tunnel ID.
CASA(config)# show dsg tunnel

client-list 123
service-class private-class
classifier 1 20 192.168.0.1/24 224.0.0.100 indcd
Casa Systems CMTS

dsg tunnel
show cable dsg tunnel [<id> [cfrs | clients | interface | verbose]]
Shows the cable DSG tunnel configuration. Output can also be filtered by ID, and then
by DSG classifier (CFRS), clients, interface, or verbose.
CASA(config)# show cable dsg tunnel

cfr cfr cfr destination ip source ip srcPre d_port d_port id state pri
address address length start end
Casa Systems CMTS

dsg tunnel-group
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.
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
<1:4294967295> DSG tunnel group ID, although the maximum number

of tunnel groups is 32. Specifying the tunnel group ID
puts you in DSG tunnel-group configuration mode.
Example:
CASA(config)# dsg tunnel-group 2

CASA(conf-dsg-tunnel-grp 2)# exit
CASA(config)# no dsg tunnel-group 2
channel <1:4294967295> Channel ID.

qam <slot>/<port>/<chan> QAM interface ID, as <slot>/<port>/<channel>. (See
the interface qam command.)
Casa Systems CMTS

dsg tunnel-group
Properties
rule-priority <0:255> Optional rule priority number.

ucid-list <string> Optional upstream channel ID list, such as 1,2,3, up
to 255.
vendor-param-id Optional dsg vendor-param-id.
<1:4294967295>
Example:
CASA(conf-dsg-tunnel-grp 2)# channel 1

qam x/y/z rule-priority 20
vendor-param-id 1 ucid-list 1
CASA(conf-dsg-tunnel-grp 2)#
no channel 1
show dsg tunnel-group
Shows the DSG tunnel group configuration.
CASA(config)# show dsg timer

channel 1 qam x/y/z rule-priority 20 vendor-param-id 1 ucid-list 1
channel 2 qam x/y/z rule-priority 30 vendor-param-id 500 ucid-list 2
Casa Systems CMTS

dsg unicast-port
dsg unicast-port
Purpose
The dsg unicast-port command configures DSG unicast.
mode. There is no no form of the command.
Mode
(config)#
Syntax
dsg unicast-port <1:65535>
Properties
<1:65535> Unicast port ID.
Example:
CASA(config)# dsg unicast-port 1
show dsg running-config
Shows the DSG running configuration that includes the unicast port value.
CASA(config)# show dsg running-config

dsg tunnel-group 1
dsg tunnel-group 2
dsg tunnel 1
classifier 1 255 192.168.8.8/24 224.0.0.100 indcd 6666 6667
dsg unicast-port 8888
Casa Systems CMTS

dsg vendor-param-id
dsg vendor-param-id
Purpose
The dsg vendor-param-id command configures DSG vendor parameters. These

vendor parameters can then be assigned to an interface qam channel.
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
<1:4294967295> Vendor parameter index for the vendor-specific

parameters, and applied to the specified vendor
group.
vendor <1:4294967295> Vendor ID.
oui <oui> Vendor Organizational Unique Identifier (OUI), in the
form xx:xx:xx.
value <val> DSG vendor parameters vendor value.
Example:
CASA(config)# dsg vendor-param-id 1

vendor 1 oui 01:02:03 value VENDOR
CASA(config)# no dsg vendor-param-id 1
vendor 1
Casa Systems CMTS

dsg vendor-param-id
show dsg vendor-param
Shows the default CM vendor configuration.
CASA(config)# show dsg vendor-param

dsg vendor-param-id 1 vendor 1 oui 01:02:03 value abc
Casa Systems CMTS

10-1
Chapter 10. Load balancing
Load balancing commands description

The load balancing feature of the Casa CMTS allows system operators to distribute
cable modems across radio frequency downstream and upstream channels on the same
cable interface line card, or across multiple cable interface line cards in some
circumstances. Load balancing maximizes bandwidth and usage of the cable plant.
Load balancing supports multiple methods to achieve greater bandwidth availability.
These include static and dynamic load balancing schemes, inter-line card and
intra-line card support, and in some circumstances, configuration of load balancing
groups that entail multiple interfaces, multiple load balancing policies, and the option
to configure multiple additional load balancing parameters.
A CMTS channel can be load-balanced using two methods:
Number of cable modems Load balancing according to the number of cable

modems on the interface.
Utilization Load balancing according to the current percentage of channel
utilization.
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.
Casa Systems CMTS

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 configure load balancing:
1. Define the MAC domains and the service groups.

2. Define the basic rules and/or the execution rules.
3. Define the load balancing policy and assign the rules to the policy.
4. Apply the policy to a load balancing group, either the default group or a restricted
load balance group.
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.
Casa Systems CMTS

Load balancing 10-3
Table 10-1 lists and briefly describes the objects related to load balancing.
Table 10-1. Load balancing objects
load-balance Initiates load balancing.

load-balance basic-rule Set load balancing basic rules.
load-balance enable Enables load balancing globally.
load-balance exclusion Defines a load balancing exclusion list.
list
load-balance Defines load balancing execution rules.
execution-rule
load-balance Defines load balancing general group policies.
general-group
load-balance permit Permits dynamic bonding change (DBC) messages for
dbc-chg-prim-ds downstream load balancing.
load-balance policy Defines a load balancing policy.
load-balance Creates a restricted configuration for cable modems.
restricted-cm
load-balance Creates a restricted group configuration.
restricted-group
Casa Systems CMTS

load-balance
load-balance
Purpose
The load-balance command configures load balancing for the CMTS. Configuring
load balancing requires the following steps:

2. Define the basic rules and/or the execution rules.
3. Define the load balancing policy and assign the rules to the policy.
4. Apply the policy to a load balancing group, either the load-balance general-group
or a load-balance restricted-group. 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.
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)#
Casa Systems CMTS

Load balancing 10-5
load-balance
show load-balance dynamic
Shows the load balancing dynamic configuration.
CASA(config)# show load-balance dynamic

Mac address Mac_id upstream-channel downstream-channel initial_tech
-------------------------------------------------------------------
cmd status type time
--------------------
The possible type values are as follows:
BAL Balancing done by the system.

CLI Load balancing done manually from the CLI.
CSM DCC done by CSM per cable modem.
DSA DCC done by voice.
EM Energy management.
MIB Load balancing done manually from SNMP.
MLT DCC by limit replication multicast.
RGLB General load balancing done until registration.
RSLB DCC moved a cable modem into a restricted load-balance group.
SG Channel is not in the channel set of the configured service group.
show load-balance static
Shows the load balancing static configuration, the equivalent of the show static
load-balance command.
CASA(config)# show load-balance static

Mac address date time upstream downstream new us new ds
clear load-balance log
Clears all load balancing logs.
CASA(config)# clear load-balance log
Casa Systems CMTS

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:

2. Enter a basic rule.
3. Enable or disable this rule.
4. Specify a time period.
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
<1:4294967295> Load balancing basic rule ID. Using this command

brings you into basic rule configuration mode.
Example:
CASA(config)# load-balance basic-rule 1

CASA(config)#
no load-balance basic-rule 1
Casa Systems CMTS

Load balancing 10-7
Properties
enable Enables the basic rule. Use the no form of the

command to disable the rule. The default for the
load-balance basic-rule is no enable.
Example:
CASA(load-bal-basic-rule 1)# enable

CASA(load-bal-basic-rule 1)# no enable
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
show load-balance basic-rule
Shows the load balancing basic rule configuration.
CASA(config)# show load-balance basic-rule
load-balance basic-rule 1
suspend-load-balance from 12:30:00 to 15:00:00
Casa Systems CMTS

load-balance enable
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.
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
enable Enables load balancing globally.
Example:
CASA(config)# load-balance enable

CASA(config)# no load-balance enable
Casa Systems CMTS

Load balancing 10-9
load-balance enable
Properties
enable across-mac Optionally enables static load balancing across MAC

[downstream] domains, with the optional downstream modifier.
Example:
CASA(config)# load-balance enable

across-mac downstream
CASA(config)#
no load-balance enable across-mac
show load-balance running-config
Shows if load balancing is enabled in the running configuration.
CASA(config)# show load-balance running-config

!
!
! load balance commands
!
load-balance enable
load-balance basic-rule 1
suspend-load-balance from 12:30:00 to 13:00:00
Casa Systems CMTS

load-balance exclusion list

Purpose
The load-balance exclusion list command sets exclusions for load balancing.
exclusion-list configuration mode. Use the no form of the command to remove the
exclusion list.
Modes
(config)#
Syntax
(config)# [no] load balance exclusion list
[no] mac addr <mac_addr> mask <mask> [both | dynamic | static]
Properties
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:
CASA(config)# load-balance exclusion

list
CASA(load-bal-exclusion-list)# mac addr
0014.0000.0000 mask ffff.0000.0000
static
CASA(load-bal-exclusion-list)# no mac
addr 0014.0000.0000 mask ffff.0000.0000
Casa Systems CMTS

Load balancing 10-11
show load-balance exclusion list
Shows the exclusion list configuration.
CASA(config)# show load-balance exclusion list

!
mac addr 0022.2d77.fc56 mask ffff.0000.0000 static
Casa Systems CMTS

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:
1. Enter a load balance execution rule.

2. Specify a minimum time interval between each load balance.
3. Specify a minimum time interval between each upstream load balance.
4. Specify a minimum time interval to move the same modem.
5. Specify a method for load balancing calculation.
6. Specify a method of upstream load balancing for load balancing calculation.
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>]
Casa Systems CMTS

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
<1:16> Execution rule ID. Executing this command takes you

into execution-rule configuration mode.
Example:
CASA(config)# load-balance
execution-rule 5
CASA(config)#
no load-balance execution-rule 5
cable modem Minimum time between when cable modem does

rebalance-interval load balancing successfully and then it can be
<60:3600> load-balanced again, the default 3600 seconds.
Example:
CASA(load-bal-exe-rule 5)# cable modem

rebalance-interval 200
CASA(load-bal-exe-rule 5)#
no cable modem rebalance-interval
cable modem Minimum time interval to move the same modem if

retry-interval first previous load-balancing failed. There are two retry
<0:4294967295> second values. The first retry defaults to 86400 seconds (24
<0:4294967295> hours). The second retry defaults to 432000 seconds
(5 days).
Example:
CASA(load-bal-exe-rule 5)# cable modem

retry-interval first 35000 second 87000
no cable modem retry-interval
Casa Systems CMTS

Properties
enable Enables the execution rule.
Example:
CASA(load-bal-exe-rule 5)# enable

CASA(load-bal-exe-rule 5)# no enable
interval <10:3600> Minimum time interval between each load balance

calculation, default 10 seconds. There is no no form
of the command.
Example:
CASA(load-bal-exe-rule 5)# interval 30
method {modem | Method to determine when to load balance, either

utilization} [dynamic] modem (number of CMs on the interface) or
utilization (current percentage of channel utilization).
A method can apply to dynamic, static or both types
of load balancing. If dynamic is not configured, the
method will apply to both static and dynamic load
balancing. If dynamic is configured, the method
applies only to static load balancing while dynamic
will apply to dynamic load balancing. To disable static
load balancing, set the threshold load to 0. The
default load-balance execution-rule method is
modem.
Example:
CASA(load-bal-exe-rule 5)# method modem

dynamic
no method dynamic
CASA(load-bal-exe-rule 5)# no method
Casa Systems CMTS

Properties
suspicious-channel retry Retry interval for suspicious channels from

interval <0:86400> unregistered modems, default 3600 seconds; a 0
value indicates disabling moving the modem to a
suspicious channel. There is no no form of the
command.
Example:
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:
enforce <num> Enforces the load difference

for dynamic load balancing, the number of
modems on the modem method or the
percentage on the utilization method, default 0
(not enforced).
dynamic minimum <num> Minimum number
of modems for dynamic load balancing, default 0.
minimum <num> For static load balancing,
the minimum number of modems on the modem
method or the minimum percentage on the
utilization method, default 10.
Example:
CASA(load-bal-exe-rule 5)# threshold

load 100 dynamic minimum 2
CASA(load-bal-exe-rule 5)# no threshold
Casa Systems CMTS

Properties
upstream-interval Minimum interval between upstream load balancing

<10:3600> calculations, in seconds.
Note: If the upstream-interval is not configured, the

interval value applies to both upstream and
downstream load balancing. If the upstream-interval
is configured, the upstream-interval value applies to
upstream load balancing; the interval <10:3600>
value applies to downstream load balancing.
Example:
upstream-interval 60
no upstream-interval 60
upstream-method {modem | Method to determine when to load balance for

utilization} [dynamic] upstream traffic. See the method property for details.
Example:
upstream-method modem dynamic
no upstream-method dynamic
no upstream-method
upstream-threshold load Utilization method for upstream load balancing

<0:100> [enforce calculations. See the threshold load property for
<0:100>] [dynamic details on the options.
minimum <2:500> |
minimum <2:500>] Example:
upstream-threshold load 100
no upstream-threshold
Casa Systems CMTS

show load-balance execution-rule
Shows the load balancing execution rule configuration.
CASA(config)# show load-balance execution rule
load-balance execution-rule 1
method modem
threshold load 100 dynamic minimum 2
Casa Systems CMTS

load-balance general-group
Purpose
The load-balance general-group command configures general groups for load

balancing. 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. Configure general groups as follows:
1. Enter the general load balance group default.

2. Enable or disable load balancing functions on the MAC service-group general
group.
3. Specify a technique to move cable modems.
4. Specify the policy to use for load balancing execution.
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>] |
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
Casa Systems CMTS

policy-id <0:4294967295>
Properties
default-settings Enters load balancing group default settings mode.

Example:
general-group default-settings
CASA(load-bal-general-default)#
enable Enables the load balancing function for the default

group (the default).
Example:
CASA(load-bal-general-default)# enable
no enable
Casa Systems CMTS

Properties
initial-tech Specifies the initial technique to use for moving cable

{broadcast-ranging | modems, one of the following:
direct [frequency-limit
<0:60>] | period-ranging broadcast-ranging The cable modem
| reinitialize-mac | broadcasts the full initial ranging request without
unicast-ranging} going off-line and performing re-registration with
the CMTS.
direct This is the initial technique default
setting. The cable modem moves directly to
another channel without performing any type of
ranging. The frequency-limit value is optional,
with 0 no limit. When this limit is set, if the CMTS
needs to move a modem to a new upstream
channel with a frequency difference greater than
the set limit during dynamic load balancing, it
uses broadcast-ranging instead of direct.
period-ranging The cable modem move to a
new channel, but performs periodic ranging
requests for an improved channel opportunity.
reinitialize-mac The cable modem MAC
address is reset, forcing the cable model off-line
and re-registering with the CMTS on the new
channel.
unicast-ranging The cable modem performs
an initial ranging request for a dedicated channel
from the CMTS where there is no other
transmission activity.
The default for the load-balance general-group is no

initial-tech. There is no no form of the command.
Example:
initial-tech broadcast-ranging
Casa Systems CMTS

Properties
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:
policy-id 2
mac-domain <1:96> Enters load balancing group MAC domain

service-group <name> service-group mode, specified with a MAC domain ID
(see the <1:96> property of the interface
docsis-mac command) and an existing service
group name.
Example:
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)#
enable Enables the load balancing function for the group.
Example:
enable
no enable
Casa Systems CMTS

Properties

{broadcast-ranging | modems, one of the following (there is no no form of
direct [frequency-limit the command):
<0:60>] | period-ranging
| reinitialize-mac | broadcast-ranging The cable modem
unicast-ranging} broadcasts the full initial ranging request without
going off-line and performing re-registration with
the CMTS.
with 0 as no limit.
address is reset, forcing the cable model off-line
channel.
Example:
policy-id <0:4294967295> Creates the load-balance policy for load balancing

execution. There is no no form of the command.
Example:
policy-id 2
Casa Systems CMTS

show load-balance general-group
Shows the load balancing general group configuration.
CASA(config)# show load-balance general-group

cfg-id mac sg-name ds-chan-list us-chan-list enable init-tech policy
success fail
- 1 plant1 1,2,3,4,5,6,7 1,2,3,4 true unknown 0
0 0
0 0
0 0
0 0
show load-balance general-group default-settings
Shows the load balancing general group default settings configuration.
CASA(config)# show load-balance general-group default-settings
load-balance general-group default-settings

policy-id 2
enable
show load-balance general-group mac-domain <id> service-group

<name>
Shows the load balancing MAC domain/service group configuration.
CASA(config)# show load-balance mac-domain 1 service-group plant1
load-balance general-group mac-domain 1 service-group plant1

enable
Casa Systems CMTS

load-balance permit dbc-chg-prim-ds
load-balance permit dbc-chg-prim-ds

Purpose
The load-balance permit dbc-chg-prim-ds command permits dynamic bonding

change (DBC) messages for load balancing on the downstream. See the cable
partial-service command for details on DBC messages.
no form of the command to disallow DBC for load balancing.
Mode
(config)#
Syntax
[no] load-balance permit dbc-chg-prim-ds
Casa Systems CMTS

load-balance policy
load-balance policy
Purpose
The load-balance policy command sets policies for load balancing. To set a policy:
1. Enter a load balance policy.

2. Add basic rules to a policy. A policy can have multiple basic rules.
3. Add an execution rule to a policy. A policy can have just one execution rule.
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
<1:4294967295> Load balancing policy ID. This takes you into

load-balancing policy configuration mode.
Example:
CASA(config)# load-balance policy 1

CASA(load-bal-policy 1)# exit
CASA(config)# no load-balance policy 1
Casa Systems CMTS

load-balance policy
Properties
rule basic The load-balance basic-rule ID. A policy can have

<1:4294967295> multiple basic rules.
Example:
CASA(load-bal-policy 1)# rule basic 1

CASA(load-bal-policy 1)# rule basic 2
CASA(load-bal-policy 1)#
no rule basic 2
rule execution <1:16> The load-balance execution-rule ID. A policy can

have only one execution rule.
Example:
rule execution 1
no rule execution
show load-balance policy
Shows the load balancing policy configuration.
CASA(config)# show load-balance policy
load-balance policy 1
rule execution 1
rule basic 1
rule basic 2
Casa Systems CMTS

load-balance restricted-cm
Purpose
The load-balance restricted-cm command creates a restricted configuration for cable

modems. To set a restricted CM policy:
1. Enter the restricted CM configuration.

2. Enter CM MAC address information.
3. Add a service type ID.
4. Add reference to a restricted load balancing group.
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
Casa Systems CMTS

Properties
<1:4294967295> Restricted modem ID. This puts you in restricted-CM

configuration mode.
Example:
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)# mac addr

0022.2d77.fc56
restricted-load-balance- References a load-balance restricted-group.

group <1:4294967295>
Example:
CASA(load-bal-restrict-cm 1)#
restricted-load-balance-group 1
no restricted-load-balance-group
service-type-id <name> Adds a service type name, maximum 16 characters,

embedded in quotes if blank spaces.
Example:
service-type-id plant1
no service-type-id
Casa Systems CMTS

show load-balance restricted-cm
Shows the load balancing restricted-CM configuration.
CASA(config)# show load-balance restricted-cm
load-balance restricted-cm 1
mac addr 0022.2d77.fc56
Casa Systems CMTS

load-balance restricted-group
Purpose
The load-balance restricted-group command creates a restricted group

configuration. A restricted load balancing group is similar to a general load balancing
group except that an upstream and downstream channel set must be specified. A
restricted load balancing group must be a subset of a cable modem service group. To
set a restricted group policy:
1. Enter load balance restricted group mode.

2. Specify the MAC domain on a restricted group.
3. Enable load balancing for this restricted group.
4. Specify a technique to move cable modems.
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
policy-id <0:4294967295>
[no] service-type-id <name>
[no] upstream <slot>/<port>.<chan>/<log_chan>
Casa Systems CMTS

Properties
<1:4294967295> Restricted group ID. This puts you in restricted-group

configuration mode.
Example:
restricted-group 1
CASA(load-bal-restrict 1)# exit
CASA(config)#
no load-balance restricted-group 1
docsis-mac <1:96> DOCSIS MAC domain on a restricted group. (See the

interface docsis-mac command.) There is no no
Example:
CASA(load-bal-restrict 1)# docsis-mac 1
enable Enables load balancing on a restricted group.
Example:
CASA(load-bal-restrict 1)# enable

CASA(load-bal-restrict 1)# no enable
Casa Systems CMTS

Properties

{broadcast-ranging | modems, one of the following (there is no no form of
direct [frequency-limit the command):
<0:60>] | period-ranging
| reinitialize-mac | broadcast-ranging The cable modem
unicast-ranging} broadcasts the full initial ranging request without
going offline and performing re-registration with
the CMTS.
with 0 no limit.
address is reset, forcing the cable model offline
channel.
Example:
CASA(load-bal-restrict 1)# initial-tech

broadcast-ranging
policy-id <0:4294967295> Sets the load-balance policy for the load balancing
restricted group. There is no no form of the
command.
Example:
CASA(load-bal-restrict 1)# policy-id 2
Casa Systems CMTS

Properties
qam <slot>/<port>/<chan> Adds a downstream channel on a restricted group,

specified by slot, port, and downstream channel.
Example:
CASA(load-bal-restrict 1)# qam 7/0/0

CASA(load-bal-restrict 1)# no qam 7/0/0
service-type-id <name> Adds a service type name, up to 16 characters,

embedded in quotes if space characters.
Example:
CASA(load-bal-restrict 1)#
service-type-id plant1
no service-type-id plant1
upstream <slot>/ Adds an upstream channel to the restricted group, in

<port>.<chan>/<log_chan> the format slot/port.channel/upstream logical
channel. (See the interface upstream command.)
Example:
CASA(load-bal-restrict 1)# upstream

5/0.0/1
no upstream 5/0.0/1
show load-balance restricted-group
Shows the load balancing restricted group configuration.
CASA(config)# show load-balance restricted-group

cfg-id mac sg-name ds-chan-list us-chan-list enable init-tech policy
success fail
Casa Systems CMTS

show cable modem service-type-id
Shows the cable modems using the service-type ID.
CASA(config)# show cable modem service-type-id

MAC Address IP Address US DS MAC Prim
Service-Type_ID(C/P)
Intf Intf Status Sid
e448.c7b4.ab62 0.0.0.0 13/0.3/0 2/0/0 init(rc) 285 -/-
e448.c7c0.ebca 0.0.0.0 13/4.2/0 2/2/4 init(rc) 297 -/-
e448.c7c0.f0dc 0.0.0.0 13/2.1/0 2/1/0 init(rc) 288 -/-
Casa Systems CMTS

11-1
Chapter 11. Modulation profiles
Modulation profile commands description

A modulation profile is a collection of burst profiles sent to cable modems in upstream
channel descriptor (UCD) messages to configure modem transmit parameters.
Primary and secondary modulation profiles are supported in an upstream logical
channel configuration. Secondary profiles are not supported on logical channel 1.
Making the number of forward error correction (FEC) bytes smaller in the modulation
profile to reduce overhead helps increase throughput.
Table 11-1 lists and briefly describes the objects related to modulation profiles.
Table 11-1. Modulation profile objects
modulation-profile Initiates modulation profiles.

a-long Creates an a-long modulation profile.
a-short Creates an a-short modulation profile.
initial Creates an initial modulation profile.
long Creates a long modulation profile.
request Creates a request modulation profile.
short Creates a short modulation profile.
station Creates a station modulation profile.
ugs Creates an Unsolicited Grant Service (UGS) modulation
profile.
Casa Systems CMTS

modulation-profile
modulation-profile
Purpose
The modulation-profile command configures a modulation profile, a collection of

burst profiles sent to cable modems in upstream channel descriptor (UCD) messages
to configure modem transmit parameters. Primary and secondary modulation profiles
are supported in an upstream logical channel configuration. Secondary profiles are not
supported on logical channel 1. Making the number of FEC error correction bytes
smaller in the modulation profile to reduce overhead helps increase throughput.
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.
Recommendations for which operation mode to use are as follows:
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>]
Casa Systems CMTS

Modulation profiles 11-3
modulation-profile
(config-mod-profile-<id>)#
a-long
a-short
initial
long
request
short
station
ugs
Properties
<6:1024> Modulation profile ID. (The numbering begins with 6

because there are five Predefined modulation
profiles.) This ID can be used for primary and
secondary modulation profiles assigned to upstream
logical channels.
Example:
CASA(config)# modulation-profile 10
CASA(config-mod-prof-10)# exit
CASA(config)# no modulation-profile 10
Casa Systems CMTS

modulation-profile
Properties
<operation_mode> Optional mode of operation or channel type when

creating the profile in auto mode, one of the following:
atdma Asynchronous Time Division Multiple

Access (ATDMA), a direct evolution of DOCSIS
1.x physical layer (PHY), which uses TDMA
multiplexing.
mtdma Modified Time Division Multiple Access
(MTDMA), or mixed mode operation for ATDMA
and TDMA. MTDMA would let the modem go to
ATDMA if it supports DOCSIS 2.0 and let the
DOCSIS 1.0 modems work on the 16qam or qpsk
modulation type. MTDMA does not support the
6.4-MHz US channel width.
scdma Synchronous Code Division Multiple
Access (SCDMA), where up to 128 symbols are
transmitted simultaneously through 128
orthogonal codes, allowing multiple modems to
transmit in the same time slot.
tdma Time Division Multiple Access (TDMA),
allowing multiple cable modems to share the
same individual RF channel in that it allocates
each cable modem its own transmit time slot.
TDMA supports DOCSIS 1.0/1.1 with a channel
width limit of 3.2 MHz.
Example:
CASA(config)#
modulation-profile 10 tdma
CASA(config-mod-prof-10)#
Casa Systems CMTS

modulation-profile
Properties
<modulation_type> Optional modulation type when creating the profile in

auto mode, one of the following:
qpsk Quadrature Phase Key Shifting (QPSK)

8qam 8 QAM
16qam 16 QAM
32qam 32 QAM
64qam 64 QAM
128qam 128 QAM, available in SCDMA
operation mode
Example:
CASA(config)#
modulation-profile 10 tdma qpsk
CASA(config-mod-prof-10)#
This example creates a profile identical to

modulation-profile 1.
Casa Systems CMTS

modulation-profile
Predefined modulation profiles

modulation-profile 1
-->> Uses QPSK for all 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 qpsk off 84 6 75 338 13 16 shortened on
long tdma qpsk off 96 8 220 338 0 16 shortened on
-->> Similar to profile 1 except uses 16qam for short and long data
burst types for TDMA upstream channels.
short tdma 16qam off 168 6 75 338 7 16 shortened on
long tdma 16qam off 192 8 220 338 0 16 shortened on
-->> 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
-->> 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
-->> 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
Casa Systems CMTS

a-long
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.
The command is executed in Casa modulation-profile configuration mode. There is no

Mode
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}
<operation_mode> The a-long modulation profile has the following

operation modes or channel types:
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.
Casa Systems CMTS

a-long
<0:32767> Scrambler 15-bit seed. In most cases, this value is

338. See also the {on | off} property for scrambler
mode.
<0:255> Maximum burst size (mini-slots).
<4:255> Guard time, the number of symbols to follow the end
of a burst, in modulation intervals.
{fixed | shortened} Code word length, either fixed or shortened.
{on | off} Scrambler mode, either on or off.
<0:2048> Interleave depth. This value applies only in certain
cases.
<0:2048> Interleave block. This value applies only in certain
cases.
{qpsk0 | qpsk1} Preamble type, either qpsk0 (low power) or qpsk1
(high power).
Example
CASA(config-mod-prof-6)# a-long atdma 64qam off 104 4 220 338 0 8 fixed
on 1 1536 qpsk1
Casa Systems CMTS

a-short
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
Syntax
a-short <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config-mod-prof-7)# a-short atdma 64qam off 104 4 75 338 6 8 fixed
on 1 1536 qpsk1
Casa Systems CMTS

initial
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
atdma
mtdma
scdma
tdma
Mode
Syntax
initial <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config-mod-prof-8)# initial atdma qpsk off 640 5 34 338 0 48 fixed
on 1 1536 qpsk0
Casa Systems CMTS

long
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
mtdma
tdma
Mode
Syntax
long <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config-mod-prof-9)# long tdma qpsk off 640 5 34 338 0 48 fixed on
Casa Systems CMTS

request
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
atdma
mtdma
scdma
tdma
Mode
Syntax
request <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config-mod-prof-10)# request atdma qpsk off 64 0 16 338 0 16 fixed
on 1 1536 qpsk0
Casa Systems CMTS

short
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
mtdma
tdma
Mode
Syntax
short <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config-mod-prof-11)# short mtdma qpsk off 64 0 16 338 0 16 fixed
on 1 1536 qpsk0
Casa Systems CMTS

station
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
atdma
mtdma
scdma
tdma
Mode
Syntax
station <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config-mod-prof-12)# station atdma qpsk off 384 5 34 338 0 48
fixed on 1 1536 qpsk0
Casa Systems CMTS

ugs
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
atdma
mtdma
scdma
Mode
Syntax
ugs <operation_mode> <modulation_type> {on | off} <1:1024> <0:16>
off} <0:2048> <0:2048> {qpsk0 | qpsk1}
Example
CASA(config-mod-prof-13)# ugs atdma qpsk off 384 5 34 338 0 48 fixed on
1 1536 qpsk0
Casa Systems CMTS

show modulation-profile [table]
Shows the modulation profile configuration. The additional table modifier renders the
output in table form.
CASA(config)# show modulation-profile

short tdma qpsk off 84 6 75 338 13 16 shortened on
long tdma qpsk off 96 8 220 338 0 16 shortened on
CASA(config)# show modulation-profile 10 table

iuc-type request initial station short long a-short a-long ugs
channel-type atdma atdma atdma - - atdma atdma -
modulation-type qpsk qpsk qpsk - - qpsk qpsk -
diff-encoding off off off - - off off -
preamble-len 64 640 384 - - 104 104 -
FEC-T 0 5 5 - - 12 16 -
FEC-K 16 34 34 - - 75 220 -
scrambler-seed 338 338 338 - - 338 338 -
max-burst-size 0 0 0 - - 6 0 -
guard-time 16 48 48 - - 16 16 -
last-codeword-len fixed fixed fixed - - shortened shortened -
scramble-mode on on on - - on on -
interleaver-depth 1 1 1 - - 1 1 -
interleaver-block 1536 1536 1536 - - 1536 1536 -
preamble-type qpsk0 qpsk0 qpsk0 - - qpsk1 qpsk1 -
interleaver-step - - - - - - - -
spreader - - - - - - - -
subframe-code - - - - - - - -
TCM-encode - - - - - - - -
Casa Systems CMTS

show upstream burst-noise
Shows brief burst noise statistics for all logical channels.
CASA(config)# show upstream burst-noise

upstream channel burst noise rate (events/sec)
10/0.0/0 143.0
10/0.0/1 119.7
10/0.1/0 95.2
10/0.1/1 131.1
10/1.0/0 0.0
10/1.0/1 0.0
10/1.1/0 0.0
10/1.1/1 0.0
show upstream x/y.z/c burst-noise
Shows brief burst noise statistics for a specified logical channel.
CASA(config)# show upstream 10/0.0/0 burst-noise

Burst Noise Stats for Channel 10/0.0/0:
Burst noise event rate: 143.5 events/second.

Percentage of Correctable Burst Events: 98%
Percentage of Uncorrectable Burst Events: 2%
Burst Duration (microseconds) % of Events Max Power (in dB)

----------------------------- ----------- -----------------
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
Casa Systems CMTS

12-1
Chapter 12. Multicast operations
Multicast operation commands description

CASA CMTS software supports DOCSIS 3.0 enhanced IP multicast features such as
Source Specific Multicast, Quality of Service support for multicast traffic, IPv6
multicast, and bonded multicast. These enhanced IP multicast features enable cable
operators to offer various IP multicast-based multimedia services, such as Internet
Protocol Television (IPTV), over the DOCSIS network.
Limited multicast sessions
In order to conserve bandwidth, it is desirable to minimize multicast replication for

IPTV programs. A modem joining a multicast session that is replicated on a different
channel should be moved to that channel, if that channel is reachable by the modem.
Multicast sessions that desire minimum replication are termed limited multicast
sessions. There are multicast sessions that many clients join. For example, multicast
sessions used to distribute EPG information are referred to as general multicast
sessions. General multicast sessions should be replicated to current channels, and
must not trigger DCC/DBC transactions.
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.
Casa Systems CMTS

Multicast operation commands description
3. Configure the application ID with limit replication and maximum IPTV channels.
For example, to identify multicast session matching group address 230.0.1.0/24 as

limited multicast sessions, define the following configurations:
CASA(config)# multicast group config 1

CASA(conf-grp-config 1) source-address 0.0.0.0/0
CASA(conf-grp-config 1) group-address 230.0.1.0/24
CASA(conf-grp-config 1) qos-id 1
CASA(conf-grp-config 1) end
CASA(config) multicast group qos 1 IPTV aggregate max-sess 10 app-id 1
CASA(config) application policy 1234
CASA(conf-app-policy 1234) limit replication
CASA(conf-app-policy 1234) max iptv channel 2
Table 12-1 lists and briefly describes the objects related to multicast operations.
Table 12-1. Multicast operation objects
mcast-classifier ds_chan Classifies packets according to both source and destination

(group) addresses.
mcast-service-flow Creates a multicast service flow.
ds_chan
multicast authorization Configures authorization for multicast operations.
multicast default Configures a default service class.
grp-service-class-name
multicast group Configures a multicast group and its properties
multicast load-balance Sets the ranging technique for multicast load balancing.
initial-tech
multicast max Sets the maximum percentage threshold for multicast
channel-util streams per channel.
multicast single_said Enables a single security association (SA) identifier (SAID)
to be used for multicast session encryption.
multicast switch over Sets the time to switch over from multicast to unicast.
time
Casa Systems CMTS

Multicast operations 12-3
mcast-classifier ds_chan
Purpose
The mcast-classifier ds_chan command classifies packets according to source and

destination (group) addresses.
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
<slot>/<port>/<chan> Downstream channel ID, in the form slot/port/

channel.
cl_id <1:4092> Classification ID.
sf_id <1:4092> Service flow ID.
dst-ip <ip_addr> <mask> Optional destination IP address and mask, which can
be followed by the protocol or tos value.
Example:
CASA(config)# mcast-classifier ds_chan

2/0/0 cl_id 1 sf_id 1 dst-ip
192.168.8.8 255.255.255.0
Casa Systems CMTS

Properties
pri <0:24> Optional priority of the classifier, which can be

followed by the src-ip, dst-ip, protocol, or tos value.
Example:

2/0/0 cl_id 1 sf_id 1 priority 24
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:

2/0/0 cl_id 1 sf_id 1 protocol 256
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:

2/0/0 cl_id 1 sf_id 1 src-ip
192.168.7.7 255.255.255.0
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:

2/0/0 cl_id 1 sf_id 1 tos 2 4 255
Casa Systems CMTS

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
<slot>/<port>/<chan> Downstream channel ID, in the form slot/port/

channel.
sf_id <1:4092> Service flow ID.
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
Casa Systems CMTS

Properties
dsid <1:4092> ID for multicast packets of the downstream service

flow.
Example:
ds_chan 2/0/0 sf_id 1 dsid 1
pri <0:7> Priority of the packets of the service flow.
Example:
ds_chan 2/0/0 sf_id 1 dsid 1 pri 7
gu_rate <Bps> Guaranteed rate of the service flow, in bytes per

second.
Example:
gu_rate 24
gu_buf_sz <bytes> Guaranteed buffer size, in bytes.
Example:
gu_rate 24 gu_buf_sz 8
mx_rate <Bps> Maximum rate of the service flow, in bytes per

second.
Example:
gu_rate 24 gu_buf_sz 8 mx_rate 32
Casa Systems CMTS

Properties
mx_buf_sz <bytes> Maximum buffer size, in bytes.
Example:
mx_buf_sz 64
default Optional default service flow.
Example:
mx_buf_sz 64 default
show multicast service-flow [module <id>]
Shows the multicast service flow configuration.
CASA(config)# show multicast service-flow

Module SFID Chan(s) KBitrate Stats (PktSent, ByteSent, PktDrop
ByteDrop)
qam 0 1 0/0/0 0 0, 0, 0, 0
2 0/0/0 0 0, 0, 0, 0
3 0/0/1 0 0, 0, 0, 0
4 0/0/1 0 0, 0, 0, 0
5 0/0/1 0 0, 0, 0, 0
6 0/0/2 136 154050, 10475400, 0, 0
7 0/0/2 0 0, 0, 0, 0
8 0/0/2 136 154046, 10475128, 0, 0
9 0/0/0 0 0, 0, 0, 0
10 0/0/1 0 0, 0, 0, 0
Casa Systems CMTS

multicast authorization
Purpose
The multicast authorization command configures authorization for multicast

operations. In the Casa configuration mode, using the multicast authorization
profile command moves you into authorization profile configuration mode. Use the
no form of the command to remove the multicast authorization property.
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>
[no] multicast authorization profile <name>

(conf-auth-file x)#
[no] desc <text>
session-rule <1:4294967295> {accept | deny} {<src_v4_addr>/<mask>
<grp_v4_addr>/<mask> | ipv6 <src_v6_addr>/<prefix>
<grp_v6_addr>/<prefix>} priority <0:255> [vrf <id>]
no session-rule <1:4294967295>
Properties
default-action {deny | Changes the default behavior of a multicast join

permit} request to deny or permit. There is no no form of the
command.
Example:
CASA(config)# multicast authorization

default-action permit
Casa Systems CMTS

Properties
enable Enables multicast authorization globally.
Example:

enable
CASA(config)#
no multicast authorization enable
match-profile <name> Assigns a profile <name> to multicast authorization.

When IP multicast authorization is enforced, this
attribute provides the default set of multicast
authorization profiles the CMTS enforces for a CM if
it did not signal a set of profiles during the registration
process. Use the command again for each profile.
Example:

match-profile MYPROF
CASA(config)# no multicast
authorization match-profile MYPROF
max-session-num <0:65535> Restricts the number of join requests accepted from

each CM. If set to 0, the maximum number of
sessions is not limited by the CMTS. There is no no
Example:

max-session-num MYPROF
Casa Systems CMTS

Properties
profile <name> Configures a multicast authorization profile, with a

name up to 15 characters. Creating a profile sets you
in authorization profile configuration mode.
Example:

profile MYPROF
CASA(conf-auth-file MYPROF)# exit
CASA(config)# no multicast
authorization profile MYPROF
desc <text> Description of the authorization profile, a quoted

string up to 32 characters.
Example:
CASA(conf-auth-file MYPROF)# desc My

Multicast Profile
CASA(conf-auth-file MYPROF)# no desc
Casa Systems CMTS

Properties
session-rule Sets an authorization profile session rule with a rule

<1:4294967295> {accept | ID and one of the following properties:
deny} {<src_v4_addr>/
<mask> <grp_v4_addr>/ accept or deny Indicates whether the rule
<mask> | ipv6 permits a matching multicast join request to be
<src_v6_addr>/<prefix> accepted or denied. If no rules match the
<grp_v6_addr>/<prefix>} multicast join request, the request will take the
priority <0:255> [vrf default-action {deny | permit}.
<id>] <src_v4_addr>/<mask> Source IPv4 address
and mask to indicate a range of source
addresses, in the form A.B.C.D/M. If a mask
length of zero is set for the source address,
requests with any source address match this rule.
<grp_v4_addr>/<mask> Multicast group IPv4
address and mask to indicate a range of multicast
group addresses, in the form A.B.C.D/M.
ipv6 <src_v6_addr>/<mask> <grp_v6_addr>/
<mask> Alternative IPv6 source and group
address ranges. If a mask length of zero is set for
the source address, requests with any source
address match this rule.
priority <0:255> Priority number. If more than
one session rule matches a joined session, the
session rule with the highest rule priority
determines the authorization action.
vrf <id> Optional Virtual Routing and
Forwarding (VRF) identifier.
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
Casa Systems CMTS

show multicast authorization profile
Shows the multicast authorization profile configuration with the session rule.
CASA(config)# show multicast authorization profile

multicast authorization profile MYPROF
desc MYPROF
session-rule 1234 accept ipv6 111:111::111/32 111:111::112/32
priority 255
show igmp client
Shows the multicast authorization sessions.
CASA(config)# show igmp client

Number Module Vlan Multicast Group
------ ------ ---- --------- -----
IPV6 Multicast Groups:
Number Module Vlan Multicast Group
------ ------ ---- --------- -----
Casa Systems CMTS

multicast default grp-service-class-name
multicast default grp-service-class-name

Purpose
The multicast default grp-service-class-name command configures a default service

class, which is used if a join request does not match any of the multicast group
configuration table entries. If a default service class is not configured, the request will
be denied.
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
<name> Identifies the cable service-class name <name>, up

to 15 characters.
Example:
CASA(conf)# multicast default

grp-service-class-name DGSC1
CASA(conf)# no multicast default
grp-service-class-name
Casa Systems CMTS

multicast group
multicast group
Purpose
The multicast group command configures a multicast group and its properties.
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>
Casa Systems CMTS

multicast group
Properties
config <1:4294967295> Configures a multicast group configuration table, with

an ID. Creating a configuration table sets you in
group configuration mode. There are no no forms of
the group configuration properties.
Example:

CASA(conf-grp-config 1)# exit
CASA(config)#
no multicast group config 1
encryption-id <0:65535> Multicast encryption ID.
Example:
CASA(conf-grp-config 1)# encryption-id

0
group-address Range of multicast group IP addresses. The mask/

{<ip_addr>/<mask> | ipv6 prefix value is 0 through 32 for IPv4, and 1 through
<v6_addr>/<prefix>} 128 for IPv6.
Example:
CASA(conf-grp-config 1)# group-address

192.168.8.8/24
phs-id <0:65535> Payload header suppression (PHS) identifier, from 0

through 65535. PHS reduces redundant packet
header information during the multicast session. Any
suppression information is re-inserted at the
destination.
Example:
CASA(conf-grp-config 1)# phs-id 1
Casa Systems CMTS

multicast group
Properties
priority <0:255> Priority of the entry when a newly replicated multicast

session matches multiple entries. Higher values
indicate a higher priority.
Example:
CASA(conf-grp-config 1)# priority 1
qos-id <0:65535> Identifies the qos <1:65535> <class_name>

{aggregate max-sess <1:65535> | single} [app-id
<1:32>} instance for configuring the QoS for the
replications of the sessions matching this GC. The
value 0 indicates that QoS is allocated based on the
default SCN for all replications derived from this
group configuration.
Example:
CASA(conf-grp-config 1)# qos-id 1
source-address Range of source IP addresses. The mask/prefix

{<ip_addr>/<mask> | ipv6 value is 0 for ASM-based sessions, 0 through 32 for
<v6_addr>/<prefix>} IPv4, and 1 through 128 for IPv6.
Example:
CASA(conf-grp-config 1)# source-address

192.168.8.8/24
tos-high <0:255> High value of a range of the TOS byte value to be

defined in a packet classifier.
Example:
CASA(conf-grp-config 1)# tos-high 100
Casa Systems CMTS

multicast group
Properties
tos-low <0:255> Low value of a range of the TOS byte value to be

Example:
CASA(conf-grp-config 1)# tos-low 1
tos-mask <0:255> Mask value bitwise and with a TOS byte value to be
Example:
CASA(conf-grp-config 1)# tos-mask 255
vrf <id> Virtual Routing and Forwarding (VRF) identifier, with

global the default.
Example:
CASA(conf-grp-config 1)# vrf VPN1
encryption <1:65535> Configures multicast group encryption, with an

algorithm {aes128 | cmts | instance ID and an algorithm setting to identify which
des40 | des56} encryption algorithm will be used for an SA
referenced by this object (AES, CMTS, DES40, or
DES56).
Example:
CASA(conf)# multicast group encryption

1 algorithm cmts
CASA(conf)#
no multicast group encryption 1
Casa Systems CMTS

multicast group
Properties
qos <1:65535> <class_name> Configures the multicast group quality of service

{aggregate max-sess (QoS), with the following properties:
<1:65535> | single} [app-id
<1:32>} <id> Service ID.
<class_name> The cable service-class
name <name> reference for the set of QoS
parameters for this GQC object, up to 15
characters.
aggregate Combines all sessions with
matching criteria into the same GCR, and only
one service flow is used for all sessions and the
max-sess number will determine the maximum
number of sessions that will be allowed to use the
service flow.
single Creates a unique GCR and GSF for the
session. If the multicast group QoS is configured
to be single, a new downstream service flow is
used for each session.
max-sess <num> Maximum number of
sessions that can be aggregated in an
aggregated service flow. This value is ignored in
case of a CGR with QosCtrl set to single.
app-id <id> Optional application policy ID to
enable special features for QoS admission control
or other policies. The behavior and usage of the
application identifier is vendor-specific.
Example:
CASA(conf)# multicast group qos 13

my-srvs-class single app-id 1
CASA(conf)# no multicast group qos 13
Casa Systems CMTS

multicast group
show multicast group config
Shows the multicast group configuration.
CASA(config)# show multicast group config
multicast group config 1

source-address 192.168.8.8/24
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
show multicast group encryption
show multicast group qos
show multicast group-address <ip_addr> client
show multicast replication
Shows the multicast replication for each session.
CASA(config)# show multicast replication

Multicast Session
Module ReplID DSID(hex) SFID Type Chan(s)
<226.94.0.0::0.0.0.0>
qam 0 2 n/a 2 DEF 0/0/0
qam 0 1 n/a 1 IPTV 0/0/0
Casa Systems CMTS

multicast group
show multicast vrf <id> replication [module <id> stats]
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.
CASA(config)# show multicast vrf VPN95 replication module 0 stats
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
Casa Systems CMTS

multicast load-balance initial-tech

Purpose
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
broadcast-ranging Enables the cable modem to broadcast the full initial

ranging request without going off line and performing
re-registration with the CMTS.
Example:
CASA(config)# multicast load-balance

direct Initial technique default setting. The cable modem

moves directly to another channel without performing
any type of ranging.
Example:

initial-tech direct frequency-limit 60
Casa Systems CMTS

Properties
period-ranging Enables the cable modem to move to a new channel,

but performs periodic ranging requests for an
improved channel opportunity.
Example:

initial-tech period-ranging
reinitialize-mac Enables resetting the cable modem MAC address,

forcing the cable model off line and re-registering with
the CMTS on the new channel.
Example:

initial-tech reinitialize-mac
unicast-ranging Enables the cable modem to perform an initial

ranging request for a dedicated channel from the
CMTS where there is no other transmission activity.
Example:

initial-tech unicast-ranging
Casa Systems CMTS

multicast max channel-util
multicast max channel-util

Purpose
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.
Mode
(config)#
Syntax
multicast max channel-util <1:100>
Properties
<1:100> Maximum percentage threshold for multicast streams

per channel, default 60.
Example:
CASA(config)# multicast max

channel-util 60
Casa Systems CMTS

multicast single_said
multicast single_said
Purpose
The multicast single_said command enables a single security association (SA)

identifier (SAID) to be used for multicast session encryption during multicast traffic
forwarding on bonded cable modems. The default setting is disabled, where each
multicast replication is assigned a different SAID to help prevent cable modems from
receiving duplicate traffic. When enabled, a single SAID is assigned to all multicast
replications.
Mode
(config)#
Syntax
[no] multicast single_said
Casa Systems CMTS

multicast switch over time
multicast switch over time

Purpose
The multicast switch over time command sets the time to switch over from multicast
to unicast.
Mode
(config)#
Syntax
[no] multicast switch over time <100:10000>
Properties
<100:10000> Switchover time from multicast to unicast, in tenths of

a second, with no switchover by default.
Example:
CASA(config)# multicast switch over

time 100
CASA(config)#
no multicast switch over time
Casa Systems CMTS

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

CASA(conf-if-mac 1)# multicast-dsid-forward wb-cm-only
no mgmd ipv4 shutdown
Enables the Multicast Group Membership Discovery (MGMD) protocol on a DOCSIS

MAC domain interface. (See the mgmd {ipv4 | ipv6} [last-member-query-interval
<0:31744> | max-query-response-time <0:31744> | proxy-interface <if> |
query-interval <0:31744> | robustness <1:255> | shutdown | version <1:3>]
property for details.)

CASA(conf-if-mac 1)# 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).
CASA(config)# interface vlan 244

CASA(conf-if-vlan 244)# rate-limit multicast 256
Casa Systems CMTS

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.
CASA(config)# ip pim rp-address 143.1.1.1 access-list MULTIACL1

override
CASA(config)# ip pim rp-candidate gige 1 priority 5
system rate-limit multicast
Sets packet-per-second (PPS) rate limits that the system uses for Layer 2 destination
lookup failure (DLF) for multicast packets.
CASA(config)# system rate-limit multicast
show multicast running-config
Shows the multicast running configuration.
CASA(config)# show multicast running-config

!
!multicast
!
multicast authorization profile MYPROF

desc THIS IS IT...
session-rule 1234 accept ipv6 111:111::111/32 111:111::112/32
priority 255

source-address 192.168.8.8/24
Casa Systems CMTS

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
multicast load-balance initial-tech direct

!
show ip multicast traffic
Shows the multicast traffic stream. You can also filter the output by group address,
docsis, or video.
CASA(config)# show ip multicast traffic

Flags: VI = video, DS = docsis, FW = forward, BL = blocked
NONE = no reason, NOMR = no mroute, DUPL = duplicate
RPTP = rpt prune, WIIF = wrong iif, WMAC = wrong mac
WOIF = wrong oif, NRPF = no rpf route, NARP = unresolved arp
Multicast Group Source IP NextHop MAC Src Intf Out
Intf Rate (kb) Flags Up Time
show ip mroute
Shows the multicast routing table.
CASA(config)# show ip mroute

(198.24.25.55, 234.209.0.6), RP 24.1.1.1, 00:00:24/00:00:35
Incoming interface: interface xgige 1, RPF nbr 199.209.0.254
Outgoing interface list:
interface qam 4
...
Casa Systems CMTS

13-1
Chapter 13. PacketCable
PacketCable commands description

The Casa CMTS supports the latest PacketCable specification from CableLabs.
Those PacketCable features offer an end-to-end solution for traffic that originates or
terminates on a cable network, simplifying the task of providing multimedia services
over an infrastructure composed of disparate networks and media types. It also
provides an integrated approach to end-to-end call signaling, provisioning, quality of
service (QoS), security, billing, and network management.
Table 13-1 lists and briefly describes the objects related to PacketCable.
Table 13-1. PacketCable objects
packetcable Enables and configures PacketCable.
Casa Systems CMTS

packetcable
packetcable
Purpose
The packetcable command enables PacketCable and configures its properties.
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>
Casa Systems CMTS

PacketCable 13-3
packetcable
Properties
<cr> The packetcable keyword with a carriage return

enables PacketCable operations.
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:
CASA(config)# packetcable cops ip dscp

62
dscp check Enables checking of Differentiated Services Code

Point (DSCP) level of service settings in IP headers.
Example:
CASA(config)# packetcable dscp check

CASA(config)# no packetcable dscp check
elemid <0:99999> Configures an event message, with the event

message ID defaulting to 99999.
Example:
CASA(config)# packetcable elemid 99996

CASA(config)# no packetcable elemid
Casa Systems CMTS

packetcable
Properties
ftp {newuser <name> | user Configures an FTP user for PacketCable, with a
password <pwd>} username and password, default casa.
Example:
CASA(config)# packetcable ftp newuser

FTPUSER
CASA(config)# packetcable ftp user
password casa
CASA(config)# no packetcable ftp user
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:
CASA(config)# packetcable inactive call

aging 4 minimum traffic 50
max {emerg | normal} call Configures maximum emergency or normal calls for
<0:8000> the CMTS, default 0 (disabled).
Example:
CASA(config)# packetcable max emergency

call 100
CASA(config)# packetcable max normal
call 0
CASA(config)#
no packetcable max normal call
Casa Systems CMTS

PacketCable 13-5
packetcable
Properties
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:
CASA(config)# packetcable media alive

time 10:30
CASA(config)#
no packetcable media alive
mgpi Enables multiple grants per interval (MGPI) that

allows mapping of multiple PacketCable Multimedia
(PCMM) voice flows into a single DOCSIS service
flow.
Example:
CASAconfig)# packetcable mgpi

CASA(config)# no packetcable mgpi
multimedia [T1 <1:1000>] Enables PacketCable Multimedia (PCMM) so that the

CMTS generates and responds to PCMM Common
Open Policy Service (COPS) commands. Once
enabled, the CMTS attempts a COPS connection
over a TCP connection to a PCMM policy server. The
optional T1 property sets a T1 timer, in seconds, that
configures the amount of time that PCMM will remain
in an authorized state.
Example:
CASA(config)# packetcable multimedia t1

100
CASA(config)# no packetcable multimedia
Casa Systems CMTS

packetcable
Properties
myaddress <ip_addr> Configures an IP address for PacketCable, in octet

format, default 0.0.0.0.
Example:
CASA(config)# packetcable myaddress

1.1.1.1
CASA(config)# no packetcable myaddress
nls {agid <0:4294967295> Configures Network Layer Signaling (NLS) for

key <key> | cpd | transporting Control Point Discovery (CPD)
source-interface loopback messages, setting the Authentication Group Identifier
<0:15>} (AGID), and the CMTS loopback interface for NLS
traffic. The options are agid, cpd, and the loopback
source-interface, as follows:
agid <id> key <key> Authentication Group

Identifier and key TLV to be carried over NLS
authentication message exchanges. The AGID
and variable key string must be matched for a
successful request and reply exchange.
cpd Specifies using Control Point Discovery
(CPD) messaging. CPD messages are carried by
the NLS protocol to media endpoints (MTAs) to
gather the IP addresses of end devices.
source-interface loopback <0:15> CMTS
logical interface for NLS traffic.
Example:
CASA(config)# packetcable nls cpd

CASA(config)# packetcable nls
source-interface loopback 10
CASA(config)# packetcable nls agid 124
key alpha
CASA(config)# no packetcable nls cpd
Casa Systems CMTS

PacketCable 13-7
packetcable
Properties
pepid <text> Policy Enforcement Point (PEP) ID, up to 63 bytes.

PEP is the client entity in COPS that consults with the
Policy Decision Point (PDP) to make policy decisions
or obtain policy information that it may use to make
admission control decisions. The PEP may receive
requests for service and initiate a query to the PDP
that results in a go/no-go response, or the PEP may
inform the PDP that it wants to receive decisions and
policy related information on an unsolicited basis.
Example:
CASA(config)# packetcable pepid

casa@packet.cable
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:
CASA(config)# packetcable rks batchfile

max msg 10
max size 4096
sendmode udp
time 120
CASA(config)#
no packetcable rks batchfile time
Casa Systems CMTS

packetcable
Properties
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:
CASA(config)# packetcable rks retry 6

CASA(config)# no packetcable rks retry
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:
CASA(config)# packetcable rks timeout 9

CASA(config)#
no packetcable rks timeout
t0 <1:65535> Configures the T0 timer, default 30 seconds.
Example:
CASA(config)# packetcable t0 30
CASA(config)# no packetcable t0
t1 <1:65535> Configures the T1 timer, default 200 seconds.
Example:
CASA(config)# packetcable t1 200

CASA(config)# no packetcable t1
vrf <name> Configures the virtual routing forwarding (VRF)

instance for PacketCable.
Example:
CASA(config)# packetcable vrf VFR1

CASA(config)# no packetcable vrf VRF1
Casa Systems CMTS

PacketCable 13-9
packetcable
show packetcable global
Shows the packet cable global parameters. Note that in release 6.5 the PacketCable
Multimedia (PCMM) version is set to 5.0 by default.
CASA(config)# show packetcable global

**********PacketCable Global***********
PacketCable: enable
Element ID: 9999
PEP ID: casa@packet.cable
MyIPaddr: 0.0.0.0
Gate ID Used: 0
Max Gate: 19660
COPS Server Listen Port: 2126
RKS_Receive_Port: 1813
PCMM Listen Port: 3918
PCMM version: 5.0

show packetcable log
Shows the PacketCable event messages.
CASA(config)# show packetcable log

697
show packetcable rks server
Shows the Record Keeping Server (RKS) information.
CASA(config)# show packetcable rks server

IP Address Port Timeout Retry Batch_file File_mode File_size
File_max_msg
show packetcable gate
Shows a summary of live gates.
CASA(config)# show packetcable gate

GateID SubID Type State Dir PDPIP RKSIP
Casa Systems CMTS

packetcable
show packetcable commit gate
Shows the number of committed gates.
CASA(config)# show packetcable commit gate

Packetcable committed gates count is 0
show packetcable cms server
Shows the Common Open Policy Service (COPS) server IP address and listen port.
CASA(config)# show packetcable cms server

IP Address Port
show packetcable mgpi [cm <mac_addr>]
Shows the multiple grants per interval (MGPI), if enabled by the packetcable mgpi
command, with the option of specifying a particular cable modem.
CASA(config)# show packetcable mgpi
Casa Systems CMTS

14-1
Chapter 14. Policy commands
Policy commands description

Policies are used in various contexts, including Load balancing and cable
admission-control.
Casa has commands in configuration mode for setting classes and policies.
Table 14-1 lists and briefly describes the objects related to classes and policies.
Table 14-1. Policy objects
application Configures application classes and policies.

class Configures application classes.
policy Configures application policies.
class-map Configures a class map.
policy-map Configures a policy map.
Casa Systems CMTS

application
application
Purpose
The application command configures application classes and policies.
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.
The two application objects are described in the following sections.
Mode
(config)#
Syntax
[no] application class <1:16>
[no] application policy <1:32>
Properties
class <1:16> Sets an application class.
Example:
CASA(config)# application class 1

CASA(conf-app-class 1)# exit
CASA(config)# no application class 1
policy <1:32> Sets an application policy.
Example:
CASA(config)# application policy 12

CASA(conf-app-policy 12)# exit
CASA(config)# no application policy 12
Casa Systems CMTS

Policy commands 14-3
class
class
Purpose
The application class command defines application class properties in Casa

application-class configuration mode. Each application class is a service that defines
the rules for matching service flows to that application class for bandwidth calculation
prior to admission (see the include property). An application class can be assigned in
only one direction, either downstream or upstream.
Up to 16 unique application classes are supported in the CMTS configuration for

classifying different flows. Each application class can be assigned a unique bandwidth
percentage on upstream or downstream channels (with upstream being the default).
This bandwidth percentage can be exclusive or non-exclusive. With the exclusive
bandwidth percentage, one application class will use all the allocated percentage. The
non-exclusive bandwidth percentage provides additional resources whenever the
exclusive bandwidth is insufficient to handle the service flows belonging to the
application class. If both are used, they cannot add up to more than 100%.
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.
(See also the cable admission-control command.)
Use the no form of the command to remove the property.
Mode
(conf-app-class <index>)#
Casa Systems CMTS

class
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
name <name> Required application class (or child application class)

name, up to 15 characters. There is no no form of the
command.
Example:
CASA(conf)# application class 1

CASA(conf-app-class 1)# name APPCLASS1
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:
CASA(conf-app-class 1)# include BE

CASA(conf-app-class 1)# child-class 1
name APPCLASS1.1
include pcmm app-id 1
upstream-bandwidth exclusive 10
CASA(conf-app-class 1)#
no child-class 1
Casa Systems CMTS

class
Properties
downstream-bandwidth Downstream bandwidth exclusive range that is the

exclusive <1:100> critical threshold for the downstream throughput
[non-exclusive <0:100>] resource, or the percentage of throughput reserved
exclusively for this class or child class. The optional
non-exclusive range is the percentage of bandwidth
over and above the exclusive share that can be used
by this class or child class. The non-exclusive range
can be used by other classes as specified. The
exclusive and non-exclusive ranges cannot add up to
more than 100%. If non-exclusive is omitted for the
parent class, it assumes the remaining percentage
from the exclusive range. If non-exclusive is omitted
for the child class, it assumes the exclusive value
from the parent.
The child class bandwidth definition must have a

matching direction (upstream or downstream)
defined for the parent. If a direction for the parent is
omitted, upstream is the default. There is no no form
of the command.
Example:
downstream-bandwidth exclusive 16
non-exclusive 20
Casa Systems CMTS

class
Properties
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:
CASA(conf-app-class 1)# include pcmm

app-id 0 1 2 3 4 5 6 7
no include pcmm app-id 0
Casa Systems CMTS

class
Properties
upstream-bandwidth Upstream bandwidth exclusive range that is the

exclusive <1:100> critical threshold for the upstream throughput
[non-exclusive <0:100>] resource, or the percentage of throughput reserved
exclusively for this class or child class. The optional
non-exclusive range is the percentage of bandwidth
over and above the exclusive share that can be used
by this class or child class. The non-exclusive range
can be used by other classes as specified. The
exclusive and non-exclusive ranges cannot add up to
more than 100%. If non-exclusive is omitted for the
parent class, it assumes the remaining percentage
from the exclusive range. If non-exclusive is omitted
for the child class, it assumes the exclusive value
from the parent.
The child class bandwidth definition must have a

matching direction (upstream or downstream)
defined for the parent. If a direction for the parent is
omitted, upstream is the default. There is no no form
of the command.
Example:
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.
CASA(conf-app-class 10)# show application class 10

application class 10
name class1
downstream-bandwidth exclusive 10 non-exclusive 20
child-class 1 name 10.1
child 1 : accept 0, deny 0, dcc 0, force free 0
total : accept 0, deny 0, dcc 0, force free 0
Casa Systems CMTS

class
CASA(conf-app-class 10)# child-class 1 downstream-bandwidth

exclusive 2 non-exclusive 30
error, child-class total threshold 32 exceeded the limitation of
parent-class's total 30
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.
CASA# show application class 10

application class 10
name class1
child-class 1 downstream-bandwidth exclusive 2 non-exclusive 28
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.
Casa Systems CMTS

class
CASA# show application class

application class 1
name wave1
include service-class STMrule_DWN.2 STMrule_DWN.1
include BE
child-class 1 name Wave3_CC_1
child-class 1 include pcmm app-id 1 5
child-class 2 downstream-bandwidth exclusive 20
child-class 3 include pcmm app-id 3
application class 2
name Wave3
include service-class STMrule_DWN.2 STMrule_DWN.1
include BE
child-class 3 include pcmm app-id 3
CASA# show cable modem qos

Sfid Dir Curr Sid Sched Prio ... Throughput ServiceClassName
State Type
Mac Addr : 0014.04dd.6586
49165 US act 15 BE 0 ... ... STMrule_UP.2
49168 US act 16 BE 0 ... ... STMrule_UP.1
57358 DS act N/A UNDEF 0 ... ... STMrule_DWN.2
57359 DS act N/A UNDEF 0 ... ... STMrule_DWN.1
Casa Systems CMTS

class
Implements Subscriber Traffic Management (STM) to allow CMTS users to monitor

and enforce upstream and downstream transmission rates for subscribers. (See the
cable traffic-policy command in Chapter 3, Cable commands.)
show application class
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).
Casa Systems CMTS

policy
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
limit replication Limits replication, with the optional override modifier

[override] to limit replication override.
Example:
CASA(conf)# application policy 1

CASA(conf-app-policy 1)# limit
replication override
CASA(conf-app-policy 1)# no limit
replication override
Casa Systems CMTS

policy
Properties
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:
CASA(conf-app-class 1)# max iptv

channel 0
monitor threshold Sets the optional monitor threshold to the minimum

min-rate-ratio <1:100> rate ratio, as a percentage of guaranteed rate defined
in the QoS.
Example:
CASA(conf-app-policy 12)# monitor

threshold min-rate-ratio 100
CASA(conf-app-policy 12)# no monitor
threshold min-rate-ratio
Casa Systems CMTS

policy
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.)
CASA(config) application policy 1234

CASA(conf-app-policy 1234) limit replication
CASA(conf-app-policy 1234) max iptv channel 2
CASA(conf-app-policy 1234) exit
CASA(conf-grp-config 1) source-address 0.0.0.0/0
CASA(conf-grp-config 1) group-address 230.0.1.0/24
CASA(conf-grp-config 1) exit
show application policy
Shows the application policies configured in the running configuration.
CASA(config)# show application policy
application policy 1
show multicast replication
Shows multicast replication, including DSG.
CASA(config)# show multicast replication

mcast-session repli-id type channel-list
Casa Systems CMTS

class-map
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
<name> Creates the required class map name. This puts you
in class-map configuration mode.
Example:
CASA(config)# class-map CLMAP1

CASA(config-class-map CLMAP)# exit
CASA(config)# no class-map CLMAP1
match access-group Matches an IP access list name.

<acl_name>
Example:
CASA(config-class-map CLMAP)# match

access-group ACL1
CASA(config-class-map CLMAP)#
no match access-group ACL1
Casa Systems CMTS

class-map
Properties
set-dscp <0:63> Sets the Differentiated Services Code Point (DSCP)

value for the class map.
Example:
CASA(config-class-map CLMAP)# set-dscp

62
CASA(config-class-map CLMAP)#
no set-dscp 62
show class-map [<name>]
Shows the class map in the running configuration. The name option shows the
properties set.
CASA(config)# show class-map CLMAP

class-map CLMAP
match access-group ACL1
set-dscp 62
Casa Systems CMTS

policy-map
policy-map
Purpose
The policy-map command creates a quality of service (QoS) policy. Up to eight

policy maps are supported.
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
<name> Creates the required policy map name. This takes

you into policy-map configuration mode.
Example:
CASA(config)# policy-map POLMAP1

CASA(config-policy-map POLMAP1)# exit
CASA(config)# no policy-map POLMAP1
class <name> Creates the required policy map class name. Up to

16 classes are supported per policy map.
Example:
CASA(config-policy-map POLMAP1)# class

CL1
CASA(config-policy-map POLMAP1)#
no class CL1
Casa Systems CMTS

policy-map
show policy-map
Shows the policy maps configured in the running configuration.
CASA(config)# show policy-map

policy-map POLMAP1
Casa Systems CMTS

15-1
QAM 8-channel configuration

The interface qam command configures a Quadrature Amplitude Modulation (QAM)
interface. QAM is the modulation scheme for digital cable and CMs for downstream
traffic and interfaces need to be configured for that traffic.
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.
Table 15-1 lists and briefly describes the objects related to the QAM 8x8 interface.
Table 15-1. QAM interface objects
interface qam Configures the QAM interface.
Casa Systems CMTS

interface qam
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>
Casa Systems CMTS

QAM 8x8 configuration 15-3
interface qam
Properties
<slot>/<port> Required slot and port number of the QAM interface.

The <slot> is the slot or module number and the
<port> is the port number, from 0 through 7. This
setting brings you into QAM configuration mode.
Example:

CASA(config-if-qam 0/0)#
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:
A Annex A describes an earlier European

cable modem system, for which a symbol rate
and channel spacing can be specified. The
symbol rate default is 6952 kilo-symbols per sec-
ond. For the DOCSIS channel, 6952 is the only
setting. The channel spacing default is 8000000
Hz (8 MHz).
B Annex B corresponds to DOCSIS/EuroDOC-
SIS 1.1 and has a channel spacing of 6 MHz. The
symbol rate and channel spacing are not options
for this annex type.
C Annex C describes a variant of DOCSIS 1.1
that is designed to operate in Japanese cable
systems and has a channel spacing of 6 MHz.
The symbol rate and channel spacing are not
options for this annex type.
Example:
CASA(config-if-qam 0/0)# annex A symbol

rate 6952 channel spacing 8000000
Casa Systems CMTS

interface qam
Properties
channel <0:7> Enables a QAM output channel. There are eight

[description <text>] possible output channels. An optional description of
the channel can be added, maximum 64 characters
and embedded in quotes if spaces are included.
Example:
CASA(config-if-qam 0/0)# channel 1

description QAM 0/0 channel 1
CASA(config-if-qam 0/0)# no channel 1
no channel 1 description
channel <0:7> dsg Configures DOCSIS Set-Top Gateway (DSG)

{channel-list properties for the QAM channel. One of the following
<1:4294967295> | modifiers is required (all have no forms available):
dcd-enable | interval
<2:10> | timer-id channel-list <id> Assigns a dsg chan-
<1:4294967295> | nel-list to a downstream channel, with the ID.
vendor-param-id dcd-enable Assigns a Downstream Channel
<1:4294967295>} Descriptor (DCD) ENABLE to a downstream
channel.
interval <ticks> Sets a downstream time inter-
val in ticks (100 milliseconds per tick).
timer-id <id> Assigns a dsg timer-id to the
channel.
vendor-param-id <id> Assigns a dsg ven-
dor-param-id to the downstream channel.
Example:
CASA(config-if-qam 0/0)# channel 1 dsg

channel-list 3
no channel 1 dsg channel-list
Casa Systems CMTS

interface qam
Properties
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:

frequency 555000000
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
Example:

interleave 128x8
Casa Systems CMTS

interface qam
Properties
channel <0:7> Assigns a provisioned attribute mask to the channel.

prov-attr-mask DOCSIS 3.0 provisioned attribute masks allow
{<0x0:0xffffffff> | assigning of service flows to channels or channel
bonding | bonding groups using binary attributes. These
highavailability | attributes are either user-defined or
lowlatency} specification-defined. There is no no form of the
command. At least one of the following values is
required:
<val> User-defined value, default 0x0.

bonding Upstream channel bonding attribute
mask, bit 0 for channel interfaces and bit 1 for
channel bonding groups.
highavailability High-availability provisioned
attribute mask, the bit set to 0 for all channels and
user-defined.
lowlatency Low-latency provisioned attribute
mask, the bit set to 0 for all channels and
user-defined.
Example:

prov-attr-mask 0x0
channel <0:7> Replicates the channel configuration to other

replicate-port specified ports (0 through 7) on the current QAM slot.
<ports_list> The ports in the list are separated by commas and
include hyphens to indicate ranges, such as 1,5-7 to
indicate ports 1, 5, 6, and 7. There is no no form of
the command.
Example:

replicate-port 1,5-7
Casa Systems CMTS

interface qam
Properties
channel <0:7> shutdown Shuts down the channel. Use the no form to restart.
Example:
channel <0:7> transport The channel transport stream ID is needed in Service

stream <0:65535> Information (SI) table generation. The SI table
contains four sub-tables: EIT (Event Information
Table), NIT (Network Information Table), SDT
(Service Description Table), and TDT (Time of Day
Table), each of which can be turned on or off
individually. The transport stream ID defaults to 0.
Example:

transport stream 500
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.
Example:
CASA(config-if-qam 0/0)# interleave

128x1
Casa Systems CMTS

interface qam
Properties
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
Example:
CASA(config-if-qam 0/0)# modulation

256qam
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.
The maximum output level per QAM channel is:
60 dBmV at 1-channel/port
56 dBmV at 2-channels/port
49 dBmv at 8-channels/port
Setting the QAM power level higher than 580 is not

recommended unless a measurement shows the
actual CMTS output is slightly lower than what is
requested in CLI, or a determination is made that the
cable plant is highly attenuated, and the only solution
is to force the CMTS to overdrive its output level (as
opposed to removing attenuation in the cable plant).
Example:
CASA(config-if-qam 0/0)# power 510
Casa Systems CMTS

interface qam
Properties
shared-channel <0:7> Assigns the shared channel ID to the QAM interface,

{annex {A [symbol rate with the following properties:
<1:6952>] [channel
spacing annex {A [symbol rate <1:6952>]
<6000000:8000000>] | B | [channel spacing <6000000:8000000>]
C} | frequency | B | C}
<47000000:999000000> | frequency <47000000:999000000>
interleave <level> |
modulation {128qam | interleave <level>
256qam | 64qam | off} | modulation {128qam | 256qam | 64qam |
shutdown | transport off}
stream <0:65535>}
shutdown
transport stream <0:65535>
Example:
CASA(config-if-qam 0/0)# shared-channel

1 frequency 549000000 transport stream
500
CASA(config-if-qam 0/0)# no
shared-channel 1 frequency 549000000
transport stream 500
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:
CASA(config-if-qam 0/0)# no shutdown
Casa Systems CMTS

interface qam
Properties
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:
CASA(config-if-qam 0/0)# spectral

inversion on
no spectral inversion on
spectrum-tilt <0:50> Sets the spectrum-tilt level to assign the power per
channel. There is no no form of the command.
Example:
CASA(config-if-qam 0/0)# spectrum-tilt

45
show interface qam
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.
CASA(config)# show interface qam
interface qam 0/0

annex B
modulation 256qam
interleave 128x1
power 510
channel 0 shutdown
Casa Systems CMTS

interface qam
show interface qam stat
Shows the QAM channel statistics.
CASA(config)# show interface qam stat

Interface qam 0/0 statistics
Admin Status: DOWN
Channel 0
TotalBytes:0
UsedBytes :0
Admin Status: DOWN
Last clearing of interface stat: never
Channel 1
TotalBytes:0
UsedBytes :0
Admin Status: DOWN
Shows any configured DSG channel lists.

show dsg qam
Shows the QAM interfaces configured with DSG.
CASA(config)# show dsg qam

interface qam 0/0
interface qam 0/1
Casa Systems CMTS

interface qam
Shows the DSG lines in the running-configuration.

dsg tunnel-group 1
channel 2 qam 0/1/0 rule-priority 1
dsg tunnel 1
group 1
dst-address 0010.5e00.1123
classifier 20 20 10.100.1.10/24 224.0.0.4
vendor-param-id 1
dsg vendor-param-id 1 vendor 1 oui 00:11:22 value 1
dsg timer-id 1 t1 1 t2 2 t3 3 t4 4
dsg server-redundancy enable
dsg unicast port : 8888
Casa Systems CMTS

16-1
QAM 96-channel configuration

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.
Table 16-1 lists and briefly describes the objects related to the QAM 8x96 interface.
Table 16-1. QAM 8x96 interface objects
interface qam Configures the QAM interface.

module Defines a module and configures narrowcast and shared
channels.
Casa Systems CMTS

QAM shared channel modes
QAM shared channel modes
Each shared channel must be in one of the two following modes:
Extra narrowcast channel mode

Multi-port shared channel mode
Extra narrowcast channel
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:
When the module <id> narrowcast-channels command is set to 48, all 96

channels are equally allocated to the eight RF ports, and there is no multiport
shared channel available.
When the module <id> narrowcast-channels command is set to 36, all 96 shared
channels are available for multiport shared channels. However, the number of
QAM channels on each RF port cannot exceed 128.
When the system is configured for Digital Video Broadcasting (DVB)
SimulCrypt, the number of shared channels is reduced to 64.
Multi-port shared channel
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.
Casa Systems CMTS

Configuring the narrowcast channels
Configuring the narrowcast channels

To configure shared channels in the extra narrowcast mode, use the module
command in the following format:
CASA(config)# [no] module <id> narrowcast-channels <32-48>
This command is described in the module command description. The command

sets the total number of narrowcast channels on the module RF downstream ports.
If the number of narrowcast-channels is more than 32 as specified with the
command, the system places a set of shared channels into the extra narrowcast
mode to meet the assigned number. The maximum value for narrowcast channels
is 48; this is also the default setting.
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
CASA(config)# show narrowcast-channels [module <id>]
Example
CASA(config)# show narrowcast-channels
module 4 narrowcast-channels 44
Configuring the shared channels

The shared-channel command places a shared channel into the multi-port shared
channel mode. Shared channels in the range 0 to 95 are enabled using an assigned
frequency. The shared channel frequency must be assigned first using the
following command format:
shared-channel <id> frequency <Hz> [1-32]
Casa Systems CMTS

Sharing channels over other QAM 8x96 ports
See the shared-channel <id> {annex {A [symbol rate <1:6952>]

[spectral-inversion] | B | C [spectral-inversion]} | frequency <0 |
47000000:999000000> | interleave <level> | modulation {128qam | 256qam |
64qam | off} | shutdown | transport stream <0:65535>} property of the interface
qam command for details. The optional range of 1 through 32 is the number of
channels to which the frequency applies using a single command.
Example
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.
Casa Systems CMTS

Figure 16-1. Sample QAM 8x96 shared channel mappings

Narrowcast channels
Multiport shared channels
Channel number
0 15 16 31 43
Port 0 DOCSIS VOD SDV0
Shared channel IDs
0 to 11; channels 32 to 43
1 DOCSIS VOD SDV0
2 DOCSIS VOD SDV1

Shared channel IDs
3 DOCSIS VOD SDV1
4 DOCSIS VOD SDV2 Shared channel IDs

5 DOCSIS VOD SDV2
6 DOCSIS VOD SDV3 Shared channel IDs

7 DOCSIS VOD SDV3
The following CLI session configures the shared channels on port 0 and shares them
with port 1 using the following steps:
1. Configure the number of narrowcast channels on module 0 and module 1.

2. Configure the shared channel identifier on the first module and number of
channels to be shared, then configure the second and any subsequent ports using
the same shared channel identifier.
3. Execute the show module <slot> shared-channel mapping command to verify
the configuration.
4. Add multi-port shared channels to the video QAM domain and QAM group. The
qam group command in the video qam domain configuration supports the range
of narrowcast and multi-port shared channels.
qam-group <group-id> shared-channel <first_schannel>
<last_schannel>
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.
Casa Systems CMTS

5. Run the show docsis channel utilization command to display multi-port shared
channel statistics.
Example


CASA(config-if-qam 0/0)# shared-channel 0 frequency 72300000 12
CASA(config-if-qam 0/0)# no shared-channel 0 shutdown 12

CASA(config-if-qam 0/1)# shared-channel 0 frequency 72300000 12
CASA(config-if-qam 0/1)# no shared-channel 0 shutdown 12
CASA(config)# show module 0 shared-channel mapping

PORT CHAN SH_CH FREQ(MHz) BINDP BINDC REPL-P P_MASK BLK_OFF STATUS
*****12 multiport shared-channels on QAM 0/0*****

*****12 multiport shared-channels on QAM 0/1*****
CASA(config)# video qam domain 1

CASA(conf-qam-domain 1)# qam-group 2 shared-channel 0/0 0/11
C10G-181(conf-qam-domain 2)# show video qam-domain

video qam-domain 1
edis 1
video service group 1
interface video 6
qam-group 1 0/0/16 0/0/31
qam-group 2 shared-channel 0/0 0/11 <<<<==== 12 multiport
shared-channels added to
video qam-domain.
CADA (config-if-qam 0/1)# show docsis channel utilization

Downstream Total-BW Utilization Online Secondary
Slot/Port/Channel (Mb/Sec) Percentage Modems Modems
Channel
Description
----------------------------------------------------------------------
<<<<==== Utilization on 12 multiport shared-channels
0/0 (723000000 Hz) 42.9 49 0 0 (shared)

0/1 (729000000 Hz) 42.9 49 0 0 (shared)
Casa Systems CMTS

QAM 8x96 channel frequency range
0/2 (735000000 Hz) 42.9 49 0 0 (shared)

0/3 (741000000 Hz) 42.9 49 0 0 (shared)
0/4 (747000000 Hz) 42.9 49 0 0 (shared)
0/5 (753000000 Hz) 42.9 49 0 0 (shared)
0/6 (759000000 Hz) 42.9 49 0 0 (shared)
0/7 (765000000 Hz) 42.9 49 0 0 (shared)
0/8 (771000000 Hz) 42.9 49 0 0 (shared)
0/9 (777000000 Hz) 42.9 49 0 0 (shared)
0/10 (783000000 Hz) 42.9 49 0 0 (shared)
0/11 (789000000 Hz) 42.9 49 0 0 (shared)

As in earlier Release 6.4 implementations, the configuration maintains four RF
blocks. Each block covers 192 MHz width, with the four blocks covering the 768
MHz frequency range. The frequency range may not be continuous, and frequency
gaps may exist between blocks.
In Annex B or C mode at the 6 MHz channel width, the maximum number of

channels on a single block is 32. The maximum number Annex B or C channels
on each physical port is 128 RF channels (4 blocks x 32 channels). See
Figure 16-2.
In Annex A mode, at the 8 MHz channel width, the maximum number of channels
on a single block is 24. The maximum number of Annex A channels on each
physical port is 96 RF channels (4 blocks x 24 channels). See Figure 16-3.
Figure 16-2. QAM 8x96 channel time line frequency blocks (Annex B, C; 128 ch.)
Dynamic system-assigned default frequencies
99000000 291000000 483000000 675000000
192 MHz 192 MHz 192 MHz 192 MHz
block 0 block 1 block 2 block3
32 channels 32 channels 32 channels 32 channels
47 MHz 768 MHz 1 GHz

QAM 8x96 (Annex B/Annex C, 128 channels)
Casa Systems CMTS

Figure 16-3. QAM 8x96 channel time line frequency blocks (Annex A; 96 ch.)
Dynamic system-assigned default frequencies
99000000 291000000 483000000 675000000
192 MHz 192 MHz 192 MHz 192 MHz
block 0 block 1 block 2 block3
24 channels 24 channels 24 channels 24 channels
47 MHz 768 MHz 1 GHz

QAM 8x96 (Annex A, 96 channels)
Example
C10G-181(config-if-qam 0/0)# show interface qam 0/0 block
interface qam 0/0:
block 0 frequency 93000000 map ffffffff

channel 0 freq 93000000 blk 0 off 0 intlv 32 status up
Casa Systems CMTS


block 1 frequency 291000000 map 00000000
block 2 frequency 483000000 map 00000000
block 3 frequency 675000000 map 000fff00
<<<<==== 12 multiport shared-channels added

shared-channel 0 freq 723000000 blk 3 off 8 intlv 12801 status 01
ch 32
ch 33
ch 34
ch 35
ch 36
ch 37
ch 38
ch 39
ch 40
ch 41
ch 42
ch 43
block_map: 000fff00 00000000 00000000 ffffffff
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
Casa Systems CMTS

shutdown channels:
PORT 0: annex 1 mod 4 intlv (12801, 32) nd 32 nu 32 ns 96 status up
FPGA_A: annex 1 mod 4 intlv (12801, 32) pmap 0x00 nd 32 nu 32 ns 96

status up
FPGA_B: annex 1 mod 4 intlv (12801, 12801) pmap 0x00 nd 32 nu 32 ns 96
status up
Casa Systems CMTS

interface qam
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 |
[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]
Casa Systems CMTS

interface qam
[no] shared-channel <id> {annex {A [symbol rate <1:6952>]

[spectral-inversion] | B | C [spectral-inversion]} |
frequency <0 | 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
<slot>/<port> Required slot and port number of the QAM interface.

The <slot> is the slot or module number and the
<port> is the port number, from 0 through 7. This
setting brings you into QAM configuration mode.
Example:

Casa Systems CMTS

interface qam
Properties
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:
A Annex A describes an earlier European

cable modem system. Spectral inversion can be
applied.
B Annex B corresponds to DOCSIS/EuroDOC-
SIS 1.1 and has a channel spacing of 6 MHz. No
symbol rate or channel spacing needs to be spec-
ified.
C Annex C describes a variant of DOCSIS 1.1
that is designed to operate in Japanese cable
systems and has a channel spacing of 6 MHz. No
symbol rate or channel spacing needs to be spec-
ified. Spectral inversion can be applied.
Example:
CASA(config-if-qam 0/0)# annex A

spectral-inversion
channel <num> Enables the channel and adds an optional

[description <text>] description, maximum 64 characters and embedded
in quotes if spaces are included.
Example:

description QAM 0/0 channel 1
no channel 1 description
Casa Systems CMTS

interface qam
Properties
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.
Example:

annex A symbol rate 6952
spectral-inversion
Casa Systems CMTS

interface qam
Properties
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:
CASA(config-if-qam 0/0)# channel 1 dsg

channel-list 3
no channel 1 dsg channel-list
Casa Systems CMTS

interface qam
Properties
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:

frequency 549000000
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:

interleave 128x8
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.
Example:

modulation 256qam
Casa Systems CMTS

interface qam
Properties
channel <num> Sets the attenuation value in tenths of a dB, default 0.

power-attenuation There is no no form of the command.
<0:100>
Example:

power-attenuation 20
channel <num> Provisioned attribute mask for the channel. DOCSIS

prov-attr-mask 3.0 provisioned attribute masks allow assigning of
{<0x0:0xFFFFFFFF> | service flows to channels or channel bonding groups
bonding | using binary attributes. There is no no form of the
highavailability | command. These attributes are either user-defined or
lowlatency} specification-defined. At least one of the following
values is required:

user-defined.
user-defined.
Example:

prov-attr-mask 0x0
Casa Systems CMTS

interface qam
Properties
channel <num> Replicates the channel configuration to other

replicate-port specified ports on the current QAM slot. The ports in
<ports_list> [<1:36>] the list are separated by commas and include
hyphens to indicate ranges, such as 1,5-7 to indicate
ports 1, 5, 6, and 7. The optional number of channels
value applies to QAM 8x96 boards only. The number
of channels to replicate times half the number of
ports to replicate to should not exceed 16 (such that
replicating 16 channels to three ports is not valid).
Example:

replicate-port 1,5-7
no channel 1 replicate-port 1,5-7
channel <num> shutdown Shuts down the channel. The optional number of
[<1:36>] channels designation applies to QAM 8x96 boards
only.
Example:

shutdown 36
channel <num> transport The channel transport stream ID is needed in Service

stream id <0:65535> Information (SI) table generation. The SI table
contains four sub-tables: EIT (Event Information
Table), NIT (Network Information Table), SDT
(Service Description Table), and TDT (Time of Day
Table), each of which can be turned on or off
individually.
Example:

transport stream id 500
no channel 1 transport stream id
Casa Systems CMTS

interface qam
Properties
interface qam <slot>/ Opens another QAM interface. There is no no form of

<port> the command.
Example:
CASA(config-if-qam 0/0)# interface qam

2/1
interleave <level> 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 <num> 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:
CASA(config-if-qam 0/0)# interleave

128x1
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:
CASA(config-if-qam 0/0)# modulation

256qam
Casa Systems CMTS

interface qam
Properties
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
The maximum output level per QAM channel is:
60 dBmV at 1-channel/port
49 dBmv at 8-channels/port
Setting the QAM power level higher than 580 is not

recommended unless a measurement shows the
actual CMTS output is slightly lower than what is
requested in CLI, or a determination is made that the
cable plant is highly attenuated, and the only solution
is to force the CMTS to overdrive its output level (as
opposed to removing attenuation in the cable plant).
Example:
CASA(config-if-qam 0/0)# power 510
Casa Systems CMTS

interface qam
Properties
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:
CASA(config-if-qam 0/0)# shared-channel

1 frequency 549000000
no shared-channel 1 shutdown
no shared-channel 1
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
Example:
CASA(config-if-qam 0/0)# shutdown

CASA(config-if-qam 0/0)# no shutdown
Casa Systems CMTS

interface qam
Properties
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:
CASA(config-if-qam 0/0)# spectral

inversion on
spectrum-tilt <0:50> Spectrum tilt adjusts each channels power based on

the channels position in the frequency spectrum. At
the higher end of the frequency, the channels power
increases and a channel with a higher frequency
gains more power with the increased tilt. At the
default value of 0, all channels have the same power
level. The power difference between the highest
frequency channel and lowest frequency channel
cannot be greater than 10 dB. There is no no form of
the command.
Example:
CASA(config-if-qam 0/0)# spectrum-tilt

45
Casa Systems CMTS

interface qam
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:
country-code <3_char_code> region-id <0:60>

dst begin month <1:12> week <|1:5> time <0:3>
dst end month <1:12> week <|1:5> time <0:3>
offset-hours <12:+13> offset-minutes <0 | 30 | 45>
CASA(config)# si generator tot country-code cet region-id 0

CASA(config)# si generator tot dst begin month 4 week 1 time 2
CASA(config)# si generator tot dst end month 10 week 5 time 2
CASA(config)# si generator tot offset-hours 5 offset-minutes 30
CASA(config)# no si generator tot
CASA(config)# no si generator tot dst
show interface qam
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.
CASA(config)# show interface qam
interface qam 0/0

annex B
modulation 256qam
interleave 128x1
power 510
channel 0 shutdown
channel 1 shutdown

Casa Systems CMTS

interface qam
show interface qam stat
Shows the QAM channel statistics.
CASA(config)# show interface qam stat

Interface qam 0/0 statistics
Admin Status: DOWN
Channel 0
TotalBytes:0
UsedBytes :0
Admin Status: DOWN
Channel 1
TotalBytes:0
UsedBytes :0
Admin Status: DOWN
show interface qam <slot>/<port> power
Shows the QAM channel power settings per specified port.
CASA(config)# show interface qam 0/0 power
Configured Total Power: 550

Calculated Per-Channel Power: 382
Send to FPGA Power: 550
Spectrum-tilt: 0
CHAN_ID FREQUENCY ATTNU B_POWER TILT T_POWER

0 474000000 0 382 0 382
1 482000000 0 382 0 382
2 490000000 0 382 0 382
3 498000000 0 382 0 382
4 506000000 0 382 0 382
5 514000000 0 382 0 382
6 522000000 0 382 0 382
7 530000000 0 382 0 382
8 538000000 0 382 0 382
9 546000000 0 382 0 382
10 554000000 0 382 0 382

Casa Systems CMTS

interface qam
Shows any configured DSG channel lists.

show dsg qam
Shows the QAM interfaces configured with DSG.
CASA(config)# show dsg qam

interface qam 0/0
interface qam 0/1
Shows the DSG lines in the running-configuration.

dsg tunnel-group 1
channel 2 qam 0/1/0 rule-priority 1
dsg tunnel 1
group 1
dst-address 0010.5e00.1123
classifier 20 20 10.100.1.10/24 224.0.0.4
vendor-param-id 1
dsg vendor-param-id 1 vendor 1 oui 00:11:22 value 1
dsg timer-id 1 t1 1 t2 2 t3 3 t4 4
dsg server-redundancy enable
dsg unicast port : 8888
Casa Systems CMTS

module
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.
The module <id> narrowcast-channels command sets the total number of

narrowcast channels on the module RF downstream ports. If the number of narrowcast
channels is more than 32, as per the command, the system places a set of shared
channels into extra narrowcast mode to meet the assigned number.
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
<id> Module ID.

narrowcast-channels Number of narrowcast channels, in the range 32
{<32:44> | <36:48>} through 44, or 36 through 48, default 44.
Example:
CASA(config)# module 0
narrowcast-channels 48
CASA(config)#
no module 0 narrowcast-channels
Casa Systems CMTS

module
show narrowcast-channels
Shows the narrowcast channel configuration.

Casa Systems CMTS

17-1
Chapter 17. Quality of service
QoS commands description

The Casa CMTS supports quality of services (QoS) as defined by the DOCSIS 1.0, 1.1
specifications. Service classes can be configured to 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. (See the cable service-class
command for service class definitions and also Chapter 14, Policy commands.)
QoS support in DQM modules
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.
Casa Systems CMTS

The packet scheduler is driven by availability of transmission opportunities on the

downstream channel. The scheduler can provide millisecond level latency guarantees
for high priority traffic through the use of shallow transmit queues. Every time a
channel transmit queue becomes available, the scheduler services the service flows in
the order of priority until the transmit queue is full or all eligible packets are serviced.
For downstream channel bonding operation, the service flow is serviced by each of the
channels in the bonding channel set in parallel.
QoS support in DCU modules
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.
Jitter-sensitive service flows are scheduled by the real-time scheduler. To provide

jitter guarantees, the transmission opportunities are pre-allocated when the service
flow is admitted to prevent overlap. At MAP generation time, the real time scheduler
aggregates jitter-sensitive grants into clusters. The best effort grants are then placed
into the gaps between the real time grant clusters. If the gap is not big enough, the
cluster is allowed to move to increase the gap, as long as jitter guarantees can be met
for the real time grants in the cluster. If the gap is still not enough to place the best
effort grant, the best effort grant is then fragmented. The scheduler keeps track of the
remainder of the fragments and continues to serve the fragments until the request is
fulfilled.
Casa Systems CMTS

Quality of service 17-3
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.
QoS support in switch fabric and Gigabit Ethernet interfaces
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.
Table 17-1 lists and briefly describes the objects related to QoS.
Table 17-1. QoS objects
cable qos Configures the cable QoS. (See Chapter 3, Cable

commands.)
cable service-class Configures the cable service class. (See Chapter 3, Cable
commands.)
cops pdp-ip Sets the address of the Policy Decision Point (PDP) for the
Common Open Policy Service (COPS).
qos-profile Configures a QoS profile.
Casa Systems CMTS

cops pdp-ip
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
<ip_addr> IP address of the Policy Decision Point (PDP), in

A.B.C.D format.
Example:
CASA(config)# cops pdp-ip 192.168.8.8

CASA(config)# no cops pdp-ip
CASA(config)#
no cops pdp-ip 192.168.8.8
Casa Systems CMTS

qos-profile
qos-profile
Purpose
The qos-profile command creates a QoS profile with upstream and downstream
bandwidth settings.
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
<1:10000> Profile index.

<0:7> Priority setting.
<0:100000000> Maximum upstream bandwidth.
<0:100000000> Guaranteed upstream bandwidth.
<0:100000000> Maximum downstream bandwidth.
{true|false} Determines if the Baseline Privacy Interface (BPI) is
used, true or false.
<0:65535> Maximum transmit burst, in bytes.
Example:
CASA(config)# qos-profile 1 7 10000000

100000000 100000000 true 65535
CASA(config)# no qos-profile 1
Casa Systems CMTS

cable qos
The cable qos command sets QoS options for the CM.
CASA(config)# cable qos class ds 7 weight 100
multicast group config

qos-id
The qos-id <0:65535> property of the multicast group config <1:4294967295>

command configures the QoS for the replication of the sessions matching the group
configuration.

multicast group qos
The multicast group qos <1:65535> <class_name> {aggregate max-sess <1:65535> |

single} [app-id <1:32>} command configures the QoS for a multicast group.
Casa Systems CMTS

show qos-profile
Shows the QOS profile configuration.
CASA(config)# show qos-profile

index = 10
show cable modem qos
Shows the cable modem QoS configuration.
CASA(config)# show cable modem qos

Sfid Dir Curr Sid Sched Prio MaxSusRate MaxBrst MinRsvRate
State Type (kbps) (kbps)
PeakTrafRate Throughput ServiceClassName
(kbps)) (kbps)
Mac Addr : 0026.24a8.db36
16385 US act 1 BE 0 0 24480 0
0 0
245 DS act N/A UNDEF 0 0 24480 0
0 0
Casa Systems CMTS

18-1
Chapter 18. Spectrum management
Spectrum management commands description

Casa Spectrum Management (CSM) allows the Casa CMTS to monitor the quality of
upstream paths and automatically perform correcting 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.
Some considerations when using CSM include the following:
1. A spectrum map is a collection of frequency ranges where a target frequency can

be selected when performing frequency hopping for an upstream channel. It is
dynamic (calculated when it is used) and upstream-interface-specific. It is
calculated based on two factors. First, frequency ranges specified in a given
spectrum rule. Second, by current frequencies used by other upstream channels in
the same service group. You can give a large frequency range and let CSM take
care of it without concerns about frequency overlapping.
2. A discrete frequency in a spectrum rule can be viewed as a frequency band with a
given center frequency and current channel width.
3. There is no frequency hopping back when a channel's impairments disappear;
only modulation and channel width.
4. A meaningful order of modulation profiles specified for dynamic modulation
profile change is the order of bandwidth efficiency (or reliability), most efficient
first and most reliable last.
Casa Systems CMTS

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.
Casa Systems CMTS

Spectrum management 18-3
Frequency hop case study
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:
CASA(config)# show spectrum-map upstream 8/1

Spectrum Map for interface 8/1/0
band 0: [28000000, 32800000]
band 1: [36000000, 38400000]
band 2: [41600000, 42000000]
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:
CASA(config-if-ups 8/1)# show spectrum-map upstream 8/1

Spectrum Map for interface 8/1/0
band 0: [26000000, 32800000]
band 1: [36000000, 38400000]
band 2: [41600000, 42000000]
When the CSM poll reaches a threshold, the channel hops to freq 27.6 MHz, as
indicated by the following debug message:
[Wed Dec 2 21:26:18 2009]-DE-CSM-FSM-1: H -> R on 8/1/0.. freq hop

30000000 to 27600000
Casa Systems CMTS

CSM configuration examples
Example 1: Modulation and channel width

spectrum rule 1
action modulation channel-width
correctable-fec threshold 3
uncorrectable-fec threshold 1
profile 3 snr-threshold 280

spectrum-rule 1

logical-channel 0 profile 3 secondary-profile 12,22,30,33
Example 2: Frequency, channel width, and modulation

spectrum rule 20
frequency 60000000
action frequency channel-width modulation
interface upstream 2/0.0

spectrum-rule 20

logical-channel 0 profile 10 secondary-profile 20
Example 3: CM mode spectrum rule applied on a logical channel

spectrum rule 2
cm-mode
cm-mode tolerance-count 15
cm-mode backhop-count 5
action channel-width

logical-channel 0 spectrum-rule 2
logical-channel 0 profile 3
logical-channel 0 channel-width 3200000
Casa Systems CMTS

Table 18-1 lists and briefly describes the objects related to spectrum management.
Table 18-1. Spectrum management objects
channel-utilization-interval Sets the interval over which the channel utilization

information is collected and averaged.
hop period Sets the time period between two consecutive
frequency hops.
spectrum Configures spectrum management
spectrum analysis Configures spectrum analysis.
spectrum rule Configures spectrum rules.
spectrum scheduler Configures the spectrum scheduler.
test cable hop upstream Tests cable upstream hops.
test cable hop-cm-mode Tests cable upstream hops for a CM mode
upstream spectrum rule.
Casa Systems CMTS

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
Mode
(config)#
Syntax
channel-utilization-interval <0:86400>
Properties
<0:86400> Channel utilization interval, default 30 seconds.

Setting this value to 0 turns off utilization collection. It
is not advisable to use a value lower than 10 in an
operational system.
Example:
CASA(config)#
show channel-utilization-interval
Shows the channel utilization interval.
CASA(config)# show channel-utilization-interval

channel utilization interval = 5 s
Casa Systems CMTS

hop period
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.)
Mode
(config)#
Syntax
hop period <5:3600>
Properties
<5:3600> Hop period, default 30 seconds.
Example:
CASA(config)# hop-period 30
show cm-hop log
Shows the CM frequency hop history for the CM addresses.
CASA(config)# show cm-hop log

Mac address Time Upstream CFEC UFEC SNR
-----------------------------------------------------------------
total: 0;
Casa Systems CMTS

hop period
show spectrum hop-history [upstream <slot>/<port>.<chan>[/<lchan>]]
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).
CASA(config)# show spectrum hop-history upstream 10/0.3/1

Port Action Time Code From To Reason
10/0.3/1 Tue Mar 25 19:54:16 2014 C 800000 1600000 CM 7 (15-3)
10/0.3/1 Tue Mar 25 19:47:31 2014 C 1600000 800000 CM 16 (15)
show spectrum hop-stats service-group <name>
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.
CASA(config)# show spectrum hop-stats service-group 2

10/8.1/0: hop counts: M 2 C 0 F 0, monitored: 0d 0h 11m
MODULATION(%): PREVIOUS CURRENT
qpsk 16qam 8qam 32qam 64qam 128qam 64qam
0 6 0 0 31 0 62
CHAN-WIDTH(%): PREVIOUS CURRENT
200k 400k 800k 1.6m 3.2m 6.4m 3200000
0 0 0 0 0 0 100
10/8.1/1:
10/8.2/0: hop counts: M 12 C 0 F 0, monitored: 0d 0h 11m
MODULATION(%): PREVIOUS CURRENT
qpsk 16qam 8qam 32qam 64qam 128qam 16qam
25 31 37 0 0 0 5
CHAN-WIDTH(%): PREVIOUS CURRENT
200k 400k 800k 1.6m 3.2m 6.4m 3200000
0 0 0 0 0 0 100
Casa Systems CMTS

spectrum
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)#
Casa Systems CMTS

spectrum analysis
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.
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
full-spectrum With the analysis property, the Casa CMTS displays

full-spectrum data in the same MIB entry and same
format, which, in turn, can be used for the same
purpose. Note that this property alway displays
40960000, which is the center frequency of the full
spectrum.
Example:
CASA(config)# spectrum analysis

full-spectrum
CASA(config)#
no spectrum analysis full-spectrum
Casa Systems CMTS

spectrum analysis
Properties
measurement-interval <5:30> Seconds to allow for spectrum analysis, default

15 seconds. There is no no form of this command.
Example:
CASA(config)# spectrum analysis

measurement-interval 10
show spectrum impair-flag
Shows the currently impaired upstream spectrum.
CASA(config)# show spectrum impair-flag

Port channels
2/ 0: 0 0 0 0 0 0 0 0
2/ 1: 0 0 0 0 0 0 0 0
2/ 2: 0 0 0 0 0 0 0 0
2/ 3: 0 0 0 0 0 0 0 0
2/ 4: 0 0 0 0 0 0 0 0

show spectrum snr-threshold-default
Shows the spectrum signal-to-noise ratio (SNR) threshold defaults.
CASA(config)# show spectrum snr-threshold-default

Default SNR threshold per modulation type (tenth dB):
QPSK: 130
8QAM: 190
16QAM: 220
32QAM: 250
64QAM: 280
128QAM: 310
Casa Systems CMTS

spectrum analysis
show spectrum upstream <slot>/<port> [channel-width <freq>] [raw]
Shows an upstream interfaces spectrum noise level results in dBmV at a channel

width of 3200000. The channel-width option allows you to set the channel width
frequency at 0.4, 0.8, 1.6, 3.2, or 6.4 MHz, with the raw modifier showing the results
in dB instead of dBmV.
CASA(config)# show spectrum upstream 13/0

Frequency NOISE-LEVEL at channel-width 3200000

(dBmV)
5000000: -42.1 8200000: -42.1
11400000: -42.1 14600000: -42.1
17800000: -42.1 21000000: -42.1
24200000: -42.1 27400000: -42.1
30600000: -42.1 33800000: -42.1
37000000: -42.1 40200000: -42.1
43400000: -42.1 46600000: -42.1
49800000: -42.1 53000000: -42.1
56200000: -42.1 59400000: -42.1
62600000: -42.1

show spectrum-map upstream <slot>/<port>[.<chan>]
Shows an upstream interfaces spectrum map. The spectrum map is a collection of

possible frequency slots for the frequency hopping operation to target. The map is
dynamic for each upstream channel. It depends on the frequency ranges defined in the
rule and the current frequency used by other channels in the same service group.
CASA(config)# show spectrum-map upstream 13/2

Spectrum Map for interface 13/2.0
band 0: [5000000, 18400000]
band 1: [21600000, 40000000]

band 0: [5000000, 18400000]
band 1: [21600000, 40000000]

band 0: [5000000, 18400000]
band 1: [21600000, 40000000]
Casa Systems CMTS

spectrum analysis

band 0: [5000000, 18400000]
band 1: [21600000, 40000000]
show spectrum-meas upstream <slot>/<port>.<chan>
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.
CASA(config)# show spectrum-meas upstream 1/0.0

1/0 (0) Spectrum MEAS data (in Hz):
chan cnter freq: 40960000
frequency span: 81920000
number of bins: 1024
resolution bw: 80000
bin spacing: 80000
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
Casa Systems CMTS

spectrum rule
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:
An FFT mode rule applied on a physical channel functions on logical channel 0.

An FFT mode rule cannot be applied specifically on logical channel 0.
An FFT mode rule applied specifically on logical channel 1 functions on that
logical channel, but does not allow for frequency hops, because the frequency is
shared between the two logical channels.
A CM mode rule must be applied on a logical channel only.
If both a physical and logical channel of an interface have a rule applied, the
logical channel rule takes effect.
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.
Casa Systems CMTS

spectrum rule
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] 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>
Casa Systems CMTS

spectrum rule
Properties
<1:64> Configures a spectrum rule to apply to a service flow

over an upstream channel. Configuring the rule puts
the command context in rule configuration mode.
Note: Frequency hopping occurs only if a

frequency band is specified in a spectrum
rule. A modulation profile change occurs
only if a secondary profile is defined in the
upstream channel. A channel-width
adjustment occurs only if a channel width
range is specified.
Example:
CASA(config)# spectrum rule 1

CASA(conf-rule 1)# exit
CASA(config)# no spectrum rule 1
action {channel-width | Specifies the order of effort of trying corrective

frequency | modulation | actions for FFT mode, or only one action for CM
scheduler <1:16>} mode. There is no default action or default order of
actions. The action has to be explicitly specified in
the action command. The following frequency
hopping priorities are set by the order they appear on
the command line (for FFT mode):
channel-width
frequency (FFT mode only)
modulation
A modulation action requires a secondary profile for

the logical channel in the interface upstream
definition. The spectrum scheduler ID can also be
specified separately for rule scheduling. There is no
no form of this command.
Example:
CASA(conf-rule 1)# action frequency

modulation channel-width
Casa Systems CMTS

spectrum rule
Properties
back-hop-limit <1:16> Configures the maximum number of past spectrum

<1:144> [channel-width | hop conditions to evaluate, and specifies the
modulation] maximum number of hours over which back-hopping
will take place. The optional modifiers determine if
the conditions are based on channel width or
modulation. In the example, a maximum of three
spectrum back-hops can take place over a 5-hour
period, based on channel width. CSM checks the last
three conditions that forced a spectrum hop before
initiating a new spectrum hop back to a previous
state. If the current condition does not represent an
improved spectrum hop, then no action is taken.
Example:
CASA(conf-rule 1)# back-hop-limit 3 5

channel-width
CASA(conf-rule 1)# no back-hop-limit
channel-width <high> Sets the required channel width adjustment range,

<low> with a high width followed by a low width. The high
width is in the Hertz interval 400000, 800000,
1600000, 3200000, or 6400000. The low width is in
the Hertz interval 200000, 400000, 800000, 1600000,
or 3200000, and should be less than or equal to the
high width. If the specified high width is larger than
the current effective width, the channel-width change
starts from the high width. Otherwise, the change
starts from the current effective width.
Example:
CASA(conf-rule 1)# channel-width

3200000 1600000
CASA(conf-rule 1)# no channel-width
Casa Systems CMTS

spectrum rule
Properties
cm-hop Enables CM hopping. When multiple logical channels

are configured with different modulation profiles in an
upstream physical channel and a cm-hop command
is issued, a cable modem can be moved among the
channels based on specified thresholds. If the
thresholds specified are exceeded for the cable
modem, it will move to the next (more reliable) logical
channel.
Example:
CASA(conf-rule 1)# cm-hop

CASA(conf-rule 1)# no cm-hop
Casa Systems CMTS

spectrum rule
Properties
cm-mode [backhop-count Enables CM mode instead of Fast Fourier Transform

<3:10> | backhop-delay (FFT) mode and sets the CM parameters:
<1:100> |
tolerance-count <1:100> <cr> Enables CM mode, required for setting
the following parameters.
backhop-count <3:10> Causes a backhop
(roll-back of a spectrum rule action) to occur
when conditions improve if the polled number of
CMs with a lower-than-threshold SNR is less than
the tolerance-count minus this value, default 3.
backhop-delay <1:100> Minimum waiting
time in polling cycles to delay a backhop
(roll-back of a spectrum rule action), default 1
polling cycle (default 45 seconds). Adjust the poll-
ing cycle using the cable spectrum
cm-mode-monitor-period command.
tolerance-count <1:100> Maximum number
of tolerated CMs on the upstream channel that
are detected with lower-than-threshold SNR
during a polling, default 15 CMs. A higher number
can trigger the specified spectrum rule action.
Example:
CASA(conf-rule 1)# cm-mode

CASA(conf-rule 1)# cm-mode
backhop-count 3
CASA(conf-rule 1)# no cm-mode
correctable-fec Only correctable FEC and uncorrectable FEC are

threshold <0:100> possible triggers to start a corrective action. The
correctable FEC threshold is set as a percentage,
default 3%. There is no no form of this command.
Example:
CASA(conf-rule 1)# correctable-fec

threshold 5
description <text> Adds a description for the spectrum rule, maximum

64 characters in a quoted string.
Casa Systems CMTS

spectrum rule
Properties
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:
CASA(conf-rule 1)# frequency 34000000

CASA(conf-rule 1)#
no frequency 34000000
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:
CASA(conf-rule 1)# frequency band

14000000 20000000
CASA(conf-rule 1)# no frequency band
14000000 20000000
profile <1:1024> Applies a modulation-profile signal-to-noise ratio

snr-threshold <.1dB> (SNR) threshold, in tenths of a dB. To prevent SNR
[<.1dB>] from triggering a possible corrective action for a
particular modulation profile, do not specify the SNR
threshold for the modulation profile or set it to 0. The
optional additional number is the hop-back SNR
threshold.
CSM has a built-in default SNR threshold for each

modulation type and for each modulation profile. See
the show spectrum snr-threshold-default
command in the Related show commands.
Example:
CASA(conf-rule 1)# profile 3

snr-threshold 0
CASA(conf-rule 1)# no profile 3
Casa Systems CMTS

spectrum rule
Properties
uncorrectable-fec Only correctable FEC and uncorrectable FEC are

threshold <0:30> possible triggers to start a corrective action. The
uncorrectable FEC threshold is set as a percentage,
default 1%. There is no no form of the command.
Example:
CASA(conf-rule 1)# uncorrectable-fec

threshold 0
interface upstream
spectrum-rule
The spectrum-rule property of the interface upstream command applies a spectrum

rule to the upstream interface.
CASA(config)# interface upstream 10/0.0

CASA(conf-service-class 1)# spectrum-rule 1
interface qam
spectral inversion on
The spectral inversion on property of the interface qam command turns on spectral
inversion for the QAM interface

CASA(config-if-qam 0/0)# spectral inversion on
Casa Systems CMTS

spectrum rule
show spectrum rule [<id> | brief]
Shows the cable spectrum settings and spectrum rules, including any CM mode
settings. Filtering can be by rule ID or more brief output.
CASA(config)# show spectrum rule

cable spectrum hop period 30
cable spectrum monitor-period 10
cable spectrum cm-mode-monitor-period 10
spectrum analysis full-spectrum
spectrum rule 1
cm-hop
spectrum rule 35
cm-mode
cm-mode tolerance-count 15
cm-mode backhop-count 3
cm-mode backhop-delay 1
show spectrum snr-threshold-default
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.
CASA# show spectrum snr-threshold-default

Default SNR threshold per modulation type (tenth dB):
Modulation Conservative Aggressive
QPSK: 130 100
8QAM: 190 160
16QAM: 220 190
32QAM: 250 220
64QAM: 280 250
128QAM: 310 290
Casa Systems CMTS

spectrum scheduler
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)#
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
<1:16> Scheduler ID. Configuring the rule scheduler puts the

command context in scheduler configuration mode.
Example:
CASA(conf)# spectrum scheduler 1

CASA(conf-sched 1)# exit
CASA(conf)# no spectrum scheduler 1
Casa Systems CMTS

spectrum scheduler
Properties
description <text> Adds a description for the spectrum scheduler,

maximum 64 characters in a quoted string.
time-action <1:8> Determines the time-action for the scheduler, which
{always | {{mon | tue | takes a priority value, meaning that multiple
wed | thu | fri | sat | time-action statements can be made, up to eight.
sun} <hh:mm>} {mon | tue When enabled, the spectrum rule is in effect to the
| wed | thu | fri | sat | applied channels over the scheduled time period.
sun} <hh:mm>}} {channel When disabled, the rule is not in effect over the
width | frequency | specified time periods, but the rule is enabled during
modulation} 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.
The action is always, or a start and end day-of-week
(in a 3-character code plus hour and minutes, for
each). The final modifiers indicate if the action should
be based on channel width, frequency, or
modulation, or they can be combined.
Example:
CASA(conf-sched 1)# time-action 1 mon

08:00 fri 20:00 frequency
CASA(conf-sched 1)# time-action 2
always frequency modulation chan-width
CASA(conf-rule 1)# action scheduler 1
CASA(conf)# spectrum scheduler 1
CASA(conf-sched 1)# no time-action 1
show spectrum scheduler
Shows the spectrum scheduler setup.
CASA(config)# show spectrum scheduler

spectrum scheduler 1
time-action 1 mon 08:00 fri 20:00 frequency
Casa Systems CMTS

test cable hop upstream
test cable hop upstream

Purpose
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
Mode
(diag)#
Syntax
test cable hop upstream <slot>/<port>.<chan>/<lchan>
Properties
<slot>/<port>.<chan>/ Upstream interface identifier (see the interface

<lchan> upstream command). The logical channel is
required. Logical channel 1 can be specified for an
FFT mode spectrum rule.
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
Casa Systems CMTS

test cable hop-cm-mode upstream
test cable hop-cm-mode upstream

Purpose
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
Mode
(diag)#
Syntax
test cable hop-cm-mode upstream <slot>/<port>.<chan>/<lchan> <1:100>
<1:64>
Properties
<slot>/<port>.<chan>/ Upstream interface identifier (see the interface

<lchan> <1:100> <1:64> upstream command). The logical channel is
required. The values that follow are the number of
simulated modems with low SNRs suffering from
hops, followed by the spectrum rule ID.
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
Casa Systems CMTS

19-1
Chapter 19. Subscriber management
Subscriber management commands description

Casa CMTS supports Subscriber Management features defined in DOCSIS 3.0.
Subscriber management allows a CMTS operator to control the IP addresses and
protocols associated with subscribers cable modems.
Table 19-1 lists and briefly describes the objects related to subscriber management.
Table 19-1. Subscriber management objects
docsis submgt default Configures the subscriber management default settings

docsis submgt filters Removes all subscriber management IP and TCP/UDP
clear-all filters
docsis submgt ip-filter Sets filter rules for DOCSIS subscriber management.
Casa Systems CMTS

docsis submgt default

Purpose
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.
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
active {off | on} Turns DOCSIS subscriber management on or off.

The default is off.
Example:
CASA(config)# docsis submgt default

active off
Casa Systems CMTS

Subscriber management 19-3
Properties
cm-filter-downstream Packet filter group ID to be applied to CM

<0:65535> downstream traffic, default 0.
Example:

cm-filter-downstream 0
cm-filter-upstream Packet filter group ID to be applied to CM upstream

<0:65535> traffic, default 0.
Example:

cm-filter-upstream 0
cpe-filter-downstream Packet filter group ID to be applied to downstream

<0:65535> traffic to CPE devices, default 0.
Example:

cpe-filter-downstream 0
cpe-filter-upstream Packet filter group ID to be applied to upstream traffic

<0:65535> from CPE devices, default 0.
Example:

cpe-filter-upstream 0
learnable {off | on} Allows the cable modem to learn its IP address. The
default is ON.
Example:

learnable on
Casa Systems CMTS

Properties
max-ip <0:1023> Maximum number of CPE IP addresses that can be

allowed for each cable modem connected to the
CMTS, default maximum 16.
Example:

max-ip 16
max-ipv6-prefix <0:1023> Maximum number of IPv6 prefixes that can be

allowed for each cable modem connected to the
CMTS, default 16 prefixes.
Example:

max-ipv6-prefix 16
mta-filter-downstream Packet filter group ID to be applied to downstream

<0:65535> traffic to Multimedia Terminal Adapter (MTA) devices,
default 0.
Example:

mta-filter-downstream 0
mta-filter-upstream Packet filter group ID to be applied to upstream traffic

<0:65535> from MTA devices, default 0.
Example:

mta-filter-upstream 0
Casa Systems CMTS

Properties
ps-filter-downstream Packet filter group ID to be applied to downstream

<0:65535> traffic to Portal Server (PS) devices, default 0.
Example:

ps-filter-downstream 0
ps-filter-upstream Packet filter group ID to be applied to upstream traffic

<0:65535> from PS devices, default 0.
Example:

ps-filter-upstream 0
stb-filter-downstream Packet filter group ID to be applied to downstream

<0:65535> traffic to Set-Top Box (STB) devices, default 0.
Example:

stb-filter-downstream 0
stb-filter-upstream Packet filter group ID to be applied to upstream traffic

<0:65535> from STB devices, default 0.
Example:

stb-filter-upstream 0
Casa Systems CMTS

show docsis submgt default
Shows the default DOCSIS subscriber management settings.
CASA(config)# show docsis submgt default

docsis submgt default active off
docsis submgt default max-ip 16
docsis submgt default max-ipv6-prefix 16
docsis submgt default learnable on
docsis submgt default cm-filter-downstream 0
docsis submgt default cm-filter-upstream 0
docsis submgt default cpe-filter-downstream 0
docsis submgt default cpe-filter-upstream 0
docsis submgt default ps-filter-downstream 0
docsis submgt default ps-filter-upstream 0
docsis submgt default mta-filter-downstream 0
docsis submgt default mta-filter-upstream 0
docsis submgt default stb-filter-downstream 0
docsis submgt default stb-filter-upstream 0
show cable subscriber-usage
Shows the cable subscriber usage. This command depends on a cable traffic-policy
being defined. (See Chapter 3, Cable commands.)
Casa Systems CMTS

docsis submgt filters clear-all

Purpose
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.
Mode
(config)#
Syntax
Are you sure? (yes/no)
Clearing all submgt filters...
Casa Systems CMTS

docsis submgt ip-filter

Purpose
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 addition to classifying traffic based on L2/L3/L4 fields in the packet headers,

upstream traffic can be classified based on which CM interface received the packet.
The CM interface mask (CMIM) encoding provides a bit mask representing the
inbound interfaces of the CM for which this classifier applies. Each bit of the CM
interface mask corresponds to an interface, logical or physical. By convention, bit
position 0 corresponds to the CMs IP stack, even though it is not an actual interface.
This is configured with the cm-intf-mask <0:ffffff> property.
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
<1:65535> IP filter group ID.
Casa Systems CMTS

Properties
<1:65535> IP filter index, which allows multiple filter settings for

a group, with the CMTS considering the first matched
instance.
{accept | deny} Allows the packet to pass (accept), or drops the
packet (deny). All further filter settings are optional.
Example:
CASA(config)# docsis submgt ip-filter 1

1 accept
CASA(config)#
no docsis submgt ip-filter 1 1
cm-intf-mask <0:ffffff> Cable modem interface mask (CMIM), a bitmask. For

example, a CMIM classifier intended to match all the
CPE ports (external interfaces) of a CM has a CMIM
setting of bit 1 (400000) plus bits 5 through 15
(07FF00), an encoding of 47FF00 when combined.
The encodings are as follows:
Bit 0 (800000) CMs IP stack.

Bit 1 (400000) Primary CPE Interface (also
ePS or eRouter).
Bit 2 (200000) RF interface.
Bits 3 and 4 Reserved.
Bits 5 through 15 (07FF00) Other CPE Ports.
Bit 16 (000080) PacketCable-eMTA.
Bit 17 (000040) eSTB-IP.
Bit 18 (000020) Reserved.
Bits 19 through 31 (001FFF) Other eSAFE
interfaces.
dst-ip <ip_addr> <mask> Destination IP address and mask, in the form
A.B.C.D. Other filter settings can follow.
dst-ipv6 <ipv6_addr> Destination IPv6 address and prefix, in the form
xxxx:xxxx::xxxx/yy. Other filter settings can follow.
dst-port <0:65535> Destination TCP/UDP low and high port numbers.
<0:65535> Only the cm-intf-mask <0:ffffff> setting can follow.
Casa Systems CMTS

Properties
protocol <0:257> Protocol number. Other filter settings can follow.

src-ip <ip_addr> <mask> Source IP address and mask, in the form A.B.C.D.
Other filter settings can follow.
src-ipv6 <ipv6_addr> Source IPv6 address and prefix, in the form
xxxx:xxxx::xxxx/yy. Other filter settings can follow.
src-port <0:65535> Source TCP/UDP low and high port numbers. Other
<0:65535> filter settings can follow.
tos <0:255> <0:255> <0:255> Type of service (TOS), low, high, and mask. Other
[cm-intf-mask <0:ffffff> | filter settings can follow.
dst-port <0:65535>
<0:65535> | protocol
<0:257> | src-port
<0:65535> <0:65535>]
show docsis submgt ip-filter
Shows the IP filters for DOCSIS subscriber management. An accept appears as the
number 1 in the output.
CASA(config)# show docsis submgt ip-filter

Group Index Accept UIP TOSlo TOShi TOSMask Src Port Dst Port Hit Cnt
1 1 1 256 0 100 255 0 65535 0 65535 0
1 2 1 256 0 255 0 255 256 335 336 0
Casa Systems CMTS

20-1
Chapter 20. Upstream interface
Upstream interface commands description

The interface upstream command configures an upstream interface. Upstream ports
are physical interfaces the cable modem return paths connect to. The Casa CMTS
allows up to two logical channels in each upstream port (in SCDMA mode, one for
A-TDMA mode). Each upstream port and logical channel can be enabled or disabled
independently. The default state for all upstream ports and channels is shutdown. If an
upstream port is disabled, individual logical channels cannot be enabled.
Table 20-1 lists and briefly describes the objects related to the upstream interface.
Table 20-1. Upstream interface objects
interface upstream Configures the upstream interface.

upstream igmp filter Sets the number of Internet Group Management Protocol
(IGMP) packets to accept in a window.
upstream map size Configures the minimum upstream MAP size.
Casa Systems CMTS

interface upstream
interface upstream
Purpose
The interface upstream command configures an upstream interface. Upstream ports

are physical interfaces the cable modem return paths connect to. The Casa CMTS
allows up to two logical channels in each upstream port (in SCDMA mode, one for
A-TDMA mode). Each upstream port and logical channel can be enabled or disabled
independently. The default state for all upstream ports and channels is shutdown. If an
upstream port is disabled, individual logical channels cannot be enabled.
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 |
Casa Systems CMTS

Upstream interface 20-3
interface upstream
[no] logical-channel {0|1} ranging-backoff <0:15> <0:15>

logical-channel {0|1} ranging-priority <0x0:0xffffffff>
[no] logical-channel {0|1} shutdown
[no] logical-channel {0|1} spectrum-rule <1:64>
map-advance {dynamic <200:2000> | static <200:4000>}
no map-advance
partial-service {fec-threshold <1:100> | snr-threshold <-10:10>}
power-adjustment {continue <2:15> | threshold <0:2>}
no power-adjustment {continue | threshold}
power-level <-16:34>
[no] rate-limit
[no] shutdown
[no] small-signal- compensation
spectrum-rule <1:64>
no spectrum-rule
voice-bw-reserve {<0:100> | max-calls <0:255>} [emergency <0:255>]
no voice-bw-reserve
Properties
<slot>/<port>.<pchan> Required upstream interface ID, in the form slot/

port.physical_channel. This sets you in upstream
interface configuration mode. There is no no form of
the command, but some of the properties have no
forms.
Example:

CASA(config-if-ups 13/1.0)#
channel-width <Hz> Upstream channel width, in Hertz. The only valid

values are 200000, 400000, 800000, 1600000,
3200000, and 6400000 (6.4 MHz). There is no no
form of this command.
Example:
channel-width 6400000
Casa Systems CMTS

interface upstream
Properties
description <text> Optional upstream interface description, up to 64

characters, enclosed in quotes if embedded spaces.
Example:
CASA(config-if-ups 13/1.0)# description

Upstream 13
no description
frequency Upstream channel frequency in the range 5 MHz

<5000000:100000000> through 100 MHz, expressed in Hertz. There is no no
form of this command.
Example:
CASA(config-if-ups 13/1.0)# frequency

65000000
ingress-cancellation Enables ingress noise cancellation, which is disabled

[<10:1000>] by default. The optional sampling interval default is
200 milliseconds.
Example:
ingress-cancellation 500
no ingress-cancellation
interface upstream Configures another upstream interface, in the form

<slot>/<port>.<pchan> slot/port.physical_channel. There is no no form of
this command.
Example:
CASA(config-if-ups 13/1.0)# interface

upstream 13/1.1
Casa Systems CMTS

interface upstream
Properties
logical-channel {0|1} Enables an upstream logical channel for the

[description <text>] interface. The ID is either 0 or 1. If not specified, the
default is 0. An optional descriptive text (enclosed in
quotes) can be added. A logical channel must be
specified if applying a CM mode spectrum rule.
Example:
logical-channel 1
no logical-channel 1
no logical-channel 1 description
logical-channel {0|1} Logical channels channel width, as in the

channel-width <Hz> channel-width <Hz> property for the interface.
Multiple logical channels on an interface can have
different channel widths, allowing for dynamic
channel width switching based on the same center
frequency. There is no no form of this command.
Example:
logical-channel 1 channel-width 6400000
logical-channel {0|1} Logical channels class ID bit value. The class-id

class-id parameter enables the ranging hold-off upstream
<0x0:0xffffffff> channel descriptor (UCD) Type-19 type-length values
(TLVs). The value sets the ranging hold-off bit field
identifier, with 0x0 disabling the identifier. There is no
Example:
logical-channel 1 class-id 0xFFFFFFFF
Casa Systems CMTS

interface upstream
Properties
logical-channel {0|1} Logical channels data backoff value. The

data-backoff {<0:15> DOCSIS-specified method of contention resolution
<0:15> | automatic} for CMs wanting to transmit on the upstream channel
is a truncated binary exponential backoff value, with
the initial backoff window and the maximum backoff
window controlled by the CMTS. The CMTS specifies
backoff window values for both data transmission
and initial ranging. It sends these values downstream
as part of the Bandwidth Allocation Map MAC
message. The values are configurable and are
power-of-two values. For example, a value of 4
indicates a window between 0 and 15; a value of 10
indicates a window between 0 and 1023. You can set
fixed start and end values for data backoff on the
upstream ports, or set the upstream ports for
automatic data backoff (recommended for data
transmission). The default start value is 0; the default
end value is 4.
Example:
logical-channel 0 data-backoff 2 8
no logical-channel 0 data-backoff
Casa Systems CMTS

interface upstream
Properties
logical-channel {0|1} Logical channels Synchronous-Code Division

frame <1:32> <2:32> Multiple Access (SCDMA) frame interval. This
<64:128> interval improves the maximum upstream bandwidth
by allowing the same physical upstream channel to
receive multiple bursts simultaneously using a time
and code data transmission technique. Multiple
modems can send simultaneously using their own
codes in the same upstream time slot without
interfering with each other. Data is sent using up to
128 spreading codes. There is no no form of this
command. The values entered in succession are the
following:
<max_int> Maximum number of spreading

intervals per frame.
<max_codes> Maximum number of codes per
minislot.
<max_active> Maximum number of active
codes.
Example:
logical-channel 0 frame 24 12 64
logical-channel {0|1} Logical channels minislot size, in ticks. The value

minislot <size> can be 1, 2, 4, 8, 16, 32, 64, or 128. Increase the
minislot size to avoid switchover due to buffer
corruption. There is no no form of this command.
Example:
logical-channel 0 minislot 64
Casa Systems CMTS

interface upstream
Properties
logical-channel {0|1} Logical channels power offset (relative to the

power-offset <-10:10> physical channel power), in decibels (dB). There is no
Example:
logical-channel 0 power-offset 0
logical-channel {0|1} Enables logical channel pre-equalization, which

pre-equalization compensates for the difference in delays between the
[auto-reset] signal on the lower part of the 6Mhz channel
spectrum and the higher part, or microreflections,
caused by imperfections in the cable plant. The
default state is disabled, but Casa recommends that
it be enabled. The auto-reset modifier is optional.
Example:
logical-channel 0 pre-equalization
no logical-channel 0 pre-equalization
Casa Systems CMTS

interface upstream
Properties
logical-channel {0|1} Modulation profile for the logical channel. A

profile <1:1024> modulation profile can cause changes to the physical
[secondary-profile layer and can be created automatically
<id_list>] (recommended) or manually using the
modulation-profile command. The logical channel
can have a primary profile and an optional secondary
profile, although the two profiles must have the same
channel type and the secondary profile is not
supported on logical channel 1 and has to be less
bandwidth-efficient. There is no no form of this
command. The following values apply:
profile <id> Predefined primary profile ID.

secondary-profile <id_list> Optional second-
ary profile ID list, specifying the order of priority in
which Casa Spectrum Management (CSM) tries
to use the predefined profiles, up to 5 values sep-
arated by commas. The secondary profile is
required for the spectrum rule modulation action.
Example:
secondary-profile 12,20,33
Casa Systems CMTS

interface upstream
Properties
logical-channel {0|1} Logical channels provisioned attribute mask.

prov-attr-mask DOCSIS 3.0 provisioned attribute masks allow
{<0x0:0xffffffff> | assigning of service flows to channels or channel
bonding | bonding groups using binary attributes. These
highavailability | attributes are either user-defined or
lowlatency} specification-defined. There is no no form of this
command. At least one of the following values is
required:

user-defined.
user-defined.
Example:
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:
logical-channel 0 ranging-backoff 2 8
no logical-channel 0 ranging-backoff
Casa Systems CMTS

interface upstream
Properties
logical-channel {0|1} Logical channels ranging hold-off priority value, with

ranging-priority 0x0 disabling the ranging hold-off TLV. There is no
<0x0:0xffffffff> no form of this command.
Example:
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:
logical-channel 0 shutdown
logical-channel {0|1} Logical channels spectrum rule.

spectrum-rule <1:64>
Example:
logical-channel spectrum-rule 1
no logical-channel spectrum-rule
Casa Systems CMTS

interface upstream
Properties
map-advance {dynamic MAP advance for the upstream interface, which

<200:2000> | static defines the amount of look-ahead time for MAPs
<200:4000>} based on the plant characteristics. The system
already has a built-in look-ahead time to account for
internal operations like generating the MAP. One of
two options are available, as follows:
dynamic <max_delay> Dynamic MAP

advance automatically tunes the look-ahead time
by calculating the offset to the farthest modem on
that upstream port. The delay value defines an
additional look-ahead time for MAPs to allow for
internal latencies and inaccuracies in the mea-
surement system.
static <max_delay> Static MAP advance uses
a fixed look-ahead time specified by the user. (For
reference, a mile of coax cable has a delay of
about 7 microseconds; a mile of fiber has a delay
of about 8 microseconds.)
The default delay is equivalent to map-advance

static 3000, a conservative value. Using large delay
values increases the run-time look-ahead in MAPs,
but also reduces the upstream performance. A delay
value of 200 ms is usually adequate. For optimal
performance, measure the throughput relative to the
percent utilization and adjust the delay value to
achieve maximum throughput.
Example:
CASA(config-if-ups 13/1.0)# map-advance

dynamic 200
no map-advance
Casa Systems CMTS

interface upstream
Properties
partial-service Partial service forward error correction (FEC) or

{fec-threshold <1:100> | signal-to-noise ratio (SNR) threshold percentage.
snr-threshold <-10:10>} The partial-service SNR threshold is the offset dB
from the SNR threshold. There is no no form of this
command.
Example:
partial-service fec-threshold 3
partial-service srn-threshold -1
power-adjustment Adjusts the upstream input power for the interface, in

{continue <2:15> | the following ways:
threshold <0:2>}
continue <2:15> The CMTS can be set to
continue to adjust the modem power output
during ranging response. If the power offset is
within the power level set by the power-adjust
continue command, the CM is properly ranged in
transmit power. The adjustment level is in dBmV,
default 2. If it is beyond this level, the CMTS con-
tinues to send power adjust messages.
threshold <0:2> The upstream input power
threshold determines whether or not the CMTS
will send power adjustments. If the modem trans-
mits power is within the threshold, the CMTS
sends no adjustments. The adjustment level is in
dBmV. If it is beyond the threshold, then it sends
a power adjustment. After 16 failed attempts, the
CMTS stops sending ranging and the modem
remains offline.
Example:
power-adjustment threshold 1
no power-adjustment continue
Casa Systems CMTS

interface upstream
Properties
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:
power-level 0
rate-limit Upstream rate limiting, which is the default setting.
Example:
CASA(config-if-ups 13/1.0)# rate-limit

no rate-limit
shutdown Shuts down the upstream interface. The no form of

Example:
CASA(config-if-ups 13/1.0)# shutdown

CASA(config-if-ups 13/1.0)# no shutdown
Casa Systems CMTS

interface upstream
Properties
small-signal- Handles sudden power swings (up to 12 dB) over

compensation upstream channels that could result in modem
deregistration. The default setting is OFF; once
enabled, use the no form of the command to disable
this feature. Note that enabling this feature results in
a slight decrease in SNR, so it is recommended to
enable this feature only in conditions where known
power swings occur that are most commonly caused
by loose connections.
Example:
small-signal-compensation
no small-signal-compensation
Casa Systems CMTS

interface upstream
Properties
spectrum-rule <1:64> Predefined spectrum rule for the upstream interface,

identified by the spectrum rule ID. The spectrum rule
is created by the spectrum rule command in
configuration mode. With a spectrum rule assigned to
an upstream interface, the actions defined in the rule
will take place in the specified (or default) order of
priority if:
Plant noise level exceeds signal-to-noise ratio

(SNR) threshold defined explicitly in the com-
mands or by default.
Percentage of correctable FEC errors of total
packets received on the upstream (during polling
period) exceeds the defined or default threshold.
Percentage of uncorrectable FEC errors of total
packets received on the upstream (during polling
period) exceeds the defined or default threshold.
A rule can be assigned to any number of upstream

interfaces. However, only one rule assignment per
upstream interface is allowed.
Example:

CASA(conf-rule 1)# channel-width
3200000 1600000
CASA(conf-rule 1)# exit
spectrum-rule 1
no spectrum-rule
Casa Systems CMTS

interface upstream
Properties
voice-bw-reserve Voice bandwidth reserve percentage for the

{<0:100> | max-calls upstream interface. When the configured percentage
<0:255>} [emergency threshold is reached, no new voice calls are accepted
<0:255>] on that channel and any unused portion of the
configured percentage is available for data sessions.
However, new voice calls will assume priority and
preempt any data sessions. Additionally, you can
also reserve a portion of the configured voice
bandwidth percentage for emergency calls. The
default is 75%.
Example:
voice-bw-reserve max-calls 100
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.
show interface upstream [<slot>/<port>/<chan> | port <slot>/<port>] {brief |

current}
Shows the upstream interface configuration in a brief form, or the current

configuration. The specification can also be by port only.
CASA(config)# show interface upstream brief

spectrum-rule 37
Casa Systems CMTS

interface upstream
frequency 20000000
ingress-cancellation
no shutdown
show interface upstream stat
Shows the statistics for the upstream interfaces.
CASA(config)# show interface upstream stat

Interface upstream 2/0.0 statistics
Admin status: DOWN
Channel utilization interval: 30
Avg upstream channel utilization: 0
Avg percent contention slots: 0
Avg percent initial ranging slots: 0
Avg percent minislots lost on late MAPs: 0
Total BW : 0.0 Mbps
Voice BW Reservation setting 75% for Normal calls
Voice BW Reservation setting 0% for emergency calls
Number of normal voice calls 0(0.00%)
Number of emergency voice calls 0(0.00%)
show interface upstream <slot>/<port>/<chan> logical-channel <id> stat
Shows the statistics for the upstream logical channel.
CASA(config)# show interface upstream 13/0.0 logical-channel 0 stat

...
Logical-channel 0
Received 4228 broadcasts, 0 multicasts, 0 unicasts
0 discards, 0 errors, 0 unknown protocol
26381 Unerroreds, 0 Correcteds, 0 Uncorrectables
Total Modems On This Upstream Channel: 1 ,1 active cm,0 secondary
cm
Req Mslots 1024814224, Used Req Mslots 12684
Init Mtn Mslots 541327773, Used Init Mtn Mslots 0
Total Mslots 1566609521, Ucast Granted Mslots 467460
Admin status: UP
Casa Systems CMTS

interface upstream
show interface upstream [<slot>/<port>/<chan>] ugs statistics
Shows the Unsolicited Grant Service (UGS) statistics for the upstream interfaces.
CASA(config)# show interface 13/0.0 upstream ugs statistics

Interface upstream 13/0.0
Active ugs flow on the Upstream: 0
UGS Allocation Statistics
max min avg
Last 3 Hour 0 0 0.00
Last 15 Min 0 0 0.00
show controller upstream
Shows the upstream interface status for the controller, including the modulation
profile and SNR.
CASA(config)# show controller upstream
Interface upstream 13/0.0/0 information:

IfIndex : 5003328
Admin status: UP
Operating status: UP
Frequency: 20000000 Hz
Channel Width: 3200000 Hz
Power Level: 0
Modulation profile 2
SNR: 0.0
Statistics:
show upstream [<slot>/<port>/<chan>] cnr
Shows the upstream interface carrier-to-noise ratio (CNR).
CASA(config)# show upstream cnr
upstream channel cnr

11/0.0/0 39.1
Casa Systems CMTS

upstream igmp filter
upstream igmp filter

Purpose
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
<0:5000> <1:5> Number of IGMP packets to accept followed by the

number of seconds in a window.
Example:
CASA(config)# upstream igmp filter 2500

5
CASA(config)# no upstream igmp filter
Casa Systems CMTS

upstream map size
upstream map size

Purpose
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
<2:10> Minimum upstream MAP size, default 5 milliseconds

(recommended). A smaller MAP size reduces
upstream latency at the expense of more frequent
MAP messages that consume more downstream
bandwidth.
Example:
CASA(config)# upstream map size 2

CASA(config)# no upstream map size 2
show interface upstream brief
Shows the upstream interface configuration in a brief form. You can also use the
current modifier to get the current configuration.
CASA(config)# show interface upstream brief

spectrum-rule 37
Casa Systems CMTS

frequency 20000000
ingress-cancellation
no shutdown
show controller upstream
Shows the upstream interface status for the controller, including the modulation
profile and SNR.
CASA(config)# show controller upstream

Interface upstream 13/0.0/0 information:
IfIndex : 5003328
Admin status: UP
Operating status: UP
Frequency: 20000000 Hz
Channel Width: 3200000 Hz
Power Level: 0
Modulation profile 2
SNR: 0.0
Statistics:
show docsis upstream channel utilization
Shows the upstream channel utilization.
CASA(config)# show docsis upstream channel utilization

Upstream Total-BW Utilization Online Secondary Channel
Slot/Port.Channel (Mb/Sec) Percentage Modems Modems Description
----------------------------------------------------------------------
13/0.0 (24000000 Hz) 10.2 80 0 1
13/0.1 (27200000 Hz) 10.2 81 1 0
Casa Systems CMTS

show upstream channel set
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.
CASA(config)# show upstream channel set

MAC Chan Channel
ID Set List
1 1 10/0.0/0
2 1 10/0.1/0
3 1 10/0.2/0
4 1 10/0.3/0
5 1 13/15.0/0
6 1 13/15.1/0
7 1 13/15.2/0
8 1 13/15.3/0
show upstream cnr
Shows the upstream interface carrier-to-noise ratio (CNR).
CASA(config)# show upstream cnr

upstream channel cnr
11/0.0/0 39.1
show upstream fec
Shows the upstream Forward Error Correction (FEC) values.
CASA(config)# show upstream fec docsis-mac 11

US chan frequency status cFEC uFEC
10/0.0/0 20000000 UP 0 0
10/0.1/0 24000000 UP 0 0
10/0.2/0 28000000 UP 0 0
10/0.3/0 32000000 UP 16 78
show upstream signal-quality
Shows the average signal-to-noise ratio (SNR) of the upstream channels in dB units.
CASA(config)# show upstream signal-quality

upstream port signal noise
11/0.0/1 42.0
11/0.0/1 42.0
Casa Systems CMTS

modulation-profile
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.
Casa Systems CMTS

21-1
Chapter 21. Video
Video commands description

A video configuration consists of a unique QAM domain along with the following:
At least one preconfigured video interface.

One preconfigured Edge Device Interface Specification (EDIS) Session Resource
Manager (SRM) or Edge Resource Manager (ERM).
At least one QAM group.
1. Add users See the adduser command.
2. Configure QAM ports See the interface qam command.
3. Configure the QAM 8x96 downstream channels See Chapter 16, QAM 8x96
configuration.
4. Configure the general video parameters See the video command.
5. Create the video interfaces See the interface video command.
6. Create the EDIS/SRM or ERM See the video edis or video erm command
(along with the video signaling-mode and video module commands for ERM).
7. Create the QAM domain to include the video interfaces See the video
qam-domain command.
8. Create one or more QAM groups See the qam-group property of the video
qam-domain command.
9. Copy the configuration to startup-config.
10. Export the configuration for EDIS/SRM See the video qam export
configuration slot command.
Casa Systems CMTS

Table 21-1 lists and briefly describes the objects related to video.
Table 21-1. Video objects
adduser Adds a video user.

interface video Configures a video interface.
video cat-interval Sets the millisecond interval between adjacent CAT tables.
video cat-interval Enables clock drift correction.
video dejitter-interval Sets the dejitter buffer size.
video edis Configures the Edge Device Interface Specification (EDIS).
video erm Configures Edge Resource Manager (ERM) properties.
video error-threshold Sets the number of errors to occur before detecting video
degradation.
video error-window Sets the time period when sampling for degraded video.
video logging Selects one or more logging levels.
video module Defines a video module.
video Defines the elapsed time before detecting multicast/
multicast-session-loss-t Switched Digital Video (SDV) session loss.
imeout
video ngod Enables Next Generation On Demand (NGOD) control
source binding.
video pat-interval Defines the maximum time between adjacent program
association tables (PATs).
video pid-remapping-mode Sets the packet identifier (PID) remapping mode.
video pktloss-window Sets the number of seconds to allow when checking for loss
of video packets.
video pme Sets the Privacy Mode Encryption (PME) properties.
video pme certificate Installs an existing ERS certificate.
video pmt-interval Sets the maximum time between adjacent program
mapping tables (PMTs).
video qam-domain Edits the QAM parameters for the Converged Cable Access
Platform (CCAP) device.
Casa Systems CMTS

Video 21-3
Table 21-1. Video objects
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.
Casa Systems CMTS

adduser
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.
The default username is root and the default password is casa.
Modes
#
(config)#
Syntax
adduser <login_id> [privilege <0:15>]
New password: <pwd>
Reenter password: <pwd>
adduser <login_id> [privilege <0:15>] encrypted-password <pwd>
Properties
<login_id> Required users login ID.

privilege <0:15> Command privilege level for the user. The privileges
range from 0 (lowest operation: show and clear
commands only) through 15 (superuser). If omitted,
the privilege level defaults to 1 (operator).
encrypted-password <pwd> Encrypts the password, which is the default. The
<pwd> is a text string, which will be encrypted.
Casa Systems CMTS

Video 21-5
adduser
Properties
<pwd> Required password. You are prompted for the

password if not adding the encrypted-password
modifier; if using the encrypted-password modifier,
specify the password as part of the
encrypted-password <pwd>. The password must be
a minimum 5 and maximum 8 characters in length,
with a combination of uppercase and lowercase
characters and integers.
Example:
CASA(config)# adduser robert privilege

15
Changing password for robert
Enter the new password (minimum of 5,
maximum of 8 characters)
Please use a combination of upper and
lower case letters and numbers.
New password: *****
Re-enter new password: *****
Password changed.
show user
Shows the user configuration. The same result can be achieved with the show run |
include user command.
CASA(config)# show user

user root privilege 15 encrypted-password vQ5PNUDraqcgc
user homeslice privilege 15 encrypted-password 0ORTMKdIqeBhg
user USER1 privilege 13 encrypted-password c1qfliaev4U

Casa Systems CMTS

interface video
interface video
Purpose
The interface video command configures a video interface.
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>
Casa Systems CMTS

Video 21-7
interface video
Properties
<1:16> Required video interface ID.
Example:
CASA(config)# interface video 1

CASA(conf-if-video 1)# exit
CASA(config)# no interface video 1
bandwidth <0:80000000> Required bandwidth setting for the video interface,

default 10000000 kbps. There is no no form of the
command.
Example:
CASA(conf-if-video 1)# bandwidth

10000000
description <text> Optional video interface description, up to 64

characters, enclosed in quotes if embedded spaces.
Example:
CASA(conf-if-video 1)# description

Video 1 interface
CASA(conf-if-video 1)# no description
edis control-source Edge Device Interface Specification (EDIS) cable

loopback <0:15> control source on the loopback interface, default 0.
Example:
CASA(conf-if-video 1)# edis

control-source loopback 1
CASA(conf-if-video 1)#
no edis control-source
Casa Systems CMTS

interface video
Properties
gige <slot>/<port> Gige interface slot and port for the voice interface.
Example:
CASA(conf-if-video 1)# gige 6/1

CASA(conf-if-video 1)# no gige 6/1
input-group-name <name> Input group name for the voice interface.
Example:
CASA(conf-if-video 1)# input-group-name

IGRP1
no input-group-name
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:
CASA(conf-if-video 1)# input-port-id 8

CASA(conf-if-video 1)# no input-port-id
ip {address <ip_addr> IP address and mask of the voice interface, in

<mask> | igmp [version A.B.C.D form, or the igmp keyword with optional
<1:3>]} version.
Example:
CASA(conf-if-video 1)# ip address

192.168.8.8 255.255.255.255
CASA(conf-if-video 1)# no ip address
CASA(conf-if-video 1)# no ip igmp
Casa Systems CMTS

Video 21-9
interface video
Properties
trunk <1:20> Trunk interface for the voice traffic.
Example:
CASA(conf-if-video 1)# trunk 1

CASA(conf-if-video 1)# no trunk 1
vlan <1:4094> VLAN ID for the voice traffic.
Example:
CASA(conf-if-video 1)# vlan 1

CASA(conf-if-video 1)# no vlan
vrf forwarding <name> Enables VRF forwarding based on a predefined VRF

on the VLAN.
Example:
CASA(conf-if-video 1)# vrf forwarding

VRFD1
no vrf forwarding
xgige <slot>/<port> XGigE interface slot and port for the voice interface.
Example:
CASA(conf-if-video 1)# xgige 7/0

CASA(conf-if-video 1)# no xgige 7/0
Casa Systems CMTS

interface video
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.
CASA(config)# interface video 6

CASA(conf-if-video 6)# edis control-source loopback 0
CASA(conf-if-video 6)# ip address 199.209.6.6 255.255.255.255
CASA(conf-if-video 6)# exit
CASA(config) interface gige 6/6

CASA(conf-if-gige 6)# mac address 00:17:10:03:c8:87
CASA(conf-if-gige 6)# ip address 199.6.6.1 255.255.255.255
CASA(conf-if-gige 6)# no ip igmp
CASA(conf-if-gige 6)# no ipv6 mld
CASA(conf-if-gige 6)# auto negotiate
CASA(conf-if-gige 6)# no shutdown
CASA(conf-if-gige 6)# exit
CASA(config)# interface xgige 7/6

CASA(conf-if-xgige 7/6)# mac address 00:17:10:03:f4:07
CASA(conf-if-xgige 7/6)# ip address 199.7.6.1 255.255.255.255
CASA(conf-if-xgige 7/6)# no ip igmp
CASA(conf-if-xgige 7/6)# no ipv6 mld
CASA(conf-if-xgige 7/6)# auto negotiate
CASA(conf-if-xgige 7/6)# no shutdown
CASA(conf-if-xgige 7/6)# exit
show interface video
Shows the video interface configuration.
CASA(config)# show interface video

interface video 1
ip address 169.254.1.1 255.255.255.0
ip igmp
edis control-source loopback 1
input-port-id 1
bandwidth 10000000
Casa Systems CMTS

Video 21-11
interface video
show interface video stat
Shows the video interface statistics.
CASA(config)# show interface video stat

interface video 1 status 1:
L3 Mode UP
qam module 0
video unicast count 0
interface video 2 status 1:

L3 Mode UP
qam module 4
video unicast count 13733
show cable voice summary
Shows the video voice statistics.
CASA(config)# show cable voice summary

Upstream Normal Emergency Total Last 0.5 Minutes Last
0.1 Hour
Channel Allow-Alloc(%)/Curr-Alloc(%)/Calls# Max Min Avg Max
Min Avg
-------- -------------------------------------- ----------------
----------------
13/0.0 90/0.00/0 0/0.00/0 90/0.00/0 0 0 0.00 0
0 0.00
13/0.1 90/0.00/0 0/0.00/0 90/0.00/0 0 0 0.00 0
0 0.00
13/0.2 90/0.00/0 0/0.00/0 90/0.00/0 0 0 0.00 0
0 0.00
13/0.3 90/0.00/0 0/0.00/0 90/0.00/0 0 0 0.00 0
0 0.00
13/0.4 90/0.00/0 0/0.00/0 90/0.00/0 0 0 0.00 0
0 0.00
13/0.5 90/0.00/0 0/0.00/0 90/0.00/0 0 0 0.00 0
0 0.00
13/0.6 90/0.00/0 0/0.00/0 90/0.00/0 0 0 0.00 0
0 0.00
13/0.7 90/0.00/0 0/0.00/0 90/0.00/0 0 0 0.00 0
0 0.00
Casa Systems CMTS

video
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)#
Casa Systems CMTS

Video 21-13
video cat-interval
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.
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
{<50:1000> | default} CAT interval, in milliseconds. The alternative default

setting accepts the default value of 250 ms.
Example:
CASA(config)# video cat-interval 200
Casa Systems CMTS

video clk-drift-correction
video clk-drift-correction
Purpose
The video clk-drift-correction command enables clock drift correction to reduce

video clock jitter.
no form of the command to remove the property.
Mode
(config)#
Syntax
[no] video clk-drift-correction
Casa Systems CMTS

Video 21-15
video dejitter-interval
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.
Mode
(config)#
Syntax
video dejitter-interval {<10:500> | default}
Properties
{<10:500> | default} Dejitter buffer size, in milliseconds. The alternative

default setting accepts the default value of 200 ms.
Example:
CASA(config)# video dejitter-interval

200
Casa Systems CMTS

video edis
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] ip-address <ip_addr>
[no] reset-indication
reset-interval <1:60>
[no] srm-type {bbnd-cvex | casa | cisco-usrm}
Properties
<1:8> EDIS index. This puts the command context in video

EDIS configuration mode.
Example:
CASA(config)# video edis 5

CASA(conf-video-edis 5)# exit
CASA(config)# no video edis 5
Casa Systems CMTS

Video 21-17
video edis
Properties
announce Enables EDIS announce messages, the default. The

EDIS announce message codes are as follows:
2104 Stream successfully established, PAT

and PMT updated.
5200 Stream lost or degraded and is no longer
flowing properly.
5406 Stream failed to acquire a multicast
stream for a source specific address (source IP
address included).
Example:
CASA(conf-video-edis 5)# announce

CASA(conf-video-edis 5)# no announce
description <text> SRM name, up to 31 alphanumeric characters,

embedded in quotes if spaces included.
Example:
CASA(conf-video-edis 5)# description

EDIS 5
CASA(conf-video-edis 5)# no description
ip-address <ip_addr> IP address of the EDIS server, in standard 32-bit

dotted notation.
Example:
CASA(conf-video-edis 5)# ip-address

192.168.8.8
CASA(conf-video-edis 5)# no ip-address
Casa Systems CMTS

video edis
Properties
reset-indication Enables EDIS reset indication messages, the default.
Example:
CASA(conf-video-edis 5)#
reset-indication
CASA(conf-video-edis 5)#
no reset-indication
reset-interval <1:60> Reset interval for the EDIS protocol, default 5

seconds. There is no no form of the command.
Example:
CASA(conf-video-edis 5)# reset-interval

30
srm-type {bbnd-cvex | Identifies the third-party SRM, which can be casa,

casa | cisco-usrm} bbnd-cvex (BigBand Networks Converged Video
Exchange) or cisco-usrm (Cisco Universal Session
and Resource Manager).
Example:
CASA(conf-video-edis 5)# srm-type casa

CASA(conf-video-edis 5)# no srm-type
Casa Systems CMTS

Video 21-19
video edis
show video edis
Shows the video EDIS configuration.
CASA(config)# show video edis 1

video edis 1
ip-address 169.254.1.2
srm-type bbnd-cvex
reset-interval 5
announce
no reset-indication
video edis 2
srm-type casa
reset-interval 5
announce
no reset-indication
Casa Systems CMTS

video erm
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
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
<1:8> Edge Resource Manager (ERM) ID.
Example:
CASA(config)# video erm 1

CASA(conf-video-erm 1)# exit
CASA(config)# no video erm 1
Casa Systems CMTS

Video 21-21
video erm
Properties
connect-retry-time Connect retry interval to the ERM server, in decimal

<1.0:60.0> seconds, default 7.5 seconds. There is no no form of
the command.
Example:
CASA(conf-video-erm 1)#
connect-retry-time 7.5
hold-timeout <30:300> Hold timeout interval, which indicates the duration

between responses to successive keepalive or
UPDATE messages received by the CCAP. If the
duration time elapses and a response is not received,
the CCAP attempts to re-establish the connection
with the ERM. The parameter should not be edited
once a session with the ERM is established. There is
The hold-timeout is negotiated between the

Edge and the ERM in the D6 OPEN message.
Each peer sends their configured hold time and
they agree on the lower of the two.
If set to zero, KEEPALIVE messages are not
sent.
If set to a non-zero value, each peer must send a
KEEPALIVE within that period to reset this timer.
Only the EDGE sends UPDATE messages; an
UPDATE message also resets this timer.
If the timer expires and no KEEPALIVE message
is received, the D6 connection terminates and
restarts after the connect-retry-time <1.0:60.0>.
If modified at the Edge, the D6 connection is
restarted for re-negotiation with the ERM.
Example:
CASA(conf-video-erm 1)# hold-timeout 60
Casa Systems CMTS

video erm
Properties
host-address <addr> ERM host address, as IP address or domain name,

[port <1:65535>] optionally followed by the port number, default 6069.
Example:
CASA(conf-video-erm 1)# host-address

192.168.8.8 port 6069
CASA(conf-video-erm 1)# no host-address
keepalive-timeout Keepalive timeout interval, default 10 seconds, which

<1:120> indicates the interval in which a D6 KEEPALIVE
message is transmitted to the ERM. The timeout
must be less than the hold-timeout <30:300>; if it is
greater than or equal to the negotiated hold-timeout,
the keepalive-timeout is set to one-third the
negotiated hold-timeout for the duration of the D6
session. There is no no form of the command.
Example:
CASA(conf-video-erm 1)#
keepalive-timeout 20
show video erm
Shows the video ERM configuration.
CASA(config)# show video erm

host-address 192.168.8.8 port 6069
hold-timeout 60
connect-retry-time 7.5
keepalive-timeout 20
Casa Systems CMTS

Video 21-23
video error-threshold
video error-threshold
Purpose
The video error-threshold command sets the number of errors to occur before
detecting video degradation.
Mode
(config)#
Syntax
video error-threshold {<1:65535> | default}
Properties
{<1:65535> | default} Number of errors to occur before detecting video

degradation. The alternative default setting accepts
the default value of 100 errors.
Example:
CASA(config)# video error-threshold 10
show video error-stats all
Shows the video error statistics.
CASA(config)# show video error-stats all
Casa Systems CMTS

video error-window
video error-window
Purpose
The video error-window command sets the time period when sampling for degraded
video.
Mode
(config)#
Syntax
[no] video error-window {<1:30> | default}
Properties
{<1:30> | default} Time period in seconds when sampling for degraded

video. The alternative default setting accepts the
default value of 10 seconds.
Example:
CASA(config)# video error-window 10

CASA(config)# no video error-window 10
show video error-stats all
Shows the video error statistics.
CASA(config)# show video error-stats all
Casa Systems CMTS

Video 21-25
video logging
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.
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}
Casa Systems CMTS

video logging
Properties
{announce | d6-keep-alive | Logging level. By default, system log messages are

debugging | edis-ping | classified at the Warning, Informational, and Errors
edis-raw | edis-text | event levels. All other levels must be set explicitly.
errors | informational | Clear the logging level with the clear video log
ngod-raw | ngod-text | command.
trace | warning}
Example:
CASA(config)# video logging announce

CASA(config)# no video logging
CASA(config)# no video logging announce
CASA(config)# clear video log announce
show video log <log_type>
Shows video session log messages of a specific type.
CASA(config)# show video log non-volatile

[2014-07-17,12:10:03.4571]-WA-_edg_upd_svc():590: thread for
127.1.0.5:48552 exit
[2014-07-17,09:35:47.3242]-WA-_edg_upd_svc(): start edg_upd_svc for
slot 10

show video mirror
Shows a video diagnostic session, if present. (The video mirror command is currently
available in diagnostic mode only.)
CASA(config)# show video mirror
Casa Systems CMTS

Video 21-27
video module
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
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] 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
<0:13> Defines a video module. Only QAM 8x96 modules

are supported. This puts you in video module
configuration mode.
Example:
CASA(config)# video module 10

CASA(conf-video-module 10)# exit
CASA(config)# no video module 10
Casa Systems CMTS

video module
Properties
bandwidth-update-thresho Available bandwidth threshold, in kilobits-per-second,

ld <0:2147483647> default 0. There is no no form of the command.
Example:
CASA(conf-video-module 10)#
bandwidth-update-threshold 0x70000000
cost <0:255> Cost value, default 1. There is no no form of the

command.
Example:
CASA(conf-video-module 10)# cost 255
d6-enable Enables the D6 cable interface for the module.
Example:
CASA(conf-video-module 10)# d6-enable

no d6-enable
description <text> Optional description for the module, up to 64

characters, embedded in quotes if spaces.
Example:
CASA(conf-video-module 10)# description

This video module is in Andover
no description
Casa Systems CMTS

Video 21-29
video module
Properties
edge-name <name> Edge name (instance ID) for the module, three digits
identifying the edge devices in a location, maximum
50 characters.
Example:
CASA(conf-video-module 10)# edge-name

001
no edge-name
erm <1:8> Edge Resource Manager (ERM) properties for the

module based on the ERM ID, as defined by the
video erm command. The video signaling-mode
must be set to ngod.
Example:
CASA(conf-video-module 10)# erm 1

Error: Video signaling mode is not ngod
CASA(conf-video-module 10)# no erm 1
location Module location, in the form

<state>.<city>.<loc_id> <State>.<City>.<Locality ID>.<Hub name>,
.<hub_name> maximum 36 characters.
Example:
CASA(conf-video-module 10)# location

"MA.Andover.01810.HUB1"
CASA(conf-video-module 10)# no location
Casa Systems CMTS

video module
Properties
ngod control-source Next Generation On Demand (NGOD) control source

loopback <0:15> [port address-defined loopback interface, with the optional
<1:65535>] R6 port number, default 554. The video
signaling-mode must be set to ngod.
Example:
CASA(conf-video-module 10)# ngod

control-source loopback 0 port 554
Error: Video signaling mode is not ngod
no ngod control-source
shutdown Shuts down the video module interface. Use the no

form of the command to restart the interface.
Example:
CASA(conf-video-module 10)# shutdown

CASA(conf-video-module 10)# no shutdown
streaming-zone <name> Streaming zone name for initiating a connection with

the ERM.
Example:
streaming-zone SZNAME
no streaming-zone
Casa Systems CMTS

Video 21-31
video module
show video module
Shows configured video modules.
CASA(config)# show video module

video module 4
d6-enable
no shutdown
no erm
no streaming-zone
no location
no edge-name
no description
cost 1
bandwidth-update-threshold 0
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
Casa Systems CMTS

video multicast-session-loss-timeout
video multicast-session-loss-timeout
Purpose
The video multicast-session-loss-timeout command defines the elapsed time before

detecting multicast/Switched Digital Video (SDV) session loss. SDV provides video
services in a more efficient manner than broadcast video. It does this by not sending
unwatched programs to the service group(s), which frees up bandwidth on the QAM
channels for other applications. (See the Casa Systems CCAP Video Edge User
Guide for more details.)
Mode
(config)#
Syntax
video multicast-session-loss-timeout {<1:172800> | default}
Properties
{<1:172800> | default} Elapsed time before detecting multicast/SDV session

loss. The alternative default setting accepts the
default value of 60 seconds.
Example:
CASA(config)# video
multicast-session-loss-timeout 30
Casa Systems CMTS

Video 21-33
video ngod
video ngod
Purpose
The video ngod command has two objects, as follows:
control-source bind Enables Next Generation On Demand (NGOD) control

source binding.
vendor-string Populates the vendor string parameter in the VREP message
forwarded to the Edge Resource Manager (ERM). The vendor string used to be
defined by the description property of the video module command, but is now a
separate NGOD property that applies to all video modules. NGOD communicates
with the ERM using the D6 protocol. When the TCP protocol is first established,
it exchanges a D6-OPEN message with the ERM and this vendor string is
included in the message. If both sides agree on the others OPEN message, they
send a KEEPALIVE as a positive acknowledgment. This sends D6-UPDATE
messages to the ERM indicating the status of the input (GigE or xGigE) video
interface and video QAM channels.
Mode
(config)#
Syntax
video ngod control-source bind
no video ngod control-source bind
video ngod vendor-string <name>
no video ngod vendor-string
Casa Systems CMTS

video ngod
Properties
control-source bind Enables NGOD control source binding.
Example:
CASA(config)# video ngod control-source

bind
CASA(config)#
no video ngod control-source bind
vendor-string <name> Vendor string, maximum 50 characters, no blank

spaces.
Example:
CASA(config)# video ngod vendor-string

casa-c100g
CASA(config)#
no video ngod vendor-string
Casa Systems CMTS

Video 21-35
video pat-interval
video pat-interval
Purpose
The video pat-interval command defines the maximum time between adjacent
program association tables (PATs).
Mode
(config)#
Syntax
video pat-interval {<50:1000> | default}
Properties
{<50:1000> | default} Maximum time between adjacent program

association tables (PAT), in milliseconds. The
alternative default setting accepts the default value
of 250 ms.
Example:
CASA(config)# video pat-interval 250
Casa Systems CMTS

video pid-remapping-mode
Purpose
The video pid-remapping-mode command sets the packet identifier (PID)

remapping mode to reserve a range of PIDs that do not conflict with the transparent
passing of a video stream through a QAM channel. Auto-mapped video sessions use
256 PIDs beginning with the start PID.
Mode
(config)#
Syntax
video pid-remapping-mode {auto [start-pid <16:7900>] | pg-num-based}
Casa Systems CMTS

Video 21-37
Properties
{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:
auto The system assigns a PID from the range

256 through 511 (0x21 through 0x1FF0) and
guarantees that all remapped PIDs are unique in
a QAM channel. The start-pid option reserves a
range of PIDs that will not conflict with the trans-
parent passing of a video stream through a QAM
channel. Auto-mapped video sessions use 256
PIDs beginning with the start PID.
pg-num-based Program-number-based
mode. The following fixed mapping is used for a
given output program number N:
PMT PID = N * 0x10

PCR PID = Video PID = (PMT PID) + 1
Audio 1 PID = (PMT PID) + 4; for the 1st audio
Audio 2 PID = (PMT PID) + 5; for the 2nd audio if
it exists
ECM PID = (PMT PID) + 9
Example:
CASA(config)# video pid-remapping-mode

auto
Casa Systems CMTS

video pktloss-window
video pktloss-window
Purpose
The video pktloss-window command sets the number of seconds to allow when
checking for loss of video packets.
Mode
(config)#
Syntax
video pktloss-window {<1:60> | default}
no video pktloss-window
Properties
{<1:60> | default} Number of seconds to allow when checking for loss

of video packets. The alternative default setting
accepts the default value of 1 second.
Example:
CASA(config)# video pktloss-window 10

CASA(config)# no video pktloss-window
Casa Systems CMTS

Video 21-39
video pme
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.
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
Casa Systems CMTS

video pme
Properties
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:
CASA(config)# video pme contact

support@casa-systems.com
CASA(config)# no video pme contact
device-id [2] <id> password Device ID and password, as text strings up to 32

[2] <pwd> characters. If the optional number 2 is omitted, the
device ID and password are presented in clear text. If
inserted, the second 2 in front of the password must
also be inserted and is intended for system
startup-configuration processing. Clear text should
be used for configuration.
Example:
CASA(config)# video pme device-id

XXXX-XXX password YYYYYYY
CASA(config)# no video pme device-id
on Turns PME encryption on or off. By default,

encryption is turned off. The command is under
configuration mode. When turned on, the encryption
engine starts encrypting the incoming stream
immediately. Use the no form of the command to turn
encryption off.
Example:
CASA(config)# video pme on

CASA(config)# no video pme on
Casa Systems CMTS

Video 21-41
video pme
Properties
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:
CASA(config)# video pme proxy server

192.168.8.9 port 50010
CASA(config)# no video pme proxy server
proxy server keepalive PME server keepalive, maximum 3600 seconds

<10:3600> (1 hour), default 30 seconds.
Example:

keepalive 60
CASA(config)#
no video pme proxy server keepalive
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:

master
CASA(config)#
no video pme proxy server master
retry-time <1:1440> PME retry time interval, default 5 minutes.
Example:
CASA(config)# video pme retry-time 10

CASA(config)# no video pme retry-time
Casa Systems CMTS

video pme
Properties
source-interface loopback Internal Converged Cable Access Platform (CCAP)

<0:15> loopback interface for Encryption Renewal System
(ERS) communication, no default. The ERS manages
encryption data for the PME Conditional Access
System (CAS) and provides the interface to the
CCAP Edge QAM Manager.
Example:
CASA(config)# video pme

CASA(config)#
no video pme source-interface
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:
CASA(config)# video pme url

casa-systems.com
CASA(config)# no video pme url
show video pme
Shows the current PME video configuration.
CASA(config)# show video pme

PME status : Off
Loopback : N/A
Retry timer : 5 minutes
Test-mode : Off
Contact info : N/A
Certificate installed : No
URL: N/A
Sync Number: 0
Casa Systems CMTS

Video 21-43
video pme
show video pme proxy stats
Shows the current PME video proxy server statistics.
CASA(config)# show video pme proxy stats

Client or Server is not configured
show video homeless-streams {all | slot <id>}
Shows reported unknown video sessions to the SMM.
CASA(config)# show video homeless-streams all

QAM Src Dest Dest Total
Module IpAddress IpAddress Port Pkts
show video input-streams [multicast | unicast] [rows [<start> [<end>] |

count]
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.
CASA(config)# show video input-streams multicast

Destination Source Input Bitrate Program PMT PCR Total
IP Addr:Port IP Addr Port (mbps) Number PID PID ES PIDs
------------ ------------- --------- ------- ------- -------- --------
230.55.0.2 198.24.25.55 xgige 7/0 3.7480 2 480 481 3
230.55.0.2 198.24.25.55 xgige 7/0 3.7470 2 480 481 3
Contin Sync PcrInter Jitter Replicated

Error Loss Exceeds (ms)
------ ------- ---------- ----------- ----------
0 0 0 0 0
2 0 0 0 0
show smm sync-status
Shows the file synchronization between the active and standby SMM.
CASA(config)# show smm sync-status

Data base sync status: synchronized
Boot image sync status: synchronized
Casa Systems CMTS

video pme certificate
video pme certificate

Purpose
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
Casa Systems CMTS

Video 21-45
video pmt-interval
video pmt-interval
Purpose
The video pmt-interval command sets the maximum time between adjacent program
mapping tables (PMTs).
Mode
(config)#
Syntax
video pmt-interval {<50:10000> | default}
Properties
{<50:10000> | default} Maximum time between adjacent program mapping

tables (PMTs), in milliseconds. The alternative
default setting accepts the default value of 250 ms.
Example:
CASA(config)# video pmt-interval 500
Casa Systems CMTS

video qam-domain
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
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
<1:128> QAM domain index. Configuring the QAM domain

index puts the command context in QAM domain
configuration mode.
Example:
CASA(config)# video qam-domain 56

CASA(conf-qam-domain 56)# exit
CASA(config)# no video qam-domain 56
Casa Systems CMTS

Video 21-47
video qam-domain
Properties
description <text> Adds a description for the QAM domain, up to 64

characters, embedded in quotes if space characters.
Example:
CASA(conf-qam-domain 56)# description

#56 QAM domain
CASA(conf-qam-domain 56)#
no description
edis <1:8> Identifies the Edge Device Interface Specification

(EDIS) instance by index number, as set by the video
edis command.
Example:
CASA(conf-qam-domain 56)# edis 1

CASA(conf-qam-domain 56)# no edis 1
interface video <1:16> Sets one or more previously-configured video

interfaces to include in the QAM domain. A QAM
domain can associate with more than one video
interface, but each interface cannot associate with
QAM domains on different QAM cards. (See the
interface video command.)
Example:
CASA(conf-qam-domain 56)# interface

video 1
no interface video 1
Casa Systems CMTS

video qam-domain
Properties
qam-group <1:8> Configures up to 32 QAM groups on a downstream

{<start_qam> <end_qam> | line card, with a maximum 8 QAM groups per QAM
shared-channel <slot>/ domain. A QAM channel cannot be present in more
<port>} than one QAM group. Specify start and end QAM
channels, in the form <slot>/<port>/<chan>, or a
shared channel in the form <slot>/<chan>.
Example:
CASA(conf-qam-domain 56)# qam-group 7

4/7/10 4/7/31
no qam-group 7
video service group Configures the video service group for the QAM
<0:4294967295> domain, default 0.
Example:
CASA(conf-qam-domain 56)# video service

group 1
no video service group
show video qam channel stat
Shows the current video QAM channel statistics.
CASA(config)# show video qam channel stat

Session Out QAM Detected Max Sess Sess Input Output
ID ProgrNo Chan Bitrate Bitrate Mode State Packet Packet
--------- ------- ---- -------- ------- ---- ----- ------ ------
Casa Systems CMTS

Video 21-49
video qam-domain
show video qam port stat
Shows the current video QAM port statistics.
CASA(config)# show video qam port stat

Chan Bitrate Bitrate Bitrate (%) Bandwidth Programs Trans
---- -------- --------- ------- ------------- -------- ----
0/0/0 0 38814 0 0 38814 0 0
0/0/1 0 38814 0 0 38814 0 0
show video qam shared-channel stat
Shows the current video QAM shared channel statistics.
CASA(config)# show video qam port stat

Session Out QAM Detected Max Sess Sess Input Output
ID ProgNo Chan Bitrate Bitrate Mode State Packet Packet
--------- ------ ---- ------- ------- ---- ----- ----- ------
show video qam stat
Shows the current video QAM statistics.
CASA(config)# show video qam stat

Port Bitrate Bitrate Bitrate (%) Bandwidth Programs Trans
------- ---------- ---------- ---------- ---- ---------- -------------
10/0 0 1242048 0 0 1242048 0 0
10/1 0 1242048 0 0 1242048 0 0
show video qam-domain
Shows the current video QAM domain configuration.
CASA(config)# show video qam-domain

video qam-domain 1
edis 1
interface video 1
Casa Systems CMTS

video qam-domain
show video channel <qam_if> {psi | stat}
Shows the current video QAM channel configuration.
CASA(config)# show video channel 1/0/0 psi

Qam channel 1/0/0
Total-bandwidth : 29.162000 Mbps
Annex : ITU-T/J.83/C-INV
Frequency : 731000000 Hz
Modulation : 64 QAM
Utilization : 8%
Bitrate : 6.94 Mbps
Packet-rate : 4615 pps
Packet Transmitted : 141696
TSID : 1
Active programs : 1
PAT interval : 98 ms
PAT version : 27
PMT interval : 12 ms
Prog PMT PMT PCR ECM ES ES

Nmbr PID Ver PID PID PID Type
---------- ------- ---------- ------- ------- ---------- -------
1 289 1 288 0 288 Video
287 Audio
Casa Systems CMTS

Video 21-51
video qam export configuration slot

Purpose
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>]
Casa Systems CMTS

Properties
<list> [in-service-state] List of QAM slots, separated by commas (see the

[filename <file>] [srm-num interface qam command). The in-service-state
<1:8>] option includes video channels in shutdown state that
can be enabled with no shutdown later without
having to re-export the configuration. The filename
supports a configurable name for the exported file, up
to 50 characters. Use the Session Resource
Manager (SRM) number if there are multiple SRMs
controlling the QAM 8x96 module. Use the copy
command to copy the file using TFTP to NVRAM.
Example:
CASA# video qam export configuration

slot 0 in-service-state filename EXPORT
srm-num 1
CASA# copy tftp 224.0.0.1 EXPORT nvram
Casa Systems CMTS

Video 21-53
video session
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>
# no video session id <1:9999>

# no video sessions {channel <slot>/<port>/<chan> | port <slot>/<0:7>
| shared-channel <slot>/<s_chan>}
Casa Systems CMTS

video session
Properties
<1:9999> Session index. Creating the video session puts the

command context in video session configuration
mode. Note that exiting video session configuration
mode leaves you in configuration mode. Use the no
form of the command in enable mode, with the id
keyword.
Example:
CASA# video session 1

CASA(conf-video-session 1)# exit
CASA(config)# exit
CASA# no video session id 1
bitrate <bps> Optional bitrate for the session to be created, in bits

per second, default 0. There is no no form of the
command.
Example:
CASA(conf-video-session 1)# bitrate 0
in-program-number Input program ID to be included in the session.

<0:65535> Specify 0 to indicate the first program stream. There
Example:
CASA(conf-video-session 1)#
in-program-number 0
input-port <1:8> Video input port number representing the interface

video index. There is no no form of the command.
Example:
CASA(conf-video-session 1)# input-port

0
Casa Systems CMTS

Video 21-55
video session
Properties
ip-address <ip_addr> Destination group IP address for a multicast session.

[<src_1>] [<src_2>] Optionally include up to three source addresses to
[<src_3>] create a Source Specific Multicast (SSM) session.
The default is Any Source Multicast (ASM). There is
Example:
CASA(conf-video-session 1)# ip-address

227.0.0.1 11.2.7.50
out-program-number Specifies whether a session is a multiplexing (the

{<1:65535> | data} default) or a data session. There is no no form of the
command.
Example:
out-program-number data
pid-remapping Specifies if PIDs are subject to remapping, the

default. The no form of the command can be used.
Example:
pid-remapping
no pid-remapping
qam-channel <slot>/ Output QAM channel, in the form <slot>/<port>/

<port>/<chan> <chan>. (See the channel <num> [description
<text>] property of the interface qam command.)
The qam-channel property creates the video
session. There is no no form of the command.
Example:
CASA(conf-video-session 1)# qam-channel

0
Casa Systems CMTS

video session
Properties
qam-channels {all | Sends a multicast/unicast stream into multiple or all

channel-list video QAM channels for broadcasting emergency
<qam_chan_list> | module programs, with the following options:
<slot> | port <slot>/
<port>} all All video QAM channels on the chassis.
channel-list <qam_chan_list> List of channels
separated by commas or including hyphens for
ranges, as in 0/0/1,0/0/3,0/1/2-0/1/19,0/4/3.
module <slot> All video channels of the mod-
ule.
port <slot>/<port> All video channels on the
port.
Example:
qam-channels all
shared-channel <slot>/ Output shared QAM channel, in the form <slot>/

<s_chan> <s_chan>. (See the shared-channel <id> {annex {A
[symbol rate <1:6952>] [spectral-inversion] | B | C
[spectral-inversion]} | frequency <0 |
47000000:999000000> | interleave <level> |
modulation {128qam | 256qam | 64qam | off} |
shutdown | transport stream <0:65535>} property of
the interface qam command.) There is no no form of
the command.
Example:
shared-channel 0
udp-port <1:65535> Destination UDP port for a unicast session. There is

Example:
CASA(conf-video-session 1)# udp-port 1
Casa Systems CMTS

Video 21-57
video session
Properties
video session [id] <id> Defines another session ID. The no form of the
command can be used if combined with the id
keyword.
Example:
CASA(conf-video-session 1)# video

session 2
CASA(conf-video-session 1)# no video
session id 2
{channel <slot>/<port>/ Used only with the no video sessions command,

<chan> | port <slot>/<0:7> specifying the channel, port, or shared channel to
| shared-channel <slot>/ remove from video sessions.
<s_chan>}
Example:
CASA# no video sessions channel 4/0/0
Examples
The following commands create and delete an SDV/SSM session.

CASA(conf-video-session 1)# in-program-number 0
CASA(conf-video-session 1)# out-program-number 3
CASA(conf-video-session 1)# input-port 6
CASA(conf-video-session 1)# ip-address 227.0.0.1 11.2.7.50
CASA(conf-video-session 1)# qam-channel 4/0/0
video session 00000000000000000001 was created successfully
CASA(conf-video-session 1)# no video session id 1
video session 00000000000000000001 was deleted successfully
The following commands create and delete a VOD session.

CASA(conf-video-session 2)# in-program-number 0
CASA(conf-video-session 2)# out-program-number 4
CASA(conf-video-session 2)# input-port 6
CASA(conf-video-session 2)# ip-address 199.209.6.6
CASA(conf-video-session 2)# udp-port 4453
Casa Systems CMTS

video session
CASA(conf-video-session 2)# qam-channel 4/0/0

video session 00000000000000000002 was created successfully
CASA(conf-video-session 2)# no video session id 2
video session 00000000000000000002 was deleted successfully
show video session <id>
Shows summary information for a particular video session. The ID must be the full
20-character hex value.
CASA(config)# show video session 0000000000010014091f

Created On : 02/24/2015,17:05:54 UTC
StreamId : 3576
Session ID : 0000000000010014091f
Pid-remapping : Yes
Session Mode : Multiplex
Provision Mode : TableMode
Session State : Active
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
PAT ver 0, TSID 1

Program 1, PMT pid 500
PMT ver 0, PCR pid 484
ES-pid ES-type
484 Video
481 Audio
IP Packets in : 6415723
TP Packets in : 42087081
TS Packets in : 41982972
PcrPackets : 972505 NonPcrPackets : 41114576
UnexpectedPackets : 559
Casa Systems CMTS

Video 21-59
video session
ContinuityErrors : 0 SyncLossPackets : 0
PcrIntervalExceeds : 19
Output Qam Channel:

Data State : On
QAM-Channel : 2/0/16
QAM-Domain : 17
PAT ver 4, TSID 20016

Program 1, PMT pid 259
PMT ver 0, PCR pid 258
ES-pid ES-type
258 Video
257 Audio
TP Packets out : 41980566 Under-flow : 0 Over-flow :
0
show video session all summary
Shows summary information for all current video sessions.
CASA(config)# show video session all summary

Video Session Summary for all:
Active : 0 Init : 0 Idle : 0
Off : 0 Blocked : 0 PSI-Ready: 0
UDP : 0 ASM : 0 SSM : 0
Remap : 0 Data : 0 Passthru : 0
Total Sessions : 0
Total Measured Bitrate : 0 bps
show video session all brief [rows <start> [<end>]]
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.
CASA(config)# show video session all brief

SRM Video Dest UDP QAM QAM PID In Out
Session ID ID Intf IpAddress Port Chan Domain Remap ProgNo ProgNo
---------- --- ----- --------- ---- ---- ------ ----- ----- ------
Detected Input Output PSI
Bitrate State State Detected
-------- ----- ------ --------
Casa Systems CMTS

video session
show video session service-group <id>
Shows per service group information for the current video session.
CASA(config)# show video session service-group 1

SRM Video Dest UDP QAM QAM PID In Out
Session ID ID Intf IpAddress Port Chan Domain Remap ProgNo ProgNo
---------- --- ----- --------- ---- ---- ------ ----- ----- ------
Detected Input Output PSI
Bitrate State State Detected
-------- ----- ------ --------
show video input-streams [multicast | unicast] [rows {<start> [<end>] |

count}]
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.
CASA(config)# show video input-streams multicast

Destination Source Input Bitrate Program PMT PCR Total
IP Addr:Port IP Addr Port (mbps) Number PID PID ES PIDs
------------ ------------- --------- ------- ------- -------- --------
230.55.0.2 198.24.25.55 xgige 7/0 3.7480 2 480 481 3
230.55.0.2 198.24.25.55 xgige 7/0 3.7470 2 480 481 3
Contin Sync PcrInter Jitter Replicated

Error Loss Exceeds (ms)
------ ------- ---------- ----------- ----------
0 0 0 0 0
2 0 0 0 0
Casa Systems CMTS

Video 21-61
video signaling-mode
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).
Mode
(config)#
Syntax
video signaling-mode {edis | ngod}
Properties
{edis | ngod} Sets the signaling mode to edis or ngod.
Example:
CASA(config)# video signaling-mode edis
Casa Systems CMTS

video simulcrypt
video simulcrypt
Purpose
The video simulcrypt command sets SimulCrypt properties. Digital Video

Broadcasting (DVB) SimulCrypt is a standard protocol for video encryption services
that are widely supported and implemented in Europe and other regions. DVB
SimulCrypt includes conditional access systems (CAS), CCAP QAMs, and
management equipment to provide program encryption to authorized subscribers. The
C100G CCAP provides the full support for DVB SimulCrypt services, including
software support for data path, signaling and management. The encryption of the
video stream is completed by the C100G CCAP hardware.
The CCAP SimulCrypt system includes the following components:

Conditional Access System (CAS) In the DVB SimulCrypt environment, the
CAS interfaces with CCAP to perform scheduling and key management.
SimulCrypt Synchronizer (SCS) Provides the interface to the CAS and
manages the encryption on the CCAP.
CCAP Edge QAM Module (EQAM) The component communicates with the
control module and performs the encryption through hardware.
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>
Casa Systems CMTS

Video 21-63
video simulcrypt
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
cp <10:86400> For tier-mode encryption, sets the crypto period,

default 30 seconds.
Example:
CASA(config)# video simulcrypt cp 60

CASA(config)# no video simulcrypt cp
CASA(config)# no video simulcrypt
ecmg <name> Sets a unique and descriptive string for each

Entitlement Control Message Generator (ECMG),
maximum 16 characters. The maximum number of
supported ECMGs is eight. The command enters
ECMG configuration mode.
Example:
CASA(config)# video simulcrypt ecmg E1

CASA(config-ecmg E1)# exit
CASA(config)#
no video simulcrypt ecmg E1
Casa Systems CMTS

video simulcrypt
Properties
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.
Example:
CASA(config-ecmg E1)#
access-criteria 0123
ip-address <ip_addr> IPv4 address for the ECMG. There is no no form of

the command.
Example:
priority <1:8> Priority level of the ECMG instance defined by the

system-id and subsystem-id. There is no no form
of the command.
Example:
CASA(config-ecmg E1)# priority 7
protocol-version <2:3> ECMG protocol version, either 2 or 3 (the default).

Example:
protocol-version 2
Casa Systems CMTS

Video 21-65
video simulcrypt
Properties
subsystem-id <0:65535> Subsystem ID for the ECMG under the unique

system-id. There is no no form of the command.
Example:
CASA(config-ecmg E1)# subsystem-id 18
system-id <1:65535> Unique system ID for the ECMG. There is no no form

of the command.
Example:
CASA(config-ecmg E1)# system-id 1898
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:
CASA(config-ecmg E1)# tcp-port 33333
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:
CASA(config)# video simulcrypt

ecmg-retries 5
CASA(config)#
no video simulcrypt ecmg-retries
Casa Systems CMTS

video simulcrypt
Properties
ecmg-timeout <1:60> Sets the timeout value for ECMG communication.

Use the no form of the command to revert the
timeout to the default 3 seconds.
Example:

ecmg-timeout 5
CASA(config)#
no video simulcrypt ecmg-timeout
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:
CASA(config)# video simulcrypt eis

tcp-port 22222
CASA(config)#
no video simulcrypt eis tcp-port
{session-mode | tier-mode} Sets the SimulCrypt encryption mode. By default,

encryption is turned off. When set to tier-mode, all
incoming video streams are encrypted using the
same set of key material.
Note: A system reboot is required after setting

these encryption modes.
Example:

session-mode
tier-mode
CASA(config)# system reboot confirm
Casa Systems CMTS

Video 21-67
Properties
source-interface loopback Sets the SimulCrypt interface to CAS to use the

<0:15> specific loopback interface. By default, this is not
configured.
Example:

CASA(config)# no video simulcrypt
show video simulcrypt ecmg
Shows the Entitlement Control Message Generator (ECMG) configuration.
CASA(config)# show video simulcrypt ecmg

Encryption Period : 30
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
Casa Systems CMTS

video table
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:
mode0 The two-byte UDP port (two-bytes) is masked as 0qqqqqqq qqqppppp,

where the seven least significant bits (LSBs) of the upper byte and the three most
significant bits (MSBs) of the lower byte are combined to form the zero-based
QAM channel number on a given line card slot, and where ppppp is the 1-based
program number in the QAM channel. In this mode, an IP address can cover 1024
QAM channels, and each QAM channel can have 63 programs.
mode1 The two-byte UDP port is preceded by the number 1 to protect the
known UDP port space, as 1qqqqqqq qqqppppp. In this mode, an IP address can
cover 1024 QAM channels, and each QAM channel can have 31 programs. This
leaves the lower 32K ports unused for video, as many of the UDP ports are
reserved for well-known UDP ports.
mode2 Only the mask is different: 1qqqqqqq qqqpppp0. In this mode, an IP
address can cover 1024 QAM channels, and each QAM channel can have 15
programs.
mode 3 The applied mask is qqqqqqqq pppppppp. In this mode, an IP address
can cover 256 QAM channels, and each QAM channel can have 255 programs.
Mode
(config)#
Syntax
video table {mode0 | mode1 | mode2 | mode3}
no video table
Casa Systems CMTS

Video 21-69
video table
Properties
{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:
CASA(config)# video table mode1

CASA(config)# no video table
Casa Systems CMTS

video unicast-session-loss-timeout
video unicast-session-loss-timeout
Purpose
The video unicast-session-loss-timeout command sets the time to elapse before

detecting unicast VOD session loss.
Mode
(config)#
Syntax
video unicast-session-loss-timeout {<1:172800> | default}
Properties
{<1:172800> | default} Time to elapse before detecting unicast VOD session

loss, in seconds. The alternative default setting
accepts the default value of 60 seconds.
Example:
CASA(config)# video
unicast-session-loss-timeout 60
show run | inc video
Shows all lines in the running configuration with video in them.
CASA(config)# show run | inc video

video table mode1
video clk-drift-corr
!video edis configurations begin
Casa Systems CMTS

Video 21-71
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
interface video 1
video qam-domain 56
show video all stat
Shows all video channel statistics.
CASA(config)# show video all stat

Channel ID Total Packets Data Rate Over Flow Under Flow Dropped Packets
---------- ---- ------ -------- --------- --------- --------------
show video global config
Shows the video global configuration.
CASA(config)# show video global config

no video edis virtual-qam-mode
video signaling-mode edis
video dejitter-interval 200
video pat-interval 250
video pmt-interval 250
video unicast-session-loss-timeout 60
video multicast-session-loss-timeout 60
video ngod control-source bind
video pid-remapping-mode auto
video table mode1
video error-window 10
video error-threshold 5
video pktloss-window 1
video clk-drift-correction enabled
no video logging edis-raw
no video logging edis-text
no video logging edis-ping
video logging ngod-raw
no video logging ngod-text
video logging errors
video logging srm-errors
Casa Systems CMTS

100 Old River Road
Suite 100
Andover, MA 01810
USA
978-688-6706
CMTS
RF Cable Configuration Guide and
Command Reference
2015 Casa Systems, Inc.
All rights reserved.
DOC-3022-01
Document Revision 01.00.05

April 2015
Printed in United States of America

CMTS RF Config - GD - CMD - Reference - R6.5.2 - 04 - 10 - 2015 PDF

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

CMTS RF Config - GD - CMD - Reference - R6.5.2 - 04 - 10 - 2015 PDF

Cargado por

Copyright:

Formatos disponibles

CMTS

RF Cable Configuration Guide

For Casa Software Releases to 6.5.2

Chapter 1. RF cable operations overview

CMTS installation in the network topology ........................................................ 1-2 .

Cable modem initialization and learning ........................................................... 1-6 .

Cable modem initial ranging and registration .................................................... 1-6 .

Cable modem provisioning and configuration ................................................... 1-7 .

Cable modem power considerations ................................................................. 1-9 .

Upstream channel descriptors and MAPs ......................................................... 1-9 .

UCD and MAP operations ................................................................................. 1-9 .

Channel bonding and service group operations ............................................. 1-13 .

Physical fiber node vs. DOCSIS terminology .................................................. 1-14 .

Load balancing CMTS traffic ........................................................................... 1-14 .

Terminology covered in this chapter ............................................................... 1-18 .

Configuration examples .................................................................................. 1-23 .

Chapter 2. Baseline Privacy Interface

cable privacy ............................................................................................... 2-3

cable sa-des-tlvlen-2 ................................................................................. 2-10 .

privacy hotlist ............................................................................................ 2-11

shared-secondary-secret .......................................................................... 2-13 .

shared-secret ............................................................................................ 2-14 .

Casa Systems CMTS

Chapter 3. Cable commands

cable admission-control .............................................................................. 3-5 .

cable arp filter ............................................................................................. 3-8

cable dhcp filter ........................................................................................... 3-9.

cable dhcp-leasequery filter ...................................................................... 3-10 .

cable dhcpv6-leasequery filter .................................................................. 3-12 .

cable diaglog ............................................................................................. 3-14 .

cable dsx authorization ............................................................................. 3-16 .

cable dynamic-service-flow ....................................................................... 3-17 .

cable ecn 770 ............................................................................................ 3-19 .

cable event ................................................................................................ 3-20.

cable flap-list ............................................................................................. 3-26

cable host authorization ............................................................................ 3-30 .

cable icmp filter ......................................................................................... 3-31 .

cable igmp filter ......................................................................................... 3-32 .

cable igmp static-group ............................................................................. 3-33 .

cable igmp vrf ............................................................................................ 3-36 .

cable mdd ................................................................................................. 3-38 .

cable mirror ............................................................................................... 3-41.

cable modem ............................................................................................ 3-42 .

cable monitor-period ................................................................................. 3-43 .

cable partial-service .................................................................................. 3-44 .

cable privacy ............................................................................................. 3-47 .

cable proxy-arp unknown .......................................................................... 3-48 .

cable qos ................................................................................................... 3-49

cable rcp-select ......................................................................................... 3-55 .

cable sa-des-tlvlen-2 ................................................................................. 3-56 .

cable sec ................................................................................................... 3-57

cable service attribute withold-TLVs peak-rate ......................................... 3-64 .

cable service-class .................................................................................... 3-65 .

cable service-flow active-timeout .............................................................. 3-76 .

Casa Systems CMTS

cable service-type-id ..................................................................................3-77 .

cable spectrum ..........................................................................................3-78 .

cable subscriber over-consume trap .........................................................3-80 .

cable tcc us-bonding-disable .....................................................................3-81 .

cable traffic-policy ......................................................................................3-82 .

cable upstream ..........................................................................................3-88 .

default cable modem vendor .....................................................................3-90 .

Chapter 4. Cable modem commands