windows-notes-20050402
authorJeffrey Altman <jaltman@secure-endpoints.com>
Sat, 2 Apr 2005 10:06:44 +0000 (10:06 +0000)
committerJeffrey Altman <jaltman@secure-endpoints.com>
Sat, 2 Apr 2005 10:06:44 +0000 (10:06 +0000)
updates for version 1.3.81

doc/txt/winnotes/afs-changes-since-1.2.txt
doc/txt/winnotes/afs-install-notes.txt
doc/txt/winnotes/afs-issues.txt
doc/txt/winnotes/msi-deployment-guide.txt

index 1efa6cc..b6296e0 100644 (file)
@@ -1,3 +1,55 @@
+Since 1.3.80:
+  * Fixed a locking error in cm_TryBulkStat() which had the
+    potential of deadlocking the system for the length of time
+    it takes to perform a bulk status fetch operation.
+
+  * Replaced time conversion code (UnixTime <-> FILETIME) to 
+    be completely arithmetic instead of relying on a bizarre
+    algorithm involving a variety of C RTL time functions.
+
+  * Fixed a invalid memory access under a bizarre circumstance.
+    Windows will allow a physical mass media device to be 
+    installed via Plug N Play to the system and will assign it
+    the lowest available drive letter.  This is true even if the
+    drive letter is currently assigned in the user session to
+    a network device via NET USE (or its equivalent.)  When this
+    happens, queries sent to the CIFS server will contain invalid
+    data.  This invalid data was not being caught by the AFS 
+    Client Service and was resulting in a crash when Freelance
+    mode was in use.  
+
+  * Fixed a reference count error when registering callbacks
+    on a stat cache object if the callback was already registered
+
+  * Add a case to cm_Analyze() in order to handle the case where
+    cm_GetConnByMServers() returns CM_ERROR_NOSUCHVOLUME because
+    the server list for the volume is empty.  In this case, force
+    an update of the volume info and retry.
+
+  * Insert a missing cm_EndCallbackGrantingCall() which could
+    result in threads waiting for a callback to complete to never
+    be woken up.
+
+  * In the persistent cache, there is a maximum number of volume
+    entries.  Allow volume entries to be reused if the maximum
+    number have been allocated and their reference count is zero.
+
+  * If we already have a dead virtual connection object, don't 
+    ignore the fact that additional dead vc objects must be taken
+    care of.
+
+  * Removed a deadlock condition introduced in the summer of 2004.
+    Do not hold mx locks around calls to RX functions including
+    rx_NewCall().  That is what reference counts on the rx_connection
+    object are for.
+
+  * Fixed an initialization error in afslogon.dll which could
+    result in random behavior including a failure to terminate
+    the NPLogon function. (1.3.80b)
+
+  * Fixed an error preventing the use of SMB authentication
+    on Windows 2000.  (1.3.80a)
+
 Since 1.3.77:
   * Updated CellServDB to Public CellServDB 16 Mar 2005
 
index e318e58..2ab7ec5 100644 (file)
@@ -1,4 +1,4 @@
-OpenAFS for Windows 1.3.80 Installation Notes
+OpenAFS for Windows 1.3.81 Installation Notes
 ---------------------------------------------
 
 The OpenAFS for Windows product was very poorly maintained throughout the 
@@ -407,8 +407,9 @@ the maximum number of entries, your host will begin to experience thrashing
 of the Status Cache and all requests will result in network operations.
 
 If you are experiencing poor performance you might want to increase the 
-maximum number of Status Cache entries.  Each entry requires 164K.  Only
-those entries which are used are allocated.
+maximum number of Status Cache entries.  Each entry requires approximately
+1.2K.  Note that the default number of Status Cache entries was increased
+to 10,000 starting in 1.3.80.
 
 
 26. "Netbios over TCP/IP" must be active on the machine in order for
index ce50ec7..da7f7b0 100644 (file)
@@ -1,4 +1,4 @@
-This file is a rough list of known issues with the 1.3.80 release of OpenAFS
+This file is a rough list of known issues with the 1.3.81 release of OpenAFS
 on Windows.  This list is not complete.  There are probably other issues 
 which can be found in the RT database or on the mailing list.
 
index c833dc8..35656ab 100644 (file)
@@ -13,6 +13,7 @@ OpenAFS for Windows
      2.2   Existing registry values
      2.3   Replacing Configuration Files
      2.4   Adding Domain Specific Registry Keys
+     2.5   Adding Site Specific Freelance Registry Keys
 
      3.         Additional resources
 
@@ -564,6 +565,89 @@ OpenAFS for Windows
     integrated logon) and 'LOCALHOST' (disable integrated logon and
     fail logins silently).
 
+2.5 Adding Site Specific Freelance Registry Keys
+
+    Following is an example for adding site specific Freelance registry keys
+    to pre-populate the Mountpoints and Symlinks in the fake root.afs volume.
+
+    Columns that are unspecified should be left empty.
+
+    We create a new feature and component to hold the new registry keys.
+
+    'Feature' table:
+
+    (new row)
+       Feature         : 'feaFreelanceKeys'
+       Feature Parent  : 'feaClient'
+       Display         : 0
+       Level           : 30
+       Attributes      : 10
+
+    'Component' table:
+
+       (new row)
+    Component  : 'rcm_FreelanceKeys'
+       ComponentId     : '{4E3B3CBF4-9AE7-40C3-7B09-C48CF842C583}'
+       Directory       : 'TARGETDIR'
+       Attributes      : 4
+       KeyPath         : 'reg_freekey0'
+
+    'FeatureComponents' table:
+
+    (new row)
+       Feature         : 'feaFreelanceKeys'
+       Component       : 'rcm_FreelanceKeys'
+
+    'Registry' table:
+
+       (new row)
+       Registry        : 'reg_freekey0'
+       Root            : 2
+       Key             : 'SOFTWARE\OpenAFS\Client\Freelance'
+       Component       : 'rcm_FreelanceKeys'
+
+       (new row)
+       Registry        : 'reg_freekey1'
+       Root            : 2
+       Key             : 'SOFTWARE\OpenAFS\Client\Freelance'
+       Name            : '0'
+        Value           : 'athena.mit.edu#athena.mit.edu:root.cell.'
+       Component       : 'rcm_FreelanceKeys'
+
+       (new row)
+       Registry        : 'reg_freekey2'
+       Root            : 2
+       Key             : 'SOFTWARE\OpenAFS\Client\Freelance'
+       Name            : '1'
+        Value           : '.athena.mit.edu%athena.mit.edu:root.cell.'
+       Component       : 'rcm_FreelanceKeys'
+
+       (new row)
+       Registry        : 'reg_freekey3'
+       Root            : 2
+       Key             : 'SOFTWARE\OpenAFS\Client\Freelance\Symlinks'
+       Component       : 'rcm_FreelanceKeys'
+
+       (new row)
+       Registry        : 'reg_freekey4'
+       Root            : 2
+       Key             : 'SOFTWARE\OpenAFS\Client\Freelance\Symlinks'
+       Name            : '0'
+        Value           : 'athena:athena.mit.edu.'
+       Component       : 'rcm_FreelanceKeys'
+
+       (new row)
+       Registry        : 'reg_freekey5'
+       Root            : 2
+       Key             : 'SOFTWARE\OpenAFS\Client\Freelance\Symlinks'
+       Name            : '0'
+        Value           : '.athena:.athena.mit.edu.'
+       Component       : 'rcm_FreelanceKeys'
+
+    The example adds a read-only mountpoint to the athena.mit.edu
+    cell's root.afs volume as well as a read-write mountpoint.  Aliases
+    are also provided using symlinks.
+
 ----------------------------------------------------------------------
 
 3   Additional Resources
@@ -642,6 +726,9 @@ OpenAFS for Windows
     wish to upgrade it you can author rows into the 'Upgrade' table as
     described in the Platform SDK.
 
+    When performing an upgrade with msiexec.exe execute the MSI with
+    the repair options "vomus".
+
 ----------------------------------------------------------------------
 
 5.  FAQ