From: Jeffrey Altman Date: Sun, 29 Jan 2012 05:22:03 +0000 (-0500) Subject: Windows: Release Notes for 1.7.5 X-Git-Tag: openafs-stable-1_8_0pre1~2796 X-Git-Url: https://git.openafs.org/?p=openafs.git;a=commitdiff_plain;h=55af3387ef90053a10b012ffe7ae1ebee7575e01;hp=de4d12dd5366bfddb6fde5bb050ce8fbaeb95f1a Windows: Release Notes for 1.7.5 Release notes updates for 1.7.5. Change-Id: Ie44441150fc077cc4ca7924c67322a1aed4cb9af Reviewed-on: http://gerrit.openafs.org/6624 Reviewed-by: Jeffrey Altman Tested-by: Jeffrey Altman --- diff --git a/doc/xml/ReleaseNotesWindows/relnotes.xml b/doc/xml/ReleaseNotesWindows/relnotes.xml index 2d6bdf9..eebabb3 100644 --- a/doc/xml/ReleaseNotesWindows/relnotes.xml +++ b/doc/xml/ReleaseNotesWindows/relnotes.xml @@ -7,7 +7,7 @@ OpenAFS for Windows Release Notes - 2003-2011 + 2003-2012 Secure Endpoints Inc. and Your File System Inc. @@ -185,6 +185,19 @@ It is important to note that AFS file servers are character-set agnostic. All file system object names are stored as octet strings without any character set tagging. If a file system object is created using OEM Code Page 858 and then interpreted as UTF-8 it is likely that the object name will appear to be gibberish. OpenAFS for Windows goes to great lengths to ensure that the object name is converted to a form that will permit the user to rename the object using Unicode. Accessing UTF-8 names on UNIX systems that have the locale set to one of the ISO Latin character sets will result in the UTF-8 strings appearing to be gibberish. UNIX AFS can not perform Unicode Normalization for string comparisons. Although it is possible to store and read Unicode object names, it is possible that a user may not be able to open an object by typing the name of the object at the keyboard. GUI point and click operations should permit any object to be accessed. +
+ 3.1.1. Interoperability with MacOS X + + MacOS X + + MacOS X uses UTF-8 Normalization Form D (NFD) whereas Microsoft Windows and most other + applications use UTF-8 Normalization Form C (NFC). The difference is that in NFD Unicode + character sequences containing diacritical marks are decomposed whereas in NFC the Unicode + character sequences use combined characters whenever possible. Whereas Microsoft Windows + can display and manipulate files stored using NFD, MacOS X Finder does have trouble with + filenames that are NFC encoded. All file names stored by the OpenAFS Windows client use + NFC. +
3.2. Requirements for Kerberos v5 Authentication @@ -267,9 +280,18 @@ principal. A user object must be used. - Starting with Windows Server 2008 R2, Microsoft has disabled the single DES - encryption types. DES must be enabled via Group Policy in order for Active - Directory to be used as a KDC for OpenAFS. + Starting with Windows 7 and Windows Server 2008 R2, Microsoft has disabled the + single DES encryption types,TechNet: + Changes in Kerberos Authentication. DES must be enabled via Group Policy + in order for Active Directory to be used as a KDC for OpenAFS. Enable weak + encryption becuase of AFS... Start > Administrative Tools > Group Policy + Management Expand Forest > Domains > (domain name) > Group Policy Objects + > Default Domain Policy Right-click "Default Domain Policy" and select "Edit" + Expand "Computer Configuration" > "Policies" > "Windows Settings” > + "Security Settings” > "Local Policies” > "Security Options” Double click + "Network security: Configure encryption types allowed for Kerberos” Select "Define + this policy setting", then select "DES_CBC_CRC" and all the others... Press "OK"
@@ -348,6 +370,16 @@ +
+ 3.2.4. Heimdal 1.5 and Weak Encryption Types + Just as Microsoft disabled the use of Weak Encryption Types in Windows 7 and Windows + Server 2008 R2, Heimdal and MIT have disabled the use of weak encryption types in their + latest releases. In order to use Heimdal 1.5 or MIT Kerberos 1.9 or later with OpenAFS, + the weak encryption types including DES-CBC-CRC and DES-CBC-MD5 must be enabled. In + Heimdal, this is performed by adding "allow_weak_crypto = true" to the [libdefaults] + section of the %SystemRoot%\ProgramData\krb5.conf file. + Futures versions of OpenAFS will not have this requirement. +
3.3. The Former use of the Microsoft Loopback Adapter by the OpenAFS Client Service @@ -771,7 +803,10 @@ 64-bit file sizes - As of release 1.5.3, OpenAFS for Windows supports files larger than 2GB. The maximum file size is now 16777216 terabytes when the AFS File Server supports large files. If the AFS File Server does not support 64-bit file sizes, then the maximum size of files stored on that server remains 2GB. + As of release 1.5.3, OpenAFS for Windows supports files larger than 2GB. The maximum + file size is now 16777216 terabytes when the AFS File Server supports large files. If the + AFS File Server does not support 64-bit file sizes, then the maximum size of files stored on + that server remains 2GB.
3.14. Encrypted AFS Network Communication @@ -1824,11 +1859,11 @@ TraceOption - If you are having trouble with the Integrated Logon operations it is often useful to be able to obtain a log of what it is attempting to do. Setting Bit 0 of the - TraceOption registry value: - - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] - REG_DWORD TraceOption = 0x01 + If you are having trouble with the Integrated Logon operations it is often useful to be + able to obtain a log of what it is attempting to do. Setting the Debug registry value: + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider] + REG_DWORD Debug = 0x01 will instruct the Integrated Logon Network Provider and Event Handlers to log information to the Windows Event Log: Application under the name "AFS Logon".
@@ -3124,7 +3159,7 @@ Value: Daemons Type: DWORD - Default: 4 (CM_CONFIGDEFAULT_DAEMONS) + Default: 16 (CM_CONFIGDEFAULT_DAEMONS) Variable: numBkgD Number of background daemons (number of threads of cm_BkgDaemon). (see cm_BkgDaemon in cm_daemon.c)
@@ -3630,18 +3665,30 @@ Variable: rx_nojumbo IdleDeadTimeout Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] - - Type: DWORD - - - Default: 0 (seconds) - - - Variable: IdleDeadtimeout - - The Idle Dead Time determines how long the cache manager will wait for an RPC to complete when the service is responding that it is busy. - If the timeout occurs on a replicated object, the cache manager can choose to fail over to an alternate replica. - This value is typically the same as the ConnDeadTimeout. + Type: DWORD + Default: 1200 (seconds) + Variable: IdleDeadtimeout + The Idle Dead Time determines how long the cache manager will wait for an RPC on a + non-replicated volume to complete when the service is responding only with keep alive + messages. When there is no replica available there is no other file server to try. An + idle dead timeout in this case is fatal. This option is intended to protect a client + against a file server that never responds. This value must be larger that the file + server hard dead timeout of 120 seconds. + +
+ Value: ReplicaIdleDeadTimeout + + ReplicaIdleDeadTimeout + + Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] + Type: DWORD + Default: 180 (seconds) + Variable: ReplicaIdleDeadtimeout + The Replica Idle Dead Time determines how long the cache manager will wait for an + RPC on a replicated volume to complete when the service is responding only with keep + alive messages. When a volume is replicated the cache manager can choose to retry the + request against a file server hosting one of the replicas. This value must be larger + that the file server hard dead timeout of 120 seconds.
Value: NATPingInterval @@ -3718,9 +3765,11 @@ Default: 0 Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] Type: DWORD {1..32} or {1..64} depending on the architecture - -Default: <no default> - If this value is specified, afsd_service.exe will restrict itself to executing on the specified number of CPUs if there are a greater number installed in the machine. + Default: 2 + If this value is specified, afsd_service.exe will restrict itself to executing on + the specified number of CPUs if there are a greater number installed in the machine. + Performance profiling shows that overall system performance degrades when the + afsd_service.exe is permitted to execute on more than two cores.
Value: SmbAuthType @@ -3948,8 +3997,7 @@ Default: 0 Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] Type: DWORD {0, 1} - -Default: 0 + Default: 1 Determines whether or not the AFS Cache Manager will give up all callbacks prior to the service being suspended or shutdown. Doing so will have significant performance benefits for the file servers. However, file servers older than 1.4.6 can become unstable if the GiveUpAllCallBacks RPC is executed. 0: do not perform GiveUpAllCallBacks RPCs 1: perform GiveUpAllCallBacks RPCs @@ -3962,15 +4010,14 @@ Default: 0 Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] Type: DWORD {0, 1} - -Default: 0 - - Determines whether or not the AFS Cache Manager will will make use of the volume version information reported - by the file server as part of the AFSVolSync data structure. Use of volume version information can significantly - reduce the number of FetchStatus RPCs issued on objects stored in read-only volumes. This functionality is - disabled by default because all OpenAFS file servers older than OpenAFS 1.4.10 failed to include valid volume - version information as part of the BulkStatus and InlineBulkStatus RPCs. - + Default: 0 + Determines whether or not the AFS Cache Manager will will make use of the volume + version information reported by the file server as part of the AFSVolSync data + structure. Use of volume version information can significantly reduce the number of + FetchStatus RPCs issued on objects stored in read-only volumes. This functionality is + disabled by default because all OpenAFS file servers older than OpenAFS 1.4.10 failed to + include valid volume version information as part of the BulkStatus and InlineBulkStatus + RPCs. 0: do not make use of volume version information 1: make use of volume version information
@@ -3982,8 +4029,7 @@ Default: 0 Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] Type: DWORD {0, 1} - -Default: 0 + Default: 0 Determines whether or not the AFS Cache Manager will give preference to .backup volumes when following mount points that originate in a .backup volume. 0: do not prefer .backup volumes when the mount point originates in a .backup volume. 1: prefer .backup volumes when the mount point originates in a .backup volume. @@ -3996,10 +4042,23 @@ Default: 0 Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] Type: DWORD {bytes} - -Default: 262144 + Default: 262144 Specifies the UDP socket receive and send buffer sizes.. +
+ Value: VerifyData + + VerifyData + + Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters] + Type: DWORD {0, 1} + Default: 0 + 1: after every RXAFS_StoreData RPC immediately perform an RXAFS_FetchData RPC and + verify that the data was correctly stored on the file server. If the data does not + match, retry the store operation until it does. + The "fs getverify" and "fs setverify {on, off}" commands can be used to query and + set this value at runtime. +
Regkey: @@ -4422,8 +4481,7 @@ Default: <none></para> <para>Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</para> <para>Type: DWORD </para> - <para> -Default: 0</para> + <para>Default: 0</para> <para>Do not display message boxes if the login fails.</para> </section> </section> @@ -4438,11 +4496,18 @@ Default: 0</para> <para>Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]</para> <para>Type: DWORD </para> - <para> -Default: 0</para> + <para>Default: 0</para> <para>Disables visible warnings during logon.</para> </section> <section> + <title id="Value_AFSLogon_Debug">Value: Debug + Regkey: + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider] + Type: DWORD + Default: 0 + Set to 1 to turn on "AFS Logon" event logging to the Windows Event Log. +
+
Value: AuthentProviderPath AuthentProviderPath @@ -4521,201 +4586,236 @@ NSIS: %WINDIR%\SYSTEM32\afslogon.dll Specifies the DLL to use for the network provider
- -
- A.2.1 Domain specific configuration keys for the Network Provider - - domain logon configuration - - The network provider can be configured to have different behavior depending on the domain that the user logs into. These settings are only relevant when using integrated login. A domain refers to an Active Directory (AD) domain, a trusted Kerberos (non-AD) realm or the local machine (i.e. local account logins). The domain name that is used for selecting the domain would be the domain that is passed into the NPLogonNotify function of the network provider. - Domain specific registry keys are: -
- Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider] - (NP key) -
-
- Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] - (Domains key) -
-
- Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<Domain Name>] - (Specific domain key. One per domain.) -
-
- Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] - (Localhost key) -
-
- Domain Specific Example: - HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider - | - +- Domain - +-AD1.EXAMPLE.COM - +-AD2.EXAMPLE.NET - +-LOCALHOST - Each of the domain specific keys can have the set of values described in 2.1.1. The effective values are chosen as described in 2.1.2. -
-
- A.2.1.1 Domain Specific Configuration Values -
- Regkeys: [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: LogonOptions - - LogonOptions - - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<domain name>] - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] - Type: DWORD - - -Default: 0x01 - NSIS/WiX: depends on user configuration - - - 0x00 - Integrated Logon is not used - - -0x01 - Integrated Logon is used - - -0x02 - High Security Mode is used (deprecated) - - -0x03 - Integrated Logon with High Security Mode is used (deprecated) - - - - High Security Mode generates random SMB names for the creation of Drive Mappings. This mode should not be used without Integrated Logon. - As of 1.3.65 the SMB server supports SMB authentication. The High Security Mode should not be used when using SMB authentication (SMBAuthType setting is non zero). +
+ A.2.1 Domain specific configuration keys for the Network Provider + + domain logon configuration + + The network provider can be configured to have different behavior depending on the + domain that the user logs into. These settings are only relevant when using integrated + login. A domain refers to an Active Directory (AD) domain, a trusted Kerberos (non-AD) + realm or the local machine (i.e. local account logins). The domain name that is used for + selecting the domain would be the domain that is passed into the NPLogonNotify function of + the network provider. + Domain specific registry keys are: +
+ Regkey: + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider] + (NP key) +
+
+ Regkey: + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] + (Domains key) +
+
+ Regkey: + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<Domain + Name>] + (Specific domain key. One per domain.) +
+
+ Regkey: + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] + (Localhost key) +
+
+ Domain Specific Example: + HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider + | + +- Domain + +-AD1.EXAMPLE.COM + +-AD2.EXAMPLE.NET + +-LOCALHOST + Each of the domain specific keys can have the set of values described in 2.1.1. The + effective values are chosen as described in 2.1.2. +
+
+ A.2.1.1 Domain Specific Configuration + Values +
+ Regkeys: + [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: LogonOptions + + LogonOptions + + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<domain + name>] + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] + Type: DWORD + Default: 0x01 + NSIS/WiX: depends on user configuration + + + 0x00 - Integrated Logon is not used + 0x01 - Integrated Logon is used + 0x02 - High Security Mode is used (deprecated) + 0x03 - Integrated Logon with High Security Mode is used (deprecated) + + + + High Security Mode generates random SMB names for the creation of Drive + Mappings. This mode should not be used without Integrated Logon. + As of 1.3.65 the SMB server supports SMB authentication. The High Security Mode + should not be used when using SMB authentication (SMBAuthType setting is non + zero). +
+
+ Value: + FailLoginsSilently + + FailLoginsSilently + + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<domain + name>] + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] + Type: DWORD (1|0) + Default: 0 + NSIS/WiX: (not set) + If true, does not display any visible warnings in the event of an error during + the integrated login process. +
+
+ Value: LogonScript + + LogonScript + + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<domain + name>] + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] + Type: REG_SZ or REG_EXPAND_SZ + Default: (null) + NSIS/WiX: (only value under NP key) <install path>\afscreds.exe -:%s -x + -a -m -n -q + A logon script that will be scheduled to be run after the profile load is + complete. If using the REG_EXPAND_SZ type, you can use any system environment + variable as "%varname%" which would be expanded at the time the network provider is + run. Optionally using a "%s" in the value would result in it being expanded into the + AFS SMB username for the session. +
+
+ Value: + LoginRetryInterval + + LoginRetryInterval + + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<domain + name>] + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] + Type: DWORD + Default: 30 + NSIS/WiX: (not set) + If the OpenAFS client service has not started yet, the network provider will + wait for a maximum of "LoginRetryInterval" seconds while retrying every + "LoginSleepInterval" seconds to check if the service is up. +
+
+ Value: + LoginSleepInterval + + LoginSleepInterval + + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<domain + name>] + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] + Type: DWORD + Default: 5 + NSIS/WiX: (not set) + See description of LoginRetryInterval. +
+
+ Value: Realm + + Realm + + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<domain + name>] + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] + Type: REG_SZ + NSIS: <not set> + When Kerberos v5 is being used, Realm specifies the Kerberos v5 realm that + should be appended to the first component of the Domain logon username to construct + the Kerberos v5 principal for which AFS tokens should be obtained. +
+
+ Value: TheseCells + + TheseCells + + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<domain + name>] + [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] + Type: REG_MULTI_SZ + NSIS: <not set> + When Kerberos v5 is being used, TheseCells provides a list of additional cells + for which tokens should be obtained with the default Kerberos v5 principal. +
+
+
+ A.2.1.2 Selection + of effective values for domain specific configuration + During login to domain X, where X is the domain passed into NPLogonNotify as + lpAuthentInfo->LogonDomainName or the string 'LOCALHOST' if + lpAuthentInfo->LogonDomainName equals the name of the computer, the following keys + will be looked up. + 1. NP key. + ("HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider") + 2. Domains key. (NP key\"Domain") + 3. Specific domain key. (Domains key\X) + If the specific domain key does not exist, then the domains key will be ignored. All + the configuration information in this case will come from the NP key. + If the specific domain key exists, then for each of the values metioned in (2), they + will be looked up in the specific domain key, domains key and the NP key successively + until the value is found. The first instance of the value found this way will be the + effective for the login session. If no such instance can be found, the default will be + used. To re-iterate, a value in a more specific key supercedes a value in a less + specific key. The exceptions to this rule are stated below. +
+
+ A.2.1.3 Exceptions to A.2.1.2 + To retain backwards compatibility, the following exceptions are made to + A.2.1.2.
- Value: FailLoginsSilently + 2.1.3.1 + 'FailLoginsSilently' FailLoginsSilently - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<domain name>] - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] - Type: DWORD (1|0) - - -Default: 0 - - -NSIS/WiX: (not set) - If true, does not display any visible warnings in the event of an error during the integrated login process. + Historically, the 'FailLoginsSilently' value was in + HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters key and not in the + NP key. Therefore, for backwards compatibility, the value in the Parameters key will + supercede all instances of this value in other keys. In the absence of this value in + the Parameters key, normal scope rules apply.
- Value: LogonScript + 2.1.3.2 + 'LogonScript' LogonScript - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<domain name>] - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] - Type: REG_SZ or REG_EXPAND_SZ - - -Default: (null) - - -NSIS/WiX: (only value under NP key) <install path>\afscreds.exe -:%s -x -a -m -n -q - A logon script that will be scheduled to be run after the profile load is complete. If using the REG_EXPAND_SZ type, you can use any system environment variable as "%varname%" which would be expanded at the time the network provider is run. Optionally using a "%s" in the value would result in it being expanded into the AFS SMB username for the session. + If a 'LogonScript' is not specified in the specific domain key nor in the domains + key, the value in the NP key will only be checked if the effective 'LogonOptions' + specify a high security integrated login. If a logon script is specified in the + specific domain key or the domains key, it will be used regardless of the high + security setting. Please be aware of this when setting this value.
-
- Value: LoginRetryInterval - - LoginRetryInterval - - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<domain name>] - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] - Type: DWORD - - -Default: 30 - - -NSIS/WiX: (not set) - If the OpenAFS client service has not started yet, the network provider will wait for a maximum of "LoginRetryInterval" seconds while retrying every "LoginSleepInterval" seconds to check if the service is up. -
-
- Value: LoginSleepInterval - - LoginSleepInterval - - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<domain name>] - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] - Type: DWORD - - -Default: 5 - - -NSIS/WiX: (not set) - See description of LoginRetryInterval. -
-
- Value: Realm - - Realm - - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<domain name>] - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] - Type: REG_SZ - - -NSIS: <not set> - When Kerberos v5 is being used, Realm specifies the Kerberos v5 realm that should be appended to the first component of the Domain logon username to construct the Kerberos v5 principal for which AFS tokens should be obtained. -
-
- Value: TheseCells - - TheseCells - - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain] - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\<domain name>] - [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST] - Type: REG_MULTI_SZ - - -NSIS: <not set> - When Kerberos v5 is being used, TheseCells provides a list of additional cells for which tokens should be obtained with the default Kerberos v5 principal. -
-
-
-
- A.2.1.2 Selection of effective values for domain specific configuration - During login to domain X, where X is the domain passed into NPLogonNotify as lpAuthentInfo->LogonDomainName or the string 'LOCALHOST' if lpAuthentInfo->LogonDomainName equals the name of the computer, the following keys will be looked up. - 1. NP key. ("HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider") - 2. Domains key. (NP key\"Domain") - 3. Specific domain key. (Domains key\X) - If the specific domain key does not exist, then the domains key will be ignored. All the configuration information in this case will come from the NP key. - If the specific domain key exists, then for each of the values metioned in (2), they will be looked up in the specific domain key, domains key and the NP key successively until the value is found. The first instance of the value found this way will be the effective for the login session. If no such instance can be found, the default will be used. To re-iterate, a value in a more specific key supercedes a value in a less specific key. The exceptions to this rule are stated below. -
-
- A.2.1.3 Exceptions to A.2.1.2 - To retain backwards compatibility, the following exceptions are made to A.2.1.2. -
- 2.1.3.1 'FailLoginsSilently' - - FailLoginsSilently - - Historically, the 'FailLoginsSilently' value was in HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters key and not in the NP key. Therefore, for backwards compatibility, the value in the Parameters key will supercede all instances of this value in other keys. In the absence of this value in the Parameters key, normal scope rules apply. -
-
- 2.1.3.2 'LogonScript' - - LogonScript - - If a 'LogonScript' is not specified in the specific domain key nor in the domains key, the value in the NP key will only be checked if the effective 'LogonOptions' specify a high security integrated login. If a logon script is specified in the specific domain key or the domains key, it will be used regardless of the high security setting. Please be aware of this when setting this value.
@@ -4935,8 +5035,7 @@ Default: <none> Regkey: [HKCU\SOFTWARE\OpenAFS\Client\Mappings] Type: REG_SZ - -Default: <none> + Default: <none> These values are used to store the AFS path in UNIX notation to which the drive letter is to be mapped. These values used to be stored in the afsdsbmt.ini file.
@@ -4973,6 +5072,105 @@ Default: local RPC
+
+ A.5 AFS Redirector Parameters + + afsredir.sys + + + afsredirlib.sys + + The AFS Redirector is implemented with three components: + %windir%\system32\drivers\AFSRedir.sys, %windir%\system32\drivers\AFSRedirLib.sys and + %windir%\system32\AFSRDFSProvider.dll. These components provide the interface between the + Windows Installable File System interface and the WNet application interface and the AFS + file system. The +
+ [HKLM\SYSTEM\CurrentControlSet\Services\AFSRedirector\Parameters] + +
+ Value: DebugFlags + RegKey: [HKLM\SYSTEM\CurrentControlSet\Services\AFSRedirector\Parameters] + Type: REG_DWORD + Default: 0 + Bit 0 (0x1): Trigger Debug Break on AFSRedir.sys start. Used for kernel + debugging. + Bit 1 (0x2): Output trace logging to Kernel Debugger. Used for kernel + debugging. + Bit 2 (0x4): Enable Force Crash Ioctl. Checked builds only. Used for force a + BSOD. + Bit 3 (0x8): Enable Bug Check on all exceptions. Normally exceptions are caught by + handlers. Used during testing. + Bit 4 (0x10): Reserved. + Bit 5 (0x20): Do not start the AFS Redirector if Windows did not perform a clean + shutdown. +
+
+ Value: TraceBufferSize + RegKey: [HKLM\SYSTEM\CurrentControlSet\Services\AFSRedirector\Parameters] + Type: REG_DWORD + Default: 0 {0 .. 10000} (KBs) + Specifies the size of the circular trace log buffer allocated within kernel memory. + 0 disables trace logging. +
+
+ Value: TraceLevel + RegKey: [HKLM\SYSTEM\CurrentControlSet\Services\AFSRedirector\Parameters] + Type: REG_DWORD + Default: 0 {0..4} + 0: No logging; 1: Error; 2: Warning; 3: Verbose; 4: Maximum Verbosity +
+
+ Value: TraceSubsystem + RegKey: [HKLM\SYSTEM\CurrentControlSet\Services\AFSRedirector\Parameters] + Type: REG_DWORD + Default: 0 + Bit 0 (0x1): I/O Subsystem + Bit 1 (0x2): File Control Blocks and Name Processing + Bit 2 (0x4): Lock Processing (requires Verbose or higher level) + Bit 3 (0x8): Extent Processing + Bit 4 (0x10): Worker Thread Processing + Bit 5 (0x20): Reference counting of directory entries + Bit 6 (0x40): Reference counting of objects + Bit 7 (0x80): Reference counting of volumes + Bit 8 (0x100): Reference counting of file control blocks + Bit 9 (0x200): Garbage Collection + Bit 10 (0x400): Pipe and share processing + Bit 11 (0x800): Directory notification interface + Bit 12 (0x1000): Network Provider support processing + Bit 13 (0x2000): Directory node count processing + Bit 14 (0x4000): PIOCTL processing + Bit 15 (0x8000): Authentication Group creation and assignment + Bit 16 (0x10000): Library load and unload, task queuing + Bit 17 (0x20000): Process creation and destruction + Bit 18 (0x40000): Extent Active counting + Bit 19 (0x80000): Redirector initialization +
+
+
+ [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider] + +
+ Value: Debug + RegKey: + [HKLM\SYSTEM\CurrentControlSet\Services\AFSRedirector\NetworkProvider] + Type: REG_DWORD + Default: 0 + Set to 1 to log all AFSRDFSProvider Network Provider requests to + C:\TEMP\AFSRDFSProvider.log. The C:\TEMP directory cannot be changed and must + exist. +
+
+ Value: Name + RegKey: + [HKLM\SYSTEM\CurrentControlSet\Services\AFSRedirector\NetworkProvider] + Type: REG_SZ + Default: "OpenAFS Network" + This value defines the name displayed in the Explorer Shell and to which network + drive mappings are made. +
+
+