Oracle Web Cache Administration and Deployment Guide Release 1.0.2.3 Part Number A86722-03 |
Library | Service | Contents | Index

# 4
Configuration and Administration Tools Overview

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

This chapter contains these topics:

- Oracle Web Cache Manager

- webcachectl Utility

- Configuration and Administration Tasks at a Glance

## Oracle Web Cache Manager

Oracle Web Cache Manager is a graphical user interface tool that combines configuration abilities with administration to provide an integrated environment for configuring and managing Oracle Web Cache.

This section introduces you to the features of Oracle Web Cache Manager. However, the primary documentation for using Oracle Web Cache Manager is the accompanying online help. This section contains these topics:

- Starting Oracle Web Cache Manager

- Navigating Oracle Web Cache

### Starting Oracle Web Cache Manager

To start Oracle Web Cache Manager:

1. Ensure that the `admin` server process is started.

   See Also: "Starting and Stopping Oracle Web Cache"

2. Point your browser to the following URL:

       http://web_cache_hostname:4000/webcacheadmin

3. When prompted for the administrator user ID and password, enter `administrator` for the user name, and enter the appropriate password. The first time you log in, the password is `administrator`.

   Note: You can also point your browser to h`ttp://``web_cache_hostname``:4000` to link to Oracle Web Cache Manager, various `README` files, user documentation, and the Oracle Technology Network.

### Navigating Oracle Web Cache

The Oracle Web Cache Manager interface includes:

- Top menu bar containing Apply Changes and Cancel Changes buttons and Oracle Web Cache status message

- Navigator pane with configuration and monitoring menu items

- Right pane with property sheet for selected menu item

  #### Figure 4-1 Oracle Web Cache Configuration Interface

  Text description of the illustration admintoa.gif

#### Apply Changes and Cancel Changes Buttons

The Apply Changes button applies submitted configuration changes to Oracle Web Cache. The Cancel Changes button cancels submitted configuration changes to Oracle Web Cache.

Note: Applied configuration changes require stopping and then restarting Oracle Web Cache. See "Starting and Stopping Oracle Web Cache" for further information.

#### Status Messages

Status messages appear below the Apply Changes and Cancel Changes buttons. Table 4-1 describes the possible status messages.

Table 4-1 Oracle Web Cache Manager Status Messages

#####

Message | Description
--- | ---
`Web Cache running with current configuration.` | This message appears if Oracle Web Cache is running with an up-to-date configuration.
`Press "Apply Changes" to commit your modifications.` | This message appears if Submit has been selected in some dialog box, but the Apply Changes button has not been chosen.
`Restart Oracle Web Cache to make configuration changes take effect` | This message appears if Oracle Web Cache is running with an older version of the configuration. This can happen if configuration changes have been applied but Oracle Web Cache has not been restarted.

#### Navigator Pane

The navigator pane provides a graphical tree view of configuration, administration, and performance monitoring capabilities for Oracle Web Cache and its supported Web sites. The navigator pane contains the following major folders:

Administering Oracle Web Cache | Contains pages that enable you to: Start and stop Oracle Web Cache Configure listening ports for administration and invalidation requests Configure event logging settings Specify the storage size of the cache Invalidate documents in the cache
Administering Web Sites | Contains pages that enable you to: Specify the Web sites and the application Web servers that Oracle Web Cache will cache documents for Configure access logging settings Configure session tracking settings Configure cacheability rules Configure compression
Monitoring Oracle Web Cache | Contains pages that enable you to monitor the performance of Oracle Web Cache
Monitoring Application Web Servers | Contains pages that enable you to monitor the performance of application Web servers

#### Right Pane

The right pane contains property sheets that enable you to configure and administer Oracle Web Cache. Figure 4-2 shows the Cacheability Rules property sheet used for viewing cacheability rules.

#### Figure 4-2 Cacheability Rules Property Sheet

Text description of the illustration adminto2.gif

## webcachectl Utility

The `webcachectl` utility enables you to administer Oracle Web Cache. The general syntax for this utility follows:

    webcachectl command

The possible commands for the `webcachectl` utility are `start` to start Oracle Web Cache, `stop` to stop Oracle Web Cache, and `status` to obtain the current status of Oracle Web Cache. For example, the following command starts Oracle Web Cache:

    webcachectl start

See Also: "Starting and Stopping Oracle Web Cache"

## Configuration and Administration Tasks at a Glance

Oracle Web Cache configuration and administration tasks are described throughout this guide and in the Oracle Web Cache Manager online help system. Table 4-2 lists the common tasks, and points you to the topic in this guide that describes the task.

Table 4-2 Common Administrative Tasks for Oracle Web Cache

#####

Task | See Also
--- | ---
Configuring Oracle Web Cache |
Change the administrator's password. | "Task 2: Modify Security Settings"
Set the maximum cache size limit. | "Task 3: Set Resource Limits"
Configure support for a Web site. | "Task 4: Specify Web Site Settings"
Configure cacheability rules. | "Configuring Cacheability Rules"
Load balance requests over multiple application Web servers. | "Configuring Load Balancing"
Bind a session to an application Web server. | "Binding a Session to an Application Web Server"
Configure event log settings. | "Configuring Event Logs"
Configure access log settings. | "Configuring Access Logs"
Administering Oracle Web Cache |
Start and stop Oracle Web Cache | "Starting and Stopping Oracle Web Cache"
Invalidate documents in the cache. | "Invalidating Documents in the Cache"
Monitoring Performance |
Monitor Oracle Web Cache overall health. | "Monitoring Overall Cache Health"
Monitor Oracle Web Cache performance. | "Gathering Oracle Web Cache Performance Statistics"
Monitor application Web server performance. | "Gathering Application Web Server Performance Statistics"

Note: All tasks listed under the heading Configuring Oracle Web Cache row require stopping and then restarting Oracle Web Cache. See "Starting and Stopping Oracle Web Cache" for further information.

| Copyright © 1996-2001 Oracle Corporation. All Rights Reserved. |
Library | Service | Contents | Index