7 Starting and Stopping OracleAS Web Cache

This chapter describes various procedures for starting and stopping OracleAS Web Cache.

This chapter contains these topics:

• Overview of Starting and Stopping for OracleAS Web Cache

• Starting and Stopping the Cache In an Oracle Application Server Configuration

• Starting and Stopping the Cache In a Standalone Configuration

Overview of Starting and Stopping for OracleAS Web Cache

Anytime the OracleAS Web Cache configuration is statically modified, you must stop and restart OracleAS Web Cache processes:

• The admin server process manages the administrative interface.

• The cache server process manages the cache.

The executable used for managing these processes is webcached, which resides in $ORACLE_HOME/webcache directory on UNIX and the ORACLE_HOME\bin directory on Windows.

When you stop OracleAS Web Cache, all objects are cleared from the cache. In addition, all statistics are cleared.

Starting and Stopping the Cache In an Oracle Application Server Configuration

You can use the following tools to start, stop, restart, and view the status of components:

• opmnctl—a command-line tool

• Application Server Control Console—a Web-based tool

These tools are completely compatible—they both use OPMN as their underlying technology for managing processes—and can be used interchangeably. For example, you can start a component using opmnctl and stop it using the Application Server Control Console.

Although the two tools can be used interchangeably, they offer different features. The opmnctl command enables you to start and stop sub-processes within components, as well as the entire component. For example, you can start and stop OracleAS Web Cache, or you can start and stop only the admin server sub-process. Application Server Control Console

Starting and Stopping Using opmnctl

To start, stop, or restart the OracleAS Web Cache processes with opmnctl:

1. Determine the status of OracleAS Web Cache. From the command line, enter:

   opmnctl status 
   
   

   OPMN generates a list of processes that are running. The following message indicates that the OracleAS Web Cache admin server (WebCacheAdmin) and the cache server (WebCache) are already running:

   Processes in Instance: AppSrv.company.com
   ias-component       | process-type         |    pid | status
   --------------------------------------------------------------
   WebCache            | WebCacheAdmin        |  29121 | Alive
   WebCache            | WebCache             |  29120 | Alive
   OC4J                | OC4J_Demos           |    N/A | Down
   OC4J                | home                 |  29268 | Init
   dcm-daemon          | dcm-daemon           |  29113 | Alive
   LogLoader           | logloader            |    N/A | Down
   HTTP_Server         | HTTP_Server          |  29099 | Alive
   
   

2. If the processes are not running, start the processes. From the command line, enter:

   opmnctl startproc ias-component=WebCache
   
   

   To stop the processes from the command line, enter:

   opmnctl stopproc ias-component=WebCache
   
   

   To restart the admin server and cache server processes from the command line, enter:

   opmnctl restartproc ias-component=WebCache
   

   
   

   See Also: "Managing Processes with Oracle Process Manager and Notification (OPMN)" for a complete list of the opmnctl commands Oracle Process Manager and Notification Server Administrator's Guide to learn more about using opmnctl

   
   

Starting and Stopping Using the Application Server Control Console

To start, stop, restart, and view status of components on the Application Server home page:

1. Navigate to the Application Server home page on the Application Server Control Console. Scroll to the System Components section.

2. Select the checkboxes in the Select column for the components you want to start, stop, or restart.

3. Click the Start, Stop, or Restart button on the top right of the System Components section.

Starting and Stopping the Cache In a Standalone Configuration

If you installed OracleAS Web Cache from a kit that included only this product or you did not install OracleAS Web Cache as part of an Oracle Application Server installation), you can use the following tools to start, stop, and restart:

• webcachectl—a command-line tool

• OracleAS Web Cache Manager—a Web-based tool

While webcachectl enables you manage all the OracleAS Web Cache processes, OracleAS Web Cache enables you to manage only the cache server process. To initialize OracleAS Web Cache for the first time, use the webcachectl utility rather than the OracleAS Web Cache Manager to start both the processes.

Starting and Stopping with webcachectl

See Also: Appendix C for information about using the webcachectl utility

Starting and Stopping Using OracleAS Web Cache Manager

OracleAS Web Cache Manager enables you to start and stop the cache server process. You must use webcachectl to start, stop, or restart the admin server process in a standalone configuration.

To start, stop, or restart the cache server process with OracleAS Web Cache Manager:

1. Start OracleAS Web Cache Manager.

   See: "Starting OracleAS Web Cache Manager"

2. In the navigator frame, select Operations > Cache Operations.

   The Cache Operations page appears in the right pane.

3. In the Cache Operations page, select the cache and click Start, Stop, or Restart.

To perform the operation on one cache in a cache cluster:

Select one cache, choose Selected Cache from the Operate On field, and then click Start, Stop, or Restart.

To perform the operation on all caches in a cache cluster:

Choose All Caches from the Operate On field, and then click Start, Stop, or Restart.