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>3</o:Revision>
  40   <o:TotalTime>39</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-09-27T00:33:00Z</o:LastSaved>
  44   <o:Pages>1</o:Pages>
  45   <o:Words>14488</o:Words>
  46   <o:Characters>82584</o:Characters>
  47   <o:Company>Secure Endpoints Inc.</o:Company>
  48   <o:Lines>688</o:Lines>
  49   <o:Paragraphs>193</o:Paragraphs>
  50   <o:CharactersWithSpaces>96879</o:CharactersWithSpaces>
  51   <o:Version>11.6408</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-ansi-language:#0400;
2279         mso-fareast-language:#0400;
2280         mso-bidi-language:#0400;}
2281 table.MsoTable3DFx1
2282         {mso-style-name:"Table 3D effects 1";
2283         mso-tstyle-rowband-size:0;
2284         mso-tstyle-colband-size:0;
2285         mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
2286         mso-tstyle-shading:white;
2287         mso-tstyle-pattern:solid silver;
2288         mso-para-margin-top:7.2pt;
2289         mso-para-margin-right:0pt;
2290         mso-para-margin-bottom:7.2pt;
2291         mso-para-margin-left:0pt;
2292         mso-pagination:none;
2293         mso-hyphenate:none;
2294         font-size:10.0pt;
2295         font-family:"Times New Roman";
2296         mso-ansi-language:#0400;
2297         mso-fareast-language:#0400;
2298         mso-bidi-language:#0400;}
2299 table.MsoTable3DFx1FirstRow
2300         {mso-style-name:"Table 3D effects 1";
2301         mso-table-condition:first-row;
2302         mso-tstyle-border-bottom:.75pt solid gray;
2303         mso-tstyle-diagonal-down:0pt none windowtext;
2304         mso-tstyle-diagonal-up:0pt none windowtext;
2305         color:purple;
2306         mso-ansi-font-weight:bold;
2307         mso-bidi-font-weight:bold;}
2308 table.MsoTable3DFx1LastRow
2309         {mso-style-name:"Table 3D effects 1";
2310         mso-table-condition:last-row;
2311         mso-tstyle-border-top:.75pt solid white;
2312         mso-tstyle-diagonal-down:0pt none windowtext;
2313         mso-tstyle-diagonal-up:0pt none windowtext;}
2314 table.MsoTable3DFx1FirstCol
2315         {mso-style-name:"Table 3D effects 1";
2316         mso-table-condition:first-column;
2317         mso-tstyle-border-right:.75pt solid gray;
2318         mso-tstyle-diagonal-down:0pt none windowtext;
2319         mso-tstyle-diagonal-up:0pt none windowtext;
2320         mso-ansi-font-weight:bold;
2321         mso-bidi-font-weight:bold;}
2322 table.MsoTable3DFx1LastCol
2323         {mso-style-name:"Table 3D effects 1";
2324         mso-table-condition:last-column;
2325         mso-tstyle-border-left:.75pt solid white;
2326         mso-tstyle-diagonal-down:0pt none windowtext;
2327         mso-tstyle-diagonal-up:0pt none windowtext;}
2328 table.MsoTable3DFx1NECell
2329         {mso-style-name:"Table 3D effects 1";
2330         mso-table-condition:ne-cell;
2331         mso-tstyle-border-left:0pt none windowtext;
2332         mso-tstyle-border-bottom:0pt none windowtext;
2333         mso-tstyle-diagonal-down:0pt none windowtext;
2334         mso-tstyle-diagonal-up:0pt none windowtext;}
2335 table.MsoTable3DFx1NWCell
2336         {mso-style-name:"Table 3D effects 1";
2337         mso-table-condition:nw-cell;
2338         mso-tstyle-border-bottom:0pt none windowtext;
2339         mso-tstyle-border-right:0pt none windowtext;
2340         mso-tstyle-diagonal-down:0pt none windowtext;
2341         mso-tstyle-diagonal-up:0pt none windowtext;}
2342 table.MsoTable3DFx1SECell
2343         {mso-style-name:"Table 3D effects 1";
2344         mso-table-condition:se-cell;
2345         mso-tstyle-border-top:0pt none windowtext;
2346         mso-tstyle-border-left:0pt none windowtext;
2347         mso-tstyle-diagonal-down:0pt none windowtext;
2348         mso-tstyle-diagonal-up:0pt none windowtext;}
2349 table.MsoTable3DFx1SWCell
2350         {mso-style-name:"Table 3D effects 1";
2351         mso-table-condition:sw-cell;
2352         mso-tstyle-border-top:0pt none windowtext;
2353         mso-tstyle-border-right:0pt none windowtext;
2354         mso-tstyle-diagonal-down:0pt none windowtext;
2355         mso-tstyle-diagonal-up:0pt none windowtext;
2356         color:navy;}
2357 table.MsoTableWeb1
2358         {mso-style-name:"Table Web 1";
2359         mso-tstyle-rowband-size:0;
2360         mso-tstyle-colband-size:0;
2361         mso-cellspacing:2.0pt;
2362         border:outset 1.0pt;
2363         mso-border-alt:outset windowtext .75pt;
2364         mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
2365         mso-border-insideh:.75pt outset windowtext;
2366         mso-border-insidev:.75pt outset windowtext;
2367         mso-para-margin-top:7.2pt;
2368         mso-para-margin-right:0pt;
2369         mso-para-margin-bottom:7.2pt;
2370         mso-para-margin-left:0pt;
2371         mso-pagination:none;
2372         mso-hyphenate:none;
2373         font-size:10.0pt;
2374         font-family:"Times New Roman";
2375         mso-ansi-language:#0400;
2376         mso-fareast-language:#0400;
2377         mso-bidi-language:#0400;}
2378 table.MsoTableWeb1FirstRow
2379         {mso-style-name:"Table Web 1";
2380         mso-table-condition:first-row;
2381         mso-tstyle-diagonal-down:0pt none windowtext;
2382         mso-tstyle-diagonal-up:0pt none windowtext;
2383         color:windowtext;}
2384 table.MsoTableWeb3
2385         {mso-style-name:"Table Web 3";
2386         mso-tstyle-rowband-size:0;
2387         mso-tstyle-colband-size:0;
2388         mso-cellspacing:2.0pt;
2389         border:outset 3.0pt;
2390         mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
2391         mso-border-insideh:.75pt outset windowtext;
2392         mso-border-insidev:.75pt outset windowtext;
2393         mso-para-margin-top:7.2pt;
2394         mso-para-margin-right:0pt;
2395         mso-para-margin-bottom:7.2pt;
2396         mso-para-margin-left:0pt;
2397         mso-pagination:none;
2398         mso-hyphenate:none;
2399         font-size:10.0pt;
2400         font-family:"Times New Roman";
2401         mso-ansi-language:#0400;
2402         mso-fareast-language:#0400;
2403         mso-bidi-language:#0400;}
2404 table.MsoTableWeb3FirstRow
2405         {mso-style-name:"Table Web 3";
2406         mso-table-condition:first-row;
2407         mso-tstyle-diagonal-down:0pt none windowtext;
2408         mso-tstyle-diagonal-up:0pt none windowtext;
2409         color:windowtext;}
2410 table.MsoTableGrid
2411         {mso-style-name:"Table Grid";
2412         mso-tstyle-rowband-size:0;
2413         mso-tstyle-colband-size:0;
2414         border:solid windowtext 1.0pt;
2415         mso-border-alt:solid windowtext .5pt;
2416         mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
2417         mso-border-insideh:.5pt solid windowtext;
2418         mso-border-insidev:.5pt solid windowtext;
2419         mso-para-margin-top:7.2pt;
2420         mso-para-margin-right:0pt;
2421         mso-para-margin-bottom:7.2pt;
2422         mso-para-margin-left:0pt;
2423         mso-pagination:none;
2424         mso-hyphenate:none;
2425         font-size:10.0pt;
2426         font-family:"Times New Roman";
2427         mso-ansi-language:#0400;
2428         mso-fareast-language:#0400;
2429         mso-bidi-language:#0400;}
2430 </style>
2431 <![endif]--><!--[if gte mso 9]><xml>
2432  <o:shapedefaults v:ext="edit" spidmax="3074"/>
2433 </xml><![endif]--><!--[if gte mso 9]><xml>
2434  <o:shapelayout v:ext="edit">
2435   <o:idmap v:ext="edit" data="1"/>
2436  </o:shapelayout></xml><![endif]-->
2437 </head>
2438
2439 <body lang=EN-US link=navy vlink=maroon style='tab-interval:35.45pt;line-break:
2440 strict'>
2441
2442 <div class=Section1>
2443
2444 <p class=MsoTitle>OpenAFS for Windows 1.4.0<br>
2445 Release Notes</p>
2446
2447 <p class=MsoBodyText>The Andrew File System (AFS) is a location-independent
2448 file system that uses a local cache to increase its performance.<span
2449 style='mso-spacerun:yes'>  </span>An AFS client accesses files anonymously or
2450 via a Kerberos authentication.<span style='mso-spacerun:yes'>  </span>The
2451 global AFS is partitioned into cells.<span style='mso-spacerun:yes'>
2452 </span>The AFS cell is a collection of AFS volumes that are administered by a
2453 common entity.<span style='mso-spacerun:yes'>   </span>AFS cells can be
2454 administered by a department even when the Kerberos realm used for local
2455 authentication is managed by a much larger organization.<span
2456 style='mso-spacerun:yes'>  </span>AFS clients and servers take advantage of
2457 Kerberos cross realm authentication to enable authenticated access by entities
2458 located outside the local realm.<span style='mso-spacerun:yes'>  </span>Authorization
2459 is enforced by the use of directory level access control lists which can
2460 consist of individual or group identities.<span style='mso-spacerun:yes'>
2461 </span></p>
2462
2463 <p class=MsoBodyText>The AFS volume is a tree of files and
2464 sub-directories.<span style='mso-spacerun:yes'>  </span>AFS volumes are created
2465 by administrators and are joined to an AFS cell via the use of a mount
2466 point.<span style='mso-spacerun:yes'>   </span>Once a volume is created, users
2467 can create files and directories as well as mount points and symlinks within
2468 the volume without regard for the physical location of the volume.<span
2469 style='mso-spacerun:yes'>  </span>Administrators can move the volume to another
2470 server as necessary without the need to notify users.<span
2471 style='mso-spacerun:yes'>   </span>In fact, the volume move can occur while
2472 files in the volume are in use.<span style='mso-spacerun:yes'>  </span></p>
2473
2474 <p class=MsoBodyText>AFS volumes can be replicated to read-only copies.<span
2475 style='mso-spacerun:yes'>   </span>When accessing files from a read-only
2476 replica, clients will read all of the data from a single replica.<span
2477 style='mso-spacerun:yes'>   </span>If that replica becomes unavailable, the
2478 clients will failover to any replica that is reachable.<span
2479 style='mso-spacerun:yes'>  </span>Users of the data are unaware of where the replicas
2480 are stored or which one is being accessed.<span style='mso-spacerun:yes'>
2481 </span>The contents of the replicas can be updated at any time by <i
2482 style='mso-bidi-font-style:normal'>releasing</i> the current contents of the
2483 source volume.</p>
2484
2485 <p class=MsoBodyText>OpenAFS for Windows (OAFW) provides AFS client access
2486 Microsoft Windows operating systems.<span style='mso-spacerun:yes'>  </span>It
2487 strives to maintain transparency such that the user is unaware of the distinction
2488 between the use of AFS and Microsoft Windows file shares.<span
2489 style='mso-spacerun:yes'>   </span>OAFW can be part of a single sign-on
2490 solution by allowing credentials for a Kerberos principal to be obtained at
2491 logon and for that principal to be used to obtain AFS tokens for one or more
2492 cells.<span style='mso-spacerun:yes'>   </span>Although OAFW is implemented as
2493 a locally installed SMB to AFS gateway, OAFW maintains the portability of file
2494 paths by its use of the <a href="file:///\\AFS">\\AFS</a> UNC server name.</p>
2495
2496 <p class=MsoBodyText>OpenAFS is the product of an open source development
2497 effort begun in July 2001.<span style='mso-spacerun:yes'>  </span>OpenAFS is
2498 maintained and developed by a group of volunteers with the support of the user
2499 community.<span style='mso-spacerun:yes'>   </span>If you use OpenAFS as part
2500 of your computing infrastructure please contribute to its continued growth.</p>
2501
2502 <p class=MsoToc1><!--[if supportFields]><span style='mso-element:field-begin'></span><span
2503 style='mso-spacerun:yes'> </span>TOC \o &quot;1-1&quot; \h \z \u <span
2504 style='mso-element:field-separator'></span><![endif]--><span
2505 class=MsoHyperlink><span style='mso-no-proof:yes'><a href="#_Toc115417109">1.
2506 Installer Options<span style='color:windowtext;display:none;mso-hide:screen;
2507 text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
2508 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2509 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2510 _Toc115417109 \h </span><span style='color:windowtext;text-decoration:none;
2511 text-underline:none'><span style='display:none;mso-hide:screen'><span
2512 style='mso-element:field-separator'></span></span></span><![endif]--><span
2513 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2514 text-underline:none'>1<!--[if gte mso 9]><xml>
2515  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100300039000000</w:data>
2516 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2517 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2518 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2519 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2520 mso-no-proof:yes'><o:p></o:p></span></p>
2521
2522 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
2523 href="#_Toc115417110">2. System Requirements<span style='color:windowtext;
2524 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2525 style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
2526 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2527 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2528 _Toc115417110 \h </span><span style='color:windowtext;text-decoration:none;
2529 text-underline:none'><span style='display:none;mso-hide:screen'><span
2530 style='mso-element:field-separator'></span></span></span><![endif]--><span
2531 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2532 text-underline:none'>2<!--[if gte mso 9]><xml>
2533  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310030000000</w:data>
2534 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2535 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2536 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2537 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2538 mso-no-proof:yes'><o:p></o:p></span></p>
2539
2540 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
2541 href="#_Toc115417111">3. Operational Notes<span style='color:windowtext;
2542 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2543 style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
2544 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2545 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF _Toc115417111
2546 \h </span><span style='color:windowtext;text-decoration:none;text-underline:
2547 none'><span style='display:none;mso-hide:screen'><span style='mso-element:field-separator'></span></span></span><![endif]--><span
2548 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2549 text-underline:none'>2<!--[if gte mso 9]><xml>
2550  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310031000000</w:data>
2551 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2552 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2553 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2554 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2555 mso-no-proof:yes'><o:p></o:p></span></p>
2556
2557 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
2558 href="#_Toc115417112">4. How to Debug Problems with OpenAFS for Windows:<span
2559 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2560 text-underline:none'><span style='mso-tab-count:1 dotted'> </span></span><!--[if supportFields]><span
2561 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2562 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2563 _Toc115417112 \h </span><span style='color:windowtext;text-decoration:none;
2564 text-underline:none'><span style='display:none;mso-hide:screen'><span
2565 style='mso-element:field-separator'></span></span></span><![endif]--><span
2566 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2567 text-underline:none'>11<!--[if gte mso 9]><xml>
2568  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310032000000</w:data>
2569 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2570 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2571 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2572 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2573 mso-no-proof:yes'><o:p></o:p></span></p>
2574
2575 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
2576 href="#_Toc115417113">5. Reporting Bugs:<span style='color:windowtext;
2577 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2578 style='mso-tab-count:1 dotted'> </span></span><!--[if supportFields]><span
2579 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2580 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2581 _Toc115417113 \h </span><span style='color:windowtext;text-decoration:none;
2582 text-underline:none'><span style='display:none;mso-hide:screen'><span
2583 style='mso-element:field-separator'></span></span></span><![endif]--><span
2584 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2585 text-underline:none'>13<!--[if gte mso 9]><xml>
2586  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310033000000</w:data>
2587 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2588 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2589 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2590 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2591 mso-no-proof:yes'><o:p></o:p></span></p>
2592
2593 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
2594 href="#_Toc115417114">6. How to Contribute to the Development of OpenAFS for
2595 Windows<span style='color:windowtext;display:none;mso-hide:screen;text-decoration:
2596 none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
2597 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2598 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2599 _Toc115417114 \h </span><span style='color:windowtext;text-decoration:none;
2600 text-underline:none'><span style='display:none;mso-hide:screen'><span
2601 style='mso-element:field-separator'></span></span></span><![endif]--><span
2602 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2603 text-underline:none'>14<!--[if gte mso 9]><xml>
2604  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310034000000</w:data>
2605 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2606 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2607 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2608 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2609 mso-no-proof:yes'><o:p></o:p></span></p>
2610
2611 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
2612 href="#_Toc115417115">7. MSI Deployment Guide<span style='color:windowtext;
2613 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2614 style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
2615 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2616 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2617 _Toc115417115 \h </span><span style='color:windowtext;text-decoration:none;
2618 text-underline:none'><span style='display:none;mso-hide:screen'><span
2619 style='mso-element:field-separator'></span></span></span><![endif]--><span
2620 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2621 text-underline:none'>15<!--[if gte mso 9]><xml>
2622  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310035000000</w:data>
2623 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2624 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2625 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2626 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2627 mso-no-proof:yes'><o:p></o:p></span></p>
2628
2629 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
2630 href="#_Toc115417116">Appendix A: Registry Values<span style='color:windowtext;
2631 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2632 style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
2633 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2634 text-underline:none'><span style='mso-element:field-begin'></span> PAGEREF
2635 _Toc115417116 \h </span><span style='color:windowtext;text-decoration:none;
2636 text-underline:none'><span style='display:none;mso-hide:screen'><span
2637 style='mso-element:field-separator'></span></span></span><![endif]--><span
2638 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
2639 text-underline:none'>26<!--[if gte mso 9]><xml>
2640  <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310036000000</w:data>
2641 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
2642 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
2643 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
2644 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
2645 mso-no-proof:yes'><o:p></o:p></span></p>
2646
2647 <h1 style='margin-left:0pt;text-indent:0pt'><!--[if supportFields]><span
2648 style='mso-element:field-end'></span><![endif]--><a name="_Toc115416098"></a><a
2649 name="_Toc115417037"></a><a name="_Toc115417109"><span style='mso-bookmark:
2650 _Toc115417037'><span style='mso-bookmark:_Toc115416098'>1. Installer Options</span></span></a></h1>
2651
2652 <p class=MsoNormal>It can be installed either as a new installation or an
2653 upgrade from previous versions of OpenAFS for Windows or IBM AFS for
2654 Windows.<span style='mso-spacerun:yes'>  </span>Installers are provided in two
2655 forms:</p>
2656
2657 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l0 level1 lfo4;
2658 tab-stops:list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;
2659 mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
2660 style='mso-list:Ignore'>1.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2661 </span></span></span><![endif]>an executable (.exe) that is built using the
2662 Nullsoft Scriptable Installation System, or</p>
2663
2664 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l0 level1 lfo4;
2665 tab-stops:list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;
2666 mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
2667 style='mso-list:Ignore'>2.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2668 </span></span></span><![endif]>a Windows Installer package (.msi) that is built
2669 using WiX and can be customized for organizations via the use of MSI Transforms
2670 (see <a href="#_MSI_Deployment_Guide">MSI Deployment Guide</a>)</p>
2671
2672 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416099"></a><a
2673 name="_Toc115417038"></a><a name="_Toc115417110"><span style='mso-bookmark:
2674 _Toc115417038'><span style='mso-bookmark:_Toc115416099'>2. System Requirements</span></span></a></h1>
2675
2676 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416100"></a><a
2677 name="_Toc115417039"><span style='mso-bookmark:_Toc115416100'>2.1 Supported
2678 Operating Systems</span></a></h2>
2679
2680 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2681 l1 level1 lfo6;tab-stops:list 14.15pt'><![if !supportLists]><span
2682 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2683 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2684 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2685 Windows 2000 Workstation</p>
2686
2687 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2688 l1 level1 lfo6;tab-stops:list 14.15pt'><![if !supportLists]><span
2689 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2690 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2691 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2692 Windows 2000 Server</p>
2693
2694 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2695 l1 level1 lfo6;tab-stops:list 14.15pt'><![if !supportLists]><span
2696 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2697 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2698 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2699 Windows XP Home</p>
2700
2701 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2702 l1 level1 lfo6;tab-stops:list 14.15pt'><![if !supportLists]><span
2703 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2704 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2705 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2706 Windows XP Professional</p>
2707
2708 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2709 l1 level1 lfo6;tab-stops:list 14.15pt'><![if !supportLists]><span
2710 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2711 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2712 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2713 Windows 2003 Server</p>
2714
2715 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2716 l1 level1 lfo6;tab-stops:list 14.15pt'><![if !supportLists]><span
2717 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2718 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2719 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2720 Windows 2003 R2 Server</p>
2721
2722 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416101">2.1.1
2723 Unsupported Operating Systems</a></h3>
2724
2725 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2726 l2 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
2727 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2728 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2729 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2730 Windows 95</p>
2731
2732 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2733 l2 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
2734 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2735 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2736 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2737 Windows 98</p>
2738
2739 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2740 l2 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
2741 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2742 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2743 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2744 Windows 98 OSR2</p>
2745
2746 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2747 l2 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
2748 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2749 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2750 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2751 Windows ME</p>
2752
2753 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2754 l2 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
2755 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2756 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2757 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2758 NT</p>
2759
2760 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2761 l2 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
2762 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2763 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2764 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
2765 Windows Vista (as of Beta 1 bugs in Windows prevent its use)</p>
2766
2767 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
2768 l2 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
2769 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2770 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2771 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>All
2772 64-bit versions of Microsoft Windows on Itanium and x86-64 chipsets.</p>
2773
2774 <p class=MsoNormal>Older releases of OpenAFS are available for download if
2775 those operating systems must be supported.<span style='mso-spacerun:yes'>
2776 </span>The last version of OpenAFS with support for Win9x is 1.2.2b.<span
2777 style='mso-spacerun:yes'>  </span>The last version with support for Windows NT
2778 4.0 is 1.2.10.</p>
2779
2780 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416102"></a><a
2781 name="_Toc115417040"><span style='mso-bookmark:_Toc115416102'>2.2 Disk Space</span></a></h2>
2782
2783 <p class=MsoNormal>Up to 60mb required for the OpenAFS binaries plus 100MB for
2784 the default AFSCache file.<span style='mso-spacerun:yes'>   </span>(The size of
2785 the AFSCache file may be adjusted via the Registry after installation.)</p>
2786
2787 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416103"></a><a
2788 name="_Toc115417041"><span style='mso-bookmark:_Toc115416103'>2.3 Additional
2789 Software</span></a></h2>
2790
2791 <p class=MsoNormal><a href="http://web.mit.edu/kerberos/dist/index.html">MIT
2792 Kerberos for Windows</a> 2.6.x if Kerberos 5 authentication support is desired.</p>
2793
2794 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416104"></a><a
2795 name="_Toc115417042"></a><a name="_Toc115417111"><span style='mso-bookmark:
2796 _Toc115417042'><span style='mso-bookmark:_Toc115416104'>3. Operational Notes</span></span></a></h1>
2797
2798 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416105"></a><a
2799 name="_Toc115417043"><span style='mso-bookmark:_Toc115416105'>3.1. Requirements
2800 for Kerberos 5 Authentication</span></a></h2>
2801
2802 <p class=MsoNormal>The Kerberos 4 infrastructure on which the OpenAFS 1.2
2803 series is reliant is no longer secure.<span style='mso-spacerun:yes'>
2804 </span>Cross-realm Kerberos is very important in the AFS context and most sites
2805 have or are migrating to Kerberos 5 environments.<span
2806 style='mso-spacerun:yes'>  </span>The OpenAFS 1.4 series integrates with MIT
2807 Kerberos for Windows 2.6.5 to support Kerberos 5 authentication including
2808 automatic renewal of AFS tokens and single sign-on via the Microsoft Windows
2809 Kerberos Logon Service.</p>
2810
2811 <p class=MsoNormal>When KFW is installed, the OpenAFS 1.4 client will obtain
2812 Kerberos 5 tickets and use them as tokens without modification.<span
2813 style='mso-spacerun:yes'>  </span>The OpenAFS 1.4 client requires that all of
2814 the AFS Servers with which it communicates support the use of Kerberos 5
2815 tickets as tokens. If Kerberos 5 based tokens are presented to an AFS server
2816 that does not understand them, the server will be unable to communicate with
2817 the client when tokens are present. Kerberos 5 based tokens are supported by
2818 OpenAFS release 1.2.8 or later.<span style='mso-spacerun:yes'>  </span>IBM
2819 Transarc servers do not support Kerberos 5.<!--[if supportFields]><span
2820 style='mso-element:field-begin'></span> XE &quot;Kerberos 5&quot; <![endif]--><!--[if supportFields]><span
2821 style='mso-element:field-end'></span><![endif]--></p>
2822
2823 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416106">3.1.1.
2824 Active Directory</a></h3>
2825
2826 <p class=MsoNormal>There are two things to consider when using a Microsoft
2827 Windows Active Directory as the Kerberos realm that issues the AFS service
2828 ticket.<span style='mso-spacerun:yes'>  </span>First, the Kerberos 5 tickets
2829 issued by Active Directory can be quite large when compared to tickets issued
2830 by a traditional KDC due to the incorporation of authorization data in the <st2:place
2831 w:st="on">PAC.</st2:place><span style='mso-spacerun:yes'>  </span>If the issued
2832 tickets become larger than 344 bytes OpenAFS 1.2 servers will be unable to
2833 process them.<span style='mso-spacerun:yes'>  </span>OpenAFS 1.4 servers can
2834 support the largest tickets that Active Directory can issue.<span
2835 style='mso-spacerun:yes'>  </span>Second, the Kerberos 5 tickets issued by
2836 Windows 2003 Active Directory are encrypted with the DES-CBC-MD5 enctype.<span
2837 style='mso-spacerun:yes'>  </span>OpenAFS 1.2 servers only support the
2838 DES-CBC-CRC enctype.<!--[if supportFields]><span style='mso-element:field-begin'></span>
2839 XE &quot;Active Directory&quot; <![endif]--><!--[if supportFields]><span
2840 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
2841 style='mso-element:field-begin'></span><span
2842 style='mso-spacerun:yes'> </span>XE &quot;DES enctypes&quot; <![endif]--><!--[if supportFields]><span
2843 style='mso-element:field-end'></span><![endif]--></p>
2844
2845 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416107">3.1.2.
2846 Using the krb524 service</a></h3>
2847
2848 <p class=MsoNormal>Some organizations which have AFS cell names and Kerberos
2849 realm names which differ by more then just lower and upper case rely on a
2850 modification to krb524d which maps a Kerberos 5 ticket from realm FOO to a
2851 Kerberos 4 ticket in realm BAR.<span style='mso-spacerun:yes'>  </span>This
2852 allows user@FOO to appear to be user@bar for the purposes of accessing the AFS
2853 cell.<span style='mso-spacerun:yes'>  </span>As of OpenAFS 1.2.8, support was
2854 added to allow the immediate use of Kerberos 5 tickets as AFS (2b) tokens. This
2855 is the first building block necessary to break away from the limitations of
2856 Kerberos 4 with AFS.<span style='mso-spacerun:yes'>  </span>By using Kerberos 5
2857 directly we avoid the security holes inherent in Kerberos 4 cross-realm.<span
2858 style='mso-spacerun:yes'>  </span>We also gain access to cryptographically
2859 stronger algorithms for authentication and encryption. </p>
2860
2861 <p class=MsoNormal>Another reason for using Kerberos 5 directly is because the
2862 krb524 service runs on a port (4444) which has become increasingly blocked by
2863 ISPs.<span style='mso-spacerun:yes'>  </span>The port was used to spread a worm
2864 which attacked Microsoft Windows in the summer of 2003.<span
2865 style='mso-spacerun:yes'>  </span>When the port is blocked users find that they
2866 are unable to authenticate.</p>
2867
2868 <p class=MsoNormal>Replacing the Kerberos 4 ticket with a Kerberos 5 ticket is
2869 a win in all situations except when the cell name does not match the realm name
2870 and the principal names placed into the ACLs are not the principal names from
2871 the Kerberos 5 ticket.<span style='mso-spacerun:yes'>  </span>To support this
2872 transition, OpenAFS for Windows 1.4 adds a new registry value, <i><a
2873 href="#_Value___:_Use524">Use524</a></i>, to force the use of krb524d.<span
2874 style='mso-spacerun:yes'>  </span>However, the availability of this option
2875 should only be used by individuals until such time as their organizations can
2876 provide a more permanent solution.<!--[if supportFields]><span
2877 style='mso-element:field-begin'></span> XE &quot;Kerberos 5&quot; <![endif]--><!--[if supportFields]><span
2878 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
2879 style='mso-element:field-begin'></span><span
2880 style='mso-spacerun:yes'> </span>XE &quot;krb524&quot; <![endif]--><!--[if supportFields]><span
2881 style='mso-element:field-end'></span><![endif]--></p>
2882
2883 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416108"></a><a
2884 name="_Toc115417044"><span style='mso-bookmark:_Toc115416108'>3.2. Use of the
2885 Microsoft Loopback Adapter</span></a></h2>
2886
2887 <p class=MsoNormal>By itself the OpenAFS Client Service does not provide robust
2888 behavior in a plug-n-play network environment.<span style='mso-spacerun:yes'>
2889 </span>Changes to the number of network adapters or their assigned IP addresses
2890 will cause the service to terminate unexpectedly.<span
2891 style='mso-spacerun:yes'>  </span>To avoid this behavior OpenAFS for Windows
2892 installs a single instance of the Microsoft Loopback Adapter (MLA) on the
2893 machine.<span style='mso-spacerun:yes'>  </span>With the MLA installed, the
2894 OpenAFS Client Service will not be affected by the configuration changes of
2895 other network adapters installed on the system.<span style='mso-spacerun:yes'>
2896 </span></p>
2897
2898 <p class=MsoNormal>The MLA is installed with a name of &quot;AFS&quot; and a
2899 pre-assigned IP address in the 10.x.x.x range.<span style='mso-spacerun:yes'>
2900 </span>The MLA is bound to the Client for Microsoft Networks service and not
2901 bound to the File and Printer Sharing for Microsoft Networks.<span
2902 style='mso-spacerun:yes'>  </span>If the MLA is unbound to &quot;Client
2903 Microsoft Networks&quot;, the OpenAFS Client Service will become inaccessible
2904 when the machine is disconnected from the network.<span
2905 style='mso-spacerun:yes'>  </span>If the MLA is bound to &quot;File and Printer
2906 Sharing ...&quot; there will be a service type collision between the name
2907 &quot;AFS&quot; and the name of the machine on the MLA's IP Address that will
2908 result in the OpenAFS client service becoming inaccessible and the &quot;NET VIEW
2909 \\AFS&quot; command will return a &quot;System Error 52&quot; message.<span
2910 style='mso-spacerun:yes'>  </span>To correct the problem:</p>
2911
2912 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
2913 l3 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
2914 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2915 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2916 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
2917 style='mso-spacerun:yes'> </span>stop the AFS Client Service</p>
2918
2919 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
2920 l3 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
2921 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2922 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2923 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
2924 style='mso-spacerun:yes'> </span>bind the &quot;Client for Microsoft
2925 Networks&quot; to the MLA</p>
2926
2927 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
2928 l3 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
2929 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2930 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2931 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
2932 style='mso-spacerun:yes'> </span>unbind &quot;File and Printer Sharing for
2933 Microsoft Networks&quot; from the MLA</p>
2934
2935 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
2936 l3 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
2937 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2938 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2939 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
2940 style='mso-spacerun:yes'> </span>Disable and then re-enable the MLA</p>
2941
2942 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
2943 l3 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
2944 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
2945 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
2946 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
2947 style='mso-spacerun:yes'> </span>start the AFS Client Service</p>
2948
2949 <p class=MsoNormal>When the MLA is not installed the unique NETBIOS name
2950 published by OpenAFS SMB server is &quot;<i>MACHINE</i>-AFS&quot;.<span
2951 style='mso-spacerun:yes'>  </span>One of the benefits of using the MLA is that
2952 the NETBIOS name does not have to be published on any adapter other than the MLA.<span
2953 style='mso-spacerun:yes'>  </span>Therefore the chosen name is no longer
2954 required to be unique.<span style='mso-spacerun:yes'>  </span>Instead the
2955 NETBIOS name associated with the AFS Client Service is simply &quot;AFS&quot;
2956 and portable UNC paths of the form \\AFS\cellname\path can now be used on all
2957 machines.<!--[if supportFields]><span style='mso-element:field-begin'></span>
2958 XE &quot;loopback&quot; <![endif]--><!--[if supportFields]><span
2959 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
2960 style='mso-element:field-begin'></span><span style='mso-spacerun:yes'> </span>XE
2961 &quot;UNC paths&quot; <![endif]--><!--[if supportFields]><span
2962 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
2963 style='mso-element:field-begin'></span><span
2964 style='mso-spacerun:yes'> </span>XE &quot;NETBIOS&quot; <![endif]--><!--[if supportFields]><span
2965 style='mso-element:field-end'></span><![endif]--></p>
2966
2967 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416109"></a><a
2968 name="_Toc115417045"><span style='mso-bookmark:_Toc115416109'>3.3. Using
2969 Freelance (Dynamic Root) Mode to Improve Mobility</span></a></h2>
2970
2971 <p class=MsoNormal>Traditionally, when the OpenAFS Client Service starts it
2972 must be able to access the &quot;root.afs&quot; volume of the default
2973 cell.<span style='mso-spacerun:yes'>  </span>The &quot;root.afs&quot; volume
2974 contains the set of mount points to the &quot;root.cell&quot; volumes of
2975 various cells the administrator of the default cell believes should be
2976 accessible.<span style='mso-spacerun:yes'>  </span>If the &quot;root.afs&quot;
2977 volume is inaccessible when the client service is started, the service will
2978 terminate unexpectedly.<span style='mso-spacerun:yes'>  </span>Since many users
2979 now use laptops or otherwise operate in disconnected environments in which a
2980 VPN may be required to access the cell's servers, it is often the case that the
2981 &quot;root.afs&quot; volume for the default cell is not reachable and the
2982 OpenAFS Client Service will not successfully start. </p>
2983
2984 <p class=MsoNormal>To allow the OpenAFS Client Service to operate in these
2985 environments, a fake &quot;root.afs&quot; volume is dynamically constructed
2986 from mount points and symlinks stored in the local registry.<span
2987 style='mso-spacerun:yes'>  </span>This method of operation is referred to as Freelance
2988 mode.</p>
2989
2990 <p class=MsoNormal>The content of the fake root.afs volume is dynamically
2991 modified as cells are accessed.<span style='mso-spacerun:yes'>  </span>When the
2992 fake &quot;root.afs&quot; volume is initially constructed it will only contain
2993 two mount points: a <i>regular path </i>and <i>read-write path </i>mount point
2994 used to access the &quot;root.cell&quot; volume of the default AFS cell.<span
2995 style='mso-spacerun:yes'>  </span>Any attempt to access a valid cell name will
2996 result in a new mount point being created in the fake &quot;root.afs&quot;
2997 volume.<span style='mso-spacerun:yes'>  </span>If the cellname begins with a
2998 &quot;.&quot; the mount point will be a <i>read-write path</i>; otherwise the
2999 mount point will be a <i>regular path</i>.<span style='mso-spacerun:yes'>
3000 </span>These mount points are preserved in the registry at key:</p>
3001
3002 <p class=PreformattedText style='margin-left:35.45pt'><a
3003 href="#_Regkey:_[HKLMSOFTWAREOpenAFSClie">HKLM\SOFTWARE\OpenAFS\Client\Freelance</a></p>
3004
3005 <p class=MsoNormal>Additional mount points may be manually created using the
3006 &quot;fs mkmount&quot; command.<span style='mso-spacerun:yes'>  </span>Mount
3007 points may be removed using the &quot;fs rmmount&quot; command.</p>
3008
3009 <p class=PreformattedText style='margin-left:35.45pt'>&gt;fs mkmount
3010 \\AFS\athena.mit.edu root.cell athena.mit.edu</p>
3011
3012 <p class=PreformattedText style='margin-left:35.45pt'>&gt;fs mkmount
3013 \\AFS\.athena.mit.edu root.cell athena.mit.edu -rw</p>
3014
3015 <p class=PreformattedText style='margin-left:35.45pt'>&gt;fs rmmount
3016 \\AFS\athena.mit.edu</p>
3017
3018 <p class=PreformattedText style='margin-left:35.45pt'>&gt;fs rmmount \\AFS\.athena.mit.edu</p>
3019
3020 <p class=MsoNormal>Symlinks may also be created within the Freelance root.afs
3021 volume.</p>
3022
3023 <p class=PreformattedText style='margin-left:35.45pt'>&gt;symlink make
3024 \\afs\link \\afs\athena.mit.edu\user\j\a\jaltman</p>
3025
3026 <p class=PreformattedText><span style='mso-tab-count:1'>      </span>&gt;symlink
3027 list \\afs\link</p>
3028
3029 <p class=PreformattedText><span style='mso-tab-count:1'>      </span>'\\afs\link'
3030 is a symlink to 'athena.mit.edu\user\j\a\jaltman'</p>
3031
3032 <p class=PreformattedText style='margin-left:35.45pt'>&gt;symlink rm \\afs\link</p>
3033
3034 <p class=MsoNormal>The symlinks are stored in the registry at:</p>
3035
3036 <p class=PreformattedText style='margin-left:35.45pt'><a
3037 href="#_Regkey:_[HKLMSOFTWAREOpenAFSClie_1">HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks</a><!--[if supportFields]><span
3038 style='mso-element:field-begin'></span> XE &quot;Freelance Mode&quot; <![endif]--><!--[if supportFields]><span
3039 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3040 style='mso-element:field-begin'></span><span
3041 style='mso-spacerun:yes'> </span>XE &quot;Dynamic Root&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;fs.exe&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;symlink.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;root.afs&quot; <![endif]--><!--[if supportFields]><span
3051 style='mso-element:field-end'></span><![endif]--><span
3052 style='mso-spacerun:yes'> </span></p>
3053
3054 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416110"></a><a
3055 name="_Toc115417046"><span style='mso-bookmark:_Toc115416110'>3.4. Locating AFS
3056 Volume Database Servers</span></a> </h2>
3057
3058 <p class=MsoNormal>The OpenAFS for Windows client will use DNS AFSDB records to
3059 discover the location of AFS Volume Database servers when entries are not
3060 present in the client's CellServDB file
3061 (\%PROGRAMFILES%\OpenAFS\Client\CellServDB).<!--[if supportFields]><span
3062 style='mso-element:field-begin'></span> XE &quot;dns&quot; <![endif]--><!--[if supportFields]><span
3063 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3064 style='mso-element:field-begin'></span><span
3065 style='mso-spacerun:yes'> </span>XE &quot;afsdb&quot; <![endif]--><!--[if supportFields]><span
3066 style='mso-element:field-end'></span><![endif]--></p>
3067
3068 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416111"></a><a
3069 name="_Toc115417047"><span style='mso-bookmark:_Toc115416111'>3.5. Obtaining
3070 AFS Tokens as a Part of Windows Logon</span></a></h2>
3071
3072 <p class=MsoNormal>OpenAFS for Windows installs a WinLogon Network Provider to
3073 provide Single Sign-on functionality (aka Integrated Logon.)<span
3074 style='mso-spacerun:yes'>  </span>Integrated Logon can be used when the Windows
3075 username and password match the username and password associated with the
3076 default cell's Kerberos realm.<span style='mso-spacerun:yes'>  </span>For
3077 example, if the Windows username is &quot;jaltman&quot; and the default cell is
3078 &quot;athena.mit.edu&quot;, then Integrated Logon can be successfully used if
3079 the windows password matches the password assigned to the Kerberos principal
3080 &quot;<a href="mailto:jaltman@ATHENA.MIT.EDU">jaltman@ATHENA.MIT.EDU</a>&quot;.<span
3081 style='mso-spacerun:yes'>  </span>The realm ATHENA.MIT.EDU is obtained by
3082 performing a domain name to realm mapping on the hostname of one of the cell's
3083 Volume Database servers.</p>
3084
3085 <p class=MsoNormal>Integrated Logon is required if you desire the ability to
3086 store roaming user profiles within the AFS file system.<span
3087 style='mso-spacerun:yes'>  </span>OpenAFS does not provide tools for
3088 synchronizing the Windows and Kerberos user accounts and passwords.</p>
3089
3090 <p class=MsoNormal>When KFW is configured, Integrated Logon will use it to
3091 obtain tokens.<span style='mso-spacerun:yes'>  </span>The Kerberos 5 tickets
3092 obtained during the process of generating AFS tokens are preserved and stored
3093 into the default ccache within the user logon session.</p>
3094
3095 <p class=MsoNormal>Integrated Logon does not have the ability to cache the
3096 user's username and password for the purpose of obtaining tokens if the
3097 Kerberos KDC is inaccessible at logon time.</p>
3098
3099 <p class=MsoNormal>Integrated Login supports the ability to obtain tokens for
3100 multiple cells.<span style='mso-spacerun:yes'>  </span>For further information
3101 on how to configure this feature read the <a
3102 href="relnotes.htm#_Value:_TheseCells">TheseCells</a> value in <a
3103 href="#_Appendix_A:_Registry_Values">Appendix A</a>.<!--[if supportFields]><span
3104 style='mso-element:field-begin'></span> XE &quot;integrated login&quot; <![endif]--><!--[if supportFields]><span
3105 style='mso-element:field-end'></span><![endif]--></p>
3106
3107 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416112"></a><a
3108 name="_Toc115417048"><span style='mso-bookmark:_Toc115416112'>3.6. AFS System
3109 Tray Command Line Options</span></a></h2>
3110
3111 <p class=MsoNormal>The AFS System Tray tool (afscreds.exe) supports several
3112 command line options: </p>
3113
3114 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-A =
3115 autoinit </p>
3116
3117 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-E = force
3118 existing afscreds to exit</p>
3119
3120 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-I =
3121 install startup shortcut</p>
3122
3123 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-M = renew
3124 drive maps </p>
3125
3126 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-N = IP
3127 address change detection </p>
3128
3129 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-Q = quiet
3130 mode.<span style='mso-spacerun:yes'>  </span>do not display start service
3131 dialog</p>
3132
3133 <p class=PreformattedText><span style='mso-spacerun:yes'>         </span>if
3134 afsd_service is not already running</p>
3135
3136 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-S = show
3137 tokens dialog on startup</p>
3138
3139 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-U =
3140 uninstall startup shortcut</p>
3141
3142 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-X = test
3143 and do map share</p>
3144
3145 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-Z = unmap
3146 drives</p>
3147
3148 <p class=MsoNormal>autoinit will result in automated attempts to acquire AFS
3149 tokens when afscreds.exe is started.<span style='mso-spacerun:yes'>
3150 </span>afscreds.exe will attempt to utilize tickets stored in the MSLSA
3151 credentials cache; any existing CCAPI credentials cache; and finally display an
3152 Obtain Tokens dialog to the user.<span style='mso-spacerun:yes'>  </span>When
3153 used in combination with IP address change detection, afscreds.exe will attempt
3154 to acquire AFS tokens whenever the IP address list changes and the Kerberos KDC
3155 is accessible.</p>
3156
3157 <p class=MsoNormal>The renew drive maps option is used to ensure that the user
3158 drive maps constructed via the OpenAFS tools (not NET USE) are re-constructed
3159 each time afscreds.exe is started.</p>
3160
3161 <p class=MsoNormal>By default afscreds.exe is configured by the OpenAFS.org
3162 installers to use -A -N -M -Q as startup options.<span
3163 style='mso-spacerun:yes'>  </span>Currently, there is no user interface to
3164 change this selection after install time although these options may be altered
3165 via the registry on either per machine or per user basis.<span
3166 style='mso-spacerun:yes'>  </span>See <span style='mso-bidi-font-style:italic'><a
3167 href="#_Value___:_AfscredsShortcutParams">AfscredsShortcutParams</a></span> in <a
3168 href="#_Appendix_A:_Registry_Values">Appendix A</a>.<!--[if supportFields]><span
3169 style='mso-element:field-begin'></span> XE &quot;afscreds.exe&quot; <![endif]--><!--[if supportFields]><span
3170 style='mso-element:field-end'></span><![endif]--></p>
3171
3172 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416113"></a><a
3173 name="_Toc115417049"><span style='mso-bookmark:_Toc115416113'>3.7. The AFS
3174 Client Admins Authorization Group</span></a></h2>
3175
3176 <p class=MsoNormal>The OpenAFS for Windows 1.4 client supports a local Windows
3177 authorization group named &quot;AFS Client Admins&quot;.<span
3178 style='mso-spacerun:yes'>  </span>This group is used in place of the
3179 &quot;Administrators&quot; group to determine which users are allowed to modify
3180 the AFS Client Service configuration via the AFS Control Panel (afs_config.exe)
3181 or fs.exe command line tool.<span style='mso-spacerun:yes'>  </span>The
3182 following fs.exe commands are now restricted to members of the &quot;AFS Client
3183 Admins&quot; group:</p>
3184
3185 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3186 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3187 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3188 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3189 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>checkservers
3190 with a non-zero timer value</p>
3191
3192 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3193 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3194 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3195 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3196 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setcachesize</p>
3197
3198 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3199 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3200 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3201 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3202 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>newcell</p>
3203
3204 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3205 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3206 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3207 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3208 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>sysname
3209 with a new sysname list</p>
3210
3211 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3212 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3213 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3214 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3215 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>exportafs</p>
3216
3217 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3218 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3219 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3220 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3221 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setcell</p>
3222
3223 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3224 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3225 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3226 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3227 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setserverprefs</p>
3228
3229 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3230 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3231 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3232 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3233 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>storebehind</p>
3234
3235 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3236 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3237 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3238 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3239 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setcrypt</p>
3240
3241 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3242 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3243 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3244 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3245 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>cscpolicy</p>
3246
3247 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3248 mso-list:l4 level1 lfo12;tab-stops:list 14.15pt'><![if !supportLists]><span
3249 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3250 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3251 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>trace</p>
3252
3253 <p class=MsoNormal>The creation or removal of mount points and symlinks in the Freelance
3254 root.afs volume are also restricted to members of the AFS Client Admins
3255 group.</p>
3256
3257 <p class=MsoNormal>The initial membership of the &quot;AFS Client Admins&quot;
3258 group when created by the installer is equivalent to the local
3259 &quot;Administrators&quot; group.<span style='mso-spacerun:yes'>  </span>If a
3260 user is added to the &quot;Administrators&quot; group after the creation of the
3261 &quot;AFS Client Admin&quot; group, that user will not be an AFS Client
3262 Administrator.<span style='mso-spacerun:yes'>  </span>Only users that are
3263 members of the &quot;AFS Client Admins&quot; group are AFS Client
3264 Administrators.<span style='mso-spacerun:yes'>  </span>The local
3265 &quot;SYSTEM&quot; account is an implicit member of the &quot;AFS Client
3266 Admins&quot; group.</p>
3267
3268 <p class=MsoNormal>Setting the default sysname for a machine should be done via
3269 the <a href="#_Value_:_SysName">registry</a> and not via &quot;fs
3270 sysname&quot;.<!--[if supportFields]><span style='mso-element:field-begin'></span>
3271 XE &quot;AFS Client Admins&quot; <![endif]--><!--[if supportFields]><span
3272 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3273 style='mso-element:field-begin'></span><span
3274 style='mso-spacerun:yes'> </span>XE &quot;fs.exe&quot; <![endif]--><!--[if supportFields]><span
3275 style='mso-element:field-end'></span><![endif]--></p>
3276
3277 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416114"></a><a
3278 name="_Toc115417050"><span style='mso-bookmark:_Toc115416114'>3.8. OpenAFS
3279 support for UNC paths</span></a> </h2>
3280
3281 <p class=MsoNormal>The OpenAFS 1.4 client supports UNC paths everywhere.<span
3282 style='mso-spacerun:yes'>  </span>UNC paths provide a canonical name for
3283 resources stored within AFS.<span style='mso-spacerun:yes'>  </span>UNC paths
3284 should be used instead of drive letter mappings whenever possible.<span
3285 style='mso-spacerun:yes'>   </span>This is especially true when specifying the
3286 location of roaming profiles and redirected folders.<!--[if supportFields]><span
3287 style='mso-element:field-begin'></span> XE &quot;UNC paths&quot; <![endif]--><!--[if supportFields]><span
3288 style='mso-element:field-end'></span><![endif]--><span
3289 style='mso-spacerun:yes'>  </span></p>
3290
3291 <p class=MsoNormal>Power users that make extensive use of the command line
3292 shell, cmd.exe, should consider using JP Software's 4NT or Take Command command
3293 processors.<span style='mso-spacerun:yes'>  </span>Unlike cmd.exe, the
3294 JPSoftware shells fully support UNC paths as the current directory.<span
3295 style='mso-spacerun:yes'>  </span>With the release of version 4NT 7.0 and Take
3296 Command 7.0, JPSoftware is adding special recognition of OpenAFS.<span
3297 style='mso-spacerun:yes'>  </span>AFS paths can be entered in UNIX notation
3298 (e.g., <a href="file:///\\afs\openafs.org\software">/afs/openafs.org/software</a>),
3299 space utilization reports the output of the volume status for the specified
3300 path, and many AFS specific functions and variables have been added to the
3301 command language.</p>
3302
3303 <p class=MsoNormal>JPSoftware's web site is <span class=MsoHyperlink>http://www.jpsoft.com</span>.<!--[if supportFields]><span
3304 style='mso-element:field-begin'></span> XE &quot;JP Software&quot; <![endif]--><!--[if supportFields]><span
3305 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3306 style='mso-element:field-begin'></span><span
3307 style='mso-spacerun:yes'> </span>XE &quot;4nt.exe&quot; <![endif]--><!--[if supportFields]><span
3308 style='mso-element:field-end'></span><![endif]--></p>
3309
3310 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416115"></a><a
3311 name="_Toc115417051"><span style='mso-bookmark:_Toc115416115'>3.9. OpenAFS
3312 includes aklog.exe</span></a></h2>
3313
3314 <p class=MsoNormal>The OpenAFS 1.4 Client ships with its own version of
3315 aklog.exe which should be used in preference to those obtained by third party
3316 sources.<span style='mso-spacerun:yes'>  </span>The OpenAFS aklog.exe supports
3317 Kerberos 5 as well as the ability to auto-generate pts IDs for user's obtaining
3318 tokens<span style='mso-spacerun:yes'>  </span>for access to foreign cells.</p>
3319
3320 <p class=PreformattedText>Usage: aklog [-d] [[-cell | -c] cell [-k krb_realm]]</p>
3321
3322 <p class=PreformattedText><span style='mso-spacerun:yes'>
3323 </span>[[-p | -path] pathname]</p>
3324
3325 <p class=PreformattedText><span style='mso-spacerun:yes'>
3326 </span>[-noprdb] [-force]</p>
3327
3328 <p class=PreformattedText><span style='mso-spacerun:yes'>
3329 </span>[-5 [-m]| -4]</p>
3330
3331 <p class=PreformattedText><o:p>&nbsp;</o:p></p>
3332
3333 <p class=PreformattedText><span style='mso-spacerun:yes'>  </span><span
3334 style='mso-spacerun:yes'> </span>-d = output debugging information.</p>
3335
3336 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>cell = zero
3337 or more cells for which tokens will be obtained</p>
3338
3339 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>krb_realm =
3340 the kerberos realm of the cell.</p>
3341
3342 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>pathname =
3343 the directory for which authentication is required</p>
3344
3345 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>-noprdb =
3346 don't try to determine AFS ID.</p>
3347
3348 <p class=PreformattedText><span style='mso-spacerun:yes'> </span><span
3349 style='mso-spacerun:yes'>  </span>-5 or -4 = use Kerberos V (default) or
3350 Kerberos IV tickets</p>
3351
3352 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>-m = use
3353 krb524d to convert Kerberos V tickets to Kerberos IV<!--[if supportFields]><span
3354 style='mso-element:field-begin'></span> XE &quot;aklog.exe&quot; <![endif]--><!--[if supportFields]><span
3355 style='mso-element:field-end'></span><![endif]--></p>
3356
3357 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416116"></a><a
3358 name="_Toc115417052"><span style='mso-bookmark:_Toc115416116'>3.10. OpenAFS
3359 Servers on Windows are Unsupported</span></a></h2>
3360
3361 <p class=MsoNormal>The AFS Server functionality provided with OpenAFS 1.4 might
3362 work but should be considered highly experimental.<span
3363 style='mso-spacerun:yes'>  </span>It has not been thoroughly tested.<span
3364 style='mso-spacerun:yes'>  </span>Any data which would cause pain if lost
3365 should not be stored in an OpenAFS Server on Windows.</p>
3366
3367 <p class=MsoNormal>A few notes on the usage of the AFS Client Service if it is
3368 going to be used with the OpenAFS AFS Server:</p>
3369
3370 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3371 l5 level1 lfo14;tab-stops:list 14.15pt'><![if !supportLists]><span
3372 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3373 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3374 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>When
3375 installed on the same machine as the AFS Server, Freelance mode must be turned
3376 off.<span style='mso-spacerun:yes'>  </span>Otherwise, you will be unable to
3377 manipulate the contents of the root.afs volume for the hosted cell.</p>
3378
3379 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3380 l5 level1 lfo14;tab-stops:list 14.15pt'><![if !supportLists]><span
3381 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3382 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3383 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>The
3384 AFS Server and related tools only support the built in kaserver (Kerberos
3385 IV).<span style='mso-spacerun:yes'>  </span>If the AFS Server is being used,
3386 MIT Kerberos for Windows should not be installed or must be disabled.<!--[if supportFields]><span
3387 style='mso-element:field-begin'></span> XE &quot;AFS Servers&quot; <![endif]--><!--[if supportFields]><span
3388 style='mso-element:field-end'></span><![endif]--></p>
3389
3390 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416117"></a><a
3391 name="_Toc115417053"><span style='mso-bookmark:_Toc115416117'>3.11. OpenAFS
3392 Debugging Symbol files</span></a></h2>
3393
3394 <p class=MsoNormal>The OpenAFS for Windows installers now include Debugging
3395 Symbol files which should be installed if you are experiencing problems and
3396 need to send crash reports.<span style='mso-spacerun:yes'>  </span>This is true
3397 for both the release and the debug versions of the installers.<span
3398 style='mso-spacerun:yes'>  </span>The difference between the release and debug
3399 versions are:</p>
3400
3401 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3402 l6 level1 lfo16;tab-stops:list 14.15pt'><![if !supportLists]><span
3403 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3404 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3405 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>whether
3406 or not the binaries were compiled with optimization</p>
3407
3408 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3409 l6 level1 lfo16;tab-stops:list 14.15pt'><![if !supportLists]><span
3410 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3411 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3412 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>whether
3413 the debug symbols are installed by default</p>
3414
3415 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3416 l6 level1 lfo16;tab-stops:list 14.15pt'><![if !supportLists]><span
3417 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3418 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3419 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>whether
3420 additional debug statements were compiled into the binaries<!--[if supportFields]><span
3421 style='mso-element:field-begin'></span> XE &quot;Symbol files&quot; <![endif]--><!--[if supportFields]><span
3422 style='mso-element:field-end'></span><![endif]--></p>
3423
3424 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416118"></a><a
3425 name="_Toc115417054"><span style='mso-bookmark:_Toc115416118'>3.12. Maximum
3426 File Size is 2GB</span></a></h2>
3427
3428 <p class=MsoNormal>OpenAFS for Windows does not support files larger than
3429 2GB.<span style='mso-spacerun:yes'>  </span>The version of the SMB/CIFS
3430 protocol implemented imposes this limitation.<span style='mso-spacerun:yes'>
3431 </span>Upgrading the SMB/CIFS implementation or replacing it with an
3432 Installable File System will allow larger files to be supported.<!--[if supportFields]><span
3433 style='mso-element:field-begin'></span> XE &quot;large file support&quot; <![endif]--><!--[if supportFields]><span
3434 style='mso-element:field-end'></span><![endif]--></p>
3435
3436 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416119"></a><a
3437 name="_Toc115417055"><span style='mso-bookmark:_Toc115416119'>3.13. Encrypted
3438 AFS File Access</span></a></h2>
3439
3440 <p class=MsoNormal>The OpenAFS for Windows installer by default activates a
3441 weak form of encrypted data transfer between the AFS client and the AFS
3442 servers.<span style='mso-spacerun:yes'>  </span>This is often referred to as
3443 &quot;fcrypt&quot; mode.</p>
3444
3445 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416120"></a><a
3446 name="_Toc115417056"><span style='mso-bookmark:_Toc115416120'>3.14. Authenticated
3447 Access to the OpenAFS Client Service</span></a></h2>
3448
3449 <p class=MsoNormal>OpenAFS 1.4 supports authenticated SMB connections using
3450 either NTLM or GSS SPNEGO (NTLM).<span style='mso-spacerun:yes'>  </span>In
3451 previous versions of OpenAFS, the SMB connections were unauthenticated which
3452 opened the door for several attacks which could be used to obtain access to
3453 another user's tokens on shared machines.<span style='mso-spacerun:yes'>
3454 </span></p>
3455
3456 <p class=MsoNormal>When GSS SPNEGO attempts a Kerberos 5 authentication, the
3457 Windows SMB client will attempt to retrieve service tickets for
3458 &quot;cifs/afs@REALM&quot; (if the loopback adapter is in use) or
3459 &quot;cifs/machine-afs@REALM&quot; (if the loopback adapter is not being
3460 used).<span style='mso-spacerun:yes'>  </span>It is extremely important that
3461 this service principal not exist in the KDC database as the Kerberos
3462 authentication must fail allowing automatic fallback to NTLM.<span
3463 style='mso-spacerun:yes'>  </span>When NTLM is used a special local
3464 authentication mode will be used that does not require access to the user's
3465 password.<span style='mso-spacerun:yes'>  </span>Instead, Windows will
3466 internally recognize the request as coming from a local logon session.</p>
3467
3468 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416121"></a><a
3469 name="_Toc115417057"><span style='mso-bookmark:_Toc115416121'>3.15. No More INI
3470 Files</span></a></h2>
3471
3472 <p class=MsoNormal>Previous AFS clients for Windows stored configuration data
3473 in Windows .INI files.<span style='mso-spacerun:yes'>   </span>OpenAFS 1.4 does
3474 not use Windows .INI files for the storage of configuration data.<span
3475 style='mso-spacerun:yes'>   </span>All settings are now stored in the registry
3476 (see <a href="#_Appendix_A:_Registry_Values">Appendix A</a>).<span
3477 style='mso-spacerun:yes'>  </span>The CellServDB file is now stored in the
3478 %PROGRAMFILES%\OpenAFS\Client directory.<span style='mso-spacerun:yes'>
3479 </span>The <i style='mso-bidi-font-style:normal'><a
3480 href="#_Value___:_CellServDBDir">CellServDBDir</a></i> registry value can be
3481 used to specify an alternative location.</p>
3482
3483 <p class=MsoNormal>OpenAFS 1.4 will relocate the contents of the afsdcell.ini
3484 file to the new CellServDB file.<span style='mso-spacerun:yes'>  </span>OpenAFS
3485 1.4 will also import the contents of the afs_freelance.ini file to the
3486 Windows registry.<span style='mso-spacerun:yes'>   </span>OpenAFS 1.4 will not
3487 process the contents of the afsddbmt.ini.</p>
3488
3489 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416122"></a><a
3490 name="_Toc115417058"><span style='mso-bookmark:_Toc115416122'>3.16. Microsoft
3491 Windows Internet Connection Firewall</span></a></h2>
3492
3493 <p class=MsoNormal>The OpenAFS 1.4 Client is compatible with the Internet
3494 Connection Firewall that debuted with Windows XP SP2 and Windows 2003 SP1.<span
3495 style='mso-spacerun:yes'>  </span>The Internet Connection Firewall will be
3496 automatically adjusted to allow the receipt of incoming callback messages from
3497 the AFS file server.<span style='mso-spacerun:yes'>  </span>In addition, the
3498 appropriate <i>Back Connection</i> registry entries are added to allow SMB
3499 authentication to be performed across the Microsoft Loopback Adapter.</p>
3500
3501 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416123"></a><a
3502 name="_Toc115417059"><span style='mso-bookmark:_Toc115416123'>3.17. Browsing
3503 AFS from the Explorer Shell and Office</span></a></h2>
3504
3505 <p class=MsoNormal>The OpenAFS 1.4 Client Service implements the CIFS Remote
3506 Admin Protocol which allows Explorer to browse server and share information.
3507 This significantly enhances the interoperability of AFS volumes within the
3508 Explorer Shell and Microsoft Office applications.</p>
3509
3510 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417060"></a><a
3511 name="_Toc115416124"><span style='mso-bookmark:_Toc115417060'>3.18. No Support
3512 for </span></a><st2:place w:st="on"><st2:PlaceName w:st="on"><span
3513   style='mso-bookmark:_Toc115417060'><span style='mso-bookmark:_Toc115416124'>Byte</span></span></st2:PlaceName><span
3514  style='mso-bookmark:_Toc115417060'><span style='mso-bookmark:_Toc115416124'> <st2:PlaceType
3515  w:st="on">Range</st2:PlaceType></span></span></st2:place><span
3516 style='mso-bookmark:_Toc115417060'><span style='mso-bookmark:_Toc115416124'>
3517 Locking</span></span></h2>
3518
3519 <p class=MsoBodyText>Many applications on Windows (e.g. Microsoft Office)
3520 require the use of byte range locks applied to a file either to protect against
3521 simultaneous file access or as a signaling mechanism.<span
3522 style='mso-spacerun:yes'>   </span>OpenAFS does not currently support byte range
3523 locks.<span style='mso-spacerun:yes'>   </span>It is strongly recommended that
3524 files not be edited within AFS if they might be accessed by multiple users or
3525 multiple processes on a single machine.</p>
3526
3527 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416125"></a><a
3528 name="_Toc115417061"><span style='mso-bookmark:_Toc115416125'>3.19. Automatic
3529 Discarding of AFS Tokens at Logoff</span></a></h2>
3530
3531 <p class=MsoNormal>OpenAFS 1.4 will automatically forget a user's tokens upon
3532 Logoff unless the user's profile was loaded from an AFS volume.<span
3533 style='mso-spacerun:yes'>  </span>In this situation there is no mechanism to
3534 determine when the profile has been successfully written back to the network.<span
3535 style='mso-spacerun:yes'>  </span>It is therefore unsafe to release the user's
3536 tokens.<span style='mso-spacerun:yes'>  </span>Whether or not the profile has
3537 been loaded from the registry can be determined for Local Accounts, Active
3538 Directory accounts and NT4 accounts.</p>
3539
3540 <p class=MsoNormal>If there is a need to disable this functionality, the <span
3541 style='mso-bidi-font-style:italic'><a href="#_Value_:_LogoffPreserveTokens">LogoffPreserveTokens</a></span>
3542 registry value can be used. (see <a href="#_Appendix_A:_Registry_Values">Appendix
3543 A</a>.)</p>
3544
3545 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416126"></a><a
3546 name="_Toc115417062"><span style='mso-bookmark:_Toc115416126'>3.20. Terminal
3547 Server installations</span></a></h2>
3548
3549 <p class=MsoNormal>When installing the NSIS (.exe) installer under Terminal
3550 Server, you must execute it from within the Add/Remove Programs Control
3551 Panel.<span style='mso-spacerun:yes'>  </span>Failure to do so will result in
3552 AFS not running properly.<span style='mso-spacerun:yes'>  </span>The AFS Server
3553 should not be installed on a machine with Terminal Server installed.</p>
3554
3555 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416127"></a><a
3556 name="_Toc115417063"><span style='mso-bookmark:_Toc115416127'>3.21. Hidden Dot
3557 Files</span></a></h2>
3558
3559 <p class=MsoNormal>AFS is a UNIX native file system.<span
3560 style='mso-spacerun:yes'>  </span>The OpenAFS client attempts to treat the
3561 files stored in AFS as they would be on UNIX.<span style='mso-spacerun:yes'>
3562 </span>File and directory names beginning with a &quot;.&quot; are
3563 automatically given the Hidden attribute so they will not normally be
3564 displayed.</p>
3565
3566 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416128"></a><a
3567 name="_Toc115417064"><span style='mso-bookmark:_Toc115416128'>3.22. Status
3568 Cache Limits</span></a></h2>
3569
3570 <p class=MsoNormal>The Status Cache (AFS Configuration Control Panel: Advanced
3571 Page) is defined to have a maximum number of entries.<span
3572 style='mso-spacerun:yes'>  </span>Each entry represents a single file or
3573 directory entry accessed within the AFS file system.<span
3574 style='mso-spacerun:yes'>  </span>When the maximum number of entries are
3575 allocated, entries will begin to be reused according to a least recently used
3576 (LRU) algorithm.<span style='mso-spacerun:yes'>  </span>If the number of files
3577 or directories being accessed repeatedly by your applications is greater then
3578 the maximum number of entries, your host will begin to experience thrashing of the
3579 Status Cache and all requests will result in network operations.</p>
3580
3581 <p class=MsoNormal>If you are experiencing poor performance try increasing the
3582 maximum number of Status Cache entries.<span style='mso-spacerun:yes'>
3583 </span>Each entry requires approximately 1.2K.<span style='mso-spacerun:yes'>
3584 </span>In OpenAFS 1.4, the default number of Status Cache entries is 10,000.</p>
3585
3586 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416129"></a><a
3587 name="_Toc115417065"><span style='mso-bookmark:_Toc115416129'>3.23. NETBIOS
3588 over TCP/IP must be enabled</span></a></h2>
3589
3590 <p class=MsoNormal>&quot;Netbios over TCP/IP&quot; must be active on the
3591 machine in order for communication with the AFS Client Service to succeed.<span
3592 style='mso-spacerun:yes'>  </span>If &quot;Netbios over TCP/IP&quot; is
3593 disabled on the machine, then communication with the AFS Client Service will be
3594 impossible.</p>
3595
3596 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416130"></a><a
3597 name="_Toc115417066"><span style='mso-bookmark:_Toc115416130'>3.24. OpenAFS
3598 binaries are digitally signed</span></a></h2>
3599
3600 <p class=MsoNormal>The OpenAFS Client Service and related binaries distributed
3601 by OpenAFS.org are digitally signed by &quot;Secure Endpoints Inc.&quot;.<span
3602 style='mso-spacerun:yes'>  </span>The OpenAFS Client Service will perform a
3603 run-time verification check to ensure that all OpenAFS related DLLs loaded by
3604 the service match the same file version number and were signed by the same
3605 entity.<span style='mso-spacerun:yes'>  </span>This check has been added to
3606 prevent the stability problems caused by more than one AFS installation present
3607 on a machine at the same time.<span style='mso-spacerun:yes'>  </span>Many
3608 hours of support time have been wasted tracking down problems caused by the
3609 mixture of files from different releases.<span style='mso-spacerun:yes'>
3610 </span></p>
3611
3612 <p class=MsoNormal><a href="#_Appendix_A:_Registry_Values">Appendix A</a>
3613 documents the &quot;<a href="#_Value___:_VerifyServiceSignature">VerifyServiceSignature</a>&quot;
3614 registry value which can be used to disable the signature check.<span
3615 style='mso-spacerun:yes'>  </span>The file version check cannot be disabled.</p>
3616
3617 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416131"></a><a
3618 name="_Toc115417067"><span style='mso-bookmark:_Toc115416131'>3.25. Maximum
3619 Size of the AFSCache File</span></a></h2>
3620
3621 <p class=MsoNormal>The maximum cache size is approximately 1.3GB.<span
3622 style='mso-spacerun:yes'>  </span>This is the largest contiguous block of
3623 memory in the 2GB process address space which can be used for constructing a
3624 memory mapped file.<span style='mso-spacerun:yes'>  </span>Due to fragmentation
3625 of the process space caused by the loading of libraries required by the digital
3626 signature verification code, any attempt to specify a cache size greater then
3627 700MB will result in the automatic disabling of the signature check.</p>
3628
3629 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416132"></a><a
3630 name="_Toc115417068"><span style='mso-bookmark:_Toc115416132'>3.26. Filename
3631 Character Sets</span></a></h2>
3632
3633 <p class=MsoNormal>OpenAFS for Windows implements an SMB server which is used
3634 as a gateway to the AFS filesystem.<span style='mso-spacerun:yes'>
3635 </span>Because of limitations of the SMB implementation, Windows stores all
3636 files into AFS using OEM code pages such as CP437 (United States) or CP850
3637 (Western Europe).<span style='mso-spacerun:yes'>  </span>These code pages are
3638 incompatible with the ISO Latin-1 character set typically used as the default
3639 on UNIX systems in both the <st2:country-region w:st="on">United States</st2:country-region>
3640 and <st2:place w:st="on">Western Europe</st2:place>.<span
3641 style='mso-spacerun:yes'>  </span>Filenames stored by OpenAFS for Windows are
3642 therefore unreadable on UNIX systems if they include any of the following
3643 characters:</p>
3644
3645 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
3646  style='border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;
3647  mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;mso-border-insideh:
3648  .5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
3649  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
3650   height:399.5pt'>
3651   <td width=590 valign=top style='width:442.8pt;border:solid windowtext 1.0pt;
3652   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt;height:399.5pt'>
3653   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[Ç]<span
3654   style='mso-spacerun:yes'>  </span>128<span style='mso-spacerun:yes'>
3655   </span>08/00<span style='mso-spacerun:yes'>  </span>200<span
3656   style='mso-spacerun:yes'>  </span>80<span style='mso-spacerun:yes'>  </span>C
3657   cedilla</p>
3658   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ü]<span
3659   style='mso-spacerun:yes'>  </span>129<span style='mso-spacerun:yes'>
3660   </span>08/01<span style='mso-spacerun:yes'>  </span>201<span
3661   style='mso-spacerun:yes'>  </span>81<span style='mso-spacerun:yes'>  </span>u
3662   diaeresis</p>
3663   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[é]<span
3664   style='mso-spacerun:yes'>  </span>130<span style='mso-spacerun:yes'>
3665   </span>08/02<span style='mso-spacerun:yes'>  </span>202<span
3666   style='mso-spacerun:yes'>  </span>82<span style='mso-spacerun:yes'>  </span>e
3667   acute</p>
3668   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[â]<span
3669   style='mso-spacerun:yes'>  </span>131<span style='mso-spacerun:yes'>
3670   </span>08/03<span style='mso-spacerun:yes'>  </span>203<span
3671   style='mso-spacerun:yes'>  </span>83<span style='mso-spacerun:yes'>  </span>a
3672   circumflex</p>
3673   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ä]<span
3674   style='mso-spacerun:yes'>  </span>132<span style='mso-spacerun:yes'>
3675   </span>08/04<span style='mso-spacerun:yes'>  </span>204<span
3676   style='mso-spacerun:yes'>  </span>84<span style='mso-spacerun:yes'>  </span>a
3677   diaeresis</p>
3678   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[à]<span
3679   style='mso-spacerun:yes'>  </span>133<span style='mso-spacerun:yes'>
3680   </span>08/05<span style='mso-spacerun:yes'>  </span>205<span
3681   style='mso-spacerun:yes'>  </span>85<span style='mso-spacerun:yes'>  </span>a
3682   grave</p>
3683   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[å]<span
3684   style='mso-spacerun:yes'>  </span>134<span style='mso-spacerun:yes'>
3685   </span>08/06<span style='mso-spacerun:yes'>  </span>206<span
3686   style='mso-spacerun:yes'>  </span>86<span style='mso-spacerun:yes'>  </span>a
3687   ring</p>
3688   <p class=PreformattedText><span style='mso-spacerun:yes'>   </span><span
3689   style='mso-spacerun:yes'>  </span>[ç]<span style='mso-spacerun:yes'>
3690   </span>135<span style='mso-spacerun:yes'>  </span>08/07<span
3691   style='mso-spacerun:yes'>  </span>207<span style='mso-spacerun:yes'>
3692   </span>87<span style='mso-spacerun:yes'>  </span>c cedilla</p>
3693   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ê]<span
3694   style='mso-spacerun:yes'>  </span>136<span style='mso-spacerun:yes'>
3695   </span>08/08<span style='mso-spacerun:yes'>  </span>210<span
3696   style='mso-spacerun:yes'>  </span>88<span style='mso-spacerun:yes'>  </span>e
3697   circumflex</p>
3698   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ë]<span
3699   style='mso-spacerun:yes'>  </span>137<span style='mso-spacerun:yes'>
3700   </span>08/09<span style='mso-spacerun:yes'>  </span>211<span
3701   style='mso-spacerun:yes'>  </span>89<span style='mso-spacerun:yes'>  </span>e
3702   diaeresis</p>
3703   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[è]<span
3704   style='mso-spacerun:yes'>  </span>138<span style='mso-spacerun:yes'>
3705   </span>08/10<span style='mso-spacerun:yes'>  </span>212<span
3706   style='mso-spacerun:yes'>  </span>8A<span style='mso-spacerun:yes'>  </span>e
3707   grave</p>
3708   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ï]<span
3709   style='mso-spacerun:yes'>  </span>139<span style='mso-spacerun:yes'>
3710   </span>08/11<span style='mso-spacerun:yes'>  </span>213<span
3711   style='mso-spacerun:yes'>  </span>8B<span style='mso-spacerun:yes'>  </span>i
3712   diaeresis</p>
3713   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[î]<span
3714   style='mso-spacerun:yes'>  </span>140<span style='mso-spacerun:yes'>
3715   </span>08/12<span style='mso-spacerun:yes'>  </span>214<span
3716   style='mso-spacerun:yes'>  </span>8C<span style='mso-spacerun:yes'>  </span>i
3717   circumflex</p>
3718   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ì]<span
3719   style='mso-spacerun:yes'>  </span>141<span style='mso-spacerun:yes'>
3720   </span>08/13<span style='mso-spacerun:yes'>  </span>215<span
3721   style='mso-spacerun:yes'>  </span>8D<span style='mso-spacerun:yes'>  </span>i
3722   grave</p>
3723   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[Ä]<span
3724   style='mso-spacerun:yes'>  </span>142<span style='mso-spacerun:yes'>
3725   </span>08/14<span style='mso-spacerun:yes'>  </span>216<span
3726   style='mso-spacerun:yes'>  </span>8E<span style='mso-spacerun:yes'>  </span>A
3727   diaeresis</p>
3728   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[Å]<span
3729   style='mso-spacerun:yes'>  </span>143<span style='mso-spacerun:yes'>
3730   </span>08/15<span style='mso-spacerun:yes'>  </span>217<span
3731   style='mso-spacerun:yes'>  </span>8F<span style='mso-spacerun:yes'>  </span>A
3732   ring</p>
3733   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[É]<span
3734   style='mso-spacerun:yes'>  </span>144<span style='mso-spacerun:yes'>
3735   </span>09/00<span style='mso-spacerun:yes'>  </span>220<span
3736   style='mso-spacerun:yes'>  </span>90<span style='mso-spacerun:yes'>  </span>E
3737   acute</p>
3738   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[æ]<span
3739   style='mso-spacerun:yes'>  </span>145<span style='mso-spacerun:yes'>
3740   </span>09/01<span style='mso-spacerun:yes'>  </span>221<span
3741   style='mso-spacerun:yes'>  </span>91<span style='mso-spacerun:yes'>
3742   </span>ae diphthong</p>
3743   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[Æ]<span
3744   style='mso-spacerun:yes'>  </span>146<span style='mso-spacerun:yes'>
3745   </span>09/02<span style='mso-spacerun:yes'>  </span>222<span
3746   style='mso-spacerun:yes'>  </span>92<span style='mso-spacerun:yes'>
3747   </span>AE diphthong</p>
3748   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ô]<span
3749   style='mso-spacerun:yes'>  </span>147 <span
3750   style='mso-spacerun:yes'> </span>09/03<span style='mso-spacerun:yes'>
3751   </span>223<span style='mso-spacerun:yes'>  </span>93<span
3752   style='mso-spacerun:yes'>  </span>o circumflex</p>
3753   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ö]<span
3754   style='mso-spacerun:yes'>  </span>148<span style='mso-spacerun:yes'>
3755   </span>09/04<span style='mso-spacerun:yes'>  </span>224<span
3756   style='mso-spacerun:yes'>  </span>94<span style='mso-spacerun:yes'>  </span>o
3757   diaeresis</p>
3758   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ò]<span
3759   style='mso-spacerun:yes'>  </span>149<span style='mso-spacerun:yes'>
3760   </span>09/05<span style='mso-spacerun:yes'>  </span>225<span
3761   style='mso-spacerun:yes'>  </span>95<span style='mso-spacerun:yes'>  </span>o
3762   grave</p>
3763   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[û]<span
3764   style='mso-spacerun:yes'>  </span>150<span style='mso-spacerun:yes'>
3765   </span>09/06<span style='mso-spacerun:yes'>  </span>226<span
3766   style='mso-spacerun:yes'>  </span>96<span style='mso-spacerun:yes'>  </span>u
3767   circumflex</p>
3768   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ù]<span
3769   style='mso-spacerun:yes'>  </span>151<span style='mso-spacerun:yes'>
3770   </span>09/07<span style='mso-spacerun:yes'>  </span>227<span
3771   style='mso-spacerun:yes'>  </span>97<span style='mso-spacerun:yes'>  </span>u
3772   grave</p>
3773   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ÿ]<span
3774   style='mso-spacerun:yes'>  </span>152<span style='mso-spacerun:yes'>
3775   </span>09/08<span style='mso-spacerun:yes'>  </span>230<span
3776   style='mso-spacerun:yes'>  </span>98<span style='mso-spacerun:yes'>  </span>y
3777   diaeresis</p>
3778   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[Ö]<span
3779   style='mso-spacerun:yes'>  </span>153<span style='mso-spacerun:yes'>
3780   </span>09/09<span style='mso-spacerun:yes'>  </span>231<span
3781   style='mso-spacerun:yes'>  </span>99<span style='mso-spacerun:yes'>  </span>O
3782   diaeresis</p>
3783   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[Ü]<span
3784   style='mso-spacerun:yes'>  </span>154<span style='mso-spacerun:yes'>
3785   </span>09/10<span style='mso-spacerun:yes'>  </span>232<span
3786   style='mso-spacerun:yes'>  </span>9A<span style='mso-spacerun:yes'>  </span>U
3787   diaeresis</p>
3788   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[ø]<span
3789   style='mso-spacerun:yes'>  </span>155<span style='mso-spacerun:yes'>
3790   </span>09/11<span style='mso-spacerun:yes'>  </span>233<span
3791   style='mso-spacerun:yes'>  </span>9B<span style='mso-spacerun:yes'>  </span>o
3792   slash</p>
3793   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[£]<span
3794   style='mso-spacerun:yes'>  </span>156<span style='mso-spacerun:yes'>
3795   </span>09/12<span style='mso-spacerun:yes'>  </span>234<span
3796   style='mso-spacerun:yes'>  </span>9C<span style='mso-spacerun:yes'>
3797   </span>Pound sterling sign</p>
3798   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[Ø]<span
3799   style='mso-spacerun:yes'>  </span>157<span style='mso-spacerun:yes'>
3800   </span>09/13<span style='mso-spacerun:yes'>  </span>235<span
3801   style='mso-spacerun:yes'>  </span>9D<span style='mso-spacerun:yes'>  </span>O
3802   slash</p>
3803   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[×]<span
3804   style='mso-spacerun:yes'>  </span>158<span style='mso-spacerun:yes'>
3805   </span>09/14<span style='mso-spacerun:yes'>  </span>236<span
3806   style='mso-spacerun:yes'>  </span>9E<span style='mso-spacerun:yes'>
3807   </span>Multiplication sign</p>
3808   <p class=PreformattedText><span style='mso-spacerun:yes'>     </span>[]<span
3809   style='mso-spacerun:yes'>  </span>159<span style='mso-spacerun:yes'>
3810   </span>09/15<span style='mso-spacerun:yes'>  </span>237<span
3811   style='mso-spacerun:yes'>  </span>9F<span style='mso-spacerun:yes'>  </span><st2:place
3812   w:st="on">Florin</st2:place> sign</p>
3813   </td>
3814  </tr>
3815 </table>
3816
3817 <p class=PreformattedText><o:p>&nbsp;</o:p></p>
3818
3819 <p class=MsoNormal>OpenAFS 1.4 provides an optional registry value, <i><a
3820 href="#_Value___:_StoreAnsiFilenames">StoreAnsiFilenames</a></i>, that can be
3821 set to instruct OpenAFS to store filenames using the ANSI Code Page instead of
3822 the OEM Code Page.<span style='mso-spacerun:yes'>  </span>The ANSI Code Page is
3823 a compatible superset of Latin-1.<span style='mso-spacerun:yes'>  </span>This
3824 setting is not the default setting because making this change would prevent
3825 OpenAFS for Windows from being able to access filenames containing the above
3826 characters which were created without this setting.</p>
3827
3828 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416133"></a><a
3829 name="_Toc115417069"><span style='mso-bookmark:_Toc115416133'>3.27. Known
3830 Character Set Issues with Roaming Profiles</span></a></h2>
3831
3832 <p class=MsoNormal>There is a known issue with storing Windows Roaming Profiles
3833 when the profile contains either directories or files with names which cannot
3834 be represented in the local OEM character set.<span style='mso-spacerun:yes'>
3835 </span>In this case, attempts to write the profile back to AFS will fail.<span
3836 style='mso-spacerun:yes'>  </span>OpenAFS for Windows does not currently
3837 support UNICODE.<span style='mso-spacerun:yes'>  </span>To avoid this problem
3838 some sites run logoff scripts (assigned by group policy) which rename all files
3839 to use only the supported characters for the locale.</p>
3840
3841 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416134"></a><a
3842 name="_Toc115417070"><span style='mso-bookmark:_Toc115416134'>3.28. The
3843 AFSCache File</span></a></h2>
3844
3845 <p class=MsoNormal>The AFS Cache file is stored by default at %TEMP%\AFSCache
3846 in a persistent file marked with the Hidden and System attributes.<span
3847 style='mso-spacerun:yes'>  </span>The persistent nature of the data stored in
3848 the cache file improves the performance of OpenAFS by reducing the number of
3849 times data must be read from the AFS file servers.<span
3850 style='mso-spacerun:yes'>  </span></p>
3851
3852 <p class=MsoNormal>The performance of the AFS Client Service is significantly
3853 affected by the access times associated with the AFSCache paging file.<span
3854 style='mso-spacerun:yes'>   </span>When given the choice, the AFSCache file
3855 should be placed on a fast disk, preferably NTFS, the file should not be
3856 compressed and should consist of as few fragments as possible.<span
3857 style='mso-spacerun:yes'>   </span>Significant performance gains can be
3858 achieved by defragmenting the AFSCache file with Sysinternal's Contig utility.</p>
3859
3860 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416135"></a><a
3861 name="_Toc115417071"><span style='mso-bookmark:_Toc115416135'>3.29. Restricting
3862 OpenAFS Client Service Start and Stop</span></a></h2>
3863
3864 <p class=MsoNormal>A new command line tool, afsdacl.exe, can be used to
3865 restrict the ability to start and stop the OpenAFS Client Service.</p>
3866
3867 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>afsdacl :
3868 Set or reset the DACL to allow starting or stopping</p>
3869
3870 <p class=PreformattedText><span style='mso-spacerun:yes'>         </span>the
3871 afsd service by any ordinary user.</p>
3872
3873 <p class=PreformattedText><o:p>&nbsp;</o:p></p>
3874
3875 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>Usage :
3876 afsdacl [-set | -reset] [-show]</p>
3877
3878 <p class=PreformattedText><span style='mso-spacerun:yes'>
3879 </span>-set<span style='mso-spacerun:yes'>   </span>: Sets the DACL</p>
3880
3881 <p class=PreformattedText><span style='mso-spacerun:yes'>
3882 </span>-reset : Reset the DACL</p>
3883
3884 <p class=PreformattedText><span style='mso-spacerun:yes'>
3885 </span>-show<span style='mso-spacerun:yes'>  </span>: Show current DACL (SDSF)</p>
3886
3887 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416136"></a><a
3888 name="_Toc115417072"><span style='mso-bookmark:_Toc115416136'>3.30. The @sys
3889 Name List</span></a></h2>
3890
3891 <p class=MsoNormal>The default @sys name list in OpenAFS 1.4 is set to
3892 &quot;x86_win32 i386_w2k i386_nt40&quot; for 32-bit x86 systems.<span
3893 style='mso-spacerun:yes'>  </span>The default for itanium will be
3894 &quot;ia64_win64&quot; and &quot;amd64_win64&quot; for amd 64-bit processors
3895 when those platforms are supported.</p>
3896
3897 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416137"></a><a
3898 name="_Toc115417073"><span style='mso-bookmark:_Toc115416137'>3.31. Symlinks to
3899 AFS UNC paths</span></a></h2>
3900
3901 <p class=MsoNormal>In OpenAFS 1.4, symlinks to AFS UNC paths, \\AFS[\all]\...,
3902 are treated the same as symlinks to /afs/...<span style='mso-spacerun:yes'>
3903 </span>However, please use /afs/... as the Windows UNC form will not work on
3904 UNIX.</p>
3905
3906 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416138"></a><a
3907 name="_Toc115417074"><span style='mso-bookmark:_Toc115416138'>3.32. Cache
3908 Manager Debugging Now Supported</span></a></h2>
3909
3910 <p class=MsoNormal>OpenAFS for Windows 1.4 implements the Cache Manager
3911 Debugging RPC Interface.<span style='mso-spacerun:yes'>  </span>The CM debugger
3912 can be queried with cmdebug.exe.</p>
3913
3914 <p class=PreformattedText>Usage: cmdebug -servers &lt;server machine&gt; [-port
3915 &lt;IP port&gt;] [-long]</p>
3916
3917 <p class=PreformattedText><span style='mso-spacerun:yes'>
3918 </span>[-addrs] [-cache] [-help]</p>
3919
3920 <p class=PreformattedText>Where: -long<span style='mso-spacerun:yes'>
3921 </span>print all info</p>
3922
3923 <p class=PreformattedText><span style='mso-spacerun:yes'>       </span>-addrs<span
3924 style='mso-spacerun:yes'>  </span>print only host interfaces</p>
3925
3926 <p class=PreformattedText><span style='mso-spacerun:yes'>
3927 </span>-cache<span style='mso-spacerun:yes'>  </span>print only cache
3928 configuration</p>
3929
3930 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416139"></a><a
3931 name="_Toc115417075"><span style='mso-bookmark:_Toc115416139'>3.33. Windows
3932 Logon Caching vs. Kerberos Logons</span></a></h2>
3933
3934 <p class=MsoNormal>If you are a site which utilizes MIT/Heimdal Kerberos
3935 principals to logon to Windows via a cross-realm relationship with a multi-domain
3936 Windows forest, you must enable Windows logon caching unless the workstation is
3937 Windows Vista Beta 1 or later.</p>
3938
3939 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416140"></a><a
3940 name="_Toc115417076"><span style='mso-bookmark:_Toc115416140'>3.34. Initial
3941 Server Preferences</span></a></h2>
3942
3943 <p class=MsoNormal>VLDB and File Server Preferences can now be provided initial
3944 values using registry keys.<span style='mso-spacerun:yes'>  </span>This is
3945 useful for managed machines in a Windows domain which are centrally located
3946 (e.g., in a computing lab.)<span style='mso-spacerun:yes'>  </span>See <a
3947 href="#_Appendix_A:_Registry_Values">Appendix A</a> for details on the &quot;<a
3948 href="#_Regkey:_[HKLMSOFTWAREOpenAFSClie_2">Server Preferences</a>&quot; keys.</p>
3949
3950 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416141"></a><a
3951 name="_Toc115417077"><span style='mso-bookmark:_Toc115416141'>3.35. File
3952 Timestamps</span></a></h2>
3953
3954 <p class=MsoNormal>OpenAFS 1.4 reports timestamps on files stored in AFS in UTC
3955 all year round.<span style='mso-spacerun:yes'>  </span>In locales with daylight
3956 savings time, previous versions of AFS for Windows reported the time when DST
3957 is active as UTC+1.<span style='mso-spacerun:yes'>  </span>This was done to
3958 preserve the relative local time for the user.<span style='mso-spacerun:yes'>
3959 </span>A file stored at 11:00am EST in January would be reported as having been
3960 stored at 11:00am EDT in June.<span style='mso-spacerun:yes'>
3961 </span>Unfortunately, this has the negative side effect of changing the
3962 reported timestamp from 16:00UTC to 15:00UTC.<span style='mso-spacerun:yes'>
3963 </span>Since Windows treats all file times in UTC, data synchronization
3964 applications which rely on the timestamp would believe that all files stored in
3965 AFS had changed.</p>
3966
3967 <p class=MsoNormal>It should be noted that UNIX based operating systems (such
3968 as Solaris) do not appear to report file times to applications in UTC.<span
3969 style='mso-spacerun:yes'>  </span>They do preserve the relative local
3970 time.<span style='mso-spacerun:yes'>  </span>This may confuse some users who
3971 are used to being able to compare the timestamp in an UNIX shell with the
3972 timestamp from the Windows explorer.<span style='mso-spacerun:yes'>
3973 </span>During DST, these two times will no longer agree even though they are in
3974 fact representing the same moment in time.</p>
3975
3976 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416142"></a><a
3977 name="_Toc115417078"><span style='mso-bookmark:_Toc115416142'>3.36. Windows RPC
3978 client support must be installed</span></a> </h2>
3979
3980 <p class=MsoNormal>If the installer refuses to install and complains about an
3981 RPC configuration error, check to ensure that the following registry entries
3982 are present and that they refer to the dll &quot;rpcrt4.dll&quot;:</p>
3983
3984 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>HKLM
3985 &quot;SOFTWARE\Microsoft\RPC\ClientProtocols&quot; &quot;ncacn_np&quot;</p>
3986
3987 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>HKLM
3988 &quot;SOFTWARE\Microsoft\RPC\ClientProtocols&quot; &quot;ncacn_ip_tcp&quot;</p>
3989
3990 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>HKLM
3991 &quot;SOFTWARE\Microsoft\RPC\ClientProtocols&quot; &quot;ncadg_ip_udp&quot;</p>
3992
3993 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>HKLM
3994 &quot;SOFTWARE\Microsoft\RPC\ClientProtocols&quot; &quot;ncacn_http&quot;</p>
3995
3996 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416143"></a><a
3997 name="_Toc115417079"><span style='mso-bookmark:_Toc115416143'>3.37. Generating
3998 Minidumps of the OpenAFS Client Service</span></a></h2>
3999
4000 <p class=MsoNormal>OpenAFS 1.4 adds a new command, &quot;fs
4001 minidump&quot;.<span style='mso-spacerun:yes'>  </span>This command can be used
4002 at any time to generate a mini dump file containing the current stack of the
4003 afsd_service.exe process.<span style='mso-spacerun:yes'>   </span>This output
4004 can be very helpful when debugging the AFS Client Service when it is
4005 unresponsive to SMB/CIFS requests.</p>
4006
4007 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416144"></a><a
4008 name="_Toc115417080"><span style='mso-bookmark:_Toc115416144'>3.38. AFS Client
4009 Universally Unique Identifiers</span></a></h2>
4010
4011 <p class=MsoNormal>The OpenAFS for Windows 1.4 client implements Universally
4012 Unique Identifiers (UUIDs).<span style='mso-spacerun:yes'>  </span>They are
4013 used to provide the server with a method of identifying the client that is
4014 independent of IP address.<span style='mso-spacerun:yes'>  </span>The UUID is
4015 generated when the AFSCache file is created and is maintained as long as the
4016 contents of the AFSCache file are kept intact.<span style='mso-spacerun:yes'>
4017 </span>The UUID is stored in the AFSCache file.<span
4018 style='mso-spacerun:yes'>   </span>When cloning machines that have Windows AFS
4019 client installed, the AFSCache files must be deleted as part of the cloning
4020 process.</p>
4021
4022 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416145"></a><a
4023 name="_Toc115417081"></a><a name="_Toc115417112"><span style='mso-bookmark:
4024 _Toc115417081'><span style='mso-bookmark:_Toc115416145'>4. How to Debug
4025 Problems with OpenAFS for Windows:</span></span></a></h1>
4026
4027 <p class=MsoNormal>OpenAFS for Windows provides a wide range of tools to assist
4028 you in debugging problems.<span style='mso-spacerun:yes'>  </span>The
4029 techniques available to you are varied because of the wide range of issues that
4030 have been discovered over the years.</p>
4031
4032 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416146"></a><a
4033 name="_Toc115417082"><span style='mso-bookmark:_Toc115416146'>4.1. pioctl
4034 debugging (</span></a><a href="#_Value___:_IoctlDebug"><span style='mso-bookmark:
4035 _Toc115417082'><span style='mso-bookmark:_Toc115416146'>IoctlDebug</span></span><span
4036 style='mso-bookmark:_Toc115417082'><span style='mso-bookmark:_Toc115416146'></span></span></a><span
4037 style='mso-bookmark:_Toc115417082'><span style='mso-bookmark:_Toc115416146'>
4038 registry key)</span></span></h2>
4039
4040 <p class=MsoNormal>pioctl (path-based ioctl) calls are used by various tools to
4041 communicate with the AFS Client Service.<span style='mso-spacerun:yes'>
4042 </span>Some of the operations performed include:</p>
4043
4044 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4045 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4046 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4047 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4048 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4049 tokens<span style='mso-spacerun:yes'>  </span>(tokens.exe, aklog.exe,
4050 afscreds.exe)</p>
4051
4052 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4053 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4054 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4055 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4056 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4057 ACLs </p>
4058
4059 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4060 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4061 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4062 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4063 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4064 cache parameters</p>
4065
4066 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4067 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4068 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4069 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4070 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>flushing
4071 files or volumes</p>
4072
4073 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4074 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4075 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4076 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4077 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4078 server preferences</p>
4079
4080 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4081 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4082 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4083 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4084 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>querying
4085 path location</p>
4086
4087 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4088 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4089 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4090 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4091 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>checking
4092 the status of servers and volumes</p>
4093
4094 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4095 l7 level1 lfo18;tab-stops:list 14.15pt'><![if !supportLists]><span
4096 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4097 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4098 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4099 the sysname list</p>
4100
4101 <p class=MsoNormal>pioctl calls are implemented by writing to a special UNC
4102 path that is processed by the AFS Client Service.<span
4103 style='mso-spacerun:yes'>   </span>If there is a failure to communicate with
4104 the AFS Client Service via SMB/CIFS, it will be impossible to perform any of
4105 the above operations.<span style='mso-spacerun:yes'>   </span></p>
4106
4107 <p class=MsoNormal>To assist in debugging these problems, the registry value:</p>
4108
4109 <p class=PreformattedText><span style='mso-spacerun:yes'>
4110 </span>[HKLM\SOFTWARE\OpenAFS\Client]</p>
4111
4112 <p class=PreformattedText><span style='mso-spacerun:yes'>
4113 </span>REG_DWORD:<span style='mso-spacerun:yes'>  </span>IoctlDebug<span
4114 style='mso-spacerun:yes'>   </span>= 0x01</p>
4115
4116 <p class=MsoNormal>should be set.<span style='mso-spacerun:yes'>  </span>Then
4117 any of the commands that perform pioctl calls should be executed from the
4118 command prompt.<span style='mso-spacerun:yes'>  </span>With this key set the
4119 pioctl library will generate debugging output to stderr.<span
4120 style='mso-spacerun:yes'>  </span>The output will contain the Win32 API calls
4121 executed along with their most important parameters and their return code.<span
4122 style='mso-spacerun:yes'>   </span>The MSDN Library and the Microsoft
4123 KnowledgeBase can be used as a reference to help you determine the
4124 configuration probem with your system.</p>
4125
4126 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416147"></a><a
4127 name="_Toc115417083"><span style='mso-bookmark:_Toc115416147'>4.2. afsd_service
4128 initialization log (%WinDir%\TEMP\afsd_init.log)</span></a></h2>
4129
4130 <p class=MsoNormal>Every time the AFS Client Service starts it appends data
4131 about its progress and configuration to a file.<span style='mso-spacerun:yes'>
4132 </span>This file provides information crucial to determining why the service
4133 cannot start when there are problems.<span style='mso-spacerun:yes'>
4134 </span>When the process terminates due to a panic condition it will write to
4135 this file the source code file and line number of the error.<span
4136 style='mso-spacerun:yes'>  </span>In many cases the panic condition is due to a
4137 misconfiguration of the machine.<span style='mso-spacerun:yes'>  </span>In
4138 other cases it might be due to a programming error in the software.<span
4139 style='mso-spacerun:yes'>  </span>A quick review of the location in the source
4140 code will quickly reveal the reason for the termination.</p>
4141
4142 <p class=MsoNormal>The <i style='mso-bidi-font-style:normal'><a
4143 href="#_Value___:_MaxLogSize">MaxLogSize</a></i> registry value determines the
4144 maximum size of the %WINDIR%\TEMP\afsd_init.log file.<span
4145 style='mso-spacerun:yes'>  </span>If the file is larger than this value when
4146 OpenAFS Client Service starts, the file will be reset to 0 bytes.<span
4147 style='mso-spacerun:yes'>  </span>If value is set to 0, the file will be
4148 allowed to grow indefinitely.</p>
4149
4150 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416148"></a><a
4151 name="_Toc115417084"><span style='mso-bookmark:_Toc115416148'>4.3. afsd_service
4152 debug logs (fs trace {-on, -off, -dump} -&gt;%WinDir%\TEMP\afsd.log)</span></a></h2>
4153
4154 <p class=MsoNormal>When attempting to debug the behavior of the SMB/CIFS Server
4155 and the Cache Manager it is often useful to examine a log of the operations
4156 being performed.<span style='mso-spacerun:yes'>  </span>While running the AFS
4157 Client Service keeps an in memory log of many of its actions.<span
4158 style='mso-spacerun:yes'>   </span>The default number of actions preserved at
4159 any one time is 5000.<span style='mso-spacerun:yes'>  </span>This can be
4160 adjusted with the <a href="#_Value_:_TraceBufferSize">registry value</a>:</p>
4161
4162 <p class=PreformattedText><span style='mso-spacerun:yes'>  </span>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
4163
4164 <p class=PreformattedText><span style='mso-spacerun:yes'>
4165 </span>REG_DWORD<span style='mso-spacerun:yes'>  </span>TraceBufferSize </p>
4166
4167 <p class=MsoNormal>A restart of the service is necessary when adjusting this
4168 value.<span style='mso-spacerun:yes'>   </span>Execute &quot;fs trace -on&quot;
4169 to clear to the log and &quot;fs trace -dump&quot; to output the contents of
4170 the log to the file.</p>
4171
4172 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416149"></a><a
4173 name="_Toc115417085"><span style='mso-bookmark:_Toc115416149'>4.4. Using
4174 SysInternals DbgView and FileMon Tools</span></a></h2>
4175
4176 <p class=MsoNormal>An alternatve option to the use of &quot;fs trace
4177 -dump&quot; to capture internal OpenAFS Client Service events is to use a tool
4178 such as Sysinternal's DbgView to capture real-time debugging output.<span
4179 style='mso-spacerun:yes'>  </span>When the OpenAFS Client Service starts and
4180 Bit 2 of the <a href="#_Value__:_TraceOption">TraceOption</a> value in the
4181 registry is set, all trace log events are output using the Windows Debug
4182 Monitor interface (OutputDebugString).<span style='mso-spacerun:yes'>  </span></p>
4183
4184 <p class=PreformattedText><span style='mso-spacerun:yes'>  </span>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
4185
4186 <p class=PreformattedText style='text-indent:12.0pt'>REG_DWORD<span
4187 style='mso-spacerun:yes'>   </span>TraceOption = 0x04</p>
4188
4189 <p class=MsoNormal>Use fs trace on and fs trace off to toggle the
4190 generation of log messages. </p>
4191
4192 <p class=MsoNormal>Sysinternals FileMon utility can be use to monitor the file
4193 operations requested by applications and their success or failure.<span
4194 style='mso-spacerun:yes'>   </span>Restrict FileMon to monitor Network Volumes
4195 only in order to reduce the output to just the CIFS requests.<span
4196 style='mso-spacerun:yes'>   </span></p>
4197
4198 <p class=MsoNormal>Turn on the <i style='mso-bidi-font-style:normal'>Clock Time</i>
4199 option in both tools to make it easier to synchronize the application requests
4200 and the resulting OpenAFS Client Service operations.<span
4201 style='mso-spacerun:yes'>   </span>The captured data can be stored to files for
4202 inclusion in bug reports.</p>
4203
4204 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416150"></a><a
4205 name="_Toc115417086"><span style='mso-bookmark:_Toc115416150'>4.5. Microsoft
4206 MiniDumps <br>
4207 (fs minidump -&gt; %WinDir%\TEMP\afsd.dmp)</span></a></h2>
4208
4209 <p class=MsoNormal>If the AFS Client Service become unresponsive to any form of
4210 communication there may be a serious error that can only be debugged by someone
4211 with access to the source code and a debugger.<span style='mso-spacerun:yes'>
4212 </span>The &quot;fs minidump&quot; command can be used to force the generation
4213 of a MiniDump file containing the state of all of the threads in the AFS Client
4214 Service process.</p>
4215
4216 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416151"></a><a
4217 name="_Toc115417087"><span style='mso-bookmark:_Toc115416151'>4.6. Single
4218 Sign-on (Integrated Logon) debugging</span></a></h2>
4219
4220 <p class=MsoNormal>If you are having trouble with the Integrated Logon
4221 operations it is often useful to be able to obtain a log of what it is
4222 attempting to do.<span style='mso-spacerun:yes'>   </span>Setting Bit 0 of the <a
4223 href="#_Value__:_TraceOption">TraceOption</a> registry value:</p>
4224
4225 <p class=PreformattedText><span style='mso-spacerun:yes'>
4226 </span>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
4227
4228 <p class=PreformattedText><span style='mso-spacerun:yes'>
4229 </span>REG_DWORD<span style='mso-spacerun:yes'>   </span>TraceOption = 0x01</p>
4230
4231 <p class=MsoNormal>will instruct the Integrated Logon Network Provider and
4232 Event Handlers to log information to the Windows Event Log: Application under
4233 the name AFS Logon&quot;.</p>
4234
4235 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416152"></a><a
4236 name="_Toc115417088"><span style='mso-bookmark:_Toc115416152'>4.7. RX (AFS RPC)
4237 debugging (rxdebug)</span></a></h2>
4238
4239 <p class=MsoNormal>The rxdebug.exe tool can be used to query a variety of
4240 information about the AFS services installed on a given machine.<span
4241 style='mso-spacerun:yes'>  </span>The port for the AFS Cache Manager is
4242 7001.<span style='mso-spacerun:yes'>  </span></p>
4243
4244 <p class=PreformattedText>Usage: rxdebug -servers &lt;server machine&gt; [-port
4245 &lt;IP port&gt;] [-nodally] </p>
4246
4247 <p class=PreformattedText style='margin-left:35.45pt;text-indent:35.45pt'><span
4248 style='mso-spacerun:yes'>   </span>[-allconnections] [-rxstats] [-onlyserver]
4249 [-onlyclient] </p>
4250
4251 <p class=PreformattedText style='margin-left:70.9pt'><span
4252 style='mso-spacerun:yes'>   </span>[-onlyport &lt;show only &lt;port&gt;&gt;] </p>
4253
4254 <p class=PreformattedText style='margin-left:70.9pt'><span
4255 style='mso-spacerun:yes'>   </span>[-onlyhost &lt;show only &lt;host&gt;&gt;] </p>
4256
4257 <p class=PreformattedText style='margin-left:70.9pt'><span
4258 style='mso-spacerun:yes'>   </span>[-onlyauth &lt;show only &lt;auth
4259 level&gt;&gt;] [-version] </p>
4260
4261 <p class=PreformattedText style='margin-left:70.9pt'><span
4262 style='mso-spacerun:yes'>   </span>[-noconns] [-peers] [-help]</p>
4263
4264 <p class=PreformattedText>Where: -nodally<span
4265 style='mso-spacerun:yes'>         </span>don't show dallying conns</p>
4266
4267 <p class=PreformattedText><span style='mso-spacerun:yes'>
4268 </span>-allconnections<span style='mso-spacerun:yes'>  </span>don't filter out
4269 uninteresting connections</p>
4270
4271 <p class=PreformattedText><span style='mso-spacerun:yes'>
4272 </span>-rxstats<span style='mso-spacerun:yes'>         </span>show Rx
4273 statistics</p>
4274
4275 <p class=PreformattedText><span style='mso-spacerun:yes'>
4276 </span>-onlyserver<span style='mso-spacerun:yes'>      </span>only show server
4277 conns</p>
4278
4279 <p class=PreformattedText><span style='mso-spacerun:yes'>
4280 </span>-onlyclient<span style='mso-spacerun:yes'>      </span>only show client
4281 conns</p>
4282
4283 <p class=PreformattedText><span style='mso-spacerun:yes'>
4284 </span>-version<span style='mso-spacerun:yes'>         </span>show AFS version
4285 id</p>
4286
4287 <p class=PreformattedText><span style='mso-spacerun:yes'>
4288 </span>-noconns<span style='mso-spacerun:yes'>         </span>show no
4289 connections</p>
4290
4291 <p class=PreformattedText><span style='mso-spacerun:yes'>
4292 </span>-peers<span style='mso-spacerun:yes'>           </span>show peers</p>
4293
4294 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416153"></a><a
4295 name="_Toc115417089"><span style='mso-bookmark:_Toc115416153'>4.8. Cache
4296 Manager debugging (cmdebug)</span></a></h2>
4297
4298 <p class=MsoNormal>The cmdebug.exe tool can be used to query the state of the
4299 AFS Cache Manager on a given machine.</p>
4300
4301 <p class=PreformattedText>Usage: cmdebug -servers &lt;server machine&gt; [-port
4302 &lt;IP port&gt;] [-long] </p>
4303
4304 <p class=PreformattedText style='margin-left:70.9pt'><span
4305 style='mso-spacerun:yes'>   </span>[-refcounts] [-callbacks] [-addrs] [-cache]
4306 [-help]</p>
4307
4308 <p class=PreformattedText>Where: -long<span style='mso-spacerun:yes'>
4309 </span>print all info</p>
4310
4311 <p class=PreformattedText><span style='mso-spacerun:yes'>  </span><span
4312 style='mso-spacerun:yes'>     </span>-refcounts<span style='mso-spacerun:yes'>
4313 </span>print only cache entries with positive reference counts</p>
4314
4315 <p class=PreformattedText><span style='mso-spacerun:yes'>
4316 </span>-callbacks<span style='mso-spacerun:yes'>  </span>print only cache
4317 entries with callbacks</p>
4318
4319 <p class=PreformattedText><span style='mso-spacerun:yes'>
4320 </span>-addrs<span style='mso-spacerun:yes'>      </span>print only host
4321 interfaces</p>
4322
4323 <p class=PreformattedText><span style='mso-spacerun:yes'>
4324 </span>-cache<span style='mso-spacerun:yes'>      </span>print only cache
4325 configuration</p>
4326
4327 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416154"></a><a
4328 name="_Toc115417090"><span style='mso-bookmark:_Toc115416154'>4.9. Persistent
4329 Cache consistency check</span></a></h2>
4330
4331 <p class=MsoNormal>The persistent cache is stored in a Hidden System file at
4332 %WinDir%\TEMP\AFSCache.<span style='mso-spacerun:yes'>  </span>If there is a
4333 problem with the persistent cache that prevent the AFS Client Service from
4334 being able to start a validation check on the file can be performed.</p>
4335
4336 <p class=PreformattedText><span style='mso-spacerun:yes'>  </span>afsd_service.exe
4337 --validate-cache &lt;cache-path&gt;</p>
4338
4339 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416155"></a><a
4340 name="_Toc115417091"></a><a name="_Toc115417113"><span style='mso-bookmark:
4341 _Toc115417091'><span style='mso-bookmark:_Toc115416155'>5. Reporting Bugs:</span></span></a></h1>
4342
4343 <p class=MsoNormal>Bug reports should be sent to <a
4344 href="mailto:openafs-bugs@openafs.org?subject=Bug%20Report">openafs-bugs@openafs.org</a>.<span
4345 style='mso-spacerun:yes'>  </span>Please include as much information as
4346 possible about the issue.<span style='mso-spacerun:yes'>  </span>If you are
4347 reporting a crash, please install the debugging symbols by re-running the
4348 installer.<span style='mso-spacerun:yes'>  </span>If a dump file is available
4349 for the problem, %WINDIR%\TEMP\afsd.dmp, include it along with the AFS Client
4350 Trace file<span style='mso-spacerun:yes'>  </span>%WINDIR%\TEMP\afsd.log.<span
4351 style='mso-spacerun:yes'>  </span>The AFS Client startup log is
4352 %WINDIR%\TEMP\afsd_init.log.<span style='mso-spacerun:yes'>  </span>Send the
4353 last continuous block of<span style='mso-spacerun:yes'>  </span>log information
4354 from this file.</p>
4355
4356 <p class=MsoNormal>Configuring DrWatson to generate dump files for crashes:</p>
4357
4358 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
4359 l8 level1 lfo20;tab-stops:list 14.15pt'><![if !supportLists]><span
4360 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4361 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4362 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Run
4363 drwtsn32.exe to configure or to identify where the log and the crash dump files
4364 are created: </p>
4365
4366 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4367 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4368 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4369 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4370 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>click
4371 Start &gt; Run...<span style='mso-spacerun:yes'>  </span></p>
4372
4373 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4374 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4375 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4376 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4377 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>type
4378 drwtsn32 &lt;enter&gt;. </p>
4379
4380 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4381 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4382 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4383 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4384 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Select
4385 either a Crash Dump Type: Mini or Full. </p>
4386
4387 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4388 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4389 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4390 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4391 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Clear
4392 Dump Symbol Table</p>
4393
4394 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4395 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4396 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4397 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4398 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Clear
4399 Append to Existing Log file. </p>
4400
4401 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4402 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4403 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4404 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4405 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Check
4406 Dump All Thread Contexts.</p>
4407
4408 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4409 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4410 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4411 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4412 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Check
4413 Create Crash Dump File</p>
4414
4415 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
4416 l9 level1 lfo22;tab-stops:list 14.15pt'><![if !supportLists]><span
4417 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4418 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4419 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Next
4420 run the monitoring module of Dr. Watson: </p>
4421
4422 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4423 l10 level1 lfo24;tab-stops:list 14.15pt'><![if !supportLists]><span
4424 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4425 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4426 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>click
4427 Start &gt; Run...</p>
4428
4429 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4430 l10 level1 lfo24;tab-stops:list 14.15pt'><![if !supportLists]><span
4431 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4432 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4433 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>type
4434 drwatson &lt;enter&gt;. </p>
4435
4436 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4437 l10 level1 lfo24;tab-stops:list 14.15pt'><![if !supportLists]><span
4438 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4439 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4440 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Once
4441 a crash happens, Dr. Watson generates a dump file and a report in the log file,
4442 including the address of the crash and the stack dump.</p>
4443
4444 <p class=MsoNormal>Once you have the Dr. Watson's logfile and minidump, zip
4445 them and attach them to your e-mail.</p>
4446
4447 <p class=MsoNormal>When reporting a error, please be sure to include the
4448 version of OpenAFS.</p>
4449
4450 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416156"></a><a
4451 name="_Toc115417092"></a><a name="_Toc115417114"><span style='mso-bookmark:
4452 _Toc115417092'><span style='mso-bookmark:_Toc115416156'>6. How to Contribute to
4453 the Development of OpenAFS for Windows</span></span></a></h1>
4454
4455 <p class=MsoNormal>Contributions to the development of OpenAFS for Windows are
4456 continuously needed.<span style='mso-spacerun:yes'>  </span>Contributions may
4457 take many forms including cash donations, support contracts, donated developer
4458 time, and even donated tech writer time.</p>
4459
4460 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416157"></a><a
4461 name="_Toc115417093"><span style='mso-bookmark:_Toc115416157'>6.1. The USENIX
4462 OpenAFS Fund</span></a> </h2>
4463
4464 <p class=MsoBodyText><a href="http://www.usenix.org/">USENIX</a>, a 501c3
4465 non-profit corporation, has formed the USENIX OpenAFS Fund in order to accept
4466 tax deductible donations on behalf of the OpenAFS Elders. The donated funds
4467 will be allocated by the OpenAFS Elders to fund OpenAFS development, documentation,
4468 project management, and maintaining openafs.org. </p>
4469
4470 <div style='mso-element:frame;mso-element-frame-height:66.05pt;mso-element-wrap:
4471 no-wrap-beside;mso-element-anchor-vertical:page;mso-element-anchor-horizontal:
4472 column;mso-element-left:.05pt;mso-element-top:372.8pt;mso-height-rule:exactly'>
4473
4474 <table cellspacing=0 cellpadding=0 hspace=0 vspace=0 width=540 height=88>
4475  <tr>
4476   <td valign=top align=left height=88 style='padding-top:0pt;padding-right:
4477   9.0pt;padding-bottom:0pt;padding-left:9.0pt'>
4478   <p class=MsoEnvelopeAddress style='mso-element:frame;mso-element-frame-height:
4479   66.05pt;mso-element-wrap:no-wrap-beside;mso-element-anchor-vertical:page;
4480   mso-element-anchor-horizontal:column;mso-element-left:.05pt;mso-element-top:
4481   372.8pt;mso-height-rule:exactly'>USENIX OpenAFS Fund<br>
4482   USENIX Association <br>
4483 <st2:address w:st="on"><st2:Street w:st="on">2560 Ninth St., Suite 215</st2:Street>
4484    <br>
4485 <st2:City w:st="on">Berkeley</st2:City>, <st2:State w:st="on">CA</st2:State> <st2:PostalCode
4486    w:st="on">94710</st2:PostalCode></st2:address> </p>
4487   </td>
4488  </tr>
4489 </table>
4490
4491 </div>
4492
4493 <![if !supportTextWrap]><br clear=ALL>
4494 <![endif]>
4495
4496 <p class=MsoBodyText>Donations can be made by sending a check, drawn on a U.S.
4497 bank, made out to the USENIX OpenAFS Fund or by making a <a
4498 href="https://db.usenix.org/cgi-bin/openafs/openafs.cgi">donation online</a>.</p>
4499
4500 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417094">6.2. Secure
4501 Endpoints Inc.</a> </h2>
4502
4503 <p class=MsoBodyText><a href="http://www.secure-endpoints.com/">Secure
4504 Endpoints Inc.</a> provides development and support services for OpenAFS for
4505 Windows and MIT Kerberos for Windows.<span style='mso-spacerun:yes'>
4506 </span>Donations provided to Secure Endpoints Inc. for the development of
4507 OpenAFS are used to cover the OpenAFS gatekeeper responsibilities; providing
4508 support to the OpenAFS community via the OpenAFS mailing lists; and furthering
4509 development of desired features that are either too small to be financed by
4510 development contracts.</p>
4511
4512 <p class=MsoBodyText>Secure Endpoints Inc. accepts software development
4513 agreements from organizations who wish to fund a well-defined set of bug fixes
4514 or new features. </p>
4515
4516 <p class=MsoBodyText>Secure Endpoints Inc. provides contract based support for
4517 the OpenAFS for Windows and the MIT Kerberos for Windows products. </p>
4518
4519 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417095">6.3. The
4520 MIT Kerberos Account</a> </h2>
4521
4522 <p class=MsoNormal style='margin:0pt;margin-bottom:.0001pt;mso-pagination:widow-orphan;
4523 mso-hyphenate:auto;mso-layout-grid-align:none;text-autospace:none'><span
4524 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
4525 color:black'>Th</span><span class=BodyTextChar>e <a
4526 href="http://web.mit.edu/kerberos/">MIT Kerberos</a> development team accepts
4527 unrestricted grants.<span style='mso-spacerun:yes'>  </span>Grants are tax
4528 deductible and the full amount of the grant will be used to fund the
4529 development of Kerberos 5 and/or Kerberos for Windows.<span
4530 style='mso-spacerun:yes'>  </span>OpenAFS for Windows is dependent on MIT
4531 Kerberos for Windows for authentication and shares many of the same re</span><span
4532 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
4533 color:black'>quirements for credential management.<span
4534 style='mso-spacerun:yes'>  </span>Future releases of both products will share a
4535 common identity management user interface. <o:p></o:p></span></p>
4536
4537 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417096">6.4. Direct
4538 contributions of code and/or documentation</a> </h2>
4539
4540 <p class=MsoBodyText>Organizations that use OpenAFS in house and have
4541 development staffs are encouraged to contribute any code modifications they
4542 make to OpenAFS.org via <u><span style='color:blue'>openafs-bugs@openafs.org</span></u>.<span
4543 style='mso-spacerun:yes'>  </span>Contributions of documentation are highly
4544 desired. </p>
4545
4546 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417097">6.5.
4547 OpenAFS for Windows Mailing Lists</a></h2>
4548
4549 <p class=MsoNormal>If you wish to participate in OpenAFS for Windows
4550 development please join the <i><a
4551 href="mailto:openafs-win32-devel@openafs.org?subject=OpenAFS%20for%20Windows%20Development%20Contribution">openafs-win32-devel@openafs.org</a></i>
4552 mailing list.</p>
4553
4554 <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>
4555
4556 <p class=MsoNormal>User questions should be sent to the <a
4557 href="mailto:openafs-info@openafs.org?subject=OpenAFS%20for%20Windows%20User%20Question">openafs-info@openafs.org</a>
4558 mailing list.<span style='mso-spacerun:yes'>  </span></p>
4559
4560 <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>
4561
4562 <p class=MsoNormal>You must join the mailing lists if you wish to post to the
4563 list without incurring a moderation delay.</p>
4564
4565 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417115"></a><a
4566 name="_Toc115417098"></a><a name="_Toc115416158"></a><a
4567 name="_MSI_Deployment_Guide"></a><![if !supportLists]><span style='mso-bookmark:
4568 _Toc115417115'><span style='mso-bookmark:_Toc115417098'><span style='mso-bookmark:
4569 _Toc115416158'></span></span></span><![endif]><span style='mso-bookmark:_Toc115417115'><span
4570 style='mso-bookmark:_Toc115417098'><span style='mso-bookmark:_Toc115416158'>7.
4571 MSI Deployment Guide</span></span></span></h1>
4572
4573 </div>
4574
4575 <b><span style='font-size:16.0pt;font-family:Albany;mso-fareast-font-family:
4576 "MS Mincho";mso-bidi-font-family:Tahoma;mso-ansi-language:EN-US;mso-fareast-language:
4577 JA;mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always;
4578 mso-break-type:section-break'>
4579 </span></b>
4580
4581 <div class=Section2>
4582
4583 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416159"></a><a
4584 name="_Toc115417099"><span style='mso-bookmark:_Toc115416159'>7.1. Introduction</span></a></h2>
4585
4586 <p class=MsoNormal>A MSI installer option is available for those who wish to
4587 use Windows Installer for installing OpenAFS and for organizations that wish to
4588 deploy OpenAFS through Group Policy.<span style='mso-spacerun:yes'>  </span>The
4589 first version of OpenAFS for Windows available as an MSI was 1.3.65.</p>
4590
4591 <p class=MsoNormal>This document provides a guide for authoring transforms used
4592 to customize the MSI package for a particular organization.<span
4593 style='mso-spacerun:yes'>  </span>Although many settings can be deployed via
4594 transforms, in an Active Directory environment it is advisable to deploy
4595 registry settings<span style='mso-spacerun:yes'>    </span>and configuration
4596 files through group policy and/or startup scripts so that machines where
4597 OpenAFS for Windows is already installed will pick up these customizations.</p>
4598
4599 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416160">7.1.1
4600 Requirements</a></h3>
4601
4602 <p class=MsoNormal>The information in this document applies to MSI packages
4603 distributed with OpenAFS for Windows releases from 1.3.65 and onwards or MSI
4604 packages built from corresponding source releases.<span
4605 style='mso-spacerun:yes'>  </span>Not all releases support all the
4606 configuration options documented here.</p>
4607
4608 <p class=MsoNormal>Authoring a &quot;Windows Installer&quot; transform requires
4609 additional software for editing the MSI database tables and generating the
4610 transform from the modified MSI package.<span style='mso-spacerun:yes'>
4611 </span>ORCA.EXE and MSITRAN.EXE which are included in the Windows Platform SDK
4612 (&quot;Windows Installer&quot; SDK) can be used for this purpose.</p>
4613
4614 <p class=MsoNormal>For reference, the schema for the MSI package is based on
4615 SCHEMA.MSI distributed with the Platform SDK.</p>
4616
4617 <p class=MsoNormal>For general information about &quot;Windows Installer&quot;,
4618 refer to:</p>
4619
4620 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><a
4621 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>
4622
4623 <p class=MsoNormal>For general information about authoring MSI transforms,
4624 refer to:</p>
4625
4626 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><a
4627 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>
4628
4629 <p class=MsoNormal>The remainder of this document assumes some familiarity with
4630 authoring transforms.<span style='mso-spacerun:yes'>  </span>While the MSDN
4631 documentation for Windows Installer is a bit dense, the guide on MSI transforms
4632 found at the second link above is recommended reading.<span
4633 style='mso-spacerun:yes'>  </span>MSDN also includes a step-by-step example for
4634 creating a transform at:</p>
4635
4636 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><a
4637 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>
4638
4639 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416161">7.1.2
4640 Authoring a Transform</a></h3>
4641
4642 <p class=MsoNormal>Transforms describe a set of modifications to be performed
4643 on an existing MSI for the purpose of customizing it.<span
4644 style='mso-spacerun:yes'>  </span>This is ordinarily done by making a copy of
4645 the MSI to be customized, modifying the copy and then using the old and the new
4646 MSI to generate a transform.<span style='mso-spacerun:yes'>  </span>For
4647 example:</p>
4648
4649 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
4650 mso-list:l17 level1 lfo26;tab-stops:list 36.0pt'><![if !supportLists]><span
4651 style='mso-list:Ignore'>1.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;
4652 </span></span><![endif]>copy openafs.msi openafs-modified.msi</p>
4653
4654 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
4655 mso-list:l17 level1 lfo26;tab-stops:list 36.0pt'><![if !supportLists]><span
4656 style='mso-list:Ignore'>2.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;
4657 </span></span><![endif]>(edit the openafs-modified.msi to include the necessary
4658 changes)</p>
4659
4660 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
4661 mso-list:l17 level1 lfo26;tab-stops:list 36.0pt'><![if !supportLists]><span
4662 style='mso-list:Ignore'>3.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;
4663 </span></span><![endif]>msitran -g openafs.msi openafs-modified.msi
4664 openafs-transform.mst</p>
4665
4666 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
4667 mso-list:l17 level1 lfo26;tab-stops:list 36.0pt'><![if !supportLists]><span
4668 style='mso-list:Ignore'>4.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;
4669 </span></span><![endif]>(generates openafs-transform.mst, which is the
4670 transform)</p>
4671
4672 <p class=MsoNormal>Transforms have an extension of .mst.<span
4673 style='mso-spacerun:yes'>  </span>'msitran' is a tool distributed as part of
4674 the &quot;Windows Installer&quot; SDK (part of the Windows Platform SDK).</p>
4675
4676 <p class=MsoNormal>You can test a transform by:</p>
4677
4678 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
4679 mso-list:l16 level1 lfo28;tab-stops:list 36.0pt'><![if !supportLists]><span
4680 style='mso-list:Ignore'>1.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;
4681 </span></span><![endif]>copy openafs.msi openafs-test.msi</p>
4682
4683 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
4684 mso-list:l16 level1 lfo28;tab-stops:list 36.0pt'><![if !supportLists]><span
4685 style='mso-list:Ignore'>2.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;
4686 </span></span><![endif]>msitran -a openafs-transform.mst openafs-test.msi</p>
4687
4688 <p class=MsoNormal>and then checking the resulting openafs-test.msi to see if all
4689 changes you have made above to openafs-modified.msi is present in
4690 openafs-test.msi.<span style='mso-spacerun:yes'>  </span>'msitran' will
4691 complain if some modification in the transform can not be successfully applied.</p>
4692
4693 <p class=MsoNormal>As mentioned above, you can use a tool like ORCA.EXE to edit
4694 the MSI databases directly when editing openafs-modified.msi.<span
4695 style='mso-spacerun:yes'>  </span>More details are given below.</p>
4696
4697 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416162"></a><a
4698 name="_Toc115417100"><span style='mso-bookmark:_Toc115416162'>7.2.
4699 Configuration Options</span></a></h2>
4700
4701 <p class=MsoNormal>The logic necessary to implement many of the settings
4702 described in <a href="#_Appendix_A:_Registry_Values">Appendix A</a> are present
4703 in the MSI.<span style='mso-spacerun:yes'>  </span>Most of these can be
4704 controlled by setting the corresponding properties to the desired value.<span
4705 style='mso-spacerun:yes'>  </span>Some settings may require modifying existing
4706 registry entries (though not recommended) or adding new resources (like files
4707 or registry keys).<span style='mso-spacerun:yes'>  </span>Instructions for
4708 performing these tasks are below.</p>
4709
4710 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416163">7.2.1
4711 Configurable Properties</a></h3>
4712
4713 <p class=MsoNormal>Most configurable properties correspond to registry keys or
4714 values.<span style='mso-spacerun:yes'>  </span>Due to the logic invoked based
4715 on the existence of these registry keys or values, they are only set if the
4716 associated property is defined to have a non null value.<span
4717 style='mso-spacerun:yes'>  </span>If the associated property is not defined in
4718 the MSI, the registry key or value will not be touched.<span
4719 style='mso-spacerun:yes'>  </span>By default, the MSI does not contain these
4720 properties and hence will not set the registry keys.<span
4721 style='mso-spacerun:yes'>  </span>You will need to add properties as needed to
4722 the MSI.</p>
4723
4724 <p class=MsoNormal>When one of the configurable properties is set, the
4725 installer will use the property value to set the corresponding setting in the
4726 HKEY_LOCAL_MACHINE registry hive.<span style='mso-spacerun:yes'>  </span>The
4727 HKEY_CURRENT_USER hive is not touched by the installer.</p>
4728
4729 <p class=MsoNormal>For each property, the associated registry setting is
4730 referenced by the same text used in <a href="#_Appendix_A:_Registry_Values">Appendix
4731 A</a>.</p>
4732
4733 <p class=MsoNormal>Strings are quoted using single quotes (e.g. 'a string'). An
4734 empty string is denoted as ''.<span style='mso-spacerun:yes'>  </span>Note that
4735 you can't author null values into the 'Property' table.</p>
4736
4737 <p class=MsoNormal>Numeric values should be authored as decimal strings.</p>
4738
4739 <h4><a name="_Toc115416164">7.2.1.1 Setting Properties</a></h4>
4740
4741 <p class=MsoNormal>In order to set a property,</p>
4742
4743 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
4744 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l14 level1 lfo30;tab-stops:
4745 list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;mso-fareast-font-family:
4746 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.<span
4747 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4748 </span></span></span><![endif]>Open the MSI in ORCA.EXE</p>
4749
4750 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
4751 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l14 level1 lfo30;tab-stops:
4752 list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;mso-fareast-font-family:
4753 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.<span
4754 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4755 </span></span></span><![endif]>Select the 'Property' table from the list of
4756 tables on the left.</p>
4757
4758 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
4759 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l14 level1 lfo30;tab-stops:
4760 list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;mso-fareast-font-family:
4761 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3.<span
4762 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4763 </span></span></span><![endif]>Find the property in the list of properties on
4764 the right, double click the value and type the new value.</p>
4765
4766 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
4767 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l14 level1 lfo30;tab-stops:
4768 list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;mso-fareast-font-family:
4769 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>4.<span
4770 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
4771 </span></span></span><![endif]>If the property does not exist in the property
4772 list, right click the list and select 'Add Row', type the property name and the
4773 desired value.</p>
4774
4775 <h4><a name="_Toc115416165">7.2.1.2 OpenAFS for Windows Properties</a></h4>
4776
4777 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
4778  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
4779  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
4780  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
4781   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4782   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416166"></a><a
4783   name="_(Service_parameters):"></a><span style='mso-bookmark:_Toc115416166'>(Service
4784   parameters):</span></h5>
4785   <p class=ListContents style='margin-left:0pt;mso-yfti-cnfc:1'>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
4786   </td>
4787  </tr>
4788  <tr style='mso-yfti-irow:0'>
4789   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4790   <h5><a name="_Toc115416167"></a><a name="_(Network_provider):"></a><span
4791   style='mso-bookmark:_Toc115416167'>(Network provider):</span></h5>
4792   <p class=ListContents style='margin-left:0pt'>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]</p>
4793   </td>
4794  </tr>
4795  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
4796   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4797   <h5><a name="_Toc115416168"></a><a name="_(OpenAFS_Client):"></a><span
4798   style='mso-bookmark:_Toc115416168'>(OpenAFS Client):</span></h5>
4799   <p class=ListContents style='margin-left:0pt'>[HKLM\SOFTWARE\OpenAFS\Client]</p>
4800   </td>
4801  </tr>
4802 </table>
4803
4804 <h5><a name="_Toc115416169">7.2.1.2.1 Registry Properties</a></h5>
4805
4806 <p class=MsoNormal>These properties are used to set the values of registry
4807 entries associated with OpenAFS for Windows.</p>
4808
4809 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
4810  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
4811  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
4812  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
4813   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4814   <h6 style='mso-yfti-cnfc:1'><a name="_Toc115416170">AFSCACHEPATH</a></h6>
4815   <p class=MsoList style='mso-yfti-cnfc:1'>Registry key<span
4816   style='mso-spacerun:yes'>    </span>: <a href="#_(Service_parameters):">(Service
4817   parameters)</a></p>
4818   <p class=MsoList style='mso-yfti-cnfc:1'>Registry value : <a
4819   href="#_Value_:_CachePath">CachePath</a></p>
4820   <p class=MsoList style='mso-yfti-cnfc:1'>Valid values<span
4821   style='mso-spacerun:yes'>    </span>: string .</p>
4822   </td>
4823  </tr>
4824  <tr style='mso-yfti-irow:0'>
4825   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4826   <h6><a name="_Toc115416171">AFSCACHESIZE</a></h6>
4827   <p class=MsoList>Registry key<span style='mso-spacerun:yes'>    </span>: <a
4828   href="#_(Service_parameters):">(Service parameters)</a></p>
4829   <p class=MsoList>Registry value : <a href="#_Value___:_CacheSize">CacheSize</a></p>
4830   <p class=MsoList>Valid values<span style='mso-spacerun:yes'>    </span>:
4831   numeric</p>
4832   </td>
4833  </tr>
4834  <tr style='mso-yfti-irow:1'>
4835   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4836   <h6><a name="_Toc115416172">AFSCELLNAME</a></h6>
4837   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4838   href="#_(Service_parameters):">(Service parameters)</a></p>
4839   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4840   href="#_Value_:_Cell">Cell</a></p>
4841   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>:
4842   string</p>
4843   </td>
4844  </tr>
4845  <tr style='mso-yfti-irow:2'>
4846   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4847   <h6><a name="_Toc115416173">FREELANCEMODE</a></h6>
4848   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4849   href="#_(Service_parameters):">(Service parameters)</a></p>
4850   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4851   href="#_Value_:_FreelanceClient">FreelanceClient</a></p>
4852   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '1'
4853   or '0'</p>
4854   </td>
4855  </tr>
4856  <tr style='mso-yfti-irow:3'>
4857   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4858   <h6><a name="_Toc115416174">HIDEDOTFILES</a></h6>
4859   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4860   href="#_(Service_parameters):">(Service parameters)</a></p>
4861   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4862   href="#_Value_:_HideDotFiles">HideDotFiles</a></p>
4863   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '1'
4864   or '0'</p>
4865   </td>
4866  </tr>
4867  <tr style='mso-yfti-irow:4'>
4868   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4869   <h6><a name="_Toc115416175">LOGONOPTIONS</a></h6>
4870   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4871   href="#_(Network_provider):">(Network provider)</a></p>
4872   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4873   href="#_Value___:_LogonOptions">LogonOptions</a></p>
4874   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '0',
4875   '1' or '3'</p>
4876   <p class=MsoNormal>See <a href="#_Appendix_A:_Registry_Values">Appendix A</a>
4877   <a href="#_A.2.1_Domain_specific_configuration">section 2.1 (Domain specific
4878   configuration keys for Network Provider)</a> for more details.</p>
4879   </td>
4880  </tr>
4881  <tr style='mso-yfti-irow:5'>
4882   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4883   <h6><a name="_Toc115416176">MOUNTROOT</a></h6>
4884   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4885   href="#_(Service_parameters):">(Service parameters)</a></p>
4886   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4887   href="#_Value_:_Mountroot">Mountroot</a></p>
4888   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>:
4889   string</p>
4890   </td>
4891  </tr>
4892  <tr style='mso-yfti-irow:6'>
4893   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4894   <h6><a name="_Toc115416177">NETBIOSNAME</a></h6>
4895   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4896   href="#_(Service_parameters):">(Service parameters)</a></p>
4897   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4898   href="#_Value___:_NetbiosName">NetbiosName</a></p>
4899   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>:
4900   string (at most 15 characters)</p>
4901   </td>
4902  </tr>
4903  <tr style='mso-yfti-irow:7'>
4904   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4905   <h6><a name="_Toc115416178">NOFINDLANABYNAME</a></h6>
4906   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4907   href="#_(Service_parameters):">(Service parameters)</a></p>
4908   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4909   href="#_Value___:_NoFindLanaByName">NoFindLanaByName</a></p>
4910   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '1'
4911   or '0'</p>
4912   </td>
4913  </tr>
4914  <tr style='mso-yfti-irow:8'>
4915   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4916   <h6><a name="_Toc115416179">RXMAXMTU</a></h6>
4917   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4918   href="#_(Service_parameters):">(Service parameters)</a></p>
4919   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4920   href="#_Value_:_RxMaxMTU">RxMaxMTU</a></p>
4921   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>:
4922   numeric</p>
4923   </td>
4924  </tr>
4925  <tr style='mso-yfti-irow:9'>
4926   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4927   <h6><a name="_Toc115416180">SECURITYLEVEL</a></h6>
4928   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4929   href="#_(Service_parameters):">(Service parameters)</a></p>
4930   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4931   href="#_Value_:_SecurityLevel">SecurityLevel</a></p>
4932   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '1'
4933   or '0'</p>
4934   </td>
4935  </tr>
4936  <tr style='mso-yfti-irow:10'>
4937   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4938   <h6><a name="_Toc115416181">SMBAUTHTYPE</a></h6>
4939   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4940   href="#_(Service_parameters):">(Service parameters)</a></p>
4941   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4942   href="#_Value___:_smbAuthType">SMBAuthType</a></p>
4943   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>:
4944   '0','1' or '2'</p>
4945   </td>
4946  </tr>
4947  <tr style='mso-yfti-irow:11'>
4948   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4949   <h6><a name="_Toc115416182">STOREANSIFILENAMES</a></h6>
4950   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4951   href="#_(OpenAFS_Client):">(OpenAFS Client)</a></p>
4952   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4953   href="#_Value___:_StoreAnsiFilenames">StoreAnsiFilenames</a></p>
4954   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '0'
4955   or '1'</p>
4956   </td>
4957  </tr>
4958  <tr style='mso-yfti-irow:12;mso-yfti-lastrow:yes'>
4959   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4960   <h6><a name="_Toc115416183">USEDNS</a></h6>
4961   <p class=MsoList>Registry key<span style='mso-tab-count:1'>    </span>: <a
4962   href="#_(Service_parameters):">(Service parameters)</a></p>
4963   <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
4964   href="#_Value_:_UseDNS">UseDNS</a></p>
4965   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '1'
4966   or '0'</p>
4967   </td>
4968  </tr>
4969 </table>
4970
4971 <h5><a name="_Toc115416184"></a><a name="_7.2.1.2.2_AFSCreds.exe_Properties"></a><span
4972 style='mso-bookmark:_Toc115416184'>7.2.1.2.2 AFSCreds.exe Properties</span></h5>
4973
4974 <p class=MsoNormal>These properties are combined to add a command line option
4975 to the shortcut that will be created in the Start:Programs:OpenAFS and
4976 Start:Programs:Startup folders (see CREDSSTARTUP).<span
4977 style='mso-spacerun:yes'>  </span>The method of specifying the option was
4978 chosen for easy integration with the Windows Installer user interface.<span
4979 style='mso-spacerun:yes'>  </span>Although other methods can be used to specify
4980 options to AFSCREDS.EXE, it is advised that they be avoided as transforms
4981 including such options may not apply to future releases of OpenAFS.</p>
4982
4983 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
4984  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
4985  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
4986  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
4987   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
4988   <h6 style='mso-yfti-cnfc:1'><a name="_Toc115416185">CREDSSTARTUP</a></h6>
4989   <p class=MsoList style='mso-yfti-cnfc:1'>Valid values<span
4990   style='mso-spacerun:yes'>  </span><span style='mso-spacerun:yes'>  </span>:
4991   '1' or '0'</p>
4992   <p class=MsoList style='mso-yfti-cnfc:1'>Controls whether AFSCreds.exe starts
4993   up automatically when the user logs on.<span style='mso-spacerun:yes'>
4994   </span>When CREDSSTARTUP is '1' a shortcut is added to the 'Startup' folder
4995   in the 'Program menu' which starts AFSCREDS.EXE with the options that are
4996   determined by the other CREDS* properties.</p>
4997   </td>
4998  </tr>
4999  <tr style='mso-yfti-irow:0'>
5000   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5001   <h6><a name="_Toc115416186">CREDSAUTOINIT</a></h6>
5002   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '-a'
5003   or ''</p>
5004   <p class=MsoList>Enables automatic initialization.</p>
5005   </td>
5006  </tr>
5007  <tr style='mso-yfti-irow:1'>
5008   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5009   <h6><a name="_Toc115416187">CREDSIPCHDET</a></h6>
5010   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '-n'
5011   or ''</p>
5012   <p class=MsoList>Enables IP address change detection.</p>
5013   </td>
5014  </tr>
5015  <tr style='mso-yfti-irow:2'>
5016   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5017   <h6><a name="_Toc115416188">CREDSQUIET</a></h6>
5018   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '-q'
5019   or ''</p>
5020   <p class=MsoList>Enables quiet mode.</p>
5021   </td>
5022  </tr>
5023  <tr style='mso-yfti-irow:3'>
5024   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5025   <h6><a name="_Toc115416189">CREDSRENEWDRMAP</a></h6>
5026   <p class=MsoList>Valid values<span style='mso-tab-count:1'>    </span>: '-m'
5027   or '</p>
5028   <p class=MsoList>Enables renewing drive map at startup.</p>
5029   </td>
5030  </tr>
5031  <tr style='mso-yfti-irow:4;mso-yfti-lastrow:yes'>
5032   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5033   <h6><a name="_Toc115416190">CREDSSHOW</a></h6>
5034   <p class=MsoList>Valid values<span style='mso-spacerun:yes'>    </span>: '-s'
5035   or ''</p>
5036   <p class=MsoList>Enables displaying the credential manager window when
5037   AFSCREDS starts up.</p>
5038   </td>
5039  </tr>
5040 </table>
5041
5042 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416191">7.2.2
5043 Existing Registry Entries</a></h3>
5044
5045 <p class=MsoNormal>You can change existing registry values subject to the
5046 restrictions mentioned in the Windows Platform SDK.<span
5047 style='mso-spacerun:yes'>  </span>Pay special attention to component key paths
5048 and try to only change the 'Value' column in the 'Registry' table.<span
5049 style='mso-spacerun:yes'>  </span>If you want to add additional registry keys
5050 please refer to section 3 (Additional resources).</p>
5051
5052 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416192">7.2.3
5053 Replacing Configuration Files</a></h3>
5054
5055 <p class=MsoNormal>The OpenAFS configuration files (CellServDB) can be replaced
5056 by your own configuration files.<span style='mso-spacerun:yes'>  </span>These
5057 files are contained in separate MSI components so that you can disable them
5058 individually.</p>
5059
5060 <p class=MsoNormal>The recommended method for replacing these files is to first
5061 disable the components containing the configuration files that you want to
5062 replace, and then add new components for the replacement files.<span
5063 style='mso-spacerun:yes'>  </span>This is outlined below (assuming you are
5064 using ORCA.EXE to author the transform).</p>
5065
5066 <p class=MsoNormal>Note that transforms are not a good way to add a new file as
5067 an embedded stream.<span style='mso-spacerun:yes'>  </span>The method outlined
5068 here places the file in the same directory as the MSI for deployment.</p>
5069
5070 <p class=MsoNormal>The walkthrough below is to add a custom 'CellServDB' file.</p>
5071
5072 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5073 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l13 level1 lfo32;tab-stops:
5074 list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5075 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.<span
5076 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Disable
5077 the component that contains the configuration file that you want to replace.</p>
5078
5079 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5080 margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;tab-stops:
5081 list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5082 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.1.<span
5083 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Locate
5084 and select the 'Component' table in the 'Tables' list.</p>
5085
5086 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5087 margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;tab-stops:
5088 list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5089 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.2.<span
5090 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>In
5091 the Component table, locate the component you need to change ( Ctrl-F invokes
5092 the 'Find' dialog).<span style='mso-spacerun:yes'>  </span>The component names
5093 are listed below in section <a href="#_2.3.1_Components_for_Configuration_">7.2.3.1</a>.<span
5094 style='mso-spacerun:yes'>  </span>For this example, the component name is
5095 'elf_CellServDB'.</p>
5096
5097 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5098 margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;tab-stops:
5099 list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5100 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.3.<span
5101 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Go
5102 to the 'Condition' column of the component.</p>
5103
5104 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5105 margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;tab-stops:
5106 list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5107 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.4.<span
5108 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Enter
5109 a condition that evaluates to false. I.e. 'DONOTINSTALL'. (Note that an
5110 undefined property always evaluates to false).</p>
5111
5112 <p class=MsoNormal>Note that you can also use this step to disable other
5113 configuration files without providing replacements.</p>
5114
5115 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l13 level1 lfo32;
5116 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
5117 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.<span
5118 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Add
5119 a new component containing the new configuration file.</p>
5120
5121 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5122 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5123 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.1.<span
5124 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
5125 the 'Component' table in the 'Tables' list.</p>
5126
5127 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5128 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5129 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.2.<span
5130 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
5131 'Tables'-&gt;'Add Row' (Ctrl-R).</p>
5132
5133 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5134 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5135 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.3.<span
5136 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Enter
5137 the following :</p>
5138
5139 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
5140  style='margin-left:39.35pt;border-collapse:collapse;border:none;mso-border-alt:
5141  solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5142  mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
5143  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;height:23.35pt'>
5144   <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
5145   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt;height:23.35pt'>
5146   <p class=PreformattedText>Component</p>
5147   </td>
5148   <td width=475 valign=top style='width:356.55pt;border:solid windowtext 1.0pt;
5149   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
5150   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt;height:23.35pt'>
5151   <p class=PreformattedText>cmf_my_CellServDB</p>
5152   </td>
5153  </tr>
5154  <tr style='mso-yfti-irow:1'>
5155   <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
5156   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5157   padding:0pt 5.4pt 0pt 5.4pt'>
5158   <p class=PreformattedText>ComponentID</p>
5159   </td>
5160   <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
5161   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5162   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5163   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5164   <p class=PreformattedText>{7019836F-BB2C-4AF6-9463-0D6EC9035CF1}</p>
5165   </td>
5166  </tr>
5167  <tr style='mso-yfti-irow:2'>
5168   <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
5169   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5170   padding:0pt 5.4pt 0pt 5.4pt'>
5171   <p class=PreformattedText>Directory_</p>
5172   </td>
5173   <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
5174   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5175   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5176   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5177   <p class=PreformattedText>dirClient</p>
5178   </td>
5179  </tr>
5180  <tr style='mso-yfti-irow:3'>
5181   <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
5182   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5183   padding:0pt 5.4pt 0pt 5.4pt'>
5184   <p class=PreformattedText>Attributes</p>
5185   </td>
5186   <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
5187   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5188   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5189   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5190   <p class=PreformattedText>144</p>
5191   </td>
5192  </tr>
5193  <tr style='mso-yfti-irow:4'>
5194   <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
5195   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5196   padding:0pt 5.4pt 0pt 5.4pt'>
5197   <p class=PreformattedText>Condition</p>
5198   </td>
5199   <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
5200   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5201   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5202   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5203   <p class=PreformattedText><o:p>&nbsp;</o:p></p>
5204   </td>
5205  </tr>
5206  <tr style='mso-yfti-irow:5;mso-yfti-lastrow:yes'>
5207   <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
5208   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5209   padding:0pt 5.4pt 0pt 5.4pt'>
5210   <p class=PreformattedText>KeyPath</p>
5211   </td>
5212   <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
5213   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5214   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5215   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5216   <p class=PreformattedText>fil_my_CellServDB</p>
5217   </td>
5218  </tr>
5219 </table>
5220
5221 <p class=MsoNormal style='margin-left:35.45pt'>Note that the ComponentId is an
5222 uppercase GUID.<span style='mso-spacerun:yes'>  </span>You can generate one
5223 using GUIDGEN.EXE or UUIDGEN.EXE, both of which are included in the Platform
5224 SDK.</p>
5225
5226 <p class=MsoNormal style='margin-left:35.45pt'>The Attributes value of 144 is a
5227 sum of msidbComponentAttributesPermanent (16) and
5228 msidbComponentAttributesNeverOverwrite (128).<span style='mso-spacerun:yes'>
5229 </span>This ensures that local modifications are not overwritten or lost during
5230 an installation or uninstallation.<span style='mso-spacerun:yes'>  </span>These
5231 are the same settings used on the default configuration files.</p>
5232
5233 <p class=MsoNormal><span style='mso-tab-count:1'>            </span>'fil_my_CellServDB'
5234 is a key into the 'File' table which we will fill later.</p>
5235
5236 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l13 level1 lfo32;
5237 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
5238 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3.<span
5239 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Add
5240 a new feature to hold the new component.</p>
5241
5242 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5243 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5244 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3.1.<span
5245 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
5246 the 'Feature' table.</p>
5247
5248 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5249 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5250 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3.2.<span
5251 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Add
5252 a new row (Ctrl-R or 'Tables'-&gt;'Add Row') with the following values:</p>
5253
5254 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
5255  style='margin-left:40.1pt;border-collapse:collapse;border:none;mso-border-alt:
5256  solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5257  mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
5258  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
5259   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5260   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5261   <p class=PreformattedText>Feature</p>
5262   </td>
5263   <td width=462 valign=top style='width:346.2pt;border:solid windowtext 1.0pt;
5264   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
5265   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5266   <p class=PreformattedText>fea_my_CellServDB</p>
5267   </td>
5268  </tr>
5269  <tr style='mso-yfti-irow:1'>
5270   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5271   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5272   padding:0pt 5.4pt 0pt 5.4pt'>
5273   <p class=PreformattedText>Feature_Parent</p>
5274   </td>
5275   <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
5276   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5277   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5278   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5279   <p class=PreformattedText>feaClient</p>
5280   </td>
5281  </tr>
5282  <tr style='mso-yfti-irow:2'>
5283   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5284   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5285   padding:0pt 5.4pt 0pt 5.4pt'>
5286   <p class=PreformattedText>Title</p>
5287   </td>
5288   <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
5289   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5290   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5291   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5292   <p class=PreformattedText><o:p>&nbsp;</o:p></p>
5293   </td>
5294  </tr>
5295  <tr style='mso-yfti-irow:3'>
5296   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5297   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5298   padding:0pt 5.4pt 0pt 5.4pt'>
5299   <p class=PreformattedText>Description</p>
5300   </td>
5301   <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
5302   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5303   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5304   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5305   <p class=PreformattedText><o:p>&nbsp;</o:p></p>
5306   </td>
5307  </tr>
5308  <tr style='mso-yfti-irow:4'>
5309   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5310   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5311   padding:0pt 5.4pt 0pt 5.4pt'>
5312   <p class=PreformattedText>Display</p>
5313   </td>
5314   <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
5315   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5316   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5317   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5318   <p class=PreformattedText>0</p>
5319   </td>
5320  </tr>
5321  <tr style='mso-yfti-irow:5'>
5322   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5323   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5324   padding:0pt 5.4pt 0pt 5.4pt'>
5325   <p class=PreformattedText>Level</p>
5326   </td>
5327   <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
5328   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5329   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5330   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5331   <p class=PreformattedText>30</p>
5332   </td>
5333  </tr>
5334  <tr style='mso-yfti-irow:6'>
5335   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5336   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5337   padding:0pt 5.4pt 0pt 5.4pt'>
5338   <p class=PreformattedText>Directory_</p>
5339   </td>
5340   <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
5341   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5342   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5343   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5344   <p class=PreformattedText><o:p>&nbsp;</o:p></p>
5345   </td>
5346  </tr>
5347  <tr style='mso-yfti-irow:7;mso-yfti-lastrow:yes'>
5348   <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
5349   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5350   padding:0pt 5.4pt 0pt 5.4pt'>
5351   <p class=PreformattedText>Attributes</p>
5352   </td>
5353   <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
5354   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5355   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5356   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5357   <p class=PreformattedText>8</p>
5358   </td>
5359  </tr>
5360 </table>
5361
5362 <p class=MsoNormal style='margin-left:35.45pt'>It is important to create the new
5363 feature under the 'feaClient' feature, which will ensure that the configuration
5364 file will be installed when the client binaries are installed.</p>
5365
5366 <p class=MsoNormal style='margin-left:35.45pt'>Setting 'Display' to 0 will hide
5367 this feature from the feature selection dialog during an interactive installation.<span
5368 style='mso-spacerun:yes'>  </span>A value of 30 for 'Level' allows this feature
5369 to be installed by default (on a 'Typical' installation).</p>
5370
5371 <p class=MsoNormal style='margin-left:35.45pt'>The 'Attributes' value is
5372 msidbFeatureAttributesDisallowAdvertise (8), which is set on all features in
5373 the OpenAFS MSI.<span style='mso-spacerun:yes'>  </span>The OpenAFS MSI is not designed
5374 for an advertised installation.</p>
5375
5376 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l13 level1 lfo32;
5377 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
5378 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>4.<span
5379 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Join
5380 the component and the feature.</p>
5381
5382 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5383 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5384 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>4.1.<span
5385 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
5386 the 'FeatureComponents' table.</p>
5387
5388 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5389 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5390 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>4.2.<span
5391 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Add
5392 a new row with the following values:</p>
5393
5394 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
5395  style='margin-left:40.1pt;border-collapse:collapse;border:none;mso-border-alt:
5396  solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5397  mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
5398  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
5399   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5400   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5401   <p class=PreformattedText>Feature</p>
5402   </td>
5403   <td width=462 valign=top style='width:346.5pt;border:solid windowtext 1.0pt;
5404   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
5405   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5406   <p class=PreformattedText>fea_my_CellServDB</p>
5407   </td>
5408  </tr>
5409  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
5410   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5411   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5412   padding:0pt 5.4pt 0pt 5.4pt'>
5413   <p class=PreformattedText>Component</p>
5414   </td>
5415   <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
5416   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5417   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5418   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5419   <p class=PreformattedText>cmf_my_CellServDB</p>
5420   </td>
5421  </tr>
5422 </table>
5423
5424 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l13 level1 lfo32;
5425 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
5426 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>5.<span
5427 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Add
5428 an entry to the 'File' table.</p>
5429
5430 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5431 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5432 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>5.1.<span
5433 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
5434 the 'File' table.</p>
5435
5436 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5437 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5438 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>5.2.<span
5439 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Add
5440 a new row with the following values:</p>
5441
5442 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
5443  style='margin-left:40.1pt;border-collapse:collapse;border:none;mso-border-alt:
5444  solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5445  mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
5446  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
5447   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5448   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5449   <p class=PreformattedText>File</p>
5450   </td>
5451   <td width=462 valign=top style='width:346.5pt;border:solid windowtext 1.0pt;
5452   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
5453   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5454   <p class=PreformattedText>fil_my_CellServDB</p>
5455   </td>
5456  </tr>
5457  <tr style='mso-yfti-irow:1'>
5458   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5459   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5460   padding:0pt 5.4pt 0pt 5.4pt'>
5461   <p class=PreformattedText>Component_</p>
5462   </td>
5463   <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
5464   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5465   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5466   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5467   <p class=PreformattedText>cmf_my_CellServDB</p>
5468   </td>
5469  </tr>
5470  <tr style='mso-yfti-irow:2'>
5471   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5472   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5473   padding:0pt 5.4pt 0pt 5.4pt'>
5474   <p class=PreformattedText>FileName</p>
5475   </td>
5476   <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
5477   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5478   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5479   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5480   <p class=PreformattedText>CellServDB</p>
5481   </td>
5482  </tr>
5483  <tr style='mso-yfti-irow:3'>
5484   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5485   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5486   padding:0pt 5.4pt 0pt 5.4pt'>
5487   <p class=PreformattedText>FileSize</p>
5488   </td>
5489   <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
5490   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5491   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5492   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5493   <p class=PreformattedText>(enter file size here)</p>
5494   </td>
5495  </tr>
5496  <tr style='mso-yfti-irow:4'>
5497   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5498   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5499   padding:0pt 5.4pt 0pt 5.4pt'>
5500   <p class=PreformattedText>Attributes</p>
5501   </td>
5502   <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
5503   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5504   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5505   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5506   <p class=PreformattedText>8192</p>
5507   </td>
5508  </tr>
5509  <tr style='mso-yfti-irow:5;mso-yfti-lastrow:yes'>
5510   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5511   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5512   padding:0pt 5.4pt 0pt 5.4pt'>
5513   <p class=PreformattedText>Sequence</p>
5514   </td>
5515   <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
5516   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5517   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5518   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5519   <p class=PreformattedText>1000</p>
5520   </td>
5521  </tr>
5522 </table>
5523
5524 <p class=MsoNormal><span style='mso-tab-count:1'>            </span><span
5525 style='mso-spacerun:yes'>    </span>(leave other fields blank)</p>
5526
5527 <p class=MsoNormal style='margin-left:35.45pt'>The 'Attributes' value is
5528 msidbFileAttributesNonCompressed (8192).<span style='mso-spacerun:yes'>
5529 </span>This is because we will be placing this file in the same directory as
5530 the MSI instead of embedding the file in it.<span style='mso-spacerun:yes'>
5531 </span>Transforms do not support updating compressed sources or adding new
5532 cabinet streams.</p>
5533
5534 <p class=MsoNormal style='margin-left:35.45pt'>Finally, the 'Sequence' value of
5535 1000 will be used later to distinguish the file as being in a separate source
5536 location than the other files in the MSI.</p>
5537
5538 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l13 level1 lfo32;
5539 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
5540 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>6.<span
5541 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Set
5542 a media source for the file.</p>
5543
5544 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5545 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5546 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>6.1.<span
5547 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
5548 the 'Media' table.</p>
5549
5550 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l13 level2 lfo32;
5551 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5552 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>6.2.<span
5553 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp; </span></span></span><![endif]>Add
5554 a row with the following values :</p>
5555
5556 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
5557  style='margin-left:40.1pt;border-collapse:collapse;border:none;mso-border-alt:
5558  solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5559  mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
5560  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
5561   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5562   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5563   <p class=PreformattedText>DiskId</p>
5564   </td>
5565   <td width=462 valign=top style='width:346.5pt;border:solid windowtext 1.0pt;
5566   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
5567   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5568   <p class=PreformattedText>2</p>
5569   </td>
5570  </tr>
5571  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
5572   <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
5573   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5574   padding:0pt 5.4pt 0pt 5.4pt'>
5575   <p class=PreformattedText>LastSequence</p>
5576   </td>
5577   <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
5578   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5579   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5580   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5581   <p class=PreformattedText>1000</p>
5582   </td>
5583  </tr>
5584 </table>
5585
5586 <p class=MsoNormal><span style='mso-tab-count:1'>            </span><span
5587 style='mso-spacerun:yes'>    </span>(leave other fields blank)</p>
5588
5589 <p class=MsoNormal style='margin-left:35.45pt'>The sequence number of 1000
5590 designates this as the media source for the newly added file.</p>
5591
5592 <h4><a name="_Toc115416193"></a><a name="_2.3.1_Components_for_Configuration_"></a><span
5593 style='mso-bookmark:_Toc115416193'>7.2.3.1 Components for Configuration Files</span></h4>
5594
5595 <p class=PreformattedText style='text-indent:35.45pt'>CellServDB: 'cpf_CellServDB'
5596 (ID {D5BA4C15-DBEC-4292-91FC-B54C30F24F2A})</p>
5597
5598 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416194">7.2.4
5599 Adding Domain Specific Registry Keys</a></h3>
5600
5601 <p class=MsoNormal>Following is an example for adding domain specific registry
5602 keys.</p>
5603
5604 <p class=MsoNormal style='tab-stops:204.0pt'><span style='mso-spacerun:yes'>
5605 </span>Refer to <a href="#_Appendix_A:_Registry_Values">Appendix A</a> section
5606 2.1 for more information.</p>
5607
5608 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>Columns that are
5609 unspecified should be left empty.</p>
5610
5611 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>We create a new
5612 feature and component to hold the new registry keys.</p>
5613
5614 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
5615  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5616  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
5617  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
5618   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5619   <p class=MsoNormal style='mso-yfti-cnfc:1'><span style='mso-spacerun:yes'>
5620   </span>'Feature' table:</p>
5621   </td>
5622  </tr>
5623  <tr style='mso-yfti-irow:0'>
5624   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5625   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><span
5626   style='mso-tab-count:1'>      </span>(new row)<br>
5627   <span style='mso-tab-count:1'>            </span>Feature<span
5628   style='mso-tab-count:1'>            </span>: 'feaDomainKeys'<br>
5629   <span style='mso-tab-count:1'>            </span>Feature Parent<span
5630   style='mso-tab-count:1'> </span>: 'feaClient'<br>
5631   <span style='mso-tab-count:1'>            </span>Display<span
5632   style='mso-tab-count:1'>           </span>: 0<br>
5633   <span style='mso-tab-count:1'>            </span>Level<span style='mso-tab-count:
5634   2'>               </span>: 30<br>
5635   <span style='mso-tab-count:1'>            </span>Attributes<span
5636   style='mso-tab-count:1'>        </span>: 10</p>
5637   </td>
5638  </tr>
5639  <tr style='mso-yfti-irow:1'>
5640   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5641   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>'Component'
5642   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'>    </span>'FeatureComponents'
5664   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>:
5722   'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\ATHENA.MIT.EDU'<br>
5723   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5724   2'>              </span>: '*'<br>
5725   <span style='mso-tab-count:1'>            </span>Component<span
5726   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'</p>
5727   </td>
5728  </tr>
5729  <tr style='mso-yfti-irow:9'>
5730   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5731   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5732   <span style='mso-tab-count:1'>            </span>Registry<span
5733   style='mso-tab-count:1'>          </span>: 'reg_domkey3'<br>
5734   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5735   2'>                </span>: 2<br>
5736   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5737   2'>                 </span>: '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>: SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST'<br>
5755   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5756   2'>              </span>: '*'<br>
5757   <span style='mso-tab-count:1'>            </span>Component<span
5758   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'</p>
5759   </td>
5760  </tr>
5761  <tr style='mso-yfti-irow:11'>
5762   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5763   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5764   <span style='mso-tab-count:1'>            </span>Registry<span
5765   style='mso-tab-count:1'>          </span>: 'reg_domkey5'<br>
5766   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5767   2'>                </span>: 2<br>
5768   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5769   2'>                 </span>:
5770   'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST'<br>
5771   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5772   2'>              </span>: 'LogonOptions'<br>
5773   <span style='mso-tab-count:1'>            </span>Value<span style='mso-tab-count:
5774   2'>              </span>: 0<br>
5775   <span style='mso-tab-count:1'>            </span>Component<span
5776   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'</p>
5777   </td>
5778  </tr>
5779  <tr style='mso-yfti-irow:12;mso-yfti-lastrow:yes'>
5780   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5781   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5782   <span style='mso-tab-count:1'>            </span>Registry<span
5783   style='mso-tab-count:1'>          </span>: 'reg_domkey6'<br>
5784   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5785   2'>                </span>: 2<br>
5786   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5787   2'>                 </span>:
5788   'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST'<br>
5789   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5790   2'>              </span>: 'FailLoginsSilently'<br>
5791   <span style='mso-tab-count:1'>            </span>Value<span style='mso-tab-count:
5792   2'>              </span>: 1<br>
5793   <span style='mso-tab-count:1'>            </span>Component<span
5794   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'<br style='mso-special-character:
5795   line-break'>
5796   <![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'>
5797   <![endif]></p>
5798   </td>
5799  </tr>
5800 </table>
5801
5802 <p class=MsoNormal><o:p>&nbsp;</o:p></p>
5803
5804 <p class=MsoNormal>The example adds domain specific keys for 'ATHENA.MIT.EDU'
5805 (enable integrated logon) and 'LOCALHOST' (disable integrated logon and fail
5806 logins silently).</p>
5807
5808 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416195">7.2.5
5809 Adding Site Specific Freelance Registry Keys</a></h3>
5810
5811 <p class=MsoNormal>Following is an example for adding site specific Freelance
5812 registry keys to pre-populate the Mountpoints and Symlinks in the fake root.afs
5813 volume.</p>
5814
5815 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>Columns that are
5816 unspecified should be left empty.</p>
5817
5818 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>We create a new
5819 feature and component to hold the new registry keys.</p>
5820
5821 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
5822  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5823  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
5824  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
5825   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5826   <p class=MsoNormal style='mso-yfti-cnfc:1'><span style='mso-spacerun:yes'>
5827   </span>'Feature' table:</p>
5828   </td>
5829  </tr>
5830  <tr style='mso-yfti-irow:0'>
5831   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5832   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><span
5833   style='mso-tab-count:1'>      </span>(new row)<br>
5834   <span style='mso-tab-count:1'>            </span>Feature<span
5835   style='mso-tab-count:1'>            </span>: 'feaFreelanceKeys'<br>
5836   <span style='mso-tab-count:1'>            </span>Feature Parent<span
5837   style='mso-tab-count:1'> </span>: 'feaClient'<br>
5838   <span style='mso-tab-count:1'>            </span>Display<span
5839   style='mso-tab-count:1'>           </span>: 0<br>
5840   <span style='mso-tab-count:1'>            </span>Level<span style='mso-tab-count:
5841   2'>               </span>: 30<br>
5842   <span style='mso-tab-count:1'>            </span>Attributes<span
5843   style='mso-tab-count:1'>        </span>: 10</p>
5844   </td>
5845  </tr>
5846  <tr style='mso-yfti-irow:1'>
5847   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5848   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>'Component'
5849   table:</p>
5850   </td>
5851  </tr>
5852  <tr style='mso-yfti-irow:2'>
5853   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5854   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><span
5855   style='mso-tab-count:1'>      </span>(new row)<br>
5856   <span style='mso-spacerun:yes'>    </span><span style='mso-tab-count:1'>      </span>Component<span
5857   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'<br>
5858   <span style='mso-tab-count:1'>            </span>ComponentId<span
5859   style='mso-tab-count:1'>  </span>: '{4E3B3CBF4-9AE7-40C3-7B09-C48CF842C583}'<br>
5860   <span style='mso-tab-count:1'>            </span>Directory<span
5861   style='mso-tab-count:1'>         </span>: 'TARGETDIR'<br>
5862   <span style='mso-tab-count:1'>            </span>Attributes<span
5863   style='mso-tab-count:1'>        </span>: 4<br>
5864   <span style='mso-tab-count:1'>            </span>KeyPath<span
5865   style='mso-tab-count:1'>          </span>: 'reg_freekey0'</p>
5866   </td>
5867  </tr>
5868  <tr style='mso-yfti-irow:3'>
5869   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5870   <p class=MsoNormal><span style='mso-spacerun:yes'>
5871   </span>'FeatureComponents' table:</p>
5872   </td>
5873  </tr>
5874  <tr style='mso-yfti-irow:4'>
5875   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5876   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span><span
5877   style='mso-tab-count:1'>      </span>(new row)<br>
5878   <span style='mso-tab-count:1'>            </span>Feature<span
5879   style='mso-tab-count:1'>            </span>: 'feaFreelanceKeys'<br>
5880   <span style='mso-tab-count:1'>            </span>Component<span
5881   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'</p>
5882   </td>
5883  </tr>
5884  <tr style='mso-yfti-irow:5'>
5885   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5886   <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>'Registry' table:</p>
5887   </td>
5888  </tr>
5889  <tr style='mso-yfti-irow:6'>
5890   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5891   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5892   <span style='mso-tab-count:1'>            </span>Registry<span
5893   style='mso-tab-count:1'>          </span>: 'reg_freekey0'<br>
5894   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5895   2'>                </span>: 2<br>
5896   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5897   2'>                 </span>: 'SOFTWARE\OpenAFS\Client\Freelance'<br>
5898   <span style='mso-tab-count:1'>            </span>Component<span
5899   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'</p>
5900   </td>
5901  </tr>
5902  <tr style='mso-yfti-irow:7'>
5903   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5904   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5905   <span style='mso-tab-count:1'>            </span>Registry<span
5906   style='mso-tab-count:1'>          </span>: 'reg_freekey1'<br>
5907   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5908   2'>                </span>: 2<br>
5909   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5910   2'>                 </span>: 'SOFTWARE\OpenAFS\Client\Freelance'<br>
5911   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5912   2'>              </span>: '0'<br>
5913   <span style='mso-spacerun:yes'>  </span><span style='mso-tab-count:1'>         </span>Value<span
5914   style='mso-spacerun:yes'>   </span><span
5915   style='mso-spacerun:yes'>        </span><span style='mso-tab-count:1'>         </span>:
5916   'athena.mit.edu#athena.mit.edu:root.cell.'<br>
5917   <span style='mso-tab-count:1'>            </span>Component<span
5918   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'</p>
5919   </td>
5920  </tr>
5921  <tr style='mso-yfti-irow:8'>
5922   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5923   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5924   <span style='mso-tab-count:1'>            </span>Registry<span
5925   style='mso-tab-count:1'>          </span>: 'reg_freekey2'<br>
5926   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5927   2'>                </span>: 2<br>
5928   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5929   2'>                 </span>: 'SOFTWARE\OpenAFS\Client\Freelance'<br>
5930   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5931   2'>              </span>: '1'<br>
5932   <span style='mso-spacerun:yes'>   </span><span style='mso-tab-count:1'>       </span>Value<span
5933   style='mso-spacerun:yes'>           </span><span style='mso-tab-count:1'>         </span>:
5934   '.athena.mit.edu%athena.mit.edu:root.cell.'<br>
5935   <span style='mso-tab-count:1'>            </span>Component<span
5936   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'</p>
5937   </td>
5938  </tr>
5939  <tr style='mso-yfti-irow:9'>
5940   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5941   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5942   <span style='mso-tab-count:1'>            </span>Registry<span
5943   style='mso-tab-count:1'>          </span>: 'reg_freekey3'<br>
5944   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5945   2'>                </span>: 2<br>
5946   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5947   2'>                 </span>: 'SOFTWARE\OpenAFS\Client\Freelance\Symlinks'<br>
5948   <span style='mso-tab-count:1'>            </span>Component<span
5949   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'</p>
5950   </td>
5951  </tr>
5952  <tr style='mso-yfti-irow:10'>
5953   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5954   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5955   <span style='mso-tab-count:1'>            </span>Registry<span
5956   style='mso-tab-count:1'>          </span>: 'reg_freekey4'<br>
5957   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5958   2'>                </span>: 2<br>
5959   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5960   2'>                 </span>: 'SOFTWARE\OpenAFS\Client\Freelance\Symlinks'<br>
5961   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5962   2'>              </span>: '0'<br>
5963   <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'>          </span>Value<span
5964   style='mso-spacerun:yes'>           </span><span style='mso-tab-count:1'>         </span>:
5965   '<st1:GivenName w:st="on">athena</st1:GivenName>:athena.mit.edu.'<br>
5966   <span style='mso-tab-count:1'>            </span>Component<span
5967   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'</p>
5968   </td>
5969  </tr>
5970  <tr style='mso-yfti-irow:11;mso-yfti-lastrow:yes'>
5971   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5972   <p class=MsoNormal><span style='mso-tab-count:1'>            </span>(new row)<br>
5973   <span style='mso-tab-count:1'>            </span>Registry<span
5974   style='mso-tab-count:1'>          </span>: 'reg_freekey5'<br>
5975   <span style='mso-tab-count:1'>            </span>Root<span style='mso-tab-count:
5976   2'>                </span>: 2<br>
5977   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
5978   2'>                 </span>: 'SOFTWARE\OpenAFS\Client\Freelance\Symlinks'<br>
5979   <span style='mso-tab-count:1'>            </span>Name<span style='mso-tab-count:
5980   2'>              </span>: '1'<br>
5981   <span style='mso-spacerun:yes'>   </span><span style='mso-tab-count:1'>       </span>Value<span
5982   style='mso-spacerun:yes'>           </span><span style='mso-tab-count:1'>         </span>:
5983   '.athena:.athena.mit.edu.'<br>
5984   <span style='mso-tab-count:1'>            </span>Component<span
5985   style='mso-tab-count:1'>     </span>: 'rcm_FreelanceKeys'</p>
5986   </td>
5987  </tr>
5988 </table>
5989
5990 <p class=MsoNormal>The example adds a read-only mountpoint to the
5991 athena.mit.edu cell's root.afs volume as well as a read-write mountpoint.<span
5992 style='mso-spacerun:yes'>  </span>Aliases are also provided using symlinks.</p>
5993
5994 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Ref115275867"></a><a
5995 name="_Toc115416196"></a><a name="_Toc115417101"><span style='mso-bookmark:
5996 _Toc115416196'><span style='mso-bookmark:_Ref115275867'>7.3 Additional
5997 Resources</span></span></a></h2>
5998
5999 <p class=MsoNormal>If you want to add registry keys or files you need to create
6000 new components and features for those.<span style='mso-spacerun:yes'>
6001 </span>Refer to the Windows Platform SDK for details.</p>
6002
6003 <p class=MsoNormal>It is beyond the scope of this document to provide a
6004 comprehensive overview of how to add new resources through a transform.<span
6005 style='mso-spacerun:yes'>  </span>Please refer to the &quot;Windows
6006 Installer&quot; documentation for details.<span style='mso-spacerun:yes'>
6007 </span>The relevant section is at :</p>
6008
6009 <p class=MsoNormal>http://msdn.microsoft.com/library/en-us/msi/setup/using_transforms_to_add_resources.asp</p>
6010
6011 <p class=MsoNormal>A sample walkthrough of adding a new configuration file is
6012 in section 2.3.</p>
6013
6014 <p class=MsoNormal>Add new features under the 'feaClient' or 'feaServer' as
6015 appropriate and set the 'Level' column for those features to equal the 'Level'
6016 for their parent features for consistency.<span style='mso-spacerun:yes'>
6017 </span>Note that none of the features in the OpenAFS for Windows MSI package
6018 are designed to be installed to run from 'source' or 'advertised'.<span
6019 style='mso-spacerun:yes'>  </span>It is recommended that you set
6020 'msidbFeatureAttributesFavorLocal' (0), 'msidbFeatureAttributesFollowParent'
6021 (2) and 'msidbFeatureAttributesDisallowAdvertise' (8) attributes for new
6022 features.</p>
6023
6024 <p class=MsoNormal>If you are creating new components, retain the same
6025 component GUID when creating new transforms against new releases of the OpenAFS
6026 MSI package.</p>
6027
6028 <p class=MsoNormal>After making the adjustments to the MSI database using
6029 ORCA.EXE you can generate a transform with MSITRAN.EXE as follows :</p>
6030
6031 <p class=MsoNormal>(Modified MSI package is 'openafs-en_US_new.msi' and the
6032 original MSI package is 'openafs-en_US.msi'.<span style='mso-spacerun:yes'>
6033 </span>Generates transform 'openafs-transform.mst')</p>
6034
6035 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>&gt; msitran.exe
6036 -g openafs-en_US.msi openafs-en_US_new.msi openafs-transform.mst</p>
6037
6038 <p class=MsoNormal>See the Platform SDK documentation for information on
6039 command line options for MSITRAN.EXE.</p>
6040
6041 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416197"></a><a
6042 name="_Toc115417102"><span style='mso-bookmark:_Toc115416197'>7.4. Upgrades</span></a></h2>
6043
6044 <p class=MsoNormal>The MSI package is designed to replace (or uninstall)
6045 previous versions of OpenAFS for Windows during installation.<span
6046 style='mso-spacerun:yes'>  </span>Previous versions are installations that used
6047 the NSIS (.EXE) installer or an MSI that has a known Upgrade Code and a
6048 different Product Code. <span style='mso-spacerun:yes'> </span>The MSI does not
6049 directly upgrade an existing installation.<span style='mso-spacerun:yes'>
6050 </span>This is intentional and ensures that development releases which do not
6051 have strictly increasing version numbers are properly upgraded.</p>
6052
6053 <p class=MsoNormal>Versions of OpenAFS that are upgraded by the MSI package
6054 are:</p>
6055
6056 <p class=MsoNormal style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:l12 level1 lfo34;
6057 tab-stops:list 36.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
6058 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1)<span
6059 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>OpenAFS
6060 MSI package<br>
6061 Upgrade code {6823EEDD-84FC-4204-ABB3-A80D25779833}<br>
6062 All versions regardless of Product Code</p>
6063
6064 <p class=MsoNormal style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:l12 level1 lfo34;
6065 tab-stops:list 36.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
6066 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2)<span
6067 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>MIT's
6068 Transarc AFS MSI package<br>
6069 Upgrade code {5332B94F-DE38-4927-9EAB-51F4A64193A7}<br>
6070 All versions up to 3.6.2</p>
6071
6072 <p class=MsoNormal style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:l12 level1 lfo34;
6073 tab-stops:list 36.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
6074 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3)<span
6075 style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>OpenAFS
6076 NSIS package<br>
6077 All versions</p>
6078
6079 <p class=MsoNormal>Note that versions of the OpenAFS NSIS package prior to
6080 1.3.65 had a bug where it couldn't be uninstalled properly in unattended
6081 mode.<span style='mso-spacerun:yes'>  </span>Therefore the MSI package will not
6082 try to uninstall an OpenAFS NSIS package if running unattended.<span
6083 style='mso-spacerun:yes'>  </span>This means that group policy based
6084 deployments will fail on machines that have the OpenAFS NSIS package installed.</p>
6085
6086 <p class=MsoNormal>If you have used a different MSI package to install OpenAFS
6087 and wish to upgrade it you can author rows into the 'Upgrade' table as
6088 described in the Platform SDK.</p>
6089
6090 <p class=MsoNormal>When performing an upgrade with msiexec.exe execute the MSI
6091 with the repair options &quot;vomus&quot;.</p>
6092
6093 <h3 style='margin-left:0pt;text-indent:0pt'>7.4.1. OpenAFS MSI Product Codes</h3>
6094
6095 <h4>Release 1.3<o:p></o:p></h4>
6096
6097 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
6098  style='border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;
6099  mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;mso-border-insideh:
6100  .5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
6101  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes'>
6102   <td width=118 valign=top style='width:88.55pt;border:solid windowtext 1.0pt;
6103   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6104   <p class=PreformattedText>i386_w2k<span style='mso-spacerun:yes'>   </span></p>
6105   </td>
6106   <td width=481 valign=top style='width:361.05pt;border:solid windowtext 1.0pt;
6107   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
6108   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6109   <p class=PreformattedText>{CCAF9E14-976E-46C0-8A1B-A218EAB7ADC5}</p>
6110   </td>
6111  </tr>
6112 </table>
6113
6114 <h4>Release 1.4<o:p></o:p></h4>
6115
6116 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
6117  style='border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;
6118  mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;mso-border-insideh:
6119  .5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
6120  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
6121   <td width=118 valign=top style='width:88.55pt;border:solid windowtext 1.0pt;
6122   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6123   <p class=PreformattedText>amd64_w2k<span style='mso-spacerun:yes'>   </span></p>
6124   </td>
6125   <td width=481 valign=top style='width:361.05pt;border:solid windowtext 1.0pt;
6126   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
6127   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6128   <p class=PreformattedText>{CC59770C-4690-4531-BAEB-55A5A6D2EEB9}</p>
6129   </td>
6130  </tr>
6131  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
6132   <td width=118 valign=top style='width:88.55pt;border:solid windowtext 1.0pt;
6133   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6134   padding:0pt 5.4pt 0pt 5.4pt'>
6135   <p class=PreformattedText>i386_w2k<span style='mso-spacerun:yes'>    </span></p>
6136   </td>
6137   <td width=481 valign=top style='width:361.05pt;border-top:none;border-left:
6138   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6139   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6140   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6141   <p class=PreformattedText>{B2220B3E-B61D-4CC7-9D4B-17BA918D049C}</p>
6142   </td>
6143  </tr>
6144 </table>
6145
6146 <h4>Release 1.5<o:p></o:p></h4>
6147
6148 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
6149  style='border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;
6150  mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;mso-border-insideh:
6151  .5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
6152  <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
6153   <td width=118 valign=top style='width:88.55pt;border:solid windowtext 1.0pt;
6154   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6155   <p class=PreformattedText>amd64_w2k<span style='mso-spacerun:yes'>   </span></p>
6156   </td>
6157   <td width=485 valign=top style='width:363.45pt;border:solid windowtext 1.0pt;
6158   border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
6159   solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6160   <p class=PreformattedText>{A0A7B986-CF35-499C-9400-9A987F218127}</p>
6161   </td>
6162  </tr>
6163  <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
6164   <td width=118 valign=top style='width:88.55pt;border:solid windowtext 1.0pt;
6165   border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6166   padding:0pt 5.4pt 0pt 5.4pt'>
6167   <p class=PreformattedText>i386_w2k<span style='mso-spacerun:yes'>    </span></p>
6168   </td>
6169   <td width=485 valign=top style='width:363.45pt;border-top:none;border-left:
6170   none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6171   mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6172   mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6173   <p class=PreformattedText>{E832F832-C937-46BC-8C1D-BC7EF6F3F62F}</p>
6174   </td>
6175  </tr>
6176 </table>
6177
6178 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417116"></a><a
6179 name="_Toc115417103"></a><a name="_Toc115416198"></a><a
6180 name="_Appendix_A:_Registry_Values"></a><![if !supportLists]><span
6181 style='mso-bookmark:_Toc115417116'><span style='mso-bookmark:_Toc115417103'><span
6182 style='mso-bookmark:_Toc115416198'></span></span></span><![endif]><span
6183 style='mso-bookmark:_Toc115417116'><span style='mso-bookmark:_Toc115417103'><span
6184 style='mso-bookmark:_Toc115416198'>Appendix A: Registry Values</span></span></span></h1>
6185
6186 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416199"></a><a
6187 name="_Toc115417104"><span style='mso-bookmark:_Toc115416199'>A.1. Service
6188 parameters</span></a></h2>
6189
6190 <p class=MsoBodyText>The service parameters primarily affect the behavior of
6191 the AFS client service (afsd_service.exe).</p>
6192
6193 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416200">Regkey:<br>
6194 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</a></h3>
6195
6196 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6197  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6198  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6199  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:145.25pt'>
6200   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6201   height:145.25pt'>
6202   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416201">Value: LANadapter</a></h5>
6203   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD<br>
6204   Default: -1<br>
6205   Variable: LANadapter</p>
6206   <p class=MsoBodyText style='mso-yfti-cnfc:1'>LAN adapter number to use.<span
6207   style='mso-spacerun:yes'>  </span>This is the lana number of the LAN adapter that
6208   the SMB server should bind to.<span style='mso-spacerun:yes'>  </span>If
6209   unspecified or set to -1, a LAN adapter with named 'AFS' or a loopback
6210   adapter will be selected.<span style='mso-spacerun:yes'>  </span>If neither
6211   are present, then all available adapters will be bound to.<span
6212   style='mso-spacerun:yes'>  </span>When binding to a non-loopback adapter, the
6213   NetBIOS name hostname%-AFS' will be used (where %hostname% is the NetBIOS
6214   name of the host truncated to 11 characters). Otherwise, the NetBIOS name
6215   will be 'AFS'.</p>
6216   </td>
6217  </tr>
6218  <tr style='mso-yfti-irow:0;height:79.25pt'>
6219   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6220   height:79.25pt'>
6221   <h5><a name="_Toc115416202"></a><a name="_Value___:_CacheSize"></a><span
6222   style='mso-bookmark:_Toc115416202'>Value: CacheSize</span></h5>
6223   <p class=MsoBodyText>Type: DWORD<br>
6224   Default: 98304 (CM_CONFIGDEFAULT_CACHESIZE)<br>
6225   Variable: cm_initParams.cacheSize</p>
6226   <p class=MsoBodyText>Size of the AFS cache in 1k blocks.</p>
6227   </td>
6228  </tr>
6229  <tr style='mso-yfti-irow:1;height:79.25pt'>
6230   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6231   height:79.25pt'>
6232   <h5><a name="_Toc115416203">Value: ChunkSize</a></h5>
6233   <p class=MsoBodyText>Type: DWORD<br>
6234   Default: 17 (CM_CONFIGDEFAULT_CHUNKSIZE)<br>
6235   Variable: cm_logChunkSize (cm_chunkSize = 1 &lt;&lt; cm_logChunkSize)</p>
6236   <p class=MsoBodyText>Size of chunk for reading and writing. Actual chunk size
6237   is 2^cm_logChunkSize.</p>
6238   </td>
6239  </tr>
6240  <tr style='mso-yfti-irow:2;height:92.0pt'>
6241   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6242   height:92.0pt'>
6243   <h5><a name="_Toc115416204">Value: Daemons</a></h5>
6244   <p class=MsoBodyText>Type: DWORD<br>
6245   Default: 2 (CM_CONFIGDEFAULT_DAEMONS)<br>
6246   Variable: numBkgD</p>
6247   <p class=MsoBodyText>Number of background daemons (number of threads of
6248   cm_BkgDaemon). (see cm_BkgDaemon in cm_daemon.c)</p>
6249   </td>
6250  </tr>
6251  <tr style='mso-yfti-irow:3;height:92.0pt'>
6252   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6253   height:92.0pt'>
6254   <h5><a name="_Toc115416205">Value: ServerThreads</a></h5>
6255   <p class=MsoBodyText>Type: DWORD<br>
6256   Default: 25 (CM_CONFIGDEFAULT_SVTHREADS)<br>
6257   Variable: numSvThreads</p>
6258   <p class=MsoBodyText>Number of SMB server threads (number of threads of
6259   smb_Server). (see smb_Server in smb.c).</p>
6260   </td>
6261  </tr>
6262  <tr style='mso-yfti-irow:4;height:79.25pt'>
6263   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6264   height:79.25pt'>
6265   <h5><a name="_Toc115416206">Value: Stats</a></h5>
6266   <p class=MsoBodyText>Type: DWORD<br>
6267   Default: 10000 (CM_CONFIGDEFAULT_STATS)<br>
6268   Variable: cm_initParams.nStatCaches</p>
6269   <p class=MsoBodyText>Cache configuration.</p>
6270   </td>
6271  </tr>
6272  <tr style='mso-yfti-irow:5;height:78.5pt'>
6273   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6274   height:78.5pt'>
6275   <h5><a name="_Toc115416207"></a><a name="_Value_:_LogoffPreserveTokens"></a><span
6276   style='mso-bookmark:_Toc115416207'>Value: LogoffPreserveTokens</span></h5>
6277   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6278   Default : 0</p>
6279   <p class=MsoBodyText>If enabled (set to 1), the Logoff Event handler will not
6280   attempt to delete the user's tokens<span style='mso-spacerun:yes'>  </span>if
6281   the user's profile is stored outside of AFS.</p>
6282   </td>
6283  </tr>
6284  <tr style='mso-yfti-irow:6;height:79.25pt'>
6285   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6286   height:79.25pt'>
6287   <h5><a name="_Toc115416208">Value: RootVolume</a></h5>
6288   <p class=MsoBodyText>Type: REG_SZ<br>
6289   Default: &quot;root.afs&quot;<br>
6290   Variable: cm_rootVolumeName</p>
6291   <p class=MsoBodyText>Root volume name.</p>
6292   </td>
6293  </tr>
6294  <tr style='mso-yfti-irow:7;height:145.25pt'>
6295   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6296   height:145.25pt'>
6297   <h5><a name="_Toc115416209"></a><a name="_Value_:_Mountroot"></a><span
6298   style='mso-bookmark:_Toc115416209'>Value: Mountroot</span></h5>
6299   <p class=MsoBodyText>Type: REG_SZ<br>
6300   Default: &quot;/afs&quot;<br>
6301   Variable: cm_mountRoot</p>
6302   <p class=MsoBodyText>Name of root mount point.<span
6303   style='mso-spacerun:yes'>  </span>In symlinks, if a path starts with
6304   cm_mountRoot, it is assumed that the path is absolute (as opposed to
6305   relative) and is adjusted accordingly. Eg: if a path is specified as
6306   /afs/athena.mit.edu/foo/bar/baz and cm_mountRoot is &quot;/afs&quot;, then
6307   the path is interpreted as \\afs\all\athena.mit.edu\foo\bar\baz.<span
6308   style='mso-spacerun:yes'>  </span>If a path does not start with with
6309   cm_mountRoot, the path is assumed to be relative and suffixed to the
6310   reference directory (i.e. directory where the symlink exists)</p>
6311   </td>
6312  </tr>
6313  <tr style='mso-yfti-irow:8;height:92.0pt'>
6314   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6315   height:92.0pt'>
6316   <h5><a name="_Toc115416210"></a><a name="_Value_:_CachePath"></a><span
6317   style='mso-bookmark:_Toc115416210'>Value: CachePath</span></h5>
6318   <p class=MsoBodyText>Type: REG_SZ or REG_EXPAND_SZ<br>
6319   Default: &quot;%TEMP%\AFSCache&quot;<br>
6320   Variable: cm_CachePath</p>
6321   <p class=MsoBodyText>Location of on-disk cache file.<span
6322   style='mso-spacerun:yes'>  </span>The default is the SYSTEM account's TEMP
6323   directory.<span style='mso-spacerun:yes'>  </span>The attributes assigned to
6324   the file are HIDDEN and SYSTEM.</p>
6325   </td>
6326  </tr>
6327  <tr style='mso-yfti-irow:9;height:119.0pt'>
6328   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6329   height:119.0pt'>
6330   <h5><a name="_Toc115416211">Value: NonPersistentCaching</a></h5>
6331   <p class=MsoBodyText>Type: DWORD [0..1]<br>
6332   Default: 0<br>
6333   Variable: buf_CacheType</p>
6334   <p class=MsoBodyText>When this registry value is set to a non-zero value, the
6335   CachePath value is ignored and the cache data is stored in the windows paging
6336   file.<span style='mso-spacerun:yes'>  </span>This prevents the use of
6337   persistent caching (when available) as well as the ability to alter the size
6338   of the cache at runtime using the &quot;fs setcachesize&quot; command.</p>
6339   </td>
6340  </tr>
6341  <tr style='mso-yfti-irow:10;height:125.5pt'>
6342   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6343   height:125.5pt'>
6344   <h5><a name="_Toc115416212">Value: ValidateCache</a></h5>
6345   <p class=MsoBodyText>Type: DWORD [0..2]<br>
6346   Default: 1<br>
6347   Variable: buf_CacheType</p>
6348   <p class=MsoBodyText>This value determines if and when persistent cache
6349   validation is performed.</p>
6350   <p class=MsoBodyText>0 - Validation is disabled<br>
6351   1 - Validation is performed at startup<br>
6352   2 - Validation is performed at shutdown</p>
6353   </td>
6354  </tr>
6355  <tr style='mso-yfti-irow:11;height:79.25pt'>
6356   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6357   height:79.25pt'>
6358   <h5><a name="_Toc115416213">Value: TrapOnPanic</a></h5>
6359   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6360   Default: 0<br>
6361   Variable: traceOnPanic</p>
6362   <p class=MsoBodyText>Issues a breakpoint in the event of a panic.
6363   (breakpoint: _asm int 3).</p>
6364   </td>
6365  </tr>
6366  <tr style='mso-yfti-irow:12;height:92.0pt'>
6367   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6368   height:92.0pt'>
6369   <h5><a name="_Toc115416214"></a><a name="_Value___:_NetbiosName"></a><span
6370   style='mso-bookmark:_Toc115416214'>Value: NetbiosName</span></h5>
6371   <p class=MsoBodyText>Type: REG_EXPAND_SZ<br>
6372   Default: &quot;AFS&quot;<br>
6373   Variable: cm_NetbiosName</p>
6374   <p class=MsoBodyText>Specifies the NetBIOS name to be used when binding to a
6375   Loopback adapter.<span style='mso-spacerun:yes'>  </span>To provide the old
6376   behavior specify a value of<span style='mso-spacerun:yes'>
6377   </span>&quot;%COMPUTERNAME%-AFS&quot;.</p>
6378   </td>
6379  </tr>
6380  <tr style='mso-yfti-irow:13;height:152.0pt'>
6381   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6382   height:152.0pt'>
6383   <h5><a name="_Toc115416215">Value: IsGateway</a></h5>
6384   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6385   Default: 0<br>
6386   Variable: isGateway</p>
6387   <p class=MsoBodyText>Select whether or not this AFS client should act as a
6388   gateway.<span style='mso-spacerun:yes'>  </span>If set and the NetBIOS name
6389   hostname-AFS is bound to a physical NIC, other machines in the subnet can
6390   access AFS via SMB connections to hostname-AFS.</p>
6391   <p class=MsoBodyText>When IsGateway is non-zero, the LAN adapter detection
6392   code will avoid binding to a loopback adapter.<span
6393   style='mso-spacerun:yes'>  </span>This will ensure that the NetBIOS name will
6394   be of the form hostname-AFS instead of the value set by the
6395   &quot;NetbiosName&quot; registry value.</p>
6396   </td>
6397  </tr>
6398  <tr style='mso-yfti-irow:14;height:92.0pt'>
6399   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6400   height:92.0pt'>
6401   <h5><a name="_Toc115416216">Value: ReportSessionStartups</a></h5>
6402   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6403   Default: 0<br>
6404   Variable: reportSessionStartups</p>
6405   <p class=MsoBodyText>If enabled, all SMB sessions created are recorded in the
6406   Application event log.<span style='mso-spacerun:yes'>  </span>This also
6407   enables other events such as drive mappings or various error types to be
6408   logged.</p>
6409   </td>
6410  </tr>
6411  <tr style='mso-yfti-irow:15;height:79.25pt'>
6412   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6413   height:79.25pt'>
6414   <h5><a name="_Toc115416217"></a><a name="_Value_:_TraceBufferSize"></a><span
6415   style='mso-bookmark:_Toc115416217'>Value: TraceBufferSize</span></h5>
6416   <p class=MsoBodyText>Type: DWORD<br>
6417   Default: 5000 (CM_CONFIGDEFAULT_TRACEBUFSIZE)<br>
6418   Variable: traceBufSize</p>
6419   <p class=MsoBodyText>Number of entries to keep in trace log.</p>
6420   </td>
6421  </tr>
6422  <tr style='mso-yfti-irow:16;height:92.0pt'>
6423   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6424   height:92.0pt'>
6425   <h5><a name="_Toc115416218"></a><a name="_Value_:_SysName"></a><span
6426   style='mso-bookmark:_Toc115416218'>Value: SysName</span></h5>
6427   <p class=MsoBodyText>Type: REG_SZ<br>
6428   Default: &quot;i386_nt40&quot;<br>
6429   Variable: cm_sysName</p>
6430   <p class=MsoBodyText>Provides an initial value for &quot;fs
6431   sysname&quot;.<span style='mso-spacerun:yes'>  </span>The string can contain
6432   one or more replacement values for @sys in order of preference separated by
6433   whitespace.</p>
6434   </td>
6435  </tr>
6436  <tr style='mso-yfti-irow:17;height:79.25pt'>
6437   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6438   height:79.25pt'>
6439   <h5><a name="_Toc115416219"></a><a name="_Value_:_SecurityLevel"></a><span
6440   style='mso-bookmark:_Toc115416219'>Value: SecurityLevel</span></h5>
6441   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6442   Default: 0<br>
6443   Variable: cryptall</p>
6444   <p class=MsoBodyText>Enables encryption on RX calls.</p>
6445   </td>
6446  </tr>
6447  <tr style='mso-yfti-irow:18;height:112.25pt'>
6448   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6449   height:112.25pt'>
6450   <h5><a name="_Toc115416220"></a><a name="_Value_:_UseDNS"></a><span
6451   style='mso-bookmark:_Toc115416220'>Value: UseDNS</span></h5>
6452   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6453   Default: 1<br>
6454   Variable: cm_dnsEnabled</p>
6455   <p class=MsoBodyText>Enables resolving volservers using AFSDB DNS queries.</p>
6456   <p class=MsoBodyText>As of 1.3.60, this value is ignored as the DNS query
6457   support utilizes the Win32 DNSQuery API which is available on Win2000 and
6458   above.</p>
6459   </td>
6460  </tr>
6461  <tr style='mso-yfti-irow:19;height:79.25pt'>
6462   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6463   height:79.25pt'>
6464   <h5><a name="_Toc115416221"></a><a name="_Value_:_FreelanceClient"></a><span
6465   style='mso-bookmark:_Toc115416221'>Value: FreelanceClient</span></h5>
6466   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6467   Default: 0<br>
6468   Variable: cm_freelanceEnabled</p>
6469   <p class=MsoBodyText>Enables freelance client.</p>
6470   </td>
6471  </tr>
6472  <tr style='mso-yfti-irow:20;height:92.0pt'>
6473   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6474   height:92.0pt'>
6475   <h5><a name="_Toc115416222"></a><a name="_Value_:_HideDotFiles"></a><span
6476   style='mso-bookmark:_Toc115416222'>Value: HideDotFiles</span></h5>
6477   <p class=MsoBodyText>Type: DWORD {1,0}<br>
6478   Default: 1<br>
6479   Variable: smb_hideDotFiles</p>
6480   <p class=MsoBodyText>Enables marking dotfiles with the hidden attribute.<span
6481   style='mso-spacerun:yes'>  </span>Dot files are files whose name starts with
6482   a period (excluding &quot;.&quot; and &quot;..&quot;).</p>
6483   </td>
6484  </tr>
6485  <tr style='mso-yfti-irow:21;height:79.25pt'>
6486   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6487   height:79.25pt'>
6488   <h5><a name="_Toc115416223">Value: MaxMpxRequests</a></h5>
6489   <p class=MsoBodyText>Type: DWORD<br>
6490   Default: 50<br>
6491   Variable: smb_maxMpxRequests</p>
6492   <p class=MsoBodyText>Maximum number of multiplexed SMB requests that can be
6493   made.</p>
6494   </td>
6495  </tr>
6496  <tr style='mso-yfti-irow:22;height:79.25pt'>
6497   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6498   height:79.25pt'>
6499   <h5><a name="_Toc115416224">Value: MaxVCPerServer</a></h5>
6500   <p class=MsoBodyText>Type: DWORD<br>
6501   Default: 100<br>
6502   Variable: smb_maxVCPerServer</p>
6503   <p class=MsoBodyText>Maximum number of SMB virtual circuits.</p>
6504   </td>
6505  </tr>
6506  <tr style='mso-yfti-irow:23;height:79.25pt'>
6507   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6508   height:79.25pt'>
6509   <h5><a name="_Toc115416225"></a><a name="_Value_:_Cell"></a><span
6510   style='mso-bookmark:_Toc115416225'>Value: Cell</span></h5>
6511   <p class=MsoBodyText>Type: REG_SZ<br>
6512   Default: &lt;none&gt;<br>
6513   Variable: rootCellName</p>
6514   <p class=MsoBodyText>Name of root cell (the cell from which root.afs should
6515   be mounted in \\afs\all).</p>
6516   </td>
6517  </tr>
6518  <tr style='mso-yfti-irow:24;height:79.25pt'>
6519   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6520   height:79.25pt'>
6521   <h5><a name="_Toc115416226">Value: RxNoJumbo</a></h5>
6522   <p class=MsoBodyText>Type: DWORD {0,1}<br>
6523   Default: 0<br>
6524   Variable: rx_nojumbo</p>
6525   <p class=MsoBodyText>If enabled, does not send or indicate that we are able
6526   to send or receive RX jumbograms.</p>
6527   </td>
6528  </tr>
6529  <tr style='mso-yfti-irow:25;height:124.75pt'>
6530   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6531   height:124.75pt'>
6532   <h5><a name="_Toc115416227"></a><a name="_Value_:_RxMaxMTU"></a><span
6533   style='mso-bookmark:_Toc115416227'>Value: RxMaxMTU</span></h5>
6534   <p class=MsoBodyText>Type: DWORD<br>
6535   Default: -1<br>
6536   Variable: rx_mtu</p>
6537   <p class=MsoBodyText>If set to anything other than -1, uses that value as the
6538   maximum MTU supported by the RX interface.</p>
6539   <p class=MsoBodyText>In order to enable OpenAFS to operate across the Cisco
6540   IPSec VPN client, this value must be set to 1264 or smaller.</p>
6541   </td>
6542  </tr>
6543  <tr style='mso-yfti-irow:26;height:151.75pt'>
6544   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6545   height:151.75pt'>
6546   <h5><a name="_Toc115416228">Value: ConnDeadTimeout</a></h5>
6547   <p class=MsoBodyText>Type: DWORD<br>
6548   Default: 60 (seconds)<br>
6549   Variable: ConnDeadtimeout</p>
6550   <p class=MsoBodyText>The Connection Dead Time is enforced to be at a minimum
6551   15 seconds longer than the minimum SMB timeout as specified by
6552   [HKLM\SYSTEM\CurrentControlSet\Services\lanmanworkstation\parameters]
6553   SessTimeout</p>
6554   <p class=MsoBodyText>If the minimum SMB timeout is not specified the value is
6555   45 seconds.<span style='mso-spacerun:yes'>  </span>See <a
6556   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>
6557   </td>
6558  </tr>
6559  <tr style='mso-yfti-irow:27;height:92.0pt'>
6560   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6561   height:92.0pt'>
6562   <h5><a name="_Toc115416229">Value: HardDeadTimeout</a></h5>
6563   <p class=MsoBodyText>Type: DWORD<br>
6564   Default: 120 (seconds)<br>
6565   Variable: HardDeadtimeout</p>
6566   <p class=MsoBodyText>The Hard Dead Time is enforced to be at least double the
6567   ConnDeadTimeout.<span style='mso-spacerun:yes'>  </span>The provides an
6568   opportunity for at least one retry.</p>
6569   </td>
6570  </tr>
6571  <tr style='mso-yfti-irow:28;height:158.5pt'>
6572   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6573   height:158.5pt'>
6574   <h5><a name="_Toc115416230"></a><a name="_Value__:_TraceOption"></a><span
6575   style='mso-bookmark:_Toc115416230'>Value: TraceOption</span></h5>
6576   <p class=MsoBodyText>Type: DWORD {0-15}<br>
6577   Default: 0</p>
6578   <p class=MsoBodyText>Enables logging of debug output to the Windows Event
6579   Log.</p>
6580   <p class=MsoBodyText>Bit 0 enables logging of &quot;Logon Events&quot; processed
6581   by the Network Provider and Winlogon Event Notification Handler.<span
6582   style='mso-spacerun:yes'>  </span></p>
6583   <p class=MsoBodyText>Bit 1 enables logging of events captured by the AFS
6584   Client Service.</p>
6585   <p class=MsoBodyText>Bit 2 enables real-time viewing of &quot;fs trace&quot;
6586   logging with DbgView or similar tools.</p>
6587   <p class=MsoBodyText>Bit 3 enables &quot;fs trace&quot; logging on startup.</p>
6588   </td>
6589  </tr>
6590  <tr style='mso-yfti-irow:29;height:98.5pt'>
6591   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6592   height:98.5pt'>
6593   <h5><a name="_Toc115416231">Value: AllSubmount</a></h5>
6594   <p class=MsoBodyText>Type: DWORD {0, 1}<br>
6595   Default: 1</p>
6596   <p class=MsoBodyText>Variable: allSubmount (smb.c)</p>
6597   <p class=MsoBodyText>By setting this value to 0, the
6598   &quot;\\NetbiosName\all&quot; mount point will not be created.<span
6599   style='mso-spacerun:yes'>  </span>This allows the read-write versions of
6600   root.afs to be hidden.</p>
6601   </td>
6602  </tr>
6603  <tr style='mso-yfti-irow:30;height:78.5pt'>
6604   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6605   height:78.5pt'>
6606   <h5><a name="_Toc115416232"></a><a name="_Value___:_NoFindLanaByName"></a><span
6607   style='mso-bookmark:_Toc115416232'>Value: NoFindLanaByName</span></h5>
6608   <p class=MsoBodyText>Type: DWORD {0, 1}<br>
6609   Default: 0</p>
6610   <p class=MsoBodyText>Disables the attempt to identity the network adapter to
6611   use by looking for an adapter with a display name of &quot;AFS&quot;.</p>
6612   </td>
6613  </tr>
6614  <tr style='mso-yfti-irow:31;height:78.5pt'>
6615   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6616   height:78.5pt'>
6617   <h5><a name="_Toc115416233">Value: MaxCPUs</a></h5>
6618   <p class=MsoBodyText>Type: DWORD {1..32} or {1..64} depending on the
6619   architecture<br>
6620   Default: &lt;no default&gt;</p>
6621   <p class=MsoBodyText>If this value is specified, afsd_service.exe will
6622   restrict itself to executing on the specified number of CPUs if there are a
6623   greater number installed in the machine.<span style='mso-spacerun:yes'>
6624   </span></p>
6625   </td>
6626  </tr>
6627  <tr style='mso-yfti-irow:32;height:151.75pt'>
6628   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6629   height:151.75pt'>
6630   <h5><a name="_Toc115416234"></a><a name="_Value___:_smbAuthType"></a><span
6631   style='mso-bookmark:_Toc115416234'>Value: smbAuthType</span></h5>
6632   <p class=MsoBodyText>Type: DWORD {0..2}<br>
6633   Default: 2</p>
6634   <p class=MsoBodyText>If this value is specified, it defines the type of SMB
6635   authentication which must be present in order for the Windows SMB client to
6636   connect to the AFS Client Service's SMB server.<span
6637   style='mso-spacerun:yes'>  </span>The values are:</p>
6638   <p class=MsoBodyText>0 = No authentication required<br>
6639   1 = NTLM authentication required<br>
6640   2 = Extended (GSS SPNEGO) authentication required<br>
6641   The default is Extended authentication</p>
6642   </td>
6643  </tr>
6644  <tr style='mso-yfti-irow:33;height:92.0pt'>
6645   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6646   height:92.0pt'>
6647   <h5><a name="_Toc115416235"></a><a name="_Value___:_MaxLogSize"></a><span
6648   style='mso-bookmark:_Toc115416235'>Value: MaxLogSize</span></h5>
6649   <p class=MsoBodyText>Type: DWORD {0 .. MAXDWORD}<br>
6650   Default: 100K</p>
6651   <p class=MsoBodyText>This entry determines the maximum size of the
6652   %WINDIR%\TEMP\afsd_init.log file.<span style='mso-spacerun:yes'>  </span>If
6653   the file is larger than this value when afsd_service.exe starts the file will
6654   be reset to 0 bytes.<span style='mso-spacerun:yes'>  </span>If this value is
6655   0, it means the file should be allowed to grow indefinitely.</p>
6656   </td>
6657  </tr>
6658  <tr style='mso-yfti-irow:34;mso-yfti-lastrow:yes;height:65.75pt'>
6659   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6660   height:65.75pt'>
6661   <h5><a name="_Toc115416236">Value: FlushOnHibernate</a></h5>
6662   <p class=MsoBodyText>Type: DWORD {0,1}<br>
6663   Default: 1</p>
6664   <p class=MsoBodyText>If set, flushes all volumes before the machine goes on
6665   hibernate or stand-by.</p>
6666   </td>
6667  </tr>
6668 </table>
6669
6670 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416237">Regkey:<br>
6671 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters\GlobalAutoMapper]</a></h3>
6672
6673 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6674  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6675  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6676  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6677   height:65.0pt'>
6678   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6679   height:65.0pt'>
6680   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416238">Value: &lt;Drive
6681   Letter:&gt; for example &quot;G:&quot;</a></h5>
6682   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ</p>
6683   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Specifies the submount name to
6684   be mapped by afsd_service.exe at startup to the provided drive letter.</p>
6685   </td>
6686  </tr>
6687 </table>
6688
6689 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416239">Regkey:<br>
6690 [HKLM\SOFTWARE\OpenAFS\Client]</a></h3>
6691
6692 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6693  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6694  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6695  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:78.5pt'>
6696   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6697   height:78.5pt'>
6698   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416240"></a><a
6699   name="_Value___:_CellServDBDir"></a><span style='mso-bookmark:_Toc115416240'>Value:
6700   CellServDBDir</span></h5>
6701   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
6702   Default: &lt;not defined&gt;</p>
6703   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Specifies the directory containing
6704   the CellServDB file.<span style='mso-spacerun:yes'>  </span>When this value
6705   is not specified, the AFS Client install directory is used.</p>
6706   </td>
6707  </tr>
6708  <tr style='mso-yfti-irow:0;height:145.25pt'>
6709   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6710   height:145.25pt'>
6711   <h5><a name="_Toc115416241"></a><a name="_Value___:_VerifyServiceSignature"></a><span
6712   style='mso-bookmark:_Toc115416241'>Value: VerifyServiceSignature</span></h5>
6713   <p class=MsoBodyText>Type: REG_DWORD<br>
6714   Default: 0x1</p>
6715   <p class=MsoBodyText>This value can be used to disable the runtime
6716   verification of the digital signatures applied to afsd_service.exe and the
6717   OpenAFS DLLs it loads.<span style='mso-spacerun:yes'>  </span>This test is
6718   performed to verify that<span style='mso-spacerun:yes'>   </span>the DLLs
6719   which are loaded by afsd_service.exe are from the same distribution as
6720   afsd_service.exe.<span style='mso-spacerun:yes'>  </span>This is to prevent
6721   random errors caused when DLLs from one distribution of AFS are loaded by
6722   another one.<span style='mso-spacerun:yes'>  </span>This is not a security
6723   test.<span style='mso-spacerun:yes'>  </span>The reason for disabling this
6724   test is to free up additional memory which can be used for a large cache
6725   size.</p>
6726   </td>
6727  </tr>
6728  <tr style='mso-yfti-irow:1;height:105.5pt'>
6729   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6730   height:105.5pt'>
6731   <h5><a name="_Toc115416242"></a><a name="_Value___:_IoctlDebug"></a><span
6732   style='mso-bookmark:_Toc115416242'>Value: IoctlDebug</span></h5>
6733   <p class=MsoBodyText>Type: REG_DWORD<br>
6734   Default: 0x0</p>
6735   <p class=MsoBodyText>This value can be used to debug the cause of pioctl()
6736   failures.<span style='mso-spacerun:yes'>  </span>Set a non-zero value and the
6737   pioctl() library will output status information to stdout.<span
6738   style='mso-spacerun:yes'>  </span>Executing command line tools such as
6739   tokens.exe, fs.exe, etc can then be used to determine why the pioctl() call
6740   is failing. </p>
6741   </td>
6742  </tr>
6743  <tr style='mso-yfti-irow:2;height:330.75pt'>
6744   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6745   height:330.75pt'>
6746   <h5><a name="_Toc115416243">Value: MiniDumpType</a></h5>
6747   <p class=MsoBodyText>Type: REG_DWORD<br>
6748   Default: 0x0 (MiniDumpNormal)</p>
6749   <p class=MsoBodyText>This value is used to specify the type of minidump
6750   generated by afsd_service.exe either when the process crashes or when a user
6751   initiated is dump file is generated with the &quot;fs.exe minidump&quot;
6752   command.</p>
6753   <p class=MsoBodyText>Valid values are dependent on the version of DbgHelp.dll
6754   installed on the machine.<span style='mso-spacerun:yes'>  </span>See the
6755   Microsoft Developer Library for further information.</p>
6756   <p class=MsoBodyText>MiniDumpNormal = 0x00000000,<br>
6757   MiniDumpWithDataSegs = 0x00000001,<br>
6758   MiniDumpWithFullMemory = 0x00000002,<br>
6759   MiniDumpWithHandleData = 0x00000004,<br>
6760   MiniDumpFilterMemory = 0x00000008,<br>
6761   MiniDumpScanMemory = 0x00000010,<br>
6762   MiniDumpWithUnloadedModules = 0x00000020,<br>
6763   MiniDumpWithIndirectlyReferencedMemory = 0x00000040,<br>
6764   MiniDumpFilterModulePaths = 0x00000080,<br>
6765   MiniDumpWithProcessThreadData = 0x00000100,<br>
6766   MiniDumpWithPrivateReadWriteMemory = 0x00000200,<br>
6767   MiniDumpWithoutOptionalData = 0x00000400,<br>
6768   MiniDumpWithFullMemoryInfo = 0x00000800,<br>
6769   MiniDumpWithThreadInfo = 0x00001000,<br>
6770   MiniDumpWithCodeSegs = 0x00002000</p>
6771   </td>
6772  </tr>
6773  <tr style='mso-yfti-irow:3;mso-yfti-lastrow:yes;height:138.25pt'>
6774   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6775   height:138.25pt'>
6776   <h5><a name="_Toc115416244"></a><a name="_Value___:_StoreAnsiFilenames"></a><span
6777   style='mso-bookmark:_Toc115416244'>Value: StoreAnsiFilenames</span></h5>
6778   <p class=MsoBodyText>Type: REG_DWORD<br>
6779   Default: 0x0</p>
6780   <p class=MsoBodyText>This value can be used to force the AFS Client Service
6781   to store filenames using the Windows system's ANSI character set instead of the
6782   OEM Code Page character set which has traditionally been used by SMB file
6783   systems.<span style='mso-spacerun:yes'>  </span></p>
6784   <p class=MsoBodyText>Note: The use of ANSI characters will render access to
6785   files with 8-bit OEM file names unaccessible from Windows.<span
6786   style='mso-spacerun:yes'>  </span>This option is of use primarily when you
6787   wish to allow file names produced on Windows to be accessible from Latin-1
6788   UNIX systems and vice versa.</p>
6789   </td>
6790  </tr>
6791 </table>
6792
6793 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416245">Regkey:<br>
6794 [HKLM\SOFTWARE\OpenAFS\Client\CSCPolicy]</a></h3>
6795
6796 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6797  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6798  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6799  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6800   height:112.0pt'>
6801   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6802   height:112.0pt'>
6803   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416246">Value: &quot;smb/cifs
6804   share name&quot;</a></h5>
6805   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
6806   Default: &lt;none&gt;</p>
6807   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to map SMB/CIFS
6808   shares to Client Side Caching (off-line access) policies. For each share one
6809   of the following policies may be used: &quot;manual&quot;,
6810   &quot;programs&quot;, &quot;documents&quot;, &quot;disable&quot;.<span
6811   style='mso-spacerun:yes'>  </span></p>
6812   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
6813   in afsdsbmt.ini</p>
6814   </td>
6815  </tr>
6816 </table>
6817
6818 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416247"></a><a
6819 name="_Regkey:_[HKLM\SOFTWARE\OpenAFS\Clie"></a><![if !supportLists]><span
6820 style='mso-bookmark:_Toc115416247'></span><![endif]><span style='mso-bookmark:
6821 _Toc115416247'>Regkey:<br>
6822 [HKLM\SOFTWARE\OpenAFS\Client\Freelance]</span></h3>
6823
6824 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6825  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6826  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6827  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6828   height:138.5pt'>
6829   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6830   height:138.5pt'>
6831   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416248">Value: &quot;numeric
6832   value&quot;</a></h5>
6833   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
6834   Default: &lt;none&gt;</p>
6835   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to store dot
6836   terminated mount point strings for use in constructing the fake root.afs
6837   volume when Freelance (dynamic roots) mode is activated.</p>
6838   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;athena.mit.edu#athena.mit.edu:root.cell.&quot;</p>
6839   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;.athena.mit.edu%athena.mit.edu:root.cell.&quot;</p>
6840   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
6841   in afs_freelance.ini</p>
6842   </td>
6843  </tr>
6844 </table>
6845
6846 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416249"></a><a
6847 name="_Regkey:_[HKLM\SOFTWARE\OpenAFS\Clie_1"></a><![if !supportLists]><span
6848 style='mso-bookmark:_Toc115416249'></span><![endif]><span style='mso-bookmark:
6849 _Toc115416249'>Regkey:<br>
6850 [HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks]</span></h3>
6851
6852 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6853  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6854  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6855  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6856   height:145.0pt'>
6857   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6858   height:145.0pt'>
6859   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416250">Value: &quot;numeric
6860   value&quot;</a></h5>
6861   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
6862   Default: &lt;none&gt;</p>
6863   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to store a dot
6864   terminated symlink strings for use in constructing the fake root.afs volume
6865   when Freelance (dynamic roots) mode is activated.</p>
6866   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;linkname:destination-path.&quot;</p>
6867   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;<st1:GivenName w:st="on">athena</st1:GivenName>:athena.mit.edu.&quot;</p>
6868   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;home:athena.mit.edu\user\j\a\jaltman.&quot;</p>
6869   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;filename:path\file.&quot;</p>
6870   </td>
6871  </tr>
6872 </table>
6873
6874 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416251">Regkey:<br>
6875 [HKLM\SOFTWARE\OpenAFS\Client\Submounts]</a></h3>
6876
6877 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6878  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6879  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6880  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6881   height:171.75pt'>
6882   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6883   height:171.75pt'>
6884   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416252">Value: &quot;submount
6885   name&quot;</a></h5>
6886   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_EXPAND_SZ<br>
6887   Default: &lt;none&gt;</p>
6888   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to store
6889   mappings of UNIX style AFS paths to submount names which can be referenced as
6890   UNC paths.<span style='mso-spacerun:yes'>  </span>For example the submount
6891   string /athena.mit.edu/user/j/a/jaltman&quot; can be associated with the
6892   submount name &quot;jaltman.home&quot;.<span style='mso-spacerun:yes'>
6893   </span>This can then be referenced as the UNC path \\AFS\jaltman.home.</p>
6894   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
6895   in afsdsbmt.ini</p>
6896   <p class=MsoBodyText style='mso-yfti-cnfc:1'>NOTE: Submounts should no longer
6897   be used with OpenAFS. Use the Windows Explorer to create drive mappings to
6898   AFS UNC paths instead of using the AFS Submount mechanism.</p>
6899   </td>
6900  </tr>
6901 </table>
6902
6903 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416253"></a><a
6904 name="_Regkey:_[HKLM\SOFTWARE\OpenAFS\Clie_2"></a><![if !supportLists]><span
6905 style='mso-bookmark:_Toc115416253'></span><![endif]><span style='mso-bookmark:
6906 _Toc115416253'>Regkey:<br>
6907 [HKLM\SOFTWARE\OpenAFS\Client\Server Preferences\VLDB]</span></h3>
6908
6909 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6910  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6911  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6912  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6913   height:105.5pt'>
6914   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6915   height:105.5pt'>
6916   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416254">Value: &quot;hostname or
6917   ip address&quot;</a></h5>
6918   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_DWORD<br>
6919   Default: &lt;none&gt;</p>
6920   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to specify a
6921   default set of VLDB server preferences. For each entry the value name will be
6922   either the IP address of a server or a fully qualified domain name.<span
6923   style='mso-spacerun:yes'>  </span>The value will be the ranking.<span
6924   style='mso-spacerun:yes'>  </span>The ranking will be adjusted by a random
6925   value between 0 and 256 prior to the preference being set.</p>
6926   </td>
6927  </tr>
6928 </table>
6929
6930 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416255">Regkey:<br>
6931 [HKLM\SOFTWARE\OpenAFS\Client\Server Preferences\File]</a></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="_Toc115416256">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 default
6945   set of File server preferences. For each entry the value name will be either
6946   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 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416257"></a><a
6955 name="_Toc115417105"><span style='mso-bookmark:_Toc115416257'>A.2. Integrated
6956 Logon Network provider parameters</span></a></h2>
6957
6958 <p class=MsoBodyText>Affects the network provider (afslogon.dll).</p>
6959
6960 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416258">Regkey:
6961 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</a></h3>
6962
6963 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6964  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6965  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6966  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
6967   height:65.75pt'>
6968   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6969   height:65.75pt'>
6970   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416259">Value: FailLoginsSilently</a></h5>
6971   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD<br>
6972   Default: 0</p>
6973   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Do not display message boxes if
6974   the login fails.</p>
6975   </td>
6976  </tr>
6977 </table>
6978
6979 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416260">Regkey:<br>
6980 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]</a></h3>
6981
6982 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6983  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6984  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6985  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:65.75pt'>
6986   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6987   height:65.75pt'>
6988   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416261">Value: NoWarnings</a></h5>
6989   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD<br>
6990   Default: 0</p>
6991   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Disables visible warnings during
6992   logon.</p>
6993   </td>
6994  </tr>
6995  <tr style='mso-yfti-irow:0;height:65.75pt'>
6996   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6997   height:65.75pt'>
6998   <h5><a name="_Toc115416262">Value: AuthentProviderPath</a></h5>
6999   <p class=MsoBodyText>Type: REG_SZ<br>
7000   NSIS: %WINDIR%\SYSTEM32\afslogon.dll</p>
7001   <p class=MsoBodyText>Specifies the install location of the authentication
7002   provider dll.</p>
7003   </td>
7004  </tr>
7005  <tr style='mso-yfti-irow:1;height:65.75pt'>
7006   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7007   height:65.75pt'>
7008   <h5><a name="_Toc115416263">Value: Class</a></h5>
7009   <p class=MsoBodyText>Type: DWORD<br>
7010   NSIS: 0x02</p>
7011   <p class=MsoBodyText>Specifies the class of network provider</p>
7012   </td>
7013  </tr>
7014  <tr style='mso-yfti-irow:2;height:92.0pt'>
7015   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7016   height:92.0pt'>
7017   <h5><a name="_Toc115416264">Value: DependOnGroup</a></h5>
7018   <p class=MsoBodyText>Type: REG_MULTI_SZ<br>
7019   NSIS: PNP_TDI</p>
7020   <p class=MsoBodyText>Specifies the service groups upon which the AFS Client
7021   Service depends.<span style='mso-spacerun:yes'>  </span>Windows should not
7022   attempt to start the AFS Client Service until all of the services within
7023   these groups have successfully started.</p>
7024   </td>
7025  </tr>
7026  <tr style='mso-yfti-irow:3;height:92.0pt'>
7027   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7028   height:92.0pt'>
7029   <h5><a name="_Toc115416265">Value: DependOnService</a></h5>
7030   <p class=MsoBodyText>Type: REG_MULTI_SZ<br>
7031   NSIS: Tcpip NETBIOS RpcSs</p>
7032   <p class=MsoBodyText>Specifies a list of services upon which the AFS Client
7033   Service depends.<span style='mso-spacerun:yes'>  </span>Windows should not
7034   attempt to start the AFS Client Service until all of the specified services
7035   have successfully started.</p>
7036   </td>
7037  </tr>
7038  <tr style='mso-yfti-irow:4;height:65.75pt'>
7039   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7040   height:65.75pt'>
7041   <h5><a name="_Toc115416266">Value: Name</a></h5>
7042   <p class=MsoBodyText>Type: REG_SZ<br>
7043   NSIS: &quot;OpenAFSDaemon&quot;</p>
7044   <p class=MsoBodyText>Specifies the display name of the AFS Client Service</p>
7045   </td>
7046  </tr>
7047  <tr style='mso-yfti-irow:5;mso-yfti-lastrow:yes;height:65.75pt'>
7048   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7049   height:65.75pt'>
7050   <h5><a name="_Toc115416267">Value: ProviderPath</a></h5>
7051   <p class=MsoBodyText>Type: REG_SZ<br>
7052   NSIS: %WINDIR%\SYSTEM32\afslogon.dll</p>
7053   <p class=MsoBodyText>Specifies the DLL to use for the network provider</p>
7054   </td>
7055  </tr>
7056 </table>
7057
7058 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417106"></a><a
7059 name="_Toc115416268"></a><a name="_A.2.1_Domain_specific_configuration"></a><![if !supportLists]><span
7060 style='mso-bookmark:_Toc115417106'><span style='mso-bookmark:_Toc115416268'></span></span><![endif]><span
7061 style='mso-bookmark:_Toc115417106'><span style='mso-bookmark:_Toc115416268'>A.2.1
7062 Domain specific configuration keys for the Network Provider</span></span></h2>
7063
7064 <p class=MsoBodyText>The network provider can be configured to have different
7065 behavior depending on the domain that the user logs into.<span
7066 style='mso-spacerun:yes'>  </span>These settings are only relevant when using
7067 integrated login.<span style='mso-spacerun:yes'>  </span>A domain refers to an
7068 Active Directory (AD) domain, a trusted Kerberos (non-AD) realm or the local
7069 machine (i.e. local account logins).<span style='mso-spacerun:yes'>  </span>The
7070 domain name that is used for selecting the domain would be the domain that is
7071 passed into the NPLogonNotify function of the network provider.</p>
7072
7073 <p class=MsoBodyText>Domain specific registry keys are:</p>
7074
7075 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416269">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]</a></h3>
7076
7077 <p class=MsoBodyText><span style='mso-spacerun:yes'>  </span>(NP key)</p>
7078
7079 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416270">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain]</a></h3>
7080
7081 <p class=MsoBodyText><span style='mso-spacerun:yes'>  </span>(Domains key)</p>
7082
7083 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416271">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\&quot;domain
7084 name&quot;]</a></h3>
7085
7086 <p class=MsoBodyText><span style='mso-spacerun:yes'>  </span>(Specific domain
7087 key. One per domain.)</p>
7088
7089 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416272">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]</a></h3>
7090
7091 <p class=MsoBodyText><span style='mso-spacerun:yes'>  </span>(Localhost key)</p>
7092
7093 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416273">Example:</a></h3>
7094
7095 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider</p>
7096
7097 <p class=PreformattedText><span style='mso-spacerun:yes'>  </span>|</p>
7098
7099 <p class=PreformattedText><span style='mso-spacerun:yes'>  </span>+- Domain</p>
7100
7101 <p class=PreformattedText><span style='mso-spacerun:yes'>
7102 </span>+-AD1.EXAMPLE.COM</p>
7103
7104 <p class=PreformattedText><span style='mso-spacerun:yes'>
7105 </span>+-AD2.EXAMPLE.NET</p>
7106
7107 <p class=PreformattedText><span style='mso-spacerun:yes'>
7108 </span>+-LOCALHOST</p>
7109
7110 <p class=MsoBodyText>Each of the domain specific keys can have the set of
7111 values described in 2.1.1.<span style='mso-spacerun:yes'>  </span>The effective
7112 values are chosen as described in 2.1.2.</p>
7113
7114 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416274">A.2.1.1
7115 Domain specific configuration values</a></h3>
7116
7117 <h4><a name="_Toc115416275">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]<br>
7118 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain]<br>
7119 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\&quot;domain
7120 name&quot;]<br>
7121 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]</a></h4>
7122
7123 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7124  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7125  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7126  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:191.0pt'>
7127   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7128   height:191.0pt'>
7129   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416276"></a><a
7130   name="_Value___:_LogonOptions"></a><span style='mso-bookmark:_Toc115416276'>Value:
7131   LogonOptions</span></h5>
7132   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD<br>
7133   Default: 0x01</p>
7134   <p class=MsoBodyText style='mso-yfti-cnfc:1'>NSIS/WiX: depends on user
7135   configuration</p>
7136   <p class=MsoBodyText style='mso-yfti-cnfc:1'>0x00 - Integrated Logon is not
7137   used<br>
7138   0x01 - Integrated Logon is used<br>
7139   0x02 - High Security Mode is used (deprecated)<br>
7140   0x03 - Integrated Logon with High Security Mode is used (deprecated)</p>
7141   <p class=MsoBodyText style='mso-yfti-cnfc:1'>High Security Mode generates
7142   random SMB names for the creation of Drive Mappings.<span
7143   style='mso-spacerun:yes'>  </span>This mode should not be used without
7144   Integrated Logon.</p>
7145   <p class=MsoBodyText style='mso-yfti-cnfc:1'>As of 1.3.65 the SMB server
7146   supports SMB authentication.<span style='mso-spacerun:yes'>  </span>The High
7147   Security Mode should not be used when using SMB authentication (SMBAuthType
7148   setting is non zero).</p>
7149   </td>
7150  </tr>
7151  <tr style='mso-yfti-irow:0;height:92.0pt'>
7152   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7153   height:92.0pt'>
7154   <h5><a name="_Toc115416277">Value: FailLoginsSilentl</a></h5>
7155   <p class=MsoBodyText>Type: DWORD (1|0)<br>
7156   Default: 0<br>
7157   NSIS/WiX: (not set)</p>
7158   <p class=MsoBodyText>If true, does not display any visible warnings in the
7159   event of an error during the integrated login process.</p>
7160   </td>
7161  </tr>
7162  <tr style='mso-yfti-irow:1;height:139.0pt'>
7163   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7164   height:139.0pt'>
7165   <h5><a name="_Toc115416278">Value: LogonScript</a></h5>
7166   <p class=MsoBodyText>Type: REG_SZ or REG_EXPAND_SZ<br>
7167   Default: (null)<br>
7168   NSIS/WiX: (only value under NP key) &lt;install path&gt;\afscreds.exe -:%s -x
7169   -a -m -n -q</p>
7170   <p class=MsoBodyText>A logon script that will be scheduled to be run after
7171   the profile load is complete.<span style='mso-spacerun:yes'>  </span>If using
7172   the REG_EXPAND_SZ type, you can use any system environment variable as
7173   &quot;%varname%&quot; which would be expanded at the time the network
7174   provider is run.<span style='mso-spacerun:yes'>  </span>Optionally using a
7175   &quot;%s&quot; in the value would result in it being expanded into the AFS
7176   SMB username for the session.</p>
7177   </td>
7178  </tr>
7179  <tr style='mso-yfti-irow:2;height:105.5pt'>
7180   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7181   height:105.5pt'>
7182   <h5><a name="_Toc115416279">Value: LoginRetryInterval</a></h5>
7183   <p class=MsoBodyText>Type: DWORD<br>
7184   Default: 30<br>
7185   NSIS/WiX: (not set)</p>
7186   <p class=MsoBodyText>If the OpenAFS client service has not started yet, the
7187   network provider will wait for a maximum of &quot;LoginRetryInterval&quot;
7188   seconds while retrying every &quot;LoginSleepInterval&quot; seconds to check
7189   if the service is up.</p>
7190   </td>
7191  </tr>
7192  <tr style='mso-yfti-irow:3;height:79.25pt'>
7193   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7194   height:79.25pt'>
7195   <h5><a name="_Toc115416280">Value: LoginSleepInterval</a></h5>
7196   <p class=MsoBodyText>Type: DWORD<br>
7197   Default: 5<br>
7198   NSIS/WiX: (not set)</p>
7199   <p class=MsoBodyText>See description of LoginRetryInterval.</p>
7200   </td>
7201  </tr>
7202  <tr style='mso-yfti-irow:4;mso-yfti-lastrow:yes;height:78.5pt'>
7203   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7204   height:78.5pt'>
7205   <h5><a name="_Toc115416281"></a><a name="_Value:_TheseCells"></a><span
7206   style='mso-bookmark:_Toc115416281'>Value: TheseCells</span></h5>
7207   <p class=MsoBodyText>Type: REG_MULTI_SZ<br>
7208   NSIS: &lt;not set&gt;</p>
7209   <p class=MsoBodyText>When Kerberos 5 is being used, TheseCells provides a
7210   list of additional cells for which tokens should be obtained with the default
7211   Kerberos 5 principal.</p>
7212   </td>
7213  </tr>
7214 </table>
7215
7216 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416282">A.2.1.2<span
7217 style='mso-spacerun:yes'>  </span>Selection of effective values for domain
7218 specific configuration</a></h3>
7219
7220 <p class=MsoBodyText>During login to domain X, where X is the domain passed
7221 into NPLogonNotify as lpAuthentInfo-&gt;LogonDomainName or the string
7222 'LOCALHOST' if lpAuthentInfo-&gt;LogonDomainName equals the name of the
7223 computer, the following keys will be looked up.</p>
7224
7225 <p class=MsoBodyText style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:
7226 l15 level1 lfo36;tab-stops:list 36.0pt'><![if !supportLists]><span
7227 style='mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
7228 style='mso-list:Ignore'>1.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
7229 </span></span></span><![endif]>NP key.
7230 (&quot;HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider&quot;)</p>
7231
7232 <p class=MsoBodyText style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:
7233 l15 level1 lfo36;tab-stops:list 36.0pt'><![if !supportLists]><span
7234 style='mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
7235 style='mso-list:Ignore'>2.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
7236 </span></span></span><![endif]>Domains key. (NP key\&quot;Domain&quot;)</p>
7237
7238 <p class=MsoBodyText style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:
7239 l15 level1 lfo36;tab-stops:list 36.0pt'><![if !supportLists]><span
7240 style='mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
7241 style='mso-list:Ignore'>3.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
7242 </span></span></span><![endif]>Specific domain key. (Domains key\X)</p>
7243
7244 <p class=MsoBodyText>If the specific domain key does not exist, then the
7245 domains key will be ignored.<span style='mso-spacerun:yes'>  </span>All the
7246 configuration information in this case will come from the NP key.</p>
7247
7248 <p class=MsoBodyText>If the specific domain key exists, then for each of the
7249 values metioned in (2), they will be looked up in the specific domain key,
7250 domains key and the NP key successively until the value is found. The first
7251 instance of the value found this way will be the effective for the login
7252 session.<span style='mso-spacerun:yes'>  </span>If no such instance can be
7253 found, the default will be used.<span style='mso-spacerun:yes'>  </span>To
7254 re-iterate, a value in a more specific key supercedes a value in a less
7255 specific key.<span style='mso-spacerun:yes'>  </span>The exceptions to this
7256 rule are stated below.</p>
7257
7258 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416283">A.2.1.3
7259 Exceptions to A.2.1.2</a></h3>
7260
7261 <p class=MsoBodyText>To retain backwards compatibility, the following
7262 exceptions are made to 2.1.2.</p>
7263
7264 <h4><a name="_Toc115416284">2.1.3.1 'FailLoginsSilently'</a></h4>
7265
7266 <p class=MsoBodyText>Historically, the 'FailLoginsSilently' value was in
7267 HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters key and not
7268 in the NP key.<span style='mso-spacerun:yes'>  </span>Therefore, for backwards
7269 compatibility, the value in the Parameters key will supercede all instances of
7270 this value in other keys.<span style='mso-spacerun:yes'>  </span>In the absence
7271 of this value in the Parameters key, normal scope rules apply.</p>
7272
7273 <h4><a name="_Toc115416285">2.1.3.2 'LogonScript'</a></h4>
7274
7275 <p class=MsoBodyText>If a 'LogonScript' is not specified in the specific domain
7276 key nor in the domains key, the value in the NP key will only be checked if the
7277 effective 'LogonOptions' specify a high security integrated login.<span
7278 style='mso-spacerun:yes'>  </span>If a logon script is specified in the
7279 specific domain key or the domains key, it will be used regardless of the high
7280 security setting.<span style='mso-spacerun:yes'>  </span>Please be aware of
7281 this when setting this value.</p>
7282
7283 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416286"></a><a
7284 name="_Toc115417107"><span style='mso-bookmark:_Toc115416286'>A.3. AFS
7285 Credentials System Tray Tool parameters</span></a></h2>
7286
7287 <p class=MsoBodyText>Affects the behavior of afscreds.exe</p>
7288
7289 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416287">Regkey:<br>
7290 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</a></h3>
7291
7292 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7293  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7294  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7295  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:92.0pt'>
7296   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7297   height:92.0pt'>
7298   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416288">Value: Gateway</a></h5>
7299   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
7300   Default: &quot;&quot;<br>
7301   Function: GetGatewayName()</p>
7302   <p class=MsoBodyText style='mso-yfti-cnfc:1'>If the AFS client is utilizing a
7303   gateway to obtain AFS access, the name of the gateway is specified by this
7304   value.</p>
7305   </td>
7306  </tr>
7307  <tr style='mso-yfti-irow:0;mso-yfti-lastrow:yes;height:92.0pt'>
7308   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7309   height:92.0pt'>
7310   <h5><a name="_Toc115416289">Value: Cell</a></h5>
7311   <p class=MsoBodyText>Type: REG_SZ<br>
7312   Default: &lt;none&gt;<br>
7313   Variable: IsServiceConfigured()</p>
7314   <p class=MsoBodyText>The value Cell is used to determine if the AFS Client Service
7315   has been properly configured or not.</p>
7316   </td>
7317  </tr>
7318 </table>
7319
7320 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416290">Regkey:<br>
7321 [HKLM\SOFTWARE\OpenAFS\Client]<br>
7322 [HKCU\SOFTWARE\OpenAFS\Client]</a></h3>
7323
7324 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7325  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7326  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7327  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:157.5pt'>
7328   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7329   height:157.5pt'>
7330   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416291">Value: ShowTrayIcon</a></h5>
7331   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD {0, 1}<br>
7332   Default: 1<br>
7333   Function: InitApp(), Main_OnCheckTerminate()</p>
7334   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This value is used to determine whether
7335   or not a shortcut should be maintained in the user's Start
7336   Menu-&gt;Programs-&gt;Startup folder. </p>
7337   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This value used to be stored at
7338   [HKLM\Software\TransarcCorporation\AFS Client\AfsCreds].</p>
7339   <p class=MsoBodyText style='mso-yfti-cnfc:1'>The current user value is
7340   checked first; if it does not exist the local machine value is checked.</p>
7341   </td>
7342  </tr>
7343  <tr style='mso-yfti-irow:0;height:119.0pt'>
7344   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7345   height:119.0pt'>
7346   <h5><a name="_Toc115416292">Value: EnableKFW</a></h5>
7347   <p class=MsoBodyText>Type: DWORD {0, 1}<br>
7348   Default: 1<br>
7349   Function: KFW_is_available()</p>
7350   <p class=MsoBodyText>When MIT Kerberos for Windows can be loaded, Kerberos 5
7351   will be used to obtain AFS credentials.<span style='mso-spacerun:yes'>
7352   </span>By setting this value to 0, the internal Kerberos 4 implementation
7353   will be used instead.<span style='mso-spacerun:yes'>  </span>The current user
7354   value is checked first; if it does not exist the local machine value is
7355   checked.</p>
7356   </td>
7357  </tr>
7358  <tr style='mso-yfti-irow:1;height:119.0pt'>
7359   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7360   height:119.0pt'>
7361   <h5><a name="_Toc115416293"></a><a name="_Value___:_Use524"></a><span
7362   style='mso-bookmark:_Toc115416293'>Value: Use524</span></h5>
7363   <p class=MsoBodyText>Type: DWORD {0, 1}<br>
7364   Default: 0<br>
7365   Function: KFW_use_krb524()</p>
7366   <p class=MsoBodyText>When MIT Kerberos for Windows can be loaded, Kerberos 5
7367   will be used to obtain AFS credentials.<span style='mso-spacerun:yes'>
7368   </span>By setting this value to 1, the Kerberos 5 tickets will be converted
7369   to Kerberos 4 tokens via a call to the krb524 daemon.<span
7370   style='mso-spacerun:yes'>  </span>The current user value is checked first; if
7371   it does not exist the local machine value is checked.</p>
7372   </td>
7373  </tr>
7374  <tr style='mso-yfti-irow:2;mso-yfti-lastrow:yes;height:251.5pt'>
7375   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7376   height:251.5pt'>
7377   <h5><a name="_Toc115416294"></a><a name="_Value___:_AfscredsShortcutParams"></a><span
7378   style='mso-bookmark:_Toc115416294'>Value: AfscredsShortcutParams</span></h5>
7379   <p class=MsoBodyText>Type: REG_SZ<br>
7380   Default: &quot;-A -M -N -Q&quot;<br>
7381   Function: Shortcut_FixStartup</p>
7382   <p class=MsoBodyText>This value specifies the command line options which should
7383   be set as part of the shortcut to afscreds.exe.<span
7384   style='mso-spacerun:yes'>  </span>afscreds.exe rewrites the shortcut each
7385   time it exits so as to ensure that the shortcut points to the latest version
7386   of the program.<span style='mso-spacerun:yes'>  </span>This value is used to
7387   determine which values should be used for command line parameters.<span
7388   style='mso-spacerun:yes'>  </span>The current user value is checked first; if
7389   it does not exist the local machine value is checked.</p>
7390   <p class=MsoBodyText>The following subset of the command line options is
7391   appropriate for use in this registry setting:</p>
7392   <p class=MsoBodyText>-A = autoinit<br>
7393   -M = renew drive maps<br>
7394   -N = ip address change detection<br>
7395   -Q = quiet mode.<span style='mso-spacerun:yes'>  </span>do not display start
7396   service dialog if afsd_service is not already running<br>
7397   -S = show tokens dialog on startup<br>
7398   -Z = unmap drives</p>
7399   </td>
7400  </tr>
7401 </table>
7402
7403 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416295">Regkey:<br>
7404 [HKCU\SOFTWARE\OpenAFS\Client]</a></h3>
7405
7406 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7407  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7408  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7409  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7410   height:92.0pt'>
7411   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7412   height:92.0pt'>
7413   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416296">Value: Authentication
7414   Cell</a></h5>
7415   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
7416   Default: &lt;none&gt;<br>
7417   Function: Afscreds.exe GetDefaultCell()</p>
7418   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This value allows the user to
7419   configure a different cell name to be used as the default cell when acquiring
7420   tokens in afscreds.exe.</p>
7421   </td>
7422  </tr>
7423 </table>
7424
7425 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416297">Regkey:<br>
7426 [HKCU\SOFTWARE\OpenAFS\Client\Reminders]</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:124.75pt'>
7433   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7434   height:124.75pt'>
7435   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416298">Value: &quot;afs cell
7436   name&quot;</a></h5>
7437   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD {0, 1}<br>
7438   Default: &lt;none&gt;<br>
7439   Function: LoadRemind(), SaveRemind()</p>
7440   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values are used to save
7441   and restore the state of the reminder flag for each cell for which the user
7442   has obtained tokens.</p>
7443   <p class=MsoBodyText style='mso-yfti-cnfc:1'>This value used to be stored at
7444   [HKLM\Software\TransarcCorporation\AFS Client\AfsCreds].</p>
7445   </td>
7446  </tr>
7447 </table>
7448
7449 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416299">Regkey:<br>
7450 [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]</a></h3>
7451
7452 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7453  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7454  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7455  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7456   height:98.5pt'>
7457   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7458   height:98.5pt'>
7459   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416300">Value: &quot;upper case
7460   drive letter&quot;</a></h5>
7461   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD {0, 1}<br>
7462   Default: &lt;none&gt;</p>
7463   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values are used to store the
7464   persistence state of the AFS drive mappings as listed in the
7465   [...\Client\Mappings] key.</p>
7466   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
7467   in the afsdsbmt.ini file</p>
7468   </td>
7469  </tr>
7470 </table>
7471
7472 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416301">Regkey:<br>
7473 [HKCU\SOFTWARE\OpenAFS\Client\Mappings]</a></h3>
7474
7475 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7476  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7477  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7478  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7479   height:98.5pt'>
7480   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7481   height:98.5pt'>
7482   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416302">Value: &quot;upper case
7483   drive letter&quot;</a></h5>
7484   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
7485   Default: &lt;none&gt;</p>
7486   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values are used to store
7487   the AFS path in UNIX notation to which the drive letter is to be mapped.</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 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416303"></a><a
7495 name="_Toc115417108"><span style='mso-bookmark:_Toc115416303'>A.4 OpenAFS
7496 Client Service Environment Variables</span></a></h2>
7497
7498 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7499  style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7500  mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7501  <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
7502   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
7503   <h5 style='mso-yfti-cnfc:1'><a name="_Toc115416304">Variable: AFS_RPC_ENCRYPT</a></h5>
7504   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Values:<span
7505   style='mso-spacerun:yes'>   </span>&quot;OFF&quot; disables the use of RPC
7506   encryption any other value allows RPC encryption to be used<br>
7507   Default:<span style='mso-spacerun:yes'>  </span>RPC encryption is on</p>
7508   </td>
7509  </tr>
7510  <tr style='mso-yfti-irow:0;mso-yfti-lastrow:yes'>
7511   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
7512   <h5><a name="_Toc115416305">Variable: AFS_RPC_PROTSEQ</a></h5>
7513   <p class=MsoBodyText>Values:<span style='mso-tab-count:1'>            </span>&quot;ncalrpc&quot;<span
7514   style='mso-spacerun:yes'>  </span>- local RPC<br>
7515   <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:2'>                      </span>&quot;ncacn_np&quot;
7516   - named pipes<br>
7517   <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:2'>                      </span>&quot;ncacn_ip_tcp&quot;
7518   - tcp/ip<br>
7519   Default:<span style='mso-spacerun:yes'>  </span>local RPC</p>
7520   </td>
7521  </tr>
7522 </table>
7523
7524 <p class=MsoBodyText><o:p>&nbsp;</o:p></p>
7525
7526 </div>
7527
7528 </body>
7529
7530 </html>