From 4ca1b0102542aec73ed5d06583f302eead94ba22 Mon Sep 17 00:00:00 2001 From: Jeffrey Altman Date: Tue, 6 Jul 2010 00:30:06 -0400 Subject: [PATCH] Windows: update release notes for 1.5.75 Add: * better description of Win7 netbios name lookup bug * "fs newcell" changes * IdleDeadTimeout registry value * NatPingInterval registry value * ReadOnlyVolumeVersioning registry value Change-Id: Ibf5ff8145be94ab8a7a48a1a9bd87c7d60e8549b Reviewed-on: http://gerrit.openafs.org/2333 Reviewed-by: Jeffrey Altman Tested-by: Jeffrey Altman --- doc/xml/ReleaseNotesWindows/relnotes.xml | 121 +++++++++++++++++++++++++++++-- 1 file changed, 114 insertions(+), 7 deletions(-) diff --git a/doc/xml/ReleaseNotesWindows/relnotes.xml b/doc/xml/ReleaseNotesWindows/relnotes.xml index 133398c..1d73aaf 100644 --- a/doc/xml/ReleaseNotesWindows/relnotes.xml +++ b/doc/xml/ReleaseNotesWindows/relnotes.xml @@ -899,6 +899,14 @@ As a result, it takes anywhere from 30 to 90 seconds after the operating system is resumed for access to the OpenAFS Client and the AFS file name space to be restored. Until the network bindings have been re-established, ticket managers and other tools will report that the "AFS Client Service may not have been started". + + Windows 7 and Server 2008 R2 contain a bug that will prevent access to \\AFS after either a network media link state change or + DHCP client lease results in the loss or change of assigned IP address. When the bug is triggered, all attempts to connect to + \\AFS will result in a "Bad Network Name" error even though "nbtstat.exe -n" reports the name "AFS" as locally registered. + HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Tcpip\Parameters "DisableDHCPMediaSense" (DWORD) can be set to "1" + to disable network media sense events from being delivered to the DHCP client. Under some circumstances this will avoid triggering + the bug. See KB239924: How to disable the Media Sensing Feature for TCP/IP in Windows. + Windows Vista, Windows 7, and Server 2008 [R2] implement User Account Control (UAC), a new security feature that implements least user privilege. With UAC, applications only run with the minimum required privileges. Even Administrator accounts run applications without the "Administrator" access control credentials. One side effect of this is that existing applications that mix user and system configuration capabilities must be re-written to separate those functions that require "Administrator" privileges into a separate process space. Future updates to OpenAFS will incorporate the necessary privilege separation, until that time some functions such as the Start and Stop Service features of the AFS Authentication Tool and the AFS Control Panel will not work unless they are "Run as Administrator". When a Vista user account that is a member of the "Administrators" group is used to access the AFS Control Panel (afs_config.exe), the process must be "Run as Administrator". Otherwise, attempts to modify the OpenAFS configuration will appear to succeed but in reality will have failed due to Vista’s system file and registry virtualization feature. @@ -924,7 +932,7 @@ fs chgrp owner information group information - 3.45. Differences between Windows and UNIX "fs examine" + 3.45. Differences between Windows and UNIX <emphasis>fs examine</emphasis> The OpenAFS for Windows version of "fs examine" provide two additional lines of output when compared to the UNIX implementation. These lines include the owner and group information for the file as well as the volume status. The Windows output will also indicate the type of object {File, Directory, Mountpoint, Symlink, ...} that was examined. @@ -1022,6 +1030,39 @@ cell names as available network shares. The network share properties will also include the object type and and the target of symlinks and mount points. +
+ fs newcell + 3.52. Differences between Windows and UNIX <emphasis>fs newcell</emphasis> + + The OpenAFS for Windows version of "fs newcell" prior to 1.5.74 behaved quite differently than its UNIX counterpart. + Instead of adding cell server information for a new cell, the command simply caused the cache manager to destroy all of its + cell server information and then reload it the next time the server list for a cell is needed. The UNIX version explicitly + replaces the server list for a cell with a new list. + + + Beginning with the 1.5.75 release, the Windows version will continue to behave as prior versions did when no parameters + are specified but will accept an extended UNIX command-line syntax as well. In addition to the UNIX parameters, + the Windows "fs newcell" command accepts four new ones: + + + + [-fsport <cell's fileserver port>] + Specifies an alternate port number at which the cell's file servers are listening + + + [-vlport <cell's vldb server port>] + Specifies an alternate port number at which the cell's volume location database servers are listening + + + [-registry] + Instructs the cache manager to save the cell server information to the registry database + + + [-dns] + Indicates that the cell server information should be obtained via DNS SRV or DNS AFSDB records + + +
debugging @@ -2872,13 +2913,14 @@ Variable: rx_nojumbo Value: ConnDeadTimeout Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] - Type: DWORD + + Type: DWORD -Default: 0 (seconds) + Default: 0 (seconds) -Variable: ConnDeadtimeout + Variable: ConnDeadtimeout When the value is 0, this setting is configured to be one-half the HardDeadTimeout value. @@ -2887,13 +2929,14 @@ Variable: ConnDeadtimeout HardDeadTimeout Value: HardDeadTimeout Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] - Type: DWORD + + Type: DWORD -Default: 0 (seconds) + Default: 0 (seconds) -Variable: HardDeadtimeout + Variable: HardDeadtimeout The Hard Dead Time is enforced to be at least double the ConnDeadTimeout.  The provides an opportunity for at least one retry. The value 0 seconds means that the real timeout should be set to be equal to the minimum SMB timeout which can be configured in the registry at: @@ -2905,6 +2948,50 @@ Variable: HardDeadtimeout +
+ IdleDeadTimeout + Value: IdleDeadTimeout + Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] + + Type: DWORD + + + Default: 0 (seconds) + + + Variable: IdleDeadtimeout + + The Idle Dead Time determines how long the cache manager will wait for an RPC to complete when the service is responding that it is busy. + If the timeout occurs on a replicated object, the cache manager can choose to fail over to an alternate replica. + This value is typically the same as the ConnDeadTimeout. +
+ + +
+ NATPingInterval + Value: NATPingInterval + Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] + + Type: DWORD + + + Default: 0 (seconds) + + + Variable: NatPingInterval + + + The NAT Ping Interval determines how frequently a low-level Rx ping packet is sent to + every file server using an anonymous connection. The value 0 seconds disables the + functionality. A non-zero value activates the NAT ping behavior. This option can be + enabled on clients that access AFS file servers from behind a NAT or port mapping + firewall that maintains a short timeout on UDP port mappings. In this case the AFS + cache manager may not receive AFS callbacks from the file server. This registry value + should be set to a number of seconds shorter than the port mapping timeout period. + When there is no other information to go on, a value of 20 seconds can be used. + +
+
TraceOption @@ -3195,6 +3282,26 @@ Default: 0
+ ReadOnlyVolumeVersioning + Value: ReadOnlyVolumeVersioning + Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] + Type: DWORD {0, 1} + + +Default: 0 + + Determines whether or not the AFS Cache Manager will will make use of the volume version information reported + by the file server as part of the AFSVolSync data structure. Use of volume version information can significantly + reduce the number of FetchStatus RPCs issued on objects stored in read-only volumes. This functionality is + disabled by default because all OpenAFS file servers older than OpenAFS 1.4.10 failed to include valid volume + version information as part of the BulkStatus and InlineBulkStatus RPCs. + + 0: do not make use of volume version information + 1: make use of volume version information +
+ + +
FollowBackupPath Value: FollowBackupPath Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] -- 1.9.4