Commit | Line | Data |
---|---|---|
805e021f CE |
1 | =head1 NAME |
2 | ||
3 | VLLog - Traces Volume Location Server operations | |
4 | ||
5 | =head1 DESCRIPTION | |
6 | ||
7 | The F<VLLog> file records a trace of Volume Location (VL) Server | |
8 | (B<vlserver> process) operations on the local machine and describes any | |
9 | error conditions it encounters. | |
10 | ||
11 | If the F<VLLog> file does not already exist in the | |
12 | F</usr/afs/logs> directory when the VL Server starts, the server | |
13 | process creates it and writes initial start-up messages to it. | |
14 | ||
15 | The file is in ASCII format. Administrators listed in the | |
16 | F</usr/afs/etc/UserList> file can use the B<bos getlog> command to display | |
17 | its contents. Alternatively, log onto the server machine and use a text | |
18 | editor or a file display command such as the UNIX B<cat> command. By | |
19 | default, the mode bits on the F<VLLog> file grant the required C<r> (read) | |
20 | permission to all users. | |
21 | ||
22 | The VL Server records operations only as it completes them, and cannot | |
23 | recover from failures by reviewing the file. The log contents are useful | |
24 | for administrative evaluation of process failures and other problems. | |
25 | ||
26 | The VL Server can record messages at several levels of detail. By default, it | |
27 | records only very rudimentary messages. The initial level of detail | |
28 | logged by the VL Server can be set by using the B<-d> command | |
29 | line option (possibly multiple times) when it is started. | |
30 | ||
31 | To increase the level of detail logged by a running VL Server, issue | |
32 | the following command while logged onto the database server machine | |
33 | as the local superuser C<root>. | |
34 | ||
35 | # kill -TSTP <vlserver_pid> | |
36 | ||
37 | where <vlserver_pid> is the process ID of the vlserver process, as | |
38 | reported in the output from the standard UNIX B<ps> command. To increase | |
39 | to the second and third levels of detail, repeat the command. | |
40 | ||
41 | To disable logging, issue the following command. | |
42 | ||
43 | # kill -HUP <vlserver_pid> | |
44 | ||
45 | To decrease the level of logging, first completely disable it and then | |
46 | issue the C<kill -TSTP> command as many times as necessary to reach the | |
47 | desired level. | |
48 | ||
49 | =head1 SEE ALSO | |
50 | ||
51 | L<UserList(5)>, | |
52 | L<bos_getlog(8)>, | |
53 | L<vlserver(8)> | |
54 | ||
55 | =head1 COPYRIGHT | |
56 | ||
57 | IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved. | |
58 | ||
59 | This documentation is covered by the IBM Public License Version 1.0. It was | |
60 | converted from HTML to POD by software written by Chas Williams and Russ | |
61 | Allbery, based on work by Alf Wachsmann and Elizabeth Cassell. |