From e754a0bebdeaa5bd8acfdb5d802392715e38fd5b Mon Sep 17 00:00:00 2001 From: Jeffrey Altman Date: Tue, 26 May 2009 16:29:16 +0000 Subject: [PATCH] doc-xml-windows-release-notes-20090526 LICENSE MIT Add notes describing registry support for CellServDB info and conversion of docs to HtmlHelp format. --- doc/xml/ReleaseNotesWindows/relnotes.xml | 142 ++++++++++++++++++++++- 1 file changed, 141 insertions(+), 1 deletion(-) diff --git a/doc/xml/ReleaseNotesWindows/relnotes.xml b/doc/xml/ReleaseNotesWindows/relnotes.xml index abcb596c7..169a4f6e5 100644 --- a/doc/xml/ReleaseNotesWindows/relnotes.xml +++ b/doc/xml/ReleaseNotesWindows/relnotes.xml @@ -289,7 +289,8 @@
3.5. Locating AFS Volume Database Servers via DNS - The OpenAFS for Windows client will use DNS AFSDB records to discover the location of AFS Volume Database servers when entries for the cell are not present in the client's CellServDB file (\%PROGRAMFILES%\OpenAFS\Client\CellServDB). + The OpenAFS for Windows client will use DNS AFSDB records to discover the location of AFS Volume Database servers when entries for the cell are not present in the client's CellServDB file (\%PROGRAMFILES%\OpenAFS\Client\CellServDB). + Also see Registry Configuration for AFS Volume Database Servers.
3.6. Obtaining AFS Tokens as a Integrated Part of Windows Logon @@ -904,6 +905,18 @@ aklog and Network Identity Manager will automatically obtain tokens for the linked cell when tokens for the other cell is specified.
+
+ 3.49 Registry Configuration for AFS Volume Database Servers + Beginning with the 1.5.60 release, the [HKLM\SOFTWARE\OpenAFS\Client\CellServDB] + registry key can be used to distribute Volume Database Server location information either as a supplement to the CellServDB file or + as a substitute for it. The precedence order for lookups is: Registry, File, and then DNS. +
+
+ 3.50 Documentation Converted to Windows HTML Help + Starting with the 1.5.60 release, this document, the OpenAFS Administrator Guide and the OpenAFS User Guide are provided in HTML Help format instead + of raw HTML pages. +
+ How to Debug Problems with OpenAFS for Windows @@ -3328,6 +3341,131 @@ Default: <none> + +
+ Regkey: [HKLM\SOFTWARE\OpenAFS\Client\CellServDB] + The CellServDB key is an alternative to the CellServDB file that can be used either to supplement + or override its contents. This registry entry is meant to provide organizations that centrally manage their client configurations using + Active Directory Group Policy a means of updating records for individual cells or servers without pushing out a new file. + + At the present time the CellServDB key contains no values; only subkeys. Each subkey is the name of a Cell. For example, grand.central.org. + + Support for registry CellServDB configuration was added in 1.5.60. +
+ +
+ Regkey: [HKLM\SOFTWARE\OpenAFS\Client\CellServDB\<cellname>] + The actual name of the <cellname> key is the full name of the cell whose configuration is being specified. The <cellname> key contains both values and subkeys. Each subkey represents a single host name or IP address. When a host is to be known by more than one name or IP address, a separate subkey should be created for each. + Unlike the <cellname> key name, the <server> key names do not have to be actual host names. + + + + + + + + Value: "Description" + + Type: REG_SZ + + Default: <none> + This value is used to store a description of the Cell appropriate for display in end user facing tools. + + + + + + Value: "ForceDNS" + + Type: REG_DWORD + Range: 0 or 1 + Default: 0 if <server> subkeys exist; 1 otherwise + When set to 1 all server configuration provided in the registry or the CellServDB file is ignored and DNS AFSDB lookups are used instead. + + + + + + Value: "LinkedCell" + + Type: REG_SZ + + Default: <none> + This value names an alternative cell to which this cell should be linked. When two cells are linked by the OpenAFS client, volume lookups that fail in the specified cell will be searched for in the linked cell + and when tokens are requested for one of the cells they will be obtained for both. + This functionality can be used for example to develop a test cell that is equivalent to a production cell with the exception that it substitutes test versions of volumes + for the production versions. Another use is to assist in the transition from one cell name to another. + See also: Linked Cells. + + + + + +
+ +
+ Regkey: [HKLM\SOFTWARE\OpenAFS\Client\CellServDB\<cellname>\<server>] + The actual name of the <server> key may be a fully qualified domain name of the server whose configuration is being specified. + If a domain name is specified as the key name, all values become optional. + + + + + + + + + Value: "HostName" + + Type: REG_SZ + + Default: <none> + This value is used to specify a fully qualified domain name appropriate that matches either a DNS A or DNS CNAME record. If provided, this value supercedes + the name of the <server> key. It is recommended that the value of this field be terminated with a period in order to avoid the use of domain substitution + during the gethostbyname() evaluation. + + + + + + + Value: "IPv4Address" + + Type: REG_SZ + Default: <none> + If the DNS host name lookup fails this value will be used as the IPv4 address for the server. + + + + + + Value: "Rank" + + Type: REG_DWORD + + Range: 0..65535 + Default: 0 + This value specifies the default server preference. A value of 0 indicates that no preference has been specified. When non-zero values + are specified lower values indicate a stronger preference than higher values. + + + + + + Value: "Comment" + + Type: REG_SZ + Default: <none> + A text string that can be displayed to end users to describe the server. + + + + + +
+ + +
Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Freelance] @@ -4081,6 +4219,8 @@ Default: <none>
+ +
A.4 OpenAFS Client Service Environment Variables -- 2.39.5