1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
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">
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="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>
18 <H2><A NAME="HDRCACHEINFO" HREF="auarf002.htm#ToC_41">cacheinfo</A></H2>
19 <P><STRONG>Purpose</STRONG>
20 <P>Defines configuration parameters for the Cache Manager
21 <P><STRONG>Description</STRONG>
22 <P>The <B>cacheinfo</B> file defines configuration parameters for the
23 Cache Manager, which reads the file as it initializes.
24 <P>The file contains a single line of ASCII text and must reside in the
25 <B>/usr/vice/etc</B> directory. Use a text editor to create it
26 during initial configuration of the client machine; the required format
28 <PRE> <VAR>mount_dir</VAR>:<VAR>cache_dir</VAR>:<VAR>cache_size</VAR>
33 <P><DT><B><VAR>mount_dir</VAR>
34 </B><DD>Names the local disk directory at which the Cache Manager mounts the AFS
35 namespace. It must exist before the <B>afsd</B> program
36 runs. The conventional value is <B>/afs</B>. Using any other
37 value prevents traversal of pathnames that begin with <B>/afs</B> (such as
38 pathnames to files in foreign cells that do use the conventional name).
39 The <B>-mountdir</B> argument to the <B>afsd</B> command overrides
41 <P><DT><B><VAR>cache_dir</VAR>
42 </B><DD>Names the local disk directory to use as a cache. It must exist
43 before the <B>afsd</B> program runs. The standard value is
44 <B>/usr/vice/cache</B>, but it is acceptable to substitute a directory on
45 a partition with more available space. Although the Cache Manager
46 ignores this field when configuring a memory cache, a value must always appear
47 in it. The <B>-cachedir</B> argument to the <B>afsd</B> command
49 <P><DT><B><VAR>cache_size</VAR>
50 </B><DD>Specifies the cache size as a number of 1-kilobyte blocks. Larger
51 caches generally yield better performance, but a disk cache must not exceed
52 90% of the space available on the cache partition (85% for AIX systems), and a
53 memory cache must use no more than 25% of available machine memory.
54 <P>The <B>-blocks</B> argument to the <B>afsd</B> command overrides
55 this value. To reset cache size without rebooting on a machine that
56 uses disk caching, use the <B>fs setcachesize</B> command. To
57 display the current size of a disk or memory cache between reboots, use the
58 <B>fs getcacheparms</B> command.
60 <P><STRONG>Examples</STRONG>
61 <P>The following example <B>cacheinfo</B> file mounts the AFS namespace at
62 <B>/afs</B>, establishes a disk cache in the <B>/usr/vice/cache</B>
63 directory, and defines cache size as 50,000 1-kilobyte blocks.
64 <PRE> /afs:/usr/vice/cache:50000
67 <P><STRONG>Related Information</STRONG>
68 <P><A HREF="auarf058.htm#HDRAFSD">afsd</A>
69 <P><A HREF="auarf143.htm#HDRFS_GETCACHEPARMS">fs getcacheparms</A>
70 <P><A HREF="auarf158.htm#HDRFS_SETCACHESIZE">fs setcachesize</A>
72 <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>
73 <!-- Begin Footer Records ========================================== -->
75 <br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
77 <!-- End Footer Records ============================================ -->
78 <A NAME="Bot_Of_Page"></A>