<o:Author>Jeffrey Altman</o:Author>
<o:Keywords>OpenAFS 1.4.0</o:Keywords>
<o:LastAuthor>Jeffrey Altman</o:LastAuthor>
- <o:Revision>3</o:Revision>
- <o:TotalTime>39</o:TotalTime>
+ <o:Revision>4</o:Revision>
+ <o:TotalTime>44</o:TotalTime>
<o:LastPrinted>2005-09-26T23:55:00Z</o:LastPrinted>
<o:Created>2005-09-25T20:12:00Z</o:Created>
- <o:LastSaved>2005-09-27T00:33:00Z</o:LastSaved>
+ <o:LastSaved>2005-10-03T00:31:00Z</o:LastSaved>
<o:Pages>1</o:Pages>
- <o:Words>14488</o:Words>
- <o:Characters>82584</o:Characters>
+ <o:Words>14557</o:Words>
+ <o:Characters>82979</o:Characters>
<o:Company>Secure Endpoints Inc.</o:Company>
- <o:Lines>688</o:Lines>
- <o:Paragraphs>193</o:Paragraphs>
- <o:CharactersWithSpaces>96879</o:CharactersWithSpaces>
- <o:Version>11.6408</o:Version>
+ <o:Lines>691</o:Lines>
+ <o:Paragraphs>194</o:Paragraphs>
+ <o:CharactersWithSpaces>97342</o:CharactersWithSpaces>
+ <o:Version>11.6568</o:Version>
</o:DocumentProperties>
</xml><![endif]--><!--[if gte mso 9]><xml>
<w:WordDocument>
mso-pagination:widow-orphan;
font-size:10.0pt;
font-family:"Times New Roman";
+ mso-fareast-font-family:"Times New Roman";
mso-ansi-language:#0400;
mso-fareast-language:#0400;
mso-bidi-language:#0400;}
mso-bidi-language:#0400;}
</style>
<![endif]--><!--[if gte mso 9]><xml>
- <o:shapedefaults v:ext="edit" spidmax="3074"/>
+ <o:shapedefaults v:ext="edit" spidmax="4098"/>
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1"/>
authentication is managed by a much larger organization.<span
style='mso-spacerun:yes'> </span>AFS clients and servers take advantage of
Kerberos cross realm authentication to enable authenticated access by entities
-located outside the local realm.<span style='mso-spacerun:yes'> </span>Authorization
-is enforced by the use of directory level access control lists which can
-consist of individual or group identities.<span style='mso-spacerun:yes'>
-</span></p>
+located outside the local realm.<span style='mso-spacerun:yes'>
+</span>Authorization is enforced by the use of directory level access control
+lists which can consist of individual or group identities.<span
+style='mso-spacerun:yes'> </span></p>
<p class=MsoBodyText>The AFS volume is a tree of files and
sub-directories.<span style='mso-spacerun:yes'> </span>AFS volumes are created
replica, clients will read all of the data from a single replica.<span
style='mso-spacerun:yes'> </span>If that replica becomes unavailable, the
clients will failover to any replica that is reachable.<span
-style='mso-spacerun:yes'> </span>Users of the data are unaware of where the replicas
-are stored or which one is being accessed.<span style='mso-spacerun:yes'>
-</span>The contents of the replicas can be updated at any time by <i
-style='mso-bidi-font-style:normal'>releasing</i> the current contents of the
-source volume.</p>
+style='mso-spacerun:yes'> </span>Users of the data are unaware of where the
+replicas are stored or which one is being accessed.<span
+style='mso-spacerun:yes'> </span>The contents of the replicas can be updated
+at any time by <i style='mso-bidi-font-style:normal'>releasing</i> the current
+contents of the source volume.</p>
<p class=MsoBodyText>OpenAFS for Windows (OAFW) provides AFS client access
Microsoft Windows operating systems.<span style='mso-spacerun:yes'> </span>It
-strives to maintain transparency such that the user is unaware of the distinction
-between the use of AFS and Microsoft Windows file shares.<span
+strives to maintain transparency such that the user is unaware of the
+distinction between the use of AFS and Microsoft Windows file shares.<span
style='mso-spacerun:yes'> </span>OAFW can be part of a single sign-on
solution by allowing credentials for a Kerberos principal to be obtained at
logon and for that principal to be used to obtain AFS tokens for one or more
display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
-text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF _Toc115417111
-\h </span><span style='color:windowtext;text-decoration:none;text-underline:
-none'><span style='display:none;mso-hide:screen'><span style='mso-element:field-separator'></span></span></span><![endif]--><span
+text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
+_Toc115417111 \h </span><span style='color:windowtext;text-decoration:none;
+text-underline:none'><span style='display:none;mso-hide:screen'><span
+style='mso-element:field-separator'></span></span></span><![endif]--><span
style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
text-underline:none'>2<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310031000000</w:data>
Windows<span style='color:windowtext;display:none;mso-hide:screen;text-decoration:
none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
-text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
-_Toc115417114 \h </span><span style='color:windowtext;text-decoration:none;
-text-underline:none'><span style='display:none;mso-hide:screen'><span
-style='mso-element:field-separator'></span></span></span><![endif]--><span
+text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF _Toc115417114
+\h </span><span style='color:windowtext;text-decoration:none;text-underline:
+none'><span style='display:none;mso-hide:screen'><span style='mso-element:field-separator'></span></span></span><![endif]--><span
style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
text-underline:none'>14<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310034000000</w:data>
mso-no-proof:yes'><o:p></o:p></span></p>
<h1 style='margin-left:0pt;text-indent:0pt'><!--[if supportFields]><span
-style='mso-element:field-end'></span><![endif]--><a name="_Toc115416098"></a><a
-name="_Toc115417037"></a><a name="_Toc115417109"><span style='mso-bookmark:
-_Toc115417037'><span style='mso-bookmark:_Toc115416098'>1. Installer Options</span></span></a></h1>
+style='mso-element:field-end'></span><![endif]--><a name="_Toc115417109"></a><a
+name="_Toc115417037"></a><a name="_Toc115416098"><span style='mso-bookmark:
+_Toc115417037'><span style='mso-bookmark:_Toc115417109'>1. Installer Options</span></span></a></h1>
<p class=MsoNormal>It can be installed either as a new installation or an
upgrade from previous versions of OpenAFS for Windows or IBM AFS for
using WiX and can be customized for organizations via the use of MSI Transforms
(see <a href="#_MSI_Deployment_Guide">MSI Deployment Guide</a>)</p>
-<h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416099"></a><a
-name="_Toc115417038"></a><a name="_Toc115417110"><span style='mso-bookmark:
-_Toc115417038'><span style='mso-bookmark:_Toc115416099'>2. System Requirements</span></span></a></h1>
+<h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417110"></a><a
+name="_Toc115417038"></a><a name="_Toc115416099"><span style='mso-bookmark:
+_Toc115417038'><span style='mso-bookmark:_Toc115417110'>2. System Requirements</span></span></a></h1>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416100"></a><a
-name="_Toc115417039"><span style='mso-bookmark:_Toc115416100'>2.1 Supported
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417039"></a><a
+name="_Toc115416100"><span style='mso-bookmark:_Toc115417039'>2.1 Supported
Operating Systems</span></a></h2>
<p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
style='mso-spacerun:yes'> </span>The last version with support for Windows NT
4.0 is 1.2.10.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416102"></a><a
-name="_Toc115417040"><span style='mso-bookmark:_Toc115416102'>2.2 Disk Space</span></a></h2>
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417040"></a><a
+name="_Toc115416102"><span style='mso-bookmark:_Toc115417040'>2.2 Disk Space</span></a></h2>
<p class=MsoNormal>Up to 60mb required for the OpenAFS binaries plus 100MB for
the default AFSCache file.<span style='mso-spacerun:yes'> </span>(The size of
the AFSCache file may be adjusted via the Registry after installation.)</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416103"></a><a
-name="_Toc115417041"><span style='mso-bookmark:_Toc115416103'>2.3 Additional
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417041"></a><a
+name="_Toc115416103"><span style='mso-bookmark:_Toc115417041'>2.3 Additional
Software</span></a></h2>
<p class=MsoNormal><a href="http://web.mit.edu/kerberos/dist/index.html">MIT
Kerberos for Windows</a> 2.6.x if Kerberos 5 authentication support is desired.</p>
-<h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416104"></a><a
-name="_Toc115417042"></a><a name="_Toc115417111"><span style='mso-bookmark:
-_Toc115417042'><span style='mso-bookmark:_Toc115416104'>3. Operational Notes</span></span></a></h1>
+<h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417111"></a><a
+name="_Toc115417042"></a><a name="_Toc115416104"><span style='mso-bookmark:
+_Toc115417042'><span style='mso-bookmark:_Toc115417111'>3. Operational Notes</span></span></a></h1>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416105"></a><a
-name="_Toc115417043"><span style='mso-bookmark:_Toc115416105'>3.1. Requirements
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417043"></a><a
+name="_Toc115416105"><span style='mso-bookmark:_Toc115417043'>3.1. Requirements
for Kerberos 5 Authentication</span></a></h2>
<p class=MsoNormal>The Kerberos 4 infrastructure on which the OpenAFS 1.2
style='mso-spacerun:yes'> </span>XE "krb524" <![endif]--><!--[if supportFields]><span
style='mso-element:field-end'></span><![endif]--></p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416108"></a><a
-name="_Toc115417044"><span style='mso-bookmark:_Toc115416108'>3.2. Use of the
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417044"></a><a
+name="_Toc115416108"><span style='mso-bookmark:_Toc115417044'>3.2. Use of the
Microsoft Loopback Adapter</span></a></h2>
<p class=MsoNormal>By itself the OpenAFS Client Service does not provide robust
style='mso-spacerun:yes'> </span>If the MLA is bound to "File and Printer
Sharing ..." there will be a service type collision between the name
"AFS" and the name of the machine on the MLA's IP Address that will
-result in the OpenAFS client service becoming inaccessible and the "NET VIEW
-\\AFS" command will return a "System Error 52" message.<span
-style='mso-spacerun:yes'> </span>To correct the problem:</p>
+result in the OpenAFS client service becoming inaccessible and the "NET
+VIEW \\AFS" command will return a "System Error 52"
+message.<span style='mso-spacerun:yes'> </span>To correct the problem:</p>
<p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
l3 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
<p class=MsoNormal>When the MLA is not installed the unique NETBIOS name
published by OpenAFS SMB server is "<i>MACHINE</i>-AFS".<span
style='mso-spacerun:yes'> </span>One of the benefits of using the MLA is that
-the NETBIOS name does not have to be published on any adapter other than the MLA.<span
-style='mso-spacerun:yes'> </span>Therefore the chosen name is no longer
-required to be unique.<span style='mso-spacerun:yes'> </span>Instead the
-NETBIOS name associated with the AFS Client Service is simply "AFS"
-and portable UNC paths of the form \\AFS\cellname\path can now be used on all
-machines.<!--[if supportFields]><span style='mso-element:field-begin'></span>
+the NETBIOS name does not have to be published on any adapter other than the
+MLA.<span style='mso-spacerun:yes'> </span>Therefore the chosen name is no
+longer required to be unique.<span style='mso-spacerun:yes'> </span>Instead
+the NETBIOS name associated with the AFS Client Service is simply
+"AFS" and portable UNC paths of the form \\AFS\cellname\path can now
+be used on all machines.<!--[if supportFields]><span style='mso-element:field-begin'></span>
XE "loopback" <![endif]--><!--[if supportFields]><span
style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
-style='mso-element:field-begin'></span><span style='mso-spacerun:yes'> </span>XE
-"UNC paths" <![endif]--><!--[if supportFields]><span
+style='mso-element:field-begin'></span><span
+style='mso-spacerun:yes'> </span>XE "UNC paths" <![endif]--><!--[if supportFields]><span
style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
style='mso-element:field-begin'></span><span
style='mso-spacerun:yes'> </span>XE "NETBIOS" <![endif]--><!--[if supportFields]><span
style='mso-element:field-end'></span><![endif]--></p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416109"></a><a
-name="_Toc115417045"><span style='mso-bookmark:_Toc115416109'>3.3. Using
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417045"></a><a
+name="_Toc115416109"><span style='mso-bookmark:_Toc115417045'>3.3. Using
Freelance (Dynamic Root) Mode to Improve Mobility</span></a></h2>
<p class=MsoNormal>Traditionally, when the OpenAFS Client Service starts it
<p class=MsoNormal>To allow the OpenAFS Client Service to operate in these
environments, a fake "root.afs" volume is dynamically constructed
from mount points and symlinks stored in the local registry.<span
-style='mso-spacerun:yes'> </span>This method of operation is referred to as Freelance
-mode.</p>
+style='mso-spacerun:yes'> </span>This method of operation is referred to as
+Freelance mode.</p>
<p class=MsoNormal>The content of the fake root.afs volume is dynamically
modified as cells are accessed.<span style='mso-spacerun:yes'> </span>When the
<p class=PreformattedText style='margin-left:35.45pt'>>fs rmmount
\\AFS\athena.mit.edu</p>
-<p class=PreformattedText style='margin-left:35.45pt'>>fs rmmount \\AFS\.athena.mit.edu</p>
+<p class=PreformattedText style='margin-left:35.45pt'>>fs rmmount
+\\AFS\.athena.mit.edu</p>
<p class=MsoNormal>Symlinks may also be created within the Freelance root.afs
volume.</p>
style='mso-element:field-end'></span><![endif]--><span
style='mso-spacerun:yes'> </span></p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416110"></a><a
-name="_Toc115417046"><span style='mso-bookmark:_Toc115416110'>3.4. Locating AFS
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417046"></a><a
+name="_Toc115416110"><span style='mso-bookmark:_Toc115417046'>3.4. Locating AFS
Volume Database Servers</span></a> </h2>
<p class=MsoNormal>The OpenAFS for Windows client will use DNS AFSDB records to
style='mso-spacerun:yes'> </span>XE "afsdb" <![endif]--><!--[if supportFields]><span
style='mso-element:field-end'></span><![endif]--></p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416111"></a><a
-name="_Toc115417047"><span style='mso-bookmark:_Toc115416111'>3.5. Obtaining
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417047"></a><a
+name="_Toc115416111"><span style='mso-bookmark:_Toc115417047'>3.5. Obtaining
AFS Tokens as a Part of Windows Logon</span></a></h2>
<p class=MsoNormal>OpenAFS for Windows installs a WinLogon Network Provider to
into the default ccache within the user logon session.</p>
<p class=MsoNormal>Integrated Logon does not have the ability to cache the
-user's username and password for the purpose of obtaining tokens if the
-Kerberos KDC is inaccessible at logon time.</p>
+user's username and password for the purpose of obtaining tokens if the Kerberos
+KDC is inaccessible at logon time.</p>
<p class=MsoNormal>Integrated Login supports the ability to obtain tokens for
multiple cells.<span style='mso-spacerun:yes'> </span>For further information
style='mso-element:field-begin'></span> XE "integrated login" <![endif]--><!--[if supportFields]><span
style='mso-element:field-end'></span><![endif]--></p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416112"></a><a
-name="_Toc115417048"><span style='mso-bookmark:_Toc115416112'>3.6. AFS System
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417048"></a><a
+name="_Toc115416112"><span style='mso-bookmark:_Toc115417048'>3.6. AFS System
Tray Command Line Options</span></a></h2>
<p class=MsoNormal>The AFS System Tray tool (afscreds.exe) supports several
<p class=MsoNormal>autoinit will result in automated attempts to acquire AFS
tokens when afscreds.exe is started.<span style='mso-spacerun:yes'>
-</span>afscreds.exe will attempt to utilize tickets stored in the MSLSA
-credentials cache; any existing CCAPI credentials cache; and finally display an
-Obtain Tokens dialog to the user.<span style='mso-spacerun:yes'> </span>When
-used in combination with IP address change detection, afscreds.exe will attempt
-to acquire AFS tokens whenever the IP address list changes and the Kerberos KDC
-is accessible.</p>
+</span>afscreds.exe will attempt to utilize tickets stored in the MSLSA credentials
+cache; any existing CCAPI credentials cache; and finally display an Obtain
+Tokens dialog to the user.<span style='mso-spacerun:yes'> </span>When used in
+combination with IP address change detection, afscreds.exe will attempt to
+acquire AFS tokens whenever the IP address list changes and the Kerberos KDC is
+accessible.</p>
<p class=MsoNormal>The renew drive maps option is used to ensure that the user
drive maps constructed via the OpenAFS tools (not NET USE) are re-constructed
style='mso-element:field-begin'></span> XE "afscreds.exe" <![endif]--><!--[if supportFields]><span
style='mso-element:field-end'></span><![endif]--></p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416113"></a><a
-name="_Toc115417049"><span style='mso-bookmark:_Toc115416113'>3.7. The AFS
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417049"></a><a
+name="_Toc115416113"><span style='mso-bookmark:_Toc115417049'>3.7. The AFS
Client Admins Authorization Group</span></a></h2>
<p class=MsoNormal>The OpenAFS for Windows 1.4 client supports a local Windows
mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>trace</p>
-<p class=MsoNormal>The creation or removal of mount points and symlinks in the Freelance
-root.afs volume are also restricted to members of the AFS Client Admins
-group.</p>
+<p class=MsoNormal>The creation or removal of mount points and symlinks in the
+Freelance root.afs volume are also restricted to members of the AFS Client
+Admins group.</p>
<p class=MsoNormal>The initial membership of the "AFS Client Admins"
group when created by the installer is equivalent to the local
style='mso-spacerun:yes'> </span>XE "fs.exe" <![endif]--><!--[if supportFields]><span
style='mso-element:field-end'></span><![endif]--></p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416114"></a><a
-name="_Toc115417050"><span style='mso-bookmark:_Toc115416114'>3.8. OpenAFS
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417050"></a><a
+name="_Toc115416114"><span style='mso-bookmark:_Toc115417050'>3.8. OpenAFS
support for UNC paths</span></a> </h2>
<p class=MsoNormal>The OpenAFS 1.4 client supports UNC paths everywhere.<span
style='mso-spacerun:yes'> </span>XE "4nt.exe" <![endif]--><!--[if supportFields]><span
style='mso-element:field-end'></span><![endif]--></p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416115"></a><a
-name="_Toc115417051"><span style='mso-bookmark:_Toc115416115'>3.9. OpenAFS
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417051"></a><a
+name="_Toc115416115"><span style='mso-bookmark:_Toc115417051'>3.9. OpenAFS
includes aklog.exe</span></a></h2>
<p class=MsoNormal>The OpenAFS 1.4 Client ships with its own version of
<p class=PreformattedText>Usage: aklog [-d] [[-cell | -c] cell [-k krb_realm]]</p>
-<p class=PreformattedText><span style='mso-spacerun:yes'>
-</span>[[-p | -path] pathname]</p>
+<p class=PreformattedText><span style='mso-spacerun:yes'> </span>[[-p
+| -path] pathname]</p>
<p class=PreformattedText><span style='mso-spacerun:yes'>
</span>[-noprdb] [-force]</p>
<p class=PreformattedText><o:p> </o:p></p>
-<p class=PreformattedText><span style='mso-spacerun:yes'> </span><span
-style='mso-spacerun:yes'> </span>-d = output debugging information.</p>
+<p class=PreformattedText><span style='mso-spacerun:yes'> </span>-d = output
+debugging information.</p>
<p class=PreformattedText><span style='mso-spacerun:yes'> </span>cell = zero
or more cells for which tokens will be obtained</p>
<p class=PreformattedText><span style='mso-spacerun:yes'> </span>-noprdb =
don't try to determine AFS ID.</p>
-<p class=PreformattedText><span style='mso-spacerun:yes'> </span><span
-style='mso-spacerun:yes'> </span>-5 or -4 = use Kerberos V (default) or
-Kerberos IV tickets</p>
+<p class=PreformattedText><span style='mso-spacerun:yes'> </span>-5 or -4 =
+use Kerberos V (default) or Kerberos IV tickets</p>
<p class=PreformattedText><span style='mso-spacerun:yes'> </span>-m = use
krb524d to convert Kerberos V tickets to Kerberos IV<!--[if supportFields]><span
style='mso-element:field-begin'></span> XE "aklog.exe" <![endif]--><!--[if supportFields]><span
style='mso-element:field-end'></span><![endif]--></p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416116"></a><a
-name="_Toc115417052"><span style='mso-bookmark:_Toc115416116'>3.10. OpenAFS
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417052"></a><a
+name="_Toc115416116"><span style='mso-bookmark:_Toc115417052'>3.10. OpenAFS
Servers on Windows are Unsupported</span></a></h2>
<p class=MsoNormal>The AFS Server functionality provided with OpenAFS 1.4 might
style='mso-element:field-begin'></span> XE "AFS Servers" <![endif]--><!--[if supportFields]><span
style='mso-element:field-end'></span><![endif]--></p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416117"></a><a
-name="_Toc115417053"><span style='mso-bookmark:_Toc115416117'>3.11. OpenAFS
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417053"></a><a
+name="_Toc115416117"><span style='mso-bookmark:_Toc115417053'>3.11. OpenAFS
Debugging Symbol files</span></a></h2>
<p class=MsoNormal>The OpenAFS for Windows installers now include Debugging
style='mso-element:field-begin'></span> XE "Symbol files" <![endif]--><!--[if supportFields]><span
style='mso-element:field-end'></span><![endif]--></p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416118"></a><a
-name="_Toc115417054"><span style='mso-bookmark:_Toc115416118'>3.12. Maximum
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417054"></a><a
+name="_Toc115416118"><span style='mso-bookmark:_Toc115417054'>3.12. Maximum
File Size is 2GB</span></a></h2>
<p class=MsoNormal>OpenAFS for Windows does not support files larger than
2GB.<span style='mso-spacerun:yes'> </span>The version of the SMB/CIFS
protocol implemented imposes this limitation.<span style='mso-spacerun:yes'>
-</span>Upgrading the SMB/CIFS implementation or replacing it with an
-Installable File System will allow larger files to be supported.<!--[if supportFields]><span
+</span>Upgrading the SMB/CIFS implementation or replacing it with an Installable
+File System will allow larger files to be supported.<!--[if supportFields]><span
style='mso-element:field-begin'></span> XE "large file support" <![endif]--><!--[if supportFields]><span
style='mso-element:field-end'></span><![endif]--></p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416119"></a><a
-name="_Toc115417055"><span style='mso-bookmark:_Toc115416119'>3.13. Encrypted
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417055"></a><a
+name="_Toc115416119"><span style='mso-bookmark:_Toc115417055'>3.13. Encrypted
AFS File Access</span></a></h2>
<p class=MsoNormal>The OpenAFS for Windows installer by default activates a
-weak form of encrypted data transfer between the AFS client and the AFS
-servers.<span style='mso-spacerun:yes'> </span>This is often referred to as
+weak form of encrypted data transfer between the AFS client and the AFS servers.<span
+style='mso-spacerun:yes'> </span>This is often referred to as
"fcrypt" mode.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416120"></a><a
-name="_Toc115417056"><span style='mso-bookmark:_Toc115416120'>3.14. Authenticated
-Access to the OpenAFS Client Service</span></a></h2>
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417056"></a><a
+name="_Toc115416120"><span style='mso-bookmark:_Toc115417056'>3.14.
+Authenticated Access to the OpenAFS Client Service</span></a></h2>
<p class=MsoNormal>OpenAFS 1.4 supports authenticated SMB connections using
either NTLM or GSS SPNEGO (NTLM).<span style='mso-spacerun:yes'> </span>In
password.<span style='mso-spacerun:yes'> </span>Instead, Windows will
internally recognize the request as coming from a local logon session.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416121"></a><a
-name="_Toc115417057"><span style='mso-bookmark:_Toc115416121'>3.15. No More INI
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417057"></a><a
+name="_Toc115416121"><span style='mso-bookmark:_Toc115417057'>3.15. No More INI
Files</span></a></h2>
<p class=MsoNormal>Previous AFS clients for Windows stored configuration data
Windows registry.<span style='mso-spacerun:yes'> </span>OpenAFS 1.4 will not
process the contents of the afsddbmt.ini.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416122"></a><a
-name="_Toc115417058"><span style='mso-bookmark:_Toc115416122'>3.16. Microsoft
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417058"></a><a
+name="_Toc115416122"><span style='mso-bookmark:_Toc115417058'>3.16. Microsoft
Windows Internet Connection Firewall</span></a></h2>
<p class=MsoNormal>The OpenAFS 1.4 Client is compatible with the Internet
appropriate <i>Back Connection</i> registry entries are added to allow SMB
authentication to be performed across the Microsoft Loopback Adapter.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416123"></a><a
-name="_Toc115417059"><span style='mso-bookmark:_Toc115416123'>3.17. Browsing
-AFS from the Explorer Shell and Office</span></a></h2>
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417059"></a><a
+name="_Toc115416123"><span style='mso-bookmark:_Toc115417059'>3.17. Browsing AFS
+from the Explorer Shell and Office</span></a></h2>
<p class=MsoNormal>The OpenAFS 1.4 Client Service implements the CIFS Remote
Admin Protocol which allows Explorer to browse server and share information.
<p class=MsoBodyText>Many applications on Windows (e.g. Microsoft Office)
require the use of byte range locks applied to a file either to protect against
simultaneous file access or as a signaling mechanism.<span
-style='mso-spacerun:yes'> </span>OpenAFS does not currently support byte range
-locks.<span style='mso-spacerun:yes'> </span>It is strongly recommended that
-files not be edited within AFS if they might be accessed by multiple users or
-multiple processes on a single machine.</p>
+style='mso-spacerun:yes'> </span>OpenAFS does not currently support byte
+range locks.<span style='mso-spacerun:yes'> </span>It is strongly recommended
+that files not be edited within AFS if they might be accessed by multiple users
+or multiple processes on a single machine.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416125"></a><a
-name="_Toc115417061"><span style='mso-bookmark:_Toc115416125'>3.19. Automatic
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417061"></a><a
+name="_Toc115416125"><span style='mso-bookmark:_Toc115417061'>3.19. Automatic
Discarding of AFS Tokens at Logoff</span></a></h2>
<p class=MsoNormal>OpenAFS 1.4 will automatically forget a user's tokens upon
registry value can be used. (see <a href="#_Appendix_A:_Registry_Values">Appendix
A</a>.)</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416126"></a><a
-name="_Toc115417062"><span style='mso-bookmark:_Toc115416126'>3.20. Terminal
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417062"></a><a
+name="_Toc115416126"><span style='mso-bookmark:_Toc115417062'>3.20. Terminal
Server installations</span></a></h2>
<p class=MsoNormal>When installing the NSIS (.exe) installer under Terminal
AFS not running properly.<span style='mso-spacerun:yes'> </span>The AFS Server
should not be installed on a machine with Terminal Server installed.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416127"></a><a
-name="_Toc115417063"><span style='mso-bookmark:_Toc115416127'>3.21. Hidden Dot
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417063"></a><a
+name="_Toc115416127"><span style='mso-bookmark:_Toc115417063'>3.21. Hidden Dot
Files</span></a></h2>
<p class=MsoNormal>AFS is a UNIX native file system.<span
automatically given the Hidden attribute so they will not normally be
displayed.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416128"></a><a
-name="_Toc115417064"><span style='mso-bookmark:_Toc115416128'>3.22. Status
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417064"></a><a
+name="_Toc115416128"><span style='mso-bookmark:_Toc115417064'>3.22. Status
Cache Limits</span></a></h2>
<p class=MsoNormal>The Status Cache (AFS Configuration Control Panel: Advanced
allocated, entries will begin to be reused according to a least recently used
(LRU) algorithm.<span style='mso-spacerun:yes'> </span>If the number of files
or directories being accessed repeatedly by your applications is greater then
-the maximum number of entries, your host will begin to experience thrashing of the
-Status Cache and all requests will result in network operations.</p>
+the maximum number of entries, your host will begin to experience thrashing of
+the Status Cache and all requests will result in network operations.</p>
<p class=MsoNormal>If you are experiencing poor performance try increasing the
maximum number of Status Cache entries.<span style='mso-spacerun:yes'>
</span>Each entry requires approximately 1.2K.<span style='mso-spacerun:yes'>
</span>In OpenAFS 1.4, the default number of Status Cache entries is 10,000.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416129"></a><a
-name="_Toc115417065"><span style='mso-bookmark:_Toc115416129'>3.23. NETBIOS
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417065"></a><a
+name="_Toc115416129"><span style='mso-bookmark:_Toc115417065'>3.23. NETBIOS
over TCP/IP must be enabled</span></a></h2>
<p class=MsoNormal>"Netbios over TCP/IP" must be active on the
machine in order for communication with the AFS Client Service to succeed.<span
-style='mso-spacerun:yes'> </span>If "Netbios over TCP/IP" is
-disabled on the machine, then communication with the AFS Client Service will be
+style='mso-spacerun:yes'> </span>If "Netbios over TCP/IP" is disabled
+on the machine, then communication with the AFS Client Service will be
impossible.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416130"></a><a
-name="_Toc115417066"><span style='mso-bookmark:_Toc115416130'>3.24. OpenAFS
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417066"></a><a
+name="_Toc115416130"><span style='mso-bookmark:_Toc115417066'>3.24. OpenAFS
binaries are digitally signed</span></a></h2>
<p class=MsoNormal>The OpenAFS Client Service and related binaries distributed
registry value which can be used to disable the signature check.<span
style='mso-spacerun:yes'> </span>The file version check cannot be disabled.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416131"></a><a
-name="_Toc115417067"><span style='mso-bookmark:_Toc115416131'>3.25. Maximum
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417067"></a><a
+name="_Toc115416131"><span style='mso-bookmark:_Toc115417067'>3.25. Maximum
Size of the AFSCache File</span></a></h2>
<p class=MsoNormal>The maximum cache size is approximately 1.3GB.<span
signature verification code, any attempt to specify a cache size greater then
700MB will result in the automatic disabling of the signature check.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416132"></a><a
-name="_Toc115417068"><span style='mso-bookmark:_Toc115416132'>3.26. Filename
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417068"></a><a
+name="_Toc115416132"><span style='mso-bookmark:_Toc115417068'>3.26. Filename
Character Sets</span></a></h2>
<p class=MsoNormal>OpenAFS for Windows implements an SMB server which is used
</span>08/06<span style='mso-spacerun:yes'> </span>206<span
style='mso-spacerun:yes'> </span>86<span style='mso-spacerun:yes'> </span>a
ring</p>
- <p class=PreformattedText><span style='mso-spacerun:yes'> </span><span
- style='mso-spacerun:yes'> </span>[ç]<span style='mso-spacerun:yes'>
- </span>135<span style='mso-spacerun:yes'> </span>08/07<span
- style='mso-spacerun:yes'> </span>207<span style='mso-spacerun:yes'>
- </span>87<span style='mso-spacerun:yes'> </span>c cedilla</p>
+ <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ç]<span
+ style='mso-spacerun:yes'> </span>135<span style='mso-spacerun:yes'>
+ </span>08/07<span style='mso-spacerun:yes'> </span>207<span
+ style='mso-spacerun:yes'> </span>87<span style='mso-spacerun:yes'> </span>c
+ cedilla</p>
<p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ê]<span
style='mso-spacerun:yes'> </span>136<span style='mso-spacerun:yes'>
</span>08/08<span style='mso-spacerun:yes'> </span>210<span
style='mso-spacerun:yes'> </span>92<span style='mso-spacerun:yes'>
</span>AE diphthong</p>
<p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ô]<span
- style='mso-spacerun:yes'> </span>147 <span
- style='mso-spacerun:yes'> </span>09/03<span style='mso-spacerun:yes'>
- </span>223<span style='mso-spacerun:yes'> </span>93<span
- style='mso-spacerun:yes'> </span>o circumflex</p>
+ style='mso-spacerun:yes'> </span>147<span style='mso-spacerun:yes'>
+ </span>09/03<span style='mso-spacerun:yes'> </span>223<span
+ style='mso-spacerun:yes'> </span>93<span style='mso-spacerun:yes'> </span>o
+ circumflex</p>
<p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ö]<span
style='mso-spacerun:yes'> </span>148<span style='mso-spacerun:yes'>
</span>09/04<span style='mso-spacerun:yes'> </span>224<span
OpenAFS for Windows from being able to access filenames containing the above
characters which were created without this setting.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416133"></a><a
-name="_Toc115417069"><span style='mso-bookmark:_Toc115416133'>3.27. Known
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417069"></a><a
+name="_Toc115416133"><span style='mso-bookmark:_Toc115417069'>3.27. Known
Character Set Issues with Roaming Profiles</span></a></h2>
<p class=MsoNormal>There is a known issue with storing Windows Roaming Profiles
-when the profile contains either directories or files with names which cannot
-be represented in the local OEM character set.<span style='mso-spacerun:yes'>
+when the profile contains either directories or files with names which cannot be
+represented in the local OEM character set.<span style='mso-spacerun:yes'>
</span>In this case, attempts to write the profile back to AFS will fail.<span
style='mso-spacerun:yes'> </span>OpenAFS for Windows does not currently
support UNICODE.<span style='mso-spacerun:yes'> </span>To avoid this problem
some sites run logoff scripts (assigned by group policy) which rename all files
to use only the supported characters for the locale.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416134"></a><a
-name="_Toc115417070"><span style='mso-bookmark:_Toc115416134'>3.28. The
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417070"></a><a
+name="_Toc115416134"><span style='mso-bookmark:_Toc115417070'>3.28. The
AFSCache File</span></a></h2>
<p class=MsoNormal>The AFS Cache file is stored by default at %TEMP%\AFSCache
style='mso-spacerun:yes'> </span>Significant performance gains can be
achieved by defragmenting the AFSCache file with Sysinternal's Contig utility.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416135"></a><a
-name="_Toc115417071"><span style='mso-bookmark:_Toc115416135'>3.29. Restricting
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417071"></a><a
+name="_Toc115416135"><span style='mso-bookmark:_Toc115417071'>3.29. Restricting
OpenAFS Client Service Start and Stop</span></a></h2>
<p class=MsoNormal>A new command line tool, afsdacl.exe, can be used to
<p class=PreformattedText><span style='mso-spacerun:yes'>
</span>-show<span style='mso-spacerun:yes'> </span>: Show current DACL (SDSF)</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416136"></a><a
-name="_Toc115417072"><span style='mso-bookmark:_Toc115416136'>3.30. The @sys
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417072"></a><a
+name="_Toc115416136"><span style='mso-bookmark:_Toc115417072'>3.30. The @sys
Name List</span></a></h2>
<p class=MsoNormal>The default @sys name list in OpenAFS 1.4 is set to
"ia64_win64" and "amd64_win64" for amd 64-bit processors
when those platforms are supported.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416137"></a><a
-name="_Toc115417073"><span style='mso-bookmark:_Toc115416137'>3.31. Symlinks to
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417073"></a><a
+name="_Toc115416137"><span style='mso-bookmark:_Toc115417073'>3.31. Symlinks to
AFS UNC paths</span></a></h2>
<p class=MsoNormal>In OpenAFS 1.4, symlinks to AFS UNC paths, \\AFS[\all]\...,
</span>However, please use /afs/... as the Windows UNC form will not work on
UNIX.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416138"></a><a
-name="_Toc115417074"><span style='mso-bookmark:_Toc115416138'>3.32. Cache
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417074"></a><a
+name="_Toc115416138"><span style='mso-bookmark:_Toc115417074'>3.32. Cache
Manager Debugging Now Supported</span></a></h2>
<p class=MsoNormal>OpenAFS for Windows 1.4 implements the Cache Manager
<p class=PreformattedText>Where: -long<span style='mso-spacerun:yes'>
</span>print all info</p>
-<p class=PreformattedText><span style='mso-spacerun:yes'> </span>-addrs<span
-style='mso-spacerun:yes'> </span>print only host interfaces</p>
+<p class=PreformattedText><span style='mso-spacerun:yes'>
+</span>-addrs<span style='mso-spacerun:yes'> </span>print only host interfaces</p>
<p class=PreformattedText><span style='mso-spacerun:yes'>
</span>-cache<span style='mso-spacerun:yes'> </span>print only cache
configuration</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416139"></a><a
-name="_Toc115417075"><span style='mso-bookmark:_Toc115416139'>3.33. Windows
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417075"></a><a
+name="_Toc115416139"><span style='mso-bookmark:_Toc115417075'>3.33. Windows
Logon Caching vs. Kerberos Logons</span></a></h2>
<p class=MsoNormal>If you are a site which utilizes MIT/Heimdal Kerberos
-principals to logon to Windows via a cross-realm relationship with a multi-domain
-Windows forest, you must enable Windows logon caching unless the workstation is
-Windows Vista Beta 1 or later.</p>
+principals to logon to Windows via a cross-realm relationship with a
+multi-domain Windows forest, you must enable Windows logon caching unless the
+workstation is Windows Vista Beta 1 or later.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416140"></a><a
-name="_Toc115417076"><span style='mso-bookmark:_Toc115416140'>3.34. Initial
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417076"></a><a
+name="_Toc115416140"><span style='mso-bookmark:_Toc115417076'>3.34. Initial
Server Preferences</span></a></h2>
<p class=MsoNormal>VLDB and File Server Preferences can now be provided initial
href="#_Appendix_A:_Registry_Values">Appendix A</a> for details on the "<a
href="#_Regkey:_[HKLMSOFTWAREOpenAFSClie_2">Server Preferences</a>" keys.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416141"></a><a
-name="_Toc115417077"><span style='mso-bookmark:_Toc115416141'>3.35. File
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417077"></a><a
+name="_Toc115416141"><span style='mso-bookmark:_Toc115417077'>3.35. File
Timestamps</span></a></h2>
<p class=MsoNormal>OpenAFS 1.4 reports timestamps on files stored in AFS in UTC
all year round.<span style='mso-spacerun:yes'> </span>In locales with daylight
savings time, previous versions of AFS for Windows reported the time when DST
-is active as UTC+1.<span style='mso-spacerun:yes'> </span>This was done to
+is active as UTC+1. <span style='mso-spacerun:yes'> </span>This was done to
preserve the relative local time for the user.<span style='mso-spacerun:yes'>
</span>A file stored at 11:00am EST in January would be reported as having been
stored at 11:00am EDT in June.<span style='mso-spacerun:yes'>
</span>During DST, these two times will no longer agree even though they are in
fact representing the same moment in time.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416142"></a><a
-name="_Toc115417078"><span style='mso-bookmark:_Toc115416142'>3.36. Windows RPC
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417078"></a><a
+name="_Toc115416142"><span style='mso-bookmark:_Toc115417078'>3.36. Windows RPC
client support must be installed</span></a> </h2>
<p class=MsoNormal>If the installer refuses to install and complains about an
<p class=PreformattedText><span style='mso-spacerun:yes'> </span>HKLM
"SOFTWARE\Microsoft\RPC\ClientProtocols" "ncacn_http"</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416143"></a><a
-name="_Toc115417079"><span style='mso-bookmark:_Toc115416143'>3.37. Generating
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417079"></a><a
+name="_Toc115416143"><span style='mso-bookmark:_Toc115417079'>3.37. Generating
Minidumps of the OpenAFS Client Service</span></a></h2>
<p class=MsoNormal>OpenAFS 1.4 adds a new command, "fs
can be very helpful when debugging the AFS Client Service when it is
unresponsive to SMB/CIFS requests.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416144"></a><a
-name="_Toc115417080"><span style='mso-bookmark:_Toc115416144'>3.38. AFS Client
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417080"></a><a
+name="_Toc115416144"><span style='mso-bookmark:_Toc115417080'>3.38. AFS Client
Universally Unique Identifiers</span></a></h2>
<p class=MsoNormal>The OpenAFS for Windows 1.4 client implements Universally
client installed, the AFSCache files must be deleted as part of the cloning
process.</p>
-<h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416145"></a><a
-name="_Toc115417081"></a><a name="_Toc115417112"><span style='mso-bookmark:
-_Toc115417081'><span style='mso-bookmark:_Toc115416145'>4. How to Debug
-Problems with OpenAFS for Windows:</span></span></a></h1>
+<h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417112"></a><a
+name="_Toc115417081"></a><a name="_Toc115416145"><span style='mso-bookmark:
+_Toc115417081'><span style='mso-bookmark:_Toc115417112'>4. How to Debug Problems
+with OpenAFS for Windows:</span></span></a></h1>
<p class=MsoNormal>OpenAFS for Windows provides a wide range of tools to assist
you in debugging problems.<span style='mso-spacerun:yes'> </span>The
techniques available to you are varied because of the wide range of issues that
have been discovered over the years.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416146"></a><a
-name="_Toc115417082"><span style='mso-bookmark:_Toc115416146'>4.1. pioctl
-debugging (</span></a><a href="#_Value___:_IoctlDebug"><span style='mso-bookmark:
-_Toc115417082'><span style='mso-bookmark:_Toc115416146'>IoctlDebug</span></span><span
-style='mso-bookmark:_Toc115417082'><span style='mso-bookmark:_Toc115416146'></span></span></a><span
-style='mso-bookmark:_Toc115417082'><span style='mso-bookmark:_Toc115416146'>
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417082"></a><a
+name="_Toc115416146"><span style='mso-bookmark:_Toc115417082'>4.1. pioctl debugging
+(</span></a><a href="#_Value___:_IoctlDebug"><span style='mso-bookmark:_Toc115416146'><span
+style='mso-bookmark:_Toc115417082'>IoctlDebug</span></span><span
+style='mso-bookmark:_Toc115416146'><span style='mso-bookmark:_Toc115417082'></span></span></a><span
+style='mso-bookmark:_Toc115416146'><span style='mso-bookmark:_Toc115417082'>
registry key)</span></span></h2>
<p class=MsoNormal>pioctl (path-based ioctl) calls are used by various tools to
KnowledgeBase can be used as a reference to help you determine the
configuration probem with your system.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416147"></a><a
-name="_Toc115417083"><span style='mso-bookmark:_Toc115416147'>4.2. afsd_service
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417083"></a><a
+name="_Toc115416147"><span style='mso-bookmark:_Toc115417083'>4.2. afsd_service
initialization log (%WinDir%\TEMP\afsd_init.log)</span></a></h2>
<p class=MsoNormal>Every time the AFS Client Service starts it appends data
maximum size of the %WINDIR%\TEMP\afsd_init.log file.<span
style='mso-spacerun:yes'> </span>If the file is larger than this value when
OpenAFS Client Service starts, the file will be reset to 0 bytes.<span
-style='mso-spacerun:yes'> </span>If value is set to 0, the file will be
-allowed to grow indefinitely.</p>
+style='mso-spacerun:yes'> </span>If value is set to 0, the file will be allowed
+to grow indefinitely.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416148"></a><a
-name="_Toc115417084"><span style='mso-bookmark:_Toc115416148'>4.3. afsd_service
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417084"></a><a
+name="_Toc115416148"><span style='mso-bookmark:_Toc115417084'>4.3. afsd_service
debug logs (fs trace {-on, -off, -dump} ->%WinDir%\TEMP\afsd.log)</span></a></h2>
<p class=MsoNormal>When attempting to debug the behavior of the SMB/CIFS Server
any one time is 5000.<span style='mso-spacerun:yes'> </span>This can be
adjusted with the <a href="#_Value_:_TraceBufferSize">registry value</a>:</p>
-<p class=PreformattedText><span style='mso-spacerun:yes'> </span>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
+<p class=PreformattedText><span style='mso-spacerun:yes'> </span><span
+style='mso-spacerun:yes'> </span>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
<p class=PreformattedText><span style='mso-spacerun:yes'>
</span>REG_DWORD<span style='mso-spacerun:yes'> </span>TraceBufferSize </p>
to clear to the log and "fs trace -dump" to output the contents of
the log to the file.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416149"></a><a
-name="_Toc115417085"><span style='mso-bookmark:_Toc115416149'>4.4. Using
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417085"></a><a
+name="_Toc115416149"><span style='mso-bookmark:_Toc115417085'>4.4. Using
SysInternals DbgView and FileMon Tools</span></a></h2>
<p class=MsoNormal>An alternatve option to the use of "fs trace
style='mso-spacerun:yes'> </span>The captured data can be stored to files for
inclusion in bug reports.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416150"></a><a
-name="_Toc115417086"><span style='mso-bookmark:_Toc115416150'>4.5. Microsoft
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417086"></a><a
+name="_Toc115416150"><span style='mso-bookmark:_Toc115417086'>4.5. Microsoft
MiniDumps <br>
(fs minidump -> %WinDir%\TEMP\afsd.dmp)</span></a></h2>
of a MiniDump file containing the state of all of the threads in the AFS Client
Service process.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416151"></a><a
-name="_Toc115417087"><span style='mso-bookmark:_Toc115416151'>4.6. Single
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417087"></a><a
+name="_Toc115416151"><span style='mso-bookmark:_Toc115417087'>4.6. Single
Sign-on (Integrated Logon) debugging</span></a></h2>
<p class=MsoNormal>If you are having trouble with the Integrated Logon
Event Handlers to log information to the Windows Event Log: Application under
the name AFS Logon".</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416152"></a><a
-name="_Toc115417088"><span style='mso-bookmark:_Toc115416152'>4.7. RX (AFS RPC)
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417088"></a><a
+name="_Toc115416152"><span style='mso-bookmark:_Toc115417088'>4.7. RX (AFS RPC)
debugging (rxdebug)</span></a></h2>
<p class=MsoNormal>The rxdebug.exe tool can be used to query a variety of
<p class=PreformattedText><span style='mso-spacerun:yes'>
</span>-peers<span style='mso-spacerun:yes'> </span>show peers</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416153"></a><a
-name="_Toc115417089"><span style='mso-bookmark:_Toc115416153'>4.8. Cache
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417089"></a><a
+name="_Toc115416153"><span style='mso-bookmark:_Toc115417089'>4.8. Cache
Manager debugging (cmdebug)</span></a></h2>
<p class=MsoNormal>The cmdebug.exe tool can be used to query the state of the
</span>-cache<span style='mso-spacerun:yes'> </span>print only cache
configuration</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416154"></a><a
-name="_Toc115417090"><span style='mso-bookmark:_Toc115416154'>4.9. Persistent
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417090"></a><a
+name="_Toc115416154"><span style='mso-bookmark:_Toc115417090'>4.9. Persistent
Cache consistency check</span></a></h2>
<p class=MsoNormal>The persistent cache is stored in a Hidden System file at
<p class=PreformattedText><span style='mso-spacerun:yes'> </span>afsd_service.exe
--validate-cache <cache-path></p>
-<h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416155"></a><a
-name="_Toc115417091"></a><a name="_Toc115417113"><span style='mso-bookmark:
-_Toc115417091'><span style='mso-bookmark:_Toc115416155'>5. Reporting Bugs:</span></span></a></h1>
+<h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417113"></a><a
+name="_Toc115417091"></a><a name="_Toc115416155"><span style='mso-bookmark:
+_Toc115417091'><span style='mso-bookmark:_Toc115417113'>5. Reporting Bugs:</span></span></a></h1>
<p class=MsoNormal>Bug reports should be sent to <a
href="mailto:openafs-bugs@openafs.org?subject=Bug%20Report">openafs-bugs@openafs.org</a>.<span
<p class=MsoNormal>When reporting a error, please be sure to include the
version of OpenAFS.</p>
-<h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416156"></a><a
-name="_Toc115417092"></a><a name="_Toc115417114"><span style='mso-bookmark:
-_Toc115417092'><span style='mso-bookmark:_Toc115416156'>6. How to Contribute to
+<h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417114"></a><a
+name="_Toc115417092"></a><a name="_Toc115416156"><span style='mso-bookmark:
+_Toc115417092'><span style='mso-bookmark:_Toc115417114'>6. How to Contribute to
the Development of OpenAFS for Windows</span></span></a></h1>
<p class=MsoNormal>Contributions to the development of OpenAFS for Windows are
take many forms including cash donations, support contracts, donated developer
time, and even donated tech writer time.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416157"></a><a
-name="_Toc115417093"><span style='mso-bookmark:_Toc115416157'>6.1. The USENIX
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417093"></a><a
+name="_Toc115416157"><span style='mso-bookmark:_Toc115417093'>6.1. The USENIX
OpenAFS Fund</span></a> </h2>
<p class=MsoBodyText><a href="http://www.usenix.org/">USENIX</a>, a 501c3
<div class=Section2>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416159"></a><a
-name="_Toc115417099"><span style='mso-bookmark:_Toc115416159'>7.1. Introduction</span></a></h2>
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417099"></a><a
+name="_Toc115416159"><span style='mso-bookmark:_Toc115417099'>7.1. Introduction</span></a></h2>
<p class=MsoNormal>A MSI installer option is available for those who wish to
use Windows Installer for installing OpenAFS and for organizations that wish to
style='mso-list:Ignore'>2.<span style='font:7.0pt "Times New Roman"'>
</span></span><![endif]>msitran -a openafs-transform.mst openafs-test.msi</p>
-<p class=MsoNormal>and then checking the resulting openafs-test.msi to see if all
-changes you have made above to openafs-modified.msi is present in
+<p class=MsoNormal>and then checking the resulting openafs-test.msi to see if
+all changes you have made above to openafs-modified.msi is present in
openafs-test.msi.<span style='mso-spacerun:yes'> </span>'msitran' will
complain if some modification in the transform can not be successfully applied.</p>
the MSI databases directly when editing openafs-modified.msi.<span
style='mso-spacerun:yes'> </span>More details are given below.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416162"></a><a
-name="_Toc115417100"><span style='mso-bookmark:_Toc115416162'>7.2.
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417100"></a><a
+name="_Toc115416162"><span style='mso-bookmark:_Toc115417100'>7.2.
Configuration Options</span></a></h2>
<p class=MsoNormal>The logic necessary to implement many of the settings
list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;mso-fareast-font-family:
Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.<span
style='font:7.0pt "Times New Roman"'>
-</span></span></span><![endif]>Select the 'Property' table from the list of
-tables on the left.</p>
+</span></span></span><![endif]>Select the 'Property' table from the list of tables
+on the left.</p>
<p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
margin-left:18.0pt;text-indent:-18.0pt;mso-list:l14 level1 lfo30;tab-stops:
<p class=MsoNormal>These properties are combined to add a command line option
to the shortcut that will be created in the Start:Programs:OpenAFS and
Start:Programs:Startup folders (see CREDSSTARTUP).<span
-style='mso-spacerun:yes'> </span>The method of specifying the option was
-chosen for easy integration with the Windows Installer user interface.<span
+style='mso-spacerun:yes'> </span>The method of specifying the option was chosen
+for easy integration with the Windows Installer user interface.<span
style='mso-spacerun:yes'> </span>Although other methods can be used to specify
options to AFSCREDS.EXE, it is advised that they be avoided as transforms
including such options may not apply to future releases of OpenAFS.</p>
<td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
<h6 style='mso-yfti-cnfc:1'><a name="_Toc115416185">CREDSSTARTUP</a></h6>
<p class=MsoList style='mso-yfti-cnfc:1'>Valid values<span
- style='mso-spacerun:yes'> </span><span style='mso-spacerun:yes'> </span>:
- '1' or '0'</p>
+ style='mso-spacerun:yes'> </span>: '1' or '0'</p>
<p class=MsoList style='mso-yfti-cnfc:1'>Controls whether AFSCreds.exe starts
up automatically when the user logs on.<span style='mso-spacerun:yes'>
- </span>When CREDSSTARTUP is '1' a shortcut is added to the 'Startup' folder
- in the 'Program menu' which starts AFSCREDS.EXE with the options that are
+ </span>When CREDSSTARTUP is '1' a shortcut is added to the 'Startup' folder in
+ the 'Program menu' which starts AFSCREDS.EXE with the options that are
determined by the other CREDS* properties.</p>
</td>
</tr>
</tr>
</table>
-<p class=MsoNormal style='margin-left:35.45pt'>Note that the ComponentId is an
-uppercase GUID.<span style='mso-spacerun:yes'> </span>You can generate one
-using GUIDGEN.EXE or UUIDGEN.EXE, both of which are included in the Platform
-SDK.</p>
+<p class=MsoNormal style='margin-left:35.45pt'>Note that the ComponentId is an uppercase
+GUID.<span style='mso-spacerun:yes'> </span>You can generate one using
+GUIDGEN.EXE or UUIDGEN.EXE, both of which are included in the Platform SDK.</p>
<p class=MsoNormal style='margin-left:35.45pt'>The Attributes value of 144 is a
sum of msidbComponentAttributesPermanent (16) and
</tr>
</table>
-<p class=MsoNormal style='margin-left:35.45pt'>It is important to create the new
-feature under the 'feaClient' feature, which will ensure that the configuration
-file will be installed when the client binaries are installed.</p>
+<p class=MsoNormal style='margin-left:35.45pt'>It is important to create the
+new feature under the 'feaClient' feature, which will ensure that the
+configuration file will be installed when the client binaries are installed.</p>
<p class=MsoNormal style='margin-left:35.45pt'>Setting 'Display' to 0 will hide
-this feature from the feature selection dialog during an interactive installation.<span
-style='mso-spacerun:yes'> </span>A value of 30 for 'Level' allows this feature
-to be installed by default (on a 'Typical' installation).</p>
+this feature from the feature selection dialog during an interactive
+installation.<span style='mso-spacerun:yes'> </span>A value of 30 for 'Level'
+allows this feature to be installed by default (on a 'Typical' installation).</p>
<p class=MsoNormal style='margin-left:35.45pt'>The 'Attributes' value is
msidbFeatureAttributesDisallowAdvertise (8), which is set on all features in
-the OpenAFS MSI.<span style='mso-spacerun:yes'> </span>The OpenAFS MSI is not designed
-for an advertised installation.</p>
+the OpenAFS MSI.<span style='mso-spacerun:yes'> </span>The OpenAFS MSI is not
+designed for an advertised installation.</p>
<p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l13 level1 lfo32;
tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
<p class=MsoNormal style='margin-left:35.45pt'>The 'Attributes' value is
msidbFileAttributesNonCompressed (8192).<span style='mso-spacerun:yes'>
-</span>This is because we will be placing this file in the same directory as
-the MSI instead of embedding the file in it.<span style='mso-spacerun:yes'>
+</span>This is because we will be placing this file in the same directory as the
+MSI instead of embedding the file in it.<span style='mso-spacerun:yes'>
</span>Transforms do not support updating compressed sources or adding new
cabinet streams.</p>
<p class=MsoNormal><span style='mso-tab-count:1'> </span><span
style='mso-spacerun:yes'> </span>(leave other fields blank)</p>
-<p class=MsoNormal style='margin-left:35.45pt'>The sequence number of 1000
-designates this as the media source for the newly added file.</p>
+<p class=MsoNormal style='margin-left:35.45pt'>The sequence number of 1000 designates
+this as the media source for the newly added file.</p>
<h4><a name="_Toc115416193"></a><a name="_2.3.1_Components_for_Configuration_"></a><span
style='mso-bookmark:_Toc115416193'>7.2.3.1 Components for Configuration Files</span></h4>
-<p class=PreformattedText style='text-indent:35.45pt'>CellServDB: 'cpf_CellServDB'
-(ID {D5BA4C15-DBEC-4292-91FC-B54C30F24F2A})</p>
+<p class=PreformattedText style='text-indent:35.45pt'>CellServDB:
+'cpf_CellServDB' (ID {D5BA4C15-DBEC-4292-91FC-B54C30F24F2A})</p>
<h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416194">7.2.4
Adding Domain Specific Registry Keys</a></h3>
<p class=MsoNormal><span style='mso-spacerun:yes'> </span>Columns that are
unspecified should be left empty.</p>
-<p class=MsoNormal><span style='mso-spacerun:yes'> </span>We create a new
-feature and component to hold the new registry keys.</p>
+<p class=MsoNormal><span style='mso-spacerun:yes'> </span>We create a new feature
+and component to hold the new registry keys.</p>
<table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
</tr>
<tr style='mso-yfti-irow:3'>
<td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
- <p class=MsoNormal><span style='mso-spacerun:yes'> </span>'FeatureComponents'
- table:</p>
+ <p class=MsoNormal><span style='mso-spacerun:yes'>
+ </span>'FeatureComponents' table:</p>
</td>
</tr>
<tr style='mso-yfti-irow:4'>
</tr>
<tr style='mso-yfti-irow:5'>
<td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
- <p class=MsoNormal><span style='mso-spacerun:yes'> </span>'Registry'
- table:</p>
+ <p class=MsoNormal><span style='mso-spacerun:yes'> </span><span
+ style='mso-spacerun:yes'> </span>'Registry' table:</p>
</td>
</tr>
<tr style='mso-yfti-irow:6'>
<span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
2'> </span>: 2<br>
<span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
- 2'> </span>:
- 'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain'<br>
+ 2'> </span>: 'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain'<br>
<span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
2'> </span>: '*'<br>
<span style='mso-tab-count:1'> </span>Component<span
<span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
2'> </span>: 2<br>
<span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
- 2'> </span>: 'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\ATHENA.MIT.EDU'<br>
+ 2'> </span>:
+ 'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\ATHENA.MIT.EDU'<br>
<span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
2'> </span>: 'LogonOptions'<br>
<span style='mso-tab-count:1'> </span>Value<span style='mso-tab-count:
<span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
2'> </span>: 2<br>
<span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
- 2'> </span>: SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST'<br>
+ 2'> </span>:
+ SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST'<br>
<span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
2'> </span>: '*'<br>
<span style='mso-tab-count:1'> </span>Component<span
<span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
2'> </span>: 2<br>
<span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
- 2'> </span>:
- 'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST'<br>
+ 2'> </span>: 'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST'<br>
<span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
2'> </span>: 'FailLoginsSilently'<br>
<span style='mso-tab-count:1'> </span>Value<span style='mso-tab-count:
<p class=MsoNormal><o:p> </o:p></p>
-<p class=MsoNormal>The example adds domain specific keys for 'ATHENA.MIT.EDU'
-(enable integrated logon) and 'LOCALHOST' (disable integrated logon and fail
-logins silently).</p>
+<p class=MsoNormal>The example adds domain specific keys for 'ATHENA.MIT.EDU' (enable
+integrated logon) and 'LOCALHOST' (disable integrated logon and fail logins
+silently).</p>
<h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416195">7.2.5
Adding Site Specific Freelance Registry Keys</a></h3>
</tr>
<tr style='mso-yfti-irow:5'>
<td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
- <p class=MsoNormal><span style='mso-spacerun:yes'> </span>'Registry' table:</p>
+ <p class=MsoNormal><span style='mso-spacerun:yes'> </span>'Registry'
+ table:</p>
</td>
</tr>
<tr style='mso-yfti-irow:6'>
<span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
2'> </span>: '0'<br>
<span style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'> </span>Value<span
- style='mso-spacerun:yes'> </span><span
- style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'> </span>:
+ style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'> </span>:
'athena.mit.edu#athena.mit.edu:root.cell.'<br>
<span style='mso-tab-count:1'> </span>Component<span
style='mso-tab-count:1'> </span>: 'rcm_FreelanceKeys'</p>
athena.mit.edu cell's root.afs volume as well as a read-write mountpoint.<span
style='mso-spacerun:yes'> </span>Aliases are also provided using symlinks.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Ref115275867"></a><a
-name="_Toc115416196"></a><a name="_Toc115417101"><span style='mso-bookmark:
-_Toc115416196'><span style='mso-bookmark:_Ref115275867'>7.3 Additional
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417101"></a><a
+name="_Toc115416196"></a><a name="_Ref115275867"><span style='mso-bookmark:
+_Toc115416196'><span style='mso-bookmark:_Toc115417101'>7.3 Additional
Resources</span></span></a></h2>
<p class=MsoNormal>If you want to add registry keys or files you need to create
<p class=MsoNormal>See the Platform SDK documentation for information on
command line options for MSITRAN.EXE.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416197"></a><a
-name="_Toc115417102"><span style='mso-bookmark:_Toc115416197'>7.4. Upgrades</span></a></h2>
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417102"></a><a
+name="_Toc115416197"><span style='mso-bookmark:_Toc115417102'>7.4. Upgrades</span></a></h2>
<p class=MsoNormal>The MSI package is designed to replace (or uninstall)
previous versions of OpenAFS for Windows during installation.<span
style='mso-spacerun:yes'> </span>Previous versions are installations that used
the NSIS (.EXE) installer or an MSI that has a known Upgrade Code and a
-different Product Code. <span style='mso-spacerun:yes'> </span>The MSI does not
+different Product Code.<span style='mso-spacerun:yes'> </span>The MSI does not
directly upgrade an existing installation.<span style='mso-spacerun:yes'>
</span>This is intentional and ensures that development releases which do not
have strictly increasing version numbers are properly upgraded.</p>
<h3 style='margin-left:0pt;text-indent:0pt'>7.4.1. OpenAFS MSI Product Codes</h3>
-<h4>Release 1.3<o:p></o:p></h4>
+<h4>Release 1.3</h4>
<table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
style='border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;
</tr>
</table>
-<h4>Release 1.4<o:p></o:p></h4>
+<h4>Release 1.4</h4>
<table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
style='border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;
</tr>
</table>
-<h4>Release 1.5<o:p></o:p></h4>
+<h4>Release 1.5</h4>
<table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
style='border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;
style='mso-bookmark:_Toc115417116'><span style='mso-bookmark:_Toc115417103'><span
style='mso-bookmark:_Toc115416198'>Appendix A: Registry Values</span></span></span></h1>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416199"></a><a
-name="_Toc115417104"><span style='mso-bookmark:_Toc115416199'>A.1. Service
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417104"></a><a
+name="_Toc115416199"><span style='mso-bookmark:_Toc115417104'>A.1. Service
parameters</span></a></h2>
<p class=MsoBodyText>The service parameters primarily affect the behavior of
Default: -1<br>
Variable: LANadapter</p>
<p class=MsoBodyText style='mso-yfti-cnfc:1'>LAN adapter number to use.<span
- style='mso-spacerun:yes'> </span>This is the lana number of the LAN adapter that
- the SMB server should bind to.<span style='mso-spacerun:yes'> </span>If
+ style='mso-spacerun:yes'> </span>This is the lana number of the LAN adapter
+ that the SMB server should bind to.<span style='mso-spacerun:yes'> </span>If
unspecified or set to -1, a LAN adapter with named 'AFS' or a loopback
adapter will be selected.<span style='mso-spacerun:yes'> </span>If neither
are present, then all available adapters will be bound to.<span
<p class=MsoBodyText>Type: DWORD<br>
Default: 25 (CM_CONFIGDEFAULT_SVTHREADS)<br>
Variable: numSvThreads</p>
- <p class=MsoBodyText>Number of SMB server threads (number of threads of
- smb_Server). (see smb_Server in smb.c).</p>
+ <p class=MsoBodyText>Number of SMB server threads (number of threads of smb_Server).
+ (see smb_Server in smb.c).</p>
</td>
</tr>
<tr style='mso-yfti-irow:4;height:79.25pt'>
Variable: cm_mountRoot</p>
<p class=MsoBodyText>Name of root mount point.<span
style='mso-spacerun:yes'> </span>In symlinks, if a path starts with
- cm_mountRoot, it is assumed that the path is absolute (as opposed to
- relative) and is adjusted accordingly. Eg: if a path is specified as
+ cm_mountRoot, it is assumed that the path is absolute (as opposed to relative)
+ and is adjusted accordingly. Eg: if a path is specified as
/afs/athena.mit.edu/foo/bar/baz and cm_mountRoot is "/afs", then
the path is interpreted as \\afs\all\athena.mit.edu\foo\bar\baz.<span
style='mso-spacerun:yes'> </span>If a path does not start with with
Default: 0</p>
<p class=MsoBodyText>Enables logging of debug output to the Windows Event
Log.</p>
- <p class=MsoBodyText>Bit 0 enables logging of "Logon Events" processed
- by the Network Provider and Winlogon Event Notification Handler.<span
- style='mso-spacerun:yes'> </span></p>
+ <p class=MsoBodyText>Bit 0 enables logging of "Logon Events"
+ processed by the Network Provider and Winlogon Event Notification
+ Handler.<span style='mso-spacerun:yes'> </span></p>
<p class=MsoBodyText>Bit 1 enables logging of events captured by the AFS
Client Service.</p>
<p class=MsoBodyText>Bit 2 enables real-time viewing of "fs trace"
<p class=MsoBodyText>Type: DWORD {0 .. MAXDWORD}<br>
Default: 100K</p>
<p class=MsoBodyText>This entry determines the maximum size of the
- %WINDIR%\TEMP\afsd_init.log file.<span style='mso-spacerun:yes'> </span>If
- the file is larger than this value when afsd_service.exe starts the file will
- be reset to 0 bytes.<span style='mso-spacerun:yes'> </span>If this value is
- 0, it means the file should be allowed to grow indefinitely.</p>
+ %WINDIR%\TEMP\afsd_init.log file.<span style='mso-spacerun:yes'> </span>If the
+ file is larger than this value when afsd_service.exe starts the file will be
+ reset to 0 bytes.<span style='mso-spacerun:yes'> </span>If this value is 0,
+ it means the file should be allowed to grow indefinitely.</p>
</td>
</tr>
<tr style='mso-yfti-irow:34;mso-yfti-lastrow:yes;height:65.75pt'>
CellServDBDir</span></h5>
<p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
Default: <not defined></p>
- <p class=MsoBodyText style='mso-yfti-cnfc:1'>Specifies the directory containing
- the CellServDB file.<span style='mso-spacerun:yes'> </span>When this value
- is not specified, the AFS Client install directory is used.</p>
+ <p class=MsoBodyText style='mso-yfti-cnfc:1'>Specifies the directory
+ containing the CellServDB file.<span style='mso-spacerun:yes'> </span>When
+ this value is not specified, the AFS Client install directory is used.</p>
</td>
</tr>
<tr style='mso-yfti-irow:0;height:145.25pt'>
MiniDumpWithCodeSegs = 0x00002000</p>
</td>
</tr>
- <tr style='mso-yfti-irow:3;mso-yfti-lastrow:yes;height:138.25pt'>
+ <tr style='mso-yfti-irow:3;height:138.25pt'>
<td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
height:138.25pt'>
<h5><a name="_Toc115416244"></a><a name="_Value___:_StoreAnsiFilenames"></a><span
<p class=MsoBodyText>Type: REG_DWORD<br>
Default: 0x0</p>
<p class=MsoBodyText>This value can be used to force the AFS Client Service
- to store filenames using the Windows system's ANSI character set instead of the
- OEM Code Page character set which has traditionally been used by SMB file
+ to store filenames using the Windows system's ANSI character set instead of
+ the OEM Code Page character set which has traditionally been used by SMB file
systems.<span style='mso-spacerun:yes'> </span></p>
<p class=MsoBodyText>Note: The use of ANSI characters will render access to
files with 8-bit OEM file names unaccessible from Windows.<span
UNIX systems and vice versa.</p>
</td>
</tr>
+ <tr style='mso-yfti-irow:4;height:138.25pt'>
+ <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
+ height:138.25pt'>
+ <h5>Value: RxEnablePeerStats</h5>
+ <p class=MsoBodyText>Type: REG_DWORD<br>
+ Default: 0x0</p>
+ <p class=MsoBodyText>This value will enable the gathering of RX Statistics
+ for connections with the Cache Managers Peers.<span
+ style='mso-spacerun:yes'> </span>This functionality can be adjusted at
+ runtime with the fs rxstatpeer command.</p>
+ </td>
+ </tr>
+ <tr style='mso-yfti-irow:5;mso-yfti-lastrow:yes;height:138.25pt'>
+ <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
+ height:138.25pt'>
+ <h5>Value: RxEnableProcessStats<o:p></o:p></h5>
+ <p class=MsoBodyText>Type: REG_DWORD<br>
+ Default: 0x0<o:p></o:p></p>
+ <p class=MsoBodyText>This value will enable the gathering of RX Statistics
+ for the Cache Managers Process.<span style='mso-spacerun:yes'> </span>This
+ functionality can be adjusted at runtime with the fs rxstatproc command.<o:p></o:p></p>
+ </td>
+ </tr>
</table>
<h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416245">Regkey:<br>
ip address"</a></h5>
<p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_DWORD<br>
Default: <none></p>
- <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to specify a default
- set of File server preferences. For each entry the value name will be either
- the IP address of a server or a fully qualified domain name.<span
+ <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to specify a
+ default set of File server preferences. For each entry the value name will be
+ either the IP address of a server or a fully qualified domain name.<span
style='mso-spacerun:yes'> </span>The value will be the ranking.<span
style='mso-spacerun:yes'> </span>The ranking will be adjusted by a random
value between 0 and 256 prior to the preference being set.</p>
</tr>
</table>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416257"></a><a
-name="_Toc115417105"><span style='mso-bookmark:_Toc115416257'>A.2. Integrated
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417105"></a><a
+name="_Toc115416257"><span style='mso-bookmark:_Toc115417105'>A.2. Integrated
Logon Network provider parameters</span></a></h2>
<p class=MsoBodyText>Affects the network provider (afslogon.dll).</p>
security setting.<span style='mso-spacerun:yes'> </span>Please be aware of
this when setting this value.</p>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416286"></a><a
-name="_Toc115417107"><span style='mso-bookmark:_Toc115416286'>A.3. AFS
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417107"></a><a
+name="_Toc115416286"><span style='mso-bookmark:_Toc115417107'>A.3. AFS
Credentials System Tray Tool parameters</span></a></h2>
<p class=MsoBodyText>Affects the behavior of afscreds.exe</p>
<p class=MsoBodyText>Type: REG_SZ<br>
Default: <none><br>
Variable: IsServiceConfigured()</p>
- <p class=MsoBodyText>The value Cell is used to determine if the AFS Client Service
- has been properly configured or not.</p>
+ <p class=MsoBodyText>The value Cell is used to determine if the AFS Client
+ Service has been properly configured or not.</p>
</td>
</tr>
</table>
<p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD {0, 1}<br>
Default: 1<br>
Function: InitApp(), Main_OnCheckTerminate()</p>
- <p class=MsoBodyText style='mso-yfti-cnfc:1'>This value is used to determine whether
- or not a shortcut should be maintained in the user's Start
+ <p class=MsoBodyText style='mso-yfti-cnfc:1'>This value is used to determine
+ whether or not a shortcut should be maintained in the user's Start
Menu->Programs->Startup folder. </p>
<p class=MsoBodyText style='mso-yfti-cnfc:1'>This value used to be stored at
[HKLM\Software\TransarcCorporation\AFS Client\AfsCreds].</p>
<p class=MsoBodyText>Type: REG_SZ<br>
Default: "-A -M -N -Q"<br>
Function: Shortcut_FixStartup</p>
- <p class=MsoBodyText>This value specifies the command line options which should
- be set as part of the shortcut to afscreds.exe.<span
+ <p class=MsoBodyText>This value specifies the command line options which
+ should be set as part of the shortcut to afscreds.exe.<span
style='mso-spacerun:yes'> </span>afscreds.exe rewrites the shortcut each
time it exits so as to ensure that the shortcut points to the latest version
of the program.<span style='mso-spacerun:yes'> </span>This value is used to
drive letter"</a></h5>
<p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD {0, 1}<br>
Default: <none></p>
- <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values are used to store the
- persistence state of the AFS drive mappings as listed in the
+ <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values are used to store
+ the persistence state of the AFS drive mappings as listed in the
[...\Client\Mappings] key.</p>
<p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
in the afsdsbmt.ini file</p>
</tr>
</table>
-<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416303"></a><a
-name="_Toc115417108"><span style='mso-bookmark:_Toc115416303'>A.4 OpenAFS
+<h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417108"></a><a
+name="_Toc115416303"><span style='mso-bookmark:_Toc115417108'>A.4 OpenAFS
Client Service Environment Variables</span></a></h2>
<table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
git://git.openafs.org / openafs.git / blobdiff