jimzah/openafs
1
0
Fork 0
mirror of https://git.openafs.org/openafs.git synced 2025-01-18 15:00:12 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Update fs {get,set}serverprefs documentation for DNS

Browse Source 
Mention in the fs getserverprefs and fs setserverprefs documentation
that VL servers may also come from DNS AFSDB and SRV records.  Document
that SRV record information is not (yet) properly used.

Change-Id: I223efedf4d00ac1b57b3dce74a807790691abdbf
Reviewed-on: http://gerrit.openafs.org/2015
Tested-by: Russ Allbery <rra@stanford.edu>
Tested-by: Derrick Brashear <shadow@dementia.org>
Reviewed-by: Derrick Brashear <shadow@dementia.org>
This commit is contained in:
Russ Allbery 2010-05-24 14:28:01 -05:00 committed by Derrick Brashear
parent 6916146b46
commit 48d3ec164b
3 changed files with 18 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
doc/man-pages/README
View File

@ -230,9 +230,6 @@ Known Problems
don't just report the deficiency again, but any contributions towards
fixing it are greatly appreciated.
* Some of the documentation in fs getserverprefs needs minor updates to
reflect what happens in the dynroot case.
* There are lingering references to AFS Development or AFS Product
Support in descriptions of options that one should generally not
use. Also, all of the manual references refer to the "IBM" manual.

21
doc/man-pages/pod1/fs_getserverprefs.pod
View File

@ -33,17 +33,18 @@ types of rank, lower integer values are more preferred.
The Cache Manager stores ranks in kernel memory. Once set, a rank persists
until the machine reboots, or until the B<fs setserverprefs> command is
used to change it. The reference page for the B<fs setserverprefs> command
explains how the Cache Manager sets default ranks, and how to use that
command to change the default values.
used to change it. L<fs_setserverprefs(1)> explains how the Cache Manager
sets default ranks, and how to use that command to change the default
values.
Default VL Server ranks range from 10,000 to 10,126, and the Cache Manager
assigns them to every machine listed in its copy of the
F</usr/vice/etc/CellServDB> file. When the Cache Manager needs to fetch
VLDB information from a cell, it compares the ranks for the VL Server
machines belonging to that cell, and attempts to contact the VL Server
with the lowest integer rank. If the Cache Manager cannot reach the VL
Server (because of server process, machine or network outage), it tries to
Default VL Server ranks range from 10,000 to 10,126. The Cache Manager
assigns ranks to every machine listed in its copy of the
F</usr/vice/etc/CellServDB> file or found via DNS AFSDB or SRV records for
the cell when it initializes. When the Cache Manager needs to fetch VLDB
information from a cell, it compares the ranks for the VL Server machines
belonging to that cell, and attempts to contact the VL Server with the
lowest integer rank. If the Cache Manager cannot reach the VL Server
(because of server process, machine or network outage), it tries to
contact the VL Server with the next lowest integer rank, and so on. If all
of a cell's VL Server machines are unavailable, the Cache Manager cannot
fetch data from the cell.

11
doc/man-pages/pod1/fs_setserverprefs.pod
View File

@ -51,10 +51,13 @@ change it.
The Cache Manager sets default VL Server preference ranks as it
initializes, randomly assigning a rank from the range 10,000 to 10,126 to
each of the machines listed in the local F</usr/vice/etc/CellServDB>
file. Machines from different cells can have the same rank, but this does
not present a problem because the Cache Manager consults only one cell's
ranks at a time.
each of the machines liste din the local F</usr/vice/etc/CellServDB>
file. If DNS is used to locate VL Servers, the Cache Manager will assign a
rank to every server configured in an AFSDB or SRV record for that
cell. Currently, the priority and weight information from SRV records is
not used. Machines from different cells can have the same rank, but this
does not present a problem because the Cache Manager consults only one
cell's ranks at a time.
The Cache Manager sets default preference ranks for file server machine as
it fetches volume location information from the VLDB. Each time it learns