DOKK / manpages / debian 11 / openafs-fileserver / sysid.5.en
SYSID(5) AFS File Reference SYSID(5)

sysid - Lists file server machine interface addresses registered in VLDB

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.

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.

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.

2021-01-14 OpenAFS