mirror of
https://git.openafs.org/openafs.git
synced 2025-01-31 13:38:01 +00:00
f5f057ce81
Mention the vlserver -d option can be used to set the initial logging level. Thanks to Mark Vitale for the suggestion. Change-Id: Ia17a2063432343c2cf78e1b01c5897751625aae8 Reviewed-on: https://gerrit.openafs.org/12324 Tested-by: BuildBot <buildbot@rampaginggeek.com> Reviewed-by: Benjamin Kaduk <kaduk@mit.edu>
62 lines
2.2 KiB
Plaintext
62 lines
2.2 KiB
Plaintext
=head1 NAME
|
|
|
|
VLLog - Traces Volume Location Server operations
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The F<VLLog> file records a trace of Volume Location (VL) Server
|
|
(B<vlserver> process) operations on the local machine and describes any
|
|
error conditions it encounters.
|
|
|
|
If the F<VLLog> file does not already exist in the
|
|
F</usr/afs/logs> directory when the VL Server starts, the server
|
|
process creates it and writes initial start-up messages to it.
|
|
|
|
The file is in ASCII format. Administrators listed in the
|
|
F</usr/afs/etc/UserList> file can use the B<bos getlog> command to display
|
|
its contents. Alternatively, log onto the server machine and use a text
|
|
editor or a file display command such as the UNIX B<cat> command. By
|
|
default, the mode bits on the F<VLLog> file grant the required C<r> (read)
|
|
permission to all users.
|
|
|
|
The VL Server records operations only as it completes them, and cannot
|
|
recover from failures by reviewing the file. The log contents are useful
|
|
for administrative evaluation of process failures and other problems.
|
|
|
|
The VL Server can record messages at several levels of detail. By default, it
|
|
records only very rudimentary messages. The initial level of detail
|
|
logged by the VL Server can be set by using the B<-d> command
|
|
line option (possibly multiple times) when it is started.
|
|
|
|
To increase the level of detail logged by a running VL Server, issue
|
|
the following command while logged onto the database server machine
|
|
as the local superuser C<root>.
|
|
|
|
# kill -TSTP <vlserver_pid>
|
|
|
|
where <vlserver_pid> is the process ID of the vlserver process, as
|
|
reported in the output from the standard UNIX B<ps> command. To increase
|
|
to the second and third levels of detail, repeat the command.
|
|
|
|
To disable logging, issue the following command.
|
|
|
|
# kill -HUP <vlserver_pid>
|
|
|
|
To decrease the level of logging, first completely disable it and then
|
|
issue the C<kill -TSTP> command as many times as necessary to reach the
|
|
desired level.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<UserList(5)>,
|
|
L<bos_getlog(8)>,
|
|
L<vlserver(8)>
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
|
|
|
|
This documentation is covered by the IBM Public License Version 1.0. It was
|
|
converted from HTML to POD by software written by Chas Williams and Russ
|
|
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
|