Oracle iPlanet Web Proxy Server 4.0.14 Configuration File Reference

flex-init

Applicable in Init-class directives.

The flex-init function opens the named log file to be used for flexible logging and establishes a record format for it. The log format is recorded in the first line of the log file. You cannot change the log format while the log file is in use by the server.

The flex-log function, which is applicable in AddLog-class directives, writes entries into the log file during the AddLog stage of the request-handling process.

The log file stays open until the server is shut down or restarted, at which time all logs are closed and reopened.

Note –

If the server has AddLog-stage directives that call flex-log, the flexible log file must be initialized by flex-init during server initialization.

You may specify multiple log file names in the same flex-init function call. Use multiple AddLog directives with the flex-log function to log transactions to each log file.

The flex-init function may be called more than once. Each new log file name and format is added to the list of log files.

If you move, remove, or change the currently active log file without shutting down or restarting the server, client accesses might not be recorded. To save or backup the currently active log file, rename the file and then restart the server. The server first looks for the log file by name, and if it doesn’t find that name, it creates a new file. The renamed original log file is left for you to use.

For information on rotating log files, see flex-rotate-init.

The flex-init function has three parameters: one that names the log file, one that specifies the format of each record in that file, and one that specifies the logging mode.

Parameters

The following table describes parameters for the flex-init function.

Table 5–3 flex-init Parameters


Parameter	Description
`logFileName`	The name of the parameter is the name of the log file. The value of the parameter specifies either the full path to the log file or a file name relative to the server’s `logs` directory. For example: `access="/usr/netscape/server4/https-servername/logs/access"mylogfile = "log1"` The log file name is a parameter to the `flex-log` function, which is applicable in `AddLog`-class directives.
`buffer-size`	Specifies the size of the global log buffer. The default is `8192`.
`buffers-per-file`	Specifies the number of buffers for a given log file. The default value is determined by the server. Access log entries can be logged in strict chronological order by using a single buffer per log file. Add `buffers-per-file="1"` to the `Init fn="flex-log-init"` line in `magnus.conf`. This setting ensures that requests are logged in chronological order. This approach results in decreased performance when the server is under heavy load.
`format.logFileName`	Specifies the format of each log entry in the log file. For information about the format, see the “More on Log Format” section below.
`no-format-str.access`	Specifies whether to include the format string in the log file. You can choose `yes` or `no`. If you are using the Proxy Server's log analyzer, you should include a format string. If you are using a third-party analyzer, you may not want to include a format string in your log file.