Netscape ENTERPRISE SERVER 6.1, Manual

Page: 247 / 373

Init SAFs
Chapter 7 Syntax and Use of magnus.conf 247
The log file stays open until the server is shut down or restarted (at which time all
logs are closed and reopened).
You may specify multiple log file names in the same
flex-init
function call. Then
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 will be 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, you need to rename the file and then restart the server.
The server first looks for the log file by name, and if it doesn’t find it, creates a new
one (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
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.
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/servers/https-servern
ame/logs/access"
mylogfile = "log1"
You will use the log file name later, as a parameter to the
flex-log
function.
buffer-size
Specifies the size of the global log buffer. The default is
8192
. See the third
flex-init
example below.
buffers-per-file
Specifies the number of buffers for a given log file. The
default is
8
.