2-163
Cisco Broadband Cable Command Reference Guide
OL-1581-08
Chapter 2 Cisco CMTS Configuration Commands
cable modem remote-query
To use the remote-query feature, you must configure the CM and Cisco CMTS as follows:
•
Configure a read-only SNMP community string on the CM for use with the remote-query feature.
This typically should be a separate community string from the read-write string used to remotely
monitor and configure the CM.
•
Configure a matching community string on the Cisco CMTS using the
snmp-server community
community-string
and
snmp-server manager
commands.
•
Enable the remote-query feature on the Cisco CMTS with the
cable modem remote-query
polling-
delay community-string
command. The
polling-delay
should be chosen so that the statistics can be
obtained in a timely manner without seriously impacting system performance. Cisco recommends
initially setting the
polling-delay
to 30 seconds and adjusting that time period as needed.
Note
The
polling-delay
time period determines only how long the Cisco CMTS waits after
completing one polling cycle before beginning a new polling cycle. It does not indicate how
long the Cisco CMTS spends in each polling cycle, which depends on the number of cable
modems being polled. To calculate the approximate time for a polling cycle, assume 4 to 5
CMs per second (100 to 200 milliseconds per CM). Also take into account the possibility
that one or more cable modems might not respond, with an approximate timeout period of
90 seconds.
You must specify matching community strings for the CM, the
snmp-server community
community-
string
command, and the
cable modem remote-query
command.
Note
You can reissue the
cable modem remote-query
command to change the polling interval at any time,
and the change becomes effective immediately. However, to change the SNMP community string, you
must first disable remote polling with the
no snmp manager
and
no cable modem remote-query
commands. Then reconfigure the new community string with the
snmp-server community
community-
string
,
snmp-server manager
, and
cable modem remote-query
commands.
Tip
After enabling the remote-query feature, you can display the collected statistics with the
show cable
modem remote-query
command. You can also display these statistics by querying the attributes in the
CISCO-DOCS-REMOTE-QUERY-MIB
MIB.
Examples
The following example illustrates how to set the polling interval to 5 seconds and the SNMP community
string to
private
:
Router#
configure terminal
Router(config)#
cable modem remote-query 5 private
Router(config)#
snmp-server community private
Router(config)#
snmp-server manager
Router(config)#
The following example demonstrates how to change the remote-query configuration, by first deleting the
existing configuration and then giving the new configuration:
Router#
configure terminal
Router(config)#
no cable modem remote-query
Router(config)#
no snmp-server manager
Router(config)#
cable modem remote-query 10 public
Router(config)#
snmp-server community public
Router(config)#
snmp-server manager
Router(config)#