openafs/doc/man-pages/pod5/sysid.pod
Russ Allbery 5f70221b2c Remove references to IBM AFS
Change references to the documentation sets that we still ship to
reference the OpenAFS manuals instead of the IBM AFS manuals.  Remove
references to the IBM AFS/DFS Migration documentation, since that
doesn't appear to be available anywhere any more, replacing them where
relevant to more generic references to the DFS documentation.  Add
links to docs.openafs.org for mentions of the manuals in SEE ALSO, and
standardize on one link format.  Replace a few references to the IBM
AFS Release Notes with the actual information in those notes, or drop
the reference if it doesn't seem particularly useful.

Change-Id: Ie9666842f1315891c6a9c37c0424200f4b78bff7
Reviewed-on: http://gerrit.openafs.org/2031
Reviewed-by: Derrick Brashear <shadow@dementia.org>
Tested-by: Derrick Brashear <shadow@dementia.org>
2010-05-26 12:05:45 -07:00

52 lines
2.0 KiB
Plaintext

=head1 NAME
sysid - Lists file server machine interface addresses registered in VLDB
=head1 DESCRIPTION
The F<sysid> file records the network interface addresses that the File
Server (B<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 F</usr/afs/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
F</usr/afs/local/NetRestrict> file, if it exists. The File Server records
the resulting list in the binary-format F<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.
=head1 CAUTIONS
The F<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 F</usr/afs/local> directory from an existing
file server machine to a newly installed one, be sure to remove the
F<sysid> file from the new machine before starting the C<fs> trio of
processes, which includes the B<fileserver> process.
A maximum of 15 file server interface addresses can be registered in the
VLDB.
=head1 SEE ALSO
L<NetInfo(5)>,
L<NetRestrict(5)>,
L<vldb.DB0(5)>,
L<fileserver(8)>
=head1 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.