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 http://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.