mirror of
https://git.openafs.org/openafs.git
synced 2025-01-22 17:00:15 +00:00
174 lines
9.4 KiB
HTML
174 lines
9.4 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
|
|
<HTML><HEAD>
|
|
<TITLE>Administration Reference</TITLE>
|
|
<!-- Begin Header Records ========================================== -->
|
|
<!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
|
|
<!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
|
|
<META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
|
|
<META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
|
|
<META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
|
|
</HEAD><BODY>
|
|
<!-- (C) IBM Corporation 2000. All Rights Reserved -->
|
|
<BODY bgcolor="ffffff">
|
|
<!-- End Header Records ============================================ -->
|
|
<A NAME="Top_Of_Page"></A>
|
|
<H1>Administration Reference</H1>
|
|
<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="auarf145.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="auarf147.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>
|
|
<P>
|
|
<H2><A NAME="HDRFS_GETSERVERPREFS" HREF="auarf002.htm#ToC_160">fs getserverprefs</A></H2>
|
|
<A NAME="IDX4844"></A>
|
|
<A NAME="IDX4845"></A>
|
|
<A NAME="IDX4846"></A>
|
|
<A NAME="IDX4847"></A>
|
|
<A NAME="IDX4848"></A>
|
|
<A NAME="IDX4849"></A>
|
|
<A NAME="IDX4850"></A>
|
|
<P><STRONG>Purpose</STRONG>
|
|
<P>Displays the Cache Manager's preference ranks for file server or VL
|
|
Server machines
|
|
<P><STRONG>Synopsis</STRONG>
|
|
<PRE><B>fs getserverprefs</B> [<B>-file</B> <<VAR>output to named file</VAR>>]
|
|
[<B>-numeric</B>] [<B>-vlservers</B>] [<B>-help</B>]
|
|
|
|
<B>fs gets</B> [<B>-f</B> <<VAR>output to named file</VAR>>] [<B>-n</B>] [<B>-v</B>] [<B>-h</B>]
|
|
|
|
<B>fs gp</B> [<B>-f</B> <<VAR>output to named file</VAR>>] [<B>-n</B>] [<B>-v</B>] [<B>-h</B>]
|
|
</PRE>
|
|
<P><STRONG>Description</STRONG>
|
|
<P>The <B>fs getserverprefs</B> command displays preference ranks for file
|
|
server machine interfaces (file server machines run the <B>fs</B> process)
|
|
or, if the <B>-vlserver</B> flag is provided, for Volume Location (VL)
|
|
Server machines (which run the <B>vlserver</B> process). For file
|
|
server machines, the Cache Manager tracks up to 15 interfaces per machine and
|
|
assigns a separate rank to each interface. The ranks indicate the order
|
|
in which the local Cache Manager attempts to contact the interfaces of
|
|
machines that are housing a volume when it needs to fetch data from the
|
|
volume. For VL Server machines, the ranks indicate the order in which
|
|
the Cache Manager attempts to contact a cell's VL Servers when requesting
|
|
VLDB information. For both types of rank, lower integer values are more
|
|
preferred.
|
|
<P>The Cache Manager stores ranks in kernel memory. Once set, a rank
|
|
persists until the machine reboots, or until the <B>fs setserverprefs</B>
|
|
command is used to change it. The reference page for the <B>fs
|
|
setserverprefs</B> command explains how the Cache Manager sets default
|
|
ranks, and how to use that command to change the default values.
|
|
<P>Default VL Server ranks range from 10,000 to 10,126, and the Cache Manager
|
|
assigns them to every machine listed in its copy of the
|
|
<B>/usr/vice/etc/CellServDB</B> file. When the Cache Manager needs
|
|
to fetch VLDB information from a cell, it compares the ranks for the VL Server
|
|
machines belonging to that cell, and attempts to contact the VL Server with
|
|
the lowest integer rank. If the Cache Manager cannot reach the VL
|
|
Server (because of server process, machine or network outage), it tries to
|
|
contact the VL Server with the next lowest integer rank, and so on. If
|
|
all of a cell's VL Server machines are unavailable, the Cache Manager
|
|
cannot fetch data from the cell.
|
|
<P>Default file server ranks range from 5,000 to 40,000, excluding the range
|
|
used for VL Servers (10,000 to 10,126); the maximum possible rank is
|
|
65,534. When the Cache Manager needs to fetch data from a volume, it
|
|
compares the ranks for the interfaces of machines that house the volume, and
|
|
attempts to contact the interface that has the lowest integer rank. If
|
|
it cannot reach the <B>fileserver</B> process via that interface (because
|
|
of server process, machine or network outage), it tries to contact the
|
|
interface with the next lowest integer rank, and so on. If it cannot
|
|
reach any of the interfaces for machines that house the volume, it cannot
|
|
fetch data from the volume.
|
|
<P>For both file server machines and VL Server machines, it is possible for a
|
|
machine or interface in a foreign cell to have the same rank as a machine or
|
|
interface in the local cell. This does not present a problem, because
|
|
the Cache Manager only ever compares ranks for machines belonging to one cell
|
|
at a time.
|
|
<P><STRONG>Options</STRONG>
|
|
<DL>
|
|
<P><DT><B>-file
|
|
</B><DD>Specifies the full pathname of a file to which to write the preference
|
|
ranks. If the specified file already exists, the command overwrites its
|
|
contents. If the pathname is invalid, the command fails. If this
|
|
argument is not provided, the preference ranks appear on the standard output
|
|
stream.
|
|
<P><DT><B>-numeric
|
|
</B><DD>Displays the IP addresses of file server machine interfaces or VL Server
|
|
machines, rather than their hostnames. If this argument is not
|
|
provided, the <B>fs</B> command interpreter has the IP addresses
|
|
translated to hostnames such as <B>fs1.abc.com</B>.
|
|
<P><DT><B>-vlservers
|
|
</B><DD>Displays preference ranks for VL Server machines rather than file server
|
|
machine interfaces.
|
|
<P><DT><B>-help
|
|
</B><DD>Prints the online help for this command. All other valid options
|
|
are ignored.
|
|
</DL>
|
|
<P><STRONG>Output</STRONG>
|
|
<P>The output consists of a separate line for each file server machine
|
|
interface or VL Server machine, pairing the machine's hostname or IP
|
|
address with its rank. The Cache Manager stores IP addresses in its
|
|
kernel list of ranks, but the command by default identifies interfaces by
|
|
hostname, by calling a translation routine that refers to either the
|
|
cell's name service (such as the Domain Name Server) or the local host
|
|
table. If an IP address appears in the output, it is because the
|
|
translation attempt failed. To bypass the translation step and display
|
|
IP addresses rather than hostnames, include the <B>-numeric</B>
|
|
flag. This can significantly speed the production of output.
|
|
<P>By default, the command writes to the standard output stream. Use
|
|
the <B>-file</B> argument to write the output to a file instead.
|
|
<P><STRONG>Examples</STRONG>
|
|
<P>The following example displays the local Cache Manager's preference
|
|
ranks for file server machines. The local machine belongs to the AFS
|
|
cell named <B>abc.com</B>, and in this example the ranks of file
|
|
server machines in its local cell are lower than the ranks of file server
|
|
machines from the foreign cell, <B>def.com</B>. It is not
|
|
possible to translate the IP addresses of two machines on the 138.255
|
|
network.
|
|
<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
|
|
138.255.33.34 40000
|
|
server6.def.com 40012
|
|
138.255.33.37 40005
|
|
|
|
</PRE>
|
|
<P>The following example shows hows the output displays IP addresses when the
|
|
<B>-numeric</B> flag is included, and illustrates how network proximity
|
|
determines default ranks (as described on the <B>fs setserverprefs</B>
|
|
reference page). The local machine has IP address
|
|
192.12.107.210, and the two file server machines on its
|
|
subnetwork have ranks of 20,007 and 20,011. The two file server
|
|
machines on a different subnetwork of the local machine's network have
|
|
higher ranks, 30,002 and 30,010, whereas the ranks of the remaining machines
|
|
range from 40,000 to 40,012 because they are in a completely different
|
|
network.
|
|
<PRE> % <B>fs getserverprefs -numeric</B>
|
|
192.12.107.214 20007
|
|
192.12.105.99 30002
|
|
192.12.107.212 20011
|
|
192.12.105.100 30010
|
|
138.255.33.41 40002
|
|
138.255.33.34 40000
|
|
138.255.33.36 40012
|
|
138.255.33.37 40005
|
|
|
|
</PRE>
|
|
<P>The example shows how the <B>-vlservers</B> flag displays preference
|
|
ranks for VL Server machines:
|
|
<PRE> % <B>fs getserverprefs -vlservers</B>
|
|
fs2.abc.com 10052
|
|
fs3.abc.com 10113
|
|
fs1.abc.com 10005
|
|
|
|
</PRE>
|
|
<P><STRONG>Privilege Required</STRONG>
|
|
<P>None
|
|
<P><STRONG>Related Information</STRONG>
|
|
<P><A HREF="auarf162.htm#HDRFS_SETSERVERPREFS">fs setserverprefs</A>
|
|
<P>
|
|
<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="auarf145.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="auarf147.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>
|
|
<!-- 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>
|