sect5/sysid.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <refentry id="sysid5">
   3   <refmeta>
   4     <refentrytitle>sysid</refentrytitle>
   5     <manvolnum>5</manvolnum>
   6   </refmeta>
   7   <refnamediv>
   8     <refname>sysid</refname>
   9     <refpurpose>Lists file server machine interface addresses registered in VLDB</refpurpose>
  10   </refnamediv>
  11   <refsect1>
  12     <title>Description</title>
  13     <para>The <replaceable>sysid</replaceable> file records the network interface addresses that the File
  14     Server (<emphasis role="bold">fileserver</emphasis> process) registers in the Volume Location Database
  15     (VLDB) for the local file server machine.</para>
  16
  17     <para>Each time the File Server restarts, it builds a list of interfaces on the
  18     local machine by reading the <replaceable>/usr/afs/local/NetInfo</replaceable> file, if it
  19     exists. If the file does not exist, the File Server uses the list of
  20     network interfaces configured with the operating system. It then removes
  21     from the list any addresses that appear in the
  22     <replaceable>/usr/afs/local/NetRestrict</replaceable> file, if it exists. The File Server records
  23     the resulting list in the binary-format <replaceable>sysid</replaceable> file and registers the
  24     interfaces in the VLDB.</para>
  25
  26     <para>When the Cache Manager requests volume location information, the Volume
  27     Location (VL) Server provides all of the interfaces registered for each
  28     server machine that houses the volume. This enables the Cache Manager to
  29     make use of multiple addresses when accessing AFS data stored on a
  30     multihomed file server machine.</para>
  31
  32   </refsect1>
  33   <refsect1>
  34     <title>Cautions</title>
  35     <para>The <replaceable>sysid</replaceable> file is unique to each file server machine, and must not be
  36     copied from one machine to another. If it is a common practice in the cell
  37     to copy the contents of the <replaceable>/usr/afs/local</replaceable> directory from an existing
  38     file server machine to a newly installed one, be sure to remove the
  39     <replaceable>sysid</replaceable> file from the new machine before starting the <computeroutput>fs</computeroutput> trio of
  40     processes, which includes the <emphasis role="bold">fileserver</emphasis> process.</para>
  41
  42     <para>Some versions of AFS limit how many of a file server machine's interface
  43     addresses that can be registered. Consult the <emphasis>IBM AFS Release Notes</emphasis>.</para>
  44
  45   </refsect1>
  46   <refsect1>
  47     <title>See Also</title>
  48     <para><link linkend="NetInfo5">NetInfo(5)</link>,
  49     <link linkend="NetRestrict5">NetRestrict(5)</link>,
  50     <link linkend="vldb_DB05">vldb.DB0(5)</link>,
  51     <link linkend="fileserver8">fileserver(8)</link></para>
  52
  53   </refsect1>
  54   <refsect1>
  55     <title>Copyright</title>
  56     <para>IBM Corporation 2000. &lt;http://www.ibm.com/&gt; All Rights Reserved.</para>
  57
  58     <para>This documentation is covered by the IBM Public License Version 1.0.  It was
  59     converted from HTML to POD by software written by Chas Williams and Russ
  60     Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.</para>
  61
  62   </refsect1>
  63 </refentry>