C
OracleAS Web Cache as a Standalone Product

If you are running OracleAS Web Cache in a standalone environment (that is, you installed OracleAS Web Cache from a kit that included only this product; you did not install OracleAS Web Cache as part of an Oracle Application Server installation), there are some differences in how you administer OracleAS Web Cache. This appendix describes those differences.

This appendix contains these topics:

• Differences When OracleAS Web Cache Installed Standalone

• OracleAS Web Cache Processes

• webcachectl Utility Overview

• Enabling Wallets to Open on Windows

Differences When OracleAS Web Cache Installed Standalone

If you are running OracleAS Web Cache in a standalone environment (that is, you installed OracleAS Web Cache from a kit that included only this product; you did not install OracleAS Web Cache as part of an Oracle Application Server installation), note the following differences in how you administer OracleAS Web Cache:

• OracleAS Web Cache has three processes, rather than two processes. On Windows, two of these processes are Windows services. See "OracleAS Web Cache Processes" for more information.

• You use the OracleAS Web Cache Manager and the webcachectl utility, rather than Oracle Process Manager and Notification (OPMN) Server, to start, stop, and restart the OracleAS Web Cache processes. (In most cases, you can use the OracleAS Web Cache Manager to start, stop, and restart the processes.) See "webcachectl Utility Overview" for more information.

• On Windows, you must take additional steps to allow wallets to open automatically. See "Enabling Wallets to Open on Windows" for more information.

OracleAS Web Cache Processes

In a standalone environment, OracleAS Web Cache has three processes:

• The admin server process manages the OracleAS Web Cache Manager interface.

  In standalone environments on Windows, the admin server process is represented by the OracleHOME_NAMEWebCacheAdmin service.

• The cache server process manages the cache.

  In standalone environments on Windows, the cache server process is represented by the OracleHOME_NAMEWebCache service.

• If enabled, the auto-restart process checks that the cache server process is running and automatically restarts the cache server process if it is not running. (In an environment where you have installed OracleAS Web Cache as part of an Oracle Application Server installation, the auto-restart mechanism is controlled by OPMN and is not a process.)

  Because the auto-restart process is dependent upon the cache server process, you administer it by starting, stopping, or restarting the cache server process.

  See Also: "Task 3: Configure Auto-Restart Settings" for instructions on enabling auto-restart

webcachectl Utility Overview

In most cases, you can use the OracleAS Web Cache Manager to start, stop, and restart the processes. However, in previous releases, OracleAS Web Cache also provided the webcachectl utility to start, stop, and restart the admin server process, the cache server process, and the auto-restart process. Beginning with OracleAS Web Cache release 9.0.4, when OracleAS Web Cache is installed as part of an Oracle Application Server installation, you must use OPMN rather than the webcachectl utility.

If you are running OracleAS Web Cache in a standalone environment (that is, you installed OracleAS Web Cache from a kit that included only this product; you did not install OracleAS Web Cache as part of an Oracle Application Server installation), you use the webcachectl utility to administer the OracleAS Web Cache processes: the admin server, cache server, and auto-restart processes.

Note: If you invoke the webcachectl utility in an environment where you have installed OracleAS Web Cache as part of an Oracle Application Server installation, OracleAS Web Cache returns an error. See: "OPMN for Process Administration" "Starting and Stopping OracleAS Web Cache" to start or stop OracleAS Web Cache using OPMN

The webcachectl executable is located in the $ORACLE_HOME/webcache/bin directory on UNIX and the ORACLE_HOME\bin directory on Windows.

The syntax for this utility is as follows:

webcachectl command [parameter]

In standalone environments on Windows, you can also start or stop OracleAS Web Cache through the Control Panel:

1. Select the Services icon in the Control Panel window.

   The Services window appears.

2. Select the OracleHOME_NAMEWebCacheAdmin service to start the admin server process, and then click Start or Stop.

3. Select the OracleHOME_NAMEWebCache service to start the cache server process, and then click Start or Stop. This service also starts and stops the auto-restart process.

4. In the Services window, click Close.

webcachectl Utility Commands

The commands for the webcachectl utility are described in the next sections. The start, stop, and restart commands enable you to administer all three processes. You can save system resources by administering only the processes you require.

• The *adm commands enable you to administer the admin server process.

  The admin server process is the only process required during configuration with the OracleAS Web Cache Manager. After OracleAS Web Cache Manager configuration is complete, the admin server process is no longer needed unless you want to monitor the cache using the OracleAS Web Cache Manager.

• The *cache commands enable you to administer the cache server process, and if enabled, the auto-restart process.

  The cache server process is the only process required to run the cache.

reset

Use the reset command to restore the configuration to the last version saved with Apply Changes button in the OracleAS Web Cache Manager. This command also stops any running processes.

The following message displays:

Previous configuration restored. 
You must restart OracleAS Web Cache for it to run with that configuration.
Web Cache admin server is already down.
Web Cache auto-restart monitor is already down.
Web Cache cache server is already down.

restart

Use the restart command to stop and then restart the admin server, cache server, and, if enabled, the auto-restart processes. The following message displays:

Web Cache admin server stopping.
Web Cache auto-restart monitor stopping.
Web Cache cache server stopping.

OracleAS Web Cache, Version 9.0.4.0.0
Copyright c 1999, 2003, Oracle. All rights reserved.
Admin Server now running as process 17722

Admin Server is attempting to start the Cache Server

OracleAS Web Cache, Version 9.0.4.0.0
Copyright c 1999, 2003, Oracle. All rights reserved.
Cache Server now running as process 17724

restartadm

Use the restartadm command to stop and then restart the admin server process. The following message displays:

Web Cache admin server is already down.

OracleAS Web Cache, Version 9.0.4.0.0
Copyright c 1999, 2003, Oracle. All rights reserved.
Admin Server now running as process 17729

Admin Server running in admin-only mode. Cache Server NOT started

restartcache

Use the restartcache command to stop and then restart the cache server process and, if enabled, the auto-restart process. The following message displays:

Web Cache admin server stopping.
Web Cache auto-restart monitor is already down.
Web Cache cache server stopping.

OracleAS Web Cache, Version 9.0.4.0.0
Copyright c 1999, 2003, Oracle. All rights reserved.
Admin Server now running as process 8919

Admin Server is attempting to start the Cache Server

OracleAS Web Cache, Version 9.0.4.0.0
Copyright c 1999, 2003, Oracle. All rights reserved.
Cache Server now running as process 8921

start

Use the start command to start the admin server, cache server process, and, if enabled, the auto-restart process. The following message displays:

OracleAS Web Cache, Version 9.0.4.0.0
Copyright c 1999, 2003, Oracle. All rights reserved.
Admin Server now running as process 8911

Admin Server is attempting to start the Cache Server

OracleAS Web Cache, Version 9.0.4.0.0
Copyright c 1999, 2003, Oracle. All rights reserved.
Cache Server now running as process 8913

startadm

Use the startadm command to start the admin server process. The following message displays:

OracleAS Web Cache, Version 9.0.4.0.0
Copyright c 1999, 2003, Oracle. All rights reserved.
Admin Server now running as process 8971

Admin Server running in admin-only mode. Cache Server NOT started

startcache

Use the startcache command to start the cache server process and, if enabled, the auto-restart process. The following message displays:

OracleAS Web Cache, Version 9.0.4.0.0
Copyright c 1999, 2003, Oracle. All rights reserved.
Cache Server now running as process 17752

status

Use the status command to find out if the admin server process, cache server process, and, if enabled, the auto-restart process, are running or not running.

The following message displays when all three processes are not running:

Web Cache admin server is not running.
Web Cache auto-restart monitor is not running.
Web Cache cache server is not running.

The following message displays when all three processes are running:

Web Cache admin server is running as process 16274.
Web Cache auto-restart is running as process 16275.
Web Cache cache server is running as process 16273.

stop

Use the stop command to stop the admin server process, cache server process, and, if enabled, the auto-restart process. With the stop command, the cache server process does not accept any new connections, but it completes the requests of all existing connections before it shuts down. The following message displays:

Web Cache admin server stopping.
Web Cache auto-restart monitor is already down.
Web Cache cache server stopping.

stopabort

Use the stopabort command to stop the admin server process, cache server process, and, if enabled, the auto-restart process. With the stopabort command, the cache server process does not accept any new connections, drops all existing connections, and shuts down.

The following message displays:

Web Cache admin server stopping.
Web Cache auto-restart monitor stopping.
Web Cache cache server stopping.

stopadm

Use the stopadm command to stop the admin server process. The following message displays:

Web Cache admin server stopping.

stopcache

Use the stopcache command to stop the cache server process and, if enabled, the auto-restart process. With the stopcache command, the cache server process does not accept any new connections, but it satisfies the requests of all existing connections before it shuts down. The following message displays:

Web Cache auto-restart monitor stopping.
Web Cache cache server stopping.

webcachectl Parameter

The webcachectl utility supports the following parameter intended for Oracle Support Services:

coreok: Enables OracleAS Web Cache to produce a core dump

Enabling Wallets to Open on Windows

On Windows platforms, if you are using OracleAS Web Cache in a standalone environment, you must take special actions to enable wallets to open.

OracleAS Web Cache attempts to open wallets at startup. On Windows, wallets are protected so that only the user that created them can open and use them. In a standalone environment, the OracleAS Web Cache admin and cache processes are Windows services. By default, OracleAS Web Cache services are associated with the local system account, which does not have permission to open wallets.

To enable OracleAS Web Cache to open wallets at startup:

1. Create a wallet with an administrator account.

2. Change the system account information for the OracleAS Web Cache services, as described in Table C-1.

   Windows NT

   Windows 2000

   Choose the Services icon from the Control Panel window. The Services window appears. Select the OracleHOME_NAMEWebCache service. The Service dialog appears. Choose This Account. By default, the LocalSystem user account is associated with the service. Choose the ellipse (...) next to This Account. The Add User dialog box appears. Select the user that created the wallet from the Names list, and then click Add. Click OK to close the Add User dialog box. In the Service dialog box, provide the password for the wallet administrator in the Password field, and then confirm the password in the Confirm Password field. In the Services dialog box, click OK. Repeat Steps 3 - 8 for the OracleHOME_NAMEWebCacheAdmin service. In the Services window, click Close.

   Choose Administrative Tools > Services from the Control Panel window. The Services window appears. Select the OracleHOME_NAMEWebCache service. The OracleHOME_NAMEWebCache Properties dialog appears. Choose the Log On tab. In the Log On tab, choose This account. By default, the LocalSystem user account is associated with the service. Choose Browse next to This Account. The Select User dialog box appears. Select the user that created the wallet from the list, and then click OK. Click OK to close the Add User dialog box. In the OracleHOME_NAMEWebCache Properties dialog box, provide the password for the wallet administrator in the Password field, and then confirm the password in the Confirm Password field. In the Services dialog box, click OK. Repeat Steps 3 - 9 for the OracleHOME_NAMEWebCacheAdmin service.

On Windows NT, additionally grant the wallet administrator the right to run OracleAS Web Cache as a service:

1. Choose Start > Programs > Administrative Tools > User Manager.

   The User Manager window appears.

2. Select the wallet administration, and then choose Policies > User Rights.

   The User Rights Policy dialog box appears.

3. Choose the Show Advanced User Rights check box, and then select Log on as a service from the Right list.

4. Select Users from the Grant To list.

   If Users does not exist, create it:

   1. Click Add.

      The Add Users and Groups dialog box appears:

   2. Select the name of the local host computer from the List Names From list.

   3. Select Users from the Names list, and then click Add.

   4. Click OK.

      Users appears in the Grant To list.

5. Click OK in the User Rights Policy dialog box.

   The User Manager window reappears.

6. Choose User > Exit.

   See Also: "Wallet Cannot Be Opened"