|
|
Table Of Contents
interface ethernet 0...1 ip address
interface ethernet 0...1 ip enabled
show interface ethernet <0...1> config
show interface ethernet <0...1> stats
show interface ethernet <intf0|intf1> config
show interface ethernet <intf0|intf1> stats
System Commands
This chapter contains detailed information about the command line interface (CLI) commands that you can use to manage and monitor aspects of the Broadband Access Center for Cable (BACC)
hardware DPE.Commands
This section describes the system commands that affect the entire DPE. These commands include:
•
disable
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
clock set
Usage Guidelines
This command sets the current time, using the 24-hour format, and date used by the DPE. The DPE uses GMT to keep time and any time changes made take affect immediately.
Note
This command is only used in conjunction with a hardware DPE.Syntax Description
When entering the clock set command, you must use this syntax:
clock set <hh:mm:ss> <day> <month> <yyyy>Where:
•
•
•
•
Examples
This is an example of how to use the clock set command:
dpe# clock set 11:26:00 21 12 2001Fri Dec 21 11:26:00 GMT 2001
Note
disable
Usage Guidelines
Use the disable command only when the DPE CLI is in the enable mode. Once the disable mode is activated, only those commands that allow viewing the system configuration are available.
Note
Examples
This is an example of how to use the disable command:
dpe# disableenable password
Usage Guidelines
This command is used to change the access password for entering into an enabled state on the DPE. You can only change the enable password when you are in the enabled mode. Once the password is changed, all users who, from that point forward, attempt to enter into an enabled mode, will be required to use the new password.
You do not use this command whenever TACACS authentication is enabled (see the aaa authentication, page 4-2 for additional information).
Note
This command is used with both the hardware and Solaris DPEs.Syntax Description
When entering the enable password command, you can either provide the password on a command line or when prompted. The syntax you must use is:
enable password <password>Where the <password> identifies the password currently in effect or, optionally, provides a new password. If this parameter is omitted, you are prompted for the password.
Examples
These are examples of how to use the enable password command:
Note
Example 1:
dpe# enable passwordNew enable password:Retype new enable password:Password changed successfully.Results:
These results occur when the password is changed successfully.
Example 2:
dpe# enable passwordNew enable password:Retype new enable password:Sorry, passwords do not match.Results:
These results occur when the password is not entered consistently.
Example 3:
dpe# enable password ciscoPassword changed successfullyResults:
These results occur when the password was successfully changed.
enable
Usage Guidelines
Use the enable command to enter the enabled mode. Viewing system configuration does not require the enabled mode. However, the enabled mode is required to change the system configuration, state, and data.
Note
Syntax Description
You must use this syntax when entering the enable command:
enableAfter entering the command, you are prompted to enter the password used to place the DPE into the enabled state.
Note
Examples
This is an example of how to use the enable command:
dpe# enablePassword:dpe#exit
Usage Guidelines
This command closes a Telnet or console connection to the DPE and returns to the login prompt on the console.
Note
Syntax Description
You must use this syntax when entering the exit command:
exitAfter running this command a prompt is displayed to indicate that the Telnet connection has been closed.
Examples
This is an example of how to use the exit command:
dpe# exitConnection closed.help
Usage Guidelines
This command displays a help screen to assist you in using the DPE CLI. If you need help on a particular command, or to list all available commands, enter <system_command> ? or ? respectively.
Note
Command Types
Two types of help are provided:
1.
2.
Syntax Description
You must use this syntax when entering the help command:
helpAfter entering the command, a screen prompt appears to explain how you can use the help function.
Examples
This is an example of how to use the help command:
dpe# helpHelp may be requested at any point in a command by entering a question mark '?'. If nothing matches, the help list will be empty and you must backup until entering a '?' shows the available options.1) Full help is available when you are ready to enter a command argument (e.g. 'show ?') and describes each possible argument.2) Partial help is provided when an abbreviated argument is entered and you want to know what arguments match the input (e.g. 'show stat?'.)hostname
Usage Guidelines
This command is used to set the DPE hostname. The hostname is used primarily for display in the DPE and should correspond to the DNS name for the DPEs IP address.
Note
Syntax Description
When entering the hostname command, you must use this syntax:
hostname <hostname>Where: the <hostname> identifies the host name of the DPE being addressed.
When this command is used, you must follow it by running the reload command to make the changes take effect. See the "reload" section for additional information.
Examples
This is an example of how to use the hostname command:
dpe# hostname BPR_DPE_name%OK (Requires appliance restart "> reload")interface ethernet 0...1 ip address
Usage Guidelines
This command sets the IP address of the Ethernet interface being used by the DPE. This IP address must be kept current with a valid gateway. If the gateway is invalid, rebooting could occur and this might cause the DPE to become unavailable on the network. If the IP address is configured incorrectly, use the DPE console port to reconfigure the device with a valid IP.
Note
Syntax Description
When entering the interface ethernet <0...1> ip address command, you must use this syntax:
interface ethernet <0...1> ipaddress <x.x.x.x> <y.y.y.y>Where:
•
•
•
When this command is used, you must follow it by running the reload command to make the changes take effect. See the "reload" section for additional information.
Examples
This is an example of how to use the interface ethernet <0...1> ip address command:
dpe# interface ethernet 0 ip address 10.10.10.5 255.255.255.0%OK (Requires appliance restart "> reload")
Note
interface ethernet 0...1 ip enabled
Usage Guidelines
This command controls whether or not the Ethernet interface is configured to support IP communications. If both interfaces are disabled, the device will have no network connectivity. Typically, both interfaces are enabled and connected to the network, to provide either redundancy or to use split-networking.
Note
Syntax Description
When entering the interface ethernet <0...1> IP address command, you must use this syntax:
interface ethernet <0...1> ip enabled <true/false>Where:
•
•
When this command is used, you must follow it by running the reload command to make the changes take effect. See the "reload" section for additional information.
Examples
This is an example of how to use the interface ethernet <0...1> ip enabled command:
dpe# interface ethernet 0 ip enabled true%OK (Requires appliance restart "> reload")ip default-gateway
Usage Guidelines
This command configures a default gateway for the DPE. This default gateway must be directly accessible by one of the DPE interfaces otherwise the DPE becomes unavailable.
You must verify this setting before attempting to reboot the DPE. If an incorrect value is configured, it may become necessary to physically connect to the DPE through the console port; long distances may make this impractical.
Note
Syntax Description
When entering the ip default-gateway command, you must use this syntax:
ip default-gateway <x.x.x.x>Where the (x.x.x.x) is the IP address of the default gateway.
When this command is used, you must follow it by running the reload command to make the changes take effect. See the "reload" section for additional information.
Examples
This is an example of how to use the ip default-gateway command:
dpe# ip default-gateway 10.10.20.10%OK (Requires appliance restart "> reload")no ip default-gateway
Usage Guidelines
This command clears the DPE's default gateway. If a default gateway is not specified, the DPE is only available with direct network connectivity or through the console port on the DPE.
Note
Syntax Description
When entering the no ip default-gateway command, you must use this syntax:
dpe# no ip default-gatewayWhen this command is used, you must follow it by running the reload command to make the changes take effect. See the "reload" section for additional information.
Examples
This is an example of how to use the ip default-gateway command:
dpe# no ip default-gateway%OK (Requires appliance restart "> reload")ip domain-name
Usage Guidelines
This command configures the DPE domain name for use when resolving names for communication operations, such as connecting to the RDU, or using the ping and traceroute commands. The domain name is also associated with the DPE.
Note
Syntax Description
When entering the ip domain-name command, you must use this syntax:
ip domain-name <sub.domain.com>Where the <sub.domain.com> identifies the fully qualified domain name (FQDN) of the DPE.
Examples
This is an example of how to use the ip domain-name command:
dpe# ip domain-name cisco.com%OK
Note
no ip domain-name
Usage Guidelines
This command clears the DPE's domain name. If a domain name is not specified, all remote host names must be specified using the fully qualified domain names.
Note
Syntax Description
When entering the no ip domain-name command, you must use this syntax:
dpe# no ip domain-nameExamples
This is an example of how to use the no ip domain-name command:
dpe# no ip domain-name%OK
Note
ip name-server
Usage Guidelines
This command configures the IP address of the name servers for use on the DPE. These servers are used to resolve host names into IP addresses for communication. If an FQDN is used to specify the RDU, you must specify a valid name server for successful communication with the RDU.
Note
Syntax Description
When entering the ip name-server command, you must use this syntax:
ip name-server <x.x.x.x>*Where:
•
•
Examples
This is an example of how to use the ip name-server command:
dpe# ip name-server 10.10.10.5 10.10.10.8%OK
Note
no ip name-server
Usage Guidelines
This command clears the DPE name servers. When no name servers are configured, all communication must be performed using explicit IP addresses.
Note
Syntax Description
When entering the no ip name-server command, you must use this syntax:
dpe# no ip name-serverExamples
This is an example of how to use the no ip name-server command:
dpe# no ip name-server%OKip route
Usage Guidelines
This command configures a custom route on the DPE. Three parameters are required, as shown in the following syntax description.
Note
Syntax Description
When entering the ip route command, you must use this syntax:
ip route <x.x.x.x> <y.y.y.y> <z.z.z.z>Where:
•
•
•
Examples
This is an example of how to use the ip route command:
dpe# ip route 10.10.10.5 255.255.255.0 10.10.20.10%OKno ip route
Usage Guidelines
This command clears the specified custom route, but the default route cannot be removed this way. Use the ip default-gateway command to change the default route.
Note
Syntax Description
When entering the no ip route command, you must use this syntax:
no ip route <x.x.x.x>Where the <x.x.x.x> identifies the route to be removed from the system.
Note
Examples
This is an example of how to use the no ip route command:
dpe# no ip route 10.10.10.5%OKntp server (host)
Usage Guidelines
This command lets you specify one or more network time protocol (NTP) servers, for time synchronization, as hosts. You can specify as many hosts as required to identify all of the servers.
Note
Syntax Description
When entering the ntp server (host) command, you must use this syntax:
dpe# ntp server <host_n> <host_n+>Where:
•
•
Examples
These examples illustrate the use of the ntp server command with single and multiple hosts.
Example 1
This is an example of how to use the ntp server command with a single host:
dpe# ntp server clock.cisco.comExample 2
This is an example of how to use the ntp server command with multiple hosts:
dpe# ntp server clock_1.cisco.com clock_2.cisco.com clock_3.cisco.comntp server (IP)
Usage Guidelines
This command lets you specify one or more network time protocol (NTP) servers, for time synchronization, using an IP address format. You can specify as many IP addresses as required to identify all of the servers.
Note
Examples
These examples illustrate the use of this command with single and multiple IP addresses.
Example 1
This is an example of how to use the ntp command with a single IP address:
dpe# ntp server 10.10.10.5Example 2
This is an example of how to use the ntp command with multiple IP addresses:
dpe# ntp server 10.10.10.5 10.10.10.6 10.10.10.7no ntp server
Usage Guidelines
This command disables the network time protocol (NTP).
Note
Syntax Description
When entering the no ntp server command, you must use this syntax:
dpe# no ntp serverExamples
This is an example of how to use the no ntp server command:
dpe# no ntp serverpassword
Usage Guidelines
This command changes the current system password and is not used whenever TACACS authentication is enabled (see the aaa authentication, page 4-2 for additional information). The password is changed automatically for future logins and for FTP access using the administrator account.
Note
This command is used with both the hardware and Solaris DPEs.Syntax Description
When entering the password command, you must use this syntax:
password <password>Where the <password> identifies the new DPE password.
Examples
These are examples of how to use the password command:
Example 1
dpe# passwordNew password:Retype new password:Password changed successfully.Results:
These results occur when the password is changed successfully.
Example 2
dpe# passwordNew password:Retype new password:Sorry, passwords do not match.Results:
These results occur when the password is not entered consistently.
Example 3
dpe# password ciscoPassword changed successfully.Results:
These results occur when the password is changed (using an approach easier for scripting).
poweroff
Usage Guidelines
This command turns the DPE power off. It removes all current users from the system and shuts the DPE down cleanly. Prior to executing this command, you should verify that there has been no hard drive activity for approximately 30 seconds.
Caution
Note
Syntax Description
When entering the poweroff command, you simply enter the command as indicated below:
dpe# poweroffExamples
This is an example, as shown from a Telnet session, of how to use the poweroff command:
dpe# poweroffreload
Usage Guidelines
This command reboots the DPE, disconnecting all current users from the system.
Caution
Note
Syntax Description
When entering the reload command, you simply enter the command as indicated below:
dpe# reloadExamples
This is an example of how to use the reload command:
dpe# reloadshow clock
Usage Guidelines
This command shows the current system time and date.
Note
Syntax Description
When entering the show clock command, you simply enter the command as indicated below:
dpe# show clockOnce the command is entered, the date and time are displayed.
Examples
This is an example of how to use the show clock command:
dpe# show clockFri Dec 21 11:39:31 GMT 2001show commands
Usage Guidelines
Depending on the connection type in use (enabled or disabled), this command displays all available DPE commands. For security reasons, this command shows different output based on whether a Telnet session or the console mode of operation is used on the hardware DPE.
Syntax Description
When entering the show commands command, you simply enter the command as indicated below:
dpe# show commandsOnce the command is entered, a list of available DPE commands are displayed.
Examples
This is an example of how to use the show commands command:
dpe# show commands> clear bundles> clear cache> clear logs> clock set <hh:mm:ss> <1-31> <1-12> <yyyy>> debug dpe cache> debug dpe connection
Note
show cpu
Usage Guidelines
This command identifies CPU usage for the device on which the DPE is running.
Note
Syntax Description
When entering the show cpu command, you simply enter the command as indicated below:
dpe# show cpuOnce the command is entered, cpu activities and statistics are displayed.
Examples
This is an example of how to use the show cpu command for a hardware DPE:
dpe# show cpuavg-cpu: %user %nice %sys %idle0.00 0.00 0.00 100.00This is an example of how to use the show cpu command for a Solaris DPE:
# show cpu
CPUminfmjfxcalintrithrcswicswmigrsmtxsrwsysclusrsyswtidl0300046432340600002800109906004653244051000232000100
show disk
Usage Guidelines
This command identifies the disk on which the DPE is currently using.
Note
Syntax Description
When entering the show disk command, you simply enter the command as indicated below:
dpe# show diskOnce the command is entered, the disk drive statistics are displayed.
Examples
This is an example of how to use the show disk command:
dpe# show disk
FilesystemSizeUsedAvailUse%Mounted on/dev/sda1/dev/sda51.9G14M198M57M1.6G13M11%1%//opt
show hostname
Usage Guidelines
This command displays the DPEs host name.
Note
Syntax Description
When entering the show hostname command, you simply enter the command as indicated below:
dpe# show cpuOnce the command is entered, the host's name is displayed.
Examples
This is an example of how to use the show hostname command:
dpe# show hostnamehostname = BACC_hostshow interface ethernet <0...1> config
Usage Guidelines
This command shows the configuration for the Ethernet interface. These are the settings that the DPE uses when it reboots. Use the show interface ethernet <0...1> config command to identify the currently configured IP address.
Note
Syntax Description
When entering the show interface ethernet <0...1> config command, you must use this syntax:
show interface ethernet <0...1> configWhere the <0...1> identifies the Ethernet interface number.
Examples
This is an example of how to use the show interface ethernet <0...1> config command:
dpe# show interface ethernet 0 configip address = 10.10.10.5netmask = 255.255.255.0enabled = truefor prov = trueshow interface ethernet <0...1> stats
Usage Guidelines
This command shows statistics for the DPE's Ethernet interface.
Note
Syntax Description
When entering the show interface ethernet <0...1> stats command, you must use this syntax:
show interface ethernet <0..1> statsWhere the <0...1> identifies the Ethernet interface number.
Examples
This is an example of how to use the show interface ethernet <0...1> stats command:
show interface ethernet <intf0|intf1> config
Usage Guidelines
This command shows the configuration for the Ethernet interface. These are the settings that the DPE uses when it reboots. Use the show interface ethernet [int0|intf1] config command to see the currently configured IP address.
Note
Syntax Description
When entering the show interface ethernet [int0|intf1] config command, you must use this syntax:
show interface ethernet <intf0/intf1> configWhere the <intf0/intf1> identifies the Ethernet interface number.
Examples
This is an example of how to use the show interface ethernet <intf0/intf1> config command:
dpe# show interface ethernet hme0 configip address = 10.10.10.5netmask = 255.255.255.0enabled = truefor prov = trueshow interface ethernet <intf0|intf1> stats
Usage Guidelines
This command shows statistics for the DPE's Ethernet interface.
Note
Syntax Description
When entering the show interface ethernet [intf0/intf1] stats command, you must use this syntax:
show interface ethernet <intf0/intf1> statsWhere the <intf0/intf1> identifies the Ethernet interface number.
Examples
This is an example of how to use the show interface ethernet [intf0|intf1] stats command:
show ip route
Usage Guidelines
This command shows the DPEs IP routing table, including any custom routes. the default gateway is indicated by The G flag in the flags column indicates the default gateway start.
Note
Syntax Description
When entering the show ip route command, you simply enter the command as indicated below:
dpe# show ip routeOnce the command is entered, the routing table is displayed.
Examples
This is an example of how to use the show ip route command
:
show ip
Usage Guidelines
This command shows the DPEs current general IP settings. For specific interface settings, use the show interface commands. These are the settings used when the DPE is rebooted.
Note
Syntax Description
When entering the show ip command, you simply enter the command as indicated below:
dpe# show ipOnce the command is entered, the DPE's IP settings are displayed.
Examples
This is an example of how to use the show ip command:
dpe# show iphostname = BPR_hostdomainname = cisco.comgateway = 10.10.20.10show memory
Usage Guidelines
This command identifies how much current memory and swap space is available on the device running the DPE.
Note
Syntax Description
When entering the show memory command, you simply enter the command as indicated below:
dpe# show memoryOnce the command is entered, the current memory statistics are displayed.
Examples
This is an example of how to use the show memory command:
dpe# show memory
Mem:Swap:255112K av,265032K av,148928K used0K used106184K free265032 freeOK shrd5428K buff72468K cached
show running-config
Usage Guidelines
This command displays the current configuration of the DPE. All of the configuration options are displayed using the actual commands to set the options.
Note
Syntax Description
When entering the show running-config command, you simply enter the command as indicated below:
dpe# show running-configExamples
This is an example of how to use the show running-config command:
dpe# show running-configdpe port 49186dpe rdu-server server_x.cisco.com 49187hostname dpeinterface ethernet 0 ip address 10.10.10.5 255.255.255.0interface ethernet 0 ip enabled true
Note
show tftp files
Usage Guidelines
This command identifies only the files that are stored in the DPE cache and not those in the local directory. The file size is also shown.
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
Syntax Description
When entering the show tftp files command, you simply enter the command as indicated below:
dpe# show tftp filesOnce the command is entered, all TFTP files that are currently saved in cache are listed on screen.
Examples
This is an example of how to use the show tftp files command:
dpe# show tftp filesThe list of TFTP files currently in DPE cachefilename sizebronze.cm 310gold.cm 310silver.cm 310
Note
show version
Usage Guidelines
This command is used to identify the current version of DPE software running on the device.
Note
Syntax Description
When entering the show version command, you simply enter the command as indicated below:
dpe# show versionOnce the command is entered, the current BACC version installed is identified on screen.
Examples
This is an example of how to use the show version command:
dpe# show versionVersion: BACC 2.7 (bacc_27_S_000000000000)tacacs-server <host>
Usage Guidelines
The CLI maintains a list of TACACS+ servers. This command adds a TACACS+ server to the end of the CLI's list of TACACS+ servers. When TACACS+ authentication is enabled, it attempts to authenticate each server sequentially in the list until a successful authentication exchange is executed, or the list is exhausted. If the list is exhausted, the CLI automatically falls back into the local authentication mode.
An encryption key can be optionally specified to use TACACS+ encryption on the CLI. If this encryption key is used, it must match the key configured at the specified TACACS+ server. Omitting the encryption key disables TACACS+ encryption.
Note
Syntax Description
When entering the tacacs-server command, you simply enter the command as indicated below:
tacacs-server host <host> [key <encryption-key>]Where:
•
•
Examples
These are examples of how to use the tacacs-server command:
Example 1
This example adds a TACACS+ server, using its IP address (10.0.1.1), but without encryption.
tacacs-server host 10.0.1.1% OKExample 2
This example adds a TACACS+ server, using its IP address (10.0.1.1), with an encryption key (hg667YHHj).
tacacs-server host 10.0.1.1 key hg667YHHj% OKExample 3
This example adds a TACACS+ server using its host name (tacacs1.cisco.com), but without encryption.
tacacs-server host tacacs1.cisco.com% OKExample 4
This example adds a TACACS+ server, using its host name (tacacs1.cisco.com), with an encryption key (hg667YHHj).
tacacs-server host tacacs1.cisco.com key hg667YHHj% OKno tacacs-server <host>
Usage Guidelines
This command removes a TACACS+ server from the CLI's list of TACACS+ servers.
Note
Syntax Description
When entering the no tacacs-server command, you simply enter the command as indicated below:
tacacs-server host <host>Where <host> specifies either the IP address or the host name of the TACACS+ server.
Examples
These are examples of how to use the no tacacs-server command:
Example 1
This example removes a TACACS+ server, using its IP address.
dpe# no tacacs-server host 10.0.1.1% OKExample 2
This example removes a TACACS+ server using its host name.
dpe# no tacacs-server host tacacs1.cisco.com% OKtacacs-server retries
Usage Guidelines
Set the number of times the TACACS+ protocol exchanges are retried before the CLI considers a specific TACACS+ server unreachable. When this limit is reached, the CLI will move to the next server in its TACACS+ server list or fallback into local authentication mode if the TACACS+ list has been exhausted.
Note
Syntax Description
When entering the tacacs-server retries command, you simply enter the command as indicated below:
tacacs-server retries <value>% OKWhere <value> is a dimensionless number within the range of 1 and 100 inclusive. The default value for this command is 2.
Note
Examples
This is an example of how to use the tacacs-server retries command:
dpe# tacacs-server retries 10% OKtacacs-server timeout
Usage Guidelines
This command sets the maximum time that the CLI waits for a TACACS+ server response before it considers the protocol exchange to have failed.
Note
Syntax Description
When entering the tacacs-server timeout command, you simply enter the command as indicated below:
tacacs-server timeout <value>Where <value> specifies the amount of time that the CLI will wait. This value must be within the range of 1 to 300 seconds; the default value is 5 seconds.
Note
Examples
This is an example of how to use the tacacs-server timeout command to set the timeout value to 10 seconds.
dpe# tacacs-server timeout 10% OKupgrade
Usage Guidelines
This command is used whenever the DPE requires a new software upgrade, using uploaded upgrade files. These files, which end in the file extension .bpr, should be FTP'd into the incoming directory. The upgrade process scans all available updates and determines which ones are required. It separates the files into these categories:
•
•
•
Note
Syntax Description
When entering the upgrade command, you simply enter the command as indicated below:
dpe# upgradeOnce the command is entered, the DPE upgrade process starts. When the update is finished an Update successful prompt is displayed.
Examples
This is an example of how to use the upgrade command:
dpe# upgradeStarting BPR upgrade process+ Scanning for available updates...+ Determining applicable updates...+ Compiling list of updates...Invalid update files:- update-FOOBAR.bprUpdates not applicable:- update-invalid.bpr ... BPR version 2.5Applicable updates:1 update-valid.bpr ..... BACC version 2.6 FC-2Select update [exit]: 1Updating with BACC version 2.7 FC-2+ Starting update executor...[SNIP]+ Update succesful!uptime
Usage Guidelines
This command identifies how long the system has been operational. This information is useful when determining how frequently the device is rebooted. It is also helpful when checking the reliability of the DPE when it is in a stable condition.
Note
Syntax Description
When entering the uptime command, you simply enter the command as indicated below:
dpe# uptimeOnce the command is entered, various DPE statistics are displayed.
Examples
This is an example of how to use the uptime command:
dpe# uptime11:54am up 2:07, 3users, load average: 0.27, 0.08, 0.02
Posted: Thu Mar 8 22:18:11 PST 2007
All contents are Copyright © 1992--2007 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.
