OpenAFS for Windows Release Notes

This documentation is covered by the MIT License.

Revision History
Revision 1.7.2500

Abstract

This document provides a series of usage notes regarding the OpenAFS for Windows client, supported platforms, contribution information, debugging techniques, and a reference to supported Windows registry values.


Table of Contents

Preface
1. Installer Options
2. System Requirements
2.1 Supported Operating Systems
2.1.1 Unsupported Operating Systems
2.2 Disk Space
2.3 Additional Software Packages
3. Operational Notes
3.1. Unicode Support
3.1.1. Interoperability with MacOS X
3.2. Requirements for Kerberos v5 Authentication
3.2.1. Active Directory
3.2.2. The krb524 Service is no longer supported
3.2.3. Network Identity Manager Provider
3.2.4. Heimdal 1.5, MIT 4.x, and Weak Encryption Types
3.3. The Former use of the Microsoft Loopback Adapter by the OpenAFS Client Service
3.4. Using Freelance (Dynamic Root) Mode to Improve Mobility
3.5. Locating AFS Volume Database Servers via DNS
3.6. Obtaining AFS Tokens as a Integrated Part of Windows Logon
3.7. AFS Authentication Tool Command Line Options
3.8. The "AFS Client Admins" Authorization Group
3.9. OpenAFS Support for UNC Paths
3.10. aklog.exe
3.11. OpenAFS Servers on Windows are Unsupported
3.11.1. OpenAFS Server Installation
3.11.2. Using the AFS Client Service when the Server is installed
3.12. OpenAFS Debugging Symbols and Checked Builds
3.13. Large File (64-bit) Support
3.14. Encrypted AFS Network Communication
3.15. Authenticated SMB Access to the OpenAFS Client Service
3.16. IBM AFS INI Files Replaced By Windows Registry Keys
3.17. Microsoft Windows Internet Connection Firewall
3.18. Browsing AFS from the Explorer Shell and Office
3.19. Byte Range Locking
3.20. Automatic Discarding of AFS Tokens at Logoff
3.21. Windows Terminal Server installations
3.22. Hidden Dot Files
3.23. Status Cache Limits
3.24. NETBIOS over TCP/IP must be enabled
3.25. OpenAFS binaries are digitally signed
3.26. Maximum Size of the AFSCache File
3.27. Filename Character Sets
3.28. Character Set Issues with Roaming Profiles
3.29. The AFSCache File
3.30. Restricting OpenAFS Client Service Start and Stop
3.31. The @sys Name List
3.32. Symlinks to AFS UNC Paths
3.33. Cache Manager Debugging
3.34. Windows Logon Caching vs. Kerberos Logons
3.35. Initial Server Preferences
3.36. File Timestamps and Daylight Saving Time
3.37. Windows RPC client support must be installed
3.38. Generating Minidumps of the OpenAFS Client Service
3.39. AFS Client Universally Unique Identifiers (UUIDs) vs. System Cloning or Virtual Machine Cloning
3.40. Delayed Write Errors with Microsoft Office Applications
3.41. Global Drives (aka Service Drive Letters) are no longer supported by Microsoft
3.42. 64-bit Microsoft Windows Installations
3.43. Known Issues with Microsoft Windows Vista, Windows 7, Server 2008 [R2], Windows 8 and Server 2012
3.44. AFS Share Name Syntax Provides Direct Access to Volumes
3.45. Differences between Windows and UNIX fs examine
3.46. Literal evaluation of AFS Symlink and MountPoint objects via fs commands
3.47. Out of Quota errors
3.48. Linked Cells
3.49 Registry Alternative to CellServDB File
3.50 Release Notes Converted to Windows HTML Help
3.51. Support for Microsoft RPC Services: WKSSVC and SRVSVC
3.52. Differences between Windows and UNIX fs newcell
3.53. AFS Mount Points and Symlinks are Reparse Points
3.54. AFS Authentication Groups
3.55. Known IFS redirector driver limitations
3.56. Changes for Windows 8 and Server 2012
3.57. The Explorer Shell, Drive Letter Mappings, and Read Only Volumes
4. How to Troubleshoot Problems with OpenAFS for Windows
4.1. pioctl debugging ( IoctlDebug registry key)
4.2. afsd_service initialization log (%WinDir%\TEMP\afsd_init.log)
4.3. afsd_service debug logs (fs trace {-on, -off, -dump} ->%WinDir%\TEMP\afsd.log)
4.4. Using SysInternal's Debug Viewer, Process Monitor, Process Explorer and Process Dump Tools
4.5. Creating Microsoft MiniDumps (fs minidump -> %WinDir%\TEMP\afsd.dmp)
4.6. Single Sign-on (Integrated Logon) debugging
4.7. RX (AFS RPC) debugging (rxdebug)
4.8. Cache Manager RPC debugging (cmdebug)
4.9. Persistent Cache consistency check
4.10. Token Acquisition Debugging
5. Reporting Bugs
6. How to Contribute to the Development of OpenAFS for Windows
6.1. The USENIX OpenAFS Fund
6.2. Secure Endpoints Inc.
6.3. Your File System Inc.
6.4. Direct contributions of code and/or documentation
6.5. OpenAFS for Windows Mailing Lists
7. MSI Deployment Guide
7.1. Introduction
7.1.1 Requirements
7.1.2 Authoring a Transform
7.2. Configuration Options
7.2.1 Configurable Properties
7.2.2 Existing Registry Entries
7.2.3 Replacing Configuration Files
7.2.4 Adding Domain Specific Registry Keys
7.2.5 Adding Site Specific Freelance Registry Keys
7.3 Additional Resources
7.4. Upgrades
Appendix A. Registry Values
A.1. Service parameters
Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]
Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters\GlobalAutoMapper]
Regkey: [HKLM\SOFTWARE\OpenAFS\Client]
Regkey: [HKLM\SOFTWARE\OpenAFS\Client\CSCPolicy]
Regkey: [HKLM\SOFTWARE\OpenAFS\Client\CellServDB]
Regkey: [HKLM\SOFTWARE\OpenAFS\Client\CellServDB\<cellname>]
Regkey: [HKLM\SOFTWARE\OpenAFS\Client\CellServDB\<cellname>\<server>]
Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Freelance]
Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks]
Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Realms]
Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Realms\<Realm Name>]
Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Realms\<Realm Name>\<Cell Name>]
Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Submounts]
Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Server Preferences\VLDB]
Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Server Preferences\File]
A.2. Integrated Logon Network Provider Parameters
Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]
Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]
A.2.1 Domain specific configuration keys for the Network Provider
A.3. AFS Credentials System Tray Tool parameters
Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]
Regkey: [HKLM\SOFTWARE\OpenAFS\Client] [HKCU\SOFTWARE\OpenAFS\Client]
Regkey: [HKCU\SOFTWARE\OpenAFS\Client]
Regkey: [HKCU\SOFTWARE\OpenAFS\Client\Reminders]
Regkey: [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]
Regkey: [HKCU\SOFTWARE\OpenAFS\Client\Mappings]
A.4 OpenAFS Client Service Environment Variables
Value: AFS_RPC_ENCRYPT
Value: AFS_RPC_PROTSEQ
A.5 AFS Redirector Parameters
[HKLM\SYSTEM\CurrentControlSet\Services\AFSRedirector\Parameters]
[HKLM\SYSTEM\CurrentControlSet\Services\AFSRedirector\NetworkProvider]
Index