Chapter 6 PacketCable Voice Technology Commands

Table Of Contents

PacketCable Voice Technology Commands

Commands

debug dpe netsnmp

no debug dpe netsnmp

debug dpe registration

debug dpe registration-detail

no debug dpe registration

no debug dpe registration-detail

debug dpe snmp

no debug dpe snmp

no packetcable

packetcable enable

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

show packetcable snmp log last <1..9999>

show packetcable snmp log run

PacketCable Voice Technology Commands

This chapter contains detailed information about the command line interface (CLI) commands that you can use to manage and monitor the PacketCable voice technology on Broadband Access Center for Cable (BACC) device provisioning engines (DPE).

Commands

This section describes the commands that affect the PacketCable (voice technology) features found in the DPE. These commands include:

• debug dpe netsnmp

• no debug dpe netsnmp

• debug dpe registration

• debug dpe registration-detail

• no debug dpe registration

• no debug dpe registration-detail

• debug dpe snmp

• no debug dpe snmp

• no packetcable

• packetcable enable

• 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

• show packetcable snmp log last <1..9999>

• show packetcable snmp log run

Note Prior to using any debug command, you must ensure that DPE debugging is enabled. Run the debug on command to enable this function.

debug dpe netsnmp

Usage Guidelines

This command enables detailed debugging for the PacketCable SNMP service running on the DPE.

If you run this command 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.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the debug dpe netsnmp command, you simply enter the command as indicated below:

dpe# debug dpe netsnmp
Examples

This is an example of how to use the debug dpe netsnmp command:

dpe# debug dpe netsnmp
%OK

no debug dpe netsnmp

This command disables detailed debugging for the PacketCable SNMP service running on the DPE.

If you run this command 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.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the no debug dpe snmp command, you simply enter the command as indicated below:

dpe# no debug dpe snmp
Examples

This is an example of how to use the no debug dpe netsnmp command:

dpe# no debug dpe netsnmp
%OK

debug dpe registration

Usage Guidelines

This command enables debugging for the PacketCable secure registration service running on the DPE.

If you run this command 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.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the debug dpe registration command, you simply enter the command as indicated below:

dpe# debug dpe registration
Examples

This is an example of how to use the debug dpe registration command:

dpe# debug dpe registration
%OK

debug dpe registration-detail

Usage Guidelines

This command enables the PacketCable registration detail category for debug messages.

If you run this command 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.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the debug dpe registration-detail command, you simply enter the command as indicated below:

dpe# debug dpe registration-detail
Examples

This is an example of how to use the debug dpe registration-detail command:

dpe# debug dpe registration-detail
%OK

no debug dpe registration

Usage Guidelines

This command disables debugging for the PacketCable secure registration service running on the DPE.

If you run this command 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.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the no debug dpe registration command, you simply enter the command as indicated below:

dpe# no debug dpe registration
Examples

This is an example of how to use the no debug dpe registration command:

dpe# no debug dpe registration
%OK

no debug dpe registration-detail

Usage Guidelines

This command disables the PacketCable registration detail category for debug messages.

If you run this command 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.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the no debug dpe registration-detail command, you simply enter the command as indicated below:

dpe# no debug dpe registration-detail
Examples

This is an example of how to use the debug dpe registration-detail command:

dpe# no debug dpe registration-detail
%OK

debug dpe snmp

Usage Guidelines

This command enables detailed debugging for the PacketCable SNMP service running on the DPE.

If you run this command 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.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the debug dpe snmp command, you simply enter the command as indicated below:

dpe# debug dpe snmp
Examples

This is an example of how to use the debug dpe snmp command:

dpe# debug dpe snmp
%OK

no debug dpe snmp

Usage Guidelines

This command disables detailed debugging for the PacketCable SNMP service running on the DPE.

If you run this command 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.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the no debug dpe snmp command, you simply enter the command as indicated below:

dpe# no debug dpe snmp
Examples

This is an example of how to use the no debug dpe snmp command:

dpe# no debug dpe snmp
%OK

no packetcable

Usage Guidelines

This command is used to disable PacketCable services.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the no packetcable command, you simply enter the command as indicated below:

dpe# no packetcable

Once the command is entered, PacketCable voice technology support is disabled on the DPE. When this command is used, you must follow it by running the dpe reload command to restart the DPE and make the changes take effect. See the "dpe reload" section on page 4-9 for additional information.

Examples

This is an example of how to use the no packetcable command:

dpe# no packetcable
%OK (Requires DPE restart "> dpe reload")

packetcable enable

Usage Guidelines

This command enables PacketCable services. To enable PacketCable, you must:

•Configure at least one interface with an FQDN and have provisioning enabled.

•Set the KDC service key. See the "packetcable registration kdc-service-key" section for additional information.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the packetcable enable command, you simply enter the command as indicated below:

dpe# packetcable enable

Once the command is entered, the PacketCable voice technology is enabled on the DPE. When this command is used, you must follow it by running the dpe reload command to restart the DPE and make the changes take effect. See the "dpe reload" section on page 4-9 for additional information.

Examples

This is an example of how to use the packetcable enable command:

dpe# packetcable enable
%OK (Requires DPE restart "> dpe reload")

packetcable registration encryption

Usage Guidelines

This command enables encryption of MTA configuration files.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the packetcable registration encryption command, you simply enter the command as indicated below:

dpe# packetcable registration encryption
Examples

This is an example of how to use the packetcable registration encryption command:

dpe# packetcable registration encryption
%OK

no packetcable registration encryption

Usage Guidelines

This command disables encryption on a MTA configuration file.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the no packetcable registration encryption command, you simply enter the command as indicated below:

dpe# no packetcable registration encryption
Syntax Description

When entering the no packetcable registration encryption command, you must use this syntax:

dpe# no packetcable registration encryption
%OK

packetcable registration kdc-service-key

Usage Guidelines

This command is used to generate and set a security key used for communication between KDC and DPE.

Note This command is used with both the hardware and Solaris DPE. On the hardware DPE, it is used only in the console mode.

Syntax Description

When entering the packetcable registration kdc-service-key command, you must use this syntax:

dpe# packetcable registration kdc-service-key <password>

Where the <password> is any password, 6 to 20 characters in length, that you create.

Note The password that you enter for this command must match the password that is entered into the keygen tool when configuring the KDC. See the Cisco Broadband Access Center for Cable Administrators Guide for information on the use of the KeyGen tool.

Once the command is entered, the security key is generated. When this command is used, you must follow it by running the dpe reload command to restart the DPE and make the changes take effect. See the "dpe reload" section on page 4-9 for additional information.

Examples

This is an example of how to use the packetcable registration kdc-service-key command:

dpe# packetcable registration kdc-service-key ciscosystems101
%OK (Requires DPE restart "> dpe reload")

packetcable registration policy-privacy

This CLI command sets the customer policy regarding enforcement of SNMP privacy in MTA communications. Entering a zero value lets the MTA choose the SNMP-v3 privacy option. Entering a non zero value means that the provisioning server sets the privacy option in SNMPv3 to a specific protocol; currently limited to DES.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the packetcable registration policy-privacy command, you must use this syntax:

dpe# packetcable registration policy-privacy <value>

where:

•<value>—Enter any zero, or non zero, value to identify the customer policy. Values include:

–0—This indicates that the MTA selects the privacy option with Privacy being optional.

–1—This default value indicates that the policy is enforced causing all MTA's to use Privacy. If privacy is not used the MTA will not start.

–32—This indicates that there is no privacy.

–33—This indicates that privacy is enabled for all devices.

When this command is used, you must follow it by running the dpe reload command to restart the DPE and make the changes take effect. See the "dpe reload" section on page 4-9 for additional information.

Examples

This is an example of how to use the packetcable registration policy-privacy command:

dpe# packetcable registration policy-privacy 1
%OK (Requires DPE restart "> dpe reload">

packetcable snmp key-material

Usage Guidelines

You use this command, from the console mode, 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 only used for PacketCable SNMPv3 cloning support.

Note The same key has to be set on the RDU with a command line tool generateSharedSecret.sh located in the <BACC_HOME>/rdu/bin directory. This command is used with both the hardware and Solaris DPE. On the hardware DPE, it is used only in the console mode.

Syntax Description

When entering the packetcable snmp key-material command, you must use this syntax:

dpe# packetcable snmp key-material <password>

Where the <password> is any password, 6 to 20 characters in length, that you create.

Note Once you run this CLI command, you must reload the DPE for the change to take affect.

When this command is used, you must follow it by running the dpe reload command to restart the DPE and make the changes take effect. See the "dpe reload" section on page 4-9 for additional information.

Examples

This is an example of how to use the packetcable snmp key-material command:

dpe# packetcable snmp key-material ciscosystems101
%OK (Requires DPE restart "> dpe reload")

no packetcable snmp key-material

Usage Guidelines

This command is used to clear the SNMPv3 service key and turn off the SNMPv3 cloning support. For security reasons, this command is not available when a Telnet session is used and can only be set from the console mode.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the no packetcable snmp key-material command, you simply enter the command as indicated below:

dpe# no packetcable snmp key-material

Once the command is entered, no SNMP key material is available. When this command is used, you must follow it by running the dpe reload command to restart the DPE and make the changes take effect. See the "dpe reload" section on page 4-9 for additional information.

Examples

This is an example of how to use the no packetcable snmp key-material command:

dpe# no packetcable snmp key-material
%OK (Requires DPE restart "> dpe reload")

packetcable snmp timeout

Usage Guidelines

This command dynamically sets the time (in seconds) that the PacketCable SNMP service will wait for a response to any SNMP SET operation.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When entering the packetcable snmp timeout command, you must use this syntax:

packetcable snmp timeout <time>

Where the <time> indicates the time the PacketCable SNMP service will wait, in seconds. The default value is 10 seconds.

Examples

This is an example of how to use the packetcable snmp timeout command:

dpe# packetcable snmp timeout 15
%OK

show packetcable snmp log

Usage Guidelines

This command shows recent log entries for the PacketCable SNMP provisioning service, which includes information about the general PacketCable SNMP provisioning service and the logging any MTA provisioning errors or severe problems.

Note This command is used with both the hardware and Solaris DPEs.

Examples

This is an example of how to use the show packetcable snmp log command:

dpe# show packetcable snmp log
Error [SS_MSG] 2003-03-18 14:30:44,000 - SNMP Service Tracing Set To 400
...

Note The output presented in this example is trimmed.

show packetcable snmp log last <1..9999>

Usage Guidelines

This command displays a specified number of lines from the PacketCable SNMP log file.

Note This command is used with both the hardware and Solaris DPEs.

Syntax Description

When using this command you must use this syntax:

show packetcable snmp log last <1..9999>

Where the <1..9999> identifies the number of lines from the log file that you want to see.

Examples

This is an example of how to use the show packetcable snmp log last command:

dpe# show packetcable snmp log last 1
Error [SS_MSG] 2003-03-18 14:35:44,000 - SNMP Service Tracing Set To 800

show packetcable snmp log run

Usage Guidelines

This command displays the recent PacketCable SNMP service log file, and all new log messages, until the command is interrupted.

Note This command is used with both the hardware and Solaris DPEs.

Examples

This is an example of how to use the show packetcable snmp log run command:

dpe # show packetcable snmp log run
Press <enter> to stop.

2003 12 17 11:43:43 CDT: %CSRC-5: Notification DPE: Device Provisioning Engine starting up
2003 12 17 11:43:44 CDT: %CSRC-6: Info DPE: Attempt to connect to RDU dpe failed;
2003 12 17 11:43:44 CDT: %CSRC-6: Info TFTP: Ready to service requests

Stopped.