Preface

Oracle Application Server Web Cache Administrator's Guide describes how to use Oracle Application Server Web Cache (OracleAS Web Cache) to cache both static and dynamically generated content from one or more origin servers.

This preface contains these topics:

Intended Audience

Oracle Application Server Web Cache Administrator's Guide is intended for Web site administrators who perform the following tasks:

Web site administration
Origin server administration
Domain Name System (DNS) administration

To use this guide, you need to be familiar with release 1.0 and 1.1 of the HTTP protocol, as well as application Web server and DNS administration.

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle Corporation is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at

http://www.oracle.com/accessibility/

Accessibility of Code Examples in Documentation

JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle Corporation does not own or control. Oracle Corporation neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Organization

This document contains:

Part I, "Getting Started with OracleAS Web Cache"

Chapter 1, "Introduction to OracleAS Web Cache"

This chapter introduces the architecture, benefits, and main features of OracleAS Web Cache.

Chapter 2, "Caching Concepts"

This chapter explains how OracleAS Web Cache is populated with content, how that content maintains consistency, and how dynamically generated content is cached.

Chapter 3, "Cache Clustering"

This chapter explains the concept of a cache cluster--that is, how multiple instances of OracleAS Web Cache can run as independent caches, with no interaction with one another.

Chapter 4, "OracleAS Web Cache Security"

This chapter describes the architecture and configuration of security for OracleAS Web Cache.

Chapter 5, "OracleAS Web Cache Topologies"

This chapter presents several scenarios for deploying OracleAS Web Cache.

Chapter 6, "Configuration and Administration Tools Overview"

This chapter introduces the various administration tools of OracleAS Web Cache. It discusses the main administration application and tells you how to launch it and navigate through it.

Part II, "Configuration and Administration of OracleAS Web Cache"

Chapter 7, "Basic Setup and Configuration"

This chapter describes the steps to initially configure OracleAS Web Cache to begin caching content.

Chapter 8, "Specialized Configurations"

This chapter provides instructions for establishing specialized configurations for OracleAS Web Cache, including configuring OracleAS Web Cache HTTPS protocol requests, multiple origin servers, cache hierarchies, and cache clusters.

Chapter 9, "Creating Caching Rules"

This chapter explains how to configure caching rules.

Chapter 10, "Administering OracleAS Web Cache"

This chapter describes how to start and stop OracleAS Web Cache, invalidate documents in the cache, and evaluate event and access log files.

Chapter 11, "Sending Invalidation Requests"

This chapter explains how to send invalidation requests to OracleAS Web Cache.

Chapter 12, "Logging Events, Diagnostics, and Access Information"

This chapter describes how to evaluate event and access log files.

Chapter 13, "Monitoring Performance"

This chapter describes how to gather performance statistics and interpret them.

Chapter 14, "Troubleshooting OracleAS Web Cache Configuration"

This chapter describes common configuration problems and debugging techniques for resolving them.

Part III, "Reference"

Chapter 15, "Edge Side Includes (ESI) Language Tags"

This chapter describes the Edge Side Includes (ESI) language used for content assembly of dynamic fragments.

Chapter 16, "Event Log Messages"

This chapter describes the event log messages.

Appendix A, "OracleAS Web Cache Directory Structure"

This appendix describes the installed OracleAS Web Cache directory structure.

Appendix B, "Invalidation and Statistics Document Type Definitions"

This appendix describes the Document Type Definition (DTD), or grammar, of invalidation requests and responses.

Appendix C, "OracleAS Web Cache as a Standalone Product"

This appendix describes the commands and associated syntax of the webcachectl utility.

Appendix D, "Caching with Third-Party Application Web Servers"

This appendix describes how OracleAS Web Cache works with third-party application Web servers.

Glossary

The glossary defines terminology used throughout this guide.

Conventions

This section describes the conventions used in the text and code examples of this documentation set. It describes:

Conventions in Text

We use various conventions in text to help you more quickly identify special terms. The following table describes those conventions and provides examples of their use:

Convention Meaning Example

Bold

Bold typeface indicates terms that are defined in the text or terms that appear in a glossary, or both.

When you specify this clause, you create an index-organized table.

Italics

Italic typeface indicates book titles or emphasis.

Oracle Application Server Web Cache Administrator's Guide
Ensure that the recovery catalog and target database do not reside on the same disk.

monospace (fixed-width) font

Monospace type indicates executable files, file names, directory names, and sample user-supplied elements.

The executable used for managing these process is webcached, which resides in the directory $ORACLE_HOME/webcache

lowercase italic monospace (fixed-width) font

Lowercase italic monospace font represents placeholders or variables.

You can specify the parallel_clause.
Run Uold_release.SQL where old_release refers to the release you installed prior to upgrading.

Convention	Meaning	Example
Bold	Bold typeface indicates terms that are defined in the text or terms that appear in a glossary, or both.	When you specify this clause, you create an index-organized table.
Italics	Italic typeface indicates book titles or emphasis.	Oracle Application Server Web Cache Administrator's Guide Ensure that the recovery catalog and target database do not reside on the same disk.
`monospace (fixed-width) font`	Monospace type indicates executable files, file names, directory names, and sample user-supplied elements.	The executable used for managing these process is `webcached`, which resides in the directory `$ORACLE_HOME/webcache`
`lowercase italic monospace (fixed-width) font`	Lowercase italic monospace font represents placeholders or variables.	You can specify the `parallel_clause`. Run `U``old_release``.SQL` where `old_release` refers to the release you installed prior to upgrading.

Conventions in Code Examples

Code examples illustrate examples of code or command-line statements. They are displayed in a monospace (fixed-width) font and separated from normal text as shown in this example:

SELECT username FROM dba_users WHERE username = 'MIGRATE';

The following table describes typographic conventions used in code examples and provides examples of their use:

Convention Meaning Example

[ ]

Brackets enclose one or more optional items. Do not enter the brackets.

DECIMAL (digits [ , precision ])

{ }

Braces enclose two or more items, one of which is required. Do not enter the braces.

{ENABLE | DISABLE}

|

A vertical bar represents a choice of two or more options within brackets or braces. Enter one of the options. Do not enter the vertical bar.

{ENABLE | DISABLE}
[COMPRESS | NOCOMPRESS]

...

Horizontal ellipsis points indicate either:

That we have omitted parts of the code that are not directly related to the example

That you can repeat a portion of the code

CREATE TABLE ... AS subquery;

SELECT col1, col2, ... , coln FROM employees;

.
.
.

Vertical ellipsis points indicate that we have omitted several lines of code not directly related to the example.

Other notation

You must enter symbols other than brackets, braces, vertical bars, and ellipsis points as shown.

acctbal NUMBER(11,2);
acct CONSTANT NUMBER(4) := 3;

Italics

Italicized text indicates placeholders or variables for which you must supply particular values.

CONNECT SYSTEM/system_password
DB_NAME = database_name

Convention	Meaning	Example
[ ]	Brackets enclose one or more optional items. Do not enter the brackets.	`DECIMAL (``digits` `[ ,` `precision` `])`
{ }	Braces enclose two or more items, one of which is required. Do not enter the braces.	`{ENABLE \| DISABLE}`
\|	A vertical bar represents a choice of two or more options within brackets or braces. Enter one of the options. Do not enter the vertical bar.	`{ENABLE \| DISABLE}` `[COMPRESS \| NOCOMPRESS]`
`...`	Horizontal ellipsis points indicate either: That we have omitted parts of the code that are not directly related to the example That you can repeat a portion of the code	`CREATE TABLE ... AS` `subquery``;` `SELECT` `col1``,` `col2``, ... ,` `coln` `FROM employees;`
. . .	Vertical ellipsis points indicate that we have omitted several lines of code not directly related to the example.
Other notation	You must enter symbols other than brackets, braces, vertical bars, and ellipsis points as shown.	`acctbal NUMBER(11,2);` `acct CONSTANT NUMBER(4) := 3;`
`Italics`	Italicized text indicates placeholders or variables for which you must supply particular values.	`CONNECT SYSTEM/``system_password` `DB_NAME =` `database_name`