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.
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.
-
-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
+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. 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.
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