Skip Headers
Oracle® Application Server Web Cache Administrator's Guide
10g Release 2 (10.1.2)
B14046-04
  Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
Next
Next
 

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

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

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 OracleAS Web Cache In an Oracle Application Server Configuration

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

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. With the Application Server Control Console, you can view components that cannot be started or stopped, but whose status depends on other components. For example, the Application Server Control Console displays the status of the Single Sign-On component, whose status depends on the HTTP_Server component.

This section contains the following topics:

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
    

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.

Enabling and Disabling OracleAS Web Cache Using Application Server Control

If you are not using OracleAS Web Cache in your configuration and want to conserve resources, consider disabling it. If you shut down OracleAS Web Cache without disabling it, the running status of the application server, even if all components are running, shows Down in the Application Server Home page. In the Application Server Home page, you can disable OracleAS Web Cache without removing its configuration settings. When you disable OracleAS Web Cache, it does not consume any system resources, and you can always enable it later.

Only disable OracleAS Web Cache for configurations in which it is not being used or is not needed. For example, in a configuration that uses non-cacheable OC4J applications that do not need compression, disable OracleAS Web Cache. Because OracleAS Portal requires OracleAS Web Cache, do not disable OracleAS Web Cache for OracleAS Portal configurations.

To disable OracleAS Web Cache:

  1. From the System Components table in the Application Server Home page, click Enable/Disable Components.

    The Enable/Disable Components page appears.

  2. From the Enabled Components list, select the Web Cache component and move it to the Disabled Components list.

  3. Click OK.

  4. If prompted to stop OracleAS Web Cache, click Yes.

    When the Application Server Home page refreshes, the System Components table no longer lists the Web Cache component. In addition, when you perform server-wide actions, such as Start All, Restart All, or Stop All, OracleAS Web Cache is not affected.

To re-enable OracleAS Web Cache:

  1. From the System Components table in the Application Server Home page, click Enable/Disable Components.

    The Enable/Disable Components page appears.

  2. From the Disabled Components list, select the Web Cache component and move it to the Enabled Components list.

  3. Click OK.

  4. When the Application Server Home page refreshes, the System Components table lists the Web Cache component.


See Also:

Oracle Application Server Administrator's Guide for further information about disabling and enabling components

Starting and Stopping OracleAS Web 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:

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 B 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.