Cobalt Digital Inc CacheRaQ 4 User manual

COBALT CacheRaQ 4
User Manual

©2000 Cobalt Networks, Inc. All rights reserved.
Part Number: 070-00253-01
Date: 09-2000
Cobalt Networks and Cobalt CacheRaQ are trademarks of Cobalt Networks, Inc. All other company,
brand, and product names may be registered trademarks or trademarks of their respective companies
and are hereby recognized.
This publication and the information herein is furnished AS IS, subject to change without notice, and
should not be construed as a commitment by Cobalt Networks, Inc. Furthermore, Cobalt
Networks, Inc., assumes no responsibility or liability for any errors or inaccuracies, makes no
warranty of any kind (express, implied or statutory) with respect to this publication, and expressly
disclaims any and all warranties of merchantability, fitness for particular purposes and
non infringement of third-party right.
The majority of the software used within the Cobalt CacheRaQ 4 can be freely distributed under the
terms of the BSD copyright or the GNU General Public License. However, some applications remain
the property of their owners, and require their permission to redistribute. For a complete listing of the
software used within the Cobalt CacheRaQ 4, and the terms under which it can be distributed, refer to
the Cobalt Web site at http://www.cobalt.com.
For reference, the BSD copyright and the GNU General Public License are reproduced at the back of
this manual.
Cobalt Networks, Inc.
555 Ellis Street
Mountain View, CA 94043
www.cobalt.com
In the U.S.A.:
Phone (888) 70-COBALT
[phone]
Fax [phone]
Outside the U.S.A.:
Phone [phone]
Fax [phone]

Cobalt CacheRaQ 4 User Manual iii
Important Safeguards
For your protection, please read all these instructions regarding your
CacheRaQ™ 4 and retain for future reference.
1. Read instructions
Read and understand all the safety and operating instructions before
operating the appliance.
2. Ventilation
The CacheRaQ 4’s vents (on the front) and the fan opening(s) (on the back
panel) are provided for ventilation and reliable operation of the product and
to protect it from overheating. These openings must not be blocked or
covered. This product should not be placed in a built-in installation unless
proper ventilation is provided.
3. Lithium battery
The lithium battery on the system board provides power for the real-time
clock and CMOS RAM. The battery has an estimated useful life expectancy
of 5 to 10 years. If your system no longer keeps accurate time and date
settings, it may be time to change the battery. Contact Cobalt Networks for
service information.
WARNING: There is a danger of explosion if the battery is
incorrectly replaced or replaced with the wrong type of battery.
Replace only with the same or equivalent type recommended by the
equipment manufacturer. Dispose of used batteries according to
manufacturer’s instructions.
AVERTISSMENT: Il y a danger d’explosion s’il y a remplacement
incorrect de la pile. Remplacer uniquement avec une pile du même
type ou d’un type équivalent recommandé par le fabricant. Mettre
au rebut les piles usagées conformément aux instructions du
fabricant.
ACHTUNG: Explosionsgefahr wenn die Battery in umgekehrter
Polarität eingesetzt wird. Nur mit einem gleichen oder ähnlichen,
vom Hersteller empfohlenen Typ, ersetzen. Verbrauchte Batterien
müssen per den Instructionen des Herstellers verwertet werden.

iv Cobalt CacheRaQ 4 User Manual
4. Power cord
5. Electrical shock
To reduce the risk of electrical shock, do not disassemble this product. Take
it to a qualified service person when service or repair work is required.
Opening or removing covers may expose you to dangerous voltage or other
risks. Incorrect reassembly can cause electric shock when this product is
subsequently used.
6. Operating the unit in an equipment rack
If you plan to operate the CacheRaQ 4 in an equipment rack, take the
following precautions:
a. Ensure the ambient temperature around the CacheRaQ 4 (which may be
higher than the room temperature) is within the limits specified in
Appendix B. See “Physical data” on page 64”.
b. Ensure there is sufficient air flow around the unit.
c. Ensure electrical circuits are not overloaded; consider the nameplate
ratings of all the connected equipment and ensure you have overcurrent
protection.
d. Ensure the equipment is properly grounded, particularly any equipment
connected to a power strip.
e. Do not place any objects on top of the CacheRaQ 4.
!
CAUTION: The power supply cord is used as the main disconnect
device. Ensure that the socket outlet is located or installed near the
equipment and is easily accessible.
!
ATTENTION: Le cordon d’alimentation sert d’interrupteur
général. La prise de courant doit être située ou installée à proximité
du matérial et offrir un accès facile.
!
ACHTUNG: Zur sicheren Trennung des Gerätes vom Netz ist der
Netzstecker zu ziehen. Vergewissern Sie sich, daß die Steckdose
leicht zugänglich ist.

Regulations and information
Cobalt CacheRaQ 4 User Manual v
7. Browsers
Both Netscape Navigator® and Microsoft® Internet Explorer have bugs that
can cause intermittent, unexplained failures. When using a Web browser to
interact with your Cobalt CacheRaQ 4, you may occasionally experience a
browser failure. Released product versions of the browsers are usually more
reliable than beta versions, and later versions typically work the most
reliably. A browser program failure, although annoying, does not adversely
affect your CacheRaQ 4’s data. The CacheRaQ 4 has been tested with both
Netscape Navigator version 4.7 and Microsoft Internet Explorer version 5.0.
Regulations and information
This equipment has been tested and found to comply with the limits for a Class B
digital device, pursuant to Part 15 of the FCC Rules. These limits are designed to
provide reasonable protection against harmful interference in a residential
installation. This equipment generates, uses and can radiate radio frequency
energy and, if not installed and used in accordance with the instructions, may
cause harmful interference to radio communications. However, there is no
guarantee that interference will not occur in a particular installation. If this
equipment does cause harmful interference to radio or television reception,
which can be determined by turning the equipment off and on, the user is
encouraged to try to correct the interference by one or more of the following
measures:
• Re-orient or re-locate the receiving antenna.
• Increase the separation between the equipment and receiver.
• Connect the equipment into an outlet on a circuit different from that to which
the receiver is connected.
• Consult the dealer or an experienced radio/TV technician for help.
In order to maintain compliance with FCC regulations, shielded cables must be
used with this equipment. Operation with non-approved equipment or unshielded
cables is likely to result in interference to radio and TV reception. The user is
cautioned that changes and modifications made to the equipment without the
approval of manufacturer can void the user’s authority to operate this equipment.
This equipment is in compliance with Underwriters Laboratories (UL) and is UL
listed.

vi Cobalt CacheRaQ 4 User Manual

Cobalt CacheRaQ 4 User Manual vii
Preface
This user manual is for anyone who will set up the CacheRaQ 4 network server
appliance for a group of users. You should be familiar with Microsoft®
Windows
TM
, Macintosh® or other operating systems, and Netscape Navigator®,
Microsoft® Internet Explorer or other Web browsers.
This manual consists of the following chapters and appendices:
Chapter 1 — “Introduction” on page 1 includes an overview of the
CacheRaQ 4’s features, explains how to contact Cobalt Networks and provides
general information about Cobalt networks.
Chapter 2 — “Setting up the CacheRaQ 4” on page 11 explains how to set up
the CacheRaQ 4 and integrate the server into the network.
Chapter 3 — “CacheRaQ 4 Administration” on page 31 describes how to
configure various features of the CacheRaQ 4 and how to view the statistics and
log files.
Appendix A — “Using the LCD Console” on page 55 describes the LCD
console functions—configuring or resetting the CacheRaQ 4’s network settings,
rebooting the server and powering down.
Appendix B — “Product Specifications” on page 61 provides information about
the CacheRaQ 4 hardware and software, regulatory approvals and physical data.
Appendix C — “Sample Network Topologies” on page 65 shows examples of
how the CacheRaQ 4 can be used within a network.
Appendix D — “Advanced Information” on page 77 provides information on
initializing the CacheRaQ 4 through the serial console port.
Appendix E — “Licenses” on page 79 lists licensing information.
Appendix F — “Glossary” on page 87 provides a glossary of terms used in the
CacheRaQ 4 manual.

Preface
viii Cobalt CacheRaQ 4 User Manual

Cobalt CacheRaQ 4 User Manual ix
Table of Contents
Important Safeguards iii
Regulations and information v
Preface vii
Table of Contents ix
1 Introduction 1
General 2
Front view of the CacheRaQ 4 2
Rear view of the CacheRaQ 4 3
CacheRaQ 4 requirements 4
Target audience for the user manual 4
Cobalt Developer Network 4
How to use this user manual 5
Organization of the user manual 5
Customer Service and Technical Support 6
General Cobalt information 6
Cobalt Technical Support and Service 6
Email contact 6
Technical Support telephone numbers 6
Further information 7
Before contacting Technical Support 8
To speed up your support call 8
Cobalt logo badge 9

Table of Contents
x Cobalt CacheRaQ 4 User Manual
2 Setting up the CacheRaQ 4 11
Mode of operation 11
Phase 1: Making the connection 12
Installing the CacheRaQ 4 12
Connecting to the network 13
Connecting the power supply 14
Powering on the CacheRaQ 4 14
Configuring the CacheRaQ 4 for the network 14
Using the LCD console to configure the network 15
Configuring the network settings 15
Phase 2: Setting up with the Web browser 17
Active Assist — Online Help 18
Configuring the CacheRaQ 4 with the Setup Wizard 19
1. Cache setup 20
Cache Mode table 21
Cache Settings table 21
Cache Proxy Settings table 22
2. Network setup 24
Network settings 25
Network 1 interface settings 25
Network 2 interface settings 25
3. Administrator setup 26
Password guidelines 27
4. Time setup 28
5. Registration 29
3 CacheRaQ 4 Administration 31
Home 32
Network setup 32
Cache setup 33
Cache Cluster settings 34
Inter-Cache Communication Protocol (ICP) settings 36
Proxy-only and no-query options 38
Web Cache Communication Protocol v1 (WCCP) 39
Disable Caching 40

Cobalt CacheRaQ 4 User Manual xi
Filter setup 42
Report setup 43
Email Report settings 43
Threshold settings 44
Cache statistics 45
Summary Statistics 45
Usage statistics 47
Cache logs 47
Network usage 48
CPU usage 49
Maintenance 50
Admin Setup 50
Time Setup 51
Upgrade Software 52
Installing a package file 52
A Using the LCD Console 55
Set up network 56
Reboot 57
Power down 58
Reset network 59
Resetting the CacheRaQ 4 Administrator password 60
B Product Specifications 61
Caching features 61
Performance 61
System Management 62
Browser-based user interface 62
Reporting and logging of performance and usage 62
Active Monitor 62
Cache configuration settings 62
Miscellaneous 62
Hardware 63

Table of Contents
xii Cobalt CacheRaQ 4 User Manual
Software 63
Features 63
System management 63
Physical data 64
Regulatory approval 64
C Sample Network Topologies 65
Traditional Proxy Caching mode 65
Installation notes 65
Advantage 66
Disadvantage 66
Transparent Caching mode using one network interface 67
Installation notes 67
Advantage 67
Disadvantage 67
Transparent Caching mode using two network interfaces 68
Installation notes 68
Advantages 68
Disadvantage 68
CacheRaQ 4 for workgroups 69
Installation notes 69
Advantage 69
Deployment in an ISP 70
Installation notes 70
Advantage 70
Disadvantage 70
Cluster deployment in an ISP 71
Installation notes 71
Advantages 71
Disadvantage 71
Cluster deployment with an L4 switch in an ISP 72
Installation notes 72
Advantages 72
Disadvantage 72

Cobalt CacheRaQ 4 User Manual xiii
Cluster in Traditional Proxy Caching mode 73
Installation notes 73
Advantages 73
Disadvantage 73
Cluster in Transparent Caching mode 74
Installation notes 74
Advantage 74
Disadvantage 74
Enterprise cluster with an L4 switch 75
Installation notes 75
Advantages 75
Disadvantage 75
D Advanced Information 77
Serial console port 77
Initializing the CacheRaQ 4 through the serial console port 77
E Licenses 79
THE BSD COPYRIGHT 79
GNU GENERAL PUBLIC LICENSE 80
SSL LICENSE 86
F Glossary 87

Table of Contents
xiv Cobalt CacheRaQ 4 User Manual

Cobalt CacheRaQ 4 User Manual 1
Chapter 1
Introduction
The Cobalt CacheRaQ 4 is a dedicated World Wide Web caching device — it
stores documents that have been retrieved from the Web. Once a document has
been retrieved from the Web, users can obtain it from the CacheRaQ 4 without
having to access the Web again. This reduces the communication load on the
Wide Area Network (WAN) and helps users obtain Web documents much more
quickly.
The Cobalt CacheRaQ 4 can operate in several modes:
• Traditional Proxy Caching mode . Client Web browsers are configured
explicitly to request documents from the CacheRaQ 4. Either individual
users or a central manager of the browser configuration files can configure
the browser to do this. The CacheRaQ 4 also supports the use of a proxy
auto-configuration (PAC) file for browser configuration.
• Transparent Caching mode . All client network traffic is automatically
routed through the CacheRaQ 4. The CacheRaQ 4 detects users’ requests for
Web documents (HTTP requests), which are then handled by the
CacheRaQ 4’s software. No browser configuration is necessary.
• Clustering . Several CacheRaQ 4s are configured in a cluster. Depending on
the method of clustering used, clustering can be established in either
Traditional Proxy Caching mode or Transparent Caching mode. The
CacheRaQ 4 supports a variety of clustering methods: InstaCache (based on
Cache Array Routing Protocol [CARP]), Inter-Cache Communication
Protocol (ICP) and Web Cache Communication Protocol (WCCP). WCCP
works in Transparent Caching mode only.
In a Cluster configuration, the Cluster Master receives HTTP requests from
the client by either of the two methods described above. Each request is
forwarded dynamically to one of several Cluster Slaves . The Cluster Slave
retrieves the document, either from its cache or from the document's original
server. The Cluster Slave returns the document to the Cluster Master, which
forwards it on to the requestor. Because the work of managing cached
documents is divided evenly among Cluster Slaves, clustering allows for a
greater volume of HTTP traffic.

Chapter 1: Introduction
2 Cobalt CacheRaQ 4 User Manual
General
Figure 1 and Figure 2 show the CacheRaQ 4 controls, indicators and connectors.
Front view of the CacheRaQ 4
Figure 1. CacheRaQ 4 front view
1. The Status Indicators signal Ethernet and hard drive activity:
Tx/Rx (Transmit/Receive) blinks when there is network traffic on the
primary interface.
Link indicates an active network connection on the primary interface.
Col blinks when a collision is detected on the primary interface.
100 M indicates that 100BaseT ethernet is being used on the primary
interface.
Disk indicates activity on the hard disk drive.
2. The Web indicator blinks to indicate Web activity.
3. The Logo Badge glows when the CacheRaQ 4 is powered on.
4. The LCD Screen displays messages and entered values.
5. You can use the recessed Reset Password button if you forget the
CacheRaQ 4 Administrator password. (See “Resetting the CacheRaQ 4
Administrator password” on page 60.)
6. The LCD arrow buttons allow you to enter network configuration
information, shut down and reboot the CacheRaQ 4. (See “Using the LCD
console to configure the network” on page 15.)
S
E
123456

General
Cobalt CacheRaQ 4 User Manual 3
Rear view of the CacheRaQ 4
Figure 2. CacheRaQ 4 rear view
1. The Security lock hole is used to lock the unit to a secure location.
2. The Cooling fans maintain proper operating temperature. Ensure that the
ventilation holes are not blocked.
3. The Network status indicators/OK to Power Off signal network activity
and information. The OK to Power Off light flashes when it is safe to turn
the power off.
4. The Serial console port allows you to connect serial devices.
5. Serial connector .
6. The Network connectors enable ethernet network connections and accept
the 10/100 BaseT network cables.
Network connection 2
7. Network connection 1
8. Cooling fan .
9. The Power switch toggles the power on or off.
10. The Power socket receives the AC cord that is provided.
100 - 240 VAC 50/60 Hz
1.4 A 60W max
Cobalt Networks and Cobalt CacheRaQ
are trademarks of Cobalt Networks, Inc.
www.cobalt.com
P/N 550-00192-01
Link Tx/Rx Link Tx/Rx
45
21 6 7 8 9
310

Chapter 1: Introduction
4 Cobalt CacheRaQ 4 User Manual
CacheRaQ 4 requirements
To use the CacheRaQ 4, you need the following:
• A10BaseT, 10/100BaseTX or 100BaseTX Transmission Control Protocol/
Internet Protocol (TCP/IP) -based local area network (LAN)
• A personal computer (attached to the network) that uses a Web browser (for
example, Netscape Navigator, versions 4.7 or later, or Microsoft Internet
Explorer, version 5.0 or later). To manage the CacheRaQ 4 from the user
interface (UI), your browser must have Java and Javascript™ enabled.
• An IP address and netmask for each configured ethernet interface. You also
need to have a gateway IP address and the IP address of a DNS server. To use
Transparent Caching, follow the appropriate setup procedure, as described in
Chapter 2, “Setting up the CacheRaQ 4.”
Target audience for the user manual
The user manual is for CacheRaQ 4 Administrators; it describes how to configure
and operate the CacheRaQ 4.
Administrators should be familiar with TCP/IP networking concepts, Microsoft®
Windows
TM
, Macintosh® or other operating systems, and Netscape Navigator®,
Microsoft® Internet Explorer or other Web browsers.
Cobalt Developer Network
Cobalt provides a wide range of resources, such as technical notes and white
papers, for developers of Linux applications for Cobalt platforms. Premium
resources are also available.
To register with the Cobalt Developer Network at no cost, visit the Web site at
http://developer.cobalt.com/.

How to use this user manual
Cobalt CacheRaQ 4 User Manual 5
How to use this user manual
Organization of the user manual
The user manual is organized according to the user interface (UI). See Figure 3.
For a list of chapters and appendices, see “Preface” on page vii.
Figure 3. CacheRaQ 4 user interface

Chapter 1: Introduction
6 Cobalt CacheRaQ 4 User Manual
Customer Service and Technical
Support
For Cobalt product information, visit the support section of the Cobalt Web site at
http://www.cobalt.com/support/. The site includes a Knowledge Base that
customers can query; a list of Frequently Asked Questions (FAQs) that provide
additional information is also available through the Knowledge Base.
General Cobalt information
In the U.S.A., call (888) 70-COBALT or [phone], or send email to
[email protected].
Outside the U.S.A., call [phone], or send email to [email protected].
In Europe, the Middle East and Africa, call [phone] (Netherlands), or
send email to [email protected].
In Japan, send email to [email protected].
Cobalt Technical Support and Service
Email contact
You can contact Cobalt Networks Technical Support by email using the Online
Email Support Form. This form provides us all the information we need to
service your request in a timely fashion.
Go to the URL http://www.cobalt.com/support/ and click on the
Contact Support link.
Technical Support telephone numbers
In the United States, call [phone].
In Europe, Middle East and Africa, call [phone] (Netherlands)
Customers in Japan can send email to [email protected].