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

83 lines
4.7 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="auarf043.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="auarf045.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="HDRFMSLOG" HREF="auarf002.htm#ToC_42">fms.log</A></H2>
<P><STRONG>Purpose</STRONG>
<P>Records output from the <B>fms</B> command
<P><STRONG>Description</STRONG>
<P>The <B>fms.log</B> file records the output generated by the
<B>fms</B> command. The output includes two numbers that can appear
in a tape device's entry in the <B>/usr/afs/backup/tapeconfig</B>
file on the Tape Coordinator machine to which the tape device is
attached:
<UL>
<P><LI>The capacity in bytes of the tape in the device
<P><LI>The size in bytes of the end-of-file (EOF) marks (often referred to simply
as <I>filemarks</I>) that the tape device writes
</UL>
<P>When transferring the numbers recorded in this file to the
<B>tapeconfig</B> file, adjust them as specified on the reference page for
the <B>tapeconfig</B> file, to improve Tape Coordinator performance during
dump operations.
<P>If the <B>fms.log</B> file does not already exist in the current
working directory, the <B>fms</B> command interpreter creates it.
In this case, the directory's mode bits must grant the <B>rwx</B>
(<B>read</B>, <B>write</B>, and <B>execute</B>) permissions to the
issuer of the command. If there is an existing file, the command
interpreter overwrites it, so the file's mode bits need to grant only the
<B>w</B> permission to the issuer of the <B>fms</B> command.
The <B>fms</B> command interpreter also writes similar information to the
standard output stream as it runs.
<P>The file is in ASCII format. To display its contents, log onto the
client 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>fms.log</B> file grant the required <B>r</B> permission only
to the owner (which is the local superuser <B>root</B> by default).
<P><STRONG>Output</STRONG>
<P>The first few lines of the file provide a simple trace of the
<B>fms</B> command interpreter's actions, specifying (for example)
how many blocks it wrote on the tape. The final two lines in the file
specify tape capacity and filemark size in bytes, using the following
format:
<PRE> Tape capacity is <VAR>tape_size</VAR> bytes
File marks are <VAR>filemark_size</VAR> bytes
</PRE>
<P><STRONG>Examples</STRONG>
<P>The following example of the <B>fms.log</B> file specifies that
the tape used during the execution of the <B>fms</B> command had a
capacity of 2,136,604,672 bytes, and that the tape device writes filemarks of
size 1,910,220 bytes.
<PRE> fms test started
wrote 130408 blocks
Tape capacity is 2136604672 bytes
File marks are 1910220 bytes
</PRE>
<P><STRONG>Related Information</STRONG>
<P><A HREF="auarf050.htm#HDRTAPECONFIG">tapeconfig</A>
<P><A HREF="auarf130.htm#HDRFMS">fms</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="auarf043.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="auarf045.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>