doc/html/UserGuide/auusg009.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>User Guide</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3629/auusg000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 2 Oct 2000 at 14:38:44                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Mon, 02 Oct 2000 14:38:42">
   8 <META HTTP-EQUIV="review" CONTENT="Tue, 02 Oct 2001 14:38:42">
   9 <META HTTP-EQUIV="expires" CONTENT="Wed, 02 Oct 2002 14:38:42">
  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>User Guide</H1>
  16 <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="auusg008.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="auusg010.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>
  17 <HR><H1><A NAME="HDRWQ76" HREF="auusg002.htm#ToC_151">Troubleshooting</A></H1>
  18 <P>This chapter explains how to investigate and solve some
  19 problems you can sometimes encounter when working with AFS files. To
  20 use the instructions, find the heading that describes your problem or matches
  21 the error message you received.
  22 <HR><H2><A NAME="HDRWQ77" HREF="auusg002.htm#ToC_152">Problem:  Cannot Access, Copy, or Save File</A></H2>
  23 <P>
  24 <A NAME="IDX1120"></A>
  25 <A NAME="IDX1121"></A>
  26 <A NAME="IDX1122"></A>
  27 <A NAME="IDX1123"></A>
  28 <A NAME="IDX1124"></A>
  29 <A NAME="IDX1125"></A>
  30 <OL TYPE=1>
  31 <P><LI><A NAME="LINOSAVE-TOKENS"></A>Issue the <B>tokens</B> command to verify that you
  32 have valid tokens. For complete instructions, see <A HREF="auusg005.htm#HDRWQ30">To Display Your Tokens</A>.
  33 <PRE>   % <B>tokens</B>
  34 </PRE>
  35 <UL>
  36 <P><LI>If your tokens are valid, proceed to Step <A HREF="#LINOSAVE-FSCHECKS">2</A>.
  37 <P><LI>If your do not have tokens for the relevant cell, or they are expired,
  38 issue the <B>klog</B> command to authenticate. For complete
  39 instructions, see <A HREF="auusg005.htm#HDRWQ29">To Authenticate with AFS</A>. Then try accessing or saving the file again.
  40 If you are not successful, proceed to Step <A HREF="#LINOSAVE-FSCHECKS">2</A>.
  41 <PRE>   % <B>klog</B>
  42 </PRE>
  43 </UL>
  44 <P><LI><A NAME="LINOSAVE-FSCHECKS"></A>Issue the <B>fs checkservers</B> command to check
  45 the status of file server machines. For complete instructions, see <A HREF="auusg006.htm#HDRWQ41">Checking the Status of Server Machines</A>.
  46 <PRE>   % <B>fs checkservers &amp;</B>
  47 </PRE>
  48 <UL>
  49 <P><LI>If the following message appears, proceed to Step <A HREF="#LINOSAVE-PERMS">3</A>.
  50 <PRE>   All servers are running.
  51 </PRE>
  52 <P><LI>Output like the following indicates that your Cache Manager cannot reach
  53 the indicated file server machines.
  54 <PRE>   These servers unavailable due to network or server problem:
  55    <VAR>list&nbsp;of&nbsp;machines</VAR>.
  56 </PRE>
  57 <P>Issue the <B>fs whereis</B> command to check if the file you are
  58 attempting to access or save is stored on one of the inaccessible file server
  59 machines. For complete instructions, see <A HREF="auusg006.htm#HDRWQ40">Locating Files and Directories</A>.
  60 <PRE>   % <B>fs whereis</B> &lt;<VAR>dir/file&nbsp;path</VAR>>
  61 </PRE>
  62 <P>If your file is stored on an inaccessible machine, then you cannot access
  63 the file or save it back to the File Server until the machine is again
  64 accessible. If your file is on a machine that is not listed as
  65 inaccessible, proceed to Step <A HREF="#LINOSAVE-PERMS">3</A>.
  66 </UL>
  67 <P><LI><A NAME="LINOSAVE-PERMS"></A>Issue the <B>fs listacl</B> command to verify that
  68 you have the permissions you need for accessing, copying, or saving the
  69 file. For complete instructions, see <A HREF="auusg007.htm#HDRWQ53">To display an ACL</A>.
  70 <PRE>   % <B>fs listacl</B> &lt;<VAR>dir/file&nbsp;path</VAR>>
  71 </PRE>
  72 <P>You need the indicated permissions:
  73 <UL>
  74 <P><LI>To access, copy, or save a file, you must have the <B>l</B>
  75 (<B>lookup</B>) permission on the directory and on all directories above
  76 it in the pathname.
  77 <P><LI>To save changes to an existing file, you must in addition have the
  78 <B>w</B> (<B>write</B>) permission. To create a new file, you
  79 must in addition have the <B>i</B> (<B>insert</B>) and <B>w</B>
  80 permissions.
  81 <P><LI>To copy a file between two directories, you must in addition have the
  82 <B>r</B> (<B>read</B>) permission on the source directory and the
  83 <B>i</B> permission on the destination directory.
  84 </UL>
  85 <P>If you do not have the necessary permissions but own the directory, you
  86 always have the <B>a</B> (<B>administer</B>) permission even if you do
  87 not appear on the ACL. Issue the <B>fs setacl</B> command to grant
  88 yourself the necessary permissions. For complete instructions, see <A HREF="auusg007.htm#HDRWQ54">Changing an ACL</A>.
  89 <PRE>   % <B>fs setacl  -dir</B> &lt;<VAR>directory</VAR>><SUP>+</SUP> <B>-acl</B> &lt;<VAR>access&nbsp;list&nbsp;entries</VAR>><SUP>+</SUP>
  90 </PRE>
  91 <P>If you do not have the necessary permissions and do not own the directory,
  92 ask the owner or a system administrator to grant them to you. If they
  93 add you to a group that has the required permissions, you must issue the
  94 <B>klog</B> command to reauthenticate before you can exercise them.
  95 <P>If you still cannot access the file even though you have the necessary
  96 permissions, contact your system administrator for help in investigating
  97 further possible causes of your problem. If you still cannot copy or
  98 save the file even though you have the necessary permissions, proceed to Step <A HREF="#LINOSAVE-QUOTA">4</A>.
  99 <P><LI><A NAME="LINOSAVE-QUOTA"></A>If copying a file, issue the <B>fs listquota</B>
 100 command to check whether the volume into which you are copying it, or the
 101 partition that houses that volume, is almost full. For saving, check
 102 the volume and partition that contain the directory into which you are saving
 103 the file. For complete instructions, see <A HREF="auusg006.htm#HDRWQ39">Displaying Volume Quota</A>.
 104 <PRE>   % <B>fs listquota</B>  &lt;<VAR>dir/file&nbsp;path</VAR>>
 105 </PRE>
 106 <P>The command produces output as in the following example:
 107 <PRE>   % <B>fs listquota /afs/abc.com/usr/terry</B>
 108    Volume Name     Quota    Used    % Used   Partition
 109    user.terry      10000    3400       34%         86%
 110 </PRE>
 111 <UL>
 112 <P><LI>If the value in the <TT>Partition</TT> field is not close to 100%, the
 113 partition is not almost full. Check the value in the <TT>% Used</TT>
 114 field. If it is close to 100%, then the volume is almost full.
 115 If possible, delete files from the volume that are no longer needed, or ask
 116 your system administrator to increase the volume's quota.
 117 <P>If the value in the <TT>% Used</TT> field is not close to 100% (is, say,
 118 90% or less), then it is unlikely that you are exceeding the volume's
 119 quota, unless the file is very large or the volume's quota is
 120 small. Contact your system administrator for help in investigating
 121 further possible causes of your problem.
 122 <P><LI>If the value in the <TT>Partition</TT> field is very close to 100%, the
 123 partition is possibly nearly full. However, server machine partitions
 124 are usually very large and can still have enough space for an average file
 125 when nearly full. You can either ask your system administrator about
 126 the partition's status, or issue the <B>fs examine</B>
 127 command. The final line in its output reports how many kilobyte blocks
 128 are still available on the partition. For complete instructions, see <A HREF="auusg006.htm#HDRWQ39">Displaying Volume Quota</A>.
 129 <PRE>   % <B>fs examine</B>  &lt;<VAR>dir/file&nbsp;path</VAR>>
 130 </PRE>
 131 <P>If there is enough free space on the partition but you still cannot save
 132 the file, ask your system administrator for help in investigating further
 133 possible causes of your problem.
 134 </UL>
 135 </OL>
 136 <HR><H2><A NAME="HDRWQ78" HREF="auusg002.htm#ToC_153">Problem:  Accidentally Removed Your Entry from an ACL</A></H2>
 137 <P>
 138 <A NAME="IDX1126"></A>
 139 <A NAME="IDX1127"></A>
 140 <OL TYPE=1>
 141 <P><LI>If you own the directory from which you have accidentally removed your ACL
 142 entry, then you actually still have the <B>a</B> (<B>administer</B>)
 143 permission even if it does not appear on the ACL. You normally own your
 144 home directory and all of its subdirectories, for instance. Issue the
 145 <B>fs setacl</B> command to grant yourself all other permissions.
 146 For complete instructions, see <A HREF="auusg007.htm#HDRWQ55">To Add, Remove, or Edit Normal ACL Permissions</A>.
 147 <PRE>   % <B>fs setacl  -dir</B> &lt;<VAR>directory</VAR>> <B>-acl &lt;</B><VAR>your_username</VAR>> <B>all</B>
 148 </PRE>
 149 <P>For <VAR>directory</VAR>, provide the complete pathname to the directory (for
 150 example, <B>/afs/abc.com/usr/</B><VAR>your_username</VAR>).
 151 This is necessary because AFS cannot interpret pathname abbreviations if you
 152 do not have the <B>l</B> (<B>lookup</B>) permission.
 153 <P><LI>If you do not own the directory, issue the <B>fs listacl</B> to check
 154 if any remaining entries grant you the permissions you need (perhaps you
 155 belong to one or more groups that appear on the ACL). For complete
 156 instructions, see <A HREF="auusg007.htm#HDRWQ53">To display an ACL</A>.
 157 <PRE>   % <B>fs listacl</B> &lt;<VAR>dir/file&nbsp;path</VAR>>
 158 </PRE>
 159 <UL>
 160 <P><LI>The following message displays the directory's ACL. If you
 161 need permissions that no entry currently grants you, ask the directory's
 162 owner or your system administrator for help.
 163 <PRE>   Access list for &lt;<VAR>dir/file&nbsp;path</VAR>> is
 164    Normal rights
 165    <VAR>list of entries</VAR>
 166 </PRE>
 167 <P><LI>If the command returns the following error message instead of an ACL, then
 168 you do not have the <B>l</B> permission.
 169 <PRE>   fs: You don't have the required access rights on '<VAR>dir/file&nbsp;path</VAR>'
 170 </PRE>
 171 <P>Ask the directory's owner or your system administrator to grant you
 172 the permissions you need. If they add you to a group that has the
 173 required permissions, you must issue the <B>klog</B> command to
 174 reauthenticate before you can exercise them.
 175 </UL>
 176 </OL>
 177 <HR><H2><A NAME="HDRWQ79" HREF="auusg002.htm#ToC_154">Error Message: "afs: Lost contact with fileserver"</A></H2>
 178 <A NAME="IDX1128"></A>
 179 <A NAME="IDX1129"></A>
 180 <A NAME="IDX1130"></A>
 181 <P>Issue the <B>fs checkservers</B> command to check the status of file
 182 server machines. For complete instructions, see <A HREF="auusg006.htm#HDRWQ41">Checking the Status of Server Machines</A>.
 183 <PRE>   % <B>fs checkservers &amp;</B>
 184 </PRE>
 185 <UL>
 186 <P><LI>If the following message appears, ask your system administrator for
 187 assistance in diagnosing the cause of the <TT>Lost contact</TT> error
 188 message.
 189 <PRE>   All servers are running.
 190 </PRE>
 191 <P><LI>Output like the following indicates that your Cache Manager cannot reach
 192 the indicated file server machines. You must wait until they are again
 193 accessible before continuing to work with the files that are stored on
 194 them.
 195 <PRE>   These servers unavailable due to network or server problem:
 196    <VAR>list_of_machines</VAR>.
 197 </PRE>
 198 </UL>
 199 <A NAME="IDX1131"></A>
 200 <HR><H2><A NAME="Header_155" HREF="auusg002.htm#ToC_155">Error Message: "<VAR>command</VAR>: Connection timed out"</A></H2>
 201 <P>Issue the <B>fs checkservers</B> command as described in <A HREF="#HDRWQ79">Error Message:  afs: Lost contact with fileserver</A>.
 202 <A NAME="IDX1132"></A>
 203 <HR><H2><A NAME="Header_156" HREF="auusg002.htm#ToC_156">Error Message: "fs:  You don't have the required access rights on '<VAR>file</VAR>'"</A></H2>
 204 <P>You do not have the ACL permissions you need to perform the operation
 205 you are attempting. If you own the directory and have accidentally
 206 removed yourself from the ACL, see <A HREF="#HDRWQ78">Problem:  Accidentally Removed Your Entry from an ACL</A>. Otherwise, ask the directory's owner or your
 207 system administrator to grant you the appropriate permissions.
 208 <A NAME="IDX1133"></A>
 209 <A NAME="IDX1134"></A>
 210 <HR><H2><A NAME="Header_157" HREF="auusg002.htm#ToC_157">Error Message:  "afs:  failed to store file"</A></H2>
 211 <P>Follow the instructions in <A HREF="#HDRWQ77">Problem:  Cannot Access, Copy, or Save File</A>.
 212 <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="auusg008.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="auusg010.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>
 213 <!-- Begin Footer Records  ========================================== -->
 214 <P><HR><B>
 215 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 216 </B>
 217 <!-- End Footer Records  ============================================ -->
 218 <A NAME="Bot_Of_Page"></A>
 219 </BODY></HTML>