From ea54ef0c0145b65d754b04f6e0b290d1c22e07ce Mon Sep 17 00:00:00 2001 From: Jeffrey Altman Date: Wed, 6 Feb 2008 17:58:17 +0000 Subject: [PATCH] DEVEL15-windows-release-notes-20080206 LICENSE MIT Updates for 1.5.31 --- .../en_US/html/ReleaseNotes/logo.htm | 2 +- .../html/ReleaseNotes/relnotes-frames.htm | 2 +- .../en_US/html/ReleaseNotes/relnotes.htm | 3585 ++++++++--------- .../en_US/html/ReleaseNotes/toc.htm | 526 +-- .../Documentation/en_US/html/index.htm | 4 +- 5 files changed, 1996 insertions(+), 2123 deletions(-) diff --git a/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/logo.htm b/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/logo.htm index a97c96bfea..94d558e761 100644 --- a/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/logo.htm +++ b/src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/logo.htm @@ -18,7 +18,7 @@ w\:* {behavior:url(#default#VML);} .shape {behavior:url(#default#VML);} -OpenAFS for Windows 1.5.30 Release Notes +OpenAFS for Windows 1.5.31 Release Notes -OpenAFS for Windows 1.5.30 Release Notes +OpenAFS for Windows 1.5.31 Release Notes Jeffrey Altman 4 - 957 + 1619 2006-11-29T17:26:00Z 2008-01-08T16:12:00Z - 47 - 18535 - 105654 + 1 + 18828 + 107322 Secure Endpoints Inc. - 880 - 247 - 123942 + 894 + 251 + 125899 11.9999 1. Installer Options

1. Installer Options

- -

2. System Requirements2. System Requirements

2.1 Supported Operating Systems2.1 Supported Operating Systems

2.1.1 Unsupported Operating Systems2.1.1 Unsupported Operating Systems

2.2 Disk Space2.2 Disk Space

2.3 Additional Software Packages2.3 Additional Software Packages

3. Operational Notes3. Operational Notes

3.1. Requirements for Kerberos v5 +href="relnotes.htm#_Toc190064021">3.1. Requirements for Kerberos v5 Authentication

3.1.1. Active Directory3.1.1. Active Directory

3.1.2. Using the krb524 service3.1.2. Using the krb524 service

3.1.3. Network Identity Manager Provider3.1.3. Network Identity Manager Provider

3.2. Use of the Microsoft Loopback Adapter by +href="relnotes.htm#_Toc190064025">3.2. Use of the Microsoft Loopback Adapter by the AFS Client Service

3.3. Using Freelance (Dynamic Root) Mode to +href="relnotes.htm#_Toc190064026">3.3. Using Freelance (Dynamic Root) Mode to Improve Mobility

3.4. Locating AFS Volume Database Servers via +href="relnotes.htm#_Toc190064027">3.4. Locating AFS Volume Database Servers via DNS

3.5. Obtaining AFS Tokens as a Integrated +href="relnotes.htm#_Toc190064028">3.5. Obtaining AFS Tokens as a Integrated Part of Windows Logon

3.6. AFS System Tray Command Line Options3.6. AFS System Tray Command Line Options

3.7. The “AFS Client Admins” Authorization +href="relnotes.htm#_Toc190064030">3.7. The “AFS Client Admins” Authorization Group

3.8. OpenAFS support for UNC paths3.8. OpenAFS support for UNC paths

3.9. aklog.exe3.9. aklog.exe

3.10. OpenAFS Servers on Windows are +href="relnotes.htm#_Toc190064033">3.10. OpenAFS Servers on Windows are Unsupported

3.10.1. OpenAFS Server Installation3.10.1. OpenAFS Server Installation

3.10.2. Using the AFS Client Service when the +href="relnotes.htm#_Toc190064035">3.10.2. Using the AFS Client Service when the Server is installed

3.11. OpenAFS Debugging Symbol files3.11. OpenAFS Debugging Symbol files

3.12. Large File (64-bit) Support3.12. Large File (64-bit) Support

3.13. Encrypted AFS Network Communication3.13. Encrypted AFS Network Communication

3.14. Authenticated Access to the OpenAFS +href="relnotes.htm#_Toc190064039">3.14. Authenticated Access to the OpenAFS Client Service

3.15. No More INI Files3.15. No More INI Files

3.16. Microsoft Windows Internet Connection +href="relnotes.htm#_Toc190064041">3.16. Microsoft Windows Internet Connection Firewall

3.17. Browsing AFS from the Explorer Shell +href="relnotes.htm#_Toc190064042">3.17. Browsing AFS from the Explorer Shell and Office

3.18. Byte Range Locking3.18. Byte Range Locking

3.19. Automatic Discarding of AFS Tokens at +href="relnotes.htm#_Toc190064044">3.19. Automatic Discarding of AFS Tokens at Logoff

3.20. Windows Terminal Server installations3.20. Windows Terminal Server installations

3.21. Hidden Dot Files3.21. Hidden Dot Files

3.22. Status Cache Limits3.22. Status Cache Limits

3.23. NETBIOS over TCP/IP must be enabled3.23. NETBIOS over TCP/IP must be enabled

3.24. OpenAFS binaries are digitally signed3.24. OpenAFS binaries are digitally signed

3.25. Maximum Size of the AFSCache File3.25. Maximum Size of the AFSCache File

3.26. Filename Character Sets3.26. Filename Character Sets

3.27. Known Character Set Issues with Roaming +href="relnotes.htm#_Toc190064052">3.27. Known Character Set Issues with Roaming Profiles

3.28. The AFSCache File3.28. The AFSCache File

3.29. Restricting OpenAFS Client Service -Start and Stop

3.30. The @sys Name List3.30. The @sys Name List

3.31. Symlinks to AFS UNC paths3.31. Symlinks to AFS UNC paths

3.32. Cache Manager Debugging3.32. Cache Manager Debugging

3.33. Windows Logon Caching vs. Kerberos +href="relnotes.htm#_Toc190064058">3.33. Windows Logon Caching vs. Kerberos Logons

3.34. Initial Server Preferences3.34. Initial Server Preferences

3.35. File Timestamps3.35. File Timestamps

3.36. Windows RPC client support must be +href="relnotes.htm#_Toc190064061">3.36. Windows RPC client support must be installed

3.37. Generating Minidumps of the OpenAFS -Client Service

3.38. AFS Client Universally Unique +href="relnotes.htm#_Toc190064063">3.38. AFS Client Universally Unique Identifiers (UUIDs) vs. System Cloning

3.39. Delayed Write Errors with Microsoft +href="relnotes.htm#_Toc190064064">3.39. Delayed Write Errors with Microsoft Office Applications

3.40. Global Drives (aka Service Drive +href="relnotes.htm#_Toc190064065">3.40. Global Drives (aka Service Drive Letters) are no longer supported by Microsoft

3.41. 64-bit Microsoft Windows Installations3.41. 64-bit Microsoft Windows Installations

3.42. Known Issues with Microsoft Windows +href="relnotes.htm#_Toc190064067">3.42. Known Issues with Microsoft Windows Vista

3.43. New AFS Share Name Syntax Provides +href="relnotes.htm#_Toc190064068">3.43. New AFS Share Name Syntax Provides Direct Access to Volumes

3.44. Differences between Windows and UNIX +href="relnotes.htm#_Toc190064069">3.44. Differences between Windows and UNIX “fs examine”

+

3.45. Literal evaluation of AFS objects via +fs commands

+ +

3.46. Out of Quota errors

+

4. How to Debug Problems with OpenAFS for +href="relnotes.htm#_Toc190064072">4. How to Debug Problems with OpenAFS for Windows:

4.1. pioctl debugging (IoctlDebug registry +href="relnotes.htm#_Toc190064073">4.1. pioctl debugging (IoctlDebug registry key)

4.2. afsd_service initialization log +href="relnotes.htm#_Toc190064074">4.2. afsd_service initialization log (%WinDir%\TEMP\afsd_init.log)

4.3. afsd_service debug logs (fs trace {-on, +href="relnotes.htm#_Toc190064075">4.3. afsd_service debug logs (fs trace {-on, -off, -dump} ->%WinDir%\TEMP\afsd.log)

4.4. Using SysInternal’s DbgView and ProcMon +href="relnotes.htm#_Toc190064076">4.4. Using SysInternal’s DbgView and ProcMon or FileMon Tools

4.5. Microsoft MiniDumps4.5. Microsoft MiniDumps  (fs minidump -> %WinDir%\TEMP\afsd.dmp)

4.6. Single Sign-on (Integrated Logon) +href="relnotes.htm#_Toc190064078">4.6. Single Sign-on (Integrated Logon) debugging

4.7. RX (AFS RPC) debugging (rxdebug)4.7. RX (AFS RPC) debugging (rxdebug)

4.8. Cache Manager debugging (cmdebug)4.8. Cache Manager debugging (cmdebug)

4.9. Persistent Cache consistency check4.9. Persistent Cache consistency check

4.10. Token Acquisition Debugging4.10. Token Acquisition Debugging

5. Reporting Bugs:5. Reporting Bugs:

6. How to Contribute to the Development of +href="relnotes.htm#_Toc190064084">6. How to Contribute to the Development of OpenAFS for Windows

6.1. The USENIX OpenAFS Fund6.1. The USENIX OpenAFS Fund

6.2. Secure Endpoints Inc.6.2. Secure Endpoints Inc.

6.3. Direct contributions of code and/or +href="relnotes.htm#_Toc190064087">6.3. Direct contributions of code and/or documentation

6.4. OpenAFS for Windows Mailing Lists6.4. OpenAFS for Windows Mailing Lists

7. MSI Deployment Guide7. MSI Deployment Guide

7.1. Introduction7.1. Introduction

7.1.1 Requirements7.1.1 Requirements

7.1.2 Authoring a Transform7.1.2 Authoring a Transform

7.2. Configuration Options7.2. Configuration Options

7.2.1 Configurable Properties7.2.1 Configurable Properties

7.2.1.1 Setting Properties7.2.1.1 Setting Properties

7.2.1.2 OpenAFS for Windows Properties7.2.1.2 OpenAFS for Windows Properties

(Service parameters):(Service parameters):

(Network provider):(Network provider):

(OpenAFS Client):(OpenAFS Client):

7.2.1.2.1 Registry Properties7.2.1.2.1 Registry Properties

AFSCACHEPATHAFSCACHEPATH

AFSCACHESIZEAFSCACHESIZE

AFSCELLNAMEAFSCELLNAME

FREELANCEMODEFREELANCEMODE

HIDEDOTFILESHIDEDOTFILES

LOGONOPTIONSLOGONOPTIONS

MOUNTROOTMOUNTROOT

NETBIOSNAMENETBIOSNAME

NOFINDLANABYNAMENOFINDLANABYNAME

RXMAXMTURXMAXMTU

SECURITYLEVELSECURITYLEVEL

SMBAUTHTYPESMBAUTHTYPE

STOREANSIFILENAMESSTOREANSIFILENAMES

USEDNSUSEDNS

7.2.1.2.2 AFSCreds.exe Properties7.2.1.2.2 AFSCreds.exe Properties

CREDSSTARTUPCREDSSTARTUP

CREDSAUTOINITCREDSAUTOINIT

CREDSIPCHDETCREDSIPCHDET

CREDSQUIETCREDSQUIET

CREDSRENEWDRMAPCREDSRENEWDRMAP

CREDSSHOWCREDSSHOW

7.2.2 Existing Registry Entries7.2.2 Existing Registry Entries

7.2.3 Replacing Configuration Files7.2.3 Replacing Configuration Files

7.2.3.1 Components for Configuration Files7.2.3.1 Components for Configuration Files

7.2.4 Adding Domain Specific Registry Keys7.2.4 Adding Domain Specific Registry Keys

7.2.5 Adding Site Specific Freelance Registry +href="relnotes.htm#_Toc190064126">7.2.5 Adding Site Specific Freelance Registry Keys

7.3 Additional Resources7.3 Additional Resources

7.4. Upgrades7.4. Upgrades

Appendix A: Registry ValuesAppendix A: Registry Values

A.1. Service parametersA.1. Service parameters

Regkey: +href="relnotes.htm#_Toc190064131">Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]

Value: LANadapterValue: LANadapter

Value: CacheSizeValue: CacheSize

Value: ChunkSizeValue: ChunkSize

Value: DaemonsValue: Daemons

Value: ServerThreadsValue: ServerThreads

Value: StatsValue: Stats

Value: LogoffPreserveTokensValue: LogoffPreserveTokens

Value: RootVolumeValue: RootVolume

Value: MountRootValue: MountRoot

Value: CachePathValue: CachePath

Value: NonPersistentCachingValue: NonPersistentCaching

Value: ValidateCacheValue: ValidateCache

Value: TrapOnPanicValue: TrapOnPanic

Value: NetbiosNameValue: NetbiosName

Value: IsGatewayValue: IsGateway

Value: ReportSessionStartupsValue: ReportSessionStartups

Value: TraceBufferSizeValue: TraceBufferSize

Value: SysNameValue: SysName

Value: SecurityLevelValue: SecurityLevel

Value: UseDNSValue: UseDNS

Value: FreelanceClientValue: FreelanceClient

Value: HideDotFilesValue: HideDotFiles

Value: MaxMpxRequestsValue: MaxMpxRequests

Value: MaxVCPerServerValue: MaxVCPerServer

Value: CellValue: Cell

Value: RxNoJumboValue: RxNoJumbo

Value: RxMaxMTUValue: RxMaxMTU

Value: ConnDeadTimeoutValue: ConnDeadTimeout

Value: HardDeadTimeoutValue: HardDeadTimeout

Value: TraceOptionValue: TraceOption

Value: AllSubmountValue: AllSubmount

Value: NoFindLanaByNameValue: NoFindLanaByName

Value: MaxCPUsValue: MaxCPUs

Value: smbAuthTypeValue: smbAuthType

Value: MaxLogSizeValue: MaxLogSize

Value: FlushOnHibernateValue: FlushOnHibernate

Value: daemonCheckDownIntervalValue: daemonCheckDownInterval

Value: daemonCheckUpIntervalValue: daemonCheckUpInterval

Value: daemonCheckVolIntervalValue: daemonCheckVolInterval

Value: daemonCheckCBIntervalValue: daemonCheckCBInterval

Value: daemonCheckLockIntervalValue: daemonCheckLockInterval

Value: daemonCheckTokenIntervalValue: daemonCheckTokenInterval

Value: daemonCheckOfflineVolIntervalValue: daemonCheckOfflineVolInterval

Value: CallBackPortValue: CallBackPort

Value: EnableServerLocksValue: EnableServerLocks

Value: DeleteReadOnlyValue: DeleteReadOnly

Value: BPlusTreesValue: BPlusTrees

Value: PrefetchExecutableExtensionsValue: PrefetchExecutableExtensions

Value: OfflineReadOnlyIsValidValue: OfflineReadOnlyIsValid

Value: GiveUpAllCallBacksValue: GiveUpAllCallBacks

Value: FollowBackupPathValue: FollowBackupPath

Regkey: +href="relnotes.htm#_Toc190064183">Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters\GlobalAutoMapper]

Value: <Drive Letter:> for example +href="relnotes.htm#_Toc190064184">Value: <Drive Letter:> for example "G:"

Regkey: [HKLM\SOFTWARE\OpenAFS\Client]Regkey: [HKLM\SOFTWARE\OpenAFS\Client]

Value: CellServDBDirValue: CellServDBDir

Value: VerifyServiceSignatureValue: VerifyServiceSignature

Value: IoctlDebugValue: IoctlDebug

Value: MiniDumpTypeValue: MiniDumpType

Value: StoreAnsiFilenamesValue: StoreAnsiFilenames

Regkey: +href="relnotes.htm#_Toc190064191">Regkey: [HKLM\SOFTWARE\OpenAFS\Client\CSCPolicy]

Value: "smb/cifs share name"Value: "smb/cifs share name"

Regkey: +href="relnotes.htm#_Toc190064193">Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Freelance]

Value: "numeric value"Value: "numeric value"

Regkey: +href="relnotes.htm#_Toc190064195">Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks]

Value: "numeric value"Value: "numeric value"

Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Realms]Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Realms]

Regkey: [HKLM\SOFTWARE\OpenAFS\Client\RealmsRegkey: [HKLM\SOFTWARE\OpenAFS\Client\Realms”Realm Name”]

Value: AFSEnabledValue: AFSEnabled

Regkey: [HKLM\SOFTWARE\OpenAFS\Client\RealmsRegkey: [HKLM\SOFTWARE\OpenAFS\Client\Realms”Realm Name””Cell Name”]

Value: MethodNameValue: MethodName

Value: RealmValue: Realm

Regkey: +href="relnotes.htm#_Toc190064203">Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Submounts]

Value: "submount name"Value: "submount name"

Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Server +href="relnotes.htm#_Toc190064205">Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Server Preferences\VLDB]

Value: "hostname or ip address"Value: "hostname or ip address"

Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Server +href="relnotes.htm#_Toc190064207">Regkey: [HKLM\SOFTWARE\OpenAFS\Client\Server Preferences\File]

Value: "hostname or ip address"Value: "hostname or ip address"

A.2. Integrated Logon Network provider +href="relnotes.htm#_Toc190064209">A.2. Integrated Logon Network provider parameters

Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]Regkey: +[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]

Value: FailLoginsSilentlyValue: FailLoginsSilently

Regkey: +href="relnotes.htm#_Toc190064212">Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]

Value: NoWarningsValue: NoWarnings

Value: AuthentProviderPathValue: AuthentProviderPath

Value: ClassValue: Class

Value: DependOnGroupValue: DependOnGroup

Value: DependOnServiceValue: DependOnService

Value: NameValue: Name

Value: ProviderPathValue: ProviderPath

A.2.1 Domain specific configuration keys for +href="relnotes.htm#_Toc190064220">A.2.1 Domain specific configuration keys for the Network Provider

[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider][HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]

[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain][HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain]

[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain"domain +href="relnotes.htm#_Toc190064223">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain"domain name"]

[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST][HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]

Example:Example:

A.2.1.1 Domain specific configuration valuesA.2.1.1 Domain specific configuration values

[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider] +href="relnotes.htm#_Toc190064227">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider] [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain"domain name"] [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]Value: LogonOptionsValue: LogonOptions

Value: FailLoginsSilentlValue: FailLoginsSilentl

Value: LogonScriptValue: LogonScript

Value: LoginRetryIntervalValue: LoginRetryInterval

Value: LoginSleepIntervalValue: LoginSleepInterval

Value: RealmValue: Realm

Value: TheseCellsValue: TheseCells

A.2.1.2 Selection of effective values for +href="relnotes.htm#_Toc190064235">A.2.1.2 Selection of effective values for domain specific configuration

A.2.1.3 Exceptions to A.2.1.2A.2.1.3 Exceptions to A.2.1.2

2.1.3.1 'FailLoginsSilently'2.1.3.1 'FailLoginsSilently'

2.1.3.2 'LogonScript'2.1.3.2 'LogonScript'

A.3. AFS Credentials System Tray Tool +href="relnotes.htm#_Toc190064239">A.3. AFS Credentials System Tray Tool parameters

Regkey: +href="relnotes.htm#_Toc190064240">Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]

Value: GatewayValue: Gateway

Value: CellValue: Cell

Regkey: [HKLM\SOFTWARE\OpenAFS\Client] +href="relnotes.htm#_Toc190064243">Regkey: [HKLM\SOFTWARE\OpenAFS\Client] [HKCU\SOFTWARE\OpenAFS\Client]

Value: ShowTrayIconValue: ShowTrayIcon

Value: EnableKFWValue: EnableKFW

Value: AcceptDottedPrincipalNamesValue: AcceptDottedPrincipalNames

Value: Use524Value: Use524

Value: AfscredsShortcutParamsValue: AfscredsShortcutParams

Regkey: [HKCU\SOFTWARE\OpenAFS\Client]Regkey: [HKCU\SOFTWARE\OpenAFS\Client]

Value: Authentication CellValue: Authentication Cell

Regkey: +href="relnotes.htm#_Toc190064251">Regkey: [HKCU\SOFTWARE\OpenAFS\Client\Reminders]

Value: "afs cell name"Value: "afs cell name"

Regkey: [HKCU\SOFTWARE\OpenAFS\Client\Active +href="relnotes.htm#_Toc190064253">Regkey: [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]

Value: "upper case drive letter"Value: "upper case drive letter"

Regkey: +href="relnotes.htm#_Toc190064255">Regkey: [HKCU\SOFTWARE\OpenAFS\Client\Mappings]

Value: "upper case drive letter"Value: "upper case drive letter"

A.4 +href="relnotes.htm#_Toc190064257">A.4 OpenAFS Client Service Environment Variables

Variable: AFS_RPC_ENCRYPTVariable: AFS_RPC_ENCRYPT

Variable: AFS_RPC_PROTSEQVariable: AFS_RPC_PROTSEQ

 

diff --git a/src/WINNT/doc/install/Documentation/en_US/html/index.htm b/src/WINNT/doc/install/Documentation/en_US/html/index.htm index 78d95954b2..bcd9796221 100755 --- a/src/WINNT/doc/install/Documentation/en_US/html/index.htm +++ b/src/WINNT/doc/install/Documentation/en_US/html/index.htm @@ -57,7 +57,7 @@ p

OpenAFS for Windows

-

Version 1.5.30

+

Version 1.5.31

 

@@ -80,7 +80,7 @@ revised documentation to replace it at the current time.

·         OpenAFS for Windows 1.5.30 +href="ReleaseNotes/relnotes-frames.htm">OpenAFS for Windows 1.5.31 Release Notes