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

80 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="auarf042.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="auarf044.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="HDRCACHEINFO" HREF="auarf002.htm#ToC_41">cacheinfo</A></H2>
<P><STRONG>Purpose</STRONG>
<P>Defines configuration parameters for the Cache Manager
<P><STRONG>Description</STRONG>
<P>The <B>cacheinfo</B> file defines configuration parameters for the
Cache Manager, which reads the file as it initializes.
<P>The file contains a single line of ASCII text and must reside in the
<B>/usr/vice/etc</B> directory. Use a text editor to create it
during initial configuration of the client machine; the required format
is as follows:
<PRE> <VAR>mount_dir</VAR>:<VAR>cache_dir</VAR>:<VAR>cache_size</VAR>
</PRE>
<P>where
<DL>
<P><DT><B><VAR>mount_dir</VAR>
</B><DD>Names the local disk directory at which the Cache Manager mounts the AFS
namespace. It must exist before the <B>afsd</B> program
runs. The conventional value is <B>/afs</B>. Using any other
value prevents traversal of pathnames that begin with <B>/afs</B> (such as
pathnames to files in foreign cells that do use the conventional name).
The <B>-mountdir</B> argument to the <B>afsd</B> command overrides
this value.
<P><DT><B><VAR>cache_dir</VAR>
</B><DD>Names the local disk directory to use as a cache. It must exist
before the <B>afsd</B> program runs. The standard value is
<B>/usr/vice/cache</B>, but it is acceptable to substitute a directory on
a partition with more available space. Although the Cache Manager
ignores this field when configuring a memory cache, a value must always appear
in it. The <B>-cachedir</B> argument to the <B>afsd</B> command
overrides this value.
<P><DT><B><VAR>cache_size</VAR>
</B><DD>Specifies the cache size as a number of 1-kilobyte blocks. Larger
caches generally yield better performance, but a disk cache must not exceed
90% of the space available on the cache partition (85% for AIX systems), and a
memory cache must use no more than 25% of available machine memory.
<P>The <B>-blocks</B> argument to the <B>afsd</B> command overrides
this value. To reset cache size without rebooting on a machine that
uses disk caching, use the <B>fs setcachesize</B> command. To
display the current size of a disk or memory cache between reboots, use the
<B>fs getcacheparms</B> command.
</DL>
<P><STRONG>Examples</STRONG>
<P>The following example <B>cacheinfo</B> file mounts the AFS namespace at
<B>/afs</B>, establishes a disk cache in the <B>/usr/vice/cache</B>
directory, and defines cache size as 50,000 1-kilobyte blocks.
<PRE> /afs:/usr/vice/cache:50000
</PRE>
<P><STRONG>Related Information</STRONG>
<P><A HREF="auarf058.htm#HDRAFSD">afsd</A>
<P><A HREF="auarf143.htm#HDRFS_GETCACHEPARMS">fs getcacheparms</A>
<P><A HREF="auarf158.htm#HDRFS_SETCACHESIZE">fs setcachesize</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="auarf042.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="auarf044.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>