winnotes-20050427
[openafs.git] / doc / txt / winnotes / afs-install-notes.txt
index 1ec3a34..ad1d8a1 100644 (file)
@@ -1,4 +1,4 @@
-OpenAFS for Windows 1.3.78 Installation Notes
+OpenAFS for Windows 1.3.82 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
@@ -501,6 +502,87 @@ logoff scripts (assigned by group policy) which rename all files to use
 only the supported characters for the locale.
 
 
+31. As of 1.3.80 the AFS Cache file is stored by default at %TEMP%\AFSCache
+in a persistent file marked with the Hidden and System attributes.  The 
+persistent nature of the data stored in the cache file improves the 
+performance of OpenAFS by reducing the number of times data must be read
+from the AFS file servers.
+
+
+32. Integrated Login (as of 1.3.80) supports the ability to obtain tokens
+for multiple cells.  See the "TheseCells" value in registry.txt.
+
+
+33. New command line tool:
+
+    afsdacl : Set or reset the DACL to allow starting or stopping
+         the afsd service by any ordinary user.
+
+    Usage : afsdacl [-set | -reset] [-show]
+          -set   : Sets the DACL
+          -reset : Reset the DACL
+          -show  : Show current DACL (SDSF)
+
+34. As of 1.3.80, the default @sys name list has been changed to 
+"x86_win32 i386_w2k i386_nt40" for 32-bit x86 systems.  The default 
+for itanium will be "ia64_win64" and "amd64_win64" for amd 64-bit 
+processors.
+
+
+35. As of 1.3.80, symlinks to \\AFS[\all]\... will now be treated
+the same as symlinks to /afs/...  However, please use /afs/... as
+the Windows UNC form will not work on Unix.
+
+
+36. As of 1.3.80, OpenAFS for Windows implements the Cache Manager
+Debugging RPC Interface.  The CM debugger can be queried with 
+cmdebug.exe.
+
+Usage: cmdebug -servers <server machine> [-port <IP port>] [-long]
+               [-addrs] [-cache] [-help]
+Where: -long   print all info
+       -addrs  print only host interfaces
+       -cache  print only cache configuration
+
+37.  If you are a site which utilizes MIT/Heimdal Kerberos principals
+to logon to Windows via a cross-realm relationship with a multi-domain
+Windows forest, you must enable Windows logon caching unless the 
+workstation is Longhorn Beta 1 or later.
+
+
+38. VLDB and File Server Preferences can now be provided initial 
+values using registry keys.  This is useful for managed machines in a
+Windows domain which are centrally located (e.g., in a computing
+lab.)  See registry.txt for details on the "Server Preferences" keys.
+
+
+39. As of 1.3.81, timestamps on file stored in AFS are reported to 
+Windows in UTC all year round.  Previously, in locales with daylight
+savings time, the time reported by AFS to Windows when DST is active
+was UTC+1.  This was done to preserve the relative local time for the
+user.  A file stored at 11:00am EST in January would be reported as
+having been stored at 11:00am EDT in June.  Unfortunately, this has
+the negative side effect of changing the reported timestamp from 16:00UTC
+to 15:00UTC.  Since Windows treats all file times in UTC, data 
+synchronization applications which rely on the timestamp would believe
+that all files stored in AFS had changed.  This will no longer be the
+case. 
+
+It should be noted that Unix based operating systems (such as Solaris)
+do not appear to report file times to applications in UTC.  They do 
+preserve the relative local time.  This may confuse some users who are
+used to being able to compare the timestamp in an Unix shell with the
+timestamp from the Windows explorer.  During DST, these two times will
+no longer agree even though they are in fact describing the same time.
+
+
+40. If the installer refuses to install and complains about an RPC
+configuration error, check to ensure that the following registry
+entries are present and that they refer to the dll "rpcrt4.dll":
+
+   HKLM "SOFTWARE\Microsoft\RPC\ClientProtocols" "ncacn_np"
+   HKLM "SOFTWARE\Microsoft\RPC\ClientProtocols" "ncacn_ip_tcp"
+   HKLM "SOFTWARE\Microsoft\RPC\ClientProtocols" "ncadg_ip_udp"
 
 ------------------------------------------------------------------------