src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf146.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3190/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 5 Nov 1999 at 13:58:29                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Fri, 05 Nov 1999 13:58:29">
   8 <META HTTP-EQUIV="review" CONTENT="Sun, 05 Nov 2000 13:58:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Mon, 05 Nov 2001 13:58:29">
  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>Administration Reference</H1>
  16 <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>
  17 <P>
  18 <H2><A NAME="HDRFS_GETSERVERPREFS" HREF="auarf002.htm#ToC_160">fs getserverprefs</A></H2>
  19 <A NAME="IDX4844"></A>
  20 <A NAME="IDX4845"></A>
  21 <A NAME="IDX4846"></A>
  22 <A NAME="IDX4847"></A>
  23 <A NAME="IDX4848"></A>
  24 <A NAME="IDX4849"></A>
  25 <A NAME="IDX4850"></A>
  26 <P><STRONG>Purpose</STRONG>
  27 <P>Displays the Cache Manager&#39;s preference ranks for file server or VL
  28 Server machines
  29 <P><STRONG>Synopsis</STRONG>
  30 <PRE><B>fs getserverprefs</B> [<B>-file</B> &lt;<VAR>output&nbsp;to&nbsp;named&nbsp;file</VAR>>]
  31                   [<B>-numeric</B>]  [<B>-vlservers</B>]  [<B>-help</B>]
  32
  33 <B>fs gets</B> [<B>-f</B> &lt;<VAR>output&nbsp;to&nbsp;named&nbsp;file</VAR>>]  [<B>-n</B>]  [<B>-v</B>]  [<B>-h</B>]
  34
  35 <B>fs gp</B> [<B>-f</B> &lt;<VAR>output&nbsp;to&nbsp;named&nbsp;file</VAR>>]  [<B>-n</B>]  [<B>-v</B>]  [<B>-h</B>]
  36 </PRE>
  37 <P><STRONG>Description</STRONG>
  38 <P>The <B>fs getserverprefs</B> command displays preference ranks for file
  39 server machine interfaces (file server machines run the <B>fs</B> process)
  40 or, if the <B>-vlserver</B> flag is provided, for Volume Location (VL)
  41 Server machines (which run the <B>vlserver</B> process). For file
  42 server machines, the Cache Manager tracks up to 15 interfaces per machine and
  43 assigns a separate rank to each interface. The ranks indicate the order
  44 in which the local Cache Manager attempts to contact the interfaces of
  45 machines that are housing a volume when it needs to fetch data from the
  46 volume. For VL Server machines, the ranks indicate the order in which
  47 the Cache Manager attempts to contact a cell&#39;s VL Servers when requesting
  48 VLDB information. For both types of rank, lower integer values are more
  49 preferred.
  50 <P>The Cache Manager stores ranks in kernel memory. Once set, a rank
  51 persists until the machine reboots, or until the <B>fs setserverprefs</B>
  52 command is used to change it. The reference page for the <B>fs
  53 setserverprefs</B> command explains how the Cache Manager sets default
  54 ranks, and how to use that command to change the default values.
  55 <P>Default VL Server ranks range from 10,000 to 10,126, and the Cache Manager
  56 assigns them to every machine listed in its copy of the
  57 <B>/usr/vice/etc/CellServDB</B> file. When the Cache Manager needs
  58 to fetch VLDB information from a cell, it compares the ranks for the VL Server
  59 machines belonging to that cell, and attempts to contact the VL Server with
  60 the lowest integer rank. If the Cache Manager cannot reach the VL
  61 Server (because of server process, machine or network outage), it tries to
  62 contact the VL Server with the next lowest integer rank, and so on. If
  63 all of a cell&#39;s VL Server machines are unavailable, the Cache Manager
  64 cannot fetch data from the cell.
  65 <P>Default file server ranks range from 5,000 to 40,000, excluding the range
  66 used for VL Servers (10,000 to 10,126); the maximum possible rank is
  67 65,534. When the Cache Manager needs to fetch data from a volume, it
  68 compares the ranks for the interfaces of machines that house the volume, and
  69 attempts to contact the interface that has the lowest integer rank. If
  70 it cannot reach the <B>fileserver</B> process via that interface (because
  71 of server process, machine or network outage), it tries to contact the
  72 interface with the next lowest integer rank, and so on. If it cannot
  73 reach any of the interfaces for machines that house the volume, it cannot
  74 fetch data from the volume.
  75 <P>For both file server machines and VL Server machines, it is possible for a
  76 machine or interface in a foreign cell to have the same rank as a machine or
  77 interface in the local cell. This does not present a problem, because
  78 the Cache Manager only ever compares ranks for machines belonging to one cell
  79 at a time.
  80 <P><STRONG>Options</STRONG>
  81 <DL>
  82 <P><DT><B>-file
  83 </B><DD>Specifies the full pathname of a file to which to write the preference
  84 ranks. If the specified file already exists, the command overwrites its
  85 contents. If the pathname is invalid, the command fails. If this
  86 argument is not provided, the preference ranks appear on the standard output
  87 stream.
  88 <P><DT><B>-numeric
  89 </B><DD>Displays the IP addresses of file server machine interfaces or VL Server
  90 machines, rather than their hostnames. If this argument is not
  91 provided, the <B>fs</B> command interpreter has the IP addresses
  92 translated to hostnames such as <B>fs1.abc.com</B>.
  93 <P><DT><B>-vlservers
  94 </B><DD>Displays preference ranks for VL Server machines rather than file server
  95 machine interfaces.
  96 <P><DT><B>-help
  97 </B><DD>Prints the online help for this command. All other valid options
  98 are ignored.
  99 </DL>
 100 <P><STRONG>Output</STRONG>
 101 <P>The output consists of a separate line for each file server machine
 102 interface or VL Server machine, pairing the machine&#39;s hostname or IP
 103 address with its rank. The Cache Manager stores IP addresses in its
 104 kernel list of ranks, but the command by default identifies interfaces by
 105 hostname, by calling a translation routine that refers to either the
 106 cell&#39;s name service (such as the Domain Name Server) or the local host
 107 table. If an IP address appears in the output, it is because the
 108 translation attempt failed. To bypass the translation step and display
 109 IP addresses rather than hostnames, include the <B>-numeric</B>
 110 flag. This can significantly speed the production of output.
 111 <P>By default, the command writes to the standard output stream. Use
 112 the <B>-file</B> argument to write the output to a file instead.
 113 <P><STRONG>Examples</STRONG>
 114 <P>The following example displays the local Cache Manager&#39;s preference
 115 ranks for file server machines. The local machine belongs to the AFS
 116 cell named <B>abc.com</B>, and in this example the ranks of file
 117 server machines in its local cell are lower than the ranks of file server
 118 machines from the foreign cell, <B>def.com</B>. It is not
 119 possible to translate the IP addresses of two machines on the 138.255
 120 network.
 121 <PRE>   % <B>fs getserverprefs</B>
 122    fs2.abc.com           20007
 123    fs3.abc.com           30002
 124    fs1.abc.com           20011
 125    fs4.abc.com           30010
 126    server1.def.com       40002
 127    138.255.33.34         40000
 128    server6.def.com       40012
 129    138.255.33.37         40005
 130
 131 </PRE>
 132 <P>The following example shows hows the output displays IP addresses when the
 133 <B>-numeric</B> flag is included, and illustrates how network proximity
 134 determines default ranks (as described on the <B>fs setserverprefs</B>
 135 reference page). The local machine has IP address
 136 192.12.107.210, and the two file server machines on its
 137 subnetwork have ranks of 20,007 and 20,011. The two file server
 138 machines on a different subnetwork of the local machine&#39;s network have
 139 higher ranks, 30,002 and 30,010, whereas the ranks of the remaining machines
 140 range from 40,000 to 40,012 because they are in a completely different
 141 network.
 142 <PRE>   % <B>fs getserverprefs -numeric</B>
 143    192.12.107.214          20007
 144    192.12.105.99           30002
 145    192.12.107.212          20011
 146    192.12.105.100          30010
 147    138.255.33.41           40002
 148    138.255.33.34           40000
 149    138.255.33.36           40012
 150    138.255.33.37           40005
 151
 152 </PRE>
 153 <P>The example shows how the <B>-vlservers</B> flag displays preference
 154 ranks for VL Server machines&#58;
 155 <PRE>   % <B>fs getserverprefs -vlservers</B>
 156    fs2.abc.com            10052
 157    fs3.abc.com            10113
 158    fs1.abc.com            10005
 159
 160 </PRE>
 161 <P><STRONG>Privilege Required</STRONG>
 162 <P>None
 163 <P><STRONG>Related Information</STRONG>
 164 <P><A HREF="auarf162.htm#HDRFS_SETSERVERPREFS">fs setserverprefs</A>
 165 <P>
 166 <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>
 167 <!-- Begin Footer Records  ========================================== -->
 168 <P><HR><B>
 169 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 170 </B>
 171 <!-- End Footer Records  ============================================ -->
 172 <A NAME="Bot_Of_Page"></A>
 173 </BODY></HTML>