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.