src/WINNT/doc/install/Documentation/en_US/html/ReleaseNotes/relnotes.htm

   1 <html xmlns:v="urn:schemas-microsoft-com:vml"
   2 xmlns:o="urn:schemas-microsoft-com:office:office"
   3 xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:st1="urn:schemas:contacts"
   4 xmlns:st2="urn:schemas-microsoft-com:office:smarttags"
   5 xmlns="http://www.w3.org/TR/REC-html40">
   6
   7 <head>
   8 <meta http-equiv=Content-Type content="text/html; charset=windows-1252">
   9 <meta name=ProgId content=Word.Document>
  10 <meta name=Generator content="Microsoft Word 11">
  11 <meta name=Originator content="Microsoft Word 11">
  12 <link rel=File-List href="relnotes_files/filelist.xml">
  13 <link rel=Preview href="relnotes_files/preview.wmf">
  14 <title>OpenAFS for Windows 1.4.0 Release Notes</title>
  15 <o:SmartTagType namespaceuri="urn:schemas:contacts" name="GivenName"/>
  16 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
  17  name="address"/>
  18 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
  19  name="PostalCode"/>
  20 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
  21  name="State"/>
  22 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
  23  name="City"/>
  24 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
  25  name="Street"/>
  26 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
  27  name="country-region"/>
  28 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
  29  name="PlaceType"/>
  30 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
  31  name="PlaceName"/>
  32 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
  33  name="place"/>
  34 <!--[if gte mso 9]><xml>
  35  <o:DocumentProperties>
  36   <o:Author>Jeffrey Altman</o:Author>
  37   <o:Keywords>OpenAFS 1.4.0</o:Keywords>
  38   <o:LastAuthor>Jeffrey Altman</o:LastAuthor>
  39   <o:Revision>5</o:Revision>
  40   <o:TotalTime>45</o:TotalTime>
  41   <o:LastPrinted>2005-09-26T23:55:00Z</o:LastPrinted>
  42   <o:Created>2005-09-25T20:12:00Z</o:Created>
  43   <o:LastSaved>2005-10-03T02:28:00Z</o:LastSaved>
  44   <o:Pages>1</o:Pages>
  45   <o:Words>14557</o:Words>
  46   <o:Characters>82979</o:Characters>
  47   <o:Company>Secure Endpoints Inc.</o:Company>
  48   <o:Lines>691</o:Lines>
  49   <o:Paragraphs>194</o:Paragraphs>
  50   <o:CharactersWithSpaces>97342</o:CharactersWithSpaces>
  51   <o:Version>11.6568</o:Version>
  52  </o:DocumentProperties>
  53 </xml><![endif]--><!--[if gte mso 9]><xml>
  54  <w:WordDocument>
  55   <w:DrawingGridHorizontalSpacing>0 pt</w:DrawingGridHorizontalSpacing>
  56   <w:DrawingGridVerticalSpacing>0 pt</w:DrawingGridVerticalSpacing>
  57   <w:DisplayHorizontalDrawingGridEvery>0</w:DisplayHorizontalDrawingGridEvery>
  58   <w:DisplayVerticalDrawingGridEvery>0</w:DisplayVerticalDrawingGridEvery>
  59   <w:UseMarginsForDrawingGridOrigin/>
  60   <w:ValidateAgainstSchemas/>
  61   <w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid>
  62   <w:IgnoreMixedContent>false</w:IgnoreMixedContent>
  63   <w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText>
  64   <w:DrawingGridHorizontalOrigin>0 pt</w:DrawingGridHorizontalOrigin>
  65   <w:DrawingGridVerticalOrigin>0 pt</w:DrawingGridVerticalOrigin>
  66   <w:Compatibility>
  67    <w:NoLeading/>
  68    <w:SpaceForUL/>
  69    <w:BalanceSingleByteDoubleByteWidth/>
  70    <w:DoNotLeaveBackslashAlone/>
  71    <w:ULTrailSpace/>
  72    <w:DoNotExpandShiftReturn/>
  73    <w:AdjustLineHeightInTable/>
  74    <w:SelectEntireFieldWithStartOrEnd/>
  75    <w:UseWord2002TableStyleRules/>
  76    <w:UseFELayout/>
  77   </w:Compatibility>
  78   <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
  79  </w:WordDocument>
  80 </xml><![endif]--><!--[if gte mso 9]><xml>
  81  <w:LatentStyles DefLockedState="false" LatentStyleCount="156">
  82  </w:LatentStyles>
  83 </xml><![endif]--><!--[if !mso]><object
  84  classid="clsid:38481807-CA0E-42D2-BF39-B33AF135CC4D" id=ieooui></object>
  85 <style>
  86 st1\:*{behavior:url(#ieooui) }st2\:*{behavior:url(#ieooui) }
  87 </style>
  88 <![endif]-->
  89 <style>
  90 <!--
  91  /* Font Definitions */
  92  @font-face
  93         {font-family:"MS Mincho";
  94         panose-1:2 2 6 9 4 2 5 8 3 4;
  95         mso-font-alt:"\FF2D\FF33 \660E\671D";
  96         mso-font-charset:128;
  97         mso-generic-font-family:modern;
  98         mso-font-pitch:fixed;
  99         mso-font-signature:-1610612033 1757936891 16 0 131231 0;}
 100 @font-face
 101         {font-family:Tahoma;
 102         panose-1:2 11 6 4 3 5 4 4 2 4;
 103         mso-font-charset:0;
 104         mso-generic-font-family:swiss;
 105         mso-font-pitch:variable;
 106         mso-font-signature:1627421319 -2147483648 8 0 66047 0;}
 107 @font-face
 108         {font-family:Thorndale;
 109         panose-1:2 2 6 3 5 4 5 2 3 4;
 110         mso-font-charset:0;
 111         mso-generic-font-family:roman;
 112         mso-font-pitch:variable;
 113         mso-font-signature:647 0 0 0 159 0;}
 114 @font-face
 115         {font-family:"Andale Sans UI";
 116         panose-1:2 11 5 2 0 0 0 0 0 1;
 117         mso-font-charset:0;
 118         mso-generic-font-family:swiss;
 119         mso-font-pitch:variable;
 120         mso-font-signature:647 0 0 0 159 0;}
 121 @font-face
 122         {font-family:StarSymbol;
 123         panose-1:5 0 0 0 0 0 0 0 0 0;
 124         mso-font-charset:0;
 125         mso-generic-font-family:auto;
 126         mso-font-pitch:variable;
 127         mso-font-signature:3 268468224 0 0 1 0;}
 128 @font-face
 129         {font-family:Albany;
 130         panose-1:2 11 6 4 2 2 2 2 2 4;
 131         mso-font-charset:0;
 132         mso-generic-font-family:swiss;
 133         mso-font-pitch:variable;
 134         mso-font-signature:647 0 0 0 159 0;}
 135 @font-face
 136         {font-family:Cumberland;
 137         panose-1:2 7 3 9 2 2 5 2 4 4;
 138         mso-font-charset:0;
 139         mso-generic-font-family:modern;
 140         mso-font-pitch:fixed;
 141         mso-font-signature:647 0 0 0 159 0;}
 142 @font-face
 143         {font-family:"\@MS Mincho";
 144         panose-1:2 2 6 9 4 2 5 8 3 4;
 145         mso-font-charset:128;
 146         mso-generic-font-family:modern;
 147         mso-font-pitch:fixed;
 148         mso-font-signature:-1610612033 1757936891 16 0 131231 0;}
 149  /* Style Definitions */
 150  p.MsoNormal, li.MsoNormal, div.MsoNormal
 151         {mso-style-parent:"";
 152         margin-top:7.2pt;
 153         margin-right:0pt;
 154         margin-bottom:7.2pt;
 155         margin-left:0pt;
 156         mso-pagination:none;
 157         mso-hyphenate:none;
 158         font-size:12.0pt;
 159         font-family:Thorndale;
 160         mso-fareast-font-family:"Andale Sans UI";
 161         mso-bidi-font-family:"Times New Roman";}
 162 h1
 163         {mso-style-parent:Heading;
 164         mso-style-next:"Body Text";
 165         margin-top:12.0pt;
 166         margin-right:0pt;
 167         margin-bottom:6.0pt;
 168         margin-left:0pt;
 169         text-indent:0pt;
 170         mso-pagination:none;
 171         page-break-after:avoid;
 172         mso-outline-level:1;
 173         mso-list:l11 level1 lfo2;
 174         mso-hyphenate:none;
 175         tab-stops:list 0pt;
 176         font-size:16.0pt;
 177         font-family:Albany;
 178         mso-bidi-font-family:Tahoma;
 179         mso-font-kerning:0pt;}
 180 h2
 181         {mso-style-parent:Heading;
 182         mso-style-next:"Body Text";
 183         margin-top:12.0pt;
 184         margin-right:0pt;
 185         margin-bottom:6.0pt;
 186         margin-left:0pt;
 187         text-indent:0pt;
 188         mso-pagination:none;
 189         page-break-after:avoid;
 190         mso-outline-level:2;
 191         mso-list:l11 level2 lfo2;
 192         mso-hyphenate:none;
 193         tab-stops:list 0pt;
 194         font-size:14.0pt;
 195         font-family:Albany;
 196         mso-bidi-font-family:Tahoma;
 197         font-style:italic;}
 198 h3
 199         {mso-style-parent:Heading;
 200         mso-style-link:"Heading 3 Char";
 201         mso-style-next:"Body Text";
 202         margin-top:12.0pt;
 203         margin-right:0pt;
 204         margin-bottom:6.0pt;
 205         margin-left:0pt;
 206         text-indent:0pt;
 207         mso-pagination:none;
 208         page-break-after:avoid;
 209         mso-outline-level:3;
 210         mso-list:l11 level3 lfo2;
 211         mso-hyphenate:none;
 212         tab-stops:list 0pt;
 213         font-size:14.0pt;
 214         font-family:Albany;
 215         mso-bidi-font-family:Tahoma;}
 216 h4
 217         {mso-style-link:"Heading 4 Char";
 218         mso-style-next:Normal;
 219         margin-top:12.0pt;
 220         margin-right:0pt;
 221         margin-bottom:3.0pt;
 222         margin-left:0pt;
 223         mso-pagination:none;
 224         page-break-after:avoid;
 225         mso-outline-level:4;
 226         mso-hyphenate:none;
 227         font-size:14.0pt;
 228         font-family:"Times New Roman";
 229         mso-fareast-font-family:"Andale Sans UI";}
 230 h5
 231         {mso-style-next:Normal;
 232         margin-top:12.0pt;
 233         margin-right:0pt;
 234         margin-bottom:3.0pt;
 235         margin-left:0pt;
 236         mso-pagination:none;
 237         mso-outline-level:5;
 238         mso-hyphenate:none;
 239         font-size:13.0pt;
 240         font-family:Thorndale;
 241         mso-fareast-font-family:"Andale Sans UI";
 242         font-style:italic;}
 243 h6
 244         {mso-style-next:Normal;
 245         margin-top:12.0pt;
 246         margin-right:0pt;
 247         margin-bottom:3.0pt;
 248         margin-left:0pt;
 249         mso-pagination:none;
 250         mso-outline-level:6;
 251         mso-hyphenate:none;
 252         font-size:11.0pt;
 253         font-family:"Times New Roman";
 254         mso-fareast-font-family:"Andale Sans UI";}
 255 p.MsoToc1, li.MsoToc1, div.MsoToc1
 256         {mso-style-noshow:yes;
 257         mso-style-parent:Index;
 258         margin-top:7.2pt;
 259         margin-right:0pt;
 260         margin-bottom:7.2pt;
 261         margin-left:0pt;
 262         mso-pagination:no-line-numbers;
 263         mso-hyphenate:none;
 264         tab-stops:right dotted 432.0pt;
 265         font-size:12.0pt;
 266         font-family:Thorndale;
 267         mso-fareast-font-family:"Andale Sans UI";
 268         mso-bidi-font-family:Tahoma;}
 269 p.MsoToc2, li.MsoToc2, div.MsoToc2
 270         {mso-style-noshow:yes;
 271         mso-style-parent:Index;
 272         margin-top:7.2pt;
 273         margin-right:0pt;
 274         margin-bottom:7.2pt;
 275         margin-left:14.15pt;
 276         mso-pagination:no-line-numbers;
 277         mso-hyphenate:none;
 278         tab-stops:right dotted 432.0pt;
 279         font-size:12.0pt;
 280         font-family:Thorndale;
 281         mso-fareast-font-family:"Andale Sans UI";
 282         mso-bidi-font-family:Tahoma;}
 283 p.MsoToc3, li.MsoToc3, div.MsoToc3
 284         {mso-style-noshow:yes;
 285         mso-style-parent:Index;
 286         margin-top:7.2pt;
 287         margin-right:0pt;
 288         margin-bottom:7.2pt;
 289         margin-left:28.3pt;
 290         mso-pagination:no-line-numbers;
 291         mso-hyphenate:none;
 292         tab-stops:right dotted 432.0pt;
 293         font-size:12.0pt;
 294         font-family:Thorndale;
 295         mso-fareast-font-family:"Andale Sans UI";
 296         mso-bidi-font-family:Tahoma;}
 297 p.MsoFootnoteText, li.MsoFootnoteText, div.MsoFootnoteText
 298         {mso-style-noshow:yes;
 299         margin-top:7.2pt;
 300         margin-right:0pt;
 301         margin-bottom:7.2pt;
 302         margin-left:0pt;
 303         mso-pagination:none;
 304         mso-hyphenate:none;
 305         font-size:10.0pt;
 306         font-family:Thorndale;
 307         mso-fareast-font-family:"Andale Sans UI";
 308         mso-bidi-font-family:"Times New Roman";}
 309 p.MsoHeader, li.MsoHeader, div.MsoHeader
 310         {margin-top:7.2pt;
 311         margin-right:0pt;
 312         margin-bottom:7.2pt;
 313         margin-left:0pt;
 314         mso-pagination:none;
 315         mso-hyphenate:none;
 316         tab-stops:center 216.0pt right 432.0pt;
 317         font-size:12.0pt;
 318         font-family:Thorndale;
 319         mso-fareast-font-family:"Andale Sans UI";
 320         mso-bidi-font-family:"Times New Roman";}
 321 p.MsoFooter, li.MsoFooter, div.MsoFooter
 322         {margin-top:7.2pt;
 323         margin-right:0pt;
 324         margin-bottom:7.2pt;
 325         margin-left:0pt;
 326         mso-pagination:none;
 327         mso-hyphenate:none;
 328         tab-stops:center 216.0pt right 432.0pt;
 329         font-size:12.0pt;
 330         font-family:Thorndale;
 331         mso-fareast-font-family:"Andale Sans UI";
 332         mso-bidi-font-family:"Times New Roman";}
 333 p.MsoEnvelopeAddress, li.MsoEnvelopeAddress, div.MsoEnvelopeAddress
 334         {margin-top:7.2pt;
 335         margin-right:0pt;
 336         margin-bottom:7.2pt;
 337         margin-left:144.0pt;
 338         mso-pagination:none;
 339         mso-hyphenate:none;
 340         mso-element:frame;
 341         mso-element-frame-width:396.0pt;
 342         mso-element-frame-height:99.0pt;
 343         mso-element-frame-hspace:9.0pt;
 344         mso-element-wrap:auto;
 345         mso-element-anchor-horizontal:page;
 346         mso-element-left:center;
 347         mso-element-top:bottom;
 348         font-size:12.0pt;
 349         font-family:Arial;
 350         mso-fareast-font-family:"Andale Sans UI";}
 351 span.MsoFootnoteReference
 352         {mso-style-noshow:yes;
 353         vertical-align:super;}
 354 p.MsoList, li.MsoList, div.MsoList
 355         {mso-style-parent:"Body Text";
 356         margin-top:0pt;
 357         margin-right:0pt;
 358         margin-bottom:6.0pt;
 359         margin-left:0pt;
 360         mso-pagination:none;
 361         mso-hyphenate:none;
 362         font-size:12.0pt;
 363         font-family:Thorndale;
 364         mso-fareast-font-family:"Andale Sans UI";
 365         mso-bidi-font-family:Tahoma;}
 366 p.MsoTitle, li.MsoTitle, div.MsoTitle
 367         {mso-style-parent:Heading;
 368         mso-style-next:Subtitle;
 369         margin-top:12.0pt;
 370         margin-right:0pt;
 371         margin-bottom:6.0pt;
 372         margin-left:0pt;
 373         text-align:center;
 374         mso-pagination:none;
 375         page-break-after:avoid;
 376         mso-hyphenate:none;
 377         font-size:18.0pt;
 378         font-family:Albany;
 379         mso-fareast-font-family:"MS Mincho";
 380         mso-bidi-font-family:Tahoma;
 381         font-weight:bold;}
 382 p.MsoBodyText, li.MsoBodyText, div.MsoBodyText
 383         {mso-style-link:"Body Text Char";
 384         margin-top:0pt;
 385         margin-right:0pt;
 386         margin-bottom:6.0pt;
 387         margin-left:0pt;
 388         mso-pagination:none;
 389         mso-hyphenate:none;
 390         font-size:12.0pt;
 391         font-family:Thorndale;
 392         mso-fareast-font-family:"Andale Sans UI";
 393         mso-bidi-font-family:"Times New Roman";}
 394 p.MsoBodyTextIndent, li.MsoBodyTextIndent, div.MsoBodyTextIndent
 395         {mso-style-parent:"Body Text";
 396         margin-top:0pt;
 397         margin-right:0pt;
 398         margin-bottom:6.0pt;
 399         margin-left:14.15pt;
 400         mso-pagination:none;
 401         mso-hyphenate:none;
 402         font-size:12.0pt;
 403         font-family:Thorndale;
 404         mso-fareast-font-family:"Andale Sans UI";
 405         mso-bidi-font-family:"Times New Roman";}
 406 p.MsoSubtitle, li.MsoSubtitle, div.MsoSubtitle
 407         {margin-top:7.2pt;
 408         margin-right:0pt;
 409         margin-bottom:3.0pt;
 410         margin-left:0pt;
 411         text-align:center;
 412         mso-pagination:none;
 413         mso-outline-level:2;
 414         mso-hyphenate:none;
 415         font-size:12.0pt;
 416         font-family:Arial;
 417         mso-fareast-font-family:"Andale Sans UI";}
 418 a:link, span.MsoHyperlink
 419         {mso-style-parent:"";
 420         color:navy;
 421         text-decoration:underline;
 422         text-underline:single;}
 423 a:visited, span.MsoHyperlinkFollowed
 424         {mso-style-parent:"";
 425         color:maroon;
 426         text-decoration:underline;
 427         text-underline:single;}
 428 span.Heading4Char
 429         {mso-style-name:"Heading 4 Char";
 430         mso-style-locked:yes;
 431         mso-style-link:"Heading 4";
 432         mso-ansi-font-size:14.0pt;
 433         mso-bidi-font-size:14.0pt;
 434         font-family:"Andale Sans UI";
 435         mso-ascii-font-family:"Andale Sans UI";
 436         mso-fareast-font-family:"Andale Sans UI";
 437         mso-hansi-font-family:"Andale Sans UI";
 438         mso-ansi-language:EN-US;
 439         mso-bidi-language:AR-SA;
 440         font-weight:bold;}
 441 span.BodyTextChar
 442         {mso-style-name:"Body Text Char";
 443         mso-style-locked:yes;
 444         mso-style-link:"Body Text";
 445         mso-ansi-font-size:12.0pt;
 446         mso-bidi-font-size:12.0pt;
 447         font-family:Thorndale;
 448         mso-ascii-font-family:Thorndale;
 449         mso-fareast-font-family:"Andale Sans UI";
 450         mso-hansi-font-family:Thorndale;
 451         mso-ansi-language:EN-US;
 452         mso-bidi-language:AR-SA;}
 453 span.HeadingChar
 454         {mso-style-name:"Heading Char";
 455         mso-style-locked:yes;
 456         mso-style-link:Heading;
 457         mso-ansi-font-size:14.0pt;
 458         mso-bidi-font-size:14.0pt;
 459         font-family:Albany;
 460         mso-ascii-font-family:Albany;
 461         mso-fareast-font-family:"MS Mincho";
 462         mso-hansi-font-family:Albany;
 463         mso-bidi-font-family:Tahoma;
 464         mso-ansi-language:EN-US;
 465         mso-bidi-language:AR-SA;}
 466 p.Heading, li.Heading, div.Heading
 467         {mso-style-name:Heading;
 468         mso-style-link:"Heading Char";
 469         mso-style-next:"Body Text";
 470         margin-top:12.0pt;
 471         margin-right:0pt;
 472         margin-bottom:6.0pt;
 473         margin-left:0pt;
 474         mso-pagination:none;
 475         page-break-after:avoid;
 476         mso-hyphenate:none;
 477         font-size:14.0pt;
 478         font-family:Albany;
 479         mso-fareast-font-family:"MS Mincho";
 480         mso-bidi-font-family:Tahoma;}
 481 p.Caption1, li.Caption1, div.Caption1
 482         {mso-style-name:Caption1;
 483         margin-top:6.0pt;
 484         margin-right:0pt;
 485         margin-bottom:6.0pt;
 486         margin-left:0pt;
 487         mso-pagination:no-line-numbers;
 488         mso-hyphenate:none;
 489         font-size:10.0pt;
 490         font-family:Thorndale;
 491         mso-fareast-font-family:"Andale Sans UI";
 492         mso-bidi-font-family:Tahoma;
 493         font-style:italic;}
 494 p.Index, li.Index, div.Index
 495         {mso-style-name:Index;
 496         margin-top:7.2pt;
 497         margin-right:0pt;
 498         margin-bottom:7.2pt;
 499         margin-left:0pt;
 500         mso-pagination:no-line-numbers;
 501         mso-hyphenate:none;
 502         font-size:12.0pt;
 503         font-family:Thorndale;
 504         mso-fareast-font-family:"Andale Sans UI";
 505         mso-bidi-font-family:Tahoma;}
 506 p.ContentsHeading, li.ContentsHeading, div.ContentsHeading
 507         {mso-style-name:"Contents Heading";
 508         mso-style-parent:Heading;
 509         margin-top:12.0pt;
 510         margin-right:0pt;
 511         margin-bottom:6.0pt;
 512         margin-left:0pt;
 513         mso-pagination:no-line-numbers;
 514         page-break-after:avoid;
 515         mso-hyphenate:none;
 516         font-size:16.0pt;
 517         font-family:Albany;
 518         mso-fareast-font-family:"MS Mincho";
 519         mso-bidi-font-family:Tahoma;
 520         font-weight:bold;}
 521 p.PreformattedText, li.PreformattedText, div.PreformattedText
 522         {mso-style-name:"Preformatted Text";
 523         margin:0pt;
 524         margin-bottom:.0001pt;
 525         mso-pagination:none;
 526         mso-hyphenate:none;
 527         font-size:10.0pt;
 528         font-family:Cumberland;
 529         mso-fareast-font-family:Cumberland;
 530         mso-bidi-font-family:Cumberland;}
 531 p.ListContents, li.ListContents, div.ListContents
 532         {mso-style-name:"List Contents";
 533         margin-top:7.2pt;
 534         margin-right:0pt;
 535         margin-bottom:7.2pt;
 536         margin-left:28.35pt;
 537         mso-pagination:none;
 538         mso-hyphenate:none;
 539         font-size:12.0pt;
 540         font-family:Thorndale;
 541         mso-fareast-font-family:"Andale Sans UI";
 542         mso-bidi-font-family:"Times New Roman";}
 543 p.ListHeading, li.ListHeading, div.ListHeading
 544         {mso-style-name:"List Heading";
 545         mso-style-next:"List Contents";
 546         margin-top:4.3pt;
 547         margin-right:0pt;
 548         margin-bottom:4.3pt;
 549         margin-left:0pt;
 550         mso-pagination:none;
 551         mso-hyphenate:none;
 552         font-size:12.0pt;
 553         font-family:Thorndale;
 554         mso-fareast-font-family:"Andale Sans UI";
 555         mso-bidi-font-family:"Times New Roman";}
 556 p.Header5, li.Header5, div.Header5
 557         {mso-style-name:"Header 5";
 558         margin-top:7.2pt;
 559         margin-right:0pt;
 560         margin-bottom:7.2pt;
 561         margin-left:0pt;
 562         mso-pagination:none;
 563         mso-hyphenate:none;
 564         font-size:12.0pt;
 565         font-family:Thorndale;
 566         mso-fareast-font-family:"Andale Sans UI";
 567         mso-bidi-font-family:"Times New Roman";}
 568 p.Heading3, li.Heading3, div.Heading3
 569         {mso-style-name:Heading3;
 570         margin-top:7.2pt;
 571         margin-right:0pt;
 572         margin-bottom:7.2pt;
 573         margin-left:0pt;
 574         mso-pagination:none;
 575         mso-hyphenate:none;
 576         font-size:12.0pt;
 577         font-family:Thorndale;
 578         mso-fareast-font-family:"Andale Sans UI";
 579         mso-bidi-font-family:"Times New Roman";}
 580 p.Default, li.Default, div.Default
 581         {mso-style-name:Default;
 582         mso-style-parent:"";
 583         margin:0pt;
 584         margin-bottom:.0001pt;
 585         mso-pagination:widow-orphan;
 586         mso-layout-grid-align:none;
 587         text-autospace:none;
 588         font-size:12.0pt;
 589         font-family:Arial;
 590         mso-fareast-font-family:"MS Mincho";
 591         color:black;}
 592 span.NumberingSymbols
 593         {mso-style-name:"Numbering Symbols";
 594         mso-style-parent:"";}
 595 span.Bullets
 596         {mso-style-name:Bullets;
 597         mso-style-parent:"";
 598         mso-ansi-font-size:9.0pt;
 599         mso-bidi-font-size:9.0pt;
 600         font-family:StarSymbol;
 601         mso-ascii-font-family:StarSymbol;
 602         mso-fareast-font-family:StarSymbol;
 603         mso-hansi-font-family:StarSymbol;
 604         mso-bidi-font-family:StarSymbol;}
 605 span.FootnoteCharacters
 606         {mso-style-name:"Footnote Characters";
 607         mso-style-parent:"";}
 608 span.EndnoteCharacters
 609         {mso-style-name:"Endnote Characters";
 610         mso-style-parent:"";}
 611 span.Heading3Char
 612         {mso-style-name:"Heading 3 Char";
 613         mso-style-locked:yes;
 614         mso-style-parent:"Heading Char";
 615         mso-style-link:"Heading 3";
 616         mso-ansi-font-size:14.0pt;
 617         mso-bidi-font-size:14.0pt;
 618         font-family:Albany;
 619         mso-ascii-font-family:Albany;
 620         mso-fareast-font-family:"MS Mincho";
 621         mso-hansi-font-family:Albany;
 622         mso-bidi-font-family:Tahoma;
 623         mso-ansi-language:EN-US;
 624         mso-bidi-language:AR-SA;
 625         font-weight:bold;}
 626  /* Page Definitions */
 627  @page
 628         {mso-footnote-separator:url("relnotes_files/header.htm") fs;
 629         mso-footnote-continuation-separator:url("relnotes_files/header.htm") fcs;
 630         mso-endnote-separator:url("relnotes_files/header.htm") es;
 631         mso-endnote-continuation-separator:url("relnotes_files/header.htm") ecs;
 632         mso-footnote-position:beneath-text;}
 633 @page Section1
 634         {size:612.0pt 792.0pt;
 635         margin:72.0pt 90.0pt 72.0pt 90.0pt;
 636         mso-header-margin:36.0pt;
 637         mso-footer-margin:36.0pt;
 638         mso-paper-source:0;}
 639 div.Section1
 640         {page:Section1;
 641         mso-footnote-position:beneath-text;}
 642 @page Section2
 643         {size:612.0pt 792.0pt;
 644         margin:72.0pt 90.0pt 72.0pt 90.0pt;
 645         mso-header-margin:36.0pt;
 646         mso-footer-margin:36.0pt;
 647         mso-header:url("relnotes_files/header.htm") h2;
 648         mso-paper-source:0;}
 649 div.Section2
 650         {page:Section2;
 651         mso-footnote-position:beneath-text;}
 652  /* List Definitions */
 653  @list l0
 654         {mso-list-id:1;
 655         mso-list-template-ids:1148726518;}
 656 @list l0:level1
 657         {mso-level-tab-stop:18.0pt;
 658         mso-level-number-position:left;
 659         margin-left:18.0pt;
 660         text-indent:-18.0pt;
 661         mso-ansi-font-size:9.0pt;
 662         mso-bidi-font-size:9.0pt;}
 663 @list l0:level2
 664         {mso-level-number-format:bullet;
 665         mso-level-text:\F0B7;
 666         mso-level-tab-stop:28.35pt;
 667         mso-level-number-position:left;
 668         margin-left:28.35pt;
 669         text-indent:-14.15pt;
 670         mso-ansi-font-size:9.0pt;
 671         mso-bidi-font-size:9.0pt;
 672         mso-ascii-font-family:Symbol;
 673         mso-hansi-font-family:Symbol;
 674         mso-bidi-font-family:StarSymbol;}
 675 @list l0:level3
 676         {mso-level-number-format:bullet;
 677         mso-level-text:\F0B7;
 678         mso-level-tab-stop:42.5pt;
 679         mso-level-number-position:left;
 680         margin-left:42.5pt;
 681         text-indent:-14.15pt;
 682         mso-ansi-font-size:9.0pt;
 683         mso-bidi-font-size:9.0pt;
 684         mso-ascii-font-family:Symbol;
 685         mso-hansi-font-family:Symbol;
 686         mso-bidi-font-family:StarSymbol;}
 687 @list l0:level4
 688         {mso-level-number-format:bullet;
 689         mso-level-text:\F0B7;
 690         mso-level-tab-stop:56.7pt;
 691         mso-level-number-position:left;
 692         margin-left:56.7pt;
 693         text-indent:-14.15pt;
 694         mso-ansi-font-size:9.0pt;
 695         mso-bidi-font-size:9.0pt;
 696         mso-ascii-font-family:Symbol;
 697         mso-hansi-font-family:Symbol;
 698         mso-bidi-font-family:StarSymbol;}
 699 @list l0:level5
 700         {mso-level-number-format:bullet;
 701         mso-level-text:\F0B7;
 702         mso-level-tab-stop:70.85pt;
 703         mso-level-number-position:left;
 704         margin-left:70.85pt;
 705         text-indent:-14.15pt;
 706         mso-ansi-font-size:9.0pt;
 707         mso-bidi-font-size:9.0pt;
 708         mso-ascii-font-family:Symbol;
 709         mso-hansi-font-family:Symbol;
 710         mso-bidi-font-family:StarSymbol;}
 711 @list l0:level6
 712         {mso-level-number-format:bullet;
 713         mso-level-text:\F0B7;
 714         mso-level-tab-stop:85.05pt;
 715         mso-level-number-position:left;
 716         margin-left:85.05pt;
 717         text-indent:-14.15pt;
 718         mso-ansi-font-size:9.0pt;
 719         mso-bidi-font-size:9.0pt;
 720         mso-ascii-font-family:Symbol;
 721         mso-hansi-font-family:Symbol;
 722         mso-bidi-font-family:StarSymbol;}
 723 @list l0:level7
 724         {mso-level-number-format:bullet;
 725         mso-level-text:\F0B7;
 726         mso-level-tab-stop:99.2pt;
 727         mso-level-number-position:left;
 728         margin-left:99.2pt;
 729         text-indent:-14.15pt;
 730         mso-ansi-font-size:9.0pt;
 731         mso-bidi-font-size:9.0pt;
 732         mso-ascii-font-family:Symbol;
 733         mso-hansi-font-family:Symbol;
 734         mso-bidi-font-family:StarSymbol;}
 735 @list l0:level8
 736         {mso-level-number-format:bullet;
 737         mso-level-text:\F0B7;
 738         mso-level-tab-stop:113.4pt;
 739         mso-level-number-position:left;
 740         margin-left:113.4pt;
 741         text-indent:-14.15pt;
 742         mso-ansi-font-size:9.0pt;
 743         mso-bidi-font-size:9.0pt;
 744         mso-ascii-font-family:Symbol;
 745         mso-hansi-font-family:Symbol;
 746         mso-bidi-font-family:StarSymbol;}
 747 @list l0:level9
 748         {mso-level-number-format:bullet;
 749         mso-level-text:\F0B7;
 750         mso-level-tab-stop:127.55pt;
 751         mso-level-number-position:left;
 752         margin-left:127.55pt;
 753         text-indent:-14.15pt;
 754         mso-ansi-font-size:9.0pt;
 755         mso-bidi-font-size:9.0pt;
 756         mso-ascii-font-family:Symbol;
 757         mso-hansi-font-family:Symbol;
 758         mso-bidi-font-family:StarSymbol;}
 759 @list l1
 760         {mso-list-id:2;
 761         mso-list-template-ids:2;}
 762 @list l1:level1
 763         {mso-level-number-format:bullet;
 764         mso-level-text:\F0B7;
 765         mso-level-tab-stop:14.15pt;
 766         mso-level-number-position:left;
 767         margin-left:14.15pt;
 768         text-indent:-14.15pt;
 769         mso-ansi-font-size:9.0pt;
 770         mso-bidi-font-size:9.0pt;
 771         mso-ascii-font-family:Symbol;
 772         mso-hansi-font-family:Symbol;
 773         mso-bidi-font-family:StarSymbol;}
 774 @list l1:level2
 775         {mso-level-number-format:bullet;
 776         mso-level-text:\F0B7;
 777         mso-level-tab-stop:28.35pt;
 778         mso-level-number-position:left;
 779         margin-left:28.35pt;
 780         text-indent:-14.15pt;
 781         mso-ansi-font-size:9.0pt;
 782         mso-bidi-font-size:9.0pt;
 783         mso-ascii-font-family:Symbol;
 784         mso-hansi-font-family:Symbol;
 785         mso-bidi-font-family:StarSymbol;}
 786 @list l1:level3
 787         {mso-level-number-format:bullet;
 788         mso-level-text:\F0B7;
 789         mso-level-tab-stop:42.5pt;
 790         mso-level-number-position:left;
 791         margin-left:42.5pt;
 792         text-indent:-14.15pt;
 793         mso-ansi-font-size:9.0pt;
 794         mso-bidi-font-size:9.0pt;
 795         mso-ascii-font-family:Symbol;
 796         mso-hansi-font-family:Symbol;
 797         mso-bidi-font-family:StarSymbol;}
 798 @list l1:level4
 799         {mso-level-number-format:bullet;
 800         mso-level-text:\F0B7;
 801         mso-level-tab-stop:56.7pt;
 802         mso-level-number-position:left;
 803         margin-left:56.7pt;
 804         text-indent:-14.15pt;
 805         mso-ansi-font-size:9.0pt;
 806         mso-bidi-font-size:9.0pt;
 807         mso-ascii-font-family:Symbol;
 808         mso-hansi-font-family:Symbol;
 809         mso-bidi-font-family:StarSymbol;}
 810 @list l1:level5
 811         {mso-level-number-format:bullet;
 812         mso-level-text:\F0B7;
 813         mso-level-tab-stop:70.85pt;
 814         mso-level-number-position:left;
 815         margin-left:70.85pt;
 816         text-indent:-14.15pt;
 817         mso-ansi-font-size:9.0pt;
 818         mso-bidi-font-size:9.0pt;
 819         mso-ascii-font-family:Symbol;
 820         mso-hansi-font-family:Symbol;
 821         mso-bidi-font-family:StarSymbol;}
 822 @list l1:level6
 823         {mso-level-number-format:bullet;
 824         mso-level-text:\F0B7;
 825         mso-level-tab-stop:85.05pt;
 826         mso-level-number-position:left;
 827         margin-left:85.05pt;
 828         text-indent:-14.15pt;
 829         mso-ansi-font-size:9.0pt;
 830         mso-bidi-font-size:9.0pt;
 831         mso-ascii-font-family:Symbol;
 832         mso-hansi-font-family:Symbol;
 833         mso-bidi-font-family:StarSymbol;}
 834 @list l1:level7
 835         {mso-level-number-format:bullet;
 836         mso-level-text:\F0B7;
 837         mso-level-tab-stop:99.2pt;
 838         mso-level-number-position:left;
 839         margin-left:99.2pt;
 840         text-indent:-14.15pt;
 841         mso-ansi-font-size:9.0pt;
 842         mso-bidi-font-size:9.0pt;
 843         mso-ascii-font-family:Symbol;
 844         mso-hansi-font-family:Symbol;
 845         mso-bidi-font-family:StarSymbol;}
 846 @list l1:level8
 847         {mso-level-number-format:bullet;
 848         mso-level-text:\F0B7;
 849         mso-level-tab-stop:113.4pt;
 850         mso-level-number-position:left;
 851         margin-left:113.4pt;
 852         text-indent:-14.15pt;
 853         mso-ansi-font-size:9.0pt;
 854         mso-bidi-font-size:9.0pt;
 855         mso-ascii-font-family:Symbol;
 856         mso-hansi-font-family:Symbol;
 857         mso-bidi-font-family:StarSymbol;}
 858 @list l1:level9
 859         {mso-level-number-format:bullet;
 860         mso-level-text:\F0B7;
 861         mso-level-tab-stop:127.55pt;
 862         mso-level-number-position:left;
 863         margin-left:127.55pt;
 864         text-indent:-14.15pt;
 865         mso-ansi-font-size:9.0pt;
 866         mso-bidi-font-size:9.0pt;
 867         mso-ascii-font-family:Symbol;
 868         mso-hansi-font-family:Symbol;
 869         mso-bidi-font-family:StarSymbol;}
 870 @list l2
 871         {mso-list-id:3;
 872         mso-list-template-ids:3;}
 873 @list l2:level1
 874         {mso-level-number-format:bullet;
 875         mso-level-text:\F0B7;
 876         mso-level-tab-stop:14.15pt;
 877         mso-level-number-position:left;
 878         margin-left:14.15pt;
 879         text-indent:-14.15pt;
 880         mso-ansi-font-size:9.0pt;
 881         mso-bidi-font-size:9.0pt;
 882         mso-ascii-font-family:Symbol;
 883         mso-hansi-font-family:Symbol;
 884         mso-bidi-font-family:StarSymbol;}
 885 @list l2:level2
 886         {mso-level-number-format:bullet;
 887         mso-level-text:\F0B7;
 888         mso-level-tab-stop:28.35pt;
 889         mso-level-number-position:left;
 890         margin-left:28.35pt;
 891         text-indent:-14.15pt;
 892         mso-ansi-font-size:9.0pt;
 893         mso-bidi-font-size:9.0pt;
 894         mso-ascii-font-family:Symbol;
 895         mso-hansi-font-family:Symbol;
 896         mso-bidi-font-family:StarSymbol;}
 897 @list l2:level3
 898         {mso-level-number-format:bullet;
 899         mso-level-text:\F0B7;
 900         mso-level-tab-stop:42.5pt;
 901         mso-level-number-position:left;
 902         margin-left:42.5pt;
 903         text-indent:-14.15pt;
 904         mso-ansi-font-size:9.0pt;
 905         mso-bidi-font-size:9.0pt;
 906         mso-ascii-font-family:Symbol;
 907         mso-hansi-font-family:Symbol;
 908         mso-bidi-font-family:StarSymbol;}
 909 @list l2:level4
 910         {mso-level-number-format:bullet;
 911         mso-level-text:\F0B7;
 912         mso-level-tab-stop:56.7pt;
 913         mso-level-number-position:left;
 914         margin-left:56.7pt;
 915         text-indent:-14.15pt;
 916         mso-ansi-font-size:9.0pt;
 917         mso-bidi-font-size:9.0pt;
 918         mso-ascii-font-family:Symbol;
 919         mso-hansi-font-family:Symbol;
 920         mso-bidi-font-family:StarSymbol;}
 921 @list l2:level5
 922         {mso-level-number-format:bullet;
 923         mso-level-text:\F0B7;
 924         mso-level-tab-stop:70.85pt;
 925         mso-level-number-position:left;
 926         margin-left:70.85pt;
 927         text-indent:-14.15pt;
 928         mso-ansi-font-size:9.0pt;
 929         mso-bidi-font-size:9.0pt;
 930         mso-ascii-font-family:Symbol;
 931         mso-hansi-font-family:Symbol;
 932         mso-bidi-font-family:StarSymbol;}
 933 @list l2:level6
 934         {mso-level-number-format:bullet;
 935         mso-level-text:\F0B7;
 936         mso-level-tab-stop:85.05pt;
 937         mso-level-number-position:left;
 938         margin-left:85.05pt;
 939         text-indent:-14.15pt;
 940         mso-ansi-font-size:9.0pt;
 941         mso-bidi-font-size:9.0pt;
 942         mso-ascii-font-family:Symbol;
 943         mso-hansi-font-family:Symbol;
 944         mso-bidi-font-family:StarSymbol;}
 945 @list l2:level7
 946         {mso-level-number-format:bullet;
 947         mso-level-text:\F0B7;
 948         mso-level-tab-stop:99.2pt;
 949         mso-level-number-position:left;
 950         margin-left:99.2pt;
 951         text-indent:-14.15pt;
 952         mso-ansi-font-size:9.0pt;
 953         mso-bidi-font-size:9.0pt;
 954         mso-ascii-font-family:Symbol;
 955         mso-hansi-font-family:Symbol;
 956         mso-bidi-font-family:StarSymbol;}
 957 @list l2:level8
 958         {mso-level-number-format:bullet;
 959         mso-level-text:\F0B7;
 960         mso-level-tab-stop:113.4pt;
 961         mso-level-number-position:left;
 962         margin-left:113.4pt;
 963         text-indent:-14.15pt;
 964         mso-ansi-font-size:9.0pt;
 965         mso-bidi-font-size:9.0pt;
 966         mso-ascii-font-family:Symbol;
 967         mso-hansi-font-family:Symbol;
 968         mso-bidi-font-family:StarSymbol;}
 969 @list l2:level9
 970         {mso-level-number-format:bullet;
 971         mso-level-text:\F0B7;
 972         mso-level-tab-stop:127.55pt;
 973         mso-level-number-position:left;
 974         margin-left:127.55pt;
 975         text-indent:-14.15pt;
 976         mso-ansi-font-size:9.0pt;
 977         mso-bidi-font-size:9.0pt;
 978         mso-ascii-font-family:Symbol;
 979         mso-hansi-font-family:Symbol;
 980         mso-bidi-font-family:StarSymbol;}
 981 @list l3
 982         {mso-list-id:4;
 983         mso-list-template-ids:4;}
 984 @list l3:level1
 985         {mso-level-number-format:bullet;
 986         mso-level-text:\F0B7;
 987         mso-level-tab-stop:14.15pt;
 988         mso-level-number-position:left;
 989         margin-left:14.15pt;
 990         text-indent:-14.15pt;
 991         mso-ansi-font-size:9.0pt;
 992         mso-bidi-font-size:9.0pt;
 993         mso-ascii-font-family:Symbol;
 994         mso-hansi-font-family:Symbol;
 995         mso-bidi-font-family:StarSymbol;}
 996 @list l3:level2
 997         {mso-level-number-format:bullet;
 998         mso-level-text:\F0B7;
 999         mso-level-tab-stop:28.35pt;
1000         mso-level-number-position:left;
1001         margin-left:28.35pt;
1002         text-indent:-14.15pt;
1003         mso-ansi-font-size:9.0pt;
1004         mso-bidi-font-size:9.0pt;
1005         mso-ascii-font-family:Symbol;
1006         mso-hansi-font-family:Symbol;
1007         mso-bidi-font-family:StarSymbol;}
1008 @list l3:level3
1009         {mso-level-number-format:bullet;
1010         mso-level-text:\F0B7;
1011         mso-level-tab-stop:42.5pt;
1012         mso-level-number-position:left;
1013         margin-left:42.5pt;
1014         text-indent:-14.15pt;
1015         mso-ansi-font-size:9.0pt;
1016         mso-bidi-font-size:9.0pt;
1017         mso-ascii-font-family:Symbol;
1018         mso-hansi-font-family:Symbol;
1019         mso-bidi-font-family:StarSymbol;}
1020 @list l3:level4
1021         {mso-level-number-format:bullet;
1022         mso-level-text:\F0B7;
1023         mso-level-tab-stop:56.7pt;
1024         mso-level-number-position:left;
1025         margin-left:56.7pt;
1026         text-indent:-14.15pt;
1027         mso-ansi-font-size:9.0pt;
1028         mso-bidi-font-size:9.0pt;
1029         mso-ascii-font-family:Symbol;
1030         mso-hansi-font-family:Symbol;
1031         mso-bidi-font-family:StarSymbol;}
1032 @list l3:level5
1033         {mso-level-number-format:bullet;
1034         mso-level-text:\F0B7;
1035         mso-level-tab-stop:70.85pt;
1036         mso-level-number-position:left;
1037         margin-left:70.85pt;
1038         text-indent:-14.15pt;
1039         mso-ansi-font-size:9.0pt;
1040         mso-bidi-font-size:9.0pt;
1041         mso-ascii-font-family:Symbol;
1042         mso-hansi-font-family:Symbol;
1043         mso-bidi-font-family:StarSymbol;}
1044 @list l3:level6
1045         {mso-level-number-format:bullet;
1046         mso-level-text:\F0B7;
1047         mso-level-tab-stop:85.05pt;
1048         mso-level-number-position:left;
1049         margin-left:85.05pt;
1050         text-indent:-14.15pt;
1051         mso-ansi-font-size:9.0pt;
1052         mso-bidi-font-size:9.0pt;
1053         mso-ascii-font-family:Symbol;
1054         mso-hansi-font-family:Symbol;
1055         mso-bidi-font-family:StarSymbol;}
1056 @list l3:level7
1057         {mso-level-number-format:bullet;
1058         mso-level-text:\F0B7;
1059         mso-level-tab-stop:99.2pt;
1060         mso-level-number-position:left;
1061         margin-left:99.2pt;
1062         text-indent:-14.15pt;
1063         mso-ansi-font-size:9.0pt;
1064         mso-bidi-font-size:9.0pt;
1065         mso-ascii-font-family:Symbol;
1066         mso-hansi-font-family:Symbol;
1067         mso-bidi-font-family:StarSymbol;}
1068 @list l3:level8
1069         {mso-level-number-format:bullet;
1070         mso-level-text:\F0B7;
1071         mso-level-tab-stop:113.4pt;
1072         mso-level-number-position:left;
1073         margin-left:113.4pt;
1074         text-indent:-14.15pt;
1075         mso-ansi-font-size:9.0pt;
1076         mso-bidi-font-size:9.0pt;
1077         mso-ascii-font-family:Symbol;
1078         mso-hansi-font-family:Symbol;
1079         mso-bidi-font-family:StarSymbol;}
1080 @list l3:level9
1081         {mso-level-number-format:bullet;
1082         mso-level-text:\F0B7;
1083         mso-level-tab-stop:127.55pt;
1084         mso-level-number-position:left;
1085         margin-left:127.55pt;
1086         text-indent:-14.15pt;
1087         mso-ansi-font-size:9.0pt;
1088         mso-bidi-font-size:9.0pt;
1089         mso-ascii-font-family:Symbol;
1090         mso-hansi-font-family:Symbol;
1091         mso-bidi-font-family:StarSymbol;}
1092 @list l4
1093         {mso-list-id:5;
1094         mso-list-template-ids:5;}
1095 @list l4:level1
1096         {mso-level-number-format:bullet;
1097         mso-level-text:\F0B7;
1098         mso-level-tab-stop:14.15pt;
1099         mso-level-number-position:left;
1100         margin-left:14.15pt;
1101         text-indent:-14.15pt;
1102         mso-ansi-font-size:9.0pt;
1103         mso-bidi-font-size:9.0pt;
1104         mso-ascii-font-family:Symbol;
1105         mso-hansi-font-family:Symbol;
1106         mso-bidi-font-family:StarSymbol;}
1107 @list l4:level2
1108         {mso-level-number-format:bullet;
1109         mso-level-text:\F0B7;
1110         mso-level-tab-stop:28.35pt;
1111         mso-level-number-position:left;
1112         margin-left:28.35pt;
1113         text-indent:-14.15pt;
1114         mso-ansi-font-size:9.0pt;
1115         mso-bidi-font-size:9.0pt;
1116         mso-ascii-font-family:Symbol;
1117         mso-hansi-font-family:Symbol;
1118         mso-bidi-font-family:StarSymbol;}
1119 @list l4:level3
1120         {mso-level-number-format:bullet;
1121         mso-level-text:\F0B7;
1122         mso-level-tab-stop:42.5pt;
1123         mso-level-number-position:left;
1124         margin-left:42.5pt;
1125         text-indent:-14.15pt;
1126         mso-ansi-font-size:9.0pt;
1127         mso-bidi-font-size:9.0pt;
1128         mso-ascii-font-family:Symbol;
1129         mso-hansi-font-family:Symbol;
1130         mso-bidi-font-family:StarSymbol;}
1131 @list l4:level4
1132         {mso-level-number-format:bullet;
1133         mso-level-text:\F0B7;
1134         mso-level-tab-stop:56.7pt;
1135         mso-level-number-position:left;
1136         margin-left:56.7pt;
1137         text-indent:-14.15pt;
1138         mso-ansi-font-size:9.0pt;
1139         mso-bidi-font-size:9.0pt;
1140         mso-ascii-font-family:Symbol;
1141         mso-hansi-font-family:Symbol;
1142         mso-bidi-font-family:StarSymbol;}
1143 @list l4:level5
1144         {mso-level-number-format:bullet;
1145         mso-level-text:\F0B7;
1146         mso-level-tab-stop:70.85pt;
1147         mso-level-number-position:left;
1148         margin-left:70.85pt;
1149         text-indent:-14.15pt;
1150         mso-ansi-font-size:9.0pt;
1151         mso-bidi-font-size:9.0pt;
1152         mso-ascii-font-family:Symbol;
1153         mso-hansi-font-family:Symbol;
1154         mso-bidi-font-family:StarSymbol;}
1155 @list l4:level6
1156         {mso-level-number-format:bullet;
1157         mso-level-text:\F0B7;
1158         mso-level-tab-stop:85.05pt;
1159         mso-level-number-position:left;
1160         margin-left:85.05pt;
1161         text-indent:-14.15pt;
1162         mso-ansi-font-size:9.0pt;
1163         mso-bidi-font-size:9.0pt;
1164         mso-ascii-font-family:Symbol;
1165         mso-hansi-font-family:Symbol;
1166         mso-bidi-font-family:StarSymbol;}
1167 @list l4:level7
1168         {mso-level-number-format:bullet;
1169         mso-level-text:\F0B7;
1170         mso-level-tab-stop:99.2pt;
1171         mso-level-number-position:left;
1172         margin-left:99.2pt;
1173         text-indent:-14.15pt;
1174         mso-ansi-font-size:9.0pt;
1175         mso-bidi-font-size:9.0pt;
1176         mso-ascii-font-family:Symbol;
1177         mso-hansi-font-family:Symbol;
1178         mso-bidi-font-family:StarSymbol;}
1179 @list l4:level8
1180         {mso-level-number-format:bullet;
1181         mso-level-text:\F0B7;
1182         mso-level-tab-stop:113.4pt;
1183         mso-level-number-position:left;
1184         margin-left:113.4pt;
1185         text-indent:-14.15pt;
1186         mso-ansi-font-size:9.0pt;
1187         mso-bidi-font-size:9.0pt;
1188         mso-ascii-font-family:Symbol;
1189         mso-hansi-font-family:Symbol;
1190         mso-bidi-font-family:StarSymbol;}
1191 @list l4:level9
1192         {mso-level-number-format:bullet;
1193         mso-level-text:\F0B7;
1194         mso-level-tab-stop:127.55pt;
1195         mso-level-number-position:left;
1196         margin-left:127.55pt;
1197         text-indent:-14.15pt;
1198         mso-ansi-font-size:9.0pt;
1199         mso-bidi-font-size:9.0pt;
1200         mso-ascii-font-family:Symbol;
1201         mso-hansi-font-family:Symbol;
1202         mso-bidi-font-family:StarSymbol;}
1203 @list l5
1204         {mso-list-id:6;
1205         mso-list-template-ids:6;}
1206 @list l5:level1
1207         {mso-level-number-format:bullet;
1208         mso-level-text:\F0B7;
1209         mso-level-tab-stop:14.15pt;
1210         mso-level-number-position:left;
1211         margin-left:14.15pt;
1212         text-indent:-14.15pt;
1213         mso-ansi-font-size:9.0pt;
1214         mso-bidi-font-size:9.0pt;
1215         mso-ascii-font-family:Symbol;
1216         mso-hansi-font-family:Symbol;
1217         mso-bidi-font-family:StarSymbol;}
1218 @list l5:level2
1219         {mso-level-number-format:bullet;
1220         mso-level-text:\F0B7;
1221         mso-level-tab-stop:28.35pt;
1222         mso-level-number-position:left;
1223         margin-left:28.35pt;
1224         text-indent:-14.15pt;
1225         mso-ansi-font-size:9.0pt;
1226         mso-bidi-font-size:9.0pt;
1227         mso-ascii-font-family:Symbol;
1228         mso-hansi-font-family:Symbol;
1229         mso-bidi-font-family:StarSymbol;}
1230 @list l5:level3
1231         {mso-level-number-format:bullet;
1232         mso-level-text:\F0B7;
1233         mso-level-tab-stop:42.5pt;
1234         mso-level-number-position:left;
1235         margin-left:42.5pt;
1236         text-indent:-14.15pt;
1237         mso-ansi-font-size:9.0pt;
1238         mso-bidi-font-size:9.0pt;
1239         mso-ascii-font-family:Symbol;
1240         mso-hansi-font-family:Symbol;
1241         mso-bidi-font-family:StarSymbol;}
1242 @list l5:level4
1243         {mso-level-number-format:bullet;
1244         mso-level-text:\F0B7;
1245         mso-level-tab-stop:56.7pt;
1246         mso-level-number-position:left;
1247         margin-left:56.7pt;
1248         text-indent:-14.15pt;
1249         mso-ansi-font-size:9.0pt;
1250         mso-bidi-font-size:9.0pt;
1251         mso-ascii-font-family:Symbol;
1252         mso-hansi-font-family:Symbol;
1253         mso-bidi-font-family:StarSymbol;}
1254 @list l5:level5
1255         {mso-level-number-format:bullet;
1256         mso-level-text:\F0B7;
1257         mso-level-tab-stop:70.85pt;
1258         mso-level-number-position:left;
1259         margin-left:70.85pt;
1260         text-indent:-14.15pt;
1261         mso-ansi-font-size:9.0pt;
1262         mso-bidi-font-size:9.0pt;
1263         mso-ascii-font-family:Symbol;
1264         mso-hansi-font-family:Symbol;
1265         mso-bidi-font-family:StarSymbol;}
1266 @list l5:level6
1267         {mso-level-number-format:bullet;
1268         mso-level-text:\F0B7;
1269         mso-level-tab-stop:85.05pt;
1270         mso-level-number-position:left;
1271         margin-left:85.05pt;
1272         text-indent:-14.15pt;
1273         mso-ansi-font-size:9.0pt;
1274         mso-bidi-font-size:9.0pt;
1275         mso-ascii-font-family:Symbol;
1276         mso-hansi-font-family:Symbol;
1277         mso-bidi-font-family:StarSymbol;}
1278 @list l5:level7
1279         {mso-level-number-format:bullet;
1280         mso-level-text:\F0B7;
1281         mso-level-tab-stop:99.2pt;
1282         mso-level-number-position:left;
1283         margin-left:99.2pt;
1284         text-indent:-14.15pt;
1285         mso-ansi-font-size:9.0pt;
1286         mso-bidi-font-size:9.0pt;
1287         mso-ascii-font-family:Symbol;
1288         mso-hansi-font-family:Symbol;
1289         mso-bidi-font-family:StarSymbol;}
1290 @list l5:level8
1291         {mso-level-number-format:bullet;
1292         mso-level-text:\F0B7;
1293         mso-level-tab-stop:113.4pt;
1294         mso-level-number-position:left;
1295         margin-left:113.4pt;
1296         text-indent:-14.15pt;
1297         mso-ansi-font-size:9.0pt;
1298         mso-bidi-font-size:9.0pt;
1299         mso-ascii-font-family:Symbol;
1300         mso-hansi-font-family:Symbol;
1301         mso-bidi-font-family:StarSymbol;}
1302 @list l5:level9
1303         {mso-level-number-format:bullet;
1304         mso-level-text:\F0B7;
1305         mso-level-tab-stop:127.55pt;
1306         mso-level-number-position:left;
1307         margin-left:127.55pt;
1308         text-indent:-14.15pt;
1309         mso-ansi-font-size:9.0pt;
1310         mso-bidi-font-size:9.0pt;
1311         mso-ascii-font-family:Symbol;
1312         mso-hansi-font-family:Symbol;
1313         mso-bidi-font-family:StarSymbol;}
1314 @list l6
1315         {mso-list-id:7;
1316         mso-list-template-ids:7;}
1317 @list l6:level1
1318         {mso-level-number-format:bullet;
1319         mso-level-text:\F0B7;
1320         mso-level-tab-stop:14.15pt;
1321         mso-level-number-position:left;
1322         margin-left:14.15pt;
1323         text-indent:-14.15pt;
1324         mso-ansi-font-size:9.0pt;
1325         mso-bidi-font-size:9.0pt;
1326         mso-ascii-font-family:Symbol;
1327         mso-hansi-font-family:Symbol;
1328         mso-bidi-font-family:StarSymbol;}
1329 @list l6:level2
1330         {mso-level-number-format:bullet;
1331         mso-level-text:\F0B7;
1332         mso-level-tab-stop:28.35pt;
1333         mso-level-number-position:left;
1334         margin-left:28.35pt;
1335         text-indent:-14.15pt;
1336         mso-ansi-font-size:9.0pt;
1337         mso-bidi-font-size:9.0pt;
1338         mso-ascii-font-family:Symbol;
1339         mso-hansi-font-family:Symbol;
1340         mso-bidi-font-family:StarSymbol;}
1341 @list l6:level3
1342         {mso-level-number-format:bullet;
1343         mso-level-text:\F0B7;
1344         mso-level-tab-stop:42.5pt;
1345         mso-level-number-position:left;
1346         margin-left:42.5pt;
1347         text-indent:-14.15pt;
1348         mso-ansi-font-size:9.0pt;
1349         mso-bidi-font-size:9.0pt;
1350         mso-ascii-font-family:Symbol;
1351         mso-hansi-font-family:Symbol;
1352         mso-bidi-font-family:StarSymbol;}
1353 @list l6:level4
1354         {mso-level-number-format:bullet;
1355         mso-level-text:\F0B7;
1356         mso-level-tab-stop:56.7pt;
1357         mso-level-number-position:left;
1358         margin-left:56.7pt;
1359         text-indent:-14.15pt;
1360         mso-ansi-font-size:9.0pt;
1361         mso-bidi-font-size:9.0pt;
1362         mso-ascii-font-family:Symbol;
1363         mso-hansi-font-family:Symbol;
1364         mso-bidi-font-family:StarSymbol;}
1365 @list l6:level5
1366         {mso-level-number-format:bullet;
1367         mso-level-text:\F0B7;
1368         mso-level-tab-stop:70.85pt;
1369         mso-level-number-position:left;
1370         margin-left:70.85pt;
1371         text-indent:-14.15pt;
1372         mso-ansi-font-size:9.0pt;
1373         mso-bidi-font-size:9.0pt;
1374         mso-ascii-font-family:Symbol;
1375         mso-hansi-font-family:Symbol;
1376         mso-bidi-font-family:StarSymbol;}
1377 @list l6:level6
1378         {mso-level-number-format:bullet;
1379         mso-level-text:\F0B7;
1380         mso-level-tab-stop:85.05pt;
1381         mso-level-number-position:left;
1382         margin-left:85.05pt;
1383         text-indent:-14.15pt;
1384         mso-ansi-font-size:9.0pt;
1385         mso-bidi-font-size:9.0pt;
1386         mso-ascii-font-family:Symbol;
1387         mso-hansi-font-family:Symbol;
1388         mso-bidi-font-family:StarSymbol;}
1389 @list l6:level7
1390         {mso-level-number-format:bullet;
1391         mso-level-text:\F0B7;
1392         mso-level-tab-stop:99.2pt;
1393         mso-level-number-position:left;
1394         margin-left:99.2pt;
1395         text-indent:-14.15pt;
1396         mso-ansi-font-size:9.0pt;
1397         mso-bidi-font-size:9.0pt;
1398         mso-ascii-font-family:Symbol;
1399         mso-hansi-font-family:Symbol;
1400         mso-bidi-font-family:StarSymbol;}
1401 @list l6:level8
1402         {mso-level-number-format:bullet;
1403         mso-level-text:\F0B7;
1404         mso-level-tab-stop:113.4pt;
1405         mso-level-number-position:left;
1406         margin-left:113.4pt;
1407         text-indent:-14.15pt;
1408         mso-ansi-font-size:9.0pt;
1409         mso-bidi-font-size:9.0pt;
1410         mso-ascii-font-family:Symbol;
1411         mso-hansi-font-family:Symbol;
1412         mso-bidi-font-family:StarSymbol;}
1413 @list l6:level9
1414         {mso-level-number-format:bullet;
1415         mso-level-text:\F0B7;
1416         mso-level-tab-stop:127.55pt;
1417         mso-level-number-position:left;
1418         margin-left:127.55pt;
1419         text-indent:-14.15pt;
1420         mso-ansi-font-size:9.0pt;
1421         mso-bidi-font-size:9.0pt;
1422         mso-ascii-font-family:Symbol;
1423         mso-hansi-font-family:Symbol;
1424         mso-bidi-font-family:StarSymbol;}
1425 @list l7
1426         {mso-list-id:8;
1427         mso-list-template-ids:8;}
1428 @list l7:level1
1429         {mso-level-number-format:bullet;
1430         mso-level-text:\F0B7;
1431         mso-level-tab-stop:14.15pt;
1432         mso-level-number-position:left;
1433         margin-left:14.15pt;
1434         text-indent:-14.15pt;
1435         mso-ansi-font-size:9.0pt;
1436         mso-bidi-font-size:9.0pt;
1437         mso-ascii-font-family:Symbol;
1438         mso-hansi-font-family:Symbol;
1439         mso-bidi-font-family:StarSymbol;}
1440 @list l7:level2
1441         {mso-level-number-format:bullet;
1442         mso-level-text:\F0B7;
1443         mso-level-tab-stop:28.35pt;
1444         mso-level-number-position:left;
1445         margin-left:28.35pt;
1446         text-indent:-14.15pt;
1447         mso-ansi-font-size:9.0pt;
1448         mso-bidi-font-size:9.0pt;
1449         mso-ascii-font-family:Symbol;
1450         mso-hansi-font-family:Symbol;
1451         mso-bidi-font-family:StarSymbol;}
1452 @list l7:level3
1453         {mso-level-number-format:bullet;
1454         mso-level-text:\F0B7;
1455         mso-level-tab-stop:42.5pt;
1456         mso-level-number-position:left;
1457         margin-left:42.5pt;
1458         text-indent:-14.15pt;
1459         mso-ansi-font-size:9.0pt;
1460         mso-bidi-font-size:9.0pt;
1461         mso-ascii-font-family:Symbol;
1462         mso-hansi-font-family:Symbol;
1463         mso-bidi-font-family:StarSymbol;}
1464 @list l7:level4
1465         {mso-level-number-format:bullet;
1466         mso-level-text:\F0B7;
1467         mso-level-tab-stop:56.7pt;
1468         mso-level-number-position:left;
1469         margin-left:56.7pt;
1470         text-indent:-14.15pt;
1471         mso-ansi-font-size:9.0pt;
1472         mso-bidi-font-size:9.0pt;
1473         mso-ascii-font-family:Symbol;
1474         mso-hansi-font-family:Symbol;
1475         mso-bidi-font-family:StarSymbol;}
1476 @list l7:level5
1477         {mso-level-number-format:bullet;
1478         mso-level-text:\F0B7;
1479         mso-level-tab-stop:70.85pt;
1480         mso-level-number-position:left;
1481         margin-left:70.85pt;
1482         text-indent:-14.15pt;
1483         mso-ansi-font-size:9.0pt;
1484         mso-bidi-font-size:9.0pt;
1485         mso-ascii-font-family:Symbol;
1486         mso-hansi-font-family:Symbol;
1487         mso-bidi-font-family:StarSymbol;}
1488 @list l7:level6
1489         {mso-level-number-format:bullet;
1490         mso-level-text:\F0B7;
1491         mso-level-tab-stop:85.05pt;
1492         mso-level-number-position:left;
1493         margin-left:85.05pt;
1494         text-indent:-14.15pt;
1495         mso-ansi-font-size:9.0pt;
1496         mso-bidi-font-size:9.0pt;
1497         mso-ascii-font-family:Symbol;
1498         mso-hansi-font-family:Symbol;
1499         mso-bidi-font-family:StarSymbol;}
1500 @list l7:level7
1501         {mso-level-number-format:bullet;
1502         mso-level-text:\F0B7;
1503         mso-level-tab-stop:99.2pt;
1504         mso-level-number-position:left;
1505         margin-left:99.2pt;
1506         text-indent:-14.15pt;
1507         mso-ansi-font-size:9.0pt;
1508         mso-bidi-font-size:9.0pt;
1509         mso-ascii-font-family:Symbol;
1510         mso-hansi-font-family:Symbol;
1511         mso-bidi-font-family:StarSymbol;}
1512 @list l7:level8
1513         {mso-level-number-format:bullet;
1514         mso-level-text:\F0B7;
1515         mso-level-tab-stop:113.4pt;
1516         mso-level-number-position:left;
1517         margin-left:113.4pt;
1518         text-indent:-14.15pt;
1519         mso-ansi-font-size:9.0pt;
1520         mso-bidi-font-size:9.0pt;
1521         mso-ascii-font-family:Symbol;
1522         mso-hansi-font-family:Symbol;
1523         mso-bidi-font-family:StarSymbol;}
1524 @list l7:level9
1525         {mso-level-number-format:bullet;
1526         mso-level-text:\F0B7;
1527         mso-level-tab-stop:127.55pt;
1528         mso-level-number-position:left;
1529         margin-left:127.55pt;
1530         text-indent:-14.15pt;
1531         mso-ansi-font-size:9.0pt;
1532         mso-bidi-font-size:9.0pt;
1533         mso-ascii-font-family:Symbol;
1534         mso-hansi-font-family:Symbol;
1535         mso-bidi-font-family:StarSymbol;}
1536 @list l8
1537         {mso-list-id:9;
1538         mso-list-template-ids:9;}
1539 @list l8:level1
1540         {mso-level-number-format:bullet;
1541         mso-level-text:\F0B7;
1542         mso-level-tab-stop:14.15pt;
1543         mso-level-number-position:left;
1544         margin-left:14.15pt;
1545         text-indent:-14.15pt;
1546         mso-ansi-font-size:9.0pt;
1547         mso-bidi-font-size:9.0pt;
1548         mso-ascii-font-family:Symbol;
1549         mso-hansi-font-family:Symbol;
1550         mso-bidi-font-family:StarSymbol;}
1551 @list l8:level2
1552         {mso-level-number-format:bullet;
1553         mso-level-text:\F0B7;
1554         mso-level-tab-stop:28.35pt;
1555         mso-level-number-position:left;
1556         margin-left:28.35pt;
1557         text-indent:-14.15pt;
1558         mso-ansi-font-size:9.0pt;
1559         mso-bidi-font-size:9.0pt;
1560         mso-ascii-font-family:Symbol;
1561         mso-hansi-font-family:Symbol;
1562         mso-bidi-font-family:StarSymbol;}
1563 @list l8:level3
1564         {mso-level-number-format:bullet;
1565         mso-level-text:\F0B7;
1566         mso-level-tab-stop:42.5pt;
1567         mso-level-number-position:left;
1568         margin-left:42.5pt;
1569         text-indent:-14.15pt;
1570         mso-ansi-font-size:9.0pt;
1571         mso-bidi-font-size:9.0pt;
1572         mso-ascii-font-family:Symbol;
1573         mso-hansi-font-family:Symbol;
1574         mso-bidi-font-family:StarSymbol;}
1575 @list l8:level4
1576         {mso-level-number-format:bullet;
1577         mso-level-text:\F0B7;
1578         mso-level-tab-stop:56.7pt;
1579         mso-level-number-position:left;
1580         margin-left:56.7pt;
1581         text-indent:-14.15pt;
1582         mso-ansi-font-size:9.0pt;
1583         mso-bidi-font-size:9.0pt;
1584         mso-ascii-font-family:Symbol;
1585         mso-hansi-font-family:Symbol;
1586         mso-bidi-font-family:StarSymbol;}
1587 @list l8:level5
1588         {mso-level-number-format:bullet;
1589         mso-level-text:\F0B7;
1590         mso-level-tab-stop:70.85pt;
1591         mso-level-number-position:left;
1592         margin-left:70.85pt;
1593         text-indent:-14.15pt;
1594         mso-ansi-font-size:9.0pt;
1595         mso-bidi-font-size:9.0pt;
1596         mso-ascii-font-family:Symbol;
1597         mso-hansi-font-family:Symbol;
1598         mso-bidi-font-family:StarSymbol;}
1599 @list l8:level6
1600         {mso-level-number-format:bullet;
1601         mso-level-text:\F0B7;
1602         mso-level-tab-stop:85.05pt;
1603         mso-level-number-position:left;
1604         margin-left:85.05pt;
1605         text-indent:-14.15pt;
1606         mso-ansi-font-size:9.0pt;
1607         mso-bidi-font-size:9.0pt;
1608         mso-ascii-font-family:Symbol;
1609         mso-hansi-font-family:Symbol;
1610         mso-bidi-font-family:StarSymbol;}
1611 @list l8:level7
1612         {mso-level-number-format:bullet;
1613         mso-level-text:\F0B7;
1614         mso-level-tab-stop:99.2pt;
1615         mso-level-number-position:left;
1616         margin-left:99.2pt;
1617         text-indent:-14.15pt;
1618         mso-ansi-font-size:9.0pt;
1619         mso-bidi-font-size:9.0pt;
1620         mso-ascii-font-family:Symbol;
1621         mso-hansi-font-family:Symbol;
1622         mso-bidi-font-family:StarSymbol;}
1623 @list l8:level8
1624         {mso-level-number-format:bullet;
1625         mso-level-text:\F0B7;
1626         mso-level-tab-stop:113.4pt;
1627         mso-level-number-position:left;
1628         margin-left:113.4pt;
1629         text-indent:-14.15pt;
1630         mso-ansi-font-size:9.0pt;
1631         mso-bidi-font-size:9.0pt;
1632         mso-ascii-font-family:Symbol;
1633         mso-hansi-font-family:Symbol;
1634         mso-bidi-font-family:StarSymbol;}
1635 @list l8:level9
1636         {mso-level-number-format:bullet;
1637         mso-level-text:\F0B7;
1638         mso-level-tab-stop:127.55pt;
1639         mso-level-number-position:left;
1640         margin-left:127.55pt;
1641         text-indent:-14.15pt;
1642         mso-ansi-font-size:9.0pt;
1643         mso-bidi-font-size:9.0pt;
1644         mso-ascii-font-family:Symbol;
1645         mso-hansi-font-family:Symbol;
1646         mso-bidi-font-family:StarSymbol;}
1647 @list l9
1648         {mso-list-id:10;
1649         mso-list-template-ids:10;}
1650 @list l9:level1
1651         {mso-level-number-format:bullet;
1652         mso-level-text:\F0B7;
1653         mso-level-tab-stop:14.15pt;
1654         mso-level-number-position:left;
1655         margin-left:14.15pt;
1656         text-indent:-14.15pt;
1657         mso-ansi-font-size:9.0pt;
1658         mso-bidi-font-size:9.0pt;
1659         mso-ascii-font-family:Symbol;
1660         mso-hansi-font-family:Symbol;
1661         mso-bidi-font-family:StarSymbol;}
1662 @list l9:level2
1663         {mso-level-number-format:bullet;
1664         mso-level-text:\F0B7;
1665         mso-level-tab-stop:28.35pt;
1666         mso-level-number-position:left;
1667         margin-left:28.35pt;
1668         text-indent:-14.15pt;
1669         mso-ansi-font-size:9.0pt;
1670         mso-bidi-font-size:9.0pt;
1671         mso-ascii-font-family:Symbol;
1672         mso-hansi-font-family:Symbol;
1673         mso-bidi-font-family:StarSymbol;}
1674 @list l9:level3
1675         {mso-level-number-format:bullet;
1676         mso-level-text:\F0B7;
1677         mso-level-tab-stop:42.5pt;
1678         mso-level-number-position:left;
1679         margin-left:42.5pt;
1680         text-indent:-14.15pt;
1681         mso-ansi-font-size:9.0pt;
1682         mso-bidi-font-size:9.0pt;
1683         mso-ascii-font-family:Symbol;
1684         mso-hansi-font-family:Symbol;
1685         mso-bidi-font-family:StarSymbol;}
1686 @list l9:level4
1687         {mso-level-number-format:bullet;
1688         mso-level-text:\F0B7;
1689         mso-level-tab-stop:56.7pt;
1690         mso-level-number-position:left;
1691         margin-left:56.7pt;
1692         text-indent:-14.15pt;
1693         mso-ansi-font-size:9.0pt;
1694         mso-bidi-font-size:9.0pt;
1695         mso-ascii-font-family:Symbol;
1696         mso-hansi-font-family:Symbol;
1697         mso-bidi-font-family:StarSymbol;}
1698 @list l9:level5
1699         {mso-level-number-format:bullet;
1700         mso-level-text:\F0B7;
1701         mso-level-tab-stop:70.85pt;
1702         mso-level-number-position:left;
1703         margin-left:70.85pt;
1704         text-indent:-14.15pt;
1705         mso-ansi-font-size:9.0pt;
1706         mso-bidi-font-size:9.0pt;
1707         mso-ascii-font-family:Symbol;
1708         mso-hansi-font-family:Symbol;
1709         mso-bidi-font-family:StarSymbol;}
1710 @list l9:level6
1711         {mso-level-number-format:bullet;
1712         mso-level-text:\F0B7;
1713         mso-level-tab-stop:85.05pt;
1714         mso-level-number-position:left;
1715         margin-left:85.05pt;
1716         text-indent:-14.15pt;
1717         mso-ansi-font-size:9.0pt;
1718         mso-bidi-font-size:9.0pt;
1719         mso-ascii-font-family:Symbol;
1720         mso-hansi-font-family:Symbol;
1721         mso-bidi-font-family:StarSymbol;}
1722 @list l9:level7
1723         {mso-level-number-format:bullet;
1724         mso-level-text:\F0B7;
1725         mso-level-tab-stop:99.2pt;
1726         mso-level-number-position:left;
1727         margin-left:99.2pt;
1728         text-indent:-14.15pt;
1729         mso-ansi-font-size:9.0pt;
1730         mso-bidi-font-size:9.0pt;
1731         mso-ascii-font-family:Symbol;
1732         mso-hansi-font-family:Symbol;
1733         mso-bidi-font-family:StarSymbol;}
1734 @list l9:level8
1735         {mso-level-number-format:bullet;
1736         mso-level-text:\F0B7;
1737         mso-level-tab-stop:113.4pt;
1738         mso-level-number-position:left;
1739         margin-left:113.4pt;
1740         text-indent:-14.15pt;
1741         mso-ansi-font-size:9.0pt;
1742         mso-bidi-font-size:9.0pt;
1743         mso-ascii-font-family:Symbol;
1744         mso-hansi-font-family:Symbol;
1745         mso-bidi-font-family:StarSymbol;}
1746 @list l9:level9
1747         {mso-level-number-format:bullet;
1748         mso-level-text:\F0B7;
1749         mso-level-tab-stop:127.55pt;
1750         mso-level-number-position:left;
1751         margin-left:127.55pt;
1752         text-indent:-14.15pt;
1753         mso-ansi-font-size:9.0pt;
1754         mso-bidi-font-size:9.0pt;
1755         mso-ascii-font-family:Symbol;
1756         mso-hansi-font-family:Symbol;
1757         mso-bidi-font-family:StarSymbol;}
1758 @list l10
1759         {mso-list-id:11;
1760         mso-list-template-ids:11;}
1761 @list l10:level1
1762         {mso-level-number-format:bullet;
1763         mso-level-text:\F0B7;
1764         mso-level-tab-stop:14.15pt;
1765         mso-level-number-position:left;
1766         margin-left:14.15pt;
1767         text-indent:-14.15pt;
1768         mso-ansi-font-size:9.0pt;
1769         mso-bidi-font-size:9.0pt;
1770         mso-ascii-font-family:Symbol;
1771         mso-hansi-font-family:Symbol;
1772         mso-bidi-font-family:StarSymbol;}
1773 @list l10:level2
1774         {mso-level-number-format:bullet;
1775         mso-level-text:\F0B7;
1776         mso-level-tab-stop:28.35pt;
1777         mso-level-number-position:left;
1778         margin-left:28.35pt;
1779         text-indent:-14.15pt;
1780         mso-ansi-font-size:9.0pt;
1781         mso-bidi-font-size:9.0pt;
1782         mso-ascii-font-family:Symbol;
1783         mso-hansi-font-family:Symbol;
1784         mso-bidi-font-family:StarSymbol;}
1785 @list l10:level3
1786         {mso-level-number-format:bullet;
1787         mso-level-text:\F0B7;
1788         mso-level-tab-stop:42.5pt;
1789         mso-level-number-position:left;
1790         margin-left:42.5pt;
1791         text-indent:-14.15pt;
1792         mso-ansi-font-size:9.0pt;
1793         mso-bidi-font-size:9.0pt;
1794         mso-ascii-font-family:Symbol;
1795         mso-hansi-font-family:Symbol;
1796         mso-bidi-font-family:StarSymbol;}
1797 @list l10:level4
1798         {mso-level-number-format:bullet;
1799         mso-level-text:\F0B7;
1800         mso-level-tab-stop:56.7pt;
1801         mso-level-number-position:left;
1802         margin-left:56.7pt;
1803         text-indent:-14.15pt;
1804         mso-ansi-font-size:9.0pt;
1805         mso-bidi-font-size:9.0pt;
1806         mso-ascii-font-family:Symbol;
1807         mso-hansi-font-family:Symbol;
1808         mso-bidi-font-family:StarSymbol;}
1809 @list l10:level5
1810         {mso-level-number-format:bullet;
1811         mso-level-text:\F0B7;
1812         mso-level-tab-stop:70.85pt;
1813         mso-level-number-position:left;
1814         margin-left:70.85pt;
1815         text-indent:-14.15pt;
1816         mso-ansi-font-size:9.0pt;
1817         mso-bidi-font-size:9.0pt;
1818         mso-ascii-font-family:Symbol;
1819         mso-hansi-font-family:Symbol;
1820         mso-bidi-font-family:StarSymbol;}
1821 @list l10:level6
1822         {mso-level-number-format:bullet;
1823         mso-level-text:\F0B7;
1824         mso-level-tab-stop:85.05pt;
1825         mso-level-number-position:left;
1826         margin-left:85.05pt;
1827         text-indent:-14.15pt;
1828         mso-ansi-font-size:9.0pt;
1829         mso-bidi-font-size:9.0pt;
1830         mso-ascii-font-family:Symbol;
1831         mso-hansi-font-family:Symbol;
1832         mso-bidi-font-family:StarSymbol;}
1833 @list l10:level7
1834         {mso-level-number-format:bullet;
1835         mso-level-text:\F0B7;
1836         mso-level-tab-stop:99.2pt;
1837         mso-level-number-position:left;
1838         margin-left:99.2pt;
1839         text-indent:-14.15pt;
1840         mso-ansi-font-size:9.0pt;
1841         mso-bidi-font-size:9.0pt;
1842         mso-ascii-font-family:Symbol;
1843         mso-hansi-font-family:Symbol;
1844         mso-bidi-font-family:StarSymbol;}
1845 @list l10:level8
1846         {mso-level-number-format:bullet;
1847         mso-level-text:\F0B7;
1848         mso-level-tab-stop:113.4pt;
1849         mso-level-number-position:left;
1850         margin-left:113.4pt;
1851         text-indent:-14.15pt;
1852         mso-ansi-font-size:9.0pt;
1853         mso-bidi-font-size:9.0pt;
1854         mso-ascii-font-family:Symbol;
1855         mso-hansi-font-family:Symbol;
1856         mso-bidi-font-family:StarSymbol;}
1857 @list l10:level9
1858         {mso-level-number-format:bullet;
1859         mso-level-text:\F0B7;
1860         mso-level-tab-stop:127.55pt;
1861         mso-level-number-position:left;
1862         margin-left:127.55pt;
1863         text-indent:-14.15pt;
1864         mso-ansi-font-size:9.0pt;
1865         mso-bidi-font-size:9.0pt;
1866         mso-ascii-font-family:Symbol;
1867         mso-hansi-font-family:Symbol;
1868         mso-bidi-font-family:StarSymbol;}
1869 @list l11
1870         {mso-list-id:12;
1871         mso-list-template-ids:12;}
1872 @list l11:level1
1873         {mso-level-number-format:none;
1874         mso-level-text:"";
1875         mso-level-tab-stop:0pt;
1876         mso-level-number-position:left;
1877         margin-left:0pt;
1878         text-indent:0pt;}
1879 @list l11:level2
1880         {mso-level-number-format:none;
1881         mso-level-text:"";
1882         mso-level-tab-stop:0pt;
1883         mso-level-number-position:left;
1884         margin-left:0pt;
1885         text-indent:0pt;}
1886 @list l11:level3
1887         {mso-level-number-format:none;
1888         mso-level-text:"";
1889         mso-level-tab-stop:0pt;
1890         mso-level-number-position:left;
1891         margin-left:0pt;
1892         text-indent:0pt;}
1893 @list l11:level4
1894         {mso-level-number-format:none;
1895         mso-level-text:"";
1896         mso-level-tab-stop:0pt;
1897         mso-level-number-position:left;
1898         margin-left:0pt;
1899         text-indent:0pt;}
1900 @list l11:level5
1901         {mso-level-number-format:none;
1902         mso-level-text:"";
1903         mso-level-tab-stop:0pt;
1904         mso-level-number-position:left;
1905         margin-left:0pt;
1906         text-indent:0pt;}
1907 @list l11:level6
1908         {mso-level-number-format:none;
1909         mso-level-text:"";
1910         mso-level-tab-stop:0pt;
1911         mso-level-number-position:left;
1912         margin-left:0pt;
1913         text-indent:0pt;}
1914 @list l11:level7
1915         {mso-level-number-format:none;
1916         mso-level-text:"";
1917         mso-level-tab-stop:0pt;
1918         mso-level-number-position:left;
1919         margin-left:0pt;
1920         text-indent:0pt;}
1921 @list l11:level8
1922         {mso-level-number-format:none;
1923         mso-level-text:"";
1924         mso-level-tab-stop:0pt;
1925         mso-level-number-position:left;
1926         margin-left:0pt;
1927         text-indent:0pt;}
1928 @list l11:level9
1929         {mso-level-number-format:none;
1930         mso-level-text:"";
1931         mso-level-tab-stop:0pt;
1932         mso-level-number-position:left;
1933         margin-left:0pt;
1934         text-indent:0pt;}
1935 @list l12
1936         {mso-list-id:116531205;
1937         mso-list-template-ids:-1288027304;}
1938 @list l12:level1
1939         {mso-level-text:"%1\)";
1940         mso-level-tab-stop:36.0pt;
1941         mso-level-number-position:left;
1942         text-indent:-18.0pt;}
1943 @list l12:level2
1944         {mso-level-tab-stop:72.0pt;
1945         mso-level-number-position:left;
1946         text-indent:-18.0pt;}
1947 @list l12:level3
1948         {mso-level-tab-stop:108.0pt;
1949         mso-level-number-position:left;
1950         text-indent:-18.0pt;}
1951 @list l12:level4
1952         {mso-level-tab-stop:144.0pt;
1953         mso-level-number-position:left;
1954         text-indent:-18.0pt;}
1955 @list l12:level5
1956         {mso-level-tab-stop:180.0pt;
1957         mso-level-number-position:left;
1958         text-indent:-18.0pt;}
1959 @list l12:level6
1960         {mso-level-tab-stop:216.0pt;
1961         mso-level-number-position:left;
1962         text-indent:-18.0pt;}
1963 @list l12:level7
1964         {mso-level-tab-stop:252.0pt;
1965         mso-level-number-position:left;
1966         text-indent:-18.0pt;}
1967 @list l12:level8
1968         {mso-level-tab-stop:288.0pt;
1969         mso-level-number-position:left;
1970         text-indent:-18.0pt;}
1971 @list l12:level9
1972         {mso-level-tab-stop:324.0pt;
1973         mso-level-number-position:left;
1974         text-indent:-18.0pt;}
1975 @list l13
1976         {mso-list-id:276641855;
1977         mso-list-template-ids:67698719;}
1978 @list l13:level1
1979         {mso-level-tab-stop:18.0pt;
1980         mso-level-number-position:left;
1981         margin-left:18.0pt;
1982         text-indent:-18.0pt;}
1983 @list l13:level2
1984         {mso-level-text:"%1\.%2\.";
1985         mso-level-tab-stop:39.6pt;
1986         mso-level-number-position:left;
1987         margin-left:39.6pt;
1988         text-indent:-21.6pt;}
1989 @list l13:level3
1990         {mso-level-text:"%1\.%2\.%3\.";
1991         mso-level-tab-stop:72.0pt;
1992         mso-level-number-position:left;
1993         margin-left:61.2pt;
1994         text-indent:-25.2pt;}
1995 @list l13:level4
1996         {mso-level-text:"%1\.%2\.%3\.%4\.";
1997         mso-level-tab-stop:90.0pt;
1998         mso-level-number-position:left;
1999         margin-left:86.4pt;
2000         text-indent:-32.4pt;}
2001 @list l13:level5
2002         {mso-level-text:"%1\.%2\.%3\.%4\.%5\.";
2003         mso-level-tab-stop:126.0pt;
2004         mso-level-number-position:left;
2005         margin-left:111.6pt;
2006         text-indent:-39.6pt;}
2007 @list l13:level6
2008         {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.";
2009         mso-level-tab-stop:144.0pt;
2010         mso-level-number-position:left;
2011         margin-left:136.8pt;
2012         text-indent:-46.8pt;}
2013 @list l13:level7
2014         {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.";
2015         mso-level-tab-stop:180.0pt;
2016         mso-level-number-position:left;
2017         margin-left:162.0pt;
2018         text-indent:-54.0pt;}
2019 @list l13:level8
2020         {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.";
2021         mso-level-tab-stop:198.0pt;
2022         mso-level-number-position:left;
2023         margin-left:187.2pt;
2024         text-indent:-61.2pt;}
2025 @list l13:level9
2026         {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.%9\.";
2027         mso-level-tab-stop:234.0pt;
2028         mso-level-number-position:left;
2029         margin-left:216.0pt;
2030         text-indent:-72.0pt;}
2031 @list l14
2032         {mso-list-id:858816198;
2033         mso-list-template-ids:1148726518;}
2034 @list l14:level1
2035         {mso-level-tab-stop:18.0pt;
2036         mso-level-number-position:left;
2037         margin-left:18.0pt;
2038         text-indent:-18.0pt;
2039         mso-ansi-font-size:9.0pt;
2040         mso-bidi-font-size:9.0pt;}
2041 @list l14:level2
2042         {mso-level-number-format:bullet;
2043         mso-level-text:\F0B7;
2044         mso-level-tab-stop:28.35pt;
2045         mso-level-number-position:left;
2046         margin-left:28.35pt;
2047         text-indent:-14.15pt;
2048         mso-ansi-font-size:9.0pt;
2049         mso-bidi-font-size:9.0pt;
2050         mso-ascii-font-family:Symbol;
2051         mso-hansi-font-family:Symbol;
2052         mso-bidi-font-family:StarSymbol;}
2053 @list l14:level3
2054         {mso-level-number-format:bullet;
2055         mso-level-text:\F0B7;
2056         mso-level-tab-stop:42.5pt;
2057         mso-level-number-position:left;
2058         margin-left:42.5pt;
2059         text-indent:-14.15pt;
2060         mso-ansi-font-size:9.0pt;
2061         mso-bidi-font-size:9.0pt;
2062         mso-ascii-font-family:Symbol;
2063         mso-hansi-font-family:Symbol;
2064         mso-bidi-font-family:StarSymbol;}
2065 @list l14:level4
2066         {mso-level-number-format:bullet;
2067         mso-level-text:\F0B7;
2068         mso-level-tab-stop:56.7pt;
2069         mso-level-number-position:left;
2070         margin-left:56.7pt;
2071         text-indent:-14.15pt;
2072         mso-ansi-font-size:9.0pt;
2073         mso-bidi-font-size:9.0pt;
2074         mso-ascii-font-family:Symbol;
2075         mso-hansi-font-family:Symbol;
2076         mso-bidi-font-family:StarSymbol;}
2077 @list l14:level5
2078         {mso-level-number-format:bullet;
2079         mso-level-text:\F0B7;
2080         mso-level-tab-stop:70.85pt;
2081         mso-level-number-position:left;
2082         margin-left:70.85pt;
2083         text-indent:-14.15pt;
2084         mso-ansi-font-size:9.0pt;
2085         mso-bidi-font-size:9.0pt;
2086         mso-ascii-font-family:Symbol;
2087         mso-hansi-font-family:Symbol;
2088         mso-bidi-font-family:StarSymbol;}
2089 @list l14:level6
2090         {mso-level-number-format:bullet;
2091         mso-level-text:\F0B7;
2092         mso-level-tab-stop:85.05pt;
2093         mso-level-number-position:left;
2094         margin-left:85.05pt;
2095         text-indent:-14.15pt;
2096         mso-ansi-font-size:9.0pt;
2097         mso-bidi-font-size:9.0pt;
2098         mso-ascii-font-family:Symbol;
2099         mso-hansi-font-family:Symbol;
2100         mso-bidi-font-family:StarSymbol;}
2101 @list l14:level7
2102         {mso-level-number-format:bullet;
2103         mso-level-text:\F0B7;
2104         mso-level-tab-stop:99.2pt;
2105         mso-level-number-position:left;
2106         margin-left:99.2pt;
2107         text-indent:-14.15pt;
2108         mso-ansi-font-size:9.0pt;
2109         mso-bidi-font-size:9.0pt;
2110         mso-ascii-font-family:Symbol;
2111         mso-hansi-font-family:Symbol;
2112         mso-bidi-font-family:StarSymbol;}
2113 @list l14:level8
2114         {mso-level-number-format:bullet;
2115         mso-level-text:\F0B7;
2116         mso-level-tab-stop:113.4pt;
2117         mso-level-number-position:left;
2118         margin-left:113.4pt;
2119         text-indent:-14.15pt;
2120         mso-ansi-font-size:9.0pt;
2121         mso-bidi-font-size:9.0pt;
2122         mso-ascii-font-family:Symbol;
2123         mso-hansi-font-family:Symbol;
2124         mso-bidi-font-family:StarSymbol;}
2125 @list l14:level9
2126         {mso-level-number-format:bullet;
2127         mso-level-text:\F0B7;
2128         mso-level-tab-stop:127.55pt;
2129         mso-level-number-position:left;
2130         margin-left:127.55pt;
2131         text-indent:-14.15pt;
2132         mso-ansi-font-size:9.0pt;
2133         mso-bidi-font-size:9.0pt;
2134         mso-ascii-font-family:Symbol;
2135         mso-hansi-font-family:Symbol;
2136         mso-bidi-font-family:StarSymbol;}
2137 @list l15
2138         {mso-list-id:865482897;
2139         mso-list-type:hybrid;
2140         mso-list-template-ids:-2013987438 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
2141 @list l15:level1
2142         {mso-level-tab-stop:36.0pt;
2143         mso-level-number-position:left;
2144         text-indent:-18.0pt;}
2145 @list l15:level2
2146         {mso-level-tab-stop:72.0pt;
2147         mso-level-number-position:left;
2148         text-indent:-18.0pt;}
2149 @list l15:level3
2150         {mso-level-tab-stop:108.0pt;
2151         mso-level-number-position:left;
2152         text-indent:-18.0pt;}
2153 @list l15:level4
2154         {mso-level-tab-stop:144.0pt;
2155         mso-level-number-position:left;
2156         text-indent:-18.0pt;}
2157 @list l15:level5
2158         {mso-level-tab-stop:180.0pt;
2159         mso-level-number-position:left;
2160         text-indent:-18.0pt;}
2161 @list l15:level6
2162         {mso-level-tab-stop:216.0pt;
2163         mso-level-number-position:left;
2164         text-indent:-18.0pt;}
2165 @list l15:level7
2166         {mso-level-tab-stop:252.0pt;
2167         mso-level-number-position:left;
2168         text-indent:-18.0pt;}
2169 @list l15:level8
2170         {mso-level-tab-stop:288.0pt;
2171         mso-level-number-position:left;
2172         text-indent:-18.0pt;}
2173 @list l15:level9
2174         {mso-level-tab-stop:324.0pt;
2175         mso-level-number-position:left;
2176         text-indent:-18.0pt;}
2177 @list l16
2178         {mso-list-id:1082213354;
2179         mso-list-type:hybrid;
2180         mso-list-template-ids:1622673204 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
2181 @list l16:level1
2182         {mso-level-tab-stop:36.0pt;
2183         mso-level-number-position:left;
2184         text-indent:-18.0pt;}
2185 @list l16:level2
2186         {mso-level-tab-stop:72.0pt;
2187         mso-level-number-position:left;
2188         text-indent:-18.0pt;}
2189 @list l16:level3
2190         {mso-level-tab-stop:108.0pt;
2191         mso-level-number-position:left;
2192         text-indent:-18.0pt;}
2193 @list l16:level4
2194         {mso-level-tab-stop:144.0pt;
2195         mso-level-number-position:left;
2196         text-indent:-18.0pt;}
2197 @list l16:level5
2198         {mso-level-tab-stop:180.0pt;
2199         mso-level-number-position:left;
2200         text-indent:-18.0pt;}
2201 @list l16:level6
2202         {mso-level-tab-stop:216.0pt;
2203         mso-level-number-position:left;
2204         text-indent:-18.0pt;}
2205 @list l16:level7
2206         {mso-level-tab-stop:252.0pt;
2207         mso-level-number-position:left;
2208         text-indent:-18.0pt;}
2209 @list l16:level8
2210         {mso-level-tab-stop:288.0pt;
2211         mso-level-number-position:left;
2212         text-indent:-18.0pt;}
2213 @list l16:level9
2214         {mso-level-tab-stop:324.0pt;
2215         mso-level-number-position:left;
2216         text-indent:-18.0pt;}
2217 @list l17
2218         {mso-list-id:1281301046;
2219         mso-list-type:hybrid;
2220         mso-list-template-ids:1985279396 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
2221 @list l17:level1
2222         {mso-level-tab-stop:36.0pt;
2223         mso-level-number-position:left;
2224         text-indent:-18.0pt;}
2225 @list l17:level2
2226         {mso-level-tab-stop:72.0pt;
2227         mso-level-number-position:left;
2228         text-indent:-18.0pt;}
2229 @list l17:level3
2230         {mso-level-tab-stop:108.0pt;
2231         mso-level-number-position:left;
2232         text-indent:-18.0pt;}
2233 @list l17:level4
2234         {mso-level-tab-stop:144.0pt;
2235         mso-level-number-position:left;
2236         text-indent:-18.0pt;}
2237 @list l17:level5
2238         {mso-level-tab-stop:180.0pt;
2239         mso-level-number-position:left;
2240         text-indent:-18.0pt;}
2241 @list l17:level6
2242         {mso-level-tab-stop:216.0pt;
2243         mso-level-number-position:left;
2244         text-indent:-18.0pt;}
2245 @list l17:level7
2246         {mso-level-tab-stop:252.0pt;
2247         mso-level-number-position:left;
2248         text-indent:-18.0pt;}
2249 @list l17:level8
2250         {mso-level-tab-stop:288.0pt;
2251         mso-level-number-position:left;
2252         text-indent:-18.0pt;}
2253 @list l17:level9
2254         {mso-level-tab-stop:324.0pt;
2255         mso-level-number-position:left;
2256         text-indent:-18.0pt;}
2257 ol
2258         {margin-bottom:0pt;}
2259 ul
2260         {margin-bottom:0pt;}
2261 -->
2262 </style>
2263 <!--[if gte mso 10]>
2264 <style>
2265  /* Style Definitions */
2266  table.MsoNormalTable
2267         {mso-style-name:"Table Normal";
2268         mso-tstyle-rowband-size:0;
2269         mso-tstyle-colband-size:0;
2270         mso-style-noshow:yes;
2271         mso-style-parent:"";
2272         mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
2273         mso-para-margin:0pt;
2274         mso-para-margin-bottom:.0001pt;
2275         mso-pagination:widow-orphan;
2276         font-size:10.0pt;
2277         font-family:"Times New Roman";
2278         mso-fareast-font-family:"Times New Roman";
2279         mso-ansi-language:#0400;
2280         mso-fareast-language:#0400;
2281         mso-bidi-language:#0400;}
2282 table.MsoTable3DFx1
2283         {mso-style-name:"Table 3D effects 1";
2284         mso-tstyle-rowband-size:0;
2285         mso-tstyle-colband-size:0;
2286         mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
2287         mso-tstyle-shading:white;
2288         mso-tstyle-pattern:solid silver;
2289         mso-para-margin-top:7.2pt;
2290         mso-para-margin-right:0pt;
2291         mso-para-margin-bottom:7.2pt;
2292         mso-para-margin-left:0pt;
2293         mso-pagination:none;
2294         mso-hyphenate:none;
2295         font-size:10.0pt;
2296         font-family:"Times New Roman";
2297         mso-ansi-language:#0400;
2298         mso-fareast-language:#0400;
2299         mso-bidi-language:#0400;}
2300 table.MsoTable3DFx1FirstRow
2301         {mso-style-name:"Table 3D effects 1";
2302         mso-table-condition:first-row;
2303         mso-tstyle-border-bottom:.75pt solid gray;
2304         mso-tstyle-diagonal-down:0pt none windowtext;
2305         mso-tstyle-diagonal-up:0pt none windowtext;
2306         color:purple;
2307         mso-ansi-font-weight:bold;
2308         mso-bidi-font-weight:bold;}
2309 table.MsoTable3DFx1LastRow
2310         {mso-style-name:"Table 3D effects 1";
2311         mso-table-condition:last-row;
2312         mso-tstyle-border-top:.75pt solid white;
2313         mso-tstyle-diagonal-down:0pt none windowtext;
2314         mso-tstyle-diagonal-up:0pt none windowtext;}
2315 table.MsoTable3DFx1FirstCol
2316         {mso-style-name:"Table 3D effects 1";
2317         mso-table-condition:first-column;
2318         mso-tstyle-border-right:.75pt solid gray;
2319         mso-tstyle-diagonal-down:0pt none windowtext;
2320         mso-tstyle-diagonal-up:0pt none windowtext;
2321         mso-ansi-font-weight:bold;
2322         mso-bidi-font-weight:bold;}
2323 table.MsoTable3DFx1LastCol
2324         {mso-style-name:"Table 3D effects 1";
2325         mso-table-condition:last-column;
2326         mso-tstyle-border-left:.75pt solid white;
2327         mso-tstyle-diagonal-down:0pt none windowtext;
2328         mso-tstyle-diagonal-up:0pt none windowtext;}
2329 table.MsoTable3DFx1NECell
2330         {mso-style-name:"Table 3D effects 1";
2331         mso-table-condition:ne-cell;
2332         mso-tstyle-border-left:0pt none windowtext;
2333         mso-tstyle-border-bottom:0pt none windowtext;
2334         mso-tstyle-diagonal-down:0pt none windowtext;
2335         mso-tstyle-diagonal-up:0pt none windowtext;}
2336 table.MsoTable3DFx1NWCell
2337         {mso-style-name:"Table 3D effects 1";
2338         mso-table-condition:nw-cell;
2339         mso-tstyle-border-bottom:0pt none windowtext;
2340         mso-tstyle-border-right:0pt none windowtext;
2341         mso-tstyle-diagonal-down:0pt none windowtext;
2342         mso-tstyle-diagonal-up:0pt none windowtext;}
2343 table.MsoTable3DFx1SECell
2344         {mso-style-name:"Table 3D effects 1";
2345         mso-table-condition:se-cell;
2346         mso-tstyle-border-top:0pt none windowtext;
2347         mso-tstyle-border-left:0pt none windowtext;
2348         mso-tstyle-diagonal-down:0pt none windowtext;
2349         mso-tstyle-diagonal-up:0pt none windowtext;}
2350 table.MsoTable3DFx1SWCell
2351         {mso-style-name:"Table 3D effects 1";
2352         mso-table-condition:sw-cell;
2353         mso-tstyle-border-top:0pt none windowtext;
2354         mso-tstyle-border-right:0pt none windowtext;
2355         mso-tstyle-diagonal-down:0pt none windowtext;
2356         mso-tstyle-diagonal-up:0pt none windowtext;
2357         color:navy;}
2358 table.MsoTableWeb1
2359         {mso-style-name:"Table Web 1";
2360         mso-tstyle-rowband-size:0;
2361         mso-tstyle-colband-size:0;
2362         mso-cellspacing:2.0pt;
2363         border:outset 1.0pt;
2364         mso-border-alt:outset windowtext .75pt;
2365         mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
2366         mso-border-insideh:.75pt outset windowtext;
2367         mso-border-insidev:.75pt outset windowtext;
2368         mso-para-margin-top:7.2pt;
2369         mso-para-margin-right:0pt;
2370         mso-para-margin-bottom:7.2pt;
2371         mso-para-margin-left:0pt;
2372         mso-pagination:none;
2373         mso-hyphenate:none;
2374         font-size:10.0pt;
2375         font-family:"Times New Roman";
2376         mso-ansi-language:#0400;
2377         mso-fareast-language:#0400;
2378         mso-bidi-language:#0400;}
2379 table.MsoTableWeb1FirstRow
2380         {mso-style-name:"Table Web 1";
2381         mso-table-condition:first-row;
2382         mso-tstyle-diagonal-down:0pt none windowtext;
2383         mso-tstyle-diagonal-up:0pt none windowtext;
2384         color:windowtext;}
2385 table.MsoTableWeb3
2386         {mso-style-name:"Table Web 3";
2387         mso-tstyle-rowband-size:0;
2388         mso-tstyle-colband-size:0;
2389         mso-cellspacing:2.0pt;
2390         border:outset 3.0pt;
2391         mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
2392         mso-border-insideh:.75pt outset windowtext;
2393         mso-border-insidev:.75pt outset windowtext;
2394         mso-para-margin-top:7.2pt;
2395         mso-para-margin-right:0pt;
2396         mso-para-margin-bottom:7.2pt;
2397         mso-para-margin-left:0pt;
2398         mso-pagination:none;
2399         mso-hyphenate:none;
2400         font-size:10.0pt;
2401         font-family:"Times New Roman";
2402         mso-ansi-language:#0400;
2403         mso-fareast-language:#0400;
2404         mso-bidi-language:#0400;}
2405 table.MsoTableWeb3FirstRow
2406         {mso-style-name:"Table Web 3";
2407         mso-table-condition:first-row;
2408         mso-tstyle-diagonal-down:0pt none windowtext;
2409         mso-tstyle-diagonal-up:0pt none windowtext;
2410         color:windowtext;}
2411 table.MsoTableGrid
2412         {mso-style-name:"Table Grid";
2413         mso-tstyle-rowband-size:0;
2414         mso-tstyle-colband-size:0;
2415         border:solid windowtext 1.0pt;
2416         mso-border-alt:solid windowtext .5pt;
2417         mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
2418         mso-border-insideh:.5pt solid windowtext;
2419         mso-border-insidev:.5pt solid windowtext;
2420         mso-para-margin-top:7.2pt;
2421         mso-para-margin-right:0pt;
2422         mso-para-margin-bottom:7.2pt;
2423         mso-para-margin-left:0pt;
2424         mso-pagination:none;
2425         mso-hyphenate:none;
2426         font-size:10.0pt;
2427         font-family:"Times New Roman";
2428         mso-ansi-language:#0400;
2429         mso-fareast-language:#0400;
2430         mso-bidi-language:#0400;}
2431 </style>
2432 <![endif]--><!--[if gte mso 9]><xml>
2433  <o:shapedefaults v:ext="edit" spidmax="5122"/>
2434 </xml><![endif]--><!--[if gte mso 9]><xml>
2435  <o:shapelayout v:ext="edit">
2436   <o:idmap v:ext="edit" data="1"/>
2437  </o:shapelayout></xml><![endif]-->
2438 </head>
2439
2440 <body lang=EN-US link=navy vlink=maroon style='tab-interval:35.45pt;line-break:
2441 strict'>
2442
2443 <div class=Section1>
2444
2445 <p class=MsoTitle>OpenAFS for Windows 1.4.0<br>
2446 Release Notes</p>
2447
2448 <p class=MsoBodyText>The Andrew File System (AFS) is a location-independent
2449 file system that uses a local cache to increase its performance.<span
2450 style='mso-spacerun:yes'>  </span>An AFS client accesses files anonymously or
2451 via a Kerberos authentication.<span style='mso-spacerun:yes'>  </span>The
2452 global AFS is partitioned into cells.<span style='mso-spacerun:yes'>
2453 </span>The AFS cell is a collection of AFS volumes that are administered by a
2454 common entity.<span style='mso-spacerun:yes'>   </span>AFS cells can be
2455 administered by a department even when the Kerberos realm used for local
2456 authentication is managed by a much larger organization.<span
2457 style='mso-spacerun:yes'>  </span>AFS clients and servers take advantage of
2458 Kerberos cross realm authentication to enable authenticated access by entities
2459 located outside the local realm.<span style='mso-spacerun:yes'>
2460 </span>Authorization is enforced by the use of directory level access control
2461 lists which can consist of individual or group identities.<span
2462 style='mso-spacerun:yes'>  </span></p>
2463
2464 <p class=MsoBodyText>The AFS volume is a tree of files and
2465 sub-directories.<span style='mso-spacerun:yes'>  </span>AFS volumes are created
2466 by administrators and are joined to an AFS cell via the use of a mount
2467 point.<span style='mso-spacerun:yes'>   </span>Once a volume is created, users
2468 can create files and directories as well as mount points and symlinks within
2469 the volume without regard for the physical location of the volume.<span
2470 style='mso-spacerun:yes'>  </span>Administrators can move the volume to another
2471 server as necessary without the need to notify users.<span
2472 style='mso-spacerun:yes'>   </span>In fact, the volume move can occur while
2473 files in the volume are in use.<span style='mso-spacerun:yes'>  </span></p>
2474
2475 <p class=MsoBodyText>AFS volumes can be replicated to read-only copies.<span
2476 style='mso-spacerun:yes'>   </span>When accessing files from a read-only
2477 replica, clients will read all of the data from a single replica.<span
2478 style='mso-spacerun:yes'>   </span>If that replica becomes unavailable, the
2479 clients will failover to any replica that is reachable.<span
2480 style='mso-spacerun:yes'>  </span>Users of the data are unaware of where the
2481 replicas are stored or which one is being accessed.<span
2482 style='mso-spacerun:yes'>   </span>The contents of the replicas can be updated
2483 at any time by <i style='mso-bidi-font-style:normal'>releasing</i> the current
2484 contents of the source volume.</p>
2485
2486 <p class=MsoBodyText>OpenAFS for Windows (OAFW) provides AFS client access
2487 Microsoft Windows operating systems.<span style='mso-spacerun:yes'>  </span>It
2488 strives to maintain transparency such that the user is unaware of the
2489 distinction between the use of AFS and Microsoft Windows file shares.<span
2490 style='mso-spacerun:yes'>   </span>OAFW can be part of a single sign-on
2491 solution by allowing credentials for a Kerberos principal to be obtained at
2492 logon and for that principal to be used to obtain AFS tokens for one or more
2493 cells.<span style='mso-spacerun:yes'>   </span>Although OAFW is implemented as
2494 a locally installed SMB to AFS gateway, OAFW maintains the portability of file
2495 paths by its use of the <a href="file:///\\AFS">\\AFS</a> UNC server name.</p>
2496
2497 <p class=MsoBodyText>OpenAFS is the product of an open source development
2498 effort begun in July 2001.<span style='mso-spacerun:yes'>  </span>OpenAFS is
2499 maintained and developed by a group of volunteers with the support of the user
2500 community.<span style='mso-spacerun:yes'>   </span>If you use OpenAFS as part
2501 of your computing infrastructure please contribute to its continued growth.</p>
2502
2503 <p class=MsoToc1><!--[if supportFields]><span style='mso-element:field-begin'></span><span
2504 style='mso-spacerun:yes'> </span>TOC \o &quot;1-1&quot; \h \z \u <span
2505 style='mso-element:field-separator'></span><![endif]--><span
2506 class=MsoHyperlink><span style='mso-no-proof:yes'><a href="#_Toc115417109">1.
2507 Installer Options<span style='color:windowtext;display:none;mso-hide:screen;
2508 text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
2509 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2510 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2511 _Toc115417109 \h </span><span style='color:windowtext;text-decoration:none;
2512 text-underline:none'><span style='display:none;mso-hide:screen'><span
2513 style='mso-element:field-separator'></span></span></span><![endif]--><span
2514 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2515 text-underline:none'>1<!--[if gte mso 9]><xml>
2516  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100300039000000</w:data>
2517 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2518 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2519 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2520 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2521 mso-no-proof:yes'><o:p></o:p></span></p>
2522
2523 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
2524 href="#_Toc115417110">2. System Requirements<span style='color:windowtext;
2525 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2526 style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
2527 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2528 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2529 _Toc115417110 \h </span><span style='color:windowtext;text-decoration:none;
2530 text-underline:none'><span style='display:none;mso-hide:screen'><span
2531 style='mso-element:field-separator'></span></span></span><![endif]--><span
2532 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2533 text-underline:none'>2<!--[if gte mso 9]><xml>
2534  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310030000000</w:data>
2535 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2536 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2537 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2538 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2539 mso-no-proof:yes'><o:p></o:p></span></p>
2540
2541 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
2542 href="#_Toc115417111">3. Operational Notes<span style='color:windowtext;
2543 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2544 style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
2545 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2546 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2547 _Toc115417111 \h </span><span style='color:windowtext;text-decoration:none;
2548 text-underline:none'><span style='display:none;mso-hide:screen'><span
2549 style='mso-element:field-separator'></span></span></span><![endif]--><span
2550 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2551 text-underline:none'>2<!--[if gte mso 9]><xml>
2552  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310031000000</w:data>
2553 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2554 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2555 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2556 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2557 mso-no-proof:yes'><o:p></o:p></span></p>
2558
2559 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
2560 href="#_Toc115417112">4. How to Debug Problems with OpenAFS for Windows:<span
2561 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2562 text-underline:none'><span style='mso-tab-count:1 dotted'> </span></span><!--[if supportFields]><span
2563 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2564 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2565 _Toc115417112 \h </span><span style='color:windowtext;text-decoration:none;
2566 text-underline:none'><span style='display:none;mso-hide:screen'><span
2567 style='mso-element:field-separator'></span></span></span><![endif]--><span
2568 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2569 text-underline:none'>11<!--[if gte mso 9]><xml>
2570  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310032000000</w:data>
2571 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2572 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2573 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2574 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2575 mso-no-proof:yes'><o:p></o:p></span></p>
2576
2577 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
2578 href="#_Toc115417113">5. Reporting Bugs:<span style='color:windowtext;
2579 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2580 style='mso-tab-count:1 dotted'> </span></span><!--[if supportFields]><span
2581 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2582 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2583 _Toc115417113 \h </span><span style='color:windowtext;text-decoration:none;
2584 text-underline:none'><span style='display:none;mso-hide:screen'><span
2585 style='mso-element:field-separator'></span></span></span><![endif]--><span
2586 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2587 text-underline:none'>13<!--[if gte mso 9]><xml>
2588  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310033000000</w:data>
2589 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2590 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2591 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2592 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2593 mso-no-proof:yes'><o:p></o:p></span></p>
2594
2595 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
2596 href="#_Toc115417114">6. How to Contribute to the Development of OpenAFS for
2597 Windows<span style='color:windowtext;display:none;mso-hide:screen;text-decoration:
2598 none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
2599 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2600 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2601 _Toc115417114 \h </span><span style='color:windowtext;text-decoration:none;
2602 text-underline:none'><span style='display:none;mso-hide:screen'><span
2603 style='mso-element:field-separator'></span></span></span><![endif]--><span
2604 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2605 text-underline:none'>14<!--[if gte mso 9]><xml>
2606  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310034000000</w:data>
2607 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2608 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2609 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2610 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2611 mso-no-proof:yes'><o:p></o:p></span></p>
2612
2613 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
2614 href="#_Toc115417115">7. MSI Deployment Guide<span style='color:windowtext;
2615 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2616 style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
2617 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2618 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2619 _Toc115417115 \h </span><span style='color:windowtext;text-decoration:none;
2620 text-underline:none'><span style='display:none;mso-hide:screen'><span
2621 style='mso-element:field-separator'></span></span></span><![endif]--><span
2622 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2623 text-underline:none'>15<!--[if gte mso 9]><xml>
2624  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310035000000</w:data>
2625 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2626 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2627 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2628 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2629 mso-no-proof:yes'><o:p></o:p></span></p>
2630
2631 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
2632 href="#_Toc115417116">Appendix A: Registry Values<span style='color:windowtext;
2633 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2634 style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
2635 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2636 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2637 _Toc115417116 \h </span><span style='color:windowtext;text-decoration:none;
2638 text-underline:none'><span style='display:none;mso-hide:screen'><span
2639 style='mso-element:field-separator'></span></span></span><![endif]--><span
2640 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2641 text-underline:none'>26<!--[if gte mso 9]><xml>
2642  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310036000000</w:data>
2643 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2644 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2645 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2646 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2647 mso-no-proof:yes'><o:p></o:p></span></p>
2648
2649 <h1 style='margin-left:0pt;text-indent:0pt'><!--[if supportFields]><span
2650 style='mso-element:field-end'></span><![endif]--><a name="_Toc115416098"></a><a
2651 name="_Toc115417037"></a><a name="_Toc115417109"><span style='mso-bookmark:
2652 _Toc115417037'><span style='mso-bookmark:_Toc115416098'>1. Installer Options</span></span></a></h1>
2653
2654 <p class=MsoNormal>It can be installed either as a new installation or an
2655 upgrade from previous versions of OpenAFS for Windows or IBM AFS for
2656 Windows.<span style='mso-spacerun:yes'>  </span>Installers are provided in two
2657 forms:</p>
2658
2659 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l0 level1 lfo4;
2660 tab-stops:list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;
2661 mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
2662 style='mso-list:Ignore'>1.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2663 </span></span></span><![endif]>an executable (.exe) that is built using the
2664 Nullsoft Scriptable Installation System, or</p>
2665
2666 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l0 level1 lfo4;
2667 tab-stops:list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;
2668 mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
2669 style='mso-list:Ignore'>2.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2670 </span></span></span><![endif]>a Windows Installer package (.msi) that is built
2671 using WiX and can be customized for organizations via the use of MSI Transforms
2672 (see <a href="#_MSI_Deployment_Guide">MSI Deployment Guide</a>)</p>
2673
2674 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416099"></a><a
2675 name="_Toc115417038"></a><a name="_Toc115417110"><span style='mso-bookmark:
2676 _Toc115417038'><span style='mso-bookmark:_Toc115416099'>2. System Requirements</span></span></a></h1>
2677
2678 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416100"></a><a
2679 name="_Toc115417039"><span style='mso-bookmark:_Toc115416100'>2.1 Supported
2680 Operating Systems</span></a></h2>
2681
2682 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2683 l1 level1 lfo6;tab-stops:list 14.15pt'><![if !supportLists]><span
2684 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2685 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2686 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2687 Windows 2000 Workstation</p>
2688
2689 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2690 l1 level1 lfo6;tab-stops:list 14.15pt'><![if !supportLists]><span
2691 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2692 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2693 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2694 Windows 2000 Server</p>
2695
2696 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2697 l1 level1 lfo6;tab-stops:list 14.15pt'><![if !supportLists]><span
2698 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2699 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2700 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2701 Windows XP Home</p>
2702
2703 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2704 l1 level1 lfo6;tab-stops:list 14.15pt'><![if !supportLists]><span
2705 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2706 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2707 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2708 Windows XP Professional</p>
2709
2710 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2711 l1 level1 lfo6;tab-stops:list 14.15pt'><![if !supportLists]><span
2712 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2713 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2714 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2715 Windows 2003 Server</p>
2716
2717 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2718 l1 level1 lfo6;tab-stops:list 14.15pt'><![if !supportLists]><span
2719 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2720 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2721 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2722 Windows 2003 R2 Server</p>
2723
2724 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416101">2.1.1
2725 Unsupported Operating Systems</a></h3>
2726
2727 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2728 l2 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
2729 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2730 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2731 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2732 Windows 95</p>
2733
2734 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2735 l2 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
2736 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2737 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2738 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2739 Windows 98</p>
2740
2741 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2742 l2 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
2743 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2744 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2745 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2746 Windows 98 OSR2</p>
2747
2748 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2749 l2 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
2750 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2751 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2752 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2753 Windows ME</p>
2754
2755 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2756 l2 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
2757 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2758 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2759 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2760 NT</p>
2761
2762 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2763 l2 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
2764 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2765 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2766 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2767 Windows Vista (as of Beta 1 bugs in Windows prevent its use)</p>
2768
2769 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2770 l2 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
2771 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2772 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2773 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>All
2774 64-bit versions of Microsoft Windows on Itanium and x86-64 chipsets.</p>
2775
2776 <p class=MsoNormal>Older releases of OpenAFS are available for download if
2777 those operating systems must be supported.<span style='mso-spacerun:yes'>
2778 </span>The last version of OpenAFS with support for Win9x is 1.2.2b.<span
2779 style='mso-spacerun:yes'>  </span>The last version with support for Windows NT
2780 4.0 is 1.2.10.</p>
2781
2782 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416102"></a><a
2783 name="_Toc115417040"><span style='mso-bookmark:_Toc115416102'>2.2 Disk Space</span></a></h2>
2784
2785 <p class=MsoNormal>Up to 60mb required for the OpenAFS binaries plus 100MB for
2786 the default AFSCache file.<span style='mso-spacerun:yes'>   </span>(The size of
2787 the AFSCache file may be adjusted via the Registry after installation.)</p>
2788
2789 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416103"></a><a
2790 name="_Toc115417041"><span style='mso-bookmark:_Toc115416103'>2.3 Additional
2791 Software</span></a></h2>
2792
2793 <p class=MsoNormal><a href="http://web.mit.edu/kerberos/dist/index.html">MIT
2794 Kerberos for Windows</a> 2.6.x if Kerberos 5 authentication support is desired.</p>
2795
2796 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416104"></a><a
2797 name="_Toc115417042"></a><a name="_Toc115417111"><span style='mso-bookmark:
2798 _Toc115417042'><span style='mso-bookmark:_Toc115416104'>3. Operational Notes</span></span></a></h1>
2799
2800 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416105"></a><a
2801 name="_Toc115417043"><span style='mso-bookmark:_Toc115416105'>3.1. Requirements
2802 for Kerberos 5 Authentication</span></a></h2>
2803
2804 <p class=MsoNormal>The Kerberos 4 infrastructure on which the OpenAFS 1.2
2805 series is reliant is no longer secure.<span style='mso-spacerun:yes'>
2806 </span>Cross-realm Kerberos is very important in the AFS context and most sites
2807 have or are migrating to Kerberos 5 environments.<span
2808 style='mso-spacerun:yes'>  </span>The OpenAFS 1.4 series integrates with MIT
2809 Kerberos for Windows 2.6.5 to support Kerberos 5 authentication including
2810 automatic renewal of AFS tokens and single sign-on via the Microsoft Windows
2811 Kerberos Logon Service.</p>
2812
2813 <p class=MsoNormal>When KFW is installed, the OpenAFS 1.4 client will obtain
2814 Kerberos 5 tickets and use them as tokens without modification.<span
2815 style='mso-spacerun:yes'>  </span>The OpenAFS 1.4 client requires that all of
2816 the AFS Servers with which it communicates support the use of Kerberos 5
2817 tickets as tokens. If Kerberos 5 based tokens are presented to an AFS server
2818 that does not understand them, the server will be unable to communicate with
2819 the client when tokens are present. Kerberos 5 based tokens are supported by
2820 OpenAFS release 1.2.8 or later.<span style='mso-spacerun:yes'>  </span>IBM
2821 Transarc servers do not support Kerberos 5.<!--[if supportFields]><span
2822 style='mso-element:field-begin'></span> XE &quot;Kerberos 5&quot; <![endif]--><!--[if supportFields]><span
2823 style='mso-element:field-end'></span><![endif]--></p>
2824
2825 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416106">3.1.1.
2826 Active Directory</a></h3>
2827
2828 <p class=MsoNormal>There are two things to consider when using a Microsoft
2829 Windows Active Directory as the Kerberos realm that issues the AFS service
2830 ticket.<span style='mso-spacerun:yes'>  </span>First, the Kerberos 5 tickets
2831 issued by Active Directory can be quite large when compared to tickets issued
2832 by a traditional KDC due to the incorporation of authorization data in the <st2:place
2833 w:st="on">PAC.</st2:place><span style='mso-spacerun:yes'>  </span>If the issued
2834 tickets become larger than 344 bytes OpenAFS 1.2 servers will be unable to
2835 process them.<span style='mso-spacerun:yes'>  </span>OpenAFS 1.4 servers can
2836 support the largest tickets that Active Directory can issue.<span
2837 style='mso-spacerun:yes'>  </span>Second, the Kerberos 5 tickets issued by
2838 Windows 2003 Active Directory are encrypted with the DES-CBC-MD5 enctype.<span
2839 style='mso-spacerun:yes'>  </span>OpenAFS 1.2 servers only support the
2840 DES-CBC-CRC enctype.<!--[if supportFields]><span style='mso-element:field-begin'></span>
2841 XE &quot;Active Directory&quot; <![endif]--><!--[if supportFields]><span
2842 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
2843 style='mso-element:field-begin'></span><span
2844 style='mso-spacerun:yes'> </span>XE &quot;DES enctypes&quot; <![endif]--><!--[if supportFields]><span
2845 style='mso-element:field-end'></span><![endif]--></p>
2846
2847 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416107">3.1.2.
2848 Using the krb524 service</a></h3>
2849
2850 <p class=MsoNormal>Some organizations which have AFS cell names and Kerberos
2851 realm names which differ by more then just lower and upper case rely on a
2852 modification to krb524d which maps a Kerberos 5 ticket from realm FOO to a
2853 Kerberos 4 ticket in realm BAR.<span style='mso-spacerun:yes'>  </span>This
2854 allows user@FOO to appear to be user@bar for the purposes of accessing the AFS
2855 cell.<span style='mso-spacerun:yes'>  </span>As of OpenAFS 1.2.8, support was
2856 added to allow the immediate use of Kerberos 5 tickets as AFS (2b) tokens. This
2857 is the first building block necessary to break away from the limitations of
2858 Kerberos 4 with AFS.<span style='mso-spacerun:yes'>  </span>By using Kerberos 5
2859 directly we avoid the security holes inherent in Kerberos 4 cross-realm.<span
2860 style='mso-spacerun:yes'>  </span>We also gain access to cryptographically
2861 stronger algorithms for authentication and encryption. </p>
2862
2863 <p class=MsoNormal>Another reason for using Kerberos 5 directly is because the
2864 krb524 service runs on a port (4444) which has become increasingly blocked by
2865 ISPs.<span style='mso-spacerun:yes'>  </span>The port was used to spread a worm
2866 which attacked Microsoft Windows in the summer of 2003.<span
2867 style='mso-spacerun:yes'>  </span>When the port is blocked users find that they
2868 are unable to authenticate.</p>
2869
2870 <p class=MsoNormal>Replacing the Kerberos 4 ticket with a Kerberos 5 ticket is
2871 a win in all situations except when the cell name does not match the realm name
2872 and the principal names placed into the ACLs are not the principal names from
2873 the Kerberos 5 ticket.<span style='mso-spacerun:yes'>  </span>To support this
2874 transition, OpenAFS for Windows 1.4 adds a new registry value, <i><a
2875 href="#_Value___:_Use524">Use524</a></i>, to force the use of krb524d.<span
2876 style='mso-spacerun:yes'>  </span>However, the availability of this option
2877 should only be used by individuals until such time as their organizations can
2878 provide a more permanent solution.<!--[if supportFields]><span
2879 style='mso-element:field-begin'></span> XE &quot;Kerberos 5&quot; <![endif]--><!--[if supportFields]><span
2880 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
2881 style='mso-element:field-begin'></span><span
2882 style='mso-spacerun:yes'> </span>XE &quot;krb524&quot; <![endif]--><!--[if supportFields]><span
2883 style='mso-element:field-end'></span><![endif]--></p>
2884
2885 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416108"></a><a
2886 name="_Toc115417044"><span style='mso-bookmark:_Toc115416108'>3.2. Use of the
2887 Microsoft Loopback Adapter</span></a></h2>
2888
2889 <p class=MsoNormal>By itself the OpenAFS Client Service does not provide robust
2890 behavior in a plug-n-play network environment.<span style='mso-spacerun:yes'>
2891 </span>Changes to the number of network adapters or their assigned IP addresses
2892 will cause the service to terminate unexpectedly.<span
2893 style='mso-spacerun:yes'>  </span>To avoid this behavior OpenAFS for Windows
2894 installs a single instance of the Microsoft Loopback Adapter (MLA) on the
2895 machine.<span style='mso-spacerun:yes'>  </span>With the MLA installed, the
2896 OpenAFS Client Service will not be affected by the configuration changes of
2897 other network adapters installed on the system.<span style='mso-spacerun:yes'>
2898 </span></p>
2899
2900 <p class=MsoNormal>The MLA is installed with a name of &quot;AFS&quot; and a pre-assigned
2901 IP address in the 10.x.x.x range.<span style='mso-spacerun:yes'>  </span>The
2902 MLA is bound to the Client for Microsoft Networks service and not bound to
2903 the File and Printer Sharing for Microsoft Networks.<span
2904 style='mso-spacerun:yes'>  </span>If the MLA is unbound to &quot;Client
2905 Microsoft Networks&quot;, the OpenAFS Client Service will become inaccessible
2906 when the machine is disconnected from the network.<span
2907 style='mso-spacerun:yes'>  </span>If the MLA is bound to &quot;File and Printer
2908 Sharing ...&quot; there will be a service type collision between the name
2909 &quot;AFS&quot; and the name of the machine on the MLA's IP Address that will
2910 result in the OpenAFS client service becoming inaccessible and the &quot;NET
2911 VIEW \\AFS&quot; command will return a &quot;System Error 52&quot;
2912 message.<span style='mso-spacerun:yes'>  </span>To correct the problem:</p>
2913
2914 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
2915 l3 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
2916 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2917 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2918 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
2919 style='mso-spacerun:yes'> </span>stop the AFS Client Service</p>
2920
2921 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
2922 l3 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
2923 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2924 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2925 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
2926 style='mso-spacerun:yes'> </span>bind the &quot;Client for Microsoft
2927 Networks&quot; to the MLA</p>
2928
2929 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
2930 l3 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
2931 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2932 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2933 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
2934 style='mso-spacerun:yes'> </span>unbind &quot;File and Printer Sharing for
2935 Microsoft Networks&quot; from the MLA</p>
2936
2937 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
2938 l3 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
2939 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2940 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2941 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
2942 style='mso-spacerun:yes'> </span>Disable and then re-enable the MLA</p>
2943
2944 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
2945 l3 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
2946 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2947 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2948 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
2949 style='mso-spacerun:yes'> </span>start the AFS Client Service</p>
2950
2951 <p class=MsoNormal>When the MLA is not installed the unique NETBIOS name
2952 published by OpenAFS SMB server is &quot;<i>MACHINE</i>-AFS&quot;.<span
2953 style='mso-spacerun:yes'>  </span>One of the benefits of using the MLA is that
2954 the NETBIOS name does not have to be published on any adapter other than the
2955 MLA.<span style='mso-spacerun:yes'>  </span>Therefore the chosen name is no
2956 longer required to be unique.<span style='mso-spacerun:yes'>  </span>Instead the
2957 NETBIOS name associated with the AFS Client Service is simply &quot;AFS&quot;
2958 and portable UNC paths of the form \\AFS\cellname\path can now be used on all
2959 machines.<!--[if supportFields]><span style='mso-element:field-begin'></span>
2960 XE &quot;loopback&quot; <![endif]--><!--[if supportFields]><span
2961 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
2962 style='mso-element:field-begin'></span><span
2963 style='mso-spacerun:yes'> </span>XE &quot;UNC paths&quot; <![endif]--><!--[if supportFields]><span
2964 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
2965 style='mso-element:field-begin'></span><span
2966 style='mso-spacerun:yes'> </span>XE &quot;NETBIOS&quot; <![endif]--><!--[if supportFields]><span
2967 style='mso-element:field-end'></span><![endif]--></p>
2968
2969 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416109"></a><a
2970 name="_Toc115417045"><span style='mso-bookmark:_Toc115416109'>3.3. Using
2971 Freelance (Dynamic Root) Mode to Improve Mobility</span></a></h2>
2972
2973 <p class=MsoNormal>Traditionally, when the OpenAFS Client Service starts it must
2974 be able to access the &quot;root.afs&quot; volume of the default cell.<span
2975 style='mso-spacerun:yes'>  </span>The &quot;root.afs&quot; volume contains the
2976 set of mount points to the &quot;root.cell&quot; volumes of various cells the
2977 administrator of the default cell believes should be accessible.<span
2978 style='mso-spacerun:yes'>  </span>If the &quot;root.afs&quot; volume is
2979 inaccessible when the client service is started, the service will terminate
2980 unexpectedly.<span style='mso-spacerun:yes'>  </span>Since many users now use
2981 laptops or otherwise operate in disconnected environments in which a VPN may be
2982 required to access the cell's servers, it is often the case that the
2983 &quot;root.afs&quot; volume for the default cell is not reachable and the
2984 OpenAFS Client Service will not successfully start. </p>
2985
2986 <p class=MsoNormal>To allow the OpenAFS Client Service to operate in these
2987 environments, a fake &quot;root.afs&quot; volume is dynamically constructed from
2988 mount points and symlinks stored in the local registry.<span
2989 style='mso-spacerun:yes'>  </span>This method of operation is referred to as
2990 Freelance mode.</p>
2991
2992 <p class=MsoNormal>The content of the fake root.afs volume is dynamically
2993 modified as cells are accessed.<span style='mso-spacerun:yes'>  </span>When the
2994 fake &quot;root.afs&quot; volume is initially constructed it will only contain
2995 two mount points: a <i>regular path </i>and <i>read-write path </i>mount point
2996 used to access the &quot;root.cell&quot; volume of the default AFS cell.<span
2997 style='mso-spacerun:yes'>  </span>Any attempt to access a valid cell name will
2998 result in a new mount point being created in the fake &quot;root.afs&quot;
2999 volume.<span style='mso-spacerun:yes'>  </span>If the cellname begins with a
3000 &quot;.&quot; the mount point will be a <i>read-write path</i>; otherwise the
3001 mount point will be a <i>regular path</i>.<span style='mso-spacerun:yes'>
3002 </span>These mount points are preserved in the registry at key:</p>
3003
3004 <p class=PreformattedText style='margin-left:35.45pt'><a
3005 href="#_Regkey:_[HKLMSOFTWAREOpenAFSClie">HKLM\SOFTWARE\OpenAFS\Client\Freelance</a></p>
3006
3007 <p class=MsoNormal>Additional mount points may be manually created using the
3008 &quot;fs mkmount&quot; command.<span style='mso-spacerun:yes'>  </span>Mount
3009 points may be removed using the &quot;fs rmmount&quot; command.</p>
3010
3011 <p class=PreformattedText style='margin-left:35.45pt'>&gt;fs mkmount
3012 \\AFS\athena.mit.edu root.cell athena.mit.edu</p>
3013
3014 <p class=PreformattedText style='margin-left:35.45pt'>&gt;fs mkmount
3015 \\AFS\.athena.mit.edu root.cell athena.mit.edu -rw</p>
3016
3017 <p class=PreformattedText style='margin-left:35.45pt'>&gt;fs rmmount
3018 \\AFS\athena.mit.edu</p>
3019
3020 <p class=PreformattedText style='margin-left:35.45pt'>&gt;fs rmmount
3021 \\AFS\.athena.mit.edu</p>
3022
3023 <p class=MsoNormal>Symlinks may also be created within the Freelance root.afs
3024 volume.</p>
3025
3026 <p class=PreformattedText style='margin-left:35.45pt'>&gt;symlink make
3027 \\afs\link \\afs\athena.mit.edu\user\j\a\jaltman</p>
3028
3029 <p class=PreformattedText><span style='mso-tab-count:1'>      </span>&gt;symlink
3030 list \\afs\link</p>
3031
3032 <p class=PreformattedText><span style='mso-tab-count:1'>      </span>'\\afs\link'
3033 is a symlink to 'athena.mit.edu\user\j\a\jaltman'</p>
3034
3035 <p class=PreformattedText style='margin-left:35.45pt'>&gt;symlink rm \\afs\link</p>
3036
3037 <p class=MsoNormal>The symlinks are stored in the registry at:</p>
3038
3039 <p class=PreformattedText style='margin-left:35.45pt'><a
3040 href="#_Regkey:_[HKLMSOFTWAREOpenAFSClie_1">HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks</a><!--[if supportFields]><span
3041 style='mso-element:field-begin'></span> XE &quot;Freelance Mode&quot; <![endif]--><!--[if supportFields]><span
3042 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3043 style='mso-element:field-begin'></span><span
3044 style='mso-spacerun:yes'> </span>XE &quot;Dynamic Root&quot; <![endif]--><!--[if supportFields]><span
3045 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3046 style='mso-element:field-begin'></span><span
3047 style='mso-spacerun:yes'> </span>XE &quot;fs.exe&quot; <![endif]--><!--[if supportFields]><span
3048 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3049 style='mso-element:field-begin'></span><span
3050 style='mso-spacerun:yes'> </span>XE &quot;symlink.exe&quot; <![endif]--><!--[if supportFields]><span
3051 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3052 style='mso-element:field-begin'></span><span
3053 style='mso-spacerun:yes'> </span>XE &quot;root.afs&quot; <![endif]--><!--[if supportFields]><span
3054 style='mso-element:field-end'></span><![endif]--><span
3055 style='mso-spacerun:yes'> </span></p>
3056
3057 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416110"></a><a
3058 name="_Toc115417046"><span style='mso-bookmark:_Toc115416110'>3.4. Locating AFS
3059 Volume Database Servers</span></a> </h2>
3060
3061 <p class=MsoNormal>The OpenAFS for Windows client will use DNS AFSDB records to
3062 discover the location of AFS Volume Database servers when entries are not
3063 present in the client's CellServDB file
3064 (\%PROGRAMFILES%\OpenAFS\Client\CellServDB).<!--[if supportFields]><span
3065 style='mso-element:field-begin'></span> XE &quot;dns&quot; <![endif]--><!--[if supportFields]><span
3066 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3067 style='mso-element:field-begin'></span><span
3068 style='mso-spacerun:yes'> </span>XE &quot;afsdb&quot; <![endif]--><!--[if supportFields]><span
3069 style='mso-element:field-end'></span><![endif]--></p>
3070
3071 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416111"></a><a
3072 name="_Toc115417047"><span style='mso-bookmark:_Toc115416111'>3.5. Obtaining
3073 AFS Tokens as a Part of Windows Logon</span></a></h2>
3074
3075 <p class=MsoNormal>OpenAFS for Windows installs a WinLogon Network Provider to
3076 provide Single Sign-on functionality (aka Integrated Logon.)<span
3077 style='mso-spacerun:yes'>  </span>Integrated Logon can be used when the Windows
3078 username and password match the username and password associated with the
3079 default cell's Kerberos realm.<span style='mso-spacerun:yes'>  </span>For
3080 example, if the Windows username is &quot;jaltman&quot; and the default cell is
3081 &quot;athena.mit.edu&quot;, then Integrated Logon can be successfully used if
3082 the windows password matches the password assigned to the Kerberos principal
3083 &quot;<a href="mailto:jaltman@ATHENA.MIT.EDU">jaltman@ATHENA.MIT.EDU</a>&quot;.<span
3084 style='mso-spacerun:yes'>  </span>The realm ATHENA.MIT.EDU is obtained by
3085 performing a domain name to realm mapping on the hostname of one of the cell's
3086 Volume Database servers.</p>
3087
3088 <p class=MsoNormal>Integrated Logon is required if you desire the ability to
3089 store roaming user profiles within the AFS file system.<span
3090 style='mso-spacerun:yes'>  </span>OpenAFS does not provide tools for
3091 synchronizing the Windows and Kerberos user accounts and passwords.</p>
3092
3093 <p class=MsoNormal>When KFW is configured, Integrated Logon will use it to
3094 obtain tokens.<span style='mso-spacerun:yes'>  </span>The Kerberos 5 tickets
3095 obtained during the process of generating AFS tokens are preserved and stored
3096 into the default ccache within the user logon session.</p>
3097
3098 <p class=MsoNormal>Integrated Logon does not have the ability to cache the
3099 user's username and password for the purpose of obtaining tokens if the
3100 Kerberos KDC is inaccessible at logon time.</p>
3101
3102 <p class=MsoNormal>Integrated Login supports the ability to obtain tokens for
3103 multiple cells.<span style='mso-spacerun:yes'>  </span>For further information
3104 on how to configure this feature read the <a
3105 href="relnotes.htm#_Value:_TheseCells">TheseCells</a> value in <a
3106 href="#_Appendix_A:_Registry_Values">Appendix A</a>.<!--[if supportFields]><span
3107 style='mso-element:field-begin'></span> XE &quot;integrated login&quot; <![endif]--><!--[if supportFields]><span
3108 style='mso-element:field-end'></span><![endif]--></p>
3109
3110 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416112"></a><a
3111 name="_Toc115417048"><span style='mso-bookmark:_Toc115416112'>3.6. AFS System
3112 Tray Command Line Options</span></a></h2>
3113
3114 <p class=MsoNormal>The AFS System Tray tool (afscreds.exe) supports several
3115 command line options: </p>
3116
3117 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-A =
3118 autoinit </p>
3119
3120 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-E = force
3121 existing afscreds to exit</p>
3122
3123 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-I =
3124 install startup shortcut</p>
3125
3126 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-M = renew
3127 drive maps </p>
3128
3129 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-N = IP
3130 address change detection </p>
3131
3132 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-Q = quiet
3133 mode.<span style='mso-spacerun:yes'>  </span>do not display start service
3134 dialog</p>
3135
3136 <p class=PreformattedText><span style='mso-spacerun:yes'>         </span>if
3137 afsd_service is not already running</p>
3138
3139 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-S = show
3140 tokens dialog on startup</p>
3141
3142 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-U =
3143 uninstall startup shortcut</p>
3144
3145 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span><span
3146 style='mso-spacerun:yes'> </span>-X = test and do map share</p>
3147
3148 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-Z = unmap
3149 drives</p>
3150
3151 <p class=MsoNormal>autoinit will result in automated attempts to acquire AFS
3152 tokens when afscreds.exe is started.<span style='mso-spacerun:yes'>
3153 </span>afscreds.exe will attempt to utilize tickets stored in the MSLSA
3154 credentials cache; any existing CCAPI credentials cache; and finally display an
3155 Obtain Tokens dialog to the user.<span style='mso-spacerun:yes'>  </span>When
3156 used in combination with IP address change detection, afscreds.exe will attempt
3157 to acquire AFS tokens whenever the IP address list changes and the Kerberos KDC
3158 is accessible.</p>
3159
3160 <p class=MsoNormal>The renew drive maps option is used to ensure that the user
3161 drive maps constructed via the OpenAFS tools (not NET USE) are re-constructed
3162 each time afscreds.exe is started.</p>
3163
3164 <p class=MsoNormal>By default afscreds.exe is configured by the OpenAFS.org
3165 installers to use -A -N -M -Q as startup options.<span
3166 style='mso-spacerun:yes'>  </span>Currently, there is no user interface to
3167 change this selection after install time although these options may be altered
3168 via the registry on either per machine or per user basis.<span
3169 style='mso-spacerun:yes'>  </span>See <span style='mso-bidi-font-style:italic'><a
3170 href="#_Value___:_AfscredsShortcutParams">AfscredsShortcutParams</a></span> in <a
3171 href="#_Appendix_A:_Registry_Values">Appendix A</a>.<!--[if supportFields]><span
3172 style='mso-element:field-begin'></span> XE &quot;afscreds.exe&quot; <![endif]--><!--[if supportFields]><span
3173 style='mso-element:field-end'></span><![endif]--></p>
3174
3175 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416113"></a><a
3176 name="_Toc115417049"><span style='mso-bookmark:_Toc115416113'>3.7. The AFS
3177 Client Admins Authorization Group</span></a></h2>
3178
3179 <p class=MsoNormal>The OpenAFS for Windows 1.4 client supports a local Windows
3180 authorization group named &quot;AFS Client Admins&quot;.<span
3181 style='mso-spacerun:yes'>  </span>This group is used in place of the
3182 &quot;Administrators&quot; group to determine which users are allowed to modify
3183 the AFS Client Service configuration via the AFS Control Panel (afs_config.exe)
3184 or fs.exe command line tool.<span style='mso-spacerun:yes'>  </span>The
3185 following fs.exe commands are now restricted to members of the &quot;AFS Client
3186 Admins&quot; group:</p>
3187
3188 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3189 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3190 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3191 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3192 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>checkservers
3193 with a non-zero timer value</p>
3194
3195 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3196 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3197 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3198 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3199 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setcachesize</p>
3200
3201 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3202 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3203 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3204 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3205 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>newcell</p>
3206
3207 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3208 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3209 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3210 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3211 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>sysname
3212 with a new sysname list</p>
3213
3214 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3215 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3216 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3217 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3218 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>exportafs</p>
3219
3220 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3221 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3222 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3223 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3224 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setcell</p>
3225
3226 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3227 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3228 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3229 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3230 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setserverprefs</p>
3231
3232 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3233 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3234 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3235 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3236 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>storebehind</p>
3237
3238 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3239 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3240 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3241 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3242 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setcrypt</p>
3243
3244 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3245 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3246 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3247 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3248 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>cscpolicy</p>
3249
3250 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3251 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3252 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3253 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3254 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>trace</p>
3255
3256 <p class=MsoNormal>The creation or removal of mount points and symlinks in the
3257 Freelance root.afs volume are also restricted to members of the AFS Client
3258 Admins group.</p>
3259
3260 <p class=MsoNormal>The initial membership of the &quot;AFS Client Admins&quot;
3261 group when created by the installer is equivalent to the local
3262 &quot;Administrators&quot; group.<span style='mso-spacerun:yes'>  </span>If a
3263 user is added to the &quot;Administrators&quot; group after the creation of the
3264 &quot;AFS Client Admin&quot; group, that user will not be an AFS Client
3265 Administrator.<span style='mso-spacerun:yes'>  </span>Only users that are
3266 members of the &quot;AFS Client Admins&quot; group are AFS Client
3267 Administrators.<span style='mso-spacerun:yes'>  </span>The local
3268 &quot;SYSTEM&quot; account is an implicit member of the &quot;AFS Client
3269 Admins&quot; group.</p>
3270
3271 <p class=MsoNormal>Setting the default sysname for a machine should be done via
3272 the <a href="#_Value_:_SysName">registry</a> and not via &quot;fs
3273 sysname&quot;.<!--[if supportFields]><span style='mso-element:field-begin'></span>
3274 XE &quot;AFS Client Admins&quot; <![endif]--><!--[if supportFields]><span
3275 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3276 style='mso-element:field-begin'></span><span
3277 style='mso-spacerun:yes'> </span>XE &quot;fs.exe&quot; <![endif]--><!--[if supportFields]><span
3278 style='mso-element:field-end'></span><![endif]--></p>
3279
3280 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416114"></a><a
3281 name="_Toc115417050"><span style='mso-bookmark:_Toc115416114'>3.8. OpenAFS
3282 support for UNC paths</span></a> </h2>
3283
3284 <p class=MsoNormal>The OpenAFS 1.4 client supports UNC paths everywhere.<span
3285 style='mso-spacerun:yes'>  </span>UNC paths provide a canonical name for
3286 resources stored within AFS.<span style='mso-spacerun:yes'>  </span>UNC paths
3287 should be used instead of drive letter mappings whenever possible.<span
3288 style='mso-spacerun:yes'>   </span>This is especially true when specifying the
3289 location of roaming profiles and redirected folders.<!--[if supportFields]><span
3290 style='mso-element:field-begin'></span> XE &quot;UNC paths&quot; <![endif]--><!--[if supportFields]><span
3291 style='mso-element:field-end'></span><![endif]--><span
3292 style='mso-spacerun:yes'>  </span></p>
3293
3294 <p class=MsoNormal>Power users that make extensive use of the command line
3295 shell, cmd.exe, should consider using JP Software's 4NT or Take Command command
3296 processors.<span style='mso-spacerun:yes'>  </span>Unlike cmd.exe, the
3297 JPSoftware shells fully support UNC paths as the current directory.<span
3298 style='mso-spacerun:yes'>  </span>With the release of version 4NT 7.0 and Take
3299 Command 7.0, JPSoftware is adding special recognition of OpenAFS.<span
3300 style='mso-spacerun:yes'>  </span>AFS paths can be entered in UNIX notation
3301 (e.g., <a href="file:///\\afs\openafs.org\software">/afs/openafs.org/software</a>),
3302 space utilization reports the output of the volume status for the specified
3303 path, and many AFS specific functions and variables have been added to the command
3304 language.</p>
3305
3306 <p class=MsoNormal>JPSoftware's web site is <span class=MsoHyperlink>http://www.jpsoft.com</span>.<!--[if supportFields]><span
3307 style='mso-element:field-begin'></span> XE &quot;JP Software&quot; <![endif]--><!--[if supportFields]><span
3308 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3309 style='mso-element:field-begin'></span><span
3310 style='mso-spacerun:yes'> </span>XE &quot;4nt.exe&quot; <![endif]--><!--[if supportFields]><span
3311 style='mso-element:field-end'></span><![endif]--></p>
3312
3313 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416115"></a><a
3314 name="_Toc115417051"><span style='mso-bookmark:_Toc115416115'>3.9. OpenAFS
3315 includes aklog.exe</span></a></h2>
3316
3317 <p class=MsoNormal>The OpenAFS 1.4 Client ships with its own version of
3318 aklog.exe which should be used in preference to those obtained by third party
3319 sources.<span style='mso-spacerun:yes'>  </span>The OpenAFS aklog.exe supports
3320 Kerberos 5 as well as the ability to auto-generate pts IDs for user's obtaining
3321 tokens<span style='mso-spacerun:yes'>  </span>for access to foreign cells.</p>
3322
3323 <p class=PreformattedText>Usage: aklog [-d] [[-cell | -c] cell [-k krb_realm]]</p>
3324
3325 <p class=PreformattedText><span style='mso-spacerun:yes'>
3326 </span>[[-p | -path] pathname]</p>
3327
3328 <p class=PreformattedText><span style='mso-spacerun:yes'>  </span><span
3329 style='mso-spacerun:yes'>           </span>[-noprdb] [-force]</p>
3330
3331 <p class=PreformattedText><span style='mso-spacerun:yes'>
3332 </span>[-5 [-m]| -4]</p>
3333
3334 <p class=PreformattedText><o:p>&nbsp;</o:p></p>
3335
3336 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>-d = output
3337 debugging information.</p>
3338
3339 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>cell = zero
3340 or more cells for which tokens will be obtained</p>
3341
3342 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>krb_realm =
3343 the kerberos realm of the cell.</p>
3344
3345 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>pathname =
3346 the directory for which authentication is required</p>
3347
3348 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>-noprdb =
3349 don't try to determine AFS ID.</p>
3350
3351 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>-5 or -4 =
3352 use Kerberos V (default) or Kerberos IV tickets</p>
3353
3354 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>-m = use
3355 krb524d to convert Kerberos V tickets to Kerberos IV<!--[if supportFields]><span
3356 style='mso-element:field-begin'></span> XE &quot;aklog.exe&quot; <![endif]--><!--[if supportFields]><span
3357 style='mso-element:field-end'></span><![endif]--></p>
3358
3359 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416116"></a><a
3360 name="_Toc115417052"><span style='mso-bookmark:_Toc115416116'>3.10. OpenAFS
3361 Servers on Windows are Unsupported</span></a></h2>
3362
3363 <p class=MsoNormal>The AFS Server functionality provided with OpenAFS 1.4 might
3364 work but should be considered highly experimental.<span
3365 style='mso-spacerun:yes'>  </span>It has not been thoroughly tested.<span
3366 style='mso-spacerun:yes'>  </span>Any data which would cause pain if lost
3367 should not be stored in an OpenAFS Server on Windows.</p>
3368
3369 <p class=MsoNormal>A few notes on the usage of the AFS Client Service if it is
3370 going to be used with the OpenAFS AFS Server:</p>
3371
3372 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3373 l5 level1 lfo14;tab-stops:list 14.15pt'><![if !supportLists]><span
3374 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3375 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3376 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>When
3377 installed on the same machine as the AFS Server, Freelance mode must be turned
3378 off.<span style='mso-spacerun:yes'>  </span>Otherwise, you will be unable to
3379 manipulate the contents of the root.afs volume for the hosted cell.</p>
3380
3381 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3382 l5 level1 lfo14;tab-stops:list 14.15pt'><![if !supportLists]><span
3383 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3384 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3385 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>The
3386 AFS Server and related tools only support the built in kaserver (Kerberos
3387 IV).<span style='mso-spacerun:yes'>  </span>If the AFS Server is being used,
3388 MIT Kerberos for Windows should not be installed or must be disabled.<!--[if supportFields]><span
3389 style='mso-element:field-begin'></span> XE &quot;AFS Servers&quot; <![endif]--><!--[if supportFields]><span
3390 style='mso-element:field-end'></span><![endif]--></p>
3391
3392 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416117"></a><a
3393 name="_Toc115417053"><span style='mso-bookmark:_Toc115416117'>3.11. OpenAFS Debugging
3394 Symbol files</span></a></h2>
3395
3396 <p class=MsoNormal>The OpenAFS for Windows installers now include Debugging
3397 Symbol files which should be installed if you are experiencing problems and
3398 need to send crash reports.<span style='mso-spacerun:yes'>  </span>This is true
3399 for both the release and the debug versions of the installers.<span
3400 style='mso-spacerun:yes'>  </span>The difference between the release and debug
3401 versions are:</p>
3402
3403 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3404 l6 level1 lfo16;tab-stops:list 14.15pt'><![if !supportLists]><span
3405 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3406 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3407 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>whether
3408 or not the binaries were compiled with optimization</p>
3409
3410 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3411 l6 level1 lfo16;tab-stops:list 14.15pt'><![if !supportLists]><span
3412 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3413 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3414 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>whether
3415 the debug symbols are installed by default</p>
3416
3417 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3418 l6 level1 lfo16;tab-stops:list 14.15pt'><![if !supportLists]><span
3419 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3420 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3421 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>whether
3422 additional debug statements were compiled into the binaries<!--[if supportFields]><span
3423 style='mso-element:field-begin'></span> XE &quot;Symbol files&quot; <![endif]--><!--[if supportFields]><span
3424 style='mso-element:field-end'></span><![endif]--></p>
3425
3426 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416118"></a><a
3427 name="_Toc115417054"><span style='mso-bookmark:_Toc115416118'>3.12. Maximum
3428 File Size is 2GB</span></a></h2>
3429
3430 <p class=MsoNormal>OpenAFS for Windows does not support files larger than
3431 2GB.<span style='mso-spacerun:yes'>  </span>The version of the SMB/CIFS
3432 protocol implemented imposes this limitation.<span style='mso-spacerun:yes'>
3433 </span>Upgrading the SMB/CIFS implementation or replacing it with an
3434 Installable File System will allow larger files to be supported.<!--[if supportFields]><span
3435 style='mso-element:field-begin'></span> XE &quot;large file support&quot; <![endif]--><!--[if supportFields]><span
3436 style='mso-element:field-end'></span><![endif]--></p>
3437
3438 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416119"></a><a
3439 name="_Toc115417055"><span style='mso-bookmark:_Toc115416119'>3.13. Encrypted
3440 AFS File Access</span></a></h2>
3441
3442 <p class=MsoNormal>The OpenAFS for Windows installer by default activates a
3443 weak form of encrypted data transfer between the AFS client and the AFS
3444 servers.<span style='mso-spacerun:yes'>  </span>This is often referred to as
3445 &quot;fcrypt&quot; mode.</p>
3446
3447 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416120"></a><a
3448 name="_Toc115417056"><span style='mso-bookmark:_Toc115416120'>3.14.
3449 Authenticated Access to the OpenAFS Client Service</span></a></h2>
3450
3451 <p class=MsoNormal>OpenAFS 1.4 supports authenticated SMB connections using
3452 either NTLM or GSS SPNEGO (NTLM).<span style='mso-spacerun:yes'>  </span>In
3453 previous versions of OpenAFS, the SMB connections were unauthenticated which
3454 opened the door for several attacks which could be used to obtain access to
3455 another user's tokens on shared machines.<span style='mso-spacerun:yes'>
3456 </span></p>
3457
3458 <p class=MsoNormal>When GSS SPNEGO attempts a Kerberos 5 authentication, the
3459 Windows SMB client will attempt to retrieve service tickets for &quot;cifs/afs@REALM&quot;
3460 (if the loopback adapter is in use) or &quot;cifs/machine-afs@REALM&quot; (if
3461 the loopback adapter is not being used).<span style='mso-spacerun:yes'>
3462 </span>It is extremely important that this service principal not exist in the
3463 KDC database as the Kerberos authentication must fail allowing automatic
3464 fallback to NTLM.<span style='mso-spacerun:yes'>  </span>When NTLM is used a
3465 special local authentication mode will be used that does not require access to
3466 the user's password.<span style='mso-spacerun:yes'>  </span>Instead, Windows
3467 will internally recognize the request as coming from a local logon session.</p>
3468
3469 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416121"></a><a
3470 name="_Toc115417057"><span style='mso-bookmark:_Toc115416121'>3.15. No More INI
3471 Files</span></a></h2>
3472
3473 <p class=MsoNormal>Previous AFS clients for Windows stored configuration data
3474 in Windows .INI files.<span style='mso-spacerun:yes'>   </span>OpenAFS 1.4 does
3475 not use Windows .INI files for the storage of configuration data.<span
3476 style='mso-spacerun:yes'>   </span>All settings are now stored in the registry
3477 (see <a href="#_Appendix_A:_Registry_Values">Appendix A</a>).<span
3478 style='mso-spacerun:yes'>  </span>The CellServDB file is now stored in the
3479 %PROGRAMFILES%\OpenAFS\Client directory.<span style='mso-spacerun:yes'>
3480 </span>The <i style='mso-bidi-font-style:normal'><a
3481 href="#_Value___:_CellServDBDir">CellServDBDir</a></i> registry value can be
3482 used to specify an alternative location.</p>
3483
3484 <p class=MsoNormal>OpenAFS 1.4 will relocate the contents of the afsdcell.ini
3485 file to the new CellServDB file.<span style='mso-spacerun:yes'>  </span>OpenAFS
3486 1.4 will also import the contents of the afs_freelance.ini file to the
3487 Windows registry.<span style='mso-spacerun:yes'>   </span>OpenAFS 1.4 will not
3488 process the contents of the afsddbmt.ini.</p>
3489
3490 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416122"></a><a
3491 name="_Toc115417058"><span style='mso-bookmark:_Toc115416122'>3.16. Microsoft
3492 Windows Internet Connection Firewall</span></a></h2>
3493
3494 <p class=MsoNormal>The OpenAFS 1.4 Client is compatible with the Internet
3495 Connection Firewall that debuted with Windows XP SP2 and Windows 2003 SP1.<span
3496 style='mso-spacerun:yes'>  </span>The Internet Connection Firewall will be
3497 automatically adjusted to allow the receipt of incoming callback messages from
3498 the AFS file server.<span style='mso-spacerun:yes'>  </span>In addition, the
3499 appropriate <i>Back Connection</i> registry entries are added to allow SMB
3500 authentication to be performed across the Microsoft Loopback Adapter.</p>
3501
3502 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416123"></a><a
3503 name="_Toc115417059"><span style='mso-bookmark:_Toc115416123'>3.17. Browsing
3504 AFS from the Explorer Shell and Office</span></a></h2>
3505
3506 <p class=MsoNormal>The OpenAFS 1.4 Client Service implements the CIFS Remote
3507 Admin Protocol which allows Explorer to browse server and share information.
3508 This significantly enhances the interoperability of AFS volumes within the
3509 Explorer Shell and Microsoft Office applications.</p>
3510
3511 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417060"></a><a
3512 name="_Toc115416124"><span style='mso-bookmark:_Toc115417060'>3.18. No Support
3513 for </span></a><st2:place w:st="on"><st2:PlaceName w:st="on"><span
3514   style='mso-bookmark:_Toc115417060'><span style='mso-bookmark:_Toc115416124'>Byte</span></span></st2:PlaceName><span
3515  style='mso-bookmark:_Toc115417060'><span style='mso-bookmark:_Toc115416124'> <st2:PlaceType
3516  w:st="on">Range</st2:PlaceType></span></span></st2:place><span
3517 style='mso-bookmark:_Toc115417060'><span style='mso-bookmark:_Toc115416124'>
3518 Locking</span></span></h2>
3519
3520 <p class=MsoBodyText>Many applications on Windows (e.g. Microsoft Office)
3521 require the use of byte range locks applied to a file either to protect against
3522 simultaneous file access or as a signaling mechanism.<span
3523 style='mso-spacerun:yes'>   </span>OpenAFS does not currently support byte
3524 range locks.<span style='mso-spacerun:yes'>   </span>It is strongly recommended
3525 that files not be edited within AFS if they might be accessed by multiple users
3526 or multiple processes on a single machine.</p>
3527
3528 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416125"></a><a
3529 name="_Toc115417061"><span style='mso-bookmark:_Toc115416125'>3.19. Automatic
3530 Discarding of AFS Tokens at Logoff</span></a></h2>
3531
3532 <p class=MsoNormal>OpenAFS 1.4 will automatically forget a user's tokens upon
3533 Logoff unless the user's profile was loaded from an AFS volume.<span
3534 style='mso-spacerun:yes'>  </span>In this situation there is no mechanism to
3535 determine when the profile has been successfully written back to the
3536 network.<span style='mso-spacerun:yes'>  </span>It is therefore unsafe to
3537 release the user's tokens.<span style='mso-spacerun:yes'>  </span>Whether or
3538 not the profile has been loaded from the registry can be determined for Local
3539 Accounts, Active Directory accounts and NT4 accounts.</p>
3540
3541 <p class=MsoNormal>If there is a need to disable this functionality, the <span
3542 style='mso-bidi-font-style:italic'><a href="#_Value_:_LogoffPreserveTokens">LogoffPreserveTokens</a></span>
3543 registry value can be used. (see <a href="#_Appendix_A:_Registry_Values">Appendix
3544 A</a>.)</p>
3545
3546 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416126"></a><a
3547 name="_Toc115417062"><span style='mso-bookmark:_Toc115416126'>3.20. Terminal
3548 Server installations</span></a></h2>
3549
3550 <p class=MsoNormal>When installing the NSIS (.exe) installer under Terminal
3551 Server, you must execute it from within the Add/Remove Programs Control
3552 Panel.<span style='mso-spacerun:yes'>  </span>Failure to do so will result in
3553 AFS not running properly.<span style='mso-spacerun:yes'>  </span>The AFS Server
3554 should not be installed on a machine with Terminal Server installed.</p>
3555
3556 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416127"></a><a
3557 name="_Toc115417063"><span style='mso-bookmark:_Toc115416127'>3.21. Hidden Dot
3558 Files</span></a></h2>
3559
3560 <p class=MsoNormal>AFS is a UNIX native file system.<span
3561 style='mso-spacerun:yes'>  </span>The OpenAFS client attempts to treat the
3562 files stored in AFS as they would be on UNIX.<span style='mso-spacerun:yes'>
3563 </span>File and directory names beginning with a &quot;.&quot; are
3564 automatically given the Hidden attribute so they will not normally be
3565 displayed.</p>
3566
3567 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416128"></a><a
3568 name="_Toc115417064"><span style='mso-bookmark:_Toc115416128'>3.22. Status
3569 Cache Limits</span></a></h2>
3570
3571 <p class=MsoNormal>The Status Cache (AFS Configuration Control Panel: Advanced
3572 Page) is defined to have a maximum number of entries.<span
3573 style='mso-spacerun:yes'>  </span>Each entry represents a single file or
3574 directory entry accessed within the AFS file system.<span
3575 style='mso-spacerun:yes'>  </span>When the maximum number of entries are
3576 allocated, entries will begin to be reused according to a least recently used
3577 (LRU) algorithm.<span style='mso-spacerun:yes'>  </span>If the number of files
3578 or directories being accessed repeatedly by your applications is greater then
3579 the maximum number of entries, your host will begin to experience thrashing of
3580 the Status Cache and all requests will result in network operations.</p>
3581
3582 <p class=MsoNormal>If you are experiencing poor performance try increasing the
3583 maximum number of Status Cache entries.<span style='mso-spacerun:yes'>
3584 </span>Each entry requires approximately 1.2K.<span style='mso-spacerun:yes'>
3585 </span>In OpenAFS 1.4, the default number of Status Cache entries is 10,000.</p>
3586
3587 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416129"></a><a
3588 name="_Toc115417065"><span style='mso-bookmark:_Toc115416129'>3.23. NETBIOS
3589 over TCP/IP must be enabled</span></a></h2>
3590
3591 <p class=MsoNormal>&quot;Netbios over TCP/IP&quot; must be active on the
3592 machine in order for communication with the AFS Client Service to succeed.<span
3593 style='mso-spacerun:yes'>  </span>If &quot;Netbios over TCP/IP&quot; is disabled
3594 on the machine, then communication with the AFS Client Service will be
3595 impossible.</p>
3596
3597 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416130"></a><a
3598 name="_Toc115417066"><span style='mso-bookmark:_Toc115416130'>3.24. OpenAFS
3599 binaries are digitally signed</span></a></h2>
3600
3601 <p class=MsoNormal>The OpenAFS Client Service and related binaries distributed
3602 by OpenAFS.org are digitally signed by &quot;Secure Endpoints Inc.&quot;.<span
3603 style='mso-spacerun:yes'>  </span>The OpenAFS Client Service will perform a
3604 run-time verification check to ensure that all OpenAFS related DLLs loaded by
3605 the service match the same file version number and were signed by the same
3606 entity.<span style='mso-spacerun:yes'>  </span>This check has been added to
3607 prevent the stability problems caused by more than one AFS installation present
3608 on a machine at the same time.<span style='mso-spacerun:yes'>  </span>Many
3609 hours of support time have been wasted tracking down problems caused by the
3610 mixture of files from different releases.<span style='mso-spacerun:yes'>
3611 </span></p>
3612
3613 <p class=MsoNormal><a href="#_Appendix_A:_Registry_Values">Appendix A</a>
3614 documents the &quot;<a href="#_Value___:_VerifyServiceSignature">VerifyServiceSignature</a>&quot;
3615 registry value which can be used to disable the signature check.<span
3616 style='mso-spacerun:yes'>  </span>The file version check cannot be disabled.</p>
3617
3618 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416131"></a><a
3619 name="_Toc115417067"><span style='mso-bookmark:_Toc115416131'>3.25. Maximum
3620 Size of the AFSCache File</span></a></h2>
3621
3622 <p class=MsoNormal>The maximum cache size is approximately 1.3GB.<span
3623 style='mso-spacerun:yes'>  </span>This is the largest contiguous block of
3624 memory in the 2GB process address space which can be used for constructing a
3625 memory mapped file.<span style='mso-spacerun:yes'>  </span>Due to fragmentation
3626 of the process space caused by the loading of libraries required by the digital
3627 signature verification code, any attempt to specify a cache size greater then
3628 700MB will result in the automatic disabling of the signature check.</p>
3629
3630 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416132"></a><a
3631 name="_Toc115417068"><span style='mso-bookmark:_Toc115416132'>3.26. Filename
3632 Character Sets</span></a></h2>
3633
3634 <p class=MsoNormal>OpenAFS for Windows implements an SMB server which is used
3635 as a gateway to the AFS filesystem.<span style='mso-spacerun:yes'>
3636 </span>Because of limitations of the SMB implementation, Windows stores all
3637 files into AFS using OEM code pages such as CP437 (United States) or CP850
3638 (Western Europe).<span style='mso-spacerun:yes'>  </span>These code pages are
3639 incompatible with the ISO Latin-1 character set typically used as the default
3640 on UNIX systems in both the <st2:country-region w:st="on">United States</st2:country-region>
3641 and <st2:place w:st="on">Western Europe</st2:place>.<span
3642 style='mso-spacerun:yes'>  </span>Filenames stored by OpenAFS for Windows are
3643 therefore unreadable on UNIX systems if they include any of the following
3644 characters:</p>
3645
3646 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
3647  style='border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;
3648  mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;mso-border-insideh:
3649  .5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
3650  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
3651   height:399.5pt'>
3652   <td width=590 valign=top style='width:442.8pt;border:solid windowtext 1.0pt;
3653   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt;height:399.5pt'>
3654   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[Ç]<span
3655   style='mso-spacerun:yes'>  </span>128<span style='mso-spacerun:yes'>
3656   </span>08/00<span style='mso-spacerun:yes'>  </span>200<span
3657   style='mso-spacerun:yes'>  </span>80<span style='mso-spacerun:yes'>  </span>C
3658   cedilla</p>
3659   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ü]<span
3660   style='mso-spacerun:yes'>  </span>129<span style='mso-spacerun:yes'>
3661   </span>08/01<span style='mso-spacerun:yes'>  </span>201<span
3662   style='mso-spacerun:yes'>  </span>81<span style='mso-spacerun:yes'>  </span>u
3663   diaeresis</p>
3664   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[é]<span
3665   style='mso-spacerun:yes'>  </span>130<span style='mso-spacerun:yes'>
3666   </span>08/02<span style='mso-spacerun:yes'>  </span>202<span
3667   style='mso-spacerun:yes'>  </span>82<span style='mso-spacerun:yes'>  </span>e
3668   acute</p>
3669   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[â]<span
3670   style='mso-spacerun:yes'>  </span>131<span style='mso-spacerun:yes'>
3671   </span>08/03<span style='mso-spacerun:yes'>  </span>203<span
3672   style='mso-spacerun:yes'>  </span>83<span style='mso-spacerun:yes'>  </span>a
3673   circumflex</p>
3674   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ä]<span
3675   style='mso-spacerun:yes'>  </span>132<span style='mso-spacerun:yes'>
3676   </span>08/04<span style='mso-spacerun:yes'>  </span>204<span
3677   style='mso-spacerun:yes'>  </span>84<span style='mso-spacerun:yes'>  </span>a
3678   diaeresis</p>
3679   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[à]<span
3680   style='mso-spacerun:yes'>  </span>133<span style='mso-spacerun:yes'>
3681   </span>08/05<span style='mso-spacerun:yes'>  </span>205<span
3682   style='mso-spacerun:yes'>  </span>85<span style='mso-spacerun:yes'>  </span>a
3683   grave</p>
3684   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[å]<span
3685   style='mso-spacerun:yes'>  </span>134<span style='mso-spacerun:yes'>
3686   </span>08/06<span style='mso-spacerun:yes'>  </span>206<span
3687   style='mso-spacerun:yes'>  </span>86<span style='mso-spacerun:yes'>  </span>a
3688   ring</p>
3689   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ç]<span
3690   style='mso-spacerun:yes'>  </span>135<span style='mso-spacerun:yes'>
3691   </span>08/07<span style='mso-spacerun:yes'>  </span>207<span
3692   style='mso-spacerun:yes'>  </span>87<span style='mso-spacerun:yes'>  </span>c
3693   cedilla</p>
3694   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ê]<span
3695   style='mso-spacerun:yes'>  </span>136<span style='mso-spacerun:yes'>
3696   </span>08/08<span style='mso-spacerun:yes'>  </span>210<span
3697   style='mso-spacerun:yes'>  </span>88<span style='mso-spacerun:yes'>  </span>e
3698   circumflex</p>
3699   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ë]<span
3700   style='mso-spacerun:yes'>  </span>137<span style='mso-spacerun:yes'>
3701   </span>08/09<span style='mso-spacerun:yes'>  </span>211<span
3702   style='mso-spacerun:yes'>  </span>89<span style='mso-spacerun:yes'>  </span>e
3703   diaeresis</p>
3704   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[è]<span
3705   style='mso-spacerun:yes'>  </span>138<span style='mso-spacerun:yes'>
3706   </span>08/10<span style='mso-spacerun:yes'>  </span>212<span
3707   style='mso-spacerun:yes'>  </span>8A<span style='mso-spacerun:yes'>  </span>e
3708   grave</p>
3709   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ï]<span
3710   style='mso-spacerun:yes'>  </span>139<span style='mso-spacerun:yes'>
3711   </span>08/11<span style='mso-spacerun:yes'>  </span>213<span
3712   style='mso-spacerun:yes'>  </span>8B<span style='mso-spacerun:yes'>  </span>i
3713   diaeresis</p>
3714   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[î]<span
3715   style='mso-spacerun:yes'>  </span>140<span style='mso-spacerun:yes'>
3716   </span>08/12<span style='mso-spacerun:yes'>  </span>214<span
3717   style='mso-spacerun:yes'>  </span>8C<span style='mso-spacerun:yes'>  </span>i
3718   circumflex</p>
3719   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ì]<span
3720   style='mso-spacerun:yes'>  </span>141<span style='mso-spacerun:yes'>
3721   </span>08/13<span style='mso-spacerun:yes'>  </span>215<span
3722   style='mso-spacerun:yes'>  </span>8D<span style='mso-spacerun:yes'>  </span>i
3723   grave</p>
3724   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[Ä]<span
3725   style='mso-spacerun:yes'>  </span>142<span style='mso-spacerun:yes'>
3726   </span>08/14<span style='mso-spacerun:yes'>  </span>216<span
3727   style='mso-spacerun:yes'>  </span>8E<span style='mso-spacerun:yes'>  </span>A
3728   diaeresis</p>
3729   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[Å]<span
3730   style='mso-spacerun:yes'>  </span>143<span style='mso-spacerun:yes'>
3731   </span>08/15<span style='mso-spacerun:yes'>  </span>217<span
3732   style='mso-spacerun:yes'>  </span>8F<span style='mso-spacerun:yes'>  </span>A
3733   ring</p>
3734   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[É]<span
3735   style='mso-spacerun:yes'>  </span>144<span style='mso-spacerun:yes'>
3736   </span>09/00<span style='mso-spacerun:yes'>  </span>220<span
3737   style='mso-spacerun:yes'>  </span>90<span style='mso-spacerun:yes'>  </span>E
3738   acute</p>
3739   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[æ]<span
3740   style='mso-spacerun:yes'>  </span>145<span style='mso-spacerun:yes'>
3741   </span>09/01<span style='mso-spacerun:yes'>  </span>221<span
3742   style='mso-spacerun:yes'>  </span>91<span style='mso-spacerun:yes'>
3743   </span>ae diphthong</p>
3744   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[Æ]<span
3745   style='mso-spacerun:yes'>  </span>146<span style='mso-spacerun:yes'>
3746   </span>09/02<span style='mso-spacerun:yes'>  </span>222<span
3747   style='mso-spacerun:yes'>  </span>92<span style='mso-spacerun:yes'>
3748   </span>AE diphthong</p>
3749   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ô]<span
3750   style='mso-spacerun:yes'>  </span>147<span style='mso-spacerun:yes'>
3751   </span>09/03<span style='mso-spacerun:yes'>  </span>223<span
3752   style='mso-spacerun:yes'>  </span>93<span style='mso-spacerun:yes'>  </span>o
3753   circumflex</p>
3754   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ö]<span
3755   style='mso-spacerun:yes'>  </span>148<span style='mso-spacerun:yes'>
3756   </span>09/04<span style='mso-spacerun:yes'>  </span>224<span
3757   style='mso-spacerun:yes'>  </span>94<span style='mso-spacerun:yes'>  </span>o
3758   diaeresis</p>
3759   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ò]<span
3760   style='mso-spacerun:yes'>  </span>149<span style='mso-spacerun:yes'>
3761   </span>09/05<span style='mso-spacerun:yes'>  </span>225<span
3762   style='mso-spacerun:yes'>  </span>95<span style='mso-spacerun:yes'>  </span>o
3763   grave</p>
3764   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[û]<span
3765   style='mso-spacerun:yes'>  </span>150<span style='mso-spacerun:yes'>
3766   </span>09/06<span style='mso-spacerun:yes'>  </span>226<span
3767   style='mso-spacerun:yes'>  </span>96<span style='mso-spacerun:yes'>  </span>u
3768   circumflex</p>
3769   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ù]<span
3770   style='mso-spacerun:yes'>  </span>151<span style='mso-spacerun:yes'>
3771   </span>09/07<span style='mso-spacerun:yes'>  </span>227<span
3772   style='mso-spacerun:yes'>  </span>97<span style='mso-spacerun:yes'>  </span>u
3773   grave</p>
3774   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ÿ]<span
3775   style='mso-spacerun:yes'>  </span>152<span style='mso-spacerun:yes'>
3776   </span>09/08<span style='mso-spacerun:yes'>  </span>230<span
3777   style='mso-spacerun:yes'>  </span>98<span style='mso-spacerun:yes'>  </span>y
3778   diaeresis</p>
3779   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[Ö]<span
3780   style='mso-spacerun:yes'>  </span>153<span style='mso-spacerun:yes'>
3781   </span>09/09<span style='mso-spacerun:yes'>  </span>231<span
3782   style='mso-spacerun:yes'>  </span>99<span style='mso-spacerun:yes'>  </span>O
3783   diaeresis</p>
3784   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[Ü]<span
3785   style='mso-spacerun:yes'>  </span>154<span style='mso-spacerun:yes'>
3786   </span>09/10<span style='mso-spacerun:yes'>  </span>232<span
3787   style='mso-spacerun:yes'>  </span>9A<span style='mso-spacerun:yes'>  </span>U
3788   diaeresis</p>
3789   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ø]<span
3790   style='mso-spacerun:yes'>  </span>155<span style='mso-spacerun:yes'>
3791   </span>09/11<span style='mso-spacerun:yes'>  </span>233<span
3792   style='mso-spacerun:yes'>  </span>9B<span style='mso-spacerun:yes'>  </span>o
3793   slash</p>
3794   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[£]<span
3795   style='mso-spacerun:yes'>  </span>156<span style='mso-spacerun:yes'>
3796   </span>09/12<span style='mso-spacerun:yes'>  </span>234<span
3797   style='mso-spacerun:yes'>  </span>9C<span style='mso-spacerun:yes'>
3798   </span>Pound sterling sign</p>
3799   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[Ø]<span
3800   style='mso-spacerun:yes'>  </span>157<span style='mso-spacerun:yes'>
3801   </span>09/13<span style='mso-spacerun:yes'>  </span>235<span
3802   style='mso-spacerun:yes'>  </span>9D<span style='mso-spacerun:yes'>  </span>O
3803   slash</p>
3804   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[×]<span
3805   style='mso-spacerun:yes'>  </span>158<span style='mso-spacerun:yes'>
3806   </span>09/14<span style='mso-spacerun:yes'>  </span>236<span
3807   style='mso-spacerun:yes'>  </span>9E<span style='mso-spacerun:yes'>
3808   </span>Multiplication sign</p>
3809   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[]<span
3810   style='mso-spacerun:yes'>  </span>159<span style='mso-spacerun:yes'>
3811   </span>09/15<span style='mso-spacerun:yes'>  </span>237<span
3812   style='mso-spacerun:yes'>  </span>9F<span style='mso-spacerun:yes'>  </span><st2:place
3813   w:st="on">Florin</st2:place> sign</p>
3814   </td>
3815  </tr>
3816 </table>
3817
3818 <p class=PreformattedText><o:p>&nbsp;</o:p></p>
3819
3820 <p class=MsoNormal>OpenAFS 1.4 provides an optional registry value, <i><a
3821 href="#_Value___:_StoreAnsiFilenames">StoreAnsiFilenames</a></i>, that can be
3822 set to instruct OpenAFS to store filenames using the ANSI Code Page instead of
3823 the OEM Code Page.<span style='mso-spacerun:yes'>  </span>The ANSI Code Page is
3824 a compatible superset of Latin-1.<span style='mso-spacerun:yes'>  </span>This
3825 setting is not the default setting because making this change would prevent
3826 OpenAFS for Windows from being able to access filenames containing the above
3827 characters which were created without this setting.</p>
3828
3829 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416133"></a><a
3830 name="_Toc115417069"><span style='mso-bookmark:_Toc115416133'>3.27. Known
3831 Character Set Issues with Roaming Profiles</span></a></h2>
3832
3833 <p class=MsoNormal>There is a known issue with storing Windows Roaming Profiles
3834 when the profile contains either directories or files with names which cannot be
3835 represented in the local OEM character set.<span style='mso-spacerun:yes'>
3836 </span>In this case, attempts to write the profile back to AFS will fail.<span
3837 style='mso-spacerun:yes'>  </span>OpenAFS for Windows does not currently
3838 support UNICODE.<span style='mso-spacerun:yes'>  </span>To avoid this problem
3839 some sites run logoff scripts (assigned by group policy) which rename all files
3840 to use only the supported characters for the locale.</p>
3841
3842 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416134"></a><a
3843 name="_Toc115417070"><span style='mso-bookmark:_Toc115416134'>3.28. The
3844 AFSCache File</span></a></h2>
3845
3846 <p class=MsoNormal>The AFS Cache file is stored by default at %TEMP%\AFSCache
3847 in a persistent file marked with the Hidden and System attributes.<span
3848 style='mso-spacerun:yes'>  </span>The persistent nature of the data stored in
3849 the cache file improves the performance of OpenAFS by reducing the number of
3850 times data must be read from the AFS file servers.<span
3851 style='mso-spacerun:yes'>  </span></p>
3852
3853 <p class=MsoNormal>The performance of the AFS Client Service is significantly
3854 affected by the access times associated with the AFSCache paging file.<span
3855 style='mso-spacerun:yes'>   </span>When given the choice, the AFSCache file
3856 should be placed on a fast disk, preferably NTFS, the file should not be
3857 compressed and should consist of as few fragments as possible.<span
3858 style='mso-spacerun:yes'>   </span>Significant performance gains can be
3859 achieved by defragmenting the AFSCache file with Sysinternal's Contig utility.</p>
3860
3861 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416135"></a><a
3862 name="_Toc115417071"><span style='mso-bookmark:_Toc115416135'>3.29. Restricting
3863 OpenAFS Client Service Start and Stop</span></a></h2>
3864
3865 <p class=MsoNormal>A new command line tool, afsdacl.exe, can be used to
3866 restrict the ability to start and stop the OpenAFS Client Service.</p>
3867
3868 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>afsdacl :
3869 Set or reset the DACL to allow starting or stopping</p>
3870
3871 <p class=PreformattedText><span style='mso-spacerun:yes'>         </span>the
3872 afsd service by any ordinary user.</p>
3873
3874 <p class=PreformattedText><o:p>&nbsp;</o:p></p>
3875
3876 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>Usage :
3877 afsdacl [-set | -reset] [-show]</p>
3878
3879 <p class=PreformattedText><span style='mso-spacerun:yes'>
3880 </span>-set<span style='mso-spacerun:yes'>   </span>: Sets the DACL</p>
3881
3882 <p class=PreformattedText><span style='mso-spacerun:yes'>
3883 </span>-reset : Reset the DACL</p>
3884
3885 <p class=PreformattedText><span style='mso-spacerun:yes'>
3886 </span>-show<span style='mso-spacerun:yes'>  </span>: Show current DACL (SDSF)</p>
3887
3888 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416136"></a><a
3889 name="_Toc115417072"><span style='mso-bookmark:_Toc115416136'>3.30. The @sys
3890 Name List</span></a></h2>
3891
3892 <p class=MsoNormal>The default @sys name list in OpenAFS 1.4 is set to
3893 &quot;x86_win32 i386_w2k i386_nt40&quot; for 32-bit x86 systems.<span
3894 style='mso-spacerun:yes'>  </span>The default for itanium will be
3895 &quot;ia64_win64&quot; and &quot;amd64_win64&quot; for amd 64-bit processors
3896 when those platforms are supported.</p>
3897
3898 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416137"></a><a
3899 name="_Toc115417073"><span style='mso-bookmark:_Toc115416137'>3.31. Symlinks to
3900 AFS UNC paths</span></a></h2>
3901
3902 <p class=MsoNormal>In OpenAFS 1.4, symlinks to AFS UNC paths, \\AFS[\all]\...,
3903 are treated the same as symlinks to /afs/...<span style='mso-spacerun:yes'>
3904 </span>However, please use /afs/... as the Windows UNC form will not work on
3905 UNIX.</p>
3906
3907 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416138"></a><a
3908 name="_Toc115417074"><span style='mso-bookmark:_Toc115416138'>3.32. Cache
3909 Manager Debugging Now Supported</span></a></h2>
3910
3911 <p class=MsoNormal>OpenAFS for Windows 1.4 implements the Cache Manager
3912 Debugging RPC Interface.<span style='mso-spacerun:yes'>  </span>The CM debugger
3913 can be queried with cmdebug.exe.</p>
3914
3915 <p class=PreformattedText>Usage: cmdebug -servers &lt;server machine&gt; [-port
3916 &lt;IP port&gt;] [-long]</p>
3917
3918 <p class=PreformattedText><span style='mso-spacerun:yes'>
3919 </span>[-addrs] [-cache] [-help]</p>
3920
3921 <p class=PreformattedText>Where: -long<span style='mso-spacerun:yes'>
3922 </span>print all info</p>
3923
3924 <p class=PreformattedText><span style='mso-spacerun:yes'>
3925 </span>-addrs<span style='mso-spacerun:yes'>  </span>print only host interfaces</p>
3926
3927 <p class=PreformattedText><span style='mso-spacerun:yes'>
3928 </span>-cache<span style='mso-spacerun:yes'>  </span>print only cache
3929 configuration</p>
3930
3931 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416139"></a><a
3932 name="_Toc115417075"><span style='mso-bookmark:_Toc115416139'>3.33. Windows
3933 Logon Caching vs. Kerberos Logons</span></a></h2>
3934
3935 <p class=MsoNormal>If you are a site which utilizes MIT/Heimdal Kerberos
3936 principals to logon to Windows via a cross-realm relationship with a
3937 multi-domain Windows forest, you must enable Windows logon caching unless the
3938 workstation is Windows Vista Beta 1 or later.</p>
3939
3940 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416140"></a><a
3941 name="_Toc115417076"><span style='mso-bookmark:_Toc115416140'>3.34. Initial
3942 Server Preferences</span></a></h2>
3943
3944 <p class=MsoNormal>VLDB and File Server Preferences can now be provided initial
3945 values using registry keys.<span style='mso-spacerun:yes'>  </span>This is
3946 useful for managed machines in a Windows domain which are centrally located
3947 (e.g., in a computing lab.)<span style='mso-spacerun:yes'>  </span>See <a
3948 href="#_Appendix_A:_Registry_Values">Appendix A</a> for details on the &quot;<a
3949 href="#_Regkey:_[HKLMSOFTWAREOpenAFSClie_2">Server Preferences</a>&quot; keys.</p>
3950
3951 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416141"></a><a
3952 name="_Toc115417077"><span style='mso-bookmark:_Toc115416141'>3.35. File
3953 Timestamps</span></a></h2>
3954
3955 <p class=MsoNormal>OpenAFS 1.4 reports timestamps on files stored in AFS in UTC
3956 all year round.<span style='mso-spacerun:yes'>  </span>In locales with daylight
3957 savings time, previous versions of AFS for Windows reported the time when DST
3958 is active as UTC+1. <span style='mso-spacerun:yes'> </span>This was done to
3959 preserve the relative local time for the user.<span style='mso-spacerun:yes'>
3960 </span>A file stored at 11:00am EST in January would be reported as having been
3961 stored at 11:00am EDT in June.<span style='mso-spacerun:yes'>
3962 </span>Unfortunately, this has the negative side effect of changing the
3963 reported timestamp from 16:00UTC to 15:00UTC.<span style='mso-spacerun:yes'>
3964 </span>Since Windows treats all file times in UTC, data synchronization
3965 applications which rely on the timestamp would believe that all files stored in
3966 AFS had changed.</p>
3967
3968 <p class=MsoNormal>It should be noted that UNIX based operating systems (such
3969 as Solaris) do not appear to report file times to applications in UTC.<span
3970 style='mso-spacerun:yes'>  </span>They do preserve the relative local
3971 time.<span style='mso-spacerun:yes'>  </span>This may confuse some users who
3972 are used to being able to compare the timestamp in an UNIX shell with the
3973 timestamp from the Windows explorer.<span style='mso-spacerun:yes'>
3974 </span>During DST, these two times will no longer agree even though they are in
3975 fact representing the same moment in time.</p>
3976
3977 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416142"></a><a
3978 name="_Toc115417078"><span style='mso-bookmark:_Toc115416142'>3.36. Windows RPC
3979 client support must be installed</span></a> </h2>
3980
3981 <p class=MsoNormal>If the installer refuses to install and complains about an
3982 RPC configuration error, check to ensure that the following registry entries
3983 are present and that they refer to the dll &quot;rpcrt4.dll&quot;:</p>
3984
3985 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>HKLM
3986 &quot;SOFTWARE\Microsoft\RPC\ClientProtocols&quot; &quot;ncacn_np&quot;</p>
3987
3988 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>HKLM
3989 &quot;SOFTWARE\Microsoft\RPC\ClientProtocols&quot; &quot;ncacn_ip_tcp&quot;</p>
3990
3991 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>HKLM
3992 &quot;SOFTWARE\Microsoft\RPC\ClientProtocols&quot; &quot;ncadg_ip_udp&quot;</p>
3993
3994 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>HKLM
3995 &quot;SOFTWARE\Microsoft\RPC\ClientProtocols&quot; &quot;ncacn_http&quot;</p>
3996
3997 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416143"></a><a
3998 name="_Toc115417079"><span style='mso-bookmark:_Toc115416143'>3.37. Generating
3999 Minidumps of the OpenAFS Client Service</span></a></h2>
4000
4001 <p class=MsoNormal>OpenAFS 1.4 adds a new command, &quot;fs
4002 minidump&quot;.<span style='mso-spacerun:yes'>  </span>This command can be used
4003 at any time to generate a mini dump file containing the current stack of the
4004 afsd_service.exe process.<span style='mso-spacerun:yes'>   </span>This output
4005 can be very helpful when debugging the AFS Client Service when it is
4006 unresponsive to SMB/CIFS requests.</p>
4007
4008 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416144"></a><a
4009 name="_Toc115417080"><span style='mso-bookmark:_Toc115416144'>3.38. AFS Client
4010 Universally Unique Identifiers</span></a></h2>
4011
4012 <p class=MsoNormal>The OpenAFS for Windows 1.4 client implements Universally
4013 Unique Identifiers (UUIDs).<span style='mso-spacerun:yes'>  </span>They are
4014 used to provide the server with a method of identifying the client that is
4015 independent of IP address.<span style='mso-spacerun:yes'>  </span>The UUID is
4016 generated when the AFSCache file is created and is maintained as long as the
4017 contents of the AFSCache file are kept intact.<span style='mso-spacerun:yes'>
4018 </span>The UUID is stored in the AFSCache file.<span
4019 style='mso-spacerun:yes'>   </span>When cloning machines that have Windows AFS
4020 client installed, the AFSCache files must be deleted as part of the cloning
4021 process.</p>
4022
4023 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416145"></a><a
4024 name="_Toc115417081"></a><a name="_Toc115417112"><span style='mso-bookmark:
4025 _Toc115417081'><span style='mso-bookmark:_Toc115416145'>4. How to Debug Problems
4026 with OpenAFS for Windows:</span></span></a></h1>
4027
4028 <p class=MsoNormal>OpenAFS for Windows provides a wide range of tools to assist
4029 you in debugging problems.<span style='mso-spacerun:yes'>  </span>The
4030 techniques available to you are varied because of the wide range of issues that
4031 have been discovered over the years.</p>
4032
4033 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416146"></a><a
4034 name="_Toc115417082"><span style='mso-bookmark:_Toc115416146'>4.1. pioctl
4035 debugging (</span></a><a href="#_Value___:_IoctlDebug"><span style='mso-bookmark:
4036 _Toc115417082'><span style='mso-bookmark:_Toc115416146'>IoctlDebug</span></span><span
4037 style='mso-bookmark:_Toc115417082'><span style='mso-bookmark:_Toc115416146'></span></span></a><span
4038 style='mso-bookmark:_Toc115417082'><span style='mso-bookmark:_Toc115416146'>
4039 registry key)</span></span></h2>
4040
4041 <p class=MsoNormal>pioctl (path-based ioctl) calls are used by various tools to
4042 communicate with the AFS Client Service.<span style='mso-spacerun:yes'>
4043 </span>Some of the operations performed include:</p>
4044
4045 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4046 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4047 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4048 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4049 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4050 tokens<span style='mso-spacerun:yes'>  </span>(tokens.exe, aklog.exe,
4051 afscreds.exe)</p>
4052
4053 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4054 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4055 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4056 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4057 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4058 ACLs </p>
4059
4060 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4061 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4062 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4063 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4064 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4065 cache parameters</p>
4066
4067 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4068 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4069 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4070 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4071 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>flushing
4072 files or volumes</p>
4073
4074 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4075 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4076 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4077 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4078 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4079 server preferences</p>
4080
4081 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4082 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4083 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4084 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4085 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>querying
4086 path location</p>
4087
4088 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4089 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4090 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4091 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4092 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>checking
4093 the status of servers and volumes</p>
4094
4095 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4096 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4097 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4098 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4099 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4100 the sysname list</p>
4101
4102 <p class=MsoNormal>pioctl calls are implemented by writing to a special UNC
4103 path that is processed by the AFS Client Service.<span
4104 style='mso-spacerun:yes'>   </span>If there is a failure to communicate with
4105 the AFS Client Service via SMB/CIFS, it will be impossible to perform any of
4106 the above operations.<span style='mso-spacerun:yes'>   </span></p>
4107
4108 <p class=MsoNormal>To assist in debugging these problems, the registry value:</p>
4109
4110 <p class=PreformattedText><span style='mso-spacerun:yes'>
4111 </span>[HKLM\SOFTWARE\OpenAFS\Client]</p>
4112
4113 <p class=PreformattedText><span style='mso-spacerun:yes'>
4114 </span>REG_DWORD:<span style='mso-spacerun:yes'>  </span>IoctlDebug<span
4115 style='mso-spacerun:yes'>   </span>= 0x01</p>
4116
4117 <p class=MsoNormal>should be set.<span style='mso-spacerun:yes'>  </span>Then
4118 any of the commands that perform pioctl calls should be executed from the
4119 command prompt.<span style='mso-spacerun:yes'>  </span>With this key set the
4120 pioctl library will generate debugging output to stderr.<span
4121 style='mso-spacerun:yes'>  </span>The output will contain the Win32 API calls
4122 executed along with their most important parameters and their return code.<span
4123 style='mso-spacerun:yes'>   </span>The MSDN Library and the Microsoft
4124 KnowledgeBase can be used as a reference to help you determine the
4125 configuration probem with your system.</p>
4126
4127 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416147"></a><a
4128 name="_Toc115417083"><span style='mso-bookmark:_Toc115416147'>4.2. afsd_service
4129 initialization log (%WinDir%\TEMP\afsd_init.log)</span></a></h2>
4130
4131 <p class=MsoNormal>Every time the AFS Client Service starts it appends data
4132 about its progress and configuration to a file.<span style='mso-spacerun:yes'>
4133 </span>This file provides information crucial to determining why the service
4134 cannot start when there are problems.<span style='mso-spacerun:yes'>
4135 </span>When the process terminates due to a panic condition it will write to
4136 this file the source code file and line number of the error.<span
4137 style='mso-spacerun:yes'>  </span>In many cases the panic condition is due to a
4138 misconfiguration of the machine.<span style='mso-spacerun:yes'>  </span>In
4139 other cases it might be due to a programming error in the software.<span
4140 style='mso-spacerun:yes'>  </span>A quick review of the location in the source
4141 code will quickly reveal the reason for the termination.</p>
4142
4143 <p class=MsoNormal>The <i style='mso-bidi-font-style:normal'><a
4144 href="#_Value___:_MaxLogSize">MaxLogSize</a></i> registry value determines the
4145 maximum size of the %WINDIR%\TEMP\afsd_init.log file.<span
4146 style='mso-spacerun:yes'>  </span>If the file is larger than this value when
4147 OpenAFS Client Service starts, the file will be reset to 0 bytes.<span
4148 style='mso-spacerun:yes'>  </span>If value is set to 0, the file will be
4149 allowed to grow indefinitely.</p>
4150
4151 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416148"></a><a
4152 name="_Toc115417084"><span style='mso-bookmark:_Toc115416148'>4.3. afsd_service
4153 debug logs (fs trace {-on, -off, -dump} -&gt;%WinDir%\TEMP\afsd.log)</span></a></h2>
4154
4155 <p class=MsoNormal>When attempting to debug the behavior of the SMB/CIFS Server
4156 and the Cache Manager it is often useful to examine a log of the operations
4157 being performed.<span style='mso-spacerun:yes'>  </span>While running the AFS
4158 Client Service keeps an in memory log of many of its actions.<span
4159 style='mso-spacerun:yes'>   </span>The default number of actions preserved at
4160 any one time is 5000.<span style='mso-spacerun:yes'>  </span>This can be
4161 adjusted with the <a href="#_Value_:_TraceBufferSize">registry value</a>:</p>
4162
4163 <p class=PreformattedText><span style='mso-spacerun:yes'>
4164 </span>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
4165
4166 <p class=PreformattedText><span style='mso-spacerun:yes'>
4167 </span>REG_DWORD<span style='mso-spacerun:yes'>  </span>TraceBufferSize </p>
4168
4169 <p class=MsoNormal>A restart of the service is necessary when adjusting this
4170 value.<span style='mso-spacerun:yes'>   </span>Execute &quot;fs trace -on&quot;
4171 to clear to the log and &quot;fs trace -dump&quot; to output the contents of
4172 the log to the file.</p>
4173
4174 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416149"></a><a
4175 name="_Toc115417085"><span style='mso-bookmark:_Toc115416149'>4.4. Using
4176 SysInternals DbgView and FileMon Tools</span></a></h2>
4177
4178 <p class=MsoNormal>An alternatve option to the use of &quot;fs trace
4179 -dump&quot; to capture internal OpenAFS Client Service events is to use a tool
4180 such as Sysinternal's DbgView to capture real-time debugging output.<span
4181 style='mso-spacerun:yes'>  </span>When the OpenAFS Client Service starts and
4182 Bit 2 of the <a href="#_Value__:_TraceOption">TraceOption</a> value in the
4183 registry is set, all trace log events are output using the Windows Debug
4184 Monitor interface (OutputDebugString). <span style='mso-spacerun:yes'> </span></p>
4185
4186 <p class=PreformattedText><span style='mso-spacerun:yes'>
4187 </span>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
4188
4189 <p class=PreformattedText style='text-indent:12.0pt'>REG_DWORD<span
4190 style='mso-spacerun:yes'>   </span>TraceOption = 0x04</p>
4191
4192 <p class=MsoNormal>Use fs trace on and fs trace off to toggle the
4193 generation of log messages. </p>
4194
4195 <p class=MsoNormal>Sysinternals FileMon utility can be use to monitor the file
4196 operations requested by applications and their success or failure.<span
4197 style='mso-spacerun:yes'>   </span>Restrict FileMon to monitor Network Volumes
4198 only in order to reduce the output to just the CIFS requests.<span
4199 style='mso-spacerun:yes'>   </span></p>
4200
4201 <p class=MsoNormal>Turn on the <i style='mso-bidi-font-style:normal'>Clock Time</i>
4202 option in both tools to make it easier to synchronize the application requests
4203 and the resulting OpenAFS Client Service operations.<span
4204 style='mso-spacerun:yes'>   </span>The captured data can be stored to files for
4205 inclusion in bug reports.</p>
4206
4207 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416150"></a><a
4208 name="_Toc115417086"><span style='mso-bookmark:_Toc115416150'>4.5. Microsoft
4209 MiniDumps <br>
4210 (fs minidump -&gt; %WinDir%\TEMP\afsd.dmp)</span></a></h2>
4211
4212 <p class=MsoNormal>If the AFS Client Service become unresponsive to any form of
4213 communication there may be a serious error that can only be debugged by someone
4214 with access to the source code and a debugger.<span style='mso-spacerun:yes'>
4215 </span>The &quot;fs minidump&quot; command can be used to force the generation
4216 of a MiniDump file containing the state of all of the threads in the AFS Client
4217 Service process.</p>
4218
4219 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416151"></a><a
4220 name="_Toc115417087"><span style='mso-bookmark:_Toc115416151'>4.6. Single
4221 Sign-on (Integrated Logon) debugging</span></a></h2>
4222
4223 <p class=MsoNormal>If you are having trouble with the Integrated Logon
4224 operations it is often useful to be able to obtain a log of what it is
4225 attempting to do.<span style='mso-spacerun:yes'>   </span>Setting Bit 0 of the <a
4226 href="#_Value__:_TraceOption">TraceOption</a> registry value:</p>
4227
4228 <p class=PreformattedText><span style='mso-spacerun:yes'>
4229 </span>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
4230
4231 <p class=PreformattedText><span style='mso-spacerun:yes'>
4232 </span>REG_DWORD<span style='mso-spacerun:yes'>   </span>TraceOption = 0x01</p>
4233
4234 <p class=MsoNormal>will instruct the Integrated Logon Network Provider and
4235 Event Handlers to log information to the Windows Event Log: Application under
4236 the name AFS Logon&quot;.</p>
4237
4238 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416152"></a><a
4239 name="_Toc115417088"><span style='mso-bookmark:_Toc115416152'>4.7. RX (AFS RPC)
4240 debugging (rxdebug)</span></a></h2>
4241
4242 <p class=MsoNormal>The rxdebug.exe tool can be used to query a variety of
4243 information about the AFS services installed on a given machine.<span
4244 style='mso-spacerun:yes'>  </span>The port for the AFS Cache Manager is
4245 7001.<span style='mso-spacerun:yes'>  </span></p>
4246
4247 <p class=PreformattedText>Usage: rxdebug -servers &lt;server machine&gt; [-port
4248 &lt;IP port&gt;] [-nodally] </p>
4249
4250 <p class=PreformattedText style='margin-left:35.45pt;text-indent:35.45pt'><span
4251 style='mso-spacerun:yes'>   </span>[-allconnections] [-rxstats] [-onlyserver]
4252 [-onlyclient] </p>
4253
4254 <p class=PreformattedText style='margin-left:70.9pt'><span
4255 style='mso-spacerun:yes'>   </span>[-onlyport &lt;show only &lt;port&gt;&gt;] </p>
4256
4257 <p class=PreformattedText style='margin-left:70.9pt'><span
4258 style='mso-spacerun:yes'>   </span>[-onlyhost &lt;show only &lt;host&gt;&gt;] </p>
4259
4260 <p class=PreformattedText style='margin-left:70.9pt'><span
4261 style='mso-spacerun:yes'>   </span>[-onlyauth &lt;show only &lt;auth
4262 level&gt;&gt;] [-version] </p>
4263
4264 <p class=PreformattedText style='margin-left:70.9pt'><span
4265 style='mso-spacerun:yes'>   </span>[-noconns] [-peers] [-help]</p>
4266
4267 <p class=PreformattedText>Where: -nodally<span
4268 style='mso-spacerun:yes'>         </span>don't show dallying conns</p>
4269
4270 <p class=PreformattedText><span style='mso-spacerun:yes'>
4271 </span>-allconnections<span style='mso-spacerun:yes'>  </span>don't filter out
4272 uninteresting connections</p>
4273
4274 <p class=PreformattedText><span style='mso-spacerun:yes'>
4275 </span>-rxstats<span style='mso-spacerun:yes'>         </span>show Rx
4276 statistics</p>
4277
4278 <p class=PreformattedText><span style='mso-spacerun:yes'>
4279 </span>-onlyserver<span style='mso-spacerun:yes'>      </span>only show server
4280 conns</p>
4281
4282 <p class=PreformattedText><span style='mso-spacerun:yes'>
4283 </span>-onlyclient<span style='mso-spacerun:yes'>      </span>only show client
4284 conns</p>
4285
4286 <p class=PreformattedText><span style='mso-spacerun:yes'>
4287 </span>-version<span style='mso-spacerun:yes'>         </span>show AFS version
4288 id</p>
4289
4290 <p class=PreformattedText><span style='mso-spacerun:yes'>
4291 </span>-noconns<span style='mso-spacerun:yes'>         </span>show no
4292 connections</p>
4293
4294 <p class=PreformattedText><span style='mso-spacerun:yes'>
4295 </span>-peers<span style='mso-spacerun:yes'>           </span>show peers</p>
4296
4297 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416153"></a><a
4298 name="_Toc115417089"><span style='mso-bookmark:_Toc115416153'>4.8. Cache
4299 Manager debugging (cmdebug)</span></a></h2>
4300
4301 <p class=MsoNormal>The cmdebug.exe tool can be used to query the state of the
4302 AFS Cache Manager on a given machine.</p>
4303
4304 <p class=PreformattedText>Usage: cmdebug -servers &lt;server machine&gt; [-port
4305 &lt;IP port&gt;] [-long] </p>
4306
4307 <p class=PreformattedText style='margin-left:70.9pt'><span
4308 style='mso-spacerun:yes'>   </span>[-refcounts] [-callbacks] [-addrs] [-cache]
4309 [-help]</p>
4310
4311 <p class=PreformattedText>Where: -long<span style='mso-spacerun:yes'>
4312 </span>print all info</p>
4313
4314 <p class=PreformattedText><span style='mso-spacerun:yes'>  </span><span
4315 style='mso-spacerun:yes'>     </span>-refcounts<span style='mso-spacerun:yes'>
4316 </span>print only cache entries with positive reference counts</p>
4317
4318 <p class=PreformattedText><span style='mso-spacerun:yes'>
4319 </span>-callbacks<span style='mso-spacerun:yes'>  </span>print only cache
4320 entries with callbacks</p>
4321
4322 <p class=PreformattedText><span style='mso-spacerun:yes'>
4323 </span>-addrs<span style='mso-spacerun:yes'>      </span>print only host
4324 interfaces</p>
4325
4326 <p class=PreformattedText><span style='mso-spacerun:yes'>
4327 </span>-cache<span style='mso-spacerun:yes'>      </span>print only cache
4328 configuration</p>
4329
4330 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416154"></a><a
4331 name="_Toc115417090"><span style='mso-bookmark:_Toc115416154'>4.9. Persistent
4332 Cache consistency check</span></a></h2>
4333
4334 <p class=MsoNormal>The persistent cache is stored in a Hidden System file at
4335 %WinDir%\TEMP\AFSCache.<span style='mso-spacerun:yes'>  </span>If there is a
4336 problem with the persistent cache that prevent the AFS Client Service from
4337 being able to start a validation check on the file can be performed.</p>
4338
4339 <p class=PreformattedText><span style='mso-spacerun:yes'>  </span>afsd_service.exe
4340 --validate-cache &lt;cache-path&gt;</p>
4341
4342 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416155"></a><a
4343 name="_Toc115417091"></a><a name="_Toc115417113"><span style='mso-bookmark:
4344 _Toc115417091'><span style='mso-bookmark:_Toc115416155'>5. Reporting Bugs:</span></span></a></h1>
4345
4346 <p class=MsoNormal>Bug reports should be sent to <a
4347 href="mailto:openafs-bugs@openafs.org?subject=Bug%20Report">openafs-bugs@openafs.org</a>.<span
4348 style='mso-spacerun:yes'>  </span>Please include as much information as
4349 possible about the issue.<span style='mso-spacerun:yes'>  </span>If you are
4350 reporting a crash, please install the debugging symbols by re-running the
4351 installer.<span style='mso-spacerun:yes'>  </span>If a dump file is available
4352 for the problem, %WINDIR%\TEMP\afsd.dmp, include it along with the AFS Client
4353 Trace file<span style='mso-spacerun:yes'>  </span>%WINDIR%\TEMP\afsd.log.<span
4354 style='mso-spacerun:yes'>  </span>The AFS Client startup log is
4355 %WINDIR%\TEMP\afsd_init.log.<span style='mso-spacerun:yes'>  </span>Send the
4356 last continuous block of<span style='mso-spacerun:yes'>  </span>log information
4357 from this file.</p>
4358
4359 <p class=MsoNormal>Configuring DrWatson to generate dump files for crashes:</p>
4360
4361 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
4362 l8 level1 lfo20;tab-stops:list 14.15pt'><![if !supportLists]><span
4363 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4364 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4365 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Run
4366 drwtsn32.exe to configure or to identify where the log and the crash dump files
4367 are created: </p>
4368
4369 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4370 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4371 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4372 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4373 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>click
4374 Start &gt; Run...<span style='mso-spacerun:yes'>  </span></p>
4375
4376 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4377 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4378 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4379 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4380 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>type
4381 drwtsn32 &lt;enter&gt;. </p>
4382
4383 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4384 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4385 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4386 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4387 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Select
4388 either a Crash Dump Type: Mini or Full. </p>
4389
4390 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4391 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4392 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4393 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4394 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Clear
4395 Dump Symbol Table</p>
4396
4397 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4398 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4399 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4400 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4401 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Clear
4402 Append to Existing Log file. </p>
4403
4404 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4405 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4406 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4407 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4408 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Check
4409 Dump All Thread Contexts.</p>
4410
4411 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4412 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4413 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4414 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4415 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Check
4416 Create Crash Dump File</p>
4417
4418 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
4419 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4420 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4421 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4422 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Next
4423 run the monitoring module of Dr. Watson: </p>
4424
4425 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4426 l10 level1 lfo24;tab-stops:list 14.15pt'><![if !supportLists]><span
4427 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4428 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4429 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>click
4430 Start &gt; Run...</p>
4431
4432 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4433 l10 level1 lfo24;tab-stops:list 14.15pt'><![if !supportLists]><span
4434 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4435 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4436 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>type
4437 drwatson &lt;enter&gt;. </p>
4438
4439 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4440 l10 level1 lfo24;tab-stops:list 14.15pt'><![if !supportLists]><span
4441 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4442 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4443 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Once
4444 a crash happens, Dr. Watson generates a dump file and a report in the log file,
4445 including the address of the crash and the stack dump.</p>
4446
4447 <p class=MsoNormal>Once you have the Dr. Watson's logfile and minidump, zip
4448 them and attach them to your e-mail.</p>
4449
4450 <p class=MsoNormal>When reporting a error, please be sure to include the
4451 version of OpenAFS.</p>
4452
4453 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416156"></a><a
4454 name="_Toc115417092"></a><a name="_Toc115417114"><span style='mso-bookmark:
4455 _Toc115417092'><span style='mso-bookmark:_Toc115416156'>6. How to Contribute to
4456 the Development of OpenAFS for Windows</span></span></a></h1>
4457
4458 <p class=MsoNormal>Contributions to the development of OpenAFS for Windows are
4459 continuously needed.<span style='mso-spacerun:yes'>  </span>Contributions may
4460 take many forms including cash donations, support contracts, donated developer
4461 time, and even donated tech writer time.</p>
4462
4463 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416157"></a><a
4464 name="_Toc115417093"><span style='mso-bookmark:_Toc115416157'>6.1. The USENIX
4465 OpenAFS Fund</span></a> </h2>
4466
4467 <p class=MsoBodyText><a href="http://www.usenix.org/">USENIX</a>, a 501c3
4468 non-profit corporation, has formed the USENIX OpenAFS Fund in order to accept
4469 tax deductible donations on behalf of the OpenAFS Elders. The donated funds
4470 will be allocated by the OpenAFS Elders to fund OpenAFS development, documentation,
4471 project management, and maintaining openafs.org. </p>
4472
4473 <div style='mso-element:frame;mso-element-frame-height:66.05pt;mso-element-wrap:
4474 no-wrap-beside;mso-element-anchor-vertical:page;mso-element-anchor-horizontal:
4475 column;mso-element-left:.05pt;mso-element-top:372.8pt;mso-height-rule:exactly'>
4476
4477 <table cellspacing=0 cellpadding=0 hspace=0 vspace=0 width=540 height=88>
4478  <tr>
4479   <td valign=top align=left height=88 style='padding-top:0pt;padding-right:
4480   9.0pt;padding-bottom:0pt;padding-left:9.0pt'>
4481   <p class=MsoEnvelopeAddress style='mso-element:frame;mso-element-frame-height:
4482   66.05pt;mso-element-wrap:no-wrap-beside;mso-element-anchor-vertical:page;
4483   mso-element-anchor-horizontal:column;mso-element-left:.05pt;mso-element-top:
4484   372.8pt;mso-height-rule:exactly'>USENIX OpenAFS Fund<br>
4485   USENIX Association <br>
4486 <st2:address w:st="on"><st2:Street w:st="on">2560 Ninth St., Suite 215</st2:Street>
4487    <br>
4488 <st2:City w:st="on">Berkeley</st2:City>, <st2:State w:st="on">CA</st2:State> <st2:PostalCode
4489    w:st="on">94710</st2:PostalCode></st2:address> </p>
4490   </td>
4491  </tr>
4492 </table>
4493
4494 </div>
4495
4496 <![if !supportTextWrap]><br clear=ALL>
4497 <![endif]>
4498
4499 <p class=MsoBodyText>Donations can be made by sending a check, drawn on a U.S.
4500 bank, made out to the USENIX OpenAFS Fund or by making a <a
4501 href="https://db.usenix.org/cgi-bin/openafs/openafs.cgi">donation online</a>.</p>
4502
4503 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417094">6.2. Secure
4504 Endpoints Inc.</a> </h2>
4505
4506 <p class=MsoBodyText><a href="http://www.secure-endpoints.com/">Secure
4507 Endpoints Inc.</a> provides development and support services for OpenAFS for
4508 Windows and MIT Kerberos for Windows.<span style='mso-spacerun:yes'>
4509 </span>Donations provided to Secure Endpoints Inc. for the development of
4510 OpenAFS are used to cover the OpenAFS gatekeeper responsibilities; providing
4511 support to the OpenAFS community via the OpenAFS mailing lists; and furthering
4512 development of desired features that are either too small to be financed by
4513 development contracts.</p>
4514
4515 <p class=MsoBodyText>Secure Endpoints Inc. accepts software development
4516 agreements from organizations who wish to fund a well-defined set of bug fixes
4517 or new features. </p>
4518
4519 <p class=MsoBodyText>Secure Endpoints Inc. provides contract based support for
4520 the OpenAFS for Windows and the MIT Kerberos for Windows products. </p>
4521
4522 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417095">6.3. The
4523 MIT Kerberos Account</a> </h2>
4524
4525 <p class=MsoNormal style='margin:0pt;margin-bottom:.0001pt;mso-pagination:widow-orphan;
4526 mso-hyphenate:auto;mso-layout-grid-align:none;text-autospace:none'><span
4527 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
4528 color:black'>Th</span><span class=BodyTextChar>e <a
4529 href="http://web.mit.edu/kerberos/">MIT Kerberos</a> development team accepts
4530 unrestricted grants.<span style='mso-spacerun:yes'>  </span>Grants are tax
4531 deductible and the full amount of the grant will be used to fund the
4532 development of Kerberos 5 and/or Kerberos for Windows.<span
4533 style='mso-spacerun:yes'>  </span>OpenAFS for Windows is dependent on MIT
4534 Kerberos for Windows for authentication and shares many of the same re</span><span
4535 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
4536 color:black'>quirements for credential management.<span
4537 style='mso-spacerun:yes'>  </span>Future releases of both products will share a
4538 common identity management user interface. <o:p></o:p></span></p>
4539
4540 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417096">6.4. Direct
4541 contributions of code and/or documentation</a> </h2>
4542
4543 <p class=MsoBodyText>Organizations that use OpenAFS in house and have
4544 development staffs are encouraged to contribute any code modifications they
4545 make to OpenAFS.org via <u><span style='color:blue'>openafs-bugs@openafs.org</span></u>.<span
4546 style='mso-spacerun:yes'>  </span>Contributions of documentation are highly
4547 desired. </p>
4548
4549 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417097">6.5.
4550 OpenAFS for Windows Mailing Lists</a></h2>
4551
4552 <p class=MsoNormal>If you wish to participate in OpenAFS for Windows
4553 development please join the <i><a
4554 href="mailto:openafs-win32-devel@openafs.org?subject=OpenAFS%20for%20Windows%20Development%20Contribution">openafs-win32-devel@openafs.org</a></i>
4555 mailing list.</p>
4556
4557 <p class=MsoNormal style='margin-left:35.45pt'><span class=MsoHyperlink>https://lists.openafs.org/mailman/listinfo/openafs-win32-devel<o:p></o:p></span></p>
4558
4559 <p class=MsoNormal>User questions should be sent to the <a
4560 href="mailto:openafs-info@openafs.org?subject=OpenAFS%20for%20Windows%20User%20Question">openafs-info@openafs.org</a>
4561 mailing list.<span style='mso-spacerun:yes'>  </span></p>
4562
4563 <p class=MsoNormal style='margin-left:35.45pt'><span class=MsoHyperlink>https://lists.openafs.org/mailman/listinfo/openafs-info<o:p></o:p></span></p>
4564
4565 <p class=MsoNormal>You must join the mailing lists if you wish to post to the
4566 list without incurring a moderation delay.</p>
4567
4568 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417115"></a><a
4569 name="_Toc115417098"></a><a name="_Toc115416158"></a><a
4570 name="_MSI_Deployment_Guide"></a><![if !supportLists]><span style='mso-bookmark:
4571 _Toc115417115'><span style='mso-bookmark:_Toc115417098'><span style='mso-bookmark:
4572 _Toc115416158'></span></span></span><![endif]><span style='mso-bookmark:_Toc115417115'><span
4573 style='mso-bookmark:_Toc115417098'><span style='mso-bookmark:_Toc115416158'>7.
4574 MSI Deployment Guide</span></span></span></h1>
4575
4576 </div>
4577
4578 <b><span style='font-size:16.0pt;font-family:Albany;mso-fareast-font-family:
4579 "MS Mincho";mso-bidi-font-family:Tahoma;mso-ansi-language:EN-US;mso-fareast-language:
4580 JA;mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always;
4581 mso-break-type:section-break'>
4582 </span></b>
4583
4584 <div class=Section2>
4585
4586 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416159"></a><a
4587 name="_Toc115417099"><span style='mso-bookmark:_Toc115416159'>7.1. Introduction</span></a></h2>
4588
4589 <p class=MsoNormal>A MSI installer option is available for those who wish to
4590 use Windows Installer for installing OpenAFS and for organizations that wish to
4591 deploy OpenAFS through Group Policy.<span style='mso-spacerun:yes'>  </span>The
4592 first version of OpenAFS for Windows available as an MSI was 1.3.65.</p>
4593
4594 <p class=MsoNormal>This document provides a guide for authoring transforms used
4595 to customize the MSI package for a particular organization.<span
4596 style='mso-spacerun:yes'>  </span>Although many settings can be deployed via
4597 transforms, in an Active Directory environment it is advisable to deploy
4598 registry settings<span style='mso-spacerun:yes'>    </span>and configuration
4599 files through group policy and/or startup scripts so that machines where
4600 OpenAFS for Windows is already installed will pick up these customizations.</p>
4601
4602 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416160">7.1.1
4603 Requirements</a></h3>
4604
4605 <p class=MsoNormal>The information in this document applies to MSI packages
4606 distributed with OpenAFS for Windows releases from 1.3.65 and onwards or MSI
4607 packages built from corresponding source releases.<span
4608 style='mso-spacerun:yes'>  </span>Not all releases support all the
4609 configuration options documented here.</p>
4610
4611 <p class=MsoNormal>Authoring a &quot;Windows Installer&quot; transform requires
4612 additional software for editing the MSI database tables and generating the
4613 transform from the modified MSI package.<span style='mso-spacerun:yes'>
4614 </span>ORCA.EXE and MSITRAN.EXE which are included in the Windows Platform SDK
4615 (&quot;Windows Installer&quot; SDK) can be used for this purpose.</p>
4616
4617 <p class=MsoNormal>For reference, the schema for the MSI package is based on
4618 SCHEMA.MSI distributed with the Platform SDK.</p>
4619
4620 <p class=MsoNormal>For general information about &quot;Windows Installer&quot;,
4621 refer to:</p>
4622
4623 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><a
4624 href="http://msdn.microsoft.com/library/en-us/msi/setup/windows_installer_start_page.asp">http://msdn.microsoft.com/library/en-us/msi/setup/windows_installer_start_page.asp</a></p>
4625
4626 <p class=MsoNormal>For general information about authoring MSI transforms,
4627 refer to:</p>
4628
4629 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><a
4630 href="http://msdn.microsoft.com/library/en-us/msi/setup/transforms.asp">http://msdn.microsoft.com/library/en-us/msi/setup/transforms.asp</a></p>
4631
4632 <p class=MsoNormal>The remainder of this document assumes some familiarity with
4633 authoring transforms.<span style='mso-spacerun:yes'>  </span>While the MSDN
4634 documentation for Windows Installer is a bit dense, the guide on MSI transforms
4635 found at the second link above is recommended reading.<span
4636 style='mso-spacerun:yes'>  </span>MSDN also includes a step-by-step example for
4637 creating a transform at:</p>
4638
4639 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><a
4640 href="http://msdn.microsoft.com/library/en-us/msi/setup/a_customization_transform_example.asp">http://msdn.microsoft.com/library/en-us/msi/setup/a_customization_transform_example.asp</a></p>
4641
4642 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416161">7.1.2
4643 Authoring a Transform</a></h3>
4644
4645 <p class=MsoNormal>Transforms describe a set of modifications to be performed
4646 on an existing MSI for the purpose of customizing it.<span
4647 style='mso-spacerun:yes'>  </span>This is ordinarily done by making a copy of
4648 the MSI to be customized, modifying the copy and then using the old and the new
4649 MSI to generate a transform.<span style='mso-spacerun:yes'>  </span>For
4650 example:</p>
4651
4652 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
4653 mso-list:l17 level1 lfo26;tab-stops:list 36.0pt'><![if !supportLists]><span
4654 style='mso-list:Ignore'>1.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;
4655 </span></span><![endif]>copy openafs.msi openafs-modified.msi</p>
4656
4657 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
4658 mso-list:l17 level1 lfo26;tab-stops:list 36.0pt'><![if !supportLists]><span
4659 style='mso-list:Ignore'>2.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;
4660 </span></span><![endif]>(edit the openafs-modified.msi to include the necessary
4661 changes)</p>
4662
4663 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
4664 mso-list:l17 level1 lfo26;tab-stops:list 36.0pt'><![if !supportLists]><span
4665 style='mso-list:Ignore'>3.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;
4666 </span></span><![endif]>msitran -g openafs.msi openafs-modified.msi
4667 openafs-transform.mst</p>
4668
4669 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
4670 mso-list:l17 level1 lfo26;tab-stops:list 36.0pt'><![if !supportLists]><span
4671 style='mso-list:Ignore'>4.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;
4672 </span></span><![endif]>(generates openafs-transform.mst, which is the
4673 transform)</p>
4674
4675 <p class=MsoNormal>Transforms have an extension of .mst.<span
4676 style='mso-spacerun:yes'>  </span>'msitran' is a tool distributed as part of
4677 the &quot;Windows Installer&quot; SDK (part of the Windows Platform SDK).</p>
4678
4679 <p class=MsoNormal>You can test a transform by:</p>
4680
4681 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
4682 mso-list:l16 level1 lfo28;tab-stops:list 36.0pt'><![if !supportLists]><span
4683 style='mso-list:Ignore'>1.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;
4684 </span></span><![endif]>copy openafs.msi openafs-test.msi</p>
4685
4686 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
4687 mso-list:l16 level1 lfo28;tab-stops:list 36.0pt'><![if !supportLists]><span
4688 style='mso-list:Ignore'>2.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;
4689 </span></span><![endif]>msitran -a openafs-transform.mst openafs-test.msi</p>
4690
4691 <p class=MsoNormal>and then checking the resulting openafs-test.msi to see if all
4692 changes you have made above to openafs-modified.msi is present in
4693 openafs-test.msi.<span style='mso-spacerun:yes'>  </span>'msitran' will
4694 complain if some modification in the transform can not be successfully applied.</p>
4695
4696 <p class=MsoNormal>As mentioned above, you can use a tool like ORCA.EXE to edit
4697 the MSI databases directly when editing openafs-modified.msi.<span
4698 style='mso-spacerun:yes'>  </span>More details are given below.</p>
4699
4700 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416162"></a><a
4701 name="_Toc115417100"><span style='mso-bookmark:_Toc115416162'>7.2.
4702 Configuration Options</span></a></h2>
4703
4704 <p class=MsoNormal>The logic necessary to implement many of the settings
4705 described in <a href="#_Appendix_A:_Registry_Values">Appendix A</a> are present
4706 in the MSI.<span style='mso-spacerun:yes'>  </span>Most of these can be
4707 controlled by setting the corresponding properties to the desired value.<span
4708 style='mso-spacerun:yes'>  </span>Some settings may require modifying existing
4709 registry entries (though not recommended) or adding new resources (like files
4710 or registry keys).<span style='mso-spacerun:yes'>  </span>Instructions for
4711 performing these tasks are below.</p>
4712
4713 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416163">7.2.1
4714 Configurable Properties</a></h3>
4715
4716 <p class=MsoNormal>Most configurable properties correspond to registry keys or
4717 values.<span style='mso-spacerun:yes'>  </span>Due to the logic invoked based
4718 on the existence of these registry keys or values, they are only set if the
4719 associated property is defined to have a non null value.<span
4720 style='mso-spacerun:yes'>  </span>If the associated property is not defined in
4721 the MSI, the registry key or value will not be touched.<span
4722 style='mso-spacerun:yes'>  </span>By default, the MSI does not contain these
4723 properties and hence will not set the registry keys.<span
4724 style='mso-spacerun:yes'>  </span>You will need to add properties as needed to
4725 the MSI.</p>
4726
4727 <p class=MsoNormal>When one of the configurable properties is set, the
4728 installer will use the property value to set the corresponding setting in the
4729 HKEY_LOCAL_MACHINE registry hive.<span style='mso-spacerun:yes'>  </span>The
4730 HKEY_CURRENT_USER hive is not touched by the installer.</p>
4731
4732 <p class=MsoNormal>For each property, the associated registry setting is
4733 referenced by the same text used in <a href="#_Appendix_A:_Registry_Values">Appendix
4734 A</a>.</p>
4735
4736 <p class=MsoNormal>Strings are quoted using single quotes (e.g. 'a string'). An
4737 empty string is denoted as ''.<span style='mso-spacerun:yes'>  </span>Note that
4738 you can't author null values into the 'Property' table.</p>
4739
4740 <p class=MsoNormal>Numeric values should be authored as decimal strings.</p>
4741
4742 <h4><a name="_Toc115416164">7.2.1.1 Setting Properties</a></h4>
4743
4744 <p class=MsoNormal>In order to set a property,</p>
4745
4746 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
4747 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l14 level1 lfo30;tab-stops:
4748 list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;mso-fareast-font-family:
4749 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.<span
4750 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4751 </span></span></span><![endif]>Open the MSI in ORCA.EXE</p>
4752
4753 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
4754 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l14 level1 lfo30;tab-stops:
4755 list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;mso-fareast-font-family:
4756 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.<span
4757 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4758 </span></span></span><![endif]>Select the 'Property' table from the list of tables
4759 on the left.</p>
4760
4761 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
4762 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l14 level1 lfo30;tab-stops:
4763 list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;mso-fareast-font-family:
4764 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3.<span
4765 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4766 </span></span></span><![endif]>Find the property in the list of properties on
4767 the right, double click the value and type the new value.</p>
4768
4769 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
4770 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l14 level1 lfo30;tab-stops:
4771 list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;mso-fareast-font-family:
4772 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>4.<span
4773 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4774 </span></span></span><![endif]>If the property does not exist in the property
4775 list, right click the list and select 'Add Row', type the property name and the
4776 desired value.</p>
4777
4778 <h4><a name="_Toc115416165">7.2.1.2 OpenAFS for Windows Properties</a></h4>
4779
4780 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
4781  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
4782  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
4783  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
4784   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4785   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416166"></a><a
4786   name="_(Service_parameters):"></a><span style='mso-bookmark:_Toc115416166'>(Service
4787   parameters):</span></h5>
4788   <p class=ListContents style='margin-left:0pt;mso-yfti-cnfc:1'>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
4789   </td>
4790  </tr>
4791  <tr style='mso-yfti-irow:0'>
4792   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4793   <h5><a name="_Toc115416167"></a><a name="_(Network_provider):"></a><span
4794   style='mso-bookmark:_Toc115416167'>(Network provider):</span></h5>
4795   <p class=ListContents style='margin-left:0pt'>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]</p>
4796   </td>
4797  </tr>
4798  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
4799   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4800   <h5><a name="_Toc115416168"></a><a name="_(OpenAFS_Client):"></a><span
4801   style='mso-bookmark:_Toc115416168'>(OpenAFS Client):</span></h5>
4802   <p class=ListContents style='margin-left:0pt'>[HKLM\SOFTWARE\OpenAFS\Client]</p>
4803   </td>
4804  </tr>
4805 </table>
4806
4807 <h5><a name="_Toc115416169">7.2.1.2.1 Registry Properties</a></h5>
4808
4809 <p class=MsoNormal>These properties are used to set the values of registry
4810 entries associated with OpenAFS for Windows.</p>
4811
4812 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
4813  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
4814  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
4815  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
4816   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4817   <h6 style='mso-yfti-cnfc:1'><a name="_Toc115416170">AFSCACHEPATH</a></h6>
4818   <p class=MsoList style='mso-yfti-cnfc:1'>Registry key<span
4819   style='mso-spacerun:yes'>    </span>: <a href="#_(Service_parameters):">(Service
4820   parameters)</a></p>
4821   <p class=MsoList style='mso-yfti-cnfc:1'>Registry value : <a
4822   href="#_Value_:_CachePath">CachePath</a></p>
4823   <p class=MsoList style='mso-yfti-cnfc:1'>Valid values<span
4824   style='mso-spacerun:yes'>    </span>: string .</p>
4825   </td>
4826  </tr>
4827  <tr style='mso-yfti-irow:0'>
4828   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4829   <h6><a name="_Toc115416171">AFSCACHESIZE</a></h6>
4830   <p class=MsoList>Registry key<span style='mso-spacerun:yes'>    </span>: <a
4831   href="#_(Service_parameters):">(Service parameters)</a></p>
4832   <p class=MsoList>Registry value : <a href="#_Value___:_CacheSize">CacheSize</a></p>
4833   <p class=MsoList>Valid values<span style='mso-spacerun:yes'>    </span>:
4834   numeric</p>
4835   </td>
4836  </tr>
4837  <tr style='mso-yfti-irow:1'>
4838   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4839   <h6><a name="_Toc115416172">AFSCELLNAME</a></h6>
4840   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4841   href="#_(Service_parameters):">(Service parameters)</a></p>
4842   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4843   href="#_Value_:_Cell">Cell</a></p>
4844   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>:
4845   string</p>
4846   </td>
4847  </tr>
4848  <tr style='mso-yfti-irow:2'>
4849   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4850   <h6><a name="_Toc115416173">FREELANCEMODE</a></h6>
4851   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4852   href="#_(Service_parameters):">(Service parameters)</a></p>
4853   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4854   href="#_Value_:_FreelanceClient">FreelanceClient</a></p>
4855   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '1'
4856   or '0'</p>
4857   </td>
4858  </tr>
4859  <tr style='mso-yfti-irow:3'>
4860   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4861   <h6><a name="_Toc115416174">HIDEDOTFILES</a></h6>
4862   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4863   href="#_(Service_parameters):">(Service parameters)</a></p>
4864   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4865   href="#_Value_:_HideDotFiles">HideDotFiles</a></p>
4866   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '1'
4867   or '0'</p>
4868   </td>
4869  </tr>
4870  <tr style='mso-yfti-irow:4'>
4871   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4872   <h6><a name="_Toc115416175">LOGONOPTIONS</a></h6>
4873   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4874   href="#_(Network_provider):">(Network provider)</a></p>
4875   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4876   href="#_Value___:_LogonOptions">LogonOptions</a></p>
4877   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '0',
4878   '1' or '3'</p>
4879   <p class=MsoNormal>See <a href="#_Appendix_A:_Registry_Values">Appendix A</a>
4880   <a href="#_A.2.1_Domain_specific_configuration">section 2.1 (Domain specific
4881   configuration keys for Network Provider)</a> for more details.</p>
4882   </td>
4883  </tr>
4884  <tr style='mso-yfti-irow:5'>
4885   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4886   <h6><a name="_Toc115416176">MOUNTROOT</a></h6>
4887   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4888   href="#_(Service_parameters):">(Service parameters)</a></p>
4889   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4890   href="#_Value_:_Mountroot">Mountroot</a></p>
4891   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>:
4892   string</p>
4893   </td>
4894  </tr>
4895  <tr style='mso-yfti-irow:6'>
4896   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4897   <h6><a name="_Toc115416177">NETBIOSNAME</a></h6>
4898   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4899   href="#_(Service_parameters):">(Service parameters)</a></p>
4900   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4901   href="#_Value___:_NetbiosName">NetbiosName</a></p>
4902   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>:
4903   string (at most 15 characters)</p>
4904   </td>
4905  </tr>
4906  <tr style='mso-yfti-irow:7'>
4907   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4908   <h6><a name="_Toc115416178">NOFINDLANABYNAME</a></h6>
4909   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4910   href="#_(Service_parameters):">(Service parameters)</a></p>
4911   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4912   href="#_Value___:_NoFindLanaByName">NoFindLanaByName</a></p>
4913   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '1'
4914   or '0'</p>
4915   </td>
4916  </tr>
4917  <tr style='mso-yfti-irow:8'>
4918   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4919   <h6><a name="_Toc115416179">RXMAXMTU</a></h6>
4920   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4921   href="#_(Service_parameters):">(Service parameters)</a></p>
4922   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4923   href="#_Value_:_RxMaxMTU">RxMaxMTU</a></p>
4924   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>:
4925   numeric</p>
4926   </td>
4927  </tr>
4928  <tr style='mso-yfti-irow:9'>
4929   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4930   <h6><a name="_Toc115416180">SECURITYLEVEL</a></h6>
4931   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4932   href="#_(Service_parameters):">(Service parameters)</a></p>
4933   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4934   href="#_Value_:_SecurityLevel">SecurityLevel</a></p>
4935   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '1'
4936   or '0'</p>
4937   </td>
4938  </tr>
4939  <tr style='mso-yfti-irow:10'>
4940   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4941   <h6><a name="_Toc115416181">SMBAUTHTYPE</a></h6>
4942   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4943   href="#_(Service_parameters):">(Service parameters)</a></p>
4944   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4945   href="#_Value___:_smbAuthType">SMBAuthType</a></p>
4946   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>:
4947   '0','1' or '2'</p>
4948   </td>
4949  </tr>
4950  <tr style='mso-yfti-irow:11'>
4951   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4952   <h6><a name="_Toc115416182">STOREANSIFILENAMES</a></h6>
4953   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4954   href="#_(OpenAFS_Client):">(OpenAFS Client)</a></p>
4955   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4956   href="#_Value___:_StoreAnsiFilenames">StoreAnsiFilenames</a></p>
4957   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '0'
4958   or '1'</p>
4959   </td>
4960  </tr>
4961  <tr style='mso-yfti-irow:12;mso-yfti-lastrow:yes'>
4962   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4963   <h6><a name="_Toc115416183">USEDNS</a></h6>
4964   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4965   href="#_(Service_parameters):">(Service parameters)</a></p>
4966   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4967   href="#_Value_:_UseDNS">UseDNS</a></p>
4968   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '1'
4969   or '0'</p>
4970   </td>
4971  </tr>
4972 </table>
4973
4974 <h5><a name="_Toc115416184"></a><a name="_7.2.1.2.2_AFSCreds.exe_Properties"></a><span
4975 style='mso-bookmark:_Toc115416184'>7.2.1.2.2 AFSCreds.exe Properties</span></h5>
4976
4977 <p class=MsoNormal>These properties are combined to add a command line option
4978 to the shortcut that will be created in the Start:Programs:OpenAFS and
4979 Start:Programs:Startup folders (see CREDSSTARTUP).<span
4980 style='mso-spacerun:yes'>  </span>The method of specifying the option was chosen
4981 for easy integration with the Windows Installer user interface.<span
4982 style='mso-spacerun:yes'>  </span>Although other methods can be used to specify
4983 options to AFSCREDS.EXE, it is advised that they be avoided as transforms
4984 including such options may not apply to future releases of OpenAFS.</p>
4985
4986 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
4987  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
4988  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
4989  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
4990   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4991   <h6 style='mso-yfti-cnfc:1'><a name="_Toc115416185">CREDSSTARTUP</a></h6>
4992   <p class=MsoList style='mso-yfti-cnfc:1'>Valid values<span
4993   style='mso-spacerun:yes'>    </span>: '1' or '0'</p>
4994   <p class=MsoList style='mso-yfti-cnfc:1'>Controls whether AFSCreds.exe starts
4995   up automatically when the user logs on.<span style='mso-spacerun:yes'>
4996   </span>When CREDSSTARTUP is '1' a shortcut is added to the 'Startup' folder
4997   in the 'Program menu' which starts AFSCREDS.EXE with the options that are
4998   determined by the other CREDS* properties.</p>
4999   </td>
5000  </tr>
5001  <tr style='mso-yfti-irow:0'>
5002   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5003   <h6><a name="_Toc115416186">CREDSAUTOINIT</a></h6>
5004   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '-a'
5005   or ''</p>
5006   <p class=MsoList>Enables automatic initialization.</p>
5007   </td>
5008  </tr>
5009  <tr style='mso-yfti-irow:1'>
5010   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5011   <h6><a name="_Toc115416187">CREDSIPCHDET</a></h6>
5012   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '-n'
5013   or ''</p>
5014   <p class=MsoList>Enables IP address change detection.</p>
5015   </td>
5016  </tr>
5017  <tr style='mso-yfti-irow:2'>
5018   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5019   <h6><a name="_Toc115416188">CREDSQUIET</a></h6>
5020   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '-q'
5021   or ''</p>
5022   <p class=MsoList>Enables quiet mode.</p>
5023   </td>
5024  </tr>
5025  <tr style='mso-yfti-irow:3'>
5026   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5027   <h6><a name="_Toc115416189">CREDSRENEWDRMAP</a></h6>
5028   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '-m'
5029   or '</p>
5030   <p class=MsoList>Enables renewing drive map at startup.</p>
5031   </td>
5032  </tr>
5033  <tr style='mso-yfti-irow:4;mso-yfti-lastrow:yes'>
5034   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5035   <h6><a name="_Toc115416190">CREDSSHOW</a></h6>
5036   <p class=MsoList>Valid values<span style='mso-spacerun:yes'>    </span>: '-s'
5037   or ''</p>
5038   <p class=MsoList>Enables displaying the credential manager window when
5039   AFSCREDS starts up.</p>
5040   </td>
5041  </tr>
5042 </table>
5043
5044 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416191">7.2.2
5045 Existing Registry Entries</a></h3>
5046
5047 <p class=MsoNormal>You can change existing registry values subject to the
5048 restrictions mentioned in the Windows Platform SDK.<span
5049 style='mso-spacerun:yes'>  </span>Pay special attention to component key paths
5050 and try to only change the 'Value' column in the 'Registry' table.<span
5051 style='mso-spacerun:yes'>  </span>If you want to add additional registry keys
5052 please refer to section 3 (Additional resources).</p>
5053
5054 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416192">7.2.3
5055 Replacing Configuration Files</a></h3>
5056
5057 <p class=MsoNormal>The OpenAFS configuration files (CellServDB) can be replaced
5058 by your own configuration files.<span style='mso-spacerun:yes'>  </span>These
5059 files are contained in separate MSI components so that you can disable them
5060 individually.</p>
5061
5062 <p class=MsoNormal>The recommended method for replacing these files is to first
5063 disable the components containing the configuration files that you want to
5064 replace, and then add new components for the replacement files.<span
5065 style='mso-spacerun:yes'>  </span>This is outlined below (assuming you are
5066 using ORCA.EXE to author the transform).</p>
5067
5068 <p class=MsoNormal>Note that transforms are not a good way to add a new file as
5069 an embedded stream.<span style='mso-spacerun:yes'>  </span>The method outlined
5070 here places the file in the same directory as the MSI for deployment.</p>
5071
5072 <p class=MsoNormal>The walkthrough below is to add a custom 'CellServDB' file.</p>
5073
5074 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5075 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l13 level1 lfo32;tab-stops:
5076 list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5077 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.<span
5078 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Disable
5079 the component that contains the configuration file that you want to replace.</p>
5080
5081 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5082 margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;tab-stops:
5083 list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5084 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.1.<span
5085 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Locate
5086 and select the 'Component' table in the 'Tables' list.</p>
5087
5088 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5089 margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;tab-stops:
5090 list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5091 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.2.<span
5092 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>In
5093 the Component table, locate the component you need to change ( Ctrl-F invokes
5094 the 'Find' dialog).<span style='mso-spacerun:yes'>  </span>The component names
5095 are listed below in section <a href="#_2.3.1_Components_for_Configuration_">7.2.3.1</a>.<span
5096 style='mso-spacerun:yes'>  </span>For this example, the component name is
5097 'elf_CellServDB'.</p>
5098
5099 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5100 margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;tab-stops:
5101 list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5102 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.3.<span
5103 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Go
5104 to the 'Condition' column of the component.</p>
5105
5106 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5107 margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;tab-stops:
5108 list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5109 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.4.<span
5110 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Enter
5111 a condition that evaluates to false. I.e. 'DONOTINSTALL'. (Note that an
5112 undefined property always evaluates to false).</p>
5113
5114 <p class=MsoNormal>Note that you can also use this step to disable other
5115 configuration files without providing replacements.</p>
5116
5117 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l13 level1 lfo32;
5118 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
5119 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.<span
5120 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Add
5121 a new component containing the new configuration file.</p>
5122
5123 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5124 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5125 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.1.<span
5126 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
5127 the 'Component' table in the 'Tables' list.</p>
5128
5129 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5130 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5131 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.2.<span
5132 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
5133 'Tables'-&gt;'Add Row' (Ctrl-R).</p>
5134
5135 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5136 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5137 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.3.<span
5138 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Enter
5139 the following :</p>
5140
5141 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
5142  style='margin-left:39.35pt;border-collapse:collapse;border:none;mso-border-alt:
5143  solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5144  mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
5145  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;height:23.35pt'>
5146   <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
5147   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt;height:23.35pt'>
5148   <p class=PreformattedText>Component</p>
5149   </td>
5150   <td width=475 valign=top style='width:356.55pt;border:solid windowtext 1.0pt;
5151   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
5152   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt;height:23.35pt'>
5153   <p class=PreformattedText>cmf_my_CellServDB</p>
5154   </td>
5155  </tr>
5156  <tr style='mso-yfti-irow:1'>
5157   <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
5158   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5159   padding:0pt 5.4pt 0pt 5.4pt'>
5160   <p class=PreformattedText>ComponentID</p>
5161   </td>
5162   <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
5163   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5164   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5165   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5166   <p class=PreformattedText>{7019836F-BB2C-4AF6-9463-0D6EC9035CF1}</p>
5167   </td>
5168  </tr>
5169  <tr style='mso-yfti-irow:2'>
5170   <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
5171   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5172   padding:0pt 5.4pt 0pt 5.4pt'>
5173   <p class=PreformattedText>Directory_</p>
5174   </td>
5175   <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
5176   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5177   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5178   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5179   <p class=PreformattedText>dirClient</p>
5180   </td>
5181  </tr>
5182  <tr style='mso-yfti-irow:3'>
5183   <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
5184   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5185   padding:0pt 5.4pt 0pt 5.4pt'>
5186   <p class=PreformattedText>Attributes</p>
5187   </td>
5188   <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
5189   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5190   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5191   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5192   <p class=PreformattedText>144</p>
5193   </td>
5194  </tr>
5195  <tr style='mso-yfti-irow:4'>
5196   <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
5197   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5198   padding:0pt 5.4pt 0pt 5.4pt'>
5199   <p class=PreformattedText>Condition</p>
5200   </td>
5201   <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
5202   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5203   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5204   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5205   <p class=PreformattedText><o:p>&nbsp;</o:p></p>
5206   </td>
5207  </tr>
5208  <tr style='mso-yfti-irow:5;mso-yfti-lastrow:yes'>
5209   <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
5210   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5211   padding:0pt 5.4pt 0pt 5.4pt'>
5212   <p class=PreformattedText>KeyPath</p>
5213   </td>
5214   <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
5215   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5216   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5217   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5218   <p class=PreformattedText>fil_my_CellServDB</p>
5219   </td>
5220  </tr>
5221 </table>
5222
5223 <p class=MsoNormal style='margin-left:35.45pt'>Note that the ComponentId is an
5224 uppercase GUID.<span style='mso-spacerun:yes'>  </span>You can generate one
5225 using GUIDGEN.EXE or UUIDGEN.EXE, both of which are included in the Platform
5226 SDK.</p>
5227
5228 <p class=MsoNormal style='margin-left:35.45pt'>The Attributes value of 144 is a
5229 sum of msidbComponentAttributesPermanent (16) and msidbComponentAttributesNeverOverwrite
5230 (128).<span style='mso-spacerun:yes'>  </span>This ensures that local
5231 modifications are not overwritten or lost during an installation or
5232 uninstallation.<span style='mso-spacerun:yes'>  </span>These are the same
5233 settings used on the default configuration files.</p>
5234
5235 <p class=MsoNormal><span style='mso-tab-count:1'>            </span>'fil_my_CellServDB'
5236 is a key into the 'File' table which we will fill later.</p>
5237
5238 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l13 level1 lfo32;
5239 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
5240 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3.<span
5241 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Add
5242 a new feature to hold the new component.</p>
5243
5244 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5245 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5246 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3.1.<span
5247 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
5248 the 'Feature' table.</p>
5249
5250 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5251 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5252 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3.2.<span
5253 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Add
5254 a new row (Ctrl-R or 'Tables'-&gt;'Add Row') with the following values:</p>
5255
5256 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
5257  style='margin-left:40.1pt;border-collapse:collapse;border:none;mso-border-alt:
5258  solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5259  mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
5260  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
5261   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5262   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5263   <p class=PreformattedText>Feature</p>
5264   </td>
5265   <td width=462 valign=top style='width:346.2pt;border:solid windowtext 1.0pt;
5266   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
5267   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5268   <p class=PreformattedText>fea_my_CellServDB</p>
5269   </td>
5270  </tr>
5271  <tr style='mso-yfti-irow:1'>
5272   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5273   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5274   padding:0pt 5.4pt 0pt 5.4pt'>
5275   <p class=PreformattedText>Feature_Parent</p>
5276   </td>
5277   <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
5278   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5279   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5280   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5281   <p class=PreformattedText>feaClient</p>
5282   </td>
5283  </tr>
5284  <tr style='mso-yfti-irow:2'>
5285   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5286   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5287   padding:0pt 5.4pt 0pt 5.4pt'>
5288   <p class=PreformattedText>Title</p>
5289   </td>
5290   <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
5291   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5292   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5293   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5294   <p class=PreformattedText><o:p>&nbsp;</o:p></p>
5295   </td>
5296  </tr>
5297  <tr style='mso-yfti-irow:3'>
5298   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5299   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5300   padding:0pt 5.4pt 0pt 5.4pt'>
5301   <p class=PreformattedText>Description</p>
5302   </td>
5303   <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
5304   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5305   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5306   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5307   <p class=PreformattedText><o:p>&nbsp;</o:p></p>
5308   </td>
5309  </tr>
5310  <tr style='mso-yfti-irow:4'>
5311   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5312   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5313   padding:0pt 5.4pt 0pt 5.4pt'>
5314   <p class=PreformattedText>Display</p>
5315   </td>
5316   <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
5317   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5318   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5319   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5320   <p class=PreformattedText>0</p>
5321   </td>
5322  </tr>
5323  <tr style='mso-yfti-irow:5'>
5324   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5325   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5326   padding:0pt 5.4pt 0pt 5.4pt'>
5327   <p class=PreformattedText>Level</p>
5328   </td>
5329   <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
5330   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5331   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5332   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5333   <p class=PreformattedText>30</p>
5334   </td>
5335  </tr>
5336  <tr style='mso-yfti-irow:6'>
5337   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5338   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5339   padding:0pt 5.4pt 0pt 5.4pt'>
5340   <p class=PreformattedText>Directory_</p>
5341   </td>
5342   <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
5343   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5344   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5345   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5346   <p class=PreformattedText><o:p>&nbsp;</o:p></p>
5347   </td>
5348  </tr>
5349  <tr style='mso-yfti-irow:7;mso-yfti-lastrow:yes'>
5350   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5351   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5352   padding:0pt 5.4pt 0pt 5.4pt'>
5353   <p class=PreformattedText>Attributes</p>
5354   </td>
5355   <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
5356   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5357   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5358   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5359   <p class=PreformattedText>8</p>
5360   </td>
5361  </tr>
5362 </table>
5363
5364 <p class=MsoNormal style='margin-left:35.45pt'>It is important to create the
5365 new feature under the 'feaClient' feature, which will ensure that the configuration
5366 file will be installed when the client binaries are installed.</p>
5367
5368 <p class=MsoNormal style='margin-left:35.45pt'>Setting 'Display' to 0 will hide
5369 this feature from the feature selection dialog during an interactive
5370 installation.<span style='mso-spacerun:yes'>  </span>A value of 30 for 'Level'
5371 allows this feature to be installed by default (on a 'Typical' installation).</p>
5372
5373 <p class=MsoNormal style='margin-left:35.45pt'>The 'Attributes' value is
5374 msidbFeatureAttributesDisallowAdvertise (8), which is set on all features in
5375 the OpenAFS MSI.<span style='mso-spacerun:yes'>  </span>The OpenAFS MSI is not
5376 designed for an advertised installation.</p>
5377
5378 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l13 level1 lfo32;
5379 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
5380 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>4.<span
5381 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Join
5382 the component and the feature.</p>
5383
5384 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5385 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5386 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>4.1.<span
5387 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
5388 the 'FeatureComponents' table.</p>
5389
5390 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5391 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5392 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>4.2.<span
5393 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Add
5394 a new row with the following values:</p>
5395
5396 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
5397  style='margin-left:40.1pt;border-collapse:collapse;border:none;mso-border-alt:
5398  solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5399  mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
5400  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
5401   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5402   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5403   <p class=PreformattedText>Feature</p>
5404   </td>
5405   <td width=462 valign=top style='width:346.5pt;border:solid windowtext 1.0pt;
5406   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
5407   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5408   <p class=PreformattedText>fea_my_CellServDB</p>
5409   </td>
5410  </tr>
5411  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
5412   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5413   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5414   padding:0pt 5.4pt 0pt 5.4pt'>
5415   <p class=PreformattedText>Component</p>
5416   </td>
5417   <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
5418   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5419   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5420   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5421   <p class=PreformattedText>cmf_my_CellServDB</p>
5422   </td>
5423  </tr>
5424 </table>
5425
5426 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l13 level1 lfo32;
5427 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
5428 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>5.<span
5429 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Add
5430 an entry to the 'File' table.</p>
5431
5432 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5433 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5434 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>5.1.<span
5435 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
5436 the 'File' table.</p>
5437
5438 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5439 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5440 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>5.2.<span
5441 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Add
5442 a new row with the following values:</p>
5443
5444 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
5445  style='margin-left:40.1pt;border-collapse:collapse;border:none;mso-border-alt:
5446  solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5447  mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
5448  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
5449   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5450   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5451   <p class=PreformattedText>File</p>
5452   </td>
5453   <td width=462 valign=top style='width:346.5pt;border:solid windowtext 1.0pt;
5454   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
5455   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5456   <p class=PreformattedText>fil_my_CellServDB</p>
5457   </td>
5458  </tr>
5459  <tr style='mso-yfti-irow:1'>
5460   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5461   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5462   padding:0pt 5.4pt 0pt 5.4pt'>
5463   <p class=PreformattedText>Component_</p>
5464   </td>
5465   <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
5466   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5467   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5468   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5469   <p class=PreformattedText>cmf_my_CellServDB</p>
5470   </td>
5471  </tr>
5472  <tr style='mso-yfti-irow:2'>
5473   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5474   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5475   padding:0pt 5.4pt 0pt 5.4pt'>
5476   <p class=PreformattedText>FileName</p>
5477   </td>
5478   <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
5479   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5480   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5481   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5482   <p class=PreformattedText>CellServDB</p>
5483   </td>
5484  </tr>
5485  <tr style='mso-yfti-irow:3'>
5486   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5487   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5488   padding:0pt 5.4pt 0pt 5.4pt'>
5489   <p class=PreformattedText>FileSize</p>
5490   </td>
5491   <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
5492   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5493   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5494   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5495   <p class=PreformattedText>(enter file size here)</p>
5496   </td>
5497  </tr>
5498  <tr style='mso-yfti-irow:4'>
5499   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5500   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5501   padding:0pt 5.4pt 0pt 5.4pt'>
5502   <p class=PreformattedText>Attributes</p>
5503   </td>
5504   <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
5505   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5506   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5507   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5508   <p class=PreformattedText>8192</p>
5509   </td>
5510  </tr>
5511  <tr style='mso-yfti-irow:5;mso-yfti-lastrow:yes'>
5512   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5513   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5514   padding:0pt 5.4pt 0pt 5.4pt'>
5515   <p class=PreformattedText>Sequence</p>
5516   </td>
5517   <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
5518   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5519   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5520   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5521   <p class=PreformattedText>1000</p>
5522   </td>
5523  </tr>
5524 </table>
5525
5526 <p class=MsoNormal><span style='mso-tab-count:1'>            </span><span
5527 style='mso-spacerun:yes'>    </span>(leave other fields blank)</p>
5528
5529 <p class=MsoNormal style='margin-left:35.45pt'>The 'Attributes' value is msidbFileAttributesNonCompressed
5530 (8192).<span style='mso-spacerun:yes'>  </span>This is because we will be
5531 placing this file in the same directory as the MSI instead of embedding the
5532 file in it.<span style='mso-spacerun:yes'>  </span>Transforms do not support
5533 updating compressed sources or adding new cabinet streams.</p>
5534
5535 <p class=MsoNormal style='margin-left:35.45pt'>Finally, the 'Sequence' value of
5536 1000 will be used later to distinguish the file as being in a separate source
5537 location than the other files in the MSI.</p>
5538
5539 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l13 level1 lfo32;
5540 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
5541 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>6.<span
5542 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Set
5543 a media source for the file.</p>
5544
5545 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5546 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5547 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>6.1.<span
5548 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
5549 the 'Media' table.</p>
5550
5551 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5552 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5553 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>6.2.<span
5554 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Add
5555 a row with the following values :</p>
5556
5557 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
5558  style='margin-left:40.1pt;border-collapse:collapse;border:none;mso-border-alt:
5559  solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5560  mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
5561  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
5562   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5563   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5564   <p class=PreformattedText>DiskId</p>
5565   </td>
5566   <td width=462 valign=top style='width:346.5pt;border:solid windowtext 1.0pt;
5567   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
5568   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5569   <p class=PreformattedText>2</p>
5570   </td>
5571  </tr>
5572  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
5573   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5574   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5575   padding:0pt 5.4pt 0pt 5.4pt'>
5576   <p class=PreformattedText>LastSequence</p>
5577   </td>
5578   <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
5579   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5580   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5581   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5582   <p class=PreformattedText>1000</p>
5583   </td>
5584  </tr>
5585 </table>
5586
5587 <p class=MsoNormal><span style='mso-tab-count:1'>            </span><span
5588 style='mso-spacerun:yes'>    </span>(leave other fields blank)</p>
5589
5590 <p class=MsoNormal style='margin-left:35.45pt'>The sequence number of 1000
5591 designates this as the media source for the newly added file.</p>
5592
5593 <h4><a name="_Toc115416193"></a><a name="_2.3.1_Components_for_Configuration_"></a><span
5594 style='mso-bookmark:_Toc115416193'>7.2.3.1 Components for Configuration Files</span></h4>
5595
5596 <p class=PreformattedText style='text-indent:35.45pt'>CellServDB:
5597 'cpf_CellServDB' (ID {D5BA4C15-DBEC-4292-91FC-B54C30F24F2A})</p>
5598
5599 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416194">7.2.4
5600 Adding Domain Specific Registry Keys</a></h3>
5601
5602 <p class=MsoNormal>Following is an example for adding domain specific registry
5603 keys.</p>
5604
5605 <p class=MsoNormal style='tab-stops:204.0pt'><span style='mso-spacerun:yes'>
5606 </span>Refer to <a href="#_Appendix_A:_Registry_Values">Appendix A</a> section
5607 2.1 for more information.</p>
5608
5609 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>Columns that are
5610 unspecified should be left empty.</p>
5611
5612 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>We create a new
5613 feature and component to hold the new registry keys.</p>
5614
5615 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
5616  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5617  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
5618  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
5619   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5620   <p class=MsoNormal style='mso-yfti-cnfc:1'><span style='mso-spacerun:yes'>
5621   </span>'Feature' table:</p>
5622   </td>
5623  </tr>
5624  <tr style='mso-yfti-irow:0'>
5625   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5626   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><span
5627   style='mso-tab-count:1'>      </span>(new row)<br>
5628   <span style='mso-tab-count:1'>            </span>Feature<span
5629   style='mso-tab-count:1'>            </span>: 'feaDomainKeys'<br>
5630   <span style='mso-tab-count:1'>            </span>Feature Parent<span
5631   style='mso-tab-count:1'> </span>: 'feaClient'<br>
5632   <span style='mso-tab-count:1'>            </span>Display<span
5633   style='mso-tab-count:1'>           </span>: 0<br>
5634   <span style='mso-tab-count:1'>            </span>Level<span style='mso-tab-count:
5635   2'>               </span>: 30<br>
5636   <span style='mso-tab-count:1'>            </span>Attributes<span
5637   style='mso-tab-count:1'>        </span>: 10</p>
5638   </td>
5639  </tr>
5640  <tr style='mso-yfti-irow:1'>
5641   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5642   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>'Component' table:</p>
5643   </td>
5644  </tr>
5645  <tr style='mso-yfti-irow:2'>
5646   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5647   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><span
5648   style='mso-tab-count:1'>      </span>(new row)<br>
5649   <span style='mso-spacerun:yes'>    </span><span style='mso-tab-count:1'>      </span>Component<span
5650   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'<br>
5651   <span style='mso-tab-count:1'>            </span>ComponentId<span
5652   style='mso-tab-count:1'>  </span>: '{4E3FCBF4-8BE7-40B2-A108-C47CF743C627}'<br>
5653   <span style='mso-tab-count:1'>            </span>Directory<span
5654   style='mso-tab-count:1'>         </span>: 'TARGETDIR'<br>
5655   <span style='mso-tab-count:1'>            </span>Attributes<span
5656   style='mso-tab-count:1'>        </span>: 4<br>
5657   <span style='mso-tab-count:1'>            </span>KeyPath<span
5658   style='mso-tab-count:1'>          </span>: 'reg_domkey0'</p>
5659   </td>
5660  </tr>
5661  <tr style='mso-yfti-irow:3'>
5662   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5663   <p class=MsoNormal><span style='mso-spacerun:yes'>
5664   </span>'FeatureComponents' table:</p>
5665   </td>
5666  </tr>
5667  <tr style='mso-yfti-irow:4'>
5668   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5669   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><span
5670   style='mso-tab-count:1'>      </span>(new row)<br>
5671   <span style='mso-tab-count:1'>            </span>Feature<span
5672   style='mso-tab-count:1'>            </span>: 'feaDomainKeys'<br>
5673   <span style='mso-tab-count:1'>            </span>Component<span
5674   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'</p>
5675   </td>
5676  </tr>
5677  <tr style='mso-yfti-irow:5'>
5678   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5679   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>'Registry'
5680   table:</p>
5681   </td>
5682  </tr>
5683  <tr style='mso-yfti-irow:6'>
5684   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5685   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5686   <span style='mso-tab-count:1'>            </span>Registry<span
5687   style='mso-tab-count:1'>          </span>: 'reg_domkey0'<br>
5688   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5689   2'>                </span>: 2<br>
5690   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5691   2'>                 </span>:
5692   'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain'<br>
5693   <span style='mso-tab-count:1'>            </span>Component<span
5694   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'</p>
5695   </td>
5696  </tr>
5697  <tr style='mso-yfti-irow:7'>
5698   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5699   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5700   <span style='mso-tab-count:1'>            </span>Registry<span
5701   style='mso-tab-count:1'>          </span>: 'reg_domkey1'<br>
5702   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5703   2'>                </span>: 2<br>
5704   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5705   2'>                 </span>:
5706   'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain'<br>
5707   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5708   2'>              </span>: '*'<br>
5709   <span style='mso-tab-count:1'>            </span>Component<span
5710   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'</p>
5711   </td>
5712  </tr>
5713  <tr style='mso-yfti-irow:8'>
5714   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5715   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5716   <span style='mso-tab-count:1'>            </span>Registry<span
5717   style='mso-tab-count:1'>          </span>: 'reg_domkey2'<br>
5718   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5719   2'>                </span>: 2<br>
5720   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5721   2'>                 </span>: 'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\ATHENA.MIT.EDU'<br>
5722   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5723   2'>              </span>: '*'<br>
5724   <span style='mso-tab-count:1'>            </span>Component<span
5725   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'</p>
5726   </td>
5727  </tr>
5728  <tr style='mso-yfti-irow:9'>
5729   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5730   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5731   <span style='mso-tab-count:1'>            </span>Registry<span
5732   style='mso-tab-count:1'>          </span>: 'reg_domkey3'<br>
5733   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5734   2'>                </span>: 2<br>
5735   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5736   2'>                 </span>:
5737   'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\ATHENA.MIT.EDU'<br>
5738   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5739   2'>              </span>: 'LogonOptions'<br>
5740   <span style='mso-tab-count:1'>            </span>Value<span style='mso-tab-count:
5741   2'>              </span>: 1<br>
5742   <span style='mso-tab-count:1'>            </span>Component<span
5743   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'</p>
5744   </td>
5745  </tr>
5746  <tr style='mso-yfti-irow:10'>
5747   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5748   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5749   <span style='mso-tab-count:1'>            </span>Registry<span
5750   style='mso-tab-count:1'>          </span>: 'reg_domkey4'<br>
5751   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5752   2'>                </span>: 2<br>
5753   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5754   2'>                 </span>:
5755   SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST'<br>
5756   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5757   2'>              </span>: '*'<br>
5758   <span style='mso-tab-count:1'>            </span>Component<span
5759   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'</p>
5760   </td>
5761  </tr>
5762  <tr style='mso-yfti-irow:11'>
5763   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5764   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5765   <span style='mso-tab-count:1'>            </span>Registry<span
5766   style='mso-tab-count:1'>          </span>: 'reg_domkey5'<br>
5767   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5768   2'>                </span>: 2<br>
5769   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5770   2'>                 </span>:
5771   'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST'<br>
5772   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5773   2'>              </span>: 'LogonOptions'<br>
5774   <span style='mso-tab-count:1'>            </span>Value<span style='mso-tab-count:
5775   2'>              </span>: 0<br>
5776   <span style='mso-tab-count:1'>            </span>Component<span
5777   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'</p>
5778   </td>
5779  </tr>
5780  <tr style='mso-yfti-irow:12;mso-yfti-lastrow:yes'>
5781   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5782   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5783   <span style='mso-tab-count:1'>            </span>Registry<span
5784   style='mso-tab-count:1'>          </span>: 'reg_domkey6'<br>
5785   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5786   2'>                </span>: 2<br>
5787   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5788   2'>                 </span>:
5789   'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST'<br>
5790   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5791   2'>              </span>: 'FailLoginsSilently'<br>
5792   <span style='mso-tab-count:1'>            </span>Value<span style='mso-tab-count:
5793   2'>              </span>: 1<br>
5794   <span style='mso-tab-count:1'>            </span>Component<span
5795   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'<br style='mso-special-character:
5796   line-break'>
5797   <![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'>
5798   <![endif]></p>
5799   </td>
5800  </tr>
5801 </table>
5802
5803 <p class=MsoNormal><o:p>&nbsp;</o:p></p>
5804
5805 <p class=MsoNormal>The example adds domain specific keys for 'ATHENA.MIT.EDU'
5806 (enable integrated logon) and 'LOCALHOST' (disable integrated logon and fail
5807 logins silently).</p>
5808
5809 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416195">7.2.5
5810 Adding Site Specific Freelance Registry Keys</a></h3>
5811
5812 <p class=MsoNormal>Following is an example for adding site specific Freelance
5813 registry keys to pre-populate the Mountpoints and Symlinks in the fake root.afs
5814 volume.</p>
5815
5816 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>Columns that are
5817 unspecified should be left empty.</p>
5818
5819 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>We create a new
5820 feature and component to hold the new registry keys.</p>
5821
5822 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
5823  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5824  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
5825  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
5826   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5827   <p class=MsoNormal style='mso-yfti-cnfc:1'><span style='mso-spacerun:yes'>
5828   </span>'Feature' table:</p>
5829   </td>
5830  </tr>
5831  <tr style='mso-yfti-irow:0'>
5832   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5833   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><span
5834   style='mso-tab-count:1'>      </span>(new row)<br>
5835   <span style='mso-tab-count:1'>            </span>Feature<span
5836   style='mso-tab-count:1'>            </span>: 'feaFreelanceKeys'<br>
5837   <span style='mso-tab-count:1'>            </span>Feature Parent<span
5838   style='mso-tab-count:1'> </span>: 'feaClient'<br>
5839   <span style='mso-tab-count:1'>            </span>Display<span
5840   style='mso-tab-count:1'>           </span>: 0<br>
5841   <span style='mso-tab-count:1'>            </span>Level<span style='mso-tab-count:
5842   2'>               </span>: 30<br>
5843   <span style='mso-tab-count:1'>            </span>Attributes<span
5844   style='mso-tab-count:1'>        </span>: 10</p>
5845   </td>
5846  </tr>
5847  <tr style='mso-yfti-irow:1'>
5848   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5849   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>'Component'
5850   table:</p>
5851   </td>
5852  </tr>
5853  <tr style='mso-yfti-irow:2'>
5854   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5855   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><span
5856   style='mso-tab-count:1'>      </span>(new row)<br>
5857   <span style='mso-spacerun:yes'>    </span><span style='mso-tab-count:1'>      </span>Component<span
5858   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'<br>
5859   <span style='mso-tab-count:1'>            </span>ComponentId<span
5860   style='mso-tab-count:1'>  </span>: '{4E3B3CBF4-9AE7-40C3-7B09-C48CF842C583}'<br>
5861   <span style='mso-tab-count:1'>            </span>Directory<span
5862   style='mso-tab-count:1'>         </span>: 'TARGETDIR'<br>
5863   <span style='mso-tab-count:1'>            </span>Attributes<span
5864   style='mso-tab-count:1'>        </span>: 4<br>
5865   <span style='mso-tab-count:1'>            </span>KeyPath<span
5866   style='mso-tab-count:1'>          </span>: 'reg_freekey0'</p>
5867   </td>
5868  </tr>
5869  <tr style='mso-yfti-irow:3'>
5870   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5871   <p class=MsoNormal><span style='mso-spacerun:yes'>
5872   </span>'FeatureComponents' table:</p>
5873   </td>
5874  </tr>
5875  <tr style='mso-yfti-irow:4'>
5876   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5877   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><span
5878   style='mso-tab-count:1'>      </span>(new row)<br>
5879   <span style='mso-tab-count:1'>            </span>Feature<span
5880   style='mso-tab-count:1'>            </span>: 'feaFreelanceKeys'<br>
5881   <span style='mso-tab-count:1'>            </span>Component<span
5882   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'</p>
5883   </td>
5884  </tr>
5885  <tr style='mso-yfti-irow:5'>
5886   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5887   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>'Registry'
5888   table:</p>
5889   </td>
5890  </tr>
5891  <tr style='mso-yfti-irow:6'>
5892   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5893   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5894   <span style='mso-tab-count:1'>            </span>Registry<span
5895   style='mso-tab-count:1'>          </span>: 'reg_freekey0'<br>
5896   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5897   2'>                </span>: 2<br>
5898   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5899   2'>                 </span>: 'SOFTWARE\OpenAFS\Client\Freelance'<br>
5900   <span style='mso-tab-count:1'>            </span>Component<span
5901   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'</p>
5902   </td>
5903  </tr>
5904  <tr style='mso-yfti-irow:7'>
5905   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5906   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5907   <span style='mso-tab-count:1'>            </span>Registry<span
5908   style='mso-tab-count:1'>          </span>: 'reg_freekey1'<br>
5909   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5910   2'>                </span>: 2<br>
5911   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5912   2'>                 </span>: 'SOFTWARE\OpenAFS\Client\Freelance'<br>
5913   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5914   2'>              </span>: '0'<br>
5915   <span style='mso-spacerun:yes'>  </span><span style='mso-tab-count:1'>         </span>Value<span
5916   style='mso-spacerun:yes'>           </span><span style='mso-tab-count:1'>         </span>:
5917   'athena.mit.edu#athena.mit.edu:root.cell.'<br>
5918   <span style='mso-tab-count:1'>            </span>Component<span
5919   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'</p>
5920   </td>
5921  </tr>
5922  <tr style='mso-yfti-irow:8'>
5923   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5924   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5925   <span style='mso-tab-count:1'>            </span>Registry<span
5926   style='mso-tab-count:1'>          </span>: 'reg_freekey2'<br>
5927   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5928   2'>                </span>: 2<br>
5929   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5930   2'>                 </span>: 'SOFTWARE\OpenAFS\Client\Freelance'<br>
5931   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5932   2'>              </span>: '1'<br>
5933   <span style='mso-spacerun:yes'>   </span><span style='mso-tab-count:1'>       </span>Value<span
5934   style='mso-spacerun:yes'>           </span><span style='mso-tab-count:1'>         </span>:
5935   '.athena.mit.edu%athena.mit.edu:root.cell.'<br>
5936   <span style='mso-tab-count:1'>            </span>Component<span
5937   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'</p>
5938   </td>
5939  </tr>
5940  <tr style='mso-yfti-irow:9'>
5941   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5942   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5943   <span style='mso-tab-count:1'>            </span>Registry<span
5944   style='mso-tab-count:1'>          </span>: 'reg_freekey3'<br>
5945   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5946   2'>                </span>: 2<br>
5947   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5948   2'>                 </span>: 'SOFTWARE\OpenAFS\Client\Freelance\Symlinks'<br>
5949   <span style='mso-tab-count:1'>            </span>Component<span
5950   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'</p>
5951   </td>
5952  </tr>
5953  <tr style='mso-yfti-irow:10'>
5954   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5955   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5956   <span style='mso-tab-count:1'>            </span>Registry<span
5957   style='mso-tab-count:1'>          </span>: 'reg_freekey4'<br>
5958   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5959   2'>                </span>: 2<br>
5960   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5961   2'>                 </span>: 'SOFTWARE\OpenAFS\Client\Freelance\Symlinks'<br>
5962   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5963   2'>              </span>: '0'<br>
5964   <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'>          </span>Value<span
5965   style='mso-spacerun:yes'>           </span><span style='mso-tab-count:1'>         </span>:
5966   '<st1:GivenName w:st="on">athena</st1:GivenName>:athena.mit.edu.'<br>
5967   <span style='mso-tab-count:1'>            </span>Component<span
5968   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'</p>
5969   </td>
5970  </tr>
5971  <tr style='mso-yfti-irow:11;mso-yfti-lastrow:yes'>
5972   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5973   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5974   <span style='mso-tab-count:1'>            </span>Registry<span
5975   style='mso-tab-count:1'>          </span>: 'reg_freekey5'<br>
5976   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5977   2'>                </span>: 2<br>
5978   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5979   2'>                 </span>: 'SOFTWARE\OpenAFS\Client\Freelance\Symlinks'<br>
5980   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5981   2'>              </span>: '1'<br>
5982   <span style='mso-spacerun:yes'>   </span><span style='mso-tab-count:1'>       </span>Value<span
5983   style='mso-spacerun:yes'>           </span><span style='mso-tab-count:1'>         </span>:
5984   '.athena:.athena.mit.edu.'<br>
5985   <span style='mso-tab-count:1'>            </span>Component<span
5986   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'</p>
5987   </td>
5988  </tr>
5989 </table>
5990
5991 <p class=MsoNormal>The example adds a read-only mountpoint to the
5992 athena.mit.edu cell's root.afs volume as well as a read-write mountpoint.<span
5993 style='mso-spacerun:yes'>  </span>Aliases are also provided using symlinks.</p>
5994
5995 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Ref115275867"></a><a
5996 name="_Toc115416196"></a><a name="_Toc115417101"><span style='mso-bookmark:
5997 _Toc115416196'><span style='mso-bookmark:_Ref115275867'>7.3 Additional
5998 Resources</span></span></a></h2>
5999
6000 <p class=MsoNormal>If you want to add registry keys or files you need to create
6001 new components and features for those.<span style='mso-spacerun:yes'>
6002 </span>Refer to the Windows Platform SDK for details.</p>
6003
6004 <p class=MsoNormal>It is beyond the scope of this document to provide a
6005 comprehensive overview of how to add new resources through a transform.<span
6006 style='mso-spacerun:yes'>  </span>Please refer to the &quot;Windows
6007 Installer&quot; documentation for details.<span style='mso-spacerun:yes'>
6008 </span>The relevant section is at :</p>
6009
6010 <p class=MsoNormal>http://msdn.microsoft.com/library/en-us/msi/setup/using_transforms_to_add_resources.asp</p>
6011
6012 <p class=MsoNormal>A sample walkthrough of adding a new configuration file is
6013 in section 2.3.</p>
6014
6015 <p class=MsoNormal>Add new features under the 'feaClient' or 'feaServer' as
6016 appropriate and set the 'Level' column for those features to equal the 'Level'
6017 for their parent features for consistency.<span style='mso-spacerun:yes'>
6018 </span>Note that none of the features in the OpenAFS for Windows MSI package
6019 are designed to be installed to run from 'source' or 'advertised'.<span
6020 style='mso-spacerun:yes'>  </span>It is recommended that you set
6021 'msidbFeatureAttributesFavorLocal' (0), 'msidbFeatureAttributesFollowParent'
6022 (2) and 'msidbFeatureAttributesDisallowAdvertise' (8) attributes for new
6023 features.</p>
6024
6025 <p class=MsoNormal>If you are creating new components, retain the same
6026 component GUID when creating new transforms against new releases of the OpenAFS
6027 MSI package.</p>
6028
6029 <p class=MsoNormal>After making the adjustments to the MSI database using
6030 ORCA.EXE you can generate a transform with MSITRAN.EXE as follows :</p>
6031
6032 <p class=MsoNormal>(Modified MSI package is 'openafs-en_US_new.msi' and the
6033 original MSI package is 'openafs-en_US.msi'.<span style='mso-spacerun:yes'>
6034 </span>Generates transform 'openafs-transform.mst')</p>
6035
6036 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>&gt; msitran.exe
6037 -g openafs-en_US.msi openafs-en_US_new.msi openafs-transform.mst</p>
6038
6039 <p class=MsoNormal>See the Platform SDK documentation for information on
6040 command line options for MSITRAN.EXE.</p>
6041
6042 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416197"></a><a
6043 name="_Toc115417102"><span style='mso-bookmark:_Toc115416197'>7.4. Upgrades</span></a></h2>
6044
6045 <p class=MsoNormal>The MSI package is designed to replace (or uninstall)
6046 previous versions of OpenAFS for Windows during installation.<span
6047 style='mso-spacerun:yes'>  </span>Previous versions are installations that used
6048 the NSIS (.EXE) installer or an MSI that has a known Upgrade Code and a
6049 different Product Code.<span style='mso-spacerun:yes'>  </span>The MSI does not
6050 directly upgrade an existing installation.<span style='mso-spacerun:yes'>
6051 </span>This is intentional and ensures that development releases which do not
6052 have strictly increasing version numbers are properly upgraded.</p>
6053
6054 <p class=MsoNormal>Versions of OpenAFS that are upgraded by the MSI package
6055 are:</p>
6056
6057 <p class=MsoNormal style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:l12 level1 lfo34;
6058 tab-stops:list 36.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
6059 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1)<span
6060 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>OpenAFS
6061 MSI package<br>
6062 Upgrade code {6823EEDD-84FC-4204-ABB3-A80D25779833}<br>
6063 All versions regardless of Product Code</p>
6064
6065 <p class=MsoNormal style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:l12 level1 lfo34;
6066 tab-stops:list 36.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
6067 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2)<span
6068 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>MIT's
6069 Transarc AFS MSI package<br>
6070 Upgrade code {5332B94F-DE38-4927-9EAB-51F4A64193A7}<br>
6071 All versions up to 3.6.2</p>
6072
6073 <p class=MsoNormal style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:l12 level1 lfo34;
6074 tab-stops:list 36.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
6075 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3)<span
6076 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>OpenAFS
6077 NSIS package<br>
6078 All versions</p>
6079
6080 <p class=MsoNormal>Note that versions of the OpenAFS NSIS package prior to
6081 1.3.65 had a bug where it couldn't be uninstalled properly in unattended
6082 mode.<span style='mso-spacerun:yes'>  </span>Therefore the MSI package will not
6083 try to uninstall an OpenAFS NSIS package if running unattended.<span
6084 style='mso-spacerun:yes'>  </span>This means that group policy based
6085 deployments will fail on machines that have the OpenAFS NSIS package installed.</p>
6086
6087 <p class=MsoNormal>If you have used a different MSI package to install OpenAFS
6088 and wish to upgrade it you can author rows into the 'Upgrade' table as
6089 described in the Platform SDK.</p>
6090
6091 <p class=MsoNormal>When performing an upgrade with msiexec.exe execute the MSI
6092 with the repair options &quot;vomus&quot;.</p>
6093
6094 <h3 style='margin-left:0pt;text-indent:0pt'>7.4.1. OpenAFS MSI Product Codes</h3>
6095
6096 <h4>Release 1.3</h4>
6097
6098 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
6099  style='border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;
6100  mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;mso-border-insideh:
6101  .5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
6102  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes'>
6103   <td width=118 valign=top style='width:88.55pt;border:solid windowtext 1.0pt;
6104   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6105   <p class=PreformattedText>i386_w2k<span style='mso-spacerun:yes'>   </span></p>
6106   </td>
6107   <td width=481 valign=top style='width:361.05pt;border:solid windowtext 1.0pt;
6108   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
6109   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6110   <p class=PreformattedText>{CCAF9E14-976E-46C0-8A1B-A218EAB7ADC5}</p>
6111   </td>
6112  </tr>
6113 </table>
6114
6115 <h4>Release 1.4</h4>
6116
6117 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
6118  style='border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;
6119  mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;mso-border-insideh:
6120  .5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
6121  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
6122   <td width=118 valign=top style='width:88.55pt;border:solid windowtext 1.0pt;
6123   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6124   <p class=PreformattedText>amd64_w2k<span style='mso-spacerun:yes'>   </span></p>
6125   </td>
6126   <td width=481 valign=top style='width:361.05pt;border:solid windowtext 1.0pt;
6127   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
6128   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6129   <p class=PreformattedText>{CC59770C-4690-4531-BAEB-55A5A6D2EEB9}</p>
6130   </td>
6131  </tr>
6132  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
6133   <td width=118 valign=top style='width:88.55pt;border:solid windowtext 1.0pt;
6134   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6135   padding:0pt 5.4pt 0pt 5.4pt'>
6136   <p class=PreformattedText>i386_w2k<span style='mso-spacerun:yes'>    </span></p>
6137   </td>
6138   <td width=481 valign=top style='width:361.05pt;border-top:none;border-left:
6139   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6140   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6141   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6142   <p class=PreformattedText>{B2220B3E-B61D-4CC7-9D4B-17BA918D049C}</p>
6143   </td>
6144  </tr>
6145 </table>
6146
6147 <h4>Release 1.5</h4>
6148
6149 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
6150  style='border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;
6151  mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;mso-border-insideh:
6152  .5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
6153  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
6154   <td width=118 valign=top style='width:88.55pt;border:solid windowtext 1.0pt;
6155   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6156   <p class=PreformattedText>amd64_w2k<span style='mso-spacerun:yes'>   </span></p>
6157   </td>
6158   <td width=485 valign=top style='width:363.45pt;border:solid windowtext 1.0pt;
6159   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
6160   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6161   <p class=PreformattedText>{A0A7B986-CF35-499C-9400-9A987F218127}</p>
6162   </td>
6163  </tr>
6164  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
6165   <td width=118 valign=top style='width:88.55pt;border:solid windowtext 1.0pt;
6166   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6167   padding:0pt 5.4pt 0pt 5.4pt'>
6168   <p class=PreformattedText>i386_w2k<span style='mso-spacerun:yes'>    </span></p>
6169   </td>
6170   <td width=485 valign=top style='width:363.45pt;border-top:none;border-left:
6171   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6172   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6173   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6174   <p class=PreformattedText>{E832F832-C937-46BC-8C1D-BC7EF6F3F62F}</p>
6175   </td>
6176  </tr>
6177 </table>
6178
6179 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417116"></a><a
6180 name="_Toc115417103"></a><a name="_Toc115416198"></a><a
6181 name="_Appendix_A:_Registry_Values"></a><![if !supportLists]><span
6182 style='mso-bookmark:_Toc115417116'><span style='mso-bookmark:_Toc115417103'><span
6183 style='mso-bookmark:_Toc115416198'></span></span></span><![endif]><span
6184 style='mso-bookmark:_Toc115417116'><span style='mso-bookmark:_Toc115417103'><span
6185 style='mso-bookmark:_Toc115416198'>Appendix A: Registry Values</span></span></span></h1>
6186
6187 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416199"></a><a
6188 name="_Toc115417104"><span style='mso-bookmark:_Toc115416199'>A.1. Service
6189 parameters</span></a></h2>
6190
6191 <p class=MsoBodyText>The service parameters primarily affect the behavior of
6192 the AFS client service (afsd_service.exe).</p>
6193
6194 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416200">Regkey:<br>
6195 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</a></h3>
6196
6197 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6198  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6199  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6200  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:145.25pt'>
6201   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6202   height:145.25pt'>
6203   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416201">Value: LANadapter</a></h5>
6204   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD<br>
6205   Default: -1<br>
6206   Variable: LANadapter</p>
6207   <p class=MsoBodyText style='mso-yfti-cnfc:1'>LAN adapter number to use.<span
6208   style='mso-spacerun:yes'>  </span>This is the lana number of the LAN adapter
6209   that the SMB server should bind to.<span style='mso-spacerun:yes'>  </span>If
6210   unspecified or set to -1, a LAN adapter with named 'AFS' or a loopback
6211   adapter will be selected.<span style='mso-spacerun:yes'>  </span>If neither
6212   are present, then all available adapters will be bound to.<span
6213   style='mso-spacerun:yes'>  </span>When binding to a non-loopback adapter, the
6214   NetBIOS name hostname%-AFS' will be used (where %hostname% is the NetBIOS
6215   name of the host truncated to 11 characters). Otherwise, the NetBIOS name
6216   will be 'AFS'.</p>
6217   </td>
6218  </tr>
6219  <tr style='mso-yfti-irow:0;height:79.25pt'>
6220   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6221   height:79.25pt'>
6222   <h5><a name="_Toc115416202"></a><a name="_Value___:_CacheSize"></a><span
6223   style='mso-bookmark:_Toc115416202'>Value: CacheSize</span></h5>
6224   <p class=MsoBodyText>Type: DWORD<br>
6225   Default: 98304 (CM_CONFIGDEFAULT_CACHESIZE)<br>
6226   Variable: cm_initParams.cacheSize</p>
6227   <p class=MsoBodyText>Size of the AFS cache in 1k blocks.</p>
6228   </td>
6229  </tr>
6230  <tr style='mso-yfti-irow:1;height:79.25pt'>
6231   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6232   height:79.25pt'>
6233   <h5><a name="_Toc115416203">Value: ChunkSize</a></h5>
6234   <p class=MsoBodyText>Type: DWORD<br>
6235   Default: 17 (CM_CONFIGDEFAULT_CHUNKSIZE)<br>
6236   Variable: cm_logChunkSize (cm_chunkSize = 1 &lt;&lt; cm_logChunkSize)</p>
6237   <p class=MsoBodyText>Size of chunk for reading and writing. Actual chunk size
6238   is 2^cm_logChunkSize.</p>
6239   </td>
6240  </tr>
6241  <tr style='mso-yfti-irow:2;height:92.0pt'>
6242   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6243   height:92.0pt'>
6244   <h5><a name="_Toc115416204">Value: Daemons</a></h5>
6245   <p class=MsoBodyText>Type: DWORD<br>
6246   Default: 2 (CM_CONFIGDEFAULT_DAEMONS)<br>
6247   Variable: numBkgD</p>
6248   <p class=MsoBodyText>Number of background daemons (number of threads of
6249   cm_BkgDaemon). (see cm_BkgDaemon in cm_daemon.c)</p>
6250   </td>
6251  </tr>
6252  <tr style='mso-yfti-irow:3;height:92.0pt'>
6253   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6254   height:92.0pt'>
6255   <h5><a name="_Toc115416205">Value: ServerThreads</a></h5>
6256   <p class=MsoBodyText>Type: DWORD<br>
6257   Default: 25 (CM_CONFIGDEFAULT_SVTHREADS)<br>
6258   Variable: numSvThreads</p>
6259   <p class=MsoBodyText>Number of SMB server threads (number of threads of smb_Server).
6260   (see smb_Server in smb.c).</p>
6261   </td>
6262  </tr>
6263  <tr style='mso-yfti-irow:4;height:79.25pt'>
6264   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6265   height:79.25pt'>
6266   <h5><a name="_Toc115416206">Value: Stats</a></h5>
6267   <p class=MsoBodyText>Type: DWORD<br>
6268   Default: 10000 (CM_CONFIGDEFAULT_STATS)<br>
6269   Variable: cm_initParams.nStatCaches</p>
6270   <p class=MsoBodyText>Cache configuration.</p>
6271   </td>
6272  </tr>
6273  <tr style='mso-yfti-irow:5;height:78.5pt'>
6274   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6275   height:78.5pt'>
6276   <h5><a name="_Toc115416207"></a><a name="_Value_:_LogoffPreserveTokens"></a><span
6277   style='mso-bookmark:_Toc115416207'>Value: LogoffPreserveTokens</span></h5>
6278   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6279   Default : 0</p>
6280   <p class=MsoBodyText>If enabled (set to 1), the Logoff Event handler will not
6281   attempt to delete the user's tokens<span style='mso-spacerun:yes'>  </span>if
6282   the user's profile is stored outside of AFS.</p>
6283   </td>
6284  </tr>
6285  <tr style='mso-yfti-irow:6;height:79.25pt'>
6286   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6287   height:79.25pt'>
6288   <h5><a name="_Toc115416208">Value: RootVolume</a></h5>
6289   <p class=MsoBodyText>Type: REG_SZ<br>
6290   Default: &quot;root.afs&quot;<br>
6291   Variable: cm_rootVolumeName</p>
6292   <p class=MsoBodyText>Root volume name.</p>
6293   </td>
6294  </tr>
6295  <tr style='mso-yfti-irow:7;height:145.25pt'>
6296   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6297   height:145.25pt'>
6298   <h5><a name="_Toc115416209"></a><a name="_Value_:_Mountroot"></a><span
6299   style='mso-bookmark:_Toc115416209'>Value: Mountroot</span></h5>
6300   <p class=MsoBodyText>Type: REG_SZ<br>
6301   Default: &quot;/afs&quot;<br>
6302   Variable: cm_mountRoot</p>
6303   <p class=MsoBodyText>Name of root mount point.<span
6304   style='mso-spacerun:yes'>  </span>In symlinks, if a path starts with
6305   cm_mountRoot, it is assumed that the path is absolute (as opposed to
6306   relative) and is adjusted accordingly. Eg: if a path is specified as
6307   /afs/athena.mit.edu/foo/bar/baz and cm_mountRoot is &quot;/afs&quot;, then
6308   the path is interpreted as \\afs\all\athena.mit.edu\foo\bar\baz.<span
6309   style='mso-spacerun:yes'>  </span>If a path does not start with with
6310   cm_mountRoot, the path is assumed to be relative and suffixed to the
6311   reference directory (i.e. directory where the symlink exists)</p>
6312   </td>
6313  </tr>
6314  <tr style='mso-yfti-irow:8;height:92.0pt'>
6315   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6316   height:92.0pt'>
6317   <h5><a name="_Toc115416210"></a><a name="_Value_:_CachePath"></a><span
6318   style='mso-bookmark:_Toc115416210'>Value: CachePath</span></h5>
6319   <p class=MsoBodyText>Type: REG_SZ or REG_EXPAND_SZ<br>
6320   Default: &quot;%TEMP%\AFSCache&quot;<br>
6321   Variable: cm_CachePath</p>
6322   <p class=MsoBodyText>Location of on-disk cache file.<span
6323   style='mso-spacerun:yes'>  </span>The default is the SYSTEM account's TEMP
6324   directory.<span style='mso-spacerun:yes'>  </span>The attributes assigned to
6325   the file are HIDDEN and SYSTEM.</p>
6326   </td>
6327  </tr>
6328  <tr style='mso-yfti-irow:9;height:119.0pt'>
6329   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6330   height:119.0pt'>
6331   <h5><a name="_Toc115416211">Value: NonPersistentCaching</a></h5>
6332   <p class=MsoBodyText>Type: DWORD [0..1]<br>
6333   Default: 0<br>
6334   Variable: buf_CacheType</p>
6335   <p class=MsoBodyText>When this registry value is set to a non-zero value, the
6336   CachePath value is ignored and the cache data is stored in the windows paging
6337   file.<span style='mso-spacerun:yes'>  </span>This prevents the use of
6338   persistent caching (when available) as well as the ability to alter the size
6339   of the cache at runtime using the &quot;fs setcachesize&quot; command.</p>
6340   </td>
6341  </tr>
6342  <tr style='mso-yfti-irow:10;height:125.5pt'>
6343   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6344   height:125.5pt'>
6345   <h5><a name="_Toc115416212">Value: ValidateCache</a></h5>
6346   <p class=MsoBodyText>Type: DWORD [0..2]<br>
6347   Default: 1<br>
6348   Variable: buf_CacheType</p>
6349   <p class=MsoBodyText>This value determines if and when persistent cache
6350   validation is performed.</p>
6351   <p class=MsoBodyText>0 - Validation is disabled<br>
6352   1 - Validation is performed at startup<br>
6353   2 - Validation is performed at shutdown</p>
6354   </td>
6355  </tr>
6356  <tr style='mso-yfti-irow:11;height:79.25pt'>
6357   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6358   height:79.25pt'>
6359   <h5><a name="_Toc115416213">Value: TrapOnPanic</a></h5>
6360   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6361   Default: 0<br>
6362   Variable: traceOnPanic</p>
6363   <p class=MsoBodyText>Issues a breakpoint in the event of a panic.
6364   (breakpoint: _asm int 3).</p>
6365   </td>
6366  </tr>
6367  <tr style='mso-yfti-irow:12;height:92.0pt'>
6368   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6369   height:92.0pt'>
6370   <h5><a name="_Toc115416214"></a><a name="_Value___:_NetbiosName"></a><span
6371   style='mso-bookmark:_Toc115416214'>Value: NetbiosName</span></h5>
6372   <p class=MsoBodyText>Type: REG_EXPAND_SZ<br>
6373   Default: &quot;AFS&quot;<br>
6374   Variable: cm_NetbiosName</p>
6375   <p class=MsoBodyText>Specifies the NetBIOS name to be used when binding to a
6376   Loopback adapter.<span style='mso-spacerun:yes'>  </span>To provide the old
6377   behavior specify a value of<span style='mso-spacerun:yes'>
6378   </span>&quot;%COMPUTERNAME%-AFS&quot;.</p>
6379   </td>
6380  </tr>
6381  <tr style='mso-yfti-irow:13;height:152.0pt'>
6382   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6383   height:152.0pt'>
6384   <h5><a name="_Toc115416215">Value: IsGateway</a></h5>
6385   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6386   Default: 0<br>
6387   Variable: isGateway</p>
6388   <p class=MsoBodyText>Select whether or not this AFS client should act as a
6389   gateway.<span style='mso-spacerun:yes'>  </span>If set and the NetBIOS name
6390   hostname-AFS is bound to a physical NIC, other machines in the subnet can
6391   access AFS via SMB connections to hostname-AFS.</p>
6392   <p class=MsoBodyText>When IsGateway is non-zero, the LAN adapter detection
6393   code will avoid binding to a loopback adapter.<span
6394   style='mso-spacerun:yes'>  </span>This will ensure that the NetBIOS name will
6395   be of the form hostname-AFS instead of the value set by the
6396   &quot;NetbiosName&quot; registry value.</p>
6397   </td>
6398  </tr>
6399  <tr style='mso-yfti-irow:14;height:92.0pt'>
6400   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6401   height:92.0pt'>
6402   <h5><a name="_Toc115416216">Value: ReportSessionStartups</a></h5>
6403   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6404   Default: 0<br>
6405   Variable: reportSessionStartups</p>
6406   <p class=MsoBodyText>If enabled, all SMB sessions created are recorded in the
6407   Application event log.<span style='mso-spacerun:yes'>  </span>This also
6408   enables other events such as drive mappings or various error types to be
6409   logged.</p>
6410   </td>
6411  </tr>
6412  <tr style='mso-yfti-irow:15;height:79.25pt'>
6413   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6414   height:79.25pt'>
6415   <h5><a name="_Toc115416217"></a><a name="_Value_:_TraceBufferSize"></a><span
6416   style='mso-bookmark:_Toc115416217'>Value: TraceBufferSize</span></h5>
6417   <p class=MsoBodyText>Type: DWORD<br>
6418   Default: 5000 (CM_CONFIGDEFAULT_TRACEBUFSIZE)<br>
6419   Variable: traceBufSize</p>
6420   <p class=MsoBodyText>Number of entries to keep in trace log.</p>
6421   </td>
6422  </tr>
6423  <tr style='mso-yfti-irow:16;height:92.0pt'>
6424   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6425   height:92.0pt'>
6426   <h5><a name="_Toc115416218"></a><a name="_Value_:_SysName"></a><span
6427   style='mso-bookmark:_Toc115416218'>Value: SysName</span></h5>
6428   <p class=MsoBodyText>Type: REG_SZ<br>
6429   Default: &quot;i386_nt40&quot;<br>
6430   Variable: cm_sysName</p>
6431   <p class=MsoBodyText>Provides an initial value for &quot;fs
6432   sysname&quot;.<span style='mso-spacerun:yes'>  </span>The string can contain
6433   one or more replacement values for @sys in order of preference separated by
6434   whitespace.</p>
6435   </td>
6436  </tr>
6437  <tr style='mso-yfti-irow:17;height:79.25pt'>
6438   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6439   height:79.25pt'>
6440   <h5><a name="_Toc115416219"></a><a name="_Value_:_SecurityLevel"></a><span
6441   style='mso-bookmark:_Toc115416219'>Value: SecurityLevel</span></h5>
6442   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6443   Default: 0<br>
6444   Variable: cryptall</p>
6445   <p class=MsoBodyText>Enables encryption on RX calls.</p>
6446   </td>
6447  </tr>
6448  <tr style='mso-yfti-irow:18;height:112.25pt'>
6449   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6450   height:112.25pt'>
6451   <h5><a name="_Toc115416220"></a><a name="_Value_:_UseDNS"></a><span
6452   style='mso-bookmark:_Toc115416220'>Value: UseDNS</span></h5>
6453   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6454   Default: 1<br>
6455   Variable: cm_dnsEnabled</p>
6456   <p class=MsoBodyText>Enables resolving volservers using AFSDB DNS queries.</p>
6457   <p class=MsoBodyText>As of 1.3.60, this value is ignored as the DNS query
6458   support utilizes the Win32 DNSQuery API which is available on Win2000 and
6459   above.</p>
6460   </td>
6461  </tr>
6462  <tr style='mso-yfti-irow:19;height:79.25pt'>
6463   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6464   height:79.25pt'>
6465   <h5><a name="_Toc115416221"></a><a name="_Value_:_FreelanceClient"></a><span
6466   style='mso-bookmark:_Toc115416221'>Value: FreelanceClient</span></h5>
6467   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6468   Default: 0<br>
6469   Variable: cm_freelanceEnabled</p>
6470   <p class=MsoBodyText>Enables freelance client.</p>
6471   </td>
6472  </tr>
6473  <tr style='mso-yfti-irow:20;height:92.0pt'>
6474   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6475   height:92.0pt'>
6476   <h5><a name="_Toc115416222"></a><a name="_Value_:_HideDotFiles"></a><span
6477   style='mso-bookmark:_Toc115416222'>Value: HideDotFiles</span></h5>
6478   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6479   Default: 1<br>
6480   Variable: smb_hideDotFiles</p>
6481   <p class=MsoBodyText>Enables marking dotfiles with the hidden attribute.<span
6482   style='mso-spacerun:yes'>  </span>Dot files are files whose name starts with
6483   a period (excluding &quot;.&quot; and &quot;..&quot;).</p>
6484   </td>
6485  </tr>
6486  <tr style='mso-yfti-irow:21;height:79.25pt'>
6487   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6488   height:79.25pt'>
6489   <h5><a name="_Toc115416223">Value: MaxMpxRequests</a></h5>
6490   <p class=MsoBodyText>Type: DWORD<br>
6491   Default: 50<br>
6492   Variable: smb_maxMpxRequests</p>
6493   <p class=MsoBodyText>Maximum number of multiplexed SMB requests that can be
6494   made.</p>
6495   </td>
6496  </tr>
6497  <tr style='mso-yfti-irow:22;height:79.25pt'>
6498   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6499   height:79.25pt'>
6500   <h5><a name="_Toc115416224">Value: MaxVCPerServer</a></h5>
6501   <p class=MsoBodyText>Type: DWORD<br>
6502   Default: 100<br>
6503   Variable: smb_maxVCPerServer</p>
6504   <p class=MsoBodyText>Maximum number of SMB virtual circuits.</p>
6505   </td>
6506  </tr>
6507  <tr style='mso-yfti-irow:23;height:79.25pt'>
6508   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6509   height:79.25pt'>
6510   <h5><a name="_Toc115416225"></a><a name="_Value_:_Cell"></a><span
6511   style='mso-bookmark:_Toc115416225'>Value: Cell</span></h5>
6512   <p class=MsoBodyText>Type: REG_SZ<br>
6513   Default: &lt;none&gt;<br>
6514   Variable: rootCellName</p>
6515   <p class=MsoBodyText>Name of root cell (the cell from which root.afs should
6516   be mounted in \\afs\all).</p>
6517   </td>
6518  </tr>
6519  <tr style='mso-yfti-irow:24;height:79.25pt'>
6520   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6521   height:79.25pt'>
6522   <h5><a name="_Toc115416226">Value: RxNoJumbo</a></h5>
6523   <p class=MsoBodyText>Type: DWORD {0,1}<br>
6524   Default: 0<br>
6525   Variable: rx_nojumbo</p>
6526   <p class=MsoBodyText>If enabled, does not send or indicate that we are able
6527   to send or receive RX jumbograms.</p>
6528   </td>
6529  </tr>
6530  <tr style='mso-yfti-irow:25;height:124.75pt'>
6531   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6532   height:124.75pt'>
6533   <h5><a name="_Toc115416227"></a><a name="_Value_:_RxMaxMTU"></a><span
6534   style='mso-bookmark:_Toc115416227'>Value: RxMaxMTU</span></h5>
6535   <p class=MsoBodyText>Type: DWORD<br>
6536   Default: -1<br>
6537   Variable: rx_mtu</p>
6538   <p class=MsoBodyText>If set to anything other than -1, uses that value as the
6539   maximum MTU supported by the RX interface.</p>
6540   <p class=MsoBodyText>In order to enable OpenAFS to operate across the Cisco
6541   IPSec VPN client, this value must be set to 1264 or smaller.</p>
6542   </td>
6543  </tr>
6544  <tr style='mso-yfti-irow:26;height:151.75pt'>
6545   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6546   height:151.75pt'>
6547   <h5><a name="_Toc115416228">Value: ConnDeadTimeout</a></h5>
6548   <p class=MsoBodyText>Type: DWORD<br>
6549   Default: 60 (seconds)<br>
6550   Variable: ConnDeadtimeout</p>
6551   <p class=MsoBodyText>The Connection Dead Time is enforced to be at a minimum
6552   15 seconds longer than the minimum SMB timeout as specified by
6553   [HKLM\SYSTEM\CurrentControlSet\Services\lanmanworkstation\parameters]
6554   SessTimeout</p>
6555   <p class=MsoBodyText>If the minimum SMB timeout is not specified the value is
6556   45 seconds.<span style='mso-spacerun:yes'>  </span>See <a
6557   href="http://support.microsoft.com/support/kb/articles/Q102/0/67.asp">http://support.microsoft.com:80/support/kb/articles/Q102/0/67.asp</a></p>
6558   </td>
6559  </tr>
6560  <tr style='mso-yfti-irow:27;height:92.0pt'>
6561   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6562   height:92.0pt'>
6563   <h5><a name="_Toc115416229">Value: HardDeadTimeout</a></h5>
6564   <p class=MsoBodyText>Type: DWORD<br>
6565   Default: 120 (seconds)<br>
6566   Variable: HardDeadtimeout</p>
6567   <p class=MsoBodyText>The Hard Dead Time is enforced to be at least double the
6568   ConnDeadTimeout.<span style='mso-spacerun:yes'>  </span>The provides an
6569   opportunity for at least one retry.</p>
6570   </td>
6571  </tr>
6572  <tr style='mso-yfti-irow:28;height:158.5pt'>
6573   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6574   height:158.5pt'>
6575   <h5><a name="_Toc115416230"></a><a name="_Value__:_TraceOption"></a><span
6576   style='mso-bookmark:_Toc115416230'>Value: TraceOption</span></h5>
6577   <p class=MsoBodyText>Type: DWORD {0-15}<br>
6578   Default: 0</p>
6579   <p class=MsoBodyText>Enables logging of debug output to the Windows Event
6580   Log.</p>
6581   <p class=MsoBodyText>Bit 0 enables logging of &quot;Logon Events&quot;
6582   processed by the Network Provider and Winlogon Event Notification
6583   Handler.<span style='mso-spacerun:yes'>  </span></p>
6584   <p class=MsoBodyText>Bit 1 enables logging of events captured by the AFS
6585   Client Service.</p>
6586   <p class=MsoBodyText>Bit 2 enables real-time viewing of &quot;fs trace&quot;
6587   logging with DbgView or similar tools.</p>
6588   <p class=MsoBodyText>Bit 3 enables &quot;fs trace&quot; logging on startup.</p>
6589   </td>
6590  </tr>
6591  <tr style='mso-yfti-irow:29;height:98.5pt'>
6592   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6593   height:98.5pt'>
6594   <h5><a name="_Toc115416231">Value: AllSubmount</a></h5>
6595   <p class=MsoBodyText>Type: DWORD {0, 1}<br>
6596   Default: 1</p>
6597   <p class=MsoBodyText>Variable: allSubmount (smb.c)</p>
6598   <p class=MsoBodyText>By setting this value to 0, the
6599   &quot;\\NetbiosName\all&quot; mount point will not be created.<span
6600   style='mso-spacerun:yes'>  </span>This allows the read-write versions of
6601   root.afs to be hidden.</p>
6602   </td>
6603  </tr>
6604  <tr style='mso-yfti-irow:30;height:78.5pt'>
6605   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6606   height:78.5pt'>
6607   <h5><a name="_Toc115416232"></a><a name="_Value___:_NoFindLanaByName"></a><span
6608   style='mso-bookmark:_Toc115416232'>Value: NoFindLanaByName</span></h5>
6609   <p class=MsoBodyText>Type: DWORD {0, 1}<br>
6610   Default: 0</p>
6611   <p class=MsoBodyText>Disables the attempt to identity the network adapter to
6612   use by looking for an adapter with a display name of &quot;AFS&quot;.</p>
6613   </td>
6614  </tr>
6615  <tr style='mso-yfti-irow:31;height:78.5pt'>
6616   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6617   height:78.5pt'>
6618   <h5><a name="_Toc115416233">Value: MaxCPUs</a></h5>
6619   <p class=MsoBodyText>Type: DWORD {1..32} or {1..64} depending on the
6620   architecture<br>
6621   Default: &lt;no default&gt;</p>
6622   <p class=MsoBodyText>If this value is specified, afsd_service.exe will
6623   restrict itself to executing on the specified number of CPUs if there are a
6624   greater number installed in the machine.<span style='mso-spacerun:yes'>
6625   </span></p>
6626   </td>
6627  </tr>
6628  <tr style='mso-yfti-irow:32;height:151.75pt'>
6629   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6630   height:151.75pt'>
6631   <h5><a name="_Toc115416234"></a><a name="_Value___:_smbAuthType"></a><span
6632   style='mso-bookmark:_Toc115416234'>Value: smbAuthType</span></h5>
6633   <p class=MsoBodyText>Type: DWORD {0..2}<br>
6634   Default: 2</p>
6635   <p class=MsoBodyText>If this value is specified, it defines the type of SMB
6636   authentication which must be present in order for the Windows SMB client to
6637   connect to the AFS Client Service's SMB server.<span
6638   style='mso-spacerun:yes'>  </span>The values are:</p>
6639   <p class=MsoBodyText>0 = No authentication required<br>
6640   1 = NTLM authentication required<br>
6641   2 = Extended (GSS SPNEGO) authentication required<br>
6642   The default is Extended authentication</p>
6643   </td>
6644  </tr>
6645  <tr style='mso-yfti-irow:33;height:92.0pt'>
6646   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6647   height:92.0pt'>
6648   <h5><a name="_Toc115416235"></a><a name="_Value___:_MaxLogSize"></a><span
6649   style='mso-bookmark:_Toc115416235'>Value: MaxLogSize</span></h5>
6650   <p class=MsoBodyText>Type: DWORD {0 .. MAXDWORD}<br>
6651   Default: 100K</p>
6652   <p class=MsoBodyText>This entry determines the maximum size of the
6653   %WINDIR%\TEMP\afsd_init.log file.<span style='mso-spacerun:yes'>  </span>If
6654   the file is larger than this value when afsd_service.exe starts the file will
6655   be reset to 0 bytes.<span style='mso-spacerun:yes'>  </span>If this value is
6656   0, it means the file should be allowed to grow indefinitely.</p>
6657   </td>
6658  </tr>
6659  <tr style='mso-yfti-irow:34;height:65.75pt'>
6660   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6661   height:65.75pt'>
6662   <h5><a name="_Toc115416236">Value: FlushOnHibernate</a></h5>
6663   <p class=MsoBodyText>Type: DWORD {0,1}<br>
6664   Default: 1</p>
6665   <p class=MsoBodyText>If set, flushes all volumes before the machine goes on
6666   hibernate or stand-by.</p>
6667   </td>
6668  </tr>
6669  <tr style='mso-yfti-irow:35;height:65.75pt'>
6670   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6671   height:65.75pt'>
6672   <h5>Value: RxEnablePeerStats</h5>
6673   <p class=MsoBodyText>Type: REG_DWORD<br>
6674   Default: 0x0</p>
6675   <p class=MsoBodyText>This value will enable the gathering of RX Statistics
6676   for connections with the Cache Managers Peers.<span
6677   style='mso-spacerun:yes'>  </span>This functionality can be adjusted at
6678   runtime with the fs rxstatpeer command.</p>
6679   </td>
6680  </tr>
6681  <tr style='mso-yfti-irow:36;mso-yfti-lastrow:yes;height:65.75pt'>
6682   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6683   height:65.75pt'>
6684   <h5>Value: RxEnableProcessStats<o:p></o:p></h5>
6685   <p class=MsoBodyText>Type: REG_DWORD<br>
6686   Default: 0x0<o:p></o:p></p>
6687   <p class=MsoBodyText>This value will enable the gathering of RX Statistics
6688   for the Cache Managers Process.<span style='mso-spacerun:yes'>  </span>This
6689   functionality can be adjusted at runtime with the fs rxstatproc command.<o:p></o:p></p>
6690   </td>
6691  </tr>
6692 </table>
6693
6694 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416237">Regkey:<br>
6695 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters\GlobalAutoMapper]</a></h3>
6696
6697 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6698  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6699  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6700  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6701   height:65.0pt'>
6702   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6703   height:65.0pt'>
6704   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416238">Value: &lt;Drive
6705   Letter:&gt; for example &quot;G:&quot;</a></h5>
6706   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ</p>
6707   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Specifies the submount name to
6708   be mapped by afsd_service.exe at startup to the provided drive letter.</p>
6709   </td>
6710  </tr>
6711 </table>
6712
6713 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416239">Regkey:<br>
6714 [HKLM\SOFTWARE\OpenAFS\Client]</a></h3>
6715
6716 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6717  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6718  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6719  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:78.5pt'>
6720   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6721   height:78.5pt'>
6722   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416240"></a><a
6723   name="_Value___:_CellServDBDir"></a><span style='mso-bookmark:_Toc115416240'>Value:
6724   CellServDBDir</span></h5>
6725   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
6726   Default: &lt;not defined&gt;</p>
6727   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Specifies the directory containing
6728   the CellServDB file.<span style='mso-spacerun:yes'>  </span>When this value
6729   is not specified, the AFS Client install directory is used.</p>
6730   </td>
6731  </tr>
6732  <tr style='mso-yfti-irow:0;height:145.25pt'>
6733   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6734   height:145.25pt'>
6735   <h5><a name="_Toc115416241"></a><a name="_Value___:_VerifyServiceSignature"></a><span
6736   style='mso-bookmark:_Toc115416241'>Value: VerifyServiceSignature</span></h5>
6737   <p class=MsoBodyText>Type: REG_DWORD<br>
6738   Default: 0x1</p>
6739   <p class=MsoBodyText>This value can be used to disable the runtime
6740   verification of the digital signatures applied to afsd_service.exe and the
6741   OpenAFS DLLs it loads.<span style='mso-spacerun:yes'>  </span>This test is
6742   performed to verify that<span style='mso-spacerun:yes'>   </span>the DLLs
6743   which are loaded by afsd_service.exe are from the same distribution as
6744   afsd_service.exe.<span style='mso-spacerun:yes'>  </span>This is to prevent
6745   random errors caused when DLLs from one distribution of AFS are loaded by
6746   another one.<span style='mso-spacerun:yes'>  </span>This is not a security
6747   test.<span style='mso-spacerun:yes'>  </span>The reason for disabling this
6748   test is to free up additional memory which can be used for a large cache
6749   size.</p>
6750   </td>
6751  </tr>
6752  <tr style='mso-yfti-irow:1;height:105.5pt'>
6753   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6754   height:105.5pt'>
6755   <h5><a name="_Toc115416242"></a><a name="_Value___:_IoctlDebug"></a><span
6756   style='mso-bookmark:_Toc115416242'>Value: IoctlDebug</span></h5>
6757   <p class=MsoBodyText>Type: REG_DWORD<br>
6758   Default: 0x0</p>
6759   <p class=MsoBodyText>This value can be used to debug the cause of pioctl()
6760   failures.<span style='mso-spacerun:yes'>  </span>Set a non-zero value and the
6761   pioctl() library will output status information to stdout.<span
6762   style='mso-spacerun:yes'>  </span>Executing command line tools such as
6763   tokens.exe, fs.exe, etc can then be used to determine why the pioctl() call
6764   is failing. </p>
6765   </td>
6766  </tr>
6767  <tr style='mso-yfti-irow:2;height:330.75pt'>
6768   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6769   height:330.75pt'>
6770   <h5><a name="_Toc115416243">Value: MiniDumpType</a></h5>
6771   <p class=MsoBodyText>Type: REG_DWORD<br>
6772   Default: 0x0 (MiniDumpNormal)</p>
6773   <p class=MsoBodyText>This value is used to specify the type of minidump
6774   generated by afsd_service.exe either when the process crashes or when a user
6775   initiated is dump file is generated with the &quot;fs.exe minidump&quot;
6776   command.</p>
6777   <p class=MsoBodyText>Valid values are dependent on the version of DbgHelp.dll
6778   installed on the machine.<span style='mso-spacerun:yes'>  </span>See the
6779   Microsoft Developer Library for further information.</p>
6780   <p class=MsoBodyText>MiniDumpNormal = 0x00000000,<br>
6781   MiniDumpWithDataSegs = 0x00000001,<br>
6782   MiniDumpWithFullMemory = 0x00000002,<br>
6783   MiniDumpWithHandleData = 0x00000004,<br>
6784   MiniDumpFilterMemory = 0x00000008,<br>
6785   MiniDumpScanMemory = 0x00000010,<br>
6786   MiniDumpWithUnloadedModules = 0x00000020,<br>
6787   MiniDumpWithIndirectlyReferencedMemory = 0x00000040,<br>
6788   MiniDumpFilterModulePaths = 0x00000080,<br>
6789   MiniDumpWithProcessThreadData = 0x00000100,<br>
6790   MiniDumpWithPrivateReadWriteMemory = 0x00000200,<br>
6791   MiniDumpWithoutOptionalData = 0x00000400,<br>
6792   MiniDumpWithFullMemoryInfo = 0x00000800,<br>
6793   MiniDumpWithThreadInfo = 0x00001000,<br>
6794   MiniDumpWithCodeSegs = 0x00002000</p>
6795   </td>
6796  </tr>
6797  <tr style='mso-yfti-irow:3;mso-yfti-lastrow:yes;height:138.25pt'>
6798   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6799   height:138.25pt'>
6800   <h5><a name="_Toc115416244"></a><a name="_Value___:_StoreAnsiFilenames"></a><span
6801   style='mso-bookmark:_Toc115416244'>Value: StoreAnsiFilenames</span></h5>
6802   <p class=MsoBodyText>Type: REG_DWORD<br>
6803   Default: 0x0</p>
6804   <p class=MsoBodyText>This value can be used to force the AFS Client Service
6805   to store filenames using the Windows system's ANSI character set instead of the
6806   OEM Code Page character set which has traditionally been used by SMB file
6807   systems.<span style='mso-spacerun:yes'>  </span></p>
6808   <p class=MsoBodyText>Note: The use of ANSI characters will render access to
6809   files with 8-bit OEM file names unaccessible from Windows.<span
6810   style='mso-spacerun:yes'>  </span>This option is of use primarily when you
6811   wish to allow file names produced on Windows to be accessible from Latin-1
6812   UNIX systems and vice versa.</p>
6813   </td>
6814  </tr>
6815 </table>
6816
6817 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416245">Regkey:<br>
6818 [HKLM\SOFTWARE\OpenAFS\Client\CSCPolicy]</a></h3>
6819
6820 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6821  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6822  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6823  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6824   height:112.0pt'>
6825   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6826   height:112.0pt'>
6827   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416246">Value: &quot;smb/cifs
6828   share name&quot;</a></h5>
6829   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
6830   Default: &lt;none&gt;</p>
6831   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to map SMB/CIFS
6832   shares to Client Side Caching (off-line access) policies. For each share one
6833   of the following policies may be used: &quot;manual&quot;,
6834   &quot;programs&quot;, &quot;documents&quot;, &quot;disable&quot;.<span
6835   style='mso-spacerun:yes'>  </span></p>
6836   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
6837   in afsdsbmt.ini</p>
6838   </td>
6839  </tr>
6840 </table>
6841
6842 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416247"></a><a
6843 name="_Regkey:_[HKLM\SOFTWARE\OpenAFS\Clie"></a><![if !supportLists]><span
6844 style='mso-bookmark:_Toc115416247'></span><![endif]><span style='mso-bookmark:
6845 _Toc115416247'>Regkey:<br>
6846 [HKLM\SOFTWARE\OpenAFS\Client\Freelance]</span></h3>
6847
6848 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6849  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6850  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6851  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6852   height:138.5pt'>
6853   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6854   height:138.5pt'>
6855   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416248">Value: &quot;numeric
6856   value&quot;</a></h5>
6857   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
6858   Default: &lt;none&gt;</p>
6859   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to store dot
6860   terminated mount point strings for use in constructing the fake root.afs
6861   volume when Freelance (dynamic roots) mode is activated.</p>
6862   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;athena.mit.edu#athena.mit.edu:root.cell.&quot;</p>
6863   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;.athena.mit.edu%athena.mit.edu:root.cell.&quot;</p>
6864   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
6865   in afs_freelance.ini</p>
6866   </td>
6867  </tr>
6868 </table>
6869
6870 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416249"></a><a
6871 name="_Regkey:_[HKLM\SOFTWARE\OpenAFS\Clie_1"></a><![if !supportLists]><span
6872 style='mso-bookmark:_Toc115416249'></span><![endif]><span style='mso-bookmark:
6873 _Toc115416249'>Regkey:<br>
6874 [HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks]</span></h3>
6875
6876 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6877  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6878  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6879  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6880   height:145.0pt'>
6881   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6882   height:145.0pt'>
6883   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416250">Value: &quot;numeric
6884   value&quot;</a></h5>
6885   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
6886   Default: &lt;none&gt;</p>
6887   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to store a dot
6888   terminated symlink strings for use in constructing the fake root.afs volume
6889   when Freelance (dynamic roots) mode is activated.</p>
6890   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;linkname:destination-path.&quot;</p>
6891   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;<st1:GivenName w:st="on">athena</st1:GivenName>:athena.mit.edu.&quot;</p>
6892   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;home:athena.mit.edu\user\j\a\jaltman.&quot;</p>
6893   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;filename:path\file.&quot;</p>
6894   </td>
6895  </tr>
6896 </table>
6897
6898 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416251">Regkey:<br>
6899 [HKLM\SOFTWARE\OpenAFS\Client\Submounts]</a></h3>
6900
6901 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6902  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6903  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6904  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6905   height:171.75pt'>
6906   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6907   height:171.75pt'>
6908   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416252">Value: &quot;submount
6909   name&quot;</a></h5>
6910   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_EXPAND_SZ<br>
6911   Default: &lt;none&gt;</p>
6912   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to store
6913   mappings of UNIX style AFS paths to submount names which can be referenced as
6914   UNC paths.<span style='mso-spacerun:yes'>  </span>For example the submount
6915   string /athena.mit.edu/user/j/a/jaltman&quot; can be associated with the
6916   submount name &quot;jaltman.home&quot;.<span style='mso-spacerun:yes'>
6917   </span>This can then be referenced as the UNC path \\AFS\jaltman.home.</p>
6918   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
6919   in afsdsbmt.ini</p>
6920   <p class=MsoBodyText style='mso-yfti-cnfc:1'>NOTE: Submounts should no longer
6921   be used with OpenAFS. Use the Windows Explorer to create drive mappings to
6922   AFS UNC paths instead of using the AFS Submount mechanism.</p>
6923   </td>
6924  </tr>
6925 </table>
6926
6927 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416253"></a><a
6928 name="_Regkey:_[HKLM\SOFTWARE\OpenAFS\Clie_2"></a><![if !supportLists]><span
6929 style='mso-bookmark:_Toc115416253'></span><![endif]><span style='mso-bookmark:
6930 _Toc115416253'>Regkey:<br>
6931 [HKLM\SOFTWARE\OpenAFS\Client\Server Preferences\VLDB]</span></h3>
6932
6933 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6934  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6935  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6936  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6937   height:105.5pt'>
6938   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6939   height:105.5pt'>
6940   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416254">Value: &quot;hostname or
6941   ip address&quot;</a></h5>
6942   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_DWORD<br>
6943   Default: &lt;none&gt;</p>
6944   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to specify a
6945   default set of VLDB server preferences. For each entry the value name will be
6946   either the IP address of a server or a fully qualified domain name.<span
6947   style='mso-spacerun:yes'>  </span>The value will be the ranking.<span
6948   style='mso-spacerun:yes'>  </span>The ranking will be adjusted by a random
6949   value between 0 and 256 prior to the preference being set.</p>
6950   </td>
6951  </tr>
6952 </table>
6953
6954 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416255">Regkey:<br>
6955 [HKLM\SOFTWARE\OpenAFS\Client\Server Preferences\File]</a></h3>
6956
6957 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6958  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6959  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6960  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6961   height:105.5pt'>
6962   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6963   height:105.5pt'>
6964   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416256">Value: &quot;hostname or
6965   ip address&quot;</a></h5>
6966   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_DWORD<br>
6967   Default: &lt;none&gt;</p>
6968   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to specify a default
6969   set of File server preferences. For each entry the value name will be either
6970   the IP address of a server or a fully qualified domain name.<span
6971   style='mso-spacerun:yes'>  </span>The value will be the ranking.<span
6972   style='mso-spacerun:yes'>  </span>The ranking will be adjusted by a random
6973   value between 0 and 256 prior to the preference being set.</p>
6974   </td>
6975  </tr>
6976 </table>
6977
6978 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416257"></a><a
6979 name="_Toc115417105"><span style='mso-bookmark:_Toc115416257'>A.2. Integrated
6980 Logon Network provider parameters</span></a></h2>
6981
6982 <p class=MsoBodyText>Affects the network provider (afslogon.dll).</p>
6983
6984 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416258">Regkey:
6985 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</a></h3>
6986
6987 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6988  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6989  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6990  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6991   height:65.75pt'>
6992   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6993   height:65.75pt'>
6994   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416259">Value: FailLoginsSilently</a></h5>
6995   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD<br>
6996   Default: 0</p>
6997   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Do not display message boxes if
6998   the login fails.</p>
6999   </td>
7000  </tr>
7001 </table>
7002
7003 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416260">Regkey:<br>
7004 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]</a></h3>
7005
7006 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7007  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7008  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7009  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:65.75pt'>
7010   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7011   height:65.75pt'>
7012   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416261">Value: NoWarnings</a></h5>
7013   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD<br>
7014   Default: 0</p>
7015   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Disables visible warnings during
7016   logon.</p>
7017   </td>
7018  </tr>
7019  <tr style='mso-yfti-irow:0;height:65.75pt'>
7020   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7021   height:65.75pt'>
7022   <h5><a name="_Toc115416262">Value: AuthentProviderPath</a></h5>
7023   <p class=MsoBodyText>Type: REG_SZ<br>
7024   NSIS: %WINDIR%\SYSTEM32\afslogon.dll</p>
7025   <p class=MsoBodyText>Specifies the install location of the authentication
7026   provider dll.</p>
7027   </td>
7028  </tr>
7029  <tr style='mso-yfti-irow:1;height:65.75pt'>
7030   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7031   height:65.75pt'>
7032   <h5><a name="_Toc115416263">Value: Class</a></h5>
7033   <p class=MsoBodyText>Type: DWORD<br>
7034   NSIS: 0x02</p>
7035   <p class=MsoBodyText>Specifies the class of network provider</p>
7036   </td>
7037  </tr>
7038  <tr style='mso-yfti-irow:2;height:92.0pt'>
7039   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7040   height:92.0pt'>
7041   <h5><a name="_Toc115416264">Value: DependOnGroup</a></h5>
7042   <p class=MsoBodyText>Type: REG_MULTI_SZ<br>
7043   NSIS: PNP_TDI</p>
7044   <p class=MsoBodyText>Specifies the service groups upon which the AFS Client
7045   Service depends.<span style='mso-spacerun:yes'>  </span>Windows should not
7046   attempt to start the AFS Client Service until all of the services within
7047   these groups have successfully started.</p>
7048   </td>
7049  </tr>
7050  <tr style='mso-yfti-irow:3;height:92.0pt'>
7051   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7052   height:92.0pt'>
7053   <h5><a name="_Toc115416265">Value: DependOnService</a></h5>
7054   <p class=MsoBodyText>Type: REG_MULTI_SZ<br>
7055   NSIS: Tcpip NETBIOS RpcSs</p>
7056   <p class=MsoBodyText>Specifies a list of services upon which the AFS Client
7057   Service depends.<span style='mso-spacerun:yes'>  </span>Windows should not
7058   attempt to start the AFS Client Service until all of the specified services
7059   have successfully started.</p>
7060   </td>
7061  </tr>
7062  <tr style='mso-yfti-irow:4;height:65.75pt'>
7063   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7064   height:65.75pt'>
7065   <h5><a name="_Toc115416266">Value: Name</a></h5>
7066   <p class=MsoBodyText>Type: REG_SZ<br>
7067   NSIS: &quot;OpenAFSDaemon&quot;</p>
7068   <p class=MsoBodyText>Specifies the display name of the AFS Client Service</p>
7069   </td>
7070  </tr>
7071  <tr style='mso-yfti-irow:5;mso-yfti-lastrow:yes;height:65.75pt'>
7072   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7073   height:65.75pt'>
7074   <h5><a name="_Toc115416267">Value: ProviderPath</a></h5>
7075   <p class=MsoBodyText>Type: REG_SZ<br>
7076   NSIS: %WINDIR%\SYSTEM32\afslogon.dll</p>
7077   <p class=MsoBodyText>Specifies the DLL to use for the network provider</p>
7078   </td>
7079  </tr>
7080 </table>
7081
7082 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417106"></a><a
7083 name="_Toc115416268"></a><a name="_A.2.1_Domain_specific_configuration"></a><![if !supportLists]><span
7084 style='mso-bookmark:_Toc115417106'><span style='mso-bookmark:_Toc115416268'></span></span><![endif]><span
7085 style='mso-bookmark:_Toc115417106'><span style='mso-bookmark:_Toc115416268'>A.2.1
7086 Domain specific configuration keys for the Network Provider</span></span></h2>
7087
7088 <p class=MsoBodyText>The network provider can be configured to have different
7089 behavior depending on the domain that the user logs into.<span
7090 style='mso-spacerun:yes'>  </span>These settings are only relevant when using
7091 integrated login.<span style='mso-spacerun:yes'>  </span>A domain refers to an
7092 Active Directory (AD) domain, a trusted Kerberos (non-AD) realm or the local
7093 machine (i.e. local account logins).<span style='mso-spacerun:yes'>  </span>The
7094 domain name that is used for selecting the domain would be the domain that is
7095 passed into the NPLogonNotify function of the network provider.</p>
7096
7097 <p class=MsoBodyText>Domain specific registry keys are:</p>
7098
7099 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416269">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]</a></h3>
7100
7101 <p class=MsoBodyText><span style='mso-spacerun:yes'>  </span>(NP key)</p>
7102
7103 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416270">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain]</a></h3>
7104
7105 <p class=MsoBodyText><span style='mso-spacerun:yes'>  </span>(Domains key)</p>
7106
7107 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416271">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\&quot;domain
7108 name&quot;]</a></h3>
7109
7110 <p class=MsoBodyText><span style='mso-spacerun:yes'>  </span>(Specific domain
7111 key. One per domain.)</p>
7112
7113 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416272">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]</a></h3>
7114
7115 <p class=MsoBodyText><span style='mso-spacerun:yes'>  </span>(Localhost key)</p>
7116
7117 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416273">Example:</a></h3>
7118
7119 <p class=PreformattedText><span
7120 style='mso-spacerun:yes'> </span>HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider</p>
7121
7122 <p class=PreformattedText><span style='mso-spacerun:yes'>  </span>|</p>
7123
7124 <p class=PreformattedText><span style='mso-spacerun:yes'>  </span>+- Domain</p>
7125
7126 <p class=PreformattedText><span style='mso-spacerun:yes'>
7127 </span>+-AD1.EXAMPLE.COM</p>
7128
7129 <p class=PreformattedText><span style='mso-spacerun:yes'>
7130 </span>+-AD2.EXAMPLE.NET</p>
7131
7132 <p class=PreformattedText><span style='mso-spacerun:yes'>
7133 </span>+-LOCALHOST</p>
7134
7135 <p class=MsoBodyText>Each of the domain specific keys can have the set of
7136 values described in 2.1.1.<span style='mso-spacerun:yes'>  </span>The effective
7137 values are chosen as described in 2.1.2.</p>
7138
7139 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416274">A.2.1.1
7140 Domain specific configuration values</a></h3>
7141
7142 <h4><a name="_Toc115416275">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]<br>
7143 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain]<br>
7144 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\&quot;domain
7145 name&quot;]<br>
7146 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]</a></h4>
7147
7148 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7149  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7150  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7151  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:191.0pt'>
7152   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7153   height:191.0pt'>
7154   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416276"></a><a
7155   name="_Value___:_LogonOptions"></a><span style='mso-bookmark:_Toc115416276'>Value:
7156   LogonOptions</span></h5>
7157   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD<br>
7158   Default: 0x01</p>
7159   <p class=MsoBodyText style='mso-yfti-cnfc:1'>NSIS/WiX: depends on user configuration</p>
7160   <p class=MsoBodyText style='mso-yfti-cnfc:1'>0x00 - Integrated Logon is not
7161   used<br>
7162   0x01 - Integrated Logon is used<br>
7163   0x02 - High Security Mode is used (deprecated)<br>
7164   0x03 - Integrated Logon with High Security Mode is used (deprecated)</p>
7165   <p class=MsoBodyText style='mso-yfti-cnfc:1'>High Security Mode generates random
7166   SMB names for the creation of Drive Mappings.<span style='mso-spacerun:yes'>
7167   </span>This mode should not be used without Integrated Logon.</p>
7168   <p class=MsoBodyText style='mso-yfti-cnfc:1'>As of 1.3.65 the SMB server
7169   supports SMB authentication.<span style='mso-spacerun:yes'>  </span>The High
7170   Security Mode should not be used when using SMB authentication (SMBAuthType
7171   setting is non zero).</p>
7172   </td>
7173  </tr>
7174  <tr style='mso-yfti-irow:0;height:92.0pt'>
7175   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7176   height:92.0pt'>
7177   <h5><a name="_Toc115416277">Value: FailLoginsSilentl</a></h5>
7178   <p class=MsoBodyText>Type: DWORD (1|0)<br>
7179   Default: 0<br>
7180   NSIS/WiX: (not set)</p>
7181   <p class=MsoBodyText>If true, does not display any visible warnings in the
7182   event of an error during the integrated login process.</p>
7183   </td>
7184  </tr>
7185  <tr style='mso-yfti-irow:1;height:139.0pt'>
7186   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7187   height:139.0pt'>
7188   <h5><a name="_Toc115416278">Value: LogonScript</a></h5>
7189   <p class=MsoBodyText>Type: REG_SZ or REG_EXPAND_SZ<br>
7190   Default: (null)<br>
7191   NSIS/WiX: (only value under NP key) &lt;install path&gt;\afscreds.exe -:%s -x
7192   -a -m -n -q</p>
7193   <p class=MsoBodyText>A logon script that will be scheduled to be run after
7194   the profile load is complete.<span style='mso-spacerun:yes'>  </span>If using
7195   the REG_EXPAND_SZ type, you can use any system environment variable as
7196   &quot;%varname%&quot; which would be expanded at the time the network
7197   provider is run.<span style='mso-spacerun:yes'>  </span>Optionally using a
7198   &quot;%s&quot; in the value would result in it being expanded into the AFS
7199   SMB username for the session.</p>
7200   </td>
7201  </tr>
7202  <tr style='mso-yfti-irow:2;height:105.5pt'>
7203   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7204   height:105.5pt'>
7205   <h5><a name="_Toc115416279">Value: LoginRetryInterval</a></h5>
7206   <p class=MsoBodyText>Type: DWORD<br>
7207   Default: 30<br>
7208   NSIS/WiX: (not set)</p>
7209   <p class=MsoBodyText>If the OpenAFS client service has not started yet, the
7210   network provider will wait for a maximum of &quot;LoginRetryInterval&quot;
7211   seconds while retrying every &quot;LoginSleepInterval&quot; seconds to check
7212   if the service is up.</p>
7213   </td>
7214  </tr>
7215  <tr style='mso-yfti-irow:3;height:79.25pt'>
7216   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7217   height:79.25pt'>
7218   <h5><a name="_Toc115416280">Value: LoginSleepInterval</a></h5>
7219   <p class=MsoBodyText>Type: DWORD<br>
7220   Default: 5<br>
7221   NSIS/WiX: (not set)</p>
7222   <p class=MsoBodyText>See description of LoginRetryInterval.</p>
7223   </td>
7224  </tr>
7225  <tr style='mso-yfti-irow:4;mso-yfti-lastrow:yes;height:78.5pt'>
7226   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7227   height:78.5pt'>
7228   <h5><a name="_Toc115416281"></a><a name="_Value:_TheseCells"></a><span
7229   style='mso-bookmark:_Toc115416281'>Value: TheseCells</span></h5>
7230   <p class=MsoBodyText>Type: REG_MULTI_SZ<br>
7231   NSIS: &lt;not set&gt;</p>
7232   <p class=MsoBodyText>When Kerberos 5 is being used, TheseCells provides a
7233   list of additional cells for which tokens should be obtained with the default
7234   Kerberos 5 principal.</p>
7235   </td>
7236  </tr>
7237 </table>
7238
7239 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416282">A.2.1.2<span
7240 style='mso-spacerun:yes'>  </span>Selection of effective values for domain
7241 specific configuration</a></h3>
7242
7243 <p class=MsoBodyText>During login to domain X, where X is the domain passed
7244 into NPLogonNotify as lpAuthentInfo-&gt;LogonDomainName or the string
7245 'LOCALHOST' if lpAuthentInfo-&gt;LogonDomainName equals the name of the
7246 computer, the following keys will be looked up.</p>
7247
7248 <p class=MsoBodyText style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:
7249 l15 level1 lfo36;tab-stops:list 36.0pt'><![if !supportLists]><span
7250 style='mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
7251 style='mso-list:Ignore'>1.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
7252 </span></span></span><![endif]>NP key. (&quot;HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider&quot;)</p>
7253
7254 <p class=MsoBodyText style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:
7255 l15 level1 lfo36;tab-stops:list 36.0pt'><![if !supportLists]><span
7256 style='mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
7257 style='mso-list:Ignore'>2.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
7258 </span></span></span><![endif]>Domains key. (NP key\&quot;Domain&quot;)</p>
7259
7260 <p class=MsoBodyText style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:
7261 l15 level1 lfo36;tab-stops:list 36.0pt'><![if !supportLists]><span
7262 style='mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
7263 style='mso-list:Ignore'>3.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
7264 </span></span></span><![endif]>Specific domain key. (Domains key\X)</p>
7265
7266 <p class=MsoBodyText>If the specific domain key does not exist, then the
7267 domains key will be ignored.<span style='mso-spacerun:yes'>  </span>All the
7268 configuration information in this case will come from the NP key.</p>
7269
7270 <p class=MsoBodyText>If the specific domain key exists, then for each of the
7271 values metioned in (2), they will be looked up in the specific domain key,
7272 domains key and the NP key successively until the value is found. The first
7273 instance of the value found this way will be the effective for the login
7274 session.<span style='mso-spacerun:yes'>  </span>If no such instance can be
7275 found, the default will be used.<span style='mso-spacerun:yes'>  </span>To
7276 re-iterate, a value in a more specific key supercedes a value in a less
7277 specific key.<span style='mso-spacerun:yes'>  </span>The exceptions to this
7278 rule are stated below.</p>
7279
7280 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416283">A.2.1.3
7281 Exceptions to A.2.1.2</a></h3>
7282
7283 <p class=MsoBodyText>To retain backwards compatibility, the following
7284 exceptions are made to 2.1.2.</p>
7285
7286 <h4><a name="_Toc115416284">2.1.3.1 'FailLoginsSilently'</a></h4>
7287
7288 <p class=MsoBodyText>Historically, the 'FailLoginsSilently' value was in
7289 HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters key and not
7290 in the NP key.<span style='mso-spacerun:yes'>  </span>Therefore, for backwards
7291 compatibility, the value in the Parameters key will supercede all instances of
7292 this value in other keys.<span style='mso-spacerun:yes'>  </span>In the absence
7293 of this value in the Parameters key, normal scope rules apply.</p>
7294
7295 <h4><a name="_Toc115416285">2.1.3.2 'LogonScript'</a></h4>
7296
7297 <p class=MsoBodyText>If a 'LogonScript' is not specified in the specific domain
7298 key nor in the domains key, the value in the NP key will only be checked if the
7299 effective 'LogonOptions' specify a high security integrated login.<span
7300 style='mso-spacerun:yes'>  </span>If a logon script is specified in the
7301 specific domain key or the domains key, it will be used regardless of the high
7302 security setting.<span style='mso-spacerun:yes'>  </span>Please be aware of
7303 this when setting this value.</p>
7304
7305 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416286"></a><a
7306 name="_Toc115417107"><span style='mso-bookmark:_Toc115416286'>A.3. AFS
7307 Credentials System Tray Tool parameters</span></a></h2>
7308
7309 <p class=MsoBodyText>Affects the behavior of afscreds.exe</p>
7310
7311 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416287">Regkey:<br>
7312 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</a></h3>
7313
7314 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7315  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7316  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7317  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:92.0pt'>
7318   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7319   height:92.0pt'>
7320   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416288">Value: Gateway</a></h5>
7321   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
7322   Default: &quot;&quot;<br>
7323   Function: GetGatewayName()</p>
7324   <p class=MsoBodyText style='mso-yfti-cnfc:1'>If the AFS client is utilizing a
7325   gateway to obtain AFS access, the name of the gateway is specified by this
7326   value.</p>
7327   </td>
7328  </tr>
7329  <tr style='mso-yfti-irow:0;mso-yfti-lastrow:yes;height:92.0pt'>
7330   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7331   height:92.0pt'>
7332   <h5><a name="_Toc115416289">Value: Cell</a></h5>
7333   <p class=MsoBodyText>Type: REG_SZ<br>
7334   Default: &lt;none&gt;<br>
7335   Variable: IsServiceConfigured()</p>
7336   <p class=MsoBodyText>The value Cell is used to determine if the AFS Client
7337   Service has been properly configured or not.</p>
7338   </td>
7339  </tr>
7340 </table>
7341
7342 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416290">Regkey:<br>
7343 [HKLM\SOFTWARE\OpenAFS\Client]<br>
7344 [HKCU\SOFTWARE\OpenAFS\Client]</a></h3>
7345
7346 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7347  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7348  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7349  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:157.5pt'>
7350   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7351   height:157.5pt'>
7352   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416291">Value: ShowTrayIcon</a></h5>
7353   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD {0, 1}<br>
7354   Default: 1<br>
7355   Function: InitApp(), Main_OnCheckTerminate()</p>
7356   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This value is used to determine
7357   whether or not a shortcut should be maintained in the user's Start
7358   Menu-&gt;Programs-&gt;Startup folder. </p>
7359   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This value used to be stored at
7360   [HKLM\Software\TransarcCorporation\AFS Client\AfsCreds].</p>
7361   <p class=MsoBodyText style='mso-yfti-cnfc:1'>The current user value is
7362   checked first; if it does not exist the local machine value is checked.</p>
7363   </td>
7364  </tr>
7365  <tr style='mso-yfti-irow:0;height:119.0pt'>
7366   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7367   height:119.0pt'>
7368   <h5><a name="_Toc115416292">Value: EnableKFW</a></h5>
7369   <p class=MsoBodyText>Type: DWORD {0, 1}<br>
7370   Default: 1<br>
7371   Function: KFW_is_available()</p>
7372   <p class=MsoBodyText>When MIT Kerberos for Windows can be loaded, Kerberos 5
7373   will be used to obtain AFS credentials.<span style='mso-spacerun:yes'>
7374   </span>By setting this value to 0, the internal Kerberos 4 implementation
7375   will be used instead.<span style='mso-spacerun:yes'>  </span>The current user
7376   value is checked first; if it does not exist the local machine value is
7377   checked.</p>
7378   </td>
7379  </tr>
7380  <tr style='mso-yfti-irow:1;height:119.0pt'>
7381   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7382   height:119.0pt'>
7383   <h5><a name="_Toc115416293"></a><a name="_Value___:_Use524"></a><span
7384   style='mso-bookmark:_Toc115416293'>Value: Use524</span></h5>
7385   <p class=MsoBodyText>Type: DWORD {0, 1}<br>
7386   Default: 0<br>
7387   Function: KFW_use_krb524()</p>
7388   <p class=MsoBodyText>When MIT Kerberos for Windows can be loaded, Kerberos 5
7389   will be used to obtain AFS credentials.<span style='mso-spacerun:yes'>
7390   </span>By setting this value to 1, the Kerberos 5 tickets will be converted
7391   to Kerberos 4 tokens via a call to the krb524 daemon.<span
7392   style='mso-spacerun:yes'>  </span>The current user value is checked first; if
7393   it does not exist the local machine value is checked.</p>
7394   </td>
7395  </tr>
7396  <tr style='mso-yfti-irow:2;mso-yfti-lastrow:yes;height:251.5pt'>
7397   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7398   height:251.5pt'>
7399   <h5><a name="_Toc115416294"></a><a name="_Value___:_AfscredsShortcutParams"></a><span
7400   style='mso-bookmark:_Toc115416294'>Value: AfscredsShortcutParams</span></h5>
7401   <p class=MsoBodyText>Type: REG_SZ<br>
7402   Default: &quot;-A -M -N -Q&quot;<br>
7403   Function: Shortcut_FixStartup</p>
7404   <p class=MsoBodyText>This value specifies the command line options which
7405   should be set as part of the shortcut to afscreds.exe.<span
7406   style='mso-spacerun:yes'>  </span>afscreds.exe rewrites the shortcut each
7407   time it exits so as to ensure that the shortcut points to the latest version
7408   of the program.<span style='mso-spacerun:yes'>  </span>This value is used to
7409   determine which values should be used for command line parameters.<span
7410   style='mso-spacerun:yes'>  </span>The current user value is checked first; if
7411   it does not exist the local machine value is checked.</p>
7412   <p class=MsoBodyText>The following subset of the command line options is
7413   appropriate for use in this registry setting:</p>
7414   <p class=MsoBodyText>-A = autoinit<br>
7415   -M = renew drive maps<br>
7416   -N = ip address change detection<br>
7417   -Q = quiet mode.<span style='mso-spacerun:yes'>  </span>do not display start
7418   service dialog if afsd_service is not already running<br>
7419   -S = show tokens dialog on startup<br>
7420   -Z = unmap drives</p>
7421   </td>
7422  </tr>
7423 </table>
7424
7425 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416295">Regkey:<br>
7426 [HKCU\SOFTWARE\OpenAFS\Client]</a></h3>
7427
7428 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7429  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7430  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7431  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7432   height:92.0pt'>
7433   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7434   height:92.0pt'>
7435   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416296">Value: Authentication
7436   Cell</a></h5>
7437   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
7438   Default: &lt;none&gt;<br>
7439   Function: Afscreds.exe GetDefaultCell()</p>
7440   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This value allows the user to
7441   configure a different cell name to be used as the default cell when acquiring
7442   tokens in afscreds.exe.</p>
7443   </td>
7444  </tr>
7445 </table>
7446
7447 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416297">Regkey:<br>
7448 [HKCU\SOFTWARE\OpenAFS\Client\Reminders]</a></h3>
7449
7450 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7451  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7452  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7453  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7454   height:124.75pt'>
7455   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7456   height:124.75pt'>
7457   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416298">Value: &quot;afs cell
7458   name&quot;</a></h5>
7459   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD {0, 1}<br>
7460   Default: &lt;none&gt;<br>
7461   Function: LoadRemind(), SaveRemind()</p>
7462   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values are used to save and
7463   restore the state of the reminder flag for each cell for which the user has
7464   obtained tokens.</p>
7465   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This value used to be stored at
7466   [HKLM\Software\TransarcCorporation\AFS Client\AfsCreds].</p>
7467   </td>
7468  </tr>
7469 </table>
7470
7471 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416299">Regkey:<br>
7472 [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]</a></h3>
7473
7474 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7475  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7476  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7477  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7478   height:98.5pt'>
7479   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7480   height:98.5pt'>
7481   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416300">Value: &quot;upper case
7482   drive letter&quot;</a></h5>
7483   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD {0, 1}<br>
7484   Default: &lt;none&gt;</p>
7485   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values are used to store
7486   the persistence state of the AFS drive mappings as listed in the
7487   [...\Client\Mappings] key.</p>
7488   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
7489   in the afsdsbmt.ini file</p>
7490   </td>
7491  </tr>
7492 </table>
7493
7494 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416301">Regkey:<br>
7495 [HKCU\SOFTWARE\OpenAFS\Client\Mappings]</a></h3>
7496
7497 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7498  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7499  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7500  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7501   height:98.5pt'>
7502   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7503   height:98.5pt'>
7504   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416302">Value: &quot;upper case
7505   drive letter&quot;</a></h5>
7506   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
7507   Default: &lt;none&gt;</p>
7508   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values are used to store
7509   the AFS path in UNIX notation to which the drive letter is to be mapped.</p>
7510   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored in
7511   the afsdsbmt.ini file.</p>
7512   </td>
7513  </tr>
7514 </table>
7515
7516 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416303"></a><a
7517 name="_Toc115417108"><span style='mso-bookmark:_Toc115416303'>A.4 OpenAFS
7518 Client Service Environment Variables</span></a></h2>
7519
7520 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7521  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7522  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7523  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
7524   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
7525   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416304">Variable: AFS_RPC_ENCRYPT</a></h5>
7526   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Values:<span
7527   style='mso-spacerun:yes'>   </span>&quot;OFF&quot; disables the use of RPC
7528   encryption any other value allows RPC encryption to be used<br>
7529   Default:<span style='mso-spacerun:yes'>  </span>RPC encryption is on</p>
7530   </td>
7531  </tr>
7532  <tr style='mso-yfti-irow:0;mso-yfti-lastrow:yes'>
7533   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
7534   <h5><a name="_Toc115416305">Variable: AFS_RPC_PROTSEQ</a></h5>
7535   <p class=MsoBodyText>Values:<span style='mso-tab-count:1'>            </span>&quot;ncalrpc&quot;<span
7536   style='mso-spacerun:yes'>  </span>- local RPC<br>
7537   <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:2'>                      </span>&quot;ncacn_np&quot;
7538   - named pipes<br>
7539   <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:2'>                      </span>&quot;ncacn_ip_tcp&quot;
7540   - tcp/ip<br>
7541   Default:<span style='mso-spacerun:yes'>  </span>local RPC</p>
7542   </td>
7543  </tr>
7544 </table>
7545
7546 <p class=MsoBodyText><o:p>&nbsp;</o:p></p>
7547
7548 </div>
7549
7550 </body>
7551
7552 </html>