openafs/doc/xml/UserGuide/c3402.html
Chas Williams 52557c982e xml-docbook-documentation-first-pass-20060915
needs more massaging to make it fit the tree, but, get it here first
2006-09-16 01:13:22 +00:00

870 lines
16 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML
><HEAD
><TITLE
>Troubleshooting</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="HOME"
TITLE="AFS User Guide"
HREF="book1.html"><LINK
REL="PREVIOUS"
TITLE="Using Groups"
HREF="c2454.html"><LINK
REL="NEXT"
TITLE="Using the NFS/AFS Translator"
HREF="a3632.html"></HEAD
><BODY
CLASS="chapter"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>AFS User Guide: Version 3.6</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="c2454.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="a3632.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="chapter"
><H1
><A
NAME="HDRWQ76"
></A
>Chapter 6. Troubleshooting</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.</P
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="HDRWQ77"
>Problem: Cannot Access, Copy, or Save File</A
></H1
><P
> </P
><OL
TYPE="1"
><LI
><P
><A
NAME="LINOSAVE-TOKENS"
></A
>Issue the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>tokens</B
></SPAN
> command to verify that you have valid
tokens. For complete instructions, see <A
HREF="c569.html#HDRWQ30"
>To Display Your Tokens</A
>. <PRE
CLASS="programlisting"
>&#13; % <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>tokens</B
></SPAN
>
</PRE
></P
><UL
><LI
><P
>If your tokens are valid, proceed to Step <A
HREF="c3402.html#LINOSAVE-FSCHECKS"
>2</A
>.</P
></LI
><LI
><P
>If your do not have tokens for the relevant cell, or they are expired, issue the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>klog</B
></SPAN
> command to authenticate. For complete instructions, see <A
HREF="c569.html#HDRWQ29"
>To
Authenticate with AFS</A
>. Then try accessing or saving the file again. If you are not successful, proceed to Step
<A
HREF="c3402.html#LINOSAVE-FSCHECKS"
>2</A
>. <PRE
CLASS="programlisting"
>&#13; % <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>klog</B
></SPAN
>
</PRE
></P
></LI
></UL
></LI
><LI
><P
><A
NAME="LINOSAVE-FSCHECKS"
></A
>Issue the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs checkservers</B
></SPAN
> command to check the
status of file server machines. For complete instructions, see <A
HREF="c1095.html#HDRWQ41"
>Checking the Status of Server
Machines</A
>. <PRE
CLASS="programlisting"
>&#13; % <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs checkservers &#38;</B
></SPAN
>
</PRE
></P
><UL
><LI
><P
>If the following message appears, proceed to Step <A
HREF="c3402.html#LINOSAVE-PERMS"
>3</A
>. <PRE
CLASS="programlisting"
>&#13; All servers are running.
</PRE
></P
></LI
><LI
><P
>Output like the following indicates that your Cache Manager cannot reach the indicated file server machines.
<PRE
CLASS="programlisting"
>&#13; These servers unavailable due to network or server problem:
<VAR
CLASS="replaceable"
>list of machines</VAR
>.
</PRE
></P
><P
>Issue the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs whereis</B
></SPAN
> 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="c1095.html#HDRWQ40"
>Locating Files and Directories</A
>.</P
><PRE
CLASS="programlisting"
>&#13; % <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs whereis</B
></SPAN
> &#60;<VAR
CLASS="replaceable"
>dir/file path</VAR
>&#62;
</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="c3402.html#LINOSAVE-PERMS"
>3</A
>.</P
></LI
></UL
></LI
><LI
><P
><A
NAME="LINOSAVE-PERMS"
></A
>Issue the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs listacl</B
></SPAN
> command to verify that you have
the permissions you need for accessing, copying, or saving the file. For complete instructions, see <A
HREF="c1444.html#HDRWQ53"
>To display an ACL</A
>. <PRE
CLASS="programlisting"
>&#13; % <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs listacl</B
></SPAN
> &#60;<VAR
CLASS="replaceable"
>dir/file path</VAR
>&#62;
</PRE
></P
><P
>You need the indicated permissions:</P
><UL
><LI
><P
>To access, copy, or save a file, you must have the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>l</B
></SPAN
> (<SPAN
CLASS="bold"
><B
CLASS="emphasis"
>lookup</B
></SPAN
>) permission on the directory and on all directories above it in the pathname.</P
></LI
><LI
><P
>To save changes to an existing file, you must in addition have the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>w</B
></SPAN
> (<SPAN
CLASS="bold"
><B
CLASS="emphasis"
>write</B
></SPAN
>) permission. To create a new file, you must in addition have the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>i</B
></SPAN
> (<SPAN
CLASS="bold"
><B
CLASS="emphasis"
>insert</B
></SPAN
>) and <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>w</B
></SPAN
>
permissions.</P
></LI
><LI
><P
>To copy a file between two directories, you must in addition have the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>r</B
></SPAN
>
(<SPAN
CLASS="bold"
><B
CLASS="emphasis"
>read</B
></SPAN
>) permission on the source directory and the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>i</B
></SPAN
>
permission on the destination directory.</P
></LI
></UL
><P
>If you do not have the necessary permissions but own the directory, you always have the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>a</B
></SPAN
> (<SPAN
CLASS="bold"
><B
CLASS="emphasis"
>administer</B
></SPAN
>) permission even if you do not appear on the ACL.
Issue the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs setacl</B
></SPAN
> command to grant yourself the necessary permissions. For complete
instructions, see <A
HREF="c1444.html#HDRWQ54"
>Changing an ACL</A
>.</P
><PRE
CLASS="programlisting"
>&#13; % <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs setacl -dir</B
></SPAN
> &#60;<VAR
CLASS="replaceable"
>directory</VAR
>&#62;<SUP
>+</SUP
> <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>-acl</B
></SPAN
> &#60;<VAR
CLASS="replaceable"
>access list entries</VAR
>&#62;<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 <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>klog</B
></SPAN
> command to reauthenticate before you can exercise them.</P
><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="c3402.html#LINOSAVE-QUOTA"
>4</A
>.</P
></LI
><LI
><P
><A
NAME="LINOSAVE-QUOTA"
></A
>If copying a file, issue the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs listquota</B
></SPAN
> 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="c1095.html#HDRWQ39"
>Displaying Volume Quota</A
>. <PRE
CLASS="programlisting"
>&#13; % <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs listquota</B
></SPAN
> &#60;<VAR
CLASS="replaceable"
>dir/file path</VAR
>&#62;
</PRE
></P
><P
>The command produces output as in the following example:</P
><PRE
CLASS="programlisting"
>&#13; % <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs listquota /afs/abc.com/usr/terry</B
></SPAN
>
Volume Name Quota Used % Used Partition
user.terry 10000 3400 34% 86%
</PRE
><UL
><LI
><P
>If the value in the <SAMP
CLASS="computeroutput"
>Partition</SAMP
> field is not close to 100%, the partition is not
almost full. Check the value in the <SAMP
CLASS="computeroutput"
>% Used</SAMP
> 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
><P
>If the value in the <SAMP
CLASS="computeroutput"
>% Used</SAMP
> 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
><LI
><P
>If the value in the <SAMP
CLASS="computeroutput"
>Partition</SAMP
> 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
<SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs examine</B
></SPAN
> command. The final line in its output reports how many kilobyte blocks are
still available on the partition. For complete instructions, see <A
HREF="c1095.html#HDRWQ39"
>Displaying Volume Quota</A
>.
<PRE
CLASS="programlisting"
>&#13; % <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs examine</B
></SPAN
> &#60;<VAR
CLASS="replaceable"
>dir/file path</VAR
>&#62;
</PRE
></P
><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.</P
></LI
></UL
></LI
></OL
></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="HDRWQ78"
>Problem: Accidentally Removed Your Entry from an ACL</A
></H1
><P
> </P
><OL
TYPE="1"
><LI
><P
>If you own the directory from which you have accidentally removed your ACL entry, then you actually still have the
<SPAN
CLASS="bold"
><B
CLASS="emphasis"
>a</B
></SPAN
> (<SPAN
CLASS="bold"
><B
CLASS="emphasis"
>administer</B
></SPAN
>) 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 <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs setacl</B
></SPAN
> command to grant yourself all other permissions. For complete instructions, see <A
HREF="c1444.html#HDRWQ55"
>To Add, Remove, or Edit Normal ACL Permissions</A
>. <PRE
CLASS="programlisting"
>&#13; % <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs setacl -dir</B
></SPAN
> &#60;<VAR
CLASS="replaceable"
>directory</VAR
>&#62; <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>-acl &#60;</B
></SPAN
><VAR
CLASS="replaceable"
>your_username</VAR
>&#62; <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>all</B
></SPAN
>
</PRE
></P
><P
>For <VAR
CLASS="replaceable"
>directory</VAR
>, provide the complete pathname to the directory (for example, <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>/afs/abc.com/usr/</B
></SPAN
><VAR
CLASS="replaceable"
>your_username</VAR
>). This is necessary because AFS cannot
interpret pathname abbreviations if you do not have the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>l</B
></SPAN
> (<SPAN
CLASS="bold"
><B
CLASS="emphasis"
>lookup</B
></SPAN
>) permission.</P
></LI
><LI
><P
>If you do not own the directory, issue the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs listacl</B
></SPAN
> 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="c1444.html#HDRWQ53"
>To display an ACL</A
>. <PRE
CLASS="programlisting"
>&#13; % <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs listacl</B
></SPAN
> &#60;<VAR
CLASS="replaceable"
>dir/file path</VAR
>&#62;
</PRE
></P
><UL
><LI
><P
>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
CLASS="programlisting"
>&#13; Access list for &#60;<VAR
CLASS="replaceable"
>dir/file path</VAR
>&#62; is
Normal rights
<VAR
CLASS="replaceable"
>list of entries</VAR
>
</PRE
></P
></LI
><LI
><P
>If the command returns the following error message instead of an ACL, then you do not have the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>l</B
></SPAN
> permission. <PRE
CLASS="programlisting"
>&#13; fs: You don't have the required access rights on '<VAR
CLASS="replaceable"
>dir/file path</VAR
>'
</PRE
></P
><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 <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>klog</B
></SPAN
> command to
reauthenticate before you can exercise them.</P
></LI
></UL
></LI
></OL
></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="HDRWQ79"
>Error Message: "afs: Lost contact with fileserver"</A
></H1
><P
>Issue the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs checkservers</B
></SPAN
> command to check the status of file server machines. For
complete instructions, see <A
HREF="c1095.html#HDRWQ41"
>Checking the Status of Server Machines</A
>.</P
><PRE
CLASS="programlisting"
>&#13; % <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs checkservers &#38;</B
></SPAN
>
</PRE
><UL
><LI
><P
>If the following message appears, ask your system administrator for assistance in diagnosing the cause of the
<SAMP
CLASS="computeroutput"
>Lost contact</SAMP
> error message. <PRE
CLASS="programlisting"
>&#13; All servers are running.
</PRE
></P
></LI
><LI
><P
>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
CLASS="programlisting"
>&#13; These servers unavailable due to network or server problem:
<VAR
CLASS="replaceable"
>list_of_machines</VAR
>.
</PRE
></P
></LI
></UL
></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="Header_155"
>Error Message: "<VAR
CLASS="replaceable"
>command</VAR
>: Connection timed out"</A
></H1
><P
>Issue the <SPAN
CLASS="bold"
><B
CLASS="emphasis"
>fs checkservers</B
></SPAN
> command as described in <A
HREF="c3402.html#HDRWQ79"
>Error Message:
afs: Lost contact with fileserver</A
>. </P
></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="Header_156"
>Error Message: "fs: You don't have the required access rights on '<VAR
CLASS="replaceable"
>file</VAR
>'"</A
></H1
><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="c3402.html#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.
</P
></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="Header_157"
>Error Message: "afs: failed to store file"</A
></H1
><P
>Follow the instructions in <A
HREF="c3402.html#HDRWQ77"
>Problem: Cannot Access, Copy, or Save File</A
>.</P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="c2454.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="book1.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="a3632.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Using Groups</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Using the NFS/AFS Translator</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>