Provided by: openafs-fileserver_1.4.12+dfsg-3_i386 bug

NAME

       sysid - Lists file server machine interface addresses registered in
       VLDB

DESCRIPTION

       The sysid file records the network interface addresses that the File
       Server (fileserver process) registers in the Volume Location Database
       (VLDB) for the local file server machine.

       Each time the File Server restarts, it builds a list of interfaces on
       the local machine by reading the /var/lib/openafs/local/NetInfo file,
       if it exists. If the file does not exist, the File Server uses the list
       of network interfaces configured with the operating system. It then
       removes from the list any addresses that appear in the
       /var/lib/openafs/local/NetRestrict file, if it exists. The File Server
       records the resulting list in the binary-format sysid file and
       registers the interfaces in the VLDB.

       When the Cache Manager requests volume location information, the Volume
       Location (VL) Server provides all of the interfaces registered for each
       server machine that houses the volume. This enables the Cache Manager
       to make use of multiple addresses when accessing AFS data stored on a
       multihomed file server machine.

CAUTIONS

       The sysid file is unique to each file server machine, and must not be
       copied from one machine to another. If it is a common practice in the
       cell to copy the contents of the /var/lib/openafs/local directory from
       an existing file server machine to a newly installed one, be sure to
       remove the sysid file from the new machine before starting the "fs"
       trio of processes, which includes the fileserver process.

       Some versions of AFS limit how many of a file server machine’s
       interface addresses that can be registered. Consult the IBM AFS Release
       Notes.

SEE ALSO

       NetInfo(5), NetRestrict(5), vldb.DB0(5), fileserver(8)

COPYRIGHT

       IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

       This documentation is covered by the IBM Public License Version 1.0.
       It was converted from HTML to POD by software written by Chas Williams
       and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.