+++ /dev/null
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
-<HTML><HEAD>
-<TITLE>User Guide</TITLE>
-<!-- Begin Header Records ========================================== -->
-<!-- /tmp/idwt3629/auusg000.scr converted by idb2h R4.2 (359) ID -->
-<!-- Workbench Version (AIX) on 2 Oct 2000 at 14:38:44 -->
-<META HTTP-EQUIV="updated" CONTENT="Mon, 02 Oct 2000 14:38:42">
-<META HTTP-EQUIV="review" CONTENT="Tue, 02 Oct 2001 14:38:42">
-<META HTTP-EQUIV="expires" CONTENT="Wed, 02 Oct 2002 14:38:42">
-</HEAD><BODY>
-<!-- (C) IBM Corporation 2000. All Rights Reserved -->
-<BODY bgcolor="ffffff">
-<!-- End Header Records ============================================ -->
-<A NAME="Top_Of_Page"></A>
-<H1>User Guide</H1>
-<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auusg002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auusg005.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="auusg007.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auusg013.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
-<HR><H1><A NAME="HDRWQ38" HREF="auusg002.htm#ToC_61">Displaying Information about AFS</A></H1>
-<P>This chapter explains how to display information that can
-help you use AFS more effectively. It includes the following
-sections.
-<DL>
-<DD><P><A HREF="#HDRWQ39">Displaying Volume Quota</A>
-<DD><P><A HREF="#HDRWQ40">Locating Files and Directories</A>.
-<DD><P><A HREF="#HDRWQ41">Checking the Status of Server Machines</A>
-<DD><P><A HREF="#HDRWQ42">Determining Access to Foreign Cells</A>
-<DD><P><A HREF="#HDRWQ43">Displaying Server Preference Ranks</A>
-</DL>
-<HR><H2><A NAME="HDRWQ39" HREF="auusg002.htm#ToC_62">Displaying Volume Quota</A></H2>
-<P>By convention, the files in your home directory are stored
-together in a single volume. (For information about volumes, see <A HREF="auusg004.htm#HDRWQ6">Volumes and Mount Points</A>.) To allocate your cell's available disk space
-as fairly as possible, your system administrators impose a size limit, or
-<I>quota</I>, on each volume. You cannot store more data in a
-volume than its quota allows. If a volume is close to its quota, you
-sometimes cannot save changes you have made to files stored in the
-volume.
-<P>The amount of space available on the partition that houses the volume also
-limits how large the volume can grow. If the disk partition is full,
-you can become unable to save changes to a file even though the volume is not
-close to its quota.
-<A NAME="IDX884"></A>
-<A NAME="IDX885"></A>
-<P>Check the quota on your home volume periodically to make sure you have
-adequate space. Also, if you encounter problems saving a file, check
-the quota of the volume in which the file is stored. Use the following
-commands to display volume quota.
-<UL>
-<P><LI>The <B>fs quota</B> command lists the percentage of the volume quota
-used.
-<P><LI>Both the <B>fs listquota</B> and <B>fs examine</B> commands list
-the volume name, its maximum size (quota), and its current size. They
-also report the following additional information.
-<UL>
-<P><LI>The <B>fs listquota</B> command lists the percentage used of both the
-volume and the partition.
-<P><LI>The <B>fs examine</B> command lists the partition's size, the
-amount of space currently used, and any messages associated with the
-volume.
-</UL>
-</UL>
-<P><H3><A NAME="Header_63" HREF="auusg002.htm#ToC_63">To Display Percentage of Quota Used</A></H3>
-<A NAME="IDX886"></A>
-<A NAME="IDX887"></A>
-<A NAME="IDX888"></A>
-<A NAME="IDX889"></A>
-<P>Issue the <B>fs quota</B> command to display the percentage of the
-quota currently used for the volume that contains a specified directory or
-file.
-<PRE> % <B>fs quota</B> [<<VAR>dir/file path</VAR>><SUP>+</SUP>]
-</PRE>
-<P>where <VAR>dir/file path</VAR> specifies the pathname of a file or directory
-in each volume for which to display quota information. If you do not
-provide a pathname, the output reports quota information for the volume that
-contains the current working directory.
-<P><H3><A NAME="Header_64" HREF="auusg002.htm#ToC_64">Example: Displaying Percentage of Quota Used</A></H3>
-<P>
-<A NAME="IDX890"></A>
-The following example displays the percentage of quota used for the volumes
-that contain two user home directories in the ABC Corporation cell.
-<PRE> % <B>cd /afs/abc.com/usr</B>
- % <B>fs quota terry pat</B>
- 34% of quota used.
- 85% of quota used.
-</PRE>
-<P><H3><A NAME="Header_65" HREF="auusg002.htm#ToC_65">To Display Quota and Other Information about a Volume</A></H3>
-<A NAME="IDX891"></A>
-<A NAME="IDX892"></A>
-<A NAME="IDX893"></A>
-<A NAME="IDX894"></A>
-<A NAME="IDX895"></A>
-<A NAME="IDX896"></A>
-<P>Issue the <B>fs listquota</B> command to display the following
-information:
-<UL>
-<P><LI>The name of the volume that houses each specified file or directory
-<P><LI>The quota, expressed as a number of kilobytes (<TT>1024</TT> indicates
-one megabyte)
-<P><LI>The current size of the volume (the number of kilobytes of currently used)
-<P><LI>The percentage of the quota used
-<P><LI>The percentage of space used on the disk partition housing the volume
-</UL>
-<P>The command's syntax is as follows.
-<PRE> % <B>fs listquota</B> [<<VAR>dir/file path</VAR>><SUP>+</SUP>]
-</PRE>
-<P>where <VAR>dir/file path</VAR> specifies the pathname of a file or directory
-in each volume for which to display quota information. If you do not
-provide a pathname, the output reports quota information for the volume that
-contains the current working directory.
-<P><H3><A NAME="Header_66" HREF="auusg002.htm#ToC_66">Example: Display Quota and Other Information about a Volume</A></H3>
-<A NAME="IDX897"></A>
-<P>The following example displays quota information about the volume that
-houses the home directory of user <B>terry</B>.
-<PRE> % <B>fs listquota ~terry</B>
- Volume Name Quota Used % Used Partition
- user.terry 10000 3400 34% 86%
-</PRE>
-<P><H3><A NAME="Header_67" HREF="auusg002.htm#ToC_67">To Display Quota and Other Information about a Volume and Partition</A></H3>
-<A NAME="IDX898"></A>
-<A NAME="IDX899"></A>
-<A NAME="IDX900"></A>
-<A NAME="IDX901"></A>
-<A NAME="IDX902"></A>
-<A NAME="IDX903"></A>
-<P>Issue the <B>fs examine</B> command to display the following
-information about a volume and the partition it resides on:
-<UL>
-<P><LI>The volume's ID number (abbreviated in the output as <TT>vid</TT>)
-<P><LI>The volume name
-<P><LI>The volume's quota and current size, in kilobytes
-<P><LI>The number of kilobyte blocks available on the disk partition housing the
-volume and the total size of that partition
-<P><LI>An <I>off-line message</I> associated with the volume, if any, as set
-by a system administrator
-</UL>
-<P>The command's syntax is as follows.
-<PRE> % <B>fs examine</B> [<<VAR>dir/file path</VAR>><SUP>+</SUP>]
-</PRE>
-<P>where <VAR>dir/file path</VAR> specifies the pathname of a file or directory
-in each volume for which to display quota information. If you do not
-provide a pathname, the output reports quota information for the volume that
-contains the current working directory.
-<P><H3><A NAME="Header_68" HREF="auusg002.htm#ToC_68">Example: Displaying Quota and Other Information about a Volume and Partition</A></H3>
-<A NAME="IDX904"></A>
-<P>The following example displays quota and other information about the volume
-that houses the current working directory.
-<PRE> % <B>fs examine</B>
- Volume status for vid = 536871122 named user.terry
- Current disk quota is 10000
- Current blocks used are 5745
- The partition has 1593 blocks available out of 99162
-</PRE>
-<HR><H2><A NAME="HDRWQ40" HREF="auusg002.htm#ToC_69">Locating Files and Directories</A></H2>
-<A NAME="IDX905"></A>
-<A NAME="IDX906"></A>
-<P>Normally, you do not need to know which file server machine stores the
-volume containing a file or directory. Given the pathname to a file,
-the Cache Manager on your client machine automatically accesses the
-appropriate server machine.
-<P>If you become unable to access a file, however, it can be useful to know
-which file server machine houses it. You can then check whether the
-File Server process or machine is functioning correctly, as described in <A HREF="#HDRWQ41">Checking the Status of Server Machines</A>. Or, if your system administrators schedule downtime
-for a machine, you can learn whether the outage is likely to prevent you from
-accessing certain files.
-<P><H3><A NAME="Header_70" HREF="auusg002.htm#ToC_70">To Display a File or Directory's Location</A></H3>
-<A NAME="IDX907"></A>
-<A NAME="IDX908"></A>
-<A NAME="IDX909"></A>
-<A NAME="IDX910"></A>
-<P>Issue the <B>fs whereis</B> command to display the file server machine
-on which a file or directory is stored.
-<PRE> % <B>fs whereis</B> [<<VAR>dir/file path</VAR>><SUP>+</SUP>]
-</PRE>
-<P>where <VAR>dir/file path</VAR> specifies the pathname of each file or
-directory for which you want location information. If you do not
-provide a pathname, the output reports the machine housing the volume that
-contains the current working directory.
-<P>If the output mentions more than one machine, there is a copy of the volume
-at each site (the volume is <I>replicated</I>). Your system
-administrators can choose to replicate volumes that contain information many
-people need to use, both for load balancing reasons and to make the
-information available even if there is an outage on one machine that houses
-the volume.
-<P><H3><A NAME="Header_71" HREF="auusg002.htm#ToC_71">Example: Displaying Directory Location</A></H3>
-<A NAME="IDX911"></A>
-<P>The following example displays the names of the server machines that house
-the home volumes for users <B>terry</B> and <B>pat</B>.
-<PRE> % <B>cd /afs/abc.com/usr</B>
- % <B>fs whereis terry pat</B>
- File /afs/abc.com/usr/terry is on host fs2.abc.com
- File /afs/abc.com/usr/pat is on host fs3.abc.com
-</PRE>
-<HR><H2><A NAME="HDRWQ41" HREF="auusg002.htm#ToC_72">Checking the Status of Server Machines</A></H2>
-<A NAME="IDX912"></A>
-<A NAME="IDX913"></A>
-<A NAME="IDX914"></A>
-<P>Sometimes one or more server machines in your cell become inaccessible due
-to hardware problems, software problems, or routine maintenance. During
-the outage, you cannot access files stored on those machines or save any
-changes you have made to files that are stored on those machines. (Your
-Cache Manager possibly has copies of the files stored locally, which you can
-still work with.)
-<P>To check the status of server machines, use the <B>fs checkservers</B>
-command. If a server machine has more than one network interface
-address (is <I>multihomed</I>), the Cache Manager sends the
-status-checking message to all of the machine's interfaces. If at
-least one of the server's interfaces replies, the command's output
-reports the machine as accessible. If there is no reply from any of the
-interfaces, the output reports the machine as inaccessible but displays only
-one of the interfaces (usually the one with the best preference rank; see
-<A HREF="#HDRWQ43">Displaying Server Preference Ranks</A>).
-<P>To check the status of different groups of server machines, combine the
-<B>fs checkservers</B> command's options as indicated:
-<UL>
-<P><LI>To check file server machines in the local cell only, do not include any
-options
-<P><LI>To check file server machines in a particular foreign cell only, include
-the <B>-cell</B> argument
-<P><LI>To check every file server machine that your Cache Manager has contacted
-in any cell, include the <B>-all</B> flag
-</UL>
-<P>It can take several minutes for the command shell prompt to return, because
-the <B>fs</B> command interpreter waits a timeout period before concluding
-that an unresponsive machine is really inaccessible. To have the
-command shell prompt return immediately, add the ampersand (<B>&</B>),
-which runs the <B>fs checkservers</B> command in the background.
-<P><H3><A NAME="Header_73" HREF="auusg002.htm#ToC_73">To Check File Server Machine Status</A></H3>
-<A NAME="IDX915"></A>
-<A NAME="IDX916"></A>
-<P>Issue the <B>fs checkservers</B> command to check the status of file
-server machines.
-<PRE> % <B>fs checkservers</B> [<B>-cell</B> <<VAR>cell to check</VAR>>] [<B>-all</B>] [<B>&</B>]
-</PRE>
-<P>where
-<DL>
-<P><DT><B>-cell
-</B><DD>Names each cell for which to check server machine status. Do not
-combine this argument and the <B>-all</B> flag.
-<P><DT><B>-all
-</B><DD>Checks the status of all server machines. Do not combine this flag
-and the <B>-cell</B> argument.
-</DL>
-<P>The following message indicates that all server machines replied to the
-Cache Manager's status-checking message:
-<PRE> All servers are running.
-</PRE>
-<P>Otherwise, a message like the following lists the inaccessible
-machines:
-<PRE> These servers unavailable due to network or server problems: <VAR>list of machines</VAR>.
-</PRE>
-<P><H3><A NAME="Header_74" HREF="auusg002.htm#ToC_74">Example: Checking Server Machine Status</A></H3>
-<A NAME="IDX917"></A>
-<P>The following example checks the status of every file server machine the
-Cache Manager has contacted in any cell. Two machines are not
-responding.
-<PRE> % <B>fs checkservers -all &</B>
- These servers unavailable due to network or server problems:
- fs1.abc.com server7.stateu.edu.
-</PRE>
-<HR><H2><A NAME="HDRWQ42" HREF="auusg002.htm#ToC_75">Determining Access to Foreign Cells</A></H2>
-<A NAME="IDX918"></A>
-<P>The Cache Manager maintains a list of foreign cells that it knows how to
-reach. A cell must appear in the list for you to access its AFS
-filespace. (In addition, the ACL on each directory in the pathname to
-the file must grant you the necessary permissions, and your system
-administrator must mount the cell in the local AFS filespace--by
-convention, just under the <B>/afs</B> directory.)
-<P><H3><A NAME="Header_76" HREF="auusg002.htm#ToC_76">To Display Foreign Cells</A></H3>
-<A NAME="IDX919"></A>
-<A NAME="IDX920"></A>
-<P>Issue the <B>fs listcells</B> command to display the cells you can
-access from this client machine. It can take several minutes for the
-command shell prompt to return. The Cache Manager stores the machines
-as IP addresses, but has the addresses translated to names before displaying
-them. To have the command shell prompt return immediately, use the
-ampersand (<B>&</B>) to run the <B>fs listcells</B> command in the
-background as in the following example.
-<PRE> % <B>fs listcells &</B>
- Cell abc.com on hosts
- db1.abc.com
- db2.abc.com
- db3.abc.com
- Cell test.abc.com on hosts
- test4.abc.com.
- Cell stateu.edu on hosts
- sv5.stateu.edu.
- sv2.stateu.edu.
- sv11.stateu.edu.
- Cell def.com on hosts
- serverA.def.com
-</PRE>
-<HR><H2><A NAME="HDRWQ43" HREF="auusg002.htm#ToC_77">Displaying Server Preference Ranks</A></H2>
-<A NAME="IDX921"></A>
-<A NAME="IDX922"></A>
-<A NAME="IDX923"></A>
-<P>The Cache Manager stores a list of preference ranks for file server
-machines. When it needs to access a file or directory, the Cache
-Manager compares the ranks of the file server machines that house the relevant
-volume. It first tries to access the volume on the machine with the
-best rank. (If a file server machine is multihomed--has more than
-one network interface--the Cache Manager actually assigns a separate rank
-to each interface.)
-<P>The Cache Manager assigns a default rank to a file server machine interface
-by comparing its own IP address to the interface's IP address. It
-assigns a better rank to interfaces that are on its own subnetwork or network
-than to interfaces on other networks. Therefore, the ranks bias the
-Cache Manager to fetch files from file server machines that are close in terms
-of network distance, which tends to reduce network traffic and help the Cache
-Manager deliver data to applications more quickly.
-<P>The Cache Manager stores each rank as a pairing of a file server machine
-interface's IP address and an integer rank from the range <B>0</B> to
-<B>65,534</B>. A lower number is a better rank. To display
-the server preference ranks on the local client machine, use the <B>fs
-getserverprefs</B> command.
-<P>The Cache Manager stores a separate but similar set of ranks for Volume
-Location (VL) Servers, which tell the Cache Manager the location of volumes
-that house files and directories. To display those ranks, add the
-<B>-vlservers</B> flag to the <B>fs getserverprefs</B> command.
-<P>If the default ranks do not seem to result in the best performance, your
-system administrator can change them. Ask your system administrator
-about the ranks if appropriate.
-<P><H3><A NAME="Header_78" HREF="auusg002.htm#ToC_78">To Display Server Preference Ranks</A></H3>
-<P>Issue the <B>fs getserverprefs</B> command to display the file
-server machine preference ranks used by the Cache Manager on the local
-machine. To display VL Server ranks, add the <B>-vlservers</B>
-flag. By default, the Cache Manager has the IP address of each
-interface translated into a hostname before displaying it. To bypass
-the translation and display IP addresses, include the <B>-numeric</B>
-flag. This can significantly speed up the command's output.
-<PRE> % <B>fs getserverprefs</B> [<B>-numeric</B>] [<B>-vlservers</B>]
-</PRE>
-<P>The following example displays the file server machine preference ranks for
-a client machine in the <B>abc.com</B> cell. The ranks of
-the file server machines in that cell are lower than the ranks of the file
-server machines from the foreign cell, <B>def.com</B>.
-Because the <B>-numeric</B> flag is not used, the output displays
-hostnames. The appearance of an IP address for two machines indicates
-that translating them was not possible.
-<PRE> % <B>fs getserverprefs</B>
- fs2.abc.com 20007
- fs3.abc.com 30002
- fs1.abc.com 20011
- fs4.abc.com 30010
- server1.def.com 40002
- 192.12.105.34 40000
- server6.def.com 40012
- 192.12.105.37 40005
-</PRE>
-<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auusg002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auusg005.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="auusg007.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auusg013.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
-<!-- Begin Footer Records ========================================== -->
-<P><HR><B>
-<br>© <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>
git://git.openafs.org / openafs.git / blobdiff