|
This chapter provides a summary of the command-line interface (CLI) commands included in the Cisco Application and Content Networking Software Command Reference. The command summary tables are grouped alphabetically in five categories: user-level EXEC commands, privileged-level EXEC commands, global configuration commands, interface configuration commands, and show EXEC commands. The CLI can be accessed through the console port or Telnet.
ACNS software commands are not case sensitive. You can abbreviate commands and parameters as long as they contain enough letters to be different from any other currently available commands or parameters. You can scroll through the last 20 commands stored in the history buffer and enter or edit the command at the prompt. (See Table 1-1.)
Table 1-1 Command-Line Processing Keystroke Combinations
1The arrow keys function only on ANSI-compatible terminals such as VT100s. |
The two EXEC access levels are privileged and user. The enable and disable commands switch between the two levels. The user-level EXEC command line is available to users if they enter a valid password. The user-level EXEC commands are a subset of the privileged-level EXEC commands. The user-level EXEC prompt is the host name followed by a right angle bracket (>). The prompt for the privileged-level EXEC command line is the pound sign (#). To execute an EXEC command, enter the command at the EXEC system prompt and press the Return key. In the following example, a user accesses the privileged-level EXEC command line from the user level.
Use the Delete or Backspace key sequences to edit commands when you type commands at the EXEC prompt.
As a shortcut, you can abbreviate commands to the fewest letters that make them unique. For example, the letters sho can be entered for the show command.
Certain EXEC commands display multiple screens with the following prompt at the bottom of the screen:
Press the Spacebar to continue the output, or press Return to display the next line. Press any other key to return to the prompt. Also, at the --More-- prompt, you can enter a ? to display the help message.
To leave EXEC mode, use the exit command at the system prompt:
Domain configuration mode allows you to configure the Content Engine as a content routing agent for specific domains. To enter domain configuration mode, use the boomerang dns global configuration command. You must be in domain configuration mode to enter domain configuration commands.
To exit domain configuration mode, use the end global configuration command:
You can also exit domain configuration mode by entering the exit command or by pressing Ctrl-Z.
Note For a description of how to configure the Content Engine as a content routing agent, refer to the Cisco Cache Software Configuration Guide, Release 2.5. For more information about the boomerang content routing process, refer to the Cisco Content Routing Software Configuration Guide and Command Reference. |
To enter the global configuration mode, use the configure EXEC command. You must be in global configuration mode to enter global configuration commands.
To exit global configuration mode, use the end global configuration command:
You can also exit global configuration mode by entering the exit command or by pressing Ctrl-Z.
To enter interface configuration mode, use the interface global configuration command. The following example demonstrates how to enter interface configuration mode:
The interface configuration commands are:
These commands are described in the "Interface Configuration Command Summary" section.
To exit interface configuration mode, enter exit to return to global configuration mode:
The user interface provides error isolation in the form of an error indicator, a caret symbol (^). The ^ symbol appears at the point in the command string where you have entered an incorrect command, keyword, or argument.
In the following example, suppose you want to set the clock. Use context-sensitive help to check the syntax for setting the clock.
The help output shows that the set keyword is required. Check the syntax for entering the time:
Enter the current time in 24-hour format with hours, minutes, and seconds separated by colons:
The system indicates that you need to provide additional arguments to complete the command. Press the Up Arrow to automatically repeat the previous command entry. Then add a space and question mark (?) to display the additional arguments:
Enter the day and month as prompted and use the question mark for additional instructions.
Now you can complete the command entry by entering the year:
The caret symbol (^) and help response indicate an error with the 00 entry. To display the correct syntax, press Ctrl-P or the Up Arrow. You can also reenter the command string, and then enter a space character, a question mark, and press Enter:
Enter the year using the correct syntax and press Return to execute the command:
You can obtain help when you enter commands by using the following methods:
To avoid losing new configurations, save them to NVRAM using the copy or write commands, as shown in the following example:
See the command description for the copy running-config startup-config command for more information on "running" and "saved" configuration modes.
The EXEC commands are entered in the EXEC mode. Table 1-2 lists the user-level EXEC commands. Table 1-3 lists the privileged-level EXEC commands.
Table 1-3 ACNS Software Privileged-Level EXEC Commands
The domain configuration Content Engine commands are entered in the domain configuration mode. Table 1-4 lists the domain configuration command.
Table 1-4 ACNS Software Domain Configuration Command
The global configuration Content Engine commands are entered in the global configuration mode. Table 1-5 lists the global configuration commands.
Table 1-5 ACNS Software Global Configuration Commands
Global Configuration Command | Syntax | Description |
---|---|---|
authentication {configuration {local | tacacs} enable [primary | secondary] | login {local | tacacs} enable [primary | secondary]} |
||
bypass {auth-traffic enable | load {enable | in-interval seconds | out-interval seconds | time-interval minutes} | static {clientipaddress {serveripaddress | any-server} | any-client serveripaddress} | timer minutes} |
||
clock {summertime timezone {date startday startmonth startyear starthour endday endmonth endyear offset | recurring {1-4 startweekday startmonth starthour endweekday endmonth endhour offset | first startweekday startmonth starthour endweekday endmonh endhour offset | last startweekday startmonth starthour endweekday endmonh endhour offset}} | timezone {timezone hoursoffset minutesoffset}} |
||
error-handling {reset-connection | send-cache-error | transparent} |
||
Configures the length of time that an inactive Telnet session remains open. |
||
ftp {age-multiplier directory-listing dl_time file fo_time | max-ttl {days directory-listing dlmax_days file fmax_days | hours directory-listing dlmax_hours file fmax_hours | minutes directory-listing dlmax_min file fmax_min | seconds directory-listing dlmax_sec file fmax_sec} | min-ttl min_minutes | object max-size size | proxy {active-mode enable | anonymous-pswd passwd | incoming port | outgoing host {hostname | ip-address} port | reval-each-request {all | directory-listing | none}} |
||
http {age-multiplier text num binary num | anonymizer enable | append {proxy-auth- header {hostname | ip-address} | via-header | www-auth-header {hostname | ip-address} | x-forwarded-for-header} | authenticate- strip-ntlm | authentication {cache {max-entries entries | timeout minutes} | header {401 | 407}} | cache-authenticated {all | basic | ntlm} | cache- cookies | cache-on-abort {enable | max- threshold maxthresh | min-threshold minthresh | percent percenthresh} | client-no-cache-request {ignore | revalidate} | cluster {heal-port number | http-port number | max-delay seconds | misses number} | l4-switch enable | max-ttl {days text textdays binary bindays | hours text texthours binary binhours | minutes text textminutes binary binminutes | seconds text textseconds binary binseconds} | min-ttl minutes | object {max-size maxsize | url-validation enable} | persistent-connections {all | client-only | server-only | timeout seconds} | proxy {incoming ports | outgoing {connection-timeout microsecs | host {hostname | ip-address} port [primary] monitor seconds | origin-server | preserve-407}} | reval- each-request {all | none | text} | serve-ims {text percentage binary percentage} | strict-request- content-length-checking enable} |
||
https {destination-port allow {port | all} | deny {port | all} | proxy {incoming port | outgoing host {hostname | ip-address} port}} |
||
icp {client {{add-remote-server {hostname | ip-address} {parent | sibling} icp-port icpport http-port httpport [restrict domainnames]} | enable | exclude domainnames | max-fail retries | max-wait timeout | modify-remote-server {hostname | ip-address} {http-port port | icp-port port | parent | restrict domainnames | sibling}} | server {enable | http-port port | port icpport | remote-client {hostname | ip-address} {fetch | no-fetch}}} |
||
Configures, enables, and disables TCP/IP TFP, RCP, and TFTP services. |
||
interface {FastEthernet | GigabitEthernet} slot/port {autosense | bandwidth linespeed | cdp enable | fullduplex | halfduplex | ip address ip-address netmask [secondary] | shutdown | standby grpnumber {errors maxerrors | ip ip-address netmask | priority priority}} For more detail, see the "Interface Configuration Command Summary" section. |
||
ip {default-gateway ip-address | domain-name name | dscp {client {cache-hit {match-server | set-dscp dscp-packets | set-tos tos-packets} | cache-miss {match-server | set-dscp dscp-packets | set-tos tos-packets}} | server {match-server | set-dscp dscp-packets | set-tos tos-packets}} | name-server {ip-addresses | serial-lookup} | route dest_addrs netmask gateway} |
||
ldap server {administrative-dn name | administrative-passwd passwd | allow-mode | base baseword | enable | filter filterword | host {hostname | hostipaddress} [primary | secondary] | port portnumber | timeout seconds | userid-attribute useidword | version number} |
||
logging {console {enable | priority loglevel} | cw2K | disk {enable | filename filename | priority loglevel | recycle size} | facility facility | host {ip-address | priority loglevel}} |
||
mediafs-division {wmt-cache-space percent_space real-cache-space percent_space} |
Configures the media file system space allocation to WMT and RealProxy cache. |
|
multicast-client {accept-license-agreement | enable | evaluate | license-key key} |
||
ntlm server {domain name | enable | host {hostname | ip-address [primary | secondary}} |
||
pre-load {concurrent-requests number | depth-level-default level_number | enable | fetch {directory dir_names | domain domain_names | suffix suffix_names} | no-fetch {directory dir_names | domain domain_names | suffix suffix_names} | schedule {every-day [start-time time [end-time time]] | every-week {days of week [start-time time [end-time time]]}} | traverse-other-domains | url-list-file path} |
||
proxy-auto-config download {ftp-hostname | ftp-ip-address} remotedir pacfile |
||
proxy-protocols {outgoing-proxy exclude {enable | list word} | transparent {default-server | original-proxy}} |
||
radius-server {enable | host {hostname | hostipaddr} [auth-port port] | key keyword | redirect {enable | message reply url} | retransmit retries | timeout seconds} |
||
real-subscriber {accept-license-agreement | enable | evaluate | license-key key | publisher {host-name | ip-address} admin-port-number user-name user-password} |
||
rtsp proxy {incoming port | l4-switch enable | media-real {accept-license-agreement | enable | evaluate | ip-address ip-address | license-key keyword}} |
Enables or disables the Real-Time Streaming Protocol (RTSP) proxy, manages license, and configures the RTSP proxy IP address and the redirector port number. |
|
show rule {action {action-type {all | pattern pattern-type} | all} For a more complete explanation of specific rules, see the "rule" section. |
Sets the rules by which the Content Engine filters HTTP web traffic. |
|
Enables SNMP; sets community string and optionally names group and enables read-write access. |
||
snmp-server enable traps [config | content-engine {disk-fail | disk-read | disk-write | overload-bypass | transaction-log} | entity | snmp [authentication | cold-start]] |
||
snmp-server group name {v1 [notify name | read name | write name] | v2c [notify name | read name | write name] | v3 {auth [notify name | read name | write name] | noauth [notify name | read name | write name] | priv name [notify name | read name | write name]}} |
||
snmp-server host {hostname | ip-address} communitystring username [v2c [retry number | timeout seconds] | v3 {auth [retry number | timeout seconds] | noauth [retry number | timeout seconds] | priv [retry number | timeout seconds]}] |
||
snmp-server user name group [auth {md5 password [priv password] | sha password [priv password]} | remote octetstring [auth {md5 password [priv password] | sha password [priv password]}] |
||
standby group_number {errors max_errors | ip ip-address netmask | priority priority_level} |
Configures an interface to be a backup for another interface. |
|
tacacs {key keyword | retransmit retries | server {hostname | ip-address} [primary] | timeout seconds} |
||
tcp {client-mss maxsegsize | client-receive- buffer kbytes | client-rw-timeout seconds | client-satellite | client-send-buffer kbytes | cwnd-base segments | ecdn enable | increase-xmit-timer-value value | init-ss-threshold value | keepalive-probe-cnt count | keepalive-probe-interval seconds | keepalive-timeout seconds | server-mss maxsegsize | server-receive-buffer kbytes | server-rw-timeout seconds | server-satellite | server-send-buffer kbytes | type-of-service enable} |
||
Sets the Trivial File Transfer Protocol (TFTP) server directory. |
||
transaction-logs {archive {interval {every-day {at time | every hour} | every-hour {at minute | every minute} | second}} | max-file-size filesize} | ecdn enable | enable | export {compress | enable | ftp-server {hostname | servipaddrs} login passw directory | interval {every-hour {at minute | every minute} | every-day {at hour:minute | every hour} | every-week on weekday [at hour:minute] | minute}} | file-marker | format {apache | extended-squid | squid} | sanitize |
||
url-filter bad-sites-deny {enable | filename} | custom-message dirname | good-sites-allow {enable | filename} | N2H2 {allowmode enable | enable | server {hostname | ip-address} [port portnum [timeout seconds]]} | smartfilter enable | websense {allowmode enable | enable | server {hostname | ip-address} [port portnum [timeout seconds]]} |
||
username name {password {0 word | 1 word | word} | privilege {0-0 | 15-15 | 200-300}} |
||
wccp custom-web-cache {router-list-num num port port [[hash-destination-ip] [hash-destination-port] [hash-source-ip] [hash-source-port] [l2-redirect] [password key] [weight percentage]]} |
||
wccp media-cache {router-list-num num [[l2-redirect] [password key] [weight percentage]]} |
||
Associates ports with specific WCCP Version 2 dynamic services. |
||
wccp reverse-proxy {router-list-num num [[l2-redirect] [password key] [weight percentage]]} |
Configures WCCP Version 2 reverse proxy web caching service. |
|
wccp service-number servnumber {router-list-num num port port application {cache | streaming} [[hash-destination-ip] [hash-destination-port] [hash-source-ip] [hash-source-port] [l2-redirect] [password key] [weight percentage]]} |
||
Sets the maximum time interval over which the Content Engine will perform a clean shutdown. |
||
wccp web-cache {router-list-num num [[l2-redirect] [password key] [weight percentage]]} |
||
wccp wmt {router-list-num num [[l2-redirect] [password key] [weight percentage]]} |
Configures the web cache service to run with WCCP Windows Media Technologies (WMT). |
|
wmt {accept-license-agreement | broadcast {alias-name name source url} | cache {enable | max-obj-size size} | disallowed-client-protocols [HTTP | TCP | UDP] | enable | evaluate | incoming number | l4-switch {enable} | license-key key | max-bandwidth size | max-bitrate bit_rate | max-current-sessions number | multicast {schedule-start name minute hour day month | station-configuration name dest_addr dest_port media_source [play-forever]}} |
The interface configuration commands are entered in the interface configuration mode.
The following example demonstrates how to enter the interface configuration mode for a Fast Ethernet port:
To exit the interface configuration mode, enter exit to return to the global configuration mode.
Table 1-6 lists the interface configuration commands.
Table 1-6 ACNS Software Interface Configuration Commands
The Content Engine show commands are entered in the EXEC mode. Table 1-7 lists the show commands.
Table 1-7 ACNS Software show Commands
EXEC show Command | Syntax | Description |
---|---|---|
show bypass [list] [statistics {auth-traffic | load}] [summary] |
||
show cdp [entry neighbor {protocol | version} | holdtime | interface {fastEthernet slot/port | gigabitEthernet slot/port} | neighbors {detail | fastEthernet {slot/port | detail} | gigabitEthernet {slot/port | detail}} | run | timer | traffic] |
||
error-handling {reset-connection | send-cache-error | transparent} |
||
Displays File Transfer Protocol (FTP) caching- related configuration. |
||
Displays the graphical user interface (GUI) server configuration. |
||
show http {age-mult | all | anonymizer | append | authenticate-strip-ntlm | authentication | cache- authenticated | cache-cookie | cache-on-abort | client-no-cache- request | cluster | object | persistent-connections | proxy | reval-each-request | strict-request- content-length- checking | ttl} |
||
show interface {FastEthernet slot/port | GigabitEthernet slot/port | scsi number} |
||
Displays multicast client configuration and license parameters. |
||
Displays the state of the browser automatic configuration feature. |
||
Displays RealSubscriber configuration and license parameters. |
||
show rule {action {action-type {all | pattern pattern-type} | all} For a more complete explanation of specific rules, refer to the "show rule" section |
||
show statistics {authentication | boomerang [domain domainname] | bypass [auth-traffic | load | summary] | cfs | dns-cache | ftp | http {cluster | ims | object | performance | proxy outgoing | requests | savings | usage} | http-authcache | https | icmp | icp {client | server} | ip | ldap | mediacache real {requests | savings} | netstat | ntlm | pre-load | radius | rule {action {action-type {all | pattern pattern-type} | services | all}} | snmp | streamstat | tacacs | tcp | transaction-logs | udp | url-filter {N2H2 | websense} | wmt {all | bytes | errors | multicast | requests | savings | usage [detail | summary]} |
||
Displays Trivial File Transfer Protocol (TFTP) server configuration. |
||
show wccp {content-engines | flows {custom-web-cache | media-cache | reverse-proxy | web-cache | wmt} [summary] | gre | modules | port- list | routers | services [detail] | slowstart {custom-web-cache | media-cache | reverse-proxy | web- cache | wmt} | status} |
||
Posted: Wed May 14 13:50:25 PDT 2003
All contents are Copyright © 1992--2003 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.