OpenAFS for Windows Release Notes

This documentation is covered by the MIT License.

Revision History
Revision 1.5.6400

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.2. Requirements for Kerberos v5 Authentication
3.2.1. Active Directory
3.2.2. Using the krb524 Service
3.2.3. Network Identity Manager Provider
3.3. Use of the Microsoft Loopback Adapter by the AFS 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 System Tray 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 Symbol files
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. INI Files Replaced By Windows Registry
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
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, and Server 2008 [R2]
3.44. New AFS Share Name Syntax Provides Direct Access to Volumes
3.45. Differences between Windows and UNIX "fs examine"
3.46. Literal evaluation of AFS objects via fs commands
3.47. Out of Quota errors
3.48. Linked Cells
3.49 Registry Configuration for AFS Volume Database Servers
3.50 Documentation Converted to Windows HTML Help
3.51. Support for Microsoft RPC Services: WKSSVC and SRVSVC
4. How to Debug 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 and Process Explorer 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 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. Direct contributions of code and/or documentation
6.4. 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
Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]
Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain]
Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\"domain name"]
Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]
Domain Specific Example:
A.2.1.1 Domain Specific Configuration Values
A.2.1.2 Selection of effective values for domain specific configuration
A.2.1.3 Exceptions to A.2.1.2
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
Index