bionic (5) sysid.5.gz

Provided by: openafs-fileserver_1.8.0~pre5-1ubuntu1.2_amd64 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.

       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)

       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.