|
|
January 8, 2000
 |
Note The most current Cisco documentation for released products is available on Cisco Connection Online (CCO) at http://www.cisco.com. The online documents may contain updates and modifications made after the hardcopy documents were printed. |
These release notes describe the following topics:
These release notes describe new commands included in Cisco Cache software, Release 2.4.0 for the Cisco Cache Engine. Cisco Cache software, Release 2.4.0 is supported on the Cisco Cache Engine 505 and 550.
Release 2.4.0 includes new commands that allow you to configure your Cache Engine as a content routing agent. Content routing agents are used in conjunction with the Cisco Content Router 4400. These new commands are referred to as "boomerang" software. The commands in Cache software, Release 2.3.0 are also part of this release. With Release 2.4.0, you can use your Cache Engine for transparent caching or as a content routing agent, but you cannot use the Cache Engine for both of these functions at once.
Refer to the Cisco Content Router 4400 User Guide for the following information:
Refer to the Cisco Cache Software Configuration Guide for the following information:
Refer to the Cisco Cache Software Command Reference, Release 2.3.0 for global configuration, EXEC, show, and interface command descriptions.
To determine the version of the software currently running on the Cisco Cache Engine, log on to the Cache Engine and enter the show version EXEC command.
Cache software can be downloaded from the Cisco Systems Software Center at the following URL:
http://www.cisco.com/cgi-bin/tablebuild.pl/cache-engine
Two types of Cache software files are available on CCO to download: files with the .pax suffix and files with the .bin suffix. The .pax file contains the full-image software with the graphical user interface (GUI) and is the file routinely installed. The .bin file software is for recovery situations that require booting from the network, or restoring Flash memory. Refer to the section "Recovering the System Software" in the Cisco Cache Software Configuration Guide for instructions on loading your system image with the .bin file.
Step 1 Use an FTP client to transfer the .pax file to the /local directory of your Cache Engine.
Step 2 Log on to the Cache Engine, and at the privileged level EXEC command prompt enter:
install filename.pax
where filename is the name of the .pax file.
Step 3 Follow the command-line interface instructions as prompted. At the following prompt, enter y:
Copy new image to flash memory?[yes]:
Step 4 Reboot the Cache Engine with the reload command, and then use the show version command to display the current software version.
This release of the Cisco Cache software includes these new content routing software commands:
In addition, statistics boomerang has been added to the clear command.
For a description of how to use these commands to perform a basic startup configuration of a content routing agent, refer to Chapter 6, "Configuring the System Software," in the Cisco Content Router 4400 User Guide.
|
Note A Cache Engine running Cache software, Release 2.4.0 cannot be used for transparent caching if it has been configured as a content routing agent. Therefore, if you want to use a Cache Engine for transparent caching, do not enable boomerang on the Cache Engine. See the "Caveats" section on page 11. |
To establish alternative domain names, use the alias command in boomerang configuration mode.
alias domain-name
domain-name | Name of domain (for example, www.foo.com). |
No default behaviors or values
Boomerang configuration
Use this command on both the Content Router and the agent to establish an alternative name for a domain.
In the following example, assume you are configuring a domain named www.foobar.com. Here, it is given the alias www.foobar.net. First, enter the alias on the Content Router.
Console (config-boomerang)# alias www.foobar.net
When configuring www.foo.bar.com on the agent, enter the alias on the agent:
Console (config-boomerang)# alias www.foobar.net
To configure the boomerang software on an agent or to enter boomerang configuration mode, use the boomerang global configuration command.
boomerang dns {enable | domain domain-name}
dns | Configures DNS boomerang distributed reverse proxy. |
enable | Enables the boomerang software. |
domain | Establishes support for a domain. Enters boomerang configuration mode. |
domain-name | Name of domain (for example, www.foo.com). |
No default behaviors or values
Global configuration
Use the boomerang dns enable command to enable boomerang. Use the boomerang dns domain command to establish support for a domain and to enter boomerang configuration mode.
Console (config)# boomerang dns enable
Console (config)# boomerang dns domain www.foobar.com
To send test packets to determine whether or not a destination accepts boomerang-altered source IP addresses, use the boomerang send-packet EXEC command.
boomerang send-packet {tcp | udp} dest-port source-port {dest-ip-address | dest-hostname} {source-ip-address | source-hostname}
tcp | Sends a TCP packet. |
udp | Sends a UDP packet. |
dest-port | Destination port number. |
source-port | Source port number. |
dest-ip-address | IP address of the destination site. |
dest-hostname | Name of the destination host. |
source-ip-address | IP address of the source. |
source-hostname | Name of the source host. |
No default behavior or values
EXEC
Some networks may have filters that prevent the transmission of packets with source addresses outside the address space of the network. Such filters could inhibit the boomerang process. To determine whether such filters exist, use a sniffer and the boomerang send-packet command to send a packet with a source address outside the subnet on which the agent resides. The sniffer should be set up to monitor traffic on the network of the destination site to which the packet is sent. If the sniffer detects this packet, you know that the destination can accept boomerang-altered source IP addresses.
Console# boomerang send-packet tcp 53 53 10.1.1.1 10.1.1.2
To configure the address of a content server co-located with an agent, use the content-server boomerang configuration command.
content-server ip-address filename
ip-address | IP address of the Web content server. |
filename | Filename to probe (for example, /index.html). |
If no filename is included in the command, the probe consists only of trying to connect to port 80.
Boomerang configuration
Use this command on the agent to specify an external content source. The agent needs to return the address of the content appliance or switch that is serving the content.
The agent probes the content server periodically to ensure that it is active. The probe is an HTTP GET request for the configured filename. A response of "200 OK" indicates the content server is active.
Console (config-boomerang)# content-server 11.22.33.55 /index.html
To specify the DNS Time-To-Live (TTL) value contained in the content routing agent's DNS response, use the dns-ttl command in boomerang configuration mode.
dns-ttl seconds
seconds | Number of seconds to live (1- 4294967295). The default is 20. |
The default number of seconds is 20.
Boomerang configuration
Use this command to specify the DNS Time-To-Live value contained in the DNS response generated by the agent. In general, a lower DNS TTL value ensures more recent content, whereas a higher DNS TTL value reduces the Content Router load.
The higher the DNS Time-To-Live value, the lesser the load on the Content Router. A lower value means an increased Content Router load, but also means that winning agent addresses are used for a shorter amount of time. For example, if the DNS TTL is set at 60 seconds, a name server will return to the Content Router to look up a domain name no more than once a minute. In other words, the name server uses the winning agent address for 60 seconds before consulting the Content Router again.
|
Note A dns-ttl command entered on an agent overrides a dns-ttl command entered on the Content Router. |
Console (config-boomerang)# dns-ttl 4
To specify the IP Time-To-Live (TTL) value contained in the content routing agent's DNS response, use the ip-ttl command in boomerang configuration mode.
ip-ttl hops
hops | Number of hops to live (1-255). The default is 255. |
The default is 255 hops.
Boomerang configuration
Use this command to set the IP TTL artificially low in order to restrict the number of hops that agent DNS responses can travel.
|
Note An ip-ttl command entered on an agent overrides an ip-ttl command entered on the Content Router. |
Console (config-boomerang)# ip-ttl 5
To specify the keyword that is used to encrypt packets sent between the Content Router and agents, use the key boomerang configuration command.
key {0 | 7} keyword
0 | Indicates that the keyword will be clear text. |
7 | Indicates that the keyword will be a type 7 encrypted key. |
keyword | Keyword shared by Content Router and agent. |
No default behavior or values
Boomerang configuration
Use this command to specify the same shared keyword on the Content Router and each agent. You can use a unique keyword for each domain.
Console (config-boomerang)# key 0 cantsay
To undo a boomerang configuration mode command or set its defaults, use the no form of a command to undo the original command.
no command
command | command function |
| Establishes alternate domain names. |
| Enables and configures the boomerang software. |
| Sends test packets. |
| Configures the address of a content server co-located with an agent |
| Specifies the DNS Time-To-Live value contained in the agent's DNS response. |
| Specifies the IP Time-To-Live value contained in the agent's DNS response. |
| Specifies the keyword that is used to encrypt packets sent between the Content Router and agents. |
No default behavior or values
Boomerang configuration
Use the no command to disable functions or negate a command. If you need to negate a specific command, such as the content server IP address, you must include the specific string in your command, such as no content-server ip-address filename.
Console(config-boomerang)# alias www.fooobar.net
Console(config-boomerang)# no alias www.fooobar.net
To display Content Router and content routing agent connectivity information, use the show boomerang EXEC command.
show boomerang domain-name
domain-name | Name of a domain supported (for example, www.foo.com). |
No default behavior or values
EXEC
On an agent, this command displays the current number of queries received, as well as whether or not the agent can connect to its external content server (if applicable).
Console# show boomerang www.boomtest.com
DNS packets with unknown domain 0
HTTP hostname requests dropped 0
Domain www.boomtest.com
Content server 10.6.2.2
Origin server 10.6.1.2
DNS A record requests 1
Dropped (server down) 0
Dropped (CPU busy) 0
Security failures 0
Cache hit bytes 0
Cache miss bytes 0
Total bytes served 0
The statistics boomerang parameter has been added to the clear EXEC command. It clears all boomerang statistical data without losing configurations.
Caveats describe unexpected behavior of Software Release 2.4.0. Severity 1 caveats are the most serious caveats, severity 2 caveats are less serious. Severity 3 caveats are moderate caveats, and only select severity 3 caveats are included here. The following caveats are still open (unresolved) at the printing of these release notes.
Step 1 Go to the Websense directory on the Websense server host.
Step 2 Stop the Websense server.
Step 3 Open the websense.ini file in a text editor.
Step 4 In the [OpenServer] field of the websense.ini file, enter the following on a blank line:
BlockPageServerName = IP address
where IP address is the IP address or host name of the computer running the Websense server.
Step 5 Save the edited websense.ini file.
Step 6 Restart the Websense server.
Cisco Content Router 4400 User Guide
Cisco Cache Software Configuration Guide, Software Versions 2.2.x, 2.3.x
Cisco Cache Software Command Reference, Release 2.3.0
The following sections provide sources for obtaining documentation from Cisco Systems.
You can access the most current Cisco documentation on the World Wide Web at the following sites:
Cisco documentation and additional literature are available in a CD-ROM package, which ships with your product. The Documentation CD-ROM is updated monthly and may be more current than printed documentation. The CD-ROM package is available as a single unit or as an annual subscription.
Cisco documentation is available in the following ways:
If you are reading Cisco product documentation on the World Wide Web, you can submit technical comments electronically. Click Feedback in the toolbar and select Documentation. After you complete the form, click Submit to send it to Cisco.
You can e-mail your comments to bug-doc@cisco.com.
To submit your comments by mail, for your convenience many documents contain a response card behind the front cover. Otherwise, you can mail your comments to the following address:
Cisco Systems, Inc.
Document Resource Connection
170 West Tasman Drive
San Jose, CA 95134-9883
We appreciate your comments.
Cisco provides Cisco.com as a starting point for all technical assistance. Customers and partners can obtain documentation, troubleshooting tips, and sample configurations from online tools. For Cisco.com registered users, additional troubleshooting tools are available from the TAC website.
Cisco.com is the foundation of a suite of interactive, networked services that provides immediate, open access to Cisco information and resources at anytime, from anywhere in the world. This highly integrated Internet application is a powerful, easy-to-use tool for doing business with Cisco.
Cisco.com provides a broad range of features and services to help customers and partners streamline business processes and improve productivity. Through Cisco.com, you can find information about Cisco and our networking solutions, services, and programs. In addition, you can resolve technical issues with online technical support, download and test software packages, and order Cisco learning materials and merchandise. Valuable online skill assessment, training, and certification programs are also available.
Customers and partners can self-register on Cisco.com to obtain additional personalized information and services. Registered users can order products, check on the status of an order, access technical support, and view benefits specific to their relationships with Cisco.
To access Cisco.com, go to the following website:
The Cisco TAC website is available to all customers who need technical assistance with a Cisco product or technology that is under warranty or covered by a maintenance contract.
If you have a priority level 3 (P3) or priority level 4 (P4) problem, contact TAC by going to the TAC website:
P3 and P4 level problems are defined as follows:
In each of the above cases, use the Cisco TAC website to quickly find answers to your questions.
To register for Cisco.com, go to the following website:
http://www.cisco.com/register/
If you cannot resolve your technical issue by using the TAC online resources, Cisco.com registered users can open a case online by using the TAC Case Open tool at the following website:
http://www.cisco.com/tac/caseopen
If you have a priority level 1(P1) or priority level 2 (P2) problem, contact TAC by telephone and immediately open a case. To obtain a directory of toll-free numbers for your country, go to the following website:
http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml
P1 and P2 level problems are defined as follows:
This document is to be used in conjunction with the documents listed in the "Related Documentation" section.
AtmDirector, Browse with Me, CCDA, CCDE, CCDP, CCIE, CCNA, CCNP, CCSI, CD-PAC, CiscoLink, the Cisco NetWorks logo, the Cisco Powered Network logo, Cisco Systems Networking Academy, the Cisco Systems Networking Academy logo, Fast Step, Follow Me Browsing, FormShare,FrameShare, GigaStack, IGX, Internet Quotient, IP/VC, iQ Breakthrough, iQ Expertise, iQ FastTrack, the iQ Logo, iQ Net Readiness Scorecard, MGX, the Networkers logo, Packet, PIX, RateMUX, ScriptShare, SlideCast, SMARTnet, TransPath, Voice LAN, Wavelength Router, WebViewer are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, Empowering the Internet Generation, are service marks of Cisco Systems, Inc.; and Aironet, ASIST, BPX, Catalyst, Cisco, the Cisco Certified Internetwork Expert Logo, Cisco IOS, the Cisco IOS logo, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Enterprise/Solver, EtherChannel, EtherSwitch, FastHub, IOS, IP/TV, LightStream, Post-Routing, Pre-Routing, Registrar, StrataView Plus, Stratm, SwitchProbe, TeleRouter, and VCO are registered trademarks of Cisco Systems, Inc. or its affiliates in the U.S. and certain other countries.
All other brands, names, or trademarks mentioned in this document or Web site are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0011R)
Copyright © 2000, Cisco Systems, Inc.
All rights reserved.
Posted: Sat Sep 28 03:39:19 PDT 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.