PacketCable Voice Technology Commands
This chapter describes the command-line interface (CLI) commands that you can use to manage and monitor the PacketCable voice technology on the Broadband Access Center (BAC) Device Provisioning Engine (DPE).
Note Before using any debug command, ensure that DPE debugging is enabled. To enable this function, run the debug on command.
The commands described in this chapter are:
•debug dpe
–debug dpe netsnmp
–debug dpe registration
–debug dpe registration-detail
–debug dpe snmp
•packetcable enable
•no packetcable
•packetcable registration encryption
•no packetcable registration encryption
•packetcable registration kdc-service-key
•packetcable registration policy-privacy
•packetcable snmp key-material
•no packetcable snmp key-material
•packetcable snmp timeout
•show packetcable snmp log
debug dpe
Use this general command form to debug the PacketCable technology on the DPE.
Note If you run the following commands on an unlicensed DPE, a message similar to this one appears:
This DPE is not licensed. Your request cannot be serviced.
Please check with your system administrator for DPE licenses.
Table 4-1 describes the specific commands you can use to debug the PacketCable services on the DPE.
Table 4-1 List of debug dpe Commands for PacketCable Technology
|
|
|
|
|
debug dpe netsnmp no debug dpe netsnmp |
Enables detailed debugging of the PacketCable NetSNMP service on the DPE. To disable detailed debugging of the PacketCable NetSNMP service, use the no form of this command. |
P |
P |
dpe# no debug dpe netsnmp
|
debug dpe registration no debug dpe registration |
Enables debugging of the PacketCable secure registration service on the DPE. To disable debugging of the PacketCable secure registration service, use the no form of this command. |
P |
P |
dpe# debug dpe registration
dpe# no debug dpe registration
|
debug dpe registration-detail no debug dpe registration-detail |
Enables the PacketCable registration detail category for debug messages. To disable debugging of the PacketCable secure registration service, use the no form of this command. |
P |
P |
dpe# debug dpe registration-detail
dpe# no debug dpe registration-detail
|
debug dpe snmp no debug dpe snmp |
Enables detailed debugging of the PacketCable SNMP service on the DPE. To disable detailed debugging of the PacketCable SNMP service, use the no form of this command. |
P |
P |
|
packetcable enable
Use this command to enable PacketCable services on the DPE. To enable PacketCable, you must:
•Configure at least one interface with a fully qualified domain name (FQDN) and enable provisioning.
•Set the service key for the Key Distribution Center (KDC). See packetcable registration kdc-service-key.
After you use this command, run the dpe reload command so that the changes take effect. See dpe reload, page 3-8.
To disable PacketCable services, use the no form of this command. See no packetcable.
Usage Guidelines
Use this command on both hardware and Solaris DPEs.
Syntax Description
No keywords or arguments.
Examples
% OK (Requires DPE restart "> dpe reload")
no packetcable
Use this command to disable PacketCable services on the DPE.
After you use this command, run the dpe reload command so that the changes take effect. See dpe reload, page 3-8.
To enable PacketCable services, see packetcable enable.
Usage Guidelines
Use this command on both hardware and Solaris DPEs.
Syntax Description
No keywords or arguments.
Examples
% OK (Requires DPE restart "> dpe reload")
packetcable registration encryption
Use this command to enable encryption of MTA configuration files.
To disable encryption on MTA configuration files, use the no form of this command. See no packetcable registration encryption.
Usage Guidelines
Use this command on both hardware and Solaris DPEs.
Syntax Description
No keywords or arguments.
Examples
dpe# packetcable registration encryption
no packetcable registration encryption
Use this command to disable encryption on MTA configuration files.
To enable encryption of MTA configuration files, see packetcable registration encryption.
Usage Guidelines
Use this command on both hardware and Solaris DPEs.
Syntax Description
No keywords or arguments.
Syntax Description
dpe# no packetcable registration encryption
packetcable registration kdc-service-key
Use this command to generate and set a security key for communication between the KDC and DPE.
After you use this command, run the dpe reload command so that the changes take effect. See dpe reload, page 3-8.
Usage Guidelines
Although this command is used for both hardware and Solaris DPEs, on the hardware DPE, it is used only in the console mode.
Syntax Description
packetcable registration kdc-service-key password
password—Identifies the password, which must be from 6 to 20 characters.
Note The password that you enter must match the password that you enter while configuring the KDC using the KeyGen tool. Refer to the Cisco Broadband Access Center Administrator Guide, 2.7.1, for information on how to use the KeyGen tool.
You can verify the service key that this command creates by viewing the dpe.properties file, which resides in the BPR_HOME/dpe/conf directory. Look for the value of the /pktcbl/regsvr/KDCServiceKey
parameter.
Note You can view the dpe.properties file only on a Solaris DPE.
For example:
/pktcbl/regsvr/KDCServiceKey=2e:d5:ef:e9:5a:4e:d7:06:67:dc:65:ac:bb:89:e3:2c:bb:
The output of this example has been trimmed.
Examples
dpe# packetcable registration kdc-service-key ciscosystems101
% OK (Requires DPE restart "> dpe reload")
packetcable registration policy-privacy
Use this command to set the customer policy regarding enforcement of SNMP privacy in MTA communications.
Entering a value of zero lets the MTA choose the SNMPv3 privacy option. Entering a nonzero value means that the provisioning server sets the privacy option in SNMPv3 to a specific protocol, which is currently limited to DES.
After you use this command, run the dpe reload command so that the changes take effect. See dpe reload, page 3-8.
Usage Guidelines
Use this command on both hardware and Solaris DPEs.
Syntax Description
packetcable registration policy-privacy value
value—Enter any zero or nonzero value to identify the customer policy. Values include:
•0—Indicates that the MTA selects the privacy option with Privacy being optional.
•1—Indicates that the policy is enforced, causing all MTAs to use Privacy. If Privacy is not used, the MTA does not start.
•32—Indicates that there is no Privacy.
•33—Indicates that Privacy is enabled for all devices.
Defaults
The default value to set the customer policy regarding enforcement of SNMP privacy is 1.
Examples
dpe# packetcable registration policy-privacy 1
% OK (Requires DPE restart "> dpe reload">
packetcable snmp key-material
Use this command to generate and set a security key on the DPE to permit secure communication with the RDU. The secure communication channel with the RDU is used for PacketCable SNMPv3 cloning support only.
Note You must set the same security key on the RDU using the generateSharedSecret.sh command-line tool, which is located in the BPR_HOME/rdu/bin directory.
After you use this command, run the dpe reload command so that the changes take effect. See dpe reload, page 3-8.
To clear the SNMPv3 service key and turn off the SNMPv3 cloning support, use the no form of this command. See no packetcable snmp key-material.
Usage Guidelines
Although this command is used for both hardware and Solaris DPEs, on the hardware DPE, it is used only in the console mode.
Syntax Description
packetcable snmp key-material password
password—Identifies the password that you create, which must be from 6 to 20 characters.
Examples
dpe# packetcable snmp key-material ciscosystems101
% OK (Requires DPE restart "> dpe reload")
no packetcable snmp key-material
Use this command to clear the SNMPv3 service key and turn off SNMPv3 cloning support. For security reasons, this command is not available during a Telnet session and can be used only via the console mode.
After you use this command, run the dpe reload command so that the changes take effect. See dpe reload, page 3-8.
To generate and set a security key on the DPE for secure communication with the RDU, see packetcable snmp key-material.
Usage Guidelines
Use this command on both hardware and Solaris DPEs.
Syntax Description
No keywords or arguments.
Examples
dpe# no packetcable snmp key-material
% OK (Requires DPE restart "> dpe reload")
packetcable snmp timeout
Use this command to dynamically set the length of time that the PacketCable SNMP service waits for a response to any SNMP `Set' operation.
Usage Guidelines
Use this command on both hardware and Solaris DPEs.
Syntax Description
packetcable snmp timeout time
time—Indicates the length of time that the PacketCable SNMP service waits, in seconds.
Defaults
The default maximum length of time that the PacketCable SNMP service waits for a response to an SNMP `Set' operation is 10 seconds.
Examples
dpe# packetcable snmp timeout 15
show packetcable snmp log
Use this command to show recent log entries for the PacketCable SNMP provisioning service, which includes information about the general PacketCable SNMP provisioning service and the logging of any MTA provisioning errors or severe problems.
Usage Guidelines
Use this command on both hardware and Solaris DPEs.
Syntax Description
show packetcable snmp log [last 1..9999 | run]
•last 1..9999—Identifies the specified number of recent log entries from the PacketCable SNMP log file that you want to display. This keyword is optional.
•run—Displays all log messages from the PacketCable SNMP log file. The command continues to run until you press Enter. This keyword is optional.
Examples
Example 1
dpe# show packetcable snmp log
Error [SS_MSG] 2006-12-18 14:30:44,000 - SNMP Service Tracing Set To 400
Note The output presented in this example has been trimmed.
Example 2
dpe# show packetcable snmp log last 1
Error [SS_MSG] 2006-12-18 14:35:44,000 - SNMP Service Tracing Set To 800
Example 3
dpe # show packetcable snmp log run
2006 12 17 11:43:43 CDT: %CSRC-5: Notification DPE: Device Provisioning Engine starting up
2006 12 17 11:43:44 CDT: %CSRC-6: Info DPE: Attempt to connect to RDU dpe failed;
2006 12 17 11:43:44 CDT: %CSRC-6: Info TFTP: Ready to service requests