afslogon-wix-cleanup-20040715
[openafs.git] / doc / txt / winnotes / afs-install-notes.txt
index d3f0871..c365af4 100644 (file)
@@ -1,4 +1,4 @@
-OpenAFS for Windows 1.3.65 Installation Notes
+OpenAFS for Windows 1.3.66 Installation Notes
 ---------------------------------------------
 
 The OpenAFS for Windows product was very poorly maintained throughout the 
@@ -69,9 +69,9 @@ automatically result in a new read-only mount point being created in the fake
 root.afs volume.  These mount points are preserved between service starts in 
 the %WINDIR%\afs_freelance.ini file.  
 
-Unfortunately, at the current time it is not possible to create read-write 
-mount points in the fake root.afs cell.  This is a limitation which will be 
-addressed in a future release.
+As of 1.3.66, Freelance mode supports read-write mount points in the fake
+root.afs volume.  In addition, if the mount point list is empty, mount points
+for "cellname" (ro) and ".cellname" (rw) will be automatically generated.
 
 4. The OpenAFS for Windows client will make use of AFSDB DNS records to 
 discover cell information when it is not located in the local CellServDB file 
@@ -103,7 +103,9 @@ In particular, if you are using this mode it is crucial that new AFS tokens
 not be obtained after the logon session starts except via the AFS Systray tool 
 as started by the AFS Network Provider.  If the AFS Systray tool is stopped 
 you must log off to obtain new tokens.  Do not use external tools such as 
-"aklog.exe" if High Security mode is turned on.
+"aklog.exe" if High Security mode is turned on. As of 1.3.66, OpenAFS supports 
+Authenticated SMB connections which removes the need for High Security mode. 
+DO NOT USE IT!!!!! 
 
 7. The AFS Systray tool (afscreds.exe) supports several new command line 
 options: 
@@ -178,11 +180,15 @@ reports.
 13. OpenAFS for Windows does not support files larger than 2GB.
 
 14. There are documented problems running the AFS Client on Hyperthreaded 
-Pentium 4 machines.  At the current time it is recommended that hyper- 
-threading be disabled in the machine configuration.
+Pentium 4 machines.  As of 1.3.66, a registry entry may be created to specify
+that the AFS Client Service should only use a single processor.  If you have
+a hyperthreaded system it is strongly advised that this registry value be set.
+See "registry.txt" for details on the MaxCPUs value. 
 
 15. OpenAFS for Windows currently requires the use of TCP based RPC. If the 
 machine is restricted to Local RPC only, you will be unable to store tokens.
+As of 1.3.66, Local RPC is used as the default RPC mechanism for setting 
+tokens.  TCP RPC is still used for debugging and other functions.
 
 16. OpenAFS for Windows does not automatically open ports in the Windows 
 Internet Connection Firewall.  You must manually open port 7001 to allow for 
@@ -192,6 +198,46 @@ incoming callback messages to be received by AFS file servers.
 encrypted data transfer between the AFS client and the AFS servers.  This
 is often referred to as "crypt" mode.
 
+18. OpenAFS 1.3.66 adds support for authenticated SMB connections using 
+either NTLM or GSS SPNEGO (NTLM, Kerberos 5, ...).  In previous versions
+of OpenAFS the SMB connections were unauthenticated which left open the
+door for several security holes which could be used to obtain access to
+the use of other user's tokens on shared machines.  With the introduction
+of authenticated SMB connections the so called High Security mode should
+no longer be used.  
+
+When GSS SPNEGO results in a Kerberos 5 authentication, the Windows SMB
+client will attempt to retrieve service tickets for "cifs/afs@REALM" (if 
+the loopback adapter is in use) or "cifs/machine-afs@REALM" (if the loopback
+adapter is not being used).  It is extremely important that this service 
+principal not exist in the KDC database.   If the request for this ticket
+fails, a subsequent request for "cifs/HOST$@REALM" will be issued.  This 
+service principal should exist in the KDC database.  The key associated 
+with this service principal must match the key assigned to 
+"host/machine@REALM".  If the local machine is part of a Windows Domain
+this will all be taken care of for you.  If the local machine is using
+a non-MS KDC for authentication, then your KDC administrator will have to
+add these service principals to the list of principals to be maintained
+for each host.
+
+19. As of 1.3.66, the use of INI files for the storage of AFS configuration
+data is no more.  No longer are there any AFS related files stored in the
+%WINDIR% directory.  The CellServDB file is no longer called "afsdsbmt.ini"
+and it is stored in the OpenAFS\Client directory.  The afs_freelance.ini
+and afsdsbmt.ini file data has been moved to the registry.  
+
+IMPORTANT: while the CellServDB file location and freelance mountpoint
+data will be automatically migrated; there is no mechanism for automatic
+migration of Submounts, Drive Mappings, Active Maps, and CSCPolicy data.
+
+20. As of 1.3.66, the OpenAFS Client is compatible with Windows XP SP2.
+The Internet Connection Firewall will be automatically adjusted to allow
+the receipt of incoming callback messages from the AFS file server.  In 
+addition, the appropriate Back Connection entries are added to the registry
+to allow SMB authentication to be performed across the loopback connection.
+
+21. 
+
 ------------------------------------------------------------------------
 
 Reporting Bugs: