IBM Tivoli Access Manager for e-business: WebSEAL Administration ...

Log
Files
Location
Parameter
Enable/Disable
Parameter
(
=
yes
or
no)
referer.log
referers-file
referers
agent.log
agents-file
agents
For
example,
the
entry
for
the
default
location
of
the
request.log
file
appears
as
follows:
UNIX:
requests-file
=
/var/pdweb/www/log/request.log
Windows:
requests-file
=
\Program
Files\Tivoli\PDWeb\www\log\request.log
Enabling
and
disabling
HTTP
logging
By
default,
all
HTTP
logging
is
enabled:
[logging]
requests
=
yes
referers
=
yes
agents
=
yes
Each
log
can
be
enabled
or
disabled
independently
from
the
others.
If
any
parameter
is
set
to
″no″,
logging
is
disabled
for
that
file.
Specifying
the
timestamp
type
You
can
choose
to
have
the
timestamps
in
each
log
recorded
in
Greenwich
Mean
Time
(GMT)
instead
of
the
local
time
zone.
By
default,
the
local
time
zone
is
used:
[logging]
gmt-time
=
no
To
use
GMT
timestamps,
set:
gmt-time
=
yes
Specifying
log
file
rollover
thresholds
The
max-size
parameter
specifies
the
maximum
size
to
which
each
of
the
HTTP
log
files
may
grow
and
has
the
following
default
value
(in
bytes):
[logging]
max-size
=
2000000
When
a
log
file
reaches
the
specified
value
—
known
as
its
rollover
threshold
—
the
existing
file
is
backed
up
to
a
file
of
the
same
name
with
an
appended
current
date
and
timestamp.
A
new
log
file
is
then
started.
The
various
possible
max-size
values
are
interpreted
as
follows:
v
If
the
max-size
value
is
less
than
zero
(<
0),
then
a
new
log
file
is
created
with
each
invocation
of
the
logging
process
and
every
24
hours
from
that
instance.
v
If
the
max-size
value
is
equal
to
zero
(=
0),
then
no
rollovers
are
performed
and
the
log
file
grows
indefinitely.
If
a
log
file
already
exists,
new
data
is
appended
to
it.
v
If
the
max-size
value
is
greater
than
zero
(>
0),
then
a
rollover
is
performed
when
a
log
file
reaches
the
configured
threshold
value.
If
a
log
file
already
exists
at
startup,
new
data
is
appended
to
it.
106
IBM
Tivoli
Access
Manager
for
e-business:
WebSEAL
Administration
Guide