openafs/doc/html/AdminReference/auarf038.htm
Derrick Brashear d7da1acc31 initial-html-documentation-20010606
pull in all documentation from IBM
2001-06-06 19:09:07 +00:00

76 lines
4.4 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
<HTML><HEAD>
<TITLE>Administration Reference</TITLE>
<!-- Begin Header Records ========================================== -->
<!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
<!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
<META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
<META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
<META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
</HEAD><BODY>
<!-- (C) IBM Corporation 2000. All Rights Reserved -->
<BODY bgcolor="ffffff">
<!-- End Header Records ============================================ -->
<A NAME="Top_Of_Page"></A>
<H1>Administration Reference</H1>
<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf037.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf039.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
<P>
<H2><A NAME="HDRVLLOG" HREF="auarf002.htm#ToC_36">VLLog</A></H2>
<P><STRONG>Purpose</STRONG>
<A NAME="IDX3994"></A>
<A NAME="IDX3995"></A>
<A NAME="IDX3996"></A>
<P>Traces Volume Location Server operations
<P><STRONG>Description</STRONG>
<P>The <B>VLLog</B> file records a trace of Volume Location (VL) Server
(<B>vlserver</B> process) operations on the local machine and describes
any error conditions it encounters.
<P>If the <B>VLLog</B> file does not already exist in the
<B>/usr/afs/logs</B> 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 <B>VLLog.old</B>,
overwriting the existing <B>VLLog.old</B> file if it exists.
<P>The file is in ASCII format. Administrators listed in the
<B>/usr/afs/etc/UserList</B> file can use the <B>bos getlog</B>
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</B> command. By default, the mode bits on the
<B>VLLog</B> file grant the required <B>r</B> (<B>read</B>)
permission to all users.
<P>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.
<P>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 <B>root</B>.
<PRE> # <B>kill -TSTP</B> <VAR>vlserver_pid</VAR>
</PRE>
<P>where <VAR>vlserver_pid</VAR> is the process ID of the <B>vlserver</B>
process, as reported in the output from the standard UNIX <B>ps</B>
command. To increase to the second and third levels of detail, repeat
the command.
<P>To disable logging, issue the following command.
<PRE>
# <B>kill -HUP</B> <VAR>vlserver_pid</VAR>
</PRE>
<P>To decrease the level of logging, first completely disable it and then
issue the <B>kill -TSTP</B> command as many times as necessary to reach
the desired level.
<P><STRONG>Related Information</STRONG>
<P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
<P><A HREF="auarf102.htm#HDRBOS_GETLOG">bos getlog</A>
<P><A HREF="auarf249.htm#HDRVLSERVER">vlserver</A>
<P>
<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf037.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf039.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
<!-- Begin Footer Records ========================================== -->
<P><HR><B>
<br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
</B>
<!-- End Footer Records ============================================ -->
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>