mirror of
https://git.openafs.org/openafs.git
synced 2025-01-31 21:47:45 +00:00
75 lines
3.5 KiB
XML
75 lines
3.5 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<refentry id="VLLog5">
|
|
<refmeta>
|
|
<refentrytitle>VLLog</refentrytitle>
|
|
<manvolnum>5</manvolnum>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>VLLog</refname>
|
|
<refpurpose>Traces Volume Location Server operations</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<para>The <replaceable>VLLog</replaceable> file records a trace of Volume Location (VL) Server
|
|
(<emphasis role="bold">vlserver</emphasis> process) operations on the local machine and describes any
|
|
error conditions it encounters.</para>
|
|
|
|
<para>If the <replaceable>VLLog</replaceable> file does not already exist in the
|
|
<replaceable>/usr/afs/logs</replaceable> directory when the VL Server starts, the server
|
|
process creates it and writes initial start-up messages to it. If there
|
|
is an existing file, the VL Server renames it to <replaceable>VLLog.old</replaceable>,
|
|
overwriting the existing <replaceable>VLLog.old</replaceable> file if it exists.</para>
|
|
|
|
<para>The file is in ASCII format. Administrators listed in the
|
|
<replaceable>/usr/afs/etc/UserList</replaceable> file can use the <emphasis role="bold">bos getlog</emphasis> 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 <emphasis role="bold">cat</emphasis> command. By
|
|
default, the mode bits on the <replaceable>VLLog</replaceable> file grant the required <computeroutput>r</computeroutput> (read)
|
|
permission to all users.</para>
|
|
|
|
<para>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.</para>
|
|
|
|
<para>The VL Server can record messages at three levels of detail. By default,
|
|
it records only very rudimentary messages. To increase logging to the
|
|
first level of detail, issue the following command while logged onto the
|
|
database server machine as the local superuser <computeroutput>root</computeroutput>.</para>
|
|
|
|
<programlisting>
|
|
# kill -TSTP &lt;vlserver_pid&gt;
|
|
|
|
</programlisting>
|
|
<para>where <vlserver_pid> is the process ID of the vlserver process, as
|
|
reported in the output from the standard UNIX <emphasis role="bold">ps</emphasis> command. To increase
|
|
to the second and third levels of detail, repeat the command.</para>
|
|
|
|
<para>To disable logging, issue the following command.</para>
|
|
|
|
<programlisting>
|
|
# kill -HUP &lt;vlserver_pid&gt;
|
|
|
|
</programlisting>
|
|
<para>To decrease the level of logging, first completely disable it and then
|
|
issue the <computeroutput>kill -TSTP</computeroutput> command as many times as necessary to reach the
|
|
desired level.</para>
|
|
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
<para><link linkend="UserList5">UserList(5)</link>,
|
|
<link linkend="bos_getlog8">bos_getlog(8)</link>,
|
|
<link linkend="vlserver8">vlserver(8)</link></para>
|
|
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>Copyright</title>
|
|
<para>IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.</para>
|
|
|
|
<para>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.</para>
|
|
|
|
</refsect1>
|
|
</refentry>
|