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/yfs/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/yfs/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/yfs 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. 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.


"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)

"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)

The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).

"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).

"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.