doc/man-pages/pod5/sysid.pod

   1 =head1 NAME
   2
   3 sysid - Lists file server machine interface addresses registered in VLDB
   4
   5 =head1 DESCRIPTION
   6
   7 The F<sysid> file records the network interface addresses that the File
   8 Server (B<fileserver> process) registers in the Volume Location Database
   9 (VLDB) for the local file server machine.
  10
  11 Each time the File Server restarts, it builds a list of interfaces on the
  12 local machine by reading the F</usr/afs/local/NetInfo> file, if it
  13 exists. If the file does not exist, the File Server uses the list of
  14 network interfaces configured with the operating system. It then removes
  15 from the list any addresses that appear in the
  16 F</usr/afs/local/NetRestrict> file, if it exists. The File Server records
  17 the resulting list in the binary-format F<sysid> file and registers the
  18 interfaces in the VLDB.
  19
  20 When the Cache Manager requests volume location information, the Volume
  21 Location (VL) Server provides all of the interfaces registered for each
  22 server machine that houses the volume. This enables the Cache Manager to
  23 make use of multiple addresses when accessing AFS data stored on a
  24 multihomed file server machine.
  25
  26 =head1 CAUTIONS
  27
  28 The F<sysid> file is unique to each file server machine, and must not be
  29 copied from one machine to another. If it is a common practice in the cell
  30 to copy the contents of the F</usr/afs/local> directory from an existing
  31 file server machine to a newly installed one, be sure to remove the
  32 F<sysid> file from the new machine before starting the C<fs> trio of
  33 processes, which includes the B<fileserver> process.
  34
  35 A maximum of 15 file server interface addresses can be registered in the
  36 VLDB.
  37
  38 =head1 SEE ALSO
  39
  40 L<NetInfo(5)>,
  41 L<NetRestrict(5)>,
  42 L<vldb.DB0(5)>,
  43 L<fileserver(8)>
  44
  45 =head1 COPYRIGHT
  46
  47 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
  48
  49 This documentation is covered by the IBM Public License Version 1.0.  It was
  50 converted from HTML to POD by software written by Chas Williams and Russ
  51 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.