- Cisco Prime Cable Provisioning DPE CLI Reference, 6.3
- Cisco Prime Cable Provisioning DPE CLI Reference, 6.3
- Preface
- Introduction to the Prime Cable Provisioning CLI
- System Commands
- DPE Configuration Commands
- Packet Cable Voice Technology Commands
- SNMP Agent Commands
- Log System Management Commands
- Support and Troubleshooting Commands
- Event System Management Commands
- Hashed SNMP Community String Based on Device IP Address
- Glossary
- Index
- debug service packetcable
- service packetcable enable
- no service packetcable en able
- service packetcable registration encryption enable
- no service packetcable registration encryption
- service packetcable registration kdc-service-key
- service packetcable registration policy-privacy
- service packetcable snmp key-material
- no service packetcable snmp key-material
- service packetcable snmp timeout
- service packetcable show snmp log
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 Prime Cable Provisioning Device Provisioning Engine (DPE).
The commands described in this chapter are:
debug service packetcable
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.
Enabling debug logging may have a severe impact on DPE performance. Do not leave the DPE running with debug turned on for an extended period of time.
service packetcable enable
Use the service packetcable enable command to enable the PacketCable service on the DPE.
To enable PacketCable, you must:
- Configure at least one interface with a fully qualified domain name (FQDN) and enable provisioning. See interface ip provisioning fqdn, and interface ip provisioning.
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
- Set the service key for the Key Distribution Center (KDC). See service packetcable registration kdc-service-key.
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.
Syntax Description
Defaults
Examples
no service packetcable enable
Syntax Description
Defaults
Examples
service packetcable registration encryption enable
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.
Syntax Description
Defaults
Encryption of MTA configuration files is by default disabled.
Examples
no service packetcable registration encryption
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.
Syntax Description
Defaults
Encryption of MTA configuration files is by default disabled.
Examples
service packetcable registration kdc-service-key
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.
Syntax Description
service packetcable 1..1 registration kdc-service-key password
- 1..1— Identifies the instance of the PacketCable service.
- 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. See the Cisco Prime Cable Provisioning 6.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.
Defaults
Examples
service packetcable registration policy-privacy
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.
Syntax Description
service packetcable 1..1 registration policy-privacy value
- 1..1— Identifies the instance of the PacketCable service.
- 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.
Defaults
Examples
This result occurs when you enforce SNMP privacy, using the default value of 1, causing all MTAs to use Privacy.
service packetcable snmp key-material
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.
Syntax Description
Defaults
Generating a security key for secure communication with the RDU is by default disabled.
Examples
no service packetcable snmp key-material
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.
Syntax Description
Defaults
Generating a security key for secure communication with the RDU is by default disabled.
Examples
service packetcable snmp timeout
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.
Syntax Description
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
service packetcable show snmp log
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.
Syntax Description
service packetcable 1..1 show snmp log [ last 1..9999 | run ]
- 1..1 —Identifies the instance of the PacketCable service.
- 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. This keyword is optional.
Defaults
Examples
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.
Feedback