mirror of
https://git.openafs.org/openafs.git
synced 2025-01-19 15:30:14 +00:00
220 lines
13 KiB
HTML
220 lines
13 KiB
HTML
<!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="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>
|
|
<HR><H1><A NAME="HDRWQ76" HREF="auusg002.htm#ToC_151">Troubleshooting</A></H1>
|
|
<P>This chapter explains how to investigate and solve some
|
|
problems you can sometimes encounter when working with AFS files. To
|
|
use the instructions, find the heading that describes your problem or matches
|
|
the error message you received.
|
|
<HR><H2><A NAME="HDRWQ77" HREF="auusg002.htm#ToC_152">Problem: Cannot Access, Copy, or Save File</A></H2>
|
|
<P>
|
|
<A NAME="IDX1120"></A>
|
|
<A NAME="IDX1121"></A>
|
|
<A NAME="IDX1122"></A>
|
|
<A NAME="IDX1123"></A>
|
|
<A NAME="IDX1124"></A>
|
|
<A NAME="IDX1125"></A>
|
|
<OL TYPE=1>
|
|
<P><LI><A NAME="LINOSAVE-TOKENS"></A>Issue the <B>tokens</B> command to verify that you
|
|
have valid tokens. For complete instructions, see <A HREF="auusg005.htm#HDRWQ30">To Display Your Tokens</A>.
|
|
<PRE> % <B>tokens</B>
|
|
</PRE>
|
|
<UL>
|
|
<P><LI>If your tokens are valid, proceed to Step <A HREF="#LINOSAVE-FSCHECKS">2</A>.
|
|
<P><LI>If your do not have tokens for the relevant cell, or they are expired,
|
|
issue the <B>klog</B> command to authenticate. For complete
|
|
instructions, see <A HREF="auusg005.htm#HDRWQ29">To Authenticate with AFS</A>. Then try accessing or saving the file again.
|
|
If you are not successful, proceed to Step <A HREF="#LINOSAVE-FSCHECKS">2</A>.
|
|
<PRE> % <B>klog</B>
|
|
</PRE>
|
|
</UL>
|
|
<P><LI><A NAME="LINOSAVE-FSCHECKS"></A>Issue the <B>fs checkservers</B> command to check
|
|
the status of file server machines. For complete instructions, see <A HREF="auusg006.htm#HDRWQ41">Checking the Status of Server Machines</A>.
|
|
<PRE> % <B>fs checkservers &</B>
|
|
</PRE>
|
|
<UL>
|
|
<P><LI>If the following message appears, proceed to Step <A HREF="#LINOSAVE-PERMS">3</A>.
|
|
<PRE> All servers are running.
|
|
</PRE>
|
|
<P><LI>Output like the following indicates that your Cache Manager cannot reach
|
|
the indicated file server machines.
|
|
<PRE> These servers unavailable due to network or server problem:
|
|
<VAR>list of machines</VAR>.
|
|
</PRE>
|
|
<P>Issue the <B>fs whereis</B> command to check if the file you are
|
|
attempting to access or save is stored on one of the inaccessible file server
|
|
machines. For complete instructions, see <A HREF="auusg006.htm#HDRWQ40">Locating Files and Directories</A>.
|
|
<PRE> % <B>fs whereis</B> <<VAR>dir/file path</VAR>>
|
|
</PRE>
|
|
<P>If your file is stored on an inaccessible machine, then you cannot access
|
|
the file or save it back to the File Server until the machine is again
|
|
accessible. If your file is on a machine that is not listed as
|
|
inaccessible, proceed to Step <A HREF="#LINOSAVE-PERMS">3</A>.
|
|
</UL>
|
|
<P><LI><A NAME="LINOSAVE-PERMS"></A>Issue the <B>fs listacl</B> command to verify that
|
|
you have the permissions you need for accessing, copying, or saving the
|
|
file. For complete instructions, see <A HREF="auusg007.htm#HDRWQ53">To display an ACL</A>.
|
|
<PRE> % <B>fs listacl</B> <<VAR>dir/file path</VAR>>
|
|
</PRE>
|
|
<P>You need the indicated permissions:
|
|
<UL>
|
|
<P><LI>To access, copy, or save a file, you must have the <B>l</B>
|
|
(<B>lookup</B>) permission on the directory and on all directories above
|
|
it in the pathname.
|
|
<P><LI>To save changes to an existing file, you must in addition have the
|
|
<B>w</B> (<B>write</B>) permission. To create a new file, you
|
|
must in addition have the <B>i</B> (<B>insert</B>) and <B>w</B>
|
|
permissions.
|
|
<P><LI>To copy a file between two directories, you must in addition have the
|
|
<B>r</B> (<B>read</B>) permission on the source directory and the
|
|
<B>i</B> permission on the destination directory.
|
|
</UL>
|
|
<P>If you do not have the necessary permissions but own the directory, you
|
|
always have the <B>a</B> (<B>administer</B>) permission even if you do
|
|
not appear on the ACL. Issue the <B>fs setacl</B> command to grant
|
|
yourself the necessary permissions. For complete instructions, see <A HREF="auusg007.htm#HDRWQ54">Changing an ACL</A>.
|
|
<PRE> % <B>fs setacl -dir</B> <<VAR>directory</VAR>><SUP>+</SUP> <B>-acl</B> <<VAR>access list entries</VAR>><SUP>+</SUP>
|
|
</PRE>
|
|
<P>If you do not have the necessary permissions and do not own the directory,
|
|
ask the owner or a system administrator to grant them to you. If they
|
|
add you to a group that has the required permissions, you must issue the
|
|
<B>klog</B> command to reauthenticate before you can exercise them.
|
|
<P>If you still cannot access the file even though you have the necessary
|
|
permissions, contact your system administrator for help in investigating
|
|
further possible causes of your problem. If you still cannot copy or
|
|
save the file even though you have the necessary permissions, proceed to Step <A HREF="#LINOSAVE-QUOTA">4</A>.
|
|
<P><LI><A NAME="LINOSAVE-QUOTA"></A>If copying a file, issue the <B>fs listquota</B>
|
|
command to check whether the volume into which you are copying it, or the
|
|
partition that houses that volume, is almost full. For saving, check
|
|
the volume and partition that contain the directory into which you are saving
|
|
the file. For complete instructions, see <A HREF="auusg006.htm#HDRWQ39">Displaying Volume Quota</A>.
|
|
<PRE> % <B>fs listquota</B> <<VAR>dir/file path</VAR>>
|
|
</PRE>
|
|
<P>The command produces output as in the following example:
|
|
<PRE> % <B>fs listquota /afs/abc.com/usr/terry</B>
|
|
Volume Name Quota Used % Used Partition
|
|
user.terry 10000 3400 34% 86%
|
|
</PRE>
|
|
<UL>
|
|
<P><LI>If the value in the <TT>Partition</TT> field is not close to 100%, the
|
|
partition is not almost full. Check the value in the <TT>% Used</TT>
|
|
field. If it is close to 100%, then the volume is almost full.
|
|
If possible, delete files from the volume that are no longer needed, or ask
|
|
your system administrator to increase the volume's quota.
|
|
<P>If the value in the <TT>% Used</TT> field is not close to 100% (is, say,
|
|
90% or less), then it is unlikely that you are exceeding the volume's
|
|
quota, unless the file is very large or the volume's quota is
|
|
small. Contact your system administrator for help in investigating
|
|
further possible causes of your problem.
|
|
<P><LI>If the value in the <TT>Partition</TT> field is very close to 100%, the
|
|
partition is possibly nearly full. However, server machine partitions
|
|
are usually very large and can still have enough space for an average file
|
|
when nearly full. You can either ask your system administrator about
|
|
the partition's status, or issue the <B>fs examine</B>
|
|
command. The final line in its output reports how many kilobyte blocks
|
|
are still available on the partition. For complete instructions, see <A HREF="auusg006.htm#HDRWQ39">Displaying Volume Quota</A>.
|
|
<PRE> % <B>fs examine</B> <<VAR>dir/file path</VAR>>
|
|
</PRE>
|
|
<P>If there is enough free space on the partition but you still cannot save
|
|
the file, ask your system administrator for help in investigating further
|
|
possible causes of your problem.
|
|
</UL>
|
|
</OL>
|
|
<HR><H2><A NAME="HDRWQ78" HREF="auusg002.htm#ToC_153">Problem: Accidentally Removed Your Entry from an ACL</A></H2>
|
|
<P>
|
|
<A NAME="IDX1126"></A>
|
|
<A NAME="IDX1127"></A>
|
|
<OL TYPE=1>
|
|
<P><LI>If you own the directory from which you have accidentally removed your ACL
|
|
entry, then you actually still have the <B>a</B> (<B>administer</B>)
|
|
permission even if it does not appear on the ACL. You normally own your
|
|
home directory and all of its subdirectories, for instance. Issue the
|
|
<B>fs setacl</B> command to grant yourself all other permissions.
|
|
For complete instructions, see <A HREF="auusg007.htm#HDRWQ55">To Add, Remove, or Edit Normal ACL Permissions</A>.
|
|
<PRE> % <B>fs setacl -dir</B> <<VAR>directory</VAR>> <B>-acl <</B><VAR>your_username</VAR>> <B>all</B>
|
|
</PRE>
|
|
<P>For <VAR>directory</VAR>, provide the complete pathname to the directory (for
|
|
example, <B>/afs/abc.com/usr/</B><VAR>your_username</VAR>).
|
|
This is necessary because AFS cannot interpret pathname abbreviations if you
|
|
do not have the <B>l</B> (<B>lookup</B>) permission.
|
|
<P><LI>If you do not own the directory, issue the <B>fs listacl</B> to check
|
|
if any remaining entries grant you the permissions you need (perhaps you
|
|
belong to one or more groups that appear on the ACL). For complete
|
|
instructions, see <A HREF="auusg007.htm#HDRWQ53">To display an ACL</A>.
|
|
<PRE> % <B>fs listacl</B> <<VAR>dir/file path</VAR>>
|
|
</PRE>
|
|
<UL>
|
|
<P><LI>The following message displays the directory's ACL. If you
|
|
need permissions that no entry currently grants you, ask the directory's
|
|
owner or your system administrator for help.
|
|
<PRE> Access list for <<VAR>dir/file path</VAR>> is
|
|
Normal rights
|
|
<VAR>list of entries</VAR>
|
|
</PRE>
|
|
<P><LI>If the command returns the following error message instead of an ACL, then
|
|
you do not have the <B>l</B> permission.
|
|
<PRE> fs: You don't have the required access rights on '<VAR>dir/file path</VAR>'
|
|
</PRE>
|
|
<P>Ask the directory's owner or your system administrator to grant you
|
|
the permissions you need. If they add you to a group that has the
|
|
required permissions, you must issue the <B>klog</B> command to
|
|
reauthenticate before you can exercise them.
|
|
</UL>
|
|
</OL>
|
|
<HR><H2><A NAME="HDRWQ79" HREF="auusg002.htm#ToC_154">Error Message: "afs: Lost contact with fileserver"</A></H2>
|
|
<A NAME="IDX1128"></A>
|
|
<A NAME="IDX1129"></A>
|
|
<A NAME="IDX1130"></A>
|
|
<P>Issue the <B>fs checkservers</B> command to check the status of file
|
|
server machines. For complete instructions, see <A HREF="auusg006.htm#HDRWQ41">Checking the Status of Server Machines</A>.
|
|
<PRE> % <B>fs checkservers &</B>
|
|
</PRE>
|
|
<UL>
|
|
<P><LI>If the following message appears, ask your system administrator for
|
|
assistance in diagnosing the cause of the <TT>Lost contact</TT> error
|
|
message.
|
|
<PRE> All servers are running.
|
|
</PRE>
|
|
<P><LI>Output like the following indicates that your Cache Manager cannot reach
|
|
the indicated file server machines. You must wait until they are again
|
|
accessible before continuing to work with the files that are stored on
|
|
them.
|
|
<PRE> These servers unavailable due to network or server problem:
|
|
<VAR>list_of_machines</VAR>.
|
|
</PRE>
|
|
</UL>
|
|
<A NAME="IDX1131"></A>
|
|
<HR><H2><A NAME="Header_155" HREF="auusg002.htm#ToC_155">Error Message: "<VAR>command</VAR>: Connection timed out"</A></H2>
|
|
<P>Issue the <B>fs checkservers</B> command as described in <A HREF="#HDRWQ79">Error Message: afs: Lost contact with fileserver</A>.
|
|
<A NAME="IDX1132"></A>
|
|
<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>
|
|
<P>You do not have the ACL permissions you need to perform the operation
|
|
you are attempting. If you own the directory and have accidentally
|
|
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
|
|
system administrator to grant you the appropriate permissions.
|
|
<A NAME="IDX1133"></A>
|
|
<A NAME="IDX1134"></A>
|
|
<HR><H2><A NAME="Header_157" HREF="auusg002.htm#ToC_157">Error Message: "afs: failed to store file"</A></H2>
|
|
<P>Follow the instructions in <A HREF="#HDRWQ77">Problem: Cannot Access, Copy, or Save File</A>.
|
|
<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>
|
|
<!-- 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>
|