|
|
This chapter provides detailed descriptions of the commands used to issue Cisco IOS commands from the Cisco Web browser accessible from your router's home page.
For configuration tasks and examples, refer to the chapter entitled "Using the Cisco Web Browser" in the Configuration Fundamentals Configuration Guide.
To clear the counter for packets redirected by the Web Cache Control Protocol, use the clear ip wccp EXEC command.
clear ip wccpThis command has no arguments or keywords.
EXEC
This command first appeared in Cisco IOS Release 11.2 P and Cisco IOS Release 11.1 CA.
The "Packets Redirected" count is displayed by the show ip wccp and show ip wccp web-caches commands.
The following is sample output from the show ip wccp web-caches command before and after the clear ip wccp command is used:
Router# show ip wccp web-caches
WCCP Web-Cache information: IP Address: 192.168.88.11 Protocol Version: 1.0 State: Usable Initial Hash Info: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA Assigned Hash Info: FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF Hash Allotment: 256 (100.00%) Packets Redirected: 21345 Connect Time: 00:13:46 Router# clear ip wccp
Router# show ip wccp web-caches
WCCP Web-Cache information: IP Address: 192.168.88.11 Protocol Version: 1.0 State: Usable Initial Hash Info: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA Assigned Hash Info: FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF Hash Allotment: 256 (100.00%) Packets Redirected: 0 Connect Time: 00:13:46
You can use the master indexes or search online to find documentation of related commands.
show ip wccp
show ip wccp web-caches
This command has no arguments or keywords.
Disabled
Line configuration
This command first appeared in Cisco IOS Release 11.3
If you are configuring a Cisco IOS platform using the Cisco Web browser interface, this feature is enabled automatically when you enable the Cisco Web browser using the ip http server command.
The following example enables a Cisco IOS platform to display 8-bit and multibyte characters and print the ESC character as a single character instead of as the caret and bracket symbols (^[) when you are Telneting to the platform:
international
You can use the master indexes or search online to find documentation of related commands.
To assign an access list to the HTTP server used by the Cisco IOS ClickStart software or the Cisco Web browser interface, use the ip http access-class global configuration command. To remove the assigned access list, use the no form of this command.
ip http access-class {access-list-number | name}
access-list-number | Standard IP access list number in the range 0 to 99, as configured by the access-list (standard) command. |
name | Name of a standard IP access list, as configured by the ip access-list command. |
There is no access list applied to the HTTP server.
Global configuration
This command first appeared in Cisco IOS Release 11.2.
If this command is configured, the specified access list is assigned to the HTTP server. Before the HTTP server accepts a connection, it checks the access list. If the check fails, the HTTP server does not accept the request for a connection.
The following example assigns the access list named marketing to the HTTP server:
ip http access-class marketing ip access-list standard marketing permit 192.5.34.0 0.0.0.255 permit 128.88.0.0 0.0.255.255 permit 36.0.0.0 0.255.255.255 ! (Note: all other access implicitly denied)
You can use the master indexes or search online to find documentation of related commands.
ip access-list
ip wccp enable
Use the ip http authentication global configuration command to specify a particular authentication method for HTTP server users. Use the no form of this command to disable a configured authentication method.
ip http authentication {aaa | enable | local | tacacs}
aaa | Indicates that the AAA facility is used for authentication. |
enable | Indicates that the enable password method, which is the default method of HTTP server user authentication, is used for authentication. |
local | Indicates that the local user database as defined on the Cisco router or access server is used for authentication. |
tacacs | Indicates that the TACACS or XTACACS server is used for authentication. |
The default method of authentication for the HTTP server interface is the enable password method.
Global configuration
This command first appeared in Cisco IOS Release 11.2 F.
The ip http authentication command enables you to specify a particular authentication method for HTTP server users. The HTTP server uses the enable password method to authenticate a user at privilege level 15. The ip http authentication command now lets you specify enable, local, TACACS, or AAA HTTP server user authentication.
The following example specifies TACACS as the method of HTTP server user authentication:
ip http authentication tacacs
You can use the master indexes or search online to find documentation of related commands.
To specify the port to be used by the Cisco IOS ClickStart software or the Cisco Web browser interface, use the ip http port global configuration command. To use the default port, use the no form of this command.
ip http port number
number | Port number for use by ClickStart or the Cisco Web browser interface. The default is 80. |
80
Global configuration
This command first appeared in Cisco IOS Release 11.2.
Use this command if ClickStart or the Cisco Web browser interface cannot use port 80.
The following example configures the router so that you can use ClickStart or the Cisco Web browser interface via port 60:
ip http server ip http port 60
You can use the master indexes or search online to find documentation of related commands.
To enable a Cisco 1003, Cisco 1004, or Cisco 1005 router to be configured from a browser using the Cisco IOS ClickStart software, and to enable any router to be monitored or have its configuration modified from a browser using the Cisco Web browser interface, use the ip http server global configuration command. Use the no form of this command to disable this function.
ip http serverThis command has no arguments or keywords.
This command is enabled on Cisco 1003, Cisco 1004, and Cisco 1005 routers that have not yet been configured. For Cisco 1003, Cisco 1004, and Cisco 1005 routers that have already been configured, and for all other routers, this command is disabled.
Global configuration
This command first appeared in Cisco IOS Release 11.2.
The following example configures the router so that you can use the Cisco Web browser interface to issue commands to it:
ip http server
You can use the master indexes or search online to find documentation of related commands.
ip http access-class
ip http port
To enable the router to support the Web Cache Control Protocol, use the ip wccp enable global configuration command. The no form of this command disables support for the Web Cache Control Protocol.
ip wccp enableThis command has no arguments or keywords.
The Web Cache Control Protocol is disabled on the router.
Global configuration
This command first appeared in Cisco IOS Release 11.2 P and Release 11.1 CA.
This command and the ip web-cache redirect interface command are the only commands required to start redirecting requests to the Cisco Cache Engine using the Web Cache Control Protocol. To see if the Web Cache Control Protocol is enabled on the router, use the show ip wccp command.
When this command is enabled but the ip web-cache redirect command is disabled, the router is aware of caches but does not use them.
Use the ip wccp redirect-list command to limit the redirection of packets to those matching an access list.
The following example configures a router to support the Web Cache Control Protocol and redirects web-related packets from Ethernet interface 0 to the Cisco Cache Engine:
Router# configure terminal
Router(config)# ip wccp enable
Router(config)# interface Ethernet 0
Router(config-if)# ip web-cache redirect
Router(config-if)# end
Router# %SYS-5-CONFIG_I: Configured from console by console.
You can use the master indexes or search online to find documentation of related commands.
ip wccp redirect-list
ip web-cache redirect
show ip wccp
show ip wccp web-caches
To specify which packets are redirected to a Cisco Cache Engine, use the ip wccp redirect-list global configuration command. The no form of this command enables redirection of all packets.
ip wccp redirect-list {number | name}
number | Standard or extended IP access list number from 1 to 199. |
name | Standard or extended IP access list name. This argument is only available in Release 11.2 P. |
All HTTP packets are redirected to the Cisco Cache Engine.
Global configuration
This command first appeared in Cisco IOS Release 11.2 P and Release 11.1 CA.
Use this command to specify which packets should be redirected to the Cisco Cache Engine. When WCCP is enabled but this command is not configured, all web-related packets are redirected to the Cisco Cache Engine. When you enter this command, only packets that match the access list are redirected.
Some Web sites use the source IP address of packets for authentication. The Cisco Cache Engine uses its own IP address when sending requests to Web sites. Thus, the requests from the Cisco Cache Engine may not be authenticated. Use this command to bypass the Cisco Cache Engine in these cases.
Use the ip wccp enable and ip web-cache redirect commands to configure WCCP.
The following example configures a router to redirect web-related packets without a destination of 192.168.196.51 to the Cisco Cache Engine:
Router# configure terminal
Router(config)# access-list 100 deny ip any host 192.168.196.51
Router(config)# access-list 100 permit ip any any
Router(config)# ip wccp enable
Router(config)# ip wccp redirect-list 100
Router(config)# interface Ethernet 0
Router(config-if)# ip web-cache redirect
Router(config-if)# end
Router# %SYS-5-CONFIG_I: Configured from console by console.
You can use the master indexes or search online to find documentation of related commands.
clear ip wccp
ip wccp enable
ip web-cache redirect
show ip wccp
To instruct an interface to check for appropriate outgoing packets and redirect them to a Cisco Cache Engine, use the ip web-cache redirect interface configuration command. The no form of this command disables the redirection of messages to the Cisco Cache Engine.
ip web-cache redirectThis command has no arguments or keywords.
The interface does not redirect messages to the Cisco Cache Engine.
Interface configuration
This command first appeared in Cisco IOS Release 11.2 P and Release 11.1 CA.
This command and the ip wccp enable interface command are the only commands required to start redirecting requests to the Cisco Cache Engine using the Web Cache Control Protocol.
The following example configures a router to support the Web Cache Control Protocol and redirects web-related packets from Ethernet interface 0 to the Cisco Cache Engine:
Router# configure terminal
Router(config)# ip wccp enable
Router(config)# interface Ethernet 0
Router(config-if)# ip web-cache redirect
Router(config-if)# end
Router# %SYS-5-CONFIG_I: Configured from console by console.
You can use the master indexes or search online to find documentation of related commands.
clear ip wccp
ip wccp enable
ip wccp redirect-list
show ip interface
show ip wccp
show ip wccp web-caches
To display the usability status of interfaces configured for IP, use the show ip interface EXEC command.
show ip interface [type number]
type | (Optional) Interface type. |
number | (Optional) Interface number. |
EXEC
This command first appeared in Cisco IOS Release 10.0.
The Cisco IOS software automatically enters a directly connected route in the routing table if the interface is usable. A usable interface is one through which the software can send and receive packets. If the software determines that an interface is not usable, it removes the directly connected routing entry from the routing table. Removing the entry allows the software to use dynamic routing protocols to determine backup routes to the network (if any).
If the interface can provide two-way communication, the line protocol is marked "up." If the interface hardware is usable, the interface is marked "up."
If you specify an optional interface type, you will see only information on that specific interface.
If you specify no optional arguments, you will see information on all the interfaces.
When an asynchronous interface is encapsulated with PPP or SLIP, IP fast switching is enabled. A show ip interface command on an asynchronous interface encapsulated with PPP or SLIP displays a message indicating that IP fast switching is enabled.
The following is sample output from the show ip interface command:
Router# show ip interface
Ethernet0 is up, line protocol is up
Internet address is 192.195.78.24, subnet mask is 255.255.255.240
Broadcast address is 255.255.255.255
Address determined by non-volatile memory
MTU is 1500 bytes
Helper address is not set
Secondary address 131.192.115.2, subnet mask 255.255.255.0Directed broadcast forwarding is enabled
Multicast groups joined: 224.0.0.1 224.0.0.2
Outgoing access list is not set
Inbound access list is not set
Proxy ARP is enabled
Security level is default
Split horizon is enabled
ICMP redirects are always sent
ICMP unreachables are always sent
ICMP mask replies are never sent
IP fast switching is enabled
IP fast switching on the same interface is disabled
IP SSE switching is disabled
Router Discovery is disabled
IP output packet accounting is disabled
IP access violation accounting is disabled
TCP/IP header compression is disabled
Probe proxy name replies are disabled
Web Cache Redirect is enabled
Table 15 describes the fields shown in this display.
| Field | Description |
|---|---|
Ethernet0 is up | If the interface hardware is usable, the interface is marked "up." For an interface to be usable, both the interface hardware and line protocol must be up. |
line protocol is up | If the interface can provide two-way communication, the line protocol is marked "up." For an interface to be usable, both the interface hardware and line protocol must be up. |
Broadcast address | Shows the broadcast address. |
Address determined by... | Indicates how the IP address of the interface was determined. |
MTU | Shows the MTU value set on the interface. |
Shows a helper address, if one has been set. | |
Secondary address | Shows a secondary address, if one has been set. |
Directed broadcast forwarding | Indicates whether directed broadcast forwarding is enabled. |
Multicast groups joined | Indicates the multicast groups this interface is a member of. |
Outgoing access list | Indicates whether the interface has an outgoing access list set. |
Inbound access list | Indicates whether the interface has an incoming access list set. |
Proxy ARP | Indicates whether Proxy ARP is enabled for the interface. |
Security level | Specifies the IPSO security level set for this interface. |
ICMP redirects | Specifies whether redirects will be sent on this interface. |
ICMP unreachables | Specifies whether unreachable messages will be sent on this interface. |
ICMP mask replies | Specifies whether mask replies will be sent on this interface. |
IP fast switching | Specifies whether fast switching has been enabled for this interface. It is generally enabled on serial interfaces, such as this one. |
IP SSE switching | Specifies whether IP SSE switching is enabled. |
Router Discovery | Specifies whether the discovery process has been enabled for this interface. It is generally disabled on serial interfaces. |
IP output packet accounting | Specifies whether IP accounting is enabled for this interface and what the threshold (maximum number of entries) is. |
TCP/IP header compression | Indicates whether compression is enabled or disabled. |
Probe proxy name | Indicates whether HP Probe proxy name replies are generated. |
Web Cache Redirect | Indicates whether HTTP packets are redirected to a Cisco Cache Engine. |
To display global statistics related to the Web Cache Control Protocol, use the show ip wccp EXEC command.
show ip wccpThis command has no arguments or keywords.
EXEC
This command first appeared in Cisco IOS Release 11.2 P and Release 11.1 CA.
Use the clear ip wccp command to reset the counter for the "Packets Redirected" information.
The following example is sample output from the show ip wccp command:
Router# show ip wccp
Global WCCP information:
Number of web-caches: 2
Total Packets Redirected: 101
Redirect access-list: no_linux
Total Packets Denied Redirect: 88
Total Packets Unassigned: 0
Table 16 describes fields shown in this display.
| Field | Description |
|---|---|
Number of web-caches | Number of Cisco Cache Engines using the router as their home router. |
Total Packets Redirected | Total number of packets redirected by the router. |
Redirect access-list | Name or number of the redirect access list. Only packets matching the access list are redirected. |
Total Packets Denied Redirect | Total number of packets that were not redirected because they did not match the access list. |
Total Packets Unassigned | Number of packets that were not redirected because they were not assigned to any web cache. Packets may not be assigned during initial discovery of Cisco Cache Engines or when a cache is dropped from a farm. |
You can use the master indexes or search online to find documentation of related commands.
clear ip wccp
|ip wccp enable
ip wccp redirect-list|
ip web-cache redirect
show ip interface
show ip wccp web-caches
To display information about the router's known Cisco Cache Engines, use the show ip wccp web-caches EXEC command.
show ip wccp web-cachesThis command has no arguments or keywords.
EXEC
This command first appeared in Cisco IOS Release 11.2 P and Release 11.1 CA.
Use the clear ip wccp command to reset the counter for the "Packets Redirected" information.
The following example is sample output from the show ip wccp web-caches command:
Router# show ip wccp web-caches
WCCP Web-Cache information: IP Address: 192.168.88.11 Protocol Version: 1.0 State: Usable Initial Hash Info: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA Assigned Hash Info: FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF Hash Allotment: 256 (100.00%) Packets Redirected: 21345 Connect Time: 00:13:46
Table 17 describes the fields shown in this display.
| Field | Description |
|---|---|
IP Address | IP address of the Cisco Cache Engine. |
Protocol Version | Version of the Web Cache Control Protocol the Cisco Cache Engine is running. |
State | State of the Cisco Cache Engine. Possible values are "Usable" and "NOT Usable." |
Initial Hash Info | Initial contents of the hash field. The hash field contains information about how the router intends to use the Cisco Cache Engine. |
Assigned Hash Info | Current hash information of the Cisco Cache Engine. The hash information field contains information about how the router intends to use the Cisco Cache Engine. |
Hash Allotment | Percentage of all possible web servers for which the router redirects HTTP requests to this Web cache. In this example, there is only one Cisco Cache Engine, so all HTTP requests are redirected to it. |
Packets Redirected | Number of packets redirected to this Cisco Cache Engine. |
Connect Time | Indicates how long the Cisco Cache Engine has used this router as its home router. |
You can use the master indexes or search online to find documentation of related commands.
clear ip wccp
ip wccp enable
ip web-cache redirect
show ip interface
show ip wccp
This command has no arguments or keywords.
Disabled
EXEC
This command first appeared in Cisco IOS Release 11.3.
If you are configuring a Cisco IOS platform using the Cisco Web browser interface, this feature is enabled automatically when you enable the Cisco Web browser using the ip http server command.
The following example enables a Cisco IOS platform to display 8-bit and multibyte characters and print the ESC character as a single character instead of as the caret and bracket symbols (^[) when you are Telneting to the platform for the current Telnet session:
terminal international
You can use the master indexes or search online to find documentation of related commands.
|
|