New and Changed Commands Reference

debug cable-modem mac messages dynsrv

ip address dhcp

ip http cable-monitor

show controllers cable-modem qos

New and Changed Commands Reference

This appendix describes the commands that have been added to the Cisco uBR910 series DSU in the Cisco IOS 12.1 T and other early deployment software releases. These commands are in addition to the commands that are supported in Cisco IOS Release 12.1(1). For a description of the commands in these previous releases, see the command reference documentation for Cisco IOS Release 12.1, available on CCO and the Documentation CD-ROM.

Note To locate the documentation for the "related commands" mentioned in this chapter, use the Cisco IOS Release 12.1 command reference master index that is available on CCO and the Documentation CD-ROM. You can also search for the specific command online.

The commands in this appendix are listed alphabetically:

debug cable-modem mac messages dynsrv ---Displays debug messages about the dynamic service MAC-layer messages that are sent and received using the dynamic SID feature.
ip address dhcp---Specifies that the cable interface obtains its IP address from a DHCP server during power-on provisioning.
ip http cable-monitor ---Enables the Cable Monitor, a web-based diagnostic tool.
show controllers cable-modem qos---Displays the Quality of Service (QoS) configuration for the Cisco uBR910 series DSU.

debug cable-modem mac messages dynsrv

To display debug messages for the dynamic service MAC-layer messages that are generated using the dynamic SID feature, use the debug cable-modem mac messages dynsrv EXEC command. To turn off debug messages related to the dynamic service MAC-layer messages, use the no debug cable-modem mac messages dynsrv EXEC command.

debug cable-modem mac messages dynsrv

no debug cable-modem mac messages dynsrv

Syntax Description

This command has no keywords or arguments.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release Modification

12.0(7)XR and 12.1(1)T

This command was introduced for the Cisco uBR924 cable access router.

12.1(3)T

This command was introduced for the Cisco uBR910 series DSU.

Release	Modification
12.0(7)XR and 12.1(1)T	This command was introduced for the Cisco uBR924 cable access router.
12.1(3)T	This command was introduced for the Cisco uBR910 series DSU.

Usage Guidelines

This command begins the display of debug messages that show the dynamic service MAC messages that are generated using the dynamic SID feature. Dynamic SIDs use the following DOCSIS MAC-layer messages to create a new SID for on demand traffic and to delete it when no longer needed:

DSA-REQ---Dynamic Service Addition Request, sent to establish a new service flow.
DSA-RSP---Dynamic Service Addition Response, sent in reply to DSA-REQ to confirm or deny the new service flow.
DSA-ACK---Dynamic Service Addition Acknowledge, sent in reply to DSA-RSP to acknowledge the creation of the service flow.
DSD-REQ---Dynamic Service Deletion Request, sent to delete an existing service flow when it is no longer needed (for example, when a voice call has terminated).
DSD-RSP---Dynamic Service Deletion Response, sent in response to DSD-REQ to delete an existing service flow.

Note Dynamic Services are described in the DOCSIS 1.1 specification (SP-RFIv1.1-I03-991105 or later revision).

Examples

The following example enables the display of debug messages related to dynamic service operations:

ubr910# debug cable-modem mac messages dynsrv 
ubr910#

The following example turns off the display of debug messages related to dynamic service operations:

ubr910# no debug cable-modem mac messages dynsrv 
ubr910#

The following are examples of the types of debug messages that are displayed when a voice call is made. This example shows that dynamic SID 52 is created for this particular call.

DSA-REQ TLV's: 
--------------
US Flow Scheduler(24):
 Unsolicited Grant Size               - 19:2:89
 Nominal Grant Interval               - 20:4:20000
Created New Dynamic Service State, Transaction_id = 3
 
DSA-REQ MESSAGE TLVS
--------------------
C2000026 00010010  07DF6854 00507366
23270014 00000301  0F000003 180A1302
00591404 00004E20  
 
   597.721 CMAC_LOG_DSA_REQ_MESSAGE_EVENT 
 
DSA-REQ MESSAGE
---------------
  FRAME HEADER
    FC                        - 0xC2 == MAC Management
    MAC_PARM                  - 0x00
    LEN                       - 0x26
  MAC MANAGEMENT MESSAGE HEADER
    DA                        - 0010.abcd.ef00
    SA                        - 0050.abcd.ef00
    msg LEN                   - 14  
    DSAP                      - 0
    SSAP                      - 0
    control                   - 03
    version                   - 01
    type                      - 0F == DSA-REQ
    RSVD                      - 0
  Transaction ID              - 3
 
   597.725 CMAC_LOG_DSA_RSP_MSG_RCVD 
 
DSA-RSP MESSAGE
---------------
  FRAME HEADER
    FC                        - 0xC2 == MAC Management
    MAC_PARM                  - 0x00
    LEN                       - 0x26
  MAC MANAGEMENT MESSAGE HEADER
    DA                        - 0050.abcd.ef00
    SA                        - 0010.abcd.ef00
    msg LEN                   - 14  
    DSAP                      - 0
    SSAP                      - 0
    control                   - 03
    version                   - 01
    type                      - 10 == DSA-RSP
    RSVD                      - 0
  Transaction ID              - 3
  Response                    - 0 == DSA-RSP-OK
  SID                         - 52
 
Adding sid = 52 to sid_index = 1
   597.729 CMAC_LOG_QOS_ADD_FLOW_SID                   52

Related Commands

Command Description

debug cable-modem mac messages

Displays debug messages for other types of MAC-layer messages, including MAP messages, upstream request messages, and sync messages.

show controllers cable-modem number qos

Displays current statistics for each primary, secondary, and dynamic SIDs.

Command	Description
debug cable-modem mac messages	Displays debug messages for other types of MAC-layer messages, including MAP messages, upstream request messages, and sync messages.
show controllers cable-modem number qos	Displays current statistics for each primary, secondary, and dynamic SIDs.

Caution The debug commands are primarily intended for use in controlled test and troubleshooting situations with a limited volume of traffic. You should use caution when enabling debug messages because sending these messages to the console consumes system resources. Turning on too many types of debug messages can adversely affect the router's network performance, depending on what messages are being displayed and the type of traffic that is occurring.

ip address dhcp

To configure the Cisco uBR910 series DSU's cable interface so that it obtains its IP address from a DHCP server at power-on provisioning, use the ip address dhcp command in interface configuration mode.

ip address dhcp

Syntax Description

This command has no arguments or keywords.

Defaults

The Cisco uBR910 series DSU defaults to obtaining the cable interface's IP address from a DHCP server. This behavior is required by the DOCSIS specification and cannot be overridden.

Command Modes

Interface configuration

Command History

Release Modification

12.1(3)T

This command was introduced for the Cisco uBR924 router and Cisco uBR910 series DSU.

Release	Modification
12.1(3)T	This command was introduced for the Cisco uBR924 router and Cisco uBR910 series DSU.

Usage Guidelines

This command is the default configuration for the router's cable interface. Because DOCSIS specifies that the cable interface obtain its IP address from a DHCP server available through the cable interface, this command cannot be turned off or overridden.

Examples

The following example configures the cable interface so that it obtains its IP address from a DHCP server during power-on provisioning:

uBR910(config)# interface cable0 
uBR910(config-if)# ip address dhcp 
uBR910(config-if)# exit 
uBR910(config)#

Related Commands

Command Description

ip address negotiated

Configures the serial interface to obtain its IP address through the PPP/IPCP address negotiation.

Command	Description
ip address negotiated	Configures the serial interface to obtain its IP address through the PPP/IPCP address negotiation.

ip http cable-monitor

To enable the Cisco uBR910 series DSU's onboard Cable Monitor web server, use the ip http cable-monitor command in global configuration mode. To disable the Cable Monitor and turn off all access to the onboard Cisco web server, use the no ip http cable-monitor command in global configuration mode.

ip http cable-monitor {basic | advance} [URL-IP-address URL-mask]

no ip http cable-monitor

Syntax Description

basic

Displays only the basic status and performance pages.

advance

Displays all status and diagnostic pages.

Note The Cable Monitor should not be used in advanced mode without first implementing a secure password strategy on the CiscoCisco uBR910 series DSU. Enabling the Cable Monitor in advanced mode without setting an encrypted enabled password could provide information that would allow remote users to change the router's configuration.

URL-IP-address

Specifies the IP address for the Cable Monitor. This parameter, along with the URL-mask parameter, also defines the network that provides the IP address pool used by the temporary DHCP server when the cable interface goes down.

URL-mask

Specifies the subnet mask for the Cable Monitor. This parameter, along with the URL-IP-address parameter, also defines the network that provides the IP address pool used by the temporary DHCP server when the cable interface goes down.

Defaults

For URL-IP-address, 192.168.100.1

For URL-mask, 255.255.255.0

Command Modes

Global configuration

Command History

Release Modification

12.1(1)T

This command was introduced for the Cisco uBR924 cable access router.

12.1(3)T

This command is introduced for the Cisco uBR910 series DSU.

Release	Modification
12.1(1)T	This command was introduced for the Cisco uBR924 cable access router.
12.1(3)T	This command is introduced for the Cisco uBR910 series DSU.

Usage Guidelines

This command enables the Cable Monitor, an onboard web server that displays current status, troubleshooting, and performance information. The Cable Monitor can be accessed in two ways:

When the Cisco uBR910 series DSU has established connectivity with the CMTS over the cable interface, a service technician can use a web browser to remotely access the router and display the desired information.
When the cable network is not operational and the Cisco uBR910 series DSU is not online, the subscriber can access the tool with a PC connected to the LAN. Technicians can then prompt the user for the information they need to determine the source of the problem.

Enabling the Cable Monitor also enables the Cisco web server that is onboard the Cisco uBR910 series DSU (which is the equivalent to giving the ip http server command). However, when the Cable Monitor is enabled, all other access, including CLI access, to the onboard web server is automatically disabled.

Disabling the Cable Monitor using the no ip http cable-monitor command also automatically disables the Cisco web server (which is the equivalent of giving the no ip http server command).

The URL-IP-address and URL-mask parameters also specify that the class C private network 192.168.100.0 is the default address pool for the temporary DHCP server that activates when the cable interface goes down.

For more detailed information on using the Cable Monitor, see "Using the Cable Monitor Tool" in the Cisco uBR910 Series Software Configuration Guide, available on CCO and the Documentation CD-ROM.

Examples

The following example enables the Cable Monitor for advanced mode, in which all status and diagnostic pages are displayed:

ubr910(config)# ip http cable-monitor advance 
ubr910(config)#

The following example disables both the Cable Monitor and the Cisco web server, preventing all web server access to the Cisco uBR910 series DSU:

ubr910(config)# no ip http cable-monitor 
ubr910(config)#

Related Commands

Command Description

ip http port

Configures the TCP port number for the router's HTTP web server (the default is the well-known web server port of 80).

ip http server

Enables and disables the router's HTTP web server.

Command	Description
ip http port	Configures the TCP port number for the router's HTTP web server (the default is the well-known web server port of 80).
ip http server	Enables and disables the router's HTTP web server.

Note The ip http command also supports two options, access-class and authentication, that should not be used when the Cable Monitor is enabled.

show controllers cable-modem qos

To display detailed information about the Quality of Service (QoS) configuration for the Cisco uBR910 series DSU, use the show controllers cable-modem qos command in privileged EXEC mode.

show controllers cable-modem number qos

Syntax Description

number

Cable interface number inside the Cisco uBR910 series DSU (should always be 0 to indicate the first and only cable interface).

number	Cable interface number inside the Cisco uBR910 series DSU (should always be 0 to indicate the first and only cable interface).

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release Modification

12.1(3)T

This command was introduced for the Cisco uBR910 series DSU.

Release	Modification
12.1(3)T	This command was introduced for the Cisco uBR910 series DSU.

Usage Guidelines

This command displays the four possible stream queues, the SID associated with each queue (if the queue is currently in use), and whether the SID is the primary SID, a secondary (static) SID, or a dynamic (on demand) SID. The display also shows the packets and bytes that have been transmitted and received on each stream.

Examples

The following example displays the current QoS statistics for each of the router's four queues:

uBR910# show controllers cable-modem 0 qos
 
Queue   SID     SID     SFID    TX      TX              RX      RX
                Type            Pkts    Bytes           Pkts    Bytes
 
0       2       Primary 0       11377   2721985         12320   983969
1       52      Dynamic 52      116     13608           105     14300
2       0       NA      0       0       0               0       0
3       0       NA      0       0       0               0       0
 
ubr910#

Table 1 describes significant fields shown in this display.

Table 1: show controllers cable-modem qos Field Descriptions

Field Description

Queue

One of the four possible service flow queues that exist in the Cisco uBR910 series DSU.

SID

Service Identifier, a 14-bit integer assigned by the CMTS to each active upstream service flow.

SID Type

The type of SID:

Primary---The service flow used for best-effort data traffic and MAC maintenance messages.

Secondary---Secondary static service flows that are created at power-on provisioning for voice calls when dynamic SIDs are not active.

Dynamic---Secondary service flows that are created for on demand voice calls when using dynamic SIDs.

SFID

Service Flow Identifier, a 32-bit integer assigned by the CMTS to each service flow on the Cisco uBR910 series DSU.

TX Pkts

The number of packets the Cisco uBR910 series DSU has transmitted on this service flow.

TX Bytes

The number of bytes the Cisco uBR910 series DSU has transmitted on this service flow.

RX Pkts

The number of packets the Cisco uBR910 series DSU has received on this service flow.

RX Bytes

The number of bytes the Cisco uBR910 series DSU has received on this service flow.

Field	Description
Queue	One of the four possible service flow queues that exist in the Cisco uBR910 series DSU.
SID	Service Identifier, a 14-bit integer assigned by the CMTS to each active upstream service flow.
SID Type	The type of SID: Primary---The service flow used for best-effort data traffic and MAC maintenance messages. Secondary---Secondary static service flows that are created at power-on provisioning for voice calls when dynamic SIDs are not active. Dynamic---Secondary service flows that are created for on demand voice calls when using dynamic SIDs.
SFID	Service Flow Identifier, a 32-bit integer assigned by the CMTS to each service flow on the Cisco uBR910 series DSU.
TX Pkts	The number of packets the Cisco uBR910 series DSU has transmitted on this service flow.
TX Bytes	The number of bytes the Cisco uBR910 series DSU has transmitted on this service flow.
RX Pkts	The number of packets the Cisco uBR910 series DSU has received on this service flow.
RX Bytes	The number of bytes the Cisco uBR910 series DSU has received on this service flow.

Related Commands

Command Description

show controllers cable-modem number mac

Displays MAC-layer statistics showing the MAC error log, the other MAC log data, the number of MAC-layer resets, and the current MAC state.

Table of Contents