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.

       A maximum of 15 file server interface addresses can be registered in the VLDB.

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.