doc/html/AdminReference/auarf038.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <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>
  17 <P>
  18 <H2><A NAME="HDRVLLOG" HREF="auarf002.htm#ToC_36">VLLog</A></H2>
  19 <P><STRONG>Purpose</STRONG>
  20 <A NAME="IDX3994"></A>
  21 <A NAME="IDX3995"></A>
  22 <A NAME="IDX3996"></A>
  23 <P>Traces Volume Location Server operations
  24 <P><STRONG>Description</STRONG>
  25 <P>The <B>VLLog</B> file records a trace of Volume Location (VL) Server
  26 (<B>vlserver</B> process) operations on the local machine and describes
  27 any error conditions it encounters.
  28 <P>If the <B>VLLog</B> file does not already exist in the
  29 <B>/usr/afs/logs</B> directory when the VL Server starts, the server
  30 process creates it and writes initial start-up messages to it. If there
  31 is an existing file, the VL Server renames it to <B>VLLog.old</B>,
  32 overwriting the existing <B>VLLog.old</B> file if it exists.
  33 <P>The file is in ASCII format. Administrators listed in the
  34 <B>/usr/afs/etc/UserList</B> file can use the <B>bos getlog</B>
  35 command to display its contents. Alternatively, log onto the server
  36 machine and use a text editor or a file display command such as the UNIX
  37 <B>cat</B> command. By default, the mode bits on the
  38 <B>VLLog</B> file grant the required <B>r</B> (<B>read</B>)
  39 permission to all users.
  40 <P>The VL Server records operations only as it completes them, and cannot
  41 recover from failures by reviewing the file. The log contents are
  42 useful for administrative evaluation of process failures and other
  43 problems.
  44 <P>The VL Server can record messages at three levels of detail. By
  45 default, it records only very rudimentary messages. To increase logging
  46 to the first level of detail, issue the following command while logged onto
  47 the database server machine as the local superuser <B>root</B>.
  48 <PRE>   # <B>kill -TSTP</B> <VAR>vlserver_pid</VAR>
  49
  50 </PRE>
  51 <P>where <VAR>vlserver_pid</VAR> is the process ID of the <B>vlserver</B>
  52 process, as reported in the output from the standard UNIX <B>ps</B>
  53 command. To increase to the second and third levels of detail, repeat
  54 the command.
  55 <P>To disable logging, issue the following command.
  56 <PRE>
  57    # <B>kill -HUP</B> <VAR>vlserver_pid</VAR>
  58
  59 </PRE>
  60 <P>To decrease the level of logging, first completely disable it and then
  61 issue the <B>kill -TSTP</B> command as many times as necessary to reach
  62 the desired level.
  63 <P><STRONG>Related Information</STRONG>
  64 <P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
  65 <P><A HREF="auarf102.htm#HDRBOS_GETLOG">bos getlog</A>
  66 <P><A HREF="auarf249.htm#HDRVLSERVER">vlserver</A>
  67 <P>
  68 <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>
  69 <!-- Begin Footer Records  ========================================== -->
  70 <P><HR><B>
  71 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
  72 </B>
  73 <!-- End Footer Records  ============================================ -->
  74 <A NAME="Bot_Of_Page"></A>
  75 </BODY></HTML>