Administering Proxy Cache Service Log Files

From the Log File Management page, you can set up automatic rotation and backup of the following proxy cache service log files (each log type is shown in parentheses):

• Proxy Cache Server log (log type: cache)

• Proxy Cache Access log (log type: access)

• Proxy Cache Hierarchy log (log type: hierarchy)

• Proxy Cache Store log (log type: store)

At the time of day you specify, log files are rotated so that the current log file, type.log, becomes type.log.0; type.log.0 becomes type.log.1; type.log.1 becomes type.log.2; and so on. The highest-numbered (and oldest) file, type.log.9, is overwritten by type.log.8.

The log files are then stored locally or on a remote server, according to your settings.

To Administer Proxy Cache Service Log Files

1. In the Proxy Cache Log Administration page, click Administer Proxy Cache Server, Access, Hierarchy, and Store Logs.

2. In the Log File Management page, set file location and time of day options.

   Table 10-24 File Location and Time of Day Options

   Option	Description
   Maintain available space	Specifies that log files are stored in the local directory /var/opt/SUNWcache/cachelogs. This option enforces a minimum disk space allowance (the default value is 10 MB). If necessary, log files are deleted (starting with the oldest) until the specified amount of space is reached.
   Transfer logs via FTP	Specifies that log files are transferred after rotation to a specified directory on a remote server via FTP.
   Time of day	The time of day at which you want the log files to be rotated.

3. Set parameters for local file maintenance or FTP delivery.

   • If Maintain available space is selected and you click Set Parameters, the following option is displayed.

   Table 10-25 Maintain Available Space Option

   Option	Description
   Set Minimum Available Space To	The minimum amount of disk space that must be available in /var/opt/SUNWcache/cachelogs in addition to the log files.

   • If Transfer logs via FTP is selected and you click Set Parameters, the following options are displayed.

   Table 10-26 FTP Options

   Option	Description
   Logs To Transfer	The log file types (described earlier in this section) that will be transferred to the remote server.
   Transfer Method	The mode (binary or ASCII) in which the FTP service will transfer the log files.
   Hostname	The hostname of the remote system to which log files will be transferred.
   Username	The username for the FTP account to be used for the transfer.
   Password	The password for the FTP account to be used for the transfer.
   Remote Directory	The remote directory to which log files will be transferred.
   Log Filename Extension	An extension to be added to all log file names.

4. Click Set log file options, and enter or accept values for the following properties:

   Table 10-27

   Option	Description
   Emulate HTTPD Log	By default, the server emulates the log file format used by many HTTP servers. Accept the default of on or select off to turn this feature off.
   No. of Logfile Rotations	Specifies the number of log file rotations the server performs. With the default of 10, the software creates log files with extensions from 0 through 9. Set this property to 0 to turn off log file rotation.
   Log Directory	You do not have the option to change the default log-storage directory, /var/opt/SUNWcache/cachelogs, in the current release.