The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter describes the command-line interface (CLI) commands that you can use to manage and monitor the PacketCable voice technology on the Prime Cable Provisioning Device Provisioning Engine (DPE).
The commands described in this chapter are:
Use the debug service packetcable command to debug the PacketCable technology service on the DPE. Table 4-1 lists the keywords that you can use with this command. The PacketCable service on the DPE features one instance of the service, which you can configure to suit your requirements.
Before using any debug command, you must enable debugging by running the debug on command. 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.
Use the service packetcable enable command to enable the PacketCable service on the DPE.
To enable PacketCable, you must:
If you do not configure an interface with an FQDN and enable provisioning on that interface, the following error appears:
Enabling packetcable requires at least one interface must have an FQDN configured and provisioning enabled
Note To enable PacketCable the kdc-service key must match the dpe-service key.
If you do not set a service key for the KDC, the following error appears:
After you use this command, run the dpe reload command so that the changes take effect. See dpe reload.
Use the service packetcable registration encryption enable command to enable encryption of MTA configuration files.
To disable encryption of MTA configuration files, use the no form of this command. See no service packetcable registration encryption.
Encryption of MTA configuration files is by default disabled.
Use the no service packetcable registration encryption command to disable encryption of MTA configuration files.
To enable encryption of MTA configuration files, see service packetcable registration encryption enable.
Encryption of MTA configuration files is by default disabled.
Use the service packetcable registration kdc-service-key command to generate and set a security key for communication between the KDC and a DPE.
After you use this command, run the dpe reload command so that the changes take effect. See dpe reload.
service packetcable 1..1 registration kdc-service-key password
Note The password that you enter must match the password that you enter while configuring the KDC using the KeyGen tool. See the Cisco Prime Cable Provisioning 5.3 User Guide 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 following parameter: /pktcbl/regsvr/KDCServiceKey
.
Use the service packetcable registration policy-privacy command to set the customer policy on enforcing 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.
service packetcable 1..1 registration policy-privacy value
– 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.
This result occurs when you enforce SNMP privacy, using the default value of 1, causing all MTAs to use Privacy.
Use the service packetcable snmp key-material 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 both the DPE and the RDU. Use the generateSharedSecret.sh command-line tool, 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.
To clear the SNMPv3 service key and turn off the SNMPv3 cloning support, use the no form of this command. See no service packetcable snmp key-material.
Generating a security key for secure communication with the RDU is by default disabled.
Use the no service packetcable snmp key-material command to clear the SNMPv3 service key and turn off SNMPv3 cloning support.
After you use this command, run the dpe reload command so that the changes take effect. See dpe reload.
To generate and set a security key on the DPE for secure communication with the RDU, see service packetcable snmp key-material.
Generating a security key for secure communication with the RDU is by default disabled.
Use the service packetcable snmp timeout command to dynamically set the length of time that the PacketCable SNMP service waits for a response to any SNMP ‘Set’ operation.
The default maximum length of time that the PacketCable SNMP service waits for a response to an SNMP ‘Set’ operation is 10 seconds.
Use the service packetcable show snmp log 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.
service packetcable 1..1 show snmp log [ last 1..9999 | run ]
This result occurs when you use the service packetcable show snmp log command to display all log entries for the PacketCable SNMP service.
Note The output presented in this example is trimmed.
This result occurs when you use the service packetcable show snmp log last command to display a specific number of recent log entries; in this example, the last 5 entries.
This result occurs when you use the service packetcable show snmp log run command to display a running PacketCable SNMP log. The command continues to run until you press Enter.