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"
4 xmlns:st2="urn:schemas-microsoft-com:office:smarttags"
5 xmlns:st1="urn:schemas:contacts" xmlns="http://www.w3.org/TR/REC-html40">
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-microsoft-com:office:smarttags"
17 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
19 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
21 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
23 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
25 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
26 name="country-region"/>
27 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
29 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
31 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
33 <o:SmartTagType namespaceuri="urn:schemas:contacts" name="GivenName"/>
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>1</o:Revision>
40 <o:TotalTime>1</o:TotalTime>
41 <o:LastPrinted>1601-01-01T07:00:00Z</o:LastPrinted>
42 <o:Created>2005-09-25T20:12:00Z</o:Created>
43 <o:LastSaved>2005-09-25T20:12:00Z</o:LastSaved>
45 <o:Words>14400</o:Words>
46 <o:Characters>82083</o:Characters>
47 <o:Company>Secure Endpoints Inc.</o:Company>
48 <o:Lines>684</o:Lines>
49 <o:Paragraphs>192</o:Paragraphs>
50 <o:CharactersWithSpaces>96291</o:CharactersWithSpaces>
51 <o:Version>11.6408</o:Version>
52 </o:DocumentProperties>
53 </xml><![endif]--><!--[if gte mso 9]><xml>
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>
69 <w:BalanceSingleByteDoubleByteWidth/>
70 <w:DoNotLeaveBackslashAlone/>
72 <w:DoNotExpandShiftReturn/>
73 <w:AdjustLineHeightInTable/>
74 <w:SelectEntireFieldWithStartOrEnd/>
75 <w:UseWord2002TableStyleRules/>
77 <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
79 </xml><![endif]--><!--[if gte mso 9]><xml>
80 <w:LatentStyles DefLockedState="false" LatentStyleCount="156">
82 </xml><![endif]--><!--[if !mso]><object
83 classid="clsid:38481807-CA0E-42D2-BF39-B33AF135CC4D" id=ieooui></object>
85 st2\:*{behavior:url(#ieooui) }st1\:*{behavior:url(#ieooui) }
90 /* Font Definitions */
92 {font-family:Wingdings;
93 panose-1:5 0 0 0 0 0 0 0 0 0;
95 mso-generic-font-family:auto;
96 mso-font-pitch:variable;
97 mso-font-signature:0 268435456 0 0 -2147483648 0;}
99 {font-family:"MS Mincho";
100 panose-1:2 2 6 9 4 2 5 8 3 4;
101 mso-font-alt:"\FF2D\FF33 \660E\671D";
102 mso-font-charset:128;
103 mso-generic-font-family:modern;
104 mso-font-pitch:fixed;
105 mso-font-signature:-1610612033 1757936891 16 0 131231 0;}
108 panose-1:2 11 6 4 3 5 4 4 2 4;
110 mso-generic-font-family:swiss;
111 mso-font-pitch:variable;
112 mso-font-signature:1627421319 -2147483648 8 0 66047 0;}
114 {font-family:Thorndale;
115 panose-1:2 2 6 3 5 4 5 2 3 4;
117 mso-generic-font-family:roman;
118 mso-font-pitch:variable;
119 mso-font-signature:647 0 0 0 159 0;}
121 {font-family:"Andale Sans UI";
122 panose-1:2 11 5 2 0 0 0 0 0 1;
124 mso-generic-font-family:swiss;
125 mso-font-pitch:variable;
126 mso-font-signature:647 0 0 0 159 0;}
128 {font-family:StarSymbol;
129 panose-1:5 0 0 0 0 0 0 0 0 0;
131 mso-generic-font-family:auto;
132 mso-font-pitch:variable;
133 mso-font-signature:3 268468224 0 0 1 0;}
136 panose-1:2 11 6 4 2 2 2 2 2 4;
138 mso-generic-font-family:swiss;
139 mso-font-pitch:variable;
140 mso-font-signature:647 0 0 0 159 0;}
142 {font-family:Cumberland;
143 panose-1:2 7 3 9 2 2 5 2 4 4;
145 mso-generic-font-family:modern;
146 mso-font-pitch:fixed;
147 mso-font-signature:647 0 0 0 159 0;}
149 {font-family:"\@MS Mincho";
150 panose-1:2 2 6 9 4 2 5 8 3 4;
151 mso-font-charset:128;
152 mso-generic-font-family:modern;
153 mso-font-pitch:fixed;
154 mso-font-signature:-1610612033 1757936891 16 0 131231 0;}
155 /* Style Definitions */
156 p.MsoNormal, li.MsoNormal, div.MsoNormal
157 {mso-style-parent:"";
165 font-family:Thorndale;
166 mso-fareast-font-family:"Andale Sans UI";
167 mso-bidi-font-family:"Times New Roman";
168 mso-fareast-language:#00FF;}
170 {mso-style-parent:Heading;
171 mso-style-next:"Body Text";
178 page-break-after:avoid;
180 mso-list:l21 level1 lfo12;
185 mso-fareast-font-family:"MS Mincho";
186 mso-bidi-font-family:Tahoma;
187 mso-font-kerning:0pt;
188 mso-fareast-language:#00FF;}
190 {mso-style-parent:Heading;
191 mso-style-next:"Body Text";
198 page-break-after:avoid;
200 mso-list:l21 level2 lfo12;
205 mso-fareast-font-family:"MS Mincho";
206 mso-bidi-font-family:Tahoma;
207 mso-fareast-language:#00FF;
210 {mso-style-parent:Heading;
211 mso-style-link:"Heading 3 Char";
212 mso-style-next:"Body Text";
219 page-break-after:avoid;
221 mso-list:l21 level3 lfo12;
226 mso-fareast-font-family:"MS Mincho";
227 mso-bidi-font-family:Tahoma;
228 mso-fareast-language:#00FF;}
230 {mso-style-link:"Heading 4 Char";
231 mso-style-next:Normal;
237 page-break-after:avoid;
241 font-family:"Times New Roman";
242 mso-fareast-font-family:"Andale Sans UI";
243 mso-fareast-language:#00FF;}
245 {mso-style-next:Normal;
254 font-family:Thorndale;
255 mso-fareast-font-family:"Andale Sans UI";
256 mso-fareast-language:#00FF;
259 {mso-style-next:Normal;
268 font-family:"Times New Roman";
269 mso-fareast-font-family:"Andale Sans UI";
270 mso-fareast-language:#00FF;}
271 p.MsoToc1, li.MsoToc1, div.MsoToc1
272 {mso-style-noshow:yes;
273 mso-style-parent:Index;
278 mso-pagination:no-line-numbers;
280 tab-stops:right dotted 432.0pt;
282 font-family:Thorndale;
283 mso-fareast-font-family:"Andale Sans UI";
284 mso-bidi-font-family:Tahoma;
285 mso-fareast-language:#00FF;}
286 p.MsoToc2, li.MsoToc2, div.MsoToc2
287 {mso-style-noshow:yes;
288 mso-style-parent:Index;
293 mso-pagination:no-line-numbers;
295 tab-stops:right dotted 432.0pt;
297 font-family:Thorndale;
298 mso-fareast-font-family:"Andale Sans UI";
299 mso-bidi-font-family:Tahoma;
300 mso-fareast-language:#00FF;}
301 p.MsoToc3, li.MsoToc3, div.MsoToc3
302 {mso-style-noshow:yes;
303 mso-style-parent:Index;
308 mso-pagination:no-line-numbers;
310 tab-stops:right dotted 432.0pt;
312 font-family:Thorndale;
313 mso-fareast-font-family:"Andale Sans UI";
314 mso-bidi-font-family:Tahoma;
315 mso-fareast-language:#00FF;}
316 p.MsoFootnoteText, li.MsoFootnoteText, div.MsoFootnoteText
317 {mso-style-noshow:yes;
325 font-family:Thorndale;
326 mso-fareast-font-family:"Andale Sans UI";
327 mso-bidi-font-family:"Times New Roman";
328 mso-fareast-language:#00FF;}
329 p.MsoHeader, li.MsoHeader, div.MsoHeader
336 tab-stops:center 216.0pt right 432.0pt;
338 font-family:Thorndale;
339 mso-fareast-font-family:"Andale Sans UI";
340 mso-bidi-font-family:"Times New Roman";
341 mso-fareast-language:#00FF;}
342 p.MsoFooter, li.MsoFooter, div.MsoFooter
349 tab-stops:center 216.0pt right 432.0pt;
351 font-family:Thorndale;
352 mso-fareast-font-family:"Andale Sans UI";
353 mso-bidi-font-family:"Times New Roman";
354 mso-fareast-language:#00FF;}
355 p.MsoEnvelopeAddress, li.MsoEnvelopeAddress, div.MsoEnvelopeAddress
363 mso-element-frame-width:396.0pt;
364 mso-element-frame-height:99.0pt;
365 mso-element-frame-hspace:9.0pt;
366 mso-element-wrap:auto;
367 mso-element-anchor-horizontal:page;
368 mso-element-left:center;
369 mso-element-top:bottom;
370 mso-height-rule:exactly;
373 mso-fareast-font-family:"Andale Sans UI";
374 mso-fareast-language:#00FF;}
375 span.MsoFootnoteReference
376 {mso-style-noshow:yes;
377 vertical-align:super;}
378 p.MsoList, li.MsoList, div.MsoList
379 {mso-style-parent:"Body Text";
387 font-family:Thorndale;
388 mso-fareast-font-family:"Andale Sans UI";
389 mso-bidi-font-family:Tahoma;
390 mso-fareast-language:#00FF;}
391 p.MsoTitle, li.MsoTitle, div.MsoTitle
392 {mso-style-parent:Heading;
393 mso-style-next:Subtitle;
400 page-break-after:avoid;
404 mso-fareast-font-family:"MS Mincho";
405 mso-bidi-font-family:Tahoma;
406 mso-fareast-language:#00FF;
408 p.MsoBodyText, li.MsoBodyText, div.MsoBodyText
409 {mso-style-link:"Body Text Char";
417 font-family:Thorndale;
418 mso-fareast-font-family:"Andale Sans UI";
419 mso-bidi-font-family:"Times New Roman";
420 mso-fareast-language:#00FF;}
421 p.MsoBodyTextIndent, li.MsoBodyTextIndent, div.MsoBodyTextIndent
422 {mso-style-parent:"Body Text";
430 font-family:Thorndale;
431 mso-fareast-font-family:"Andale Sans UI";
432 mso-bidi-font-family:"Times New Roman";
433 mso-fareast-language:#00FF;}
434 p.MsoSubtitle, li.MsoSubtitle, div.MsoSubtitle
435 {mso-style-parent:Heading;
436 mso-style-next:"Body Text";
443 page-break-after:avoid;
447 mso-fareast-font-family:"MS Mincho";
448 mso-bidi-font-family:Tahoma;
449 mso-fareast-language:#00FF;
451 a:link, span.MsoHyperlink
452 {mso-style-parent:"";
454 text-decoration:underline;
455 text-underline:single;}
456 a:visited, span.MsoHyperlinkFollowed
457 {mso-style-parent:"";
459 text-decoration:underline;
460 text-underline:single;}
461 span.NumberingSymbols
462 {mso-style-name:"Numbering Symbols";
463 mso-style-parent:"";}
465 {mso-style-name:Bullets;
467 mso-ansi-font-size:9.0pt;
468 mso-bidi-font-size:9.0pt;
469 font-family:StarSymbol;
470 mso-ascii-font-family:StarSymbol;
471 mso-fareast-font-family:StarSymbol;
472 mso-hansi-font-family:StarSymbol;
473 mso-bidi-font-family:StarSymbol;}
474 span.FootnoteCharacters
475 {mso-style-name:"Footnote Characters";
476 mso-style-parent:"";}
477 span.EndnoteCharacters
478 {mso-style-name:"Endnote Characters";
479 mso-style-parent:"";}
480 p.Heading, li.Heading, div.Heading
481 {mso-style-name:Heading;
482 mso-style-link:"Heading Char";
483 mso-style-next:"Body Text";
489 page-break-after:avoid;
493 mso-fareast-font-family:"MS Mincho";
494 mso-bidi-font-family:Tahoma;
495 mso-fareast-language:#00FF;}
496 p.Caption1, li.Caption1, div.Caption1
497 {mso-style-name:Caption1;
502 mso-pagination:no-line-numbers;
505 font-family:Thorndale;
506 mso-fareast-font-family:"Andale Sans UI";
507 mso-bidi-font-family:Tahoma;
508 mso-fareast-language:#00FF;
510 p.Index, li.Index, div.Index
511 {mso-style-name:Index;
516 mso-pagination:no-line-numbers;
519 font-family:Thorndale;
520 mso-fareast-font-family:"Andale Sans UI";
521 mso-bidi-font-family:Tahoma;
522 mso-fareast-language:#00FF;}
523 p.ContentsHeading, li.ContentsHeading, div.ContentsHeading
524 {mso-style-name:"Contents Heading";
525 mso-style-parent:Heading;
530 mso-pagination:no-line-numbers;
531 page-break-after:avoid;
535 mso-fareast-font-family:"MS Mincho";
536 mso-bidi-font-family:Tahoma;
537 mso-fareast-language:#00FF;
539 p.PreformattedText, li.PreformattedText, div.PreformattedText
540 {mso-style-name:"Preformatted Text";
542 margin-bottom:.0001pt;
546 font-family:Cumberland;
547 mso-fareast-font-family:Cumberland;
548 mso-bidi-font-family:Cumberland;
549 mso-fareast-language:#00FF;}
550 p.ListContents, li.ListContents, div.ListContents
551 {mso-style-name:"List Contents";
559 font-family:Thorndale;
560 mso-fareast-font-family:"Andale Sans UI";
561 mso-bidi-font-family:"Times New Roman";
562 mso-fareast-language:#00FF;}
563 p.ListHeading, li.ListHeading, div.ListHeading
564 {mso-style-name:"List Heading";
565 mso-style-next:"List Contents";
573 font-family:Thorndale;
574 mso-fareast-font-family:"Andale Sans UI";
575 mso-bidi-font-family:"Times New Roman";
576 mso-fareast-language:#00FF;}
578 {mso-style-name:"Heading Char";
579 mso-style-locked:yes;
580 mso-style-link:Heading;
581 mso-ansi-font-size:14.0pt;
582 mso-bidi-font-size:14.0pt;
584 mso-ascii-font-family:Albany;
585 mso-fareast-font-family:"MS Mincho";
586 mso-hansi-font-family:Albany;
587 mso-bidi-font-family:Tahoma;
588 mso-ansi-language:EN-US;
589 mso-fareast-language:#00FF;
590 mso-bidi-language:AR-SA;}
592 {mso-style-name:"Heading 3 Char";
593 mso-style-locked:yes;
594 mso-style-parent:"Heading Char";
595 mso-style-link:"Heading 3";
596 mso-ansi-font-size:14.0pt;
597 mso-bidi-font-size:14.0pt;
599 mso-ascii-font-family:Albany;
600 mso-fareast-font-family:"MS Mincho";
601 mso-hansi-font-family:Albany;
602 mso-bidi-font-family:Tahoma;
603 mso-ansi-language:EN-US;
604 mso-fareast-language:#00FF;
605 mso-bidi-language:AR-SA;
607 p.Header5, li.Header5, div.Header5
608 {mso-style-name:"Header 5";
616 font-family:Thorndale;
617 mso-fareast-font-family:"Andale Sans UI";
618 mso-bidi-font-family:"Times New Roman";
619 mso-fareast-language:#00FF;}
620 p.Heading3, li.Heading3, div.Heading3
621 {mso-style-name:Heading3;
629 font-family:Thorndale;
630 mso-fareast-font-family:"Andale Sans UI";
631 mso-bidi-font-family:"Times New Roman";
632 mso-fareast-language:#00FF;}
634 {mso-style-name:"Heading 4 Char";
635 mso-style-locked:yes;
636 mso-style-link:"Heading 4";
637 mso-ansi-font-size:14.0pt;
638 mso-bidi-font-size:14.0pt;
639 font-family:"Andale Sans UI";
640 mso-fareast-font-family:"Andale Sans UI";
641 mso-ansi-language:EN-US;
642 mso-fareast-language:#00FF;
643 mso-bidi-language:AR-SA;
645 p.Default, li.Default, div.Default
646 {mso-style-name:Default;
649 margin-bottom:.0001pt;
650 mso-pagination:widow-orphan;
651 mso-layout-grid-align:none;
655 mso-fareast-font-family:"MS Mincho";
658 {mso-style-name:"Body Text Char";
659 mso-style-locked:yes;
660 mso-style-link:"Body Text";
661 mso-ansi-font-size:12.0pt;
662 mso-bidi-font-size:12.0pt;
663 font-family:Thorndale;
664 mso-ascii-font-family:Thorndale;
665 mso-fareast-font-family:"Andale Sans UI";
666 mso-hansi-font-family:Thorndale;
667 mso-ansi-language:EN-US;
668 mso-fareast-language:#00FF;
669 mso-bidi-language:AR-SA;}
670 /* Page Definitions */
672 {mso-footnote-separator:url("relnotes_files/header.htm") fs;
673 mso-footnote-continuation-separator:url("relnotes_files/header.htm") fcs;
674 mso-endnote-separator:url("relnotes_files/header.htm") es;
675 mso-endnote-continuation-separator:url("relnotes_files/header.htm") ecs;
676 mso-footnote-position:beneath-text;}
678 {size:612.0pt 792.0pt;
679 margin:72.0pt 90.0pt 72.0pt 90.0pt;
680 mso-header-margin:36.0pt;
681 mso-footer-margin:36.0pt;
685 mso-footnote-position:beneath-text;}
687 {size:612.0pt 792.0pt;
688 margin:72.0pt 90.0pt 72.0pt 90.0pt;
689 mso-header-margin:36.0pt;
690 mso-footer-margin:36.0pt;
691 mso-header:url("relnotes_files/header.htm") h2;
695 /* List Definitions */
698 mso-list-type:simple;
699 mso-list-template-ids:-1234375184;}
701 {mso-level-tab-stop:90.0pt;
702 mso-level-number-position:left;
704 text-indent:-18.0pt;}
707 mso-list-type:simple;
708 mso-list-template-ids:1628742212;}
710 {mso-level-tab-stop:72.0pt;
711 mso-level-number-position:left;
713 text-indent:-18.0pt;}
716 mso-list-type:simple;
717 mso-list-template-ids:1598849380;}
719 {mso-level-tab-stop:54.0pt;
720 mso-level-number-position:left;
722 text-indent:-18.0pt;}
725 mso-list-type:simple;
726 mso-list-template-ids:-1708084928;}
728 {mso-level-tab-stop:36.0pt;
729 mso-level-number-position:left;
730 text-indent:-18.0pt;}
733 mso-list-type:simple;
734 mso-list-template-ids:-573116274;}
736 {mso-level-number-format:bullet;
737 mso-level-text:\F0B7;
738 mso-level-tab-stop:90.0pt;
739 mso-level-number-position:left;
745 mso-list-type:simple;
746 mso-list-template-ids:-1674157402;}
748 {mso-level-number-format:bullet;
749 mso-level-text:\F0B7;
750 mso-level-tab-stop:72.0pt;
751 mso-level-number-position:left;
757 mso-list-type:simple;
758 mso-list-template-ids:-855098526;}
760 {mso-level-number-format:bullet;
761 mso-level-text:\F0B7;
762 mso-level-tab-stop:54.0pt;
763 mso-level-number-position:left;
769 mso-list-type:simple;
770 mso-list-template-ids:1629288942;}
772 {mso-level-number-format:bullet;
773 mso-level-text:\F0B7;
774 mso-level-tab-stop:36.0pt;
775 mso-level-number-position:left;
780 mso-list-type:simple;
781 mso-list-template-ids:1092749420;}
783 {mso-level-tab-stop:18.0pt;
784 mso-level-number-position:left;
786 text-indent:-18.0pt;}
789 mso-list-type:simple;
790 mso-list-template-ids:-593317242;}
792 {mso-level-number-format:bullet;
793 mso-level-text:\F0B7;
794 mso-level-tab-stop:18.0pt;
795 mso-level-number-position:left;
801 mso-list-template-ids:1148726518;}
803 {mso-level-tab-stop:18.0pt;
804 mso-level-number-position:left;
807 mso-ansi-font-size:9.0pt;
808 mso-bidi-font-size:9.0pt;}
810 {mso-level-number-format:bullet;
811 mso-level-text:\F0B7;
812 mso-level-tab-stop:28.35pt;
813 mso-level-number-position:left;
815 text-indent:-14.15pt;
816 mso-ansi-font-size:9.0pt;
817 mso-bidi-font-size:9.0pt;
818 mso-ascii-font-family:Symbol;
819 mso-hansi-font-family:Symbol;
820 mso-bidi-font-family:StarSymbol;}
822 {mso-level-number-format:bullet;
823 mso-level-text:\F0B7;
824 mso-level-tab-stop:42.5pt;
825 mso-level-number-position:left;
827 text-indent:-14.15pt;
828 mso-ansi-font-size:9.0pt;
829 mso-bidi-font-size:9.0pt;
830 mso-ascii-font-family:Symbol;
831 mso-hansi-font-family:Symbol;
832 mso-bidi-font-family:StarSymbol;}
834 {mso-level-number-format:bullet;
835 mso-level-text:\F0B7;
836 mso-level-tab-stop:56.7pt;
837 mso-level-number-position:left;
839 text-indent:-14.15pt;
840 mso-ansi-font-size:9.0pt;
841 mso-bidi-font-size:9.0pt;
842 mso-ascii-font-family:Symbol;
843 mso-hansi-font-family:Symbol;
844 mso-bidi-font-family:StarSymbol;}
846 {mso-level-number-format:bullet;
847 mso-level-text:\F0B7;
848 mso-level-tab-stop:70.85pt;
849 mso-level-number-position:left;
851 text-indent:-14.15pt;
852 mso-ansi-font-size:9.0pt;
853 mso-bidi-font-size:9.0pt;
854 mso-ascii-font-family:Symbol;
855 mso-hansi-font-family:Symbol;
856 mso-bidi-font-family:StarSymbol;}
858 {mso-level-number-format:bullet;
859 mso-level-text:\F0B7;
860 mso-level-tab-stop:85.05pt;
861 mso-level-number-position:left;
863 text-indent:-14.15pt;
864 mso-ansi-font-size:9.0pt;
865 mso-bidi-font-size:9.0pt;
866 mso-ascii-font-family:Symbol;
867 mso-hansi-font-family:Symbol;
868 mso-bidi-font-family:StarSymbol;}
870 {mso-level-number-format:bullet;
871 mso-level-text:\F0B7;
872 mso-level-tab-stop:99.2pt;
873 mso-level-number-position:left;
875 text-indent:-14.15pt;
876 mso-ansi-font-size:9.0pt;
877 mso-bidi-font-size:9.0pt;
878 mso-ascii-font-family:Symbol;
879 mso-hansi-font-family:Symbol;
880 mso-bidi-font-family:StarSymbol;}
882 {mso-level-number-format:bullet;
883 mso-level-text:\F0B7;
884 mso-level-tab-stop:113.4pt;
885 mso-level-number-position:left;
887 text-indent:-14.15pt;
888 mso-ansi-font-size:9.0pt;
889 mso-bidi-font-size:9.0pt;
890 mso-ascii-font-family:Symbol;
891 mso-hansi-font-family:Symbol;
892 mso-bidi-font-family:StarSymbol;}
894 {mso-level-number-format:bullet;
895 mso-level-text:\F0B7;
896 mso-level-tab-stop:127.55pt;
897 mso-level-number-position:left;
898 margin-left:127.55pt;
899 text-indent:-14.15pt;
900 mso-ansi-font-size:9.0pt;
901 mso-bidi-font-size:9.0pt;
902 mso-ascii-font-family:Symbol;
903 mso-hansi-font-family:Symbol;
904 mso-bidi-font-family:StarSymbol;}
907 mso-list-template-ids:2;}
909 {mso-level-number-format:bullet;
910 mso-level-text:\F0B7;
911 mso-level-tab-stop:14.15pt;
912 mso-level-number-position:left;
914 text-indent:-14.15pt;
915 mso-ansi-font-size:9.0pt;
916 mso-bidi-font-size:9.0pt;
917 mso-ascii-font-family:Symbol;
918 mso-hansi-font-family:Symbol;
919 mso-bidi-font-family:StarSymbol;}
921 {mso-level-number-format:bullet;
922 mso-level-text:\F0B7;
923 mso-level-tab-stop:28.35pt;
924 mso-level-number-position:left;
926 text-indent:-14.15pt;
927 mso-ansi-font-size:9.0pt;
928 mso-bidi-font-size:9.0pt;
929 mso-ascii-font-family:Symbol;
930 mso-hansi-font-family:Symbol;
931 mso-bidi-font-family:StarSymbol;}
933 {mso-level-number-format:bullet;
934 mso-level-text:\F0B7;
935 mso-level-tab-stop:42.5pt;
936 mso-level-number-position:left;
938 text-indent:-14.15pt;
939 mso-ansi-font-size:9.0pt;
940 mso-bidi-font-size:9.0pt;
941 mso-ascii-font-family:Symbol;
942 mso-hansi-font-family:Symbol;
943 mso-bidi-font-family:StarSymbol;}
945 {mso-level-number-format:bullet;
946 mso-level-text:\F0B7;
947 mso-level-tab-stop:56.7pt;
948 mso-level-number-position:left;
950 text-indent:-14.15pt;
951 mso-ansi-font-size:9.0pt;
952 mso-bidi-font-size:9.0pt;
953 mso-ascii-font-family:Symbol;
954 mso-hansi-font-family:Symbol;
955 mso-bidi-font-family:StarSymbol;}
957 {mso-level-number-format:bullet;
958 mso-level-text:\F0B7;
959 mso-level-tab-stop:70.85pt;
960 mso-level-number-position:left;
962 text-indent:-14.15pt;
963 mso-ansi-font-size:9.0pt;
964 mso-bidi-font-size:9.0pt;
965 mso-ascii-font-family:Symbol;
966 mso-hansi-font-family:Symbol;
967 mso-bidi-font-family:StarSymbol;}
969 {mso-level-number-format:bullet;
970 mso-level-text:\F0B7;
971 mso-level-tab-stop:85.05pt;
972 mso-level-number-position:left;
974 text-indent:-14.15pt;
975 mso-ansi-font-size:9.0pt;
976 mso-bidi-font-size:9.0pt;
977 mso-ascii-font-family:Symbol;
978 mso-hansi-font-family:Symbol;
979 mso-bidi-font-family:StarSymbol;}
981 {mso-level-number-format:bullet;
982 mso-level-text:\F0B7;
983 mso-level-tab-stop:99.2pt;
984 mso-level-number-position:left;
986 text-indent:-14.15pt;
987 mso-ansi-font-size:9.0pt;
988 mso-bidi-font-size:9.0pt;
989 mso-ascii-font-family:Symbol;
990 mso-hansi-font-family:Symbol;
991 mso-bidi-font-family:StarSymbol;}
993 {mso-level-number-format:bullet;
994 mso-level-text:\F0B7;
995 mso-level-tab-stop:113.4pt;
996 mso-level-number-position:left;
998 text-indent:-14.15pt;
999 mso-ansi-font-size:9.0pt;
1000 mso-bidi-font-size:9.0pt;
1001 mso-ascii-font-family:Symbol;
1002 mso-hansi-font-family:Symbol;
1003 mso-bidi-font-family:StarSymbol;}
1005 {mso-level-number-format:bullet;
1006 mso-level-text:\F0B7;
1007 mso-level-tab-stop:127.55pt;
1008 mso-level-number-position:left;
1009 margin-left:127.55pt;
1010 text-indent:-14.15pt;
1011 mso-ansi-font-size:9.0pt;
1012 mso-bidi-font-size:9.0pt;
1013 mso-ascii-font-family:Symbol;
1014 mso-hansi-font-family:Symbol;
1015 mso-bidi-font-family:StarSymbol;}
1018 mso-list-template-ids:3;}
1020 {mso-level-number-format:bullet;
1021 mso-level-text:\F0B7;
1022 mso-level-tab-stop:14.15pt;
1023 mso-level-number-position:left;
1024 margin-left:14.15pt;
1025 text-indent:-14.15pt;
1026 mso-ansi-font-size:9.0pt;
1027 mso-bidi-font-size:9.0pt;
1028 mso-ascii-font-family:Symbol;
1029 mso-hansi-font-family:Symbol;
1030 mso-bidi-font-family:StarSymbol;}
1032 {mso-level-number-format:bullet;
1033 mso-level-text:\F0B7;
1034 mso-level-tab-stop:28.35pt;
1035 mso-level-number-position:left;
1036 margin-left:28.35pt;
1037 text-indent:-14.15pt;
1038 mso-ansi-font-size:9.0pt;
1039 mso-bidi-font-size:9.0pt;
1040 mso-ascii-font-family:Symbol;
1041 mso-hansi-font-family:Symbol;
1042 mso-bidi-font-family:StarSymbol;}
1044 {mso-level-number-format:bullet;
1045 mso-level-text:\F0B7;
1046 mso-level-tab-stop:42.5pt;
1047 mso-level-number-position:left;
1049 text-indent:-14.15pt;
1050 mso-ansi-font-size:9.0pt;
1051 mso-bidi-font-size:9.0pt;
1052 mso-ascii-font-family:Symbol;
1053 mso-hansi-font-family:Symbol;
1054 mso-bidi-font-family:StarSymbol;}
1056 {mso-level-number-format:bullet;
1057 mso-level-text:\F0B7;
1058 mso-level-tab-stop:56.7pt;
1059 mso-level-number-position:left;
1061 text-indent:-14.15pt;
1062 mso-ansi-font-size:9.0pt;
1063 mso-bidi-font-size:9.0pt;
1064 mso-ascii-font-family:Symbol;
1065 mso-hansi-font-family:Symbol;
1066 mso-bidi-font-family:StarSymbol;}
1068 {mso-level-number-format:bullet;
1069 mso-level-text:\F0B7;
1070 mso-level-tab-stop:70.85pt;
1071 mso-level-number-position:left;
1072 margin-left:70.85pt;
1073 text-indent:-14.15pt;
1074 mso-ansi-font-size:9.0pt;
1075 mso-bidi-font-size:9.0pt;
1076 mso-ascii-font-family:Symbol;
1077 mso-hansi-font-family:Symbol;
1078 mso-bidi-font-family:StarSymbol;}
1080 {mso-level-number-format:bullet;
1081 mso-level-text:\F0B7;
1082 mso-level-tab-stop:85.05pt;
1083 mso-level-number-position:left;
1084 margin-left:85.05pt;
1085 text-indent:-14.15pt;
1086 mso-ansi-font-size:9.0pt;
1087 mso-bidi-font-size:9.0pt;
1088 mso-ascii-font-family:Symbol;
1089 mso-hansi-font-family:Symbol;
1090 mso-bidi-font-family:StarSymbol;}
1092 {mso-level-number-format:bullet;
1093 mso-level-text:\F0B7;
1094 mso-level-tab-stop:99.2pt;
1095 mso-level-number-position:left;
1097 text-indent:-14.15pt;
1098 mso-ansi-font-size:9.0pt;
1099 mso-bidi-font-size:9.0pt;
1100 mso-ascii-font-family:Symbol;
1101 mso-hansi-font-family:Symbol;
1102 mso-bidi-font-family:StarSymbol;}
1104 {mso-level-number-format:bullet;
1105 mso-level-text:\F0B7;
1106 mso-level-tab-stop:113.4pt;
1107 mso-level-number-position:left;
1108 margin-left:113.4pt;
1109 text-indent:-14.15pt;
1110 mso-ansi-font-size:9.0pt;
1111 mso-bidi-font-size:9.0pt;
1112 mso-ascii-font-family:Symbol;
1113 mso-hansi-font-family:Symbol;
1114 mso-bidi-font-family:StarSymbol;}
1116 {mso-level-number-format:bullet;
1117 mso-level-text:\F0B7;
1118 mso-level-tab-stop:127.55pt;
1119 mso-level-number-position:left;
1120 margin-left:127.55pt;
1121 text-indent:-14.15pt;
1122 mso-ansi-font-size:9.0pt;
1123 mso-bidi-font-size:9.0pt;
1124 mso-ascii-font-family:Symbol;
1125 mso-hansi-font-family:Symbol;
1126 mso-bidi-font-family:StarSymbol;}
1129 mso-list-template-ids:4;}
1131 {mso-level-number-format:bullet;
1132 mso-level-text:\F0B7;
1133 mso-level-tab-stop:14.15pt;
1134 mso-level-number-position:left;
1135 margin-left:14.15pt;
1136 text-indent:-14.15pt;
1137 mso-ansi-font-size:9.0pt;
1138 mso-bidi-font-size:9.0pt;
1139 mso-ascii-font-family:Symbol;
1140 mso-hansi-font-family:Symbol;
1141 mso-bidi-font-family:StarSymbol;}
1143 {mso-level-number-format:bullet;
1144 mso-level-text:\F0B7;
1145 mso-level-tab-stop:28.35pt;
1146 mso-level-number-position:left;
1147 margin-left:28.35pt;
1148 text-indent:-14.15pt;
1149 mso-ansi-font-size:9.0pt;
1150 mso-bidi-font-size:9.0pt;
1151 mso-ascii-font-family:Symbol;
1152 mso-hansi-font-family:Symbol;
1153 mso-bidi-font-family:StarSymbol;}
1155 {mso-level-number-format:bullet;
1156 mso-level-text:\F0B7;
1157 mso-level-tab-stop:42.5pt;
1158 mso-level-number-position:left;
1160 text-indent:-14.15pt;
1161 mso-ansi-font-size:9.0pt;
1162 mso-bidi-font-size:9.0pt;
1163 mso-ascii-font-family:Symbol;
1164 mso-hansi-font-family:Symbol;
1165 mso-bidi-font-family:StarSymbol;}
1167 {mso-level-number-format:bullet;
1168 mso-level-text:\F0B7;
1169 mso-level-tab-stop:56.7pt;
1170 mso-level-number-position:left;
1172 text-indent:-14.15pt;
1173 mso-ansi-font-size:9.0pt;
1174 mso-bidi-font-size:9.0pt;
1175 mso-ascii-font-family:Symbol;
1176 mso-hansi-font-family:Symbol;
1177 mso-bidi-font-family:StarSymbol;}
1179 {mso-level-number-format:bullet;
1180 mso-level-text:\F0B7;
1181 mso-level-tab-stop:70.85pt;
1182 mso-level-number-position:left;
1183 margin-left:70.85pt;
1184 text-indent:-14.15pt;
1185 mso-ansi-font-size:9.0pt;
1186 mso-bidi-font-size:9.0pt;
1187 mso-ascii-font-family:Symbol;
1188 mso-hansi-font-family:Symbol;
1189 mso-bidi-font-family:StarSymbol;}
1191 {mso-level-number-format:bullet;
1192 mso-level-text:\F0B7;
1193 mso-level-tab-stop:85.05pt;
1194 mso-level-number-position:left;
1195 margin-left:85.05pt;
1196 text-indent:-14.15pt;
1197 mso-ansi-font-size:9.0pt;
1198 mso-bidi-font-size:9.0pt;
1199 mso-ascii-font-family:Symbol;
1200 mso-hansi-font-family:Symbol;
1201 mso-bidi-font-family:StarSymbol;}
1203 {mso-level-number-format:bullet;
1204 mso-level-text:\F0B7;
1205 mso-level-tab-stop:99.2pt;
1206 mso-level-number-position:left;
1208 text-indent:-14.15pt;
1209 mso-ansi-font-size:9.0pt;
1210 mso-bidi-font-size:9.0pt;
1211 mso-ascii-font-family:Symbol;
1212 mso-hansi-font-family:Symbol;
1213 mso-bidi-font-family:StarSymbol;}
1215 {mso-level-number-format:bullet;
1216 mso-level-text:\F0B7;
1217 mso-level-tab-stop:113.4pt;
1218 mso-level-number-position:left;
1219 margin-left:113.4pt;
1220 text-indent:-14.15pt;
1221 mso-ansi-font-size:9.0pt;
1222 mso-bidi-font-size:9.0pt;
1223 mso-ascii-font-family:Symbol;
1224 mso-hansi-font-family:Symbol;
1225 mso-bidi-font-family:StarSymbol;}
1227 {mso-level-number-format:bullet;
1228 mso-level-text:\F0B7;
1229 mso-level-tab-stop:127.55pt;
1230 mso-level-number-position:left;
1231 margin-left:127.55pt;
1232 text-indent:-14.15pt;
1233 mso-ansi-font-size:9.0pt;
1234 mso-bidi-font-size:9.0pt;
1235 mso-ascii-font-family:Symbol;
1236 mso-hansi-font-family:Symbol;
1237 mso-bidi-font-family:StarSymbol;}
1240 mso-list-template-ids:5;}
1242 {mso-level-number-format:bullet;
1243 mso-level-text:\F0B7;
1244 mso-level-tab-stop:14.15pt;
1245 mso-level-number-position:left;
1246 margin-left:14.15pt;
1247 text-indent:-14.15pt;
1248 mso-ansi-font-size:9.0pt;
1249 mso-bidi-font-size:9.0pt;
1250 mso-ascii-font-family:Symbol;
1251 mso-hansi-font-family:Symbol;
1252 mso-bidi-font-family:StarSymbol;}
1254 {mso-level-number-format:bullet;
1255 mso-level-text:\F0B7;
1256 mso-level-tab-stop:28.35pt;
1257 mso-level-number-position:left;
1258 margin-left:28.35pt;
1259 text-indent:-14.15pt;
1260 mso-ansi-font-size:9.0pt;
1261 mso-bidi-font-size:9.0pt;
1262 mso-ascii-font-family:Symbol;
1263 mso-hansi-font-family:Symbol;
1264 mso-bidi-font-family:StarSymbol;}
1266 {mso-level-number-format:bullet;
1267 mso-level-text:\F0B7;
1268 mso-level-tab-stop:42.5pt;
1269 mso-level-number-position:left;
1271 text-indent:-14.15pt;
1272 mso-ansi-font-size:9.0pt;
1273 mso-bidi-font-size:9.0pt;
1274 mso-ascii-font-family:Symbol;
1275 mso-hansi-font-family:Symbol;
1276 mso-bidi-font-family:StarSymbol;}
1278 {mso-level-number-format:bullet;
1279 mso-level-text:\F0B7;
1280 mso-level-tab-stop:56.7pt;
1281 mso-level-number-position:left;
1283 text-indent:-14.15pt;
1284 mso-ansi-font-size:9.0pt;
1285 mso-bidi-font-size:9.0pt;
1286 mso-ascii-font-family:Symbol;
1287 mso-hansi-font-family:Symbol;
1288 mso-bidi-font-family:StarSymbol;}
1290 {mso-level-number-format:bullet;
1291 mso-level-text:\F0B7;
1292 mso-level-tab-stop:70.85pt;
1293 mso-level-number-position:left;
1294 margin-left:70.85pt;
1295 text-indent:-14.15pt;
1296 mso-ansi-font-size:9.0pt;
1297 mso-bidi-font-size:9.0pt;
1298 mso-ascii-font-family:Symbol;
1299 mso-hansi-font-family:Symbol;
1300 mso-bidi-font-family:StarSymbol;}
1302 {mso-level-number-format:bullet;
1303 mso-level-text:\F0B7;
1304 mso-level-tab-stop:85.05pt;
1305 mso-level-number-position:left;
1306 margin-left:85.05pt;
1307 text-indent:-14.15pt;
1308 mso-ansi-font-size:9.0pt;
1309 mso-bidi-font-size:9.0pt;
1310 mso-ascii-font-family:Symbol;
1311 mso-hansi-font-family:Symbol;
1312 mso-bidi-font-family:StarSymbol;}
1314 {mso-level-number-format:bullet;
1315 mso-level-text:\F0B7;
1316 mso-level-tab-stop:99.2pt;
1317 mso-level-number-position:left;
1319 text-indent:-14.15pt;
1320 mso-ansi-font-size:9.0pt;
1321 mso-bidi-font-size:9.0pt;
1322 mso-ascii-font-family:Symbol;
1323 mso-hansi-font-family:Symbol;
1324 mso-bidi-font-family:StarSymbol;}
1326 {mso-level-number-format:bullet;
1327 mso-level-text:\F0B7;
1328 mso-level-tab-stop:113.4pt;
1329 mso-level-number-position:left;
1330 margin-left:113.4pt;
1331 text-indent:-14.15pt;
1332 mso-ansi-font-size:9.0pt;
1333 mso-bidi-font-size:9.0pt;
1334 mso-ascii-font-family:Symbol;
1335 mso-hansi-font-family:Symbol;
1336 mso-bidi-font-family:StarSymbol;}
1338 {mso-level-number-format:bullet;
1339 mso-level-text:\F0B7;
1340 mso-level-tab-stop:127.55pt;
1341 mso-level-number-position:left;
1342 margin-left:127.55pt;
1343 text-indent:-14.15pt;
1344 mso-ansi-font-size:9.0pt;
1345 mso-bidi-font-size:9.0pt;
1346 mso-ascii-font-family:Symbol;
1347 mso-hansi-font-family:Symbol;
1348 mso-bidi-font-family:StarSymbol;}
1351 mso-list-template-ids:6;}
1353 {mso-level-number-format:bullet;
1354 mso-level-text:\F0B7;
1355 mso-level-tab-stop:14.15pt;
1356 mso-level-number-position:left;
1357 margin-left:14.15pt;
1358 text-indent:-14.15pt;
1359 mso-ansi-font-size:9.0pt;
1360 mso-bidi-font-size:9.0pt;
1361 mso-ascii-font-family:Symbol;
1362 mso-hansi-font-family:Symbol;
1363 mso-bidi-font-family:StarSymbol;}
1365 {mso-level-number-format:bullet;
1366 mso-level-text:\F0B7;
1367 mso-level-tab-stop:28.35pt;
1368 mso-level-number-position:left;
1369 margin-left:28.35pt;
1370 text-indent:-14.15pt;
1371 mso-ansi-font-size:9.0pt;
1372 mso-bidi-font-size:9.0pt;
1373 mso-ascii-font-family:Symbol;
1374 mso-hansi-font-family:Symbol;
1375 mso-bidi-font-family:StarSymbol;}
1377 {mso-level-number-format:bullet;
1378 mso-level-text:\F0B7;
1379 mso-level-tab-stop:42.5pt;
1380 mso-level-number-position:left;
1382 text-indent:-14.15pt;
1383 mso-ansi-font-size:9.0pt;
1384 mso-bidi-font-size:9.0pt;
1385 mso-ascii-font-family:Symbol;
1386 mso-hansi-font-family:Symbol;
1387 mso-bidi-font-family:StarSymbol;}
1389 {mso-level-number-format:bullet;
1390 mso-level-text:\F0B7;
1391 mso-level-tab-stop:56.7pt;
1392 mso-level-number-position:left;
1394 text-indent:-14.15pt;
1395 mso-ansi-font-size:9.0pt;
1396 mso-bidi-font-size:9.0pt;
1397 mso-ascii-font-family:Symbol;
1398 mso-hansi-font-family:Symbol;
1399 mso-bidi-font-family:StarSymbol;}
1401 {mso-level-number-format:bullet;
1402 mso-level-text:\F0B7;
1403 mso-level-tab-stop:70.85pt;
1404 mso-level-number-position:left;
1405 margin-left:70.85pt;
1406 text-indent:-14.15pt;
1407 mso-ansi-font-size:9.0pt;
1408 mso-bidi-font-size:9.0pt;
1409 mso-ascii-font-family:Symbol;
1410 mso-hansi-font-family:Symbol;
1411 mso-bidi-font-family:StarSymbol;}
1413 {mso-level-number-format:bullet;
1414 mso-level-text:\F0B7;
1415 mso-level-tab-stop:85.05pt;
1416 mso-level-number-position:left;
1417 margin-left:85.05pt;
1418 text-indent:-14.15pt;
1419 mso-ansi-font-size:9.0pt;
1420 mso-bidi-font-size:9.0pt;
1421 mso-ascii-font-family:Symbol;
1422 mso-hansi-font-family:Symbol;
1423 mso-bidi-font-family:StarSymbol;}
1425 {mso-level-number-format:bullet;
1426 mso-level-text:\F0B7;
1427 mso-level-tab-stop:99.2pt;
1428 mso-level-number-position:left;
1430 text-indent:-14.15pt;
1431 mso-ansi-font-size:9.0pt;
1432 mso-bidi-font-size:9.0pt;
1433 mso-ascii-font-family:Symbol;
1434 mso-hansi-font-family:Symbol;
1435 mso-bidi-font-family:StarSymbol;}
1437 {mso-level-number-format:bullet;
1438 mso-level-text:\F0B7;
1439 mso-level-tab-stop:113.4pt;
1440 mso-level-number-position:left;
1441 margin-left:113.4pt;
1442 text-indent:-14.15pt;
1443 mso-ansi-font-size:9.0pt;
1444 mso-bidi-font-size:9.0pt;
1445 mso-ascii-font-family:Symbol;
1446 mso-hansi-font-family:Symbol;
1447 mso-bidi-font-family:StarSymbol;}
1449 {mso-level-number-format:bullet;
1450 mso-level-text:\F0B7;
1451 mso-level-tab-stop:127.55pt;
1452 mso-level-number-position:left;
1453 margin-left:127.55pt;
1454 text-indent:-14.15pt;
1455 mso-ansi-font-size:9.0pt;
1456 mso-bidi-font-size:9.0pt;
1457 mso-ascii-font-family:Symbol;
1458 mso-hansi-font-family:Symbol;
1459 mso-bidi-font-family:StarSymbol;}
1462 mso-list-template-ids:7;}
1464 {mso-level-number-format:bullet;
1465 mso-level-text:\F0B7;
1466 mso-level-tab-stop:14.15pt;
1467 mso-level-number-position:left;
1468 margin-left:14.15pt;
1469 text-indent:-14.15pt;
1470 mso-ansi-font-size:9.0pt;
1471 mso-bidi-font-size:9.0pt;
1472 mso-ascii-font-family:Symbol;
1473 mso-hansi-font-family:Symbol;
1474 mso-bidi-font-family:StarSymbol;}
1476 {mso-level-number-format:bullet;
1477 mso-level-text:\F0B7;
1478 mso-level-tab-stop:28.35pt;
1479 mso-level-number-position:left;
1480 margin-left:28.35pt;
1481 text-indent:-14.15pt;
1482 mso-ansi-font-size:9.0pt;
1483 mso-bidi-font-size:9.0pt;
1484 mso-ascii-font-family:Symbol;
1485 mso-hansi-font-family:Symbol;
1486 mso-bidi-font-family:StarSymbol;}
1488 {mso-level-number-format:bullet;
1489 mso-level-text:\F0B7;
1490 mso-level-tab-stop:42.5pt;
1491 mso-level-number-position:left;
1493 text-indent:-14.15pt;
1494 mso-ansi-font-size:9.0pt;
1495 mso-bidi-font-size:9.0pt;
1496 mso-ascii-font-family:Symbol;
1497 mso-hansi-font-family:Symbol;
1498 mso-bidi-font-family:StarSymbol;}
1500 {mso-level-number-format:bullet;
1501 mso-level-text:\F0B7;
1502 mso-level-tab-stop:56.7pt;
1503 mso-level-number-position:left;
1505 text-indent:-14.15pt;
1506 mso-ansi-font-size:9.0pt;
1507 mso-bidi-font-size:9.0pt;
1508 mso-ascii-font-family:Symbol;
1509 mso-hansi-font-family:Symbol;
1510 mso-bidi-font-family:StarSymbol;}
1512 {mso-level-number-format:bullet;
1513 mso-level-text:\F0B7;
1514 mso-level-tab-stop:70.85pt;
1515 mso-level-number-position:left;
1516 margin-left:70.85pt;
1517 text-indent:-14.15pt;
1518 mso-ansi-font-size:9.0pt;
1519 mso-bidi-font-size:9.0pt;
1520 mso-ascii-font-family:Symbol;
1521 mso-hansi-font-family:Symbol;
1522 mso-bidi-font-family:StarSymbol;}
1524 {mso-level-number-format:bullet;
1525 mso-level-text:\F0B7;
1526 mso-level-tab-stop:85.05pt;
1527 mso-level-number-position:left;
1528 margin-left:85.05pt;
1529 text-indent:-14.15pt;
1530 mso-ansi-font-size:9.0pt;
1531 mso-bidi-font-size:9.0pt;
1532 mso-ascii-font-family:Symbol;
1533 mso-hansi-font-family:Symbol;
1534 mso-bidi-font-family:StarSymbol;}
1536 {mso-level-number-format:bullet;
1537 mso-level-text:\F0B7;
1538 mso-level-tab-stop:99.2pt;
1539 mso-level-number-position:left;
1541 text-indent:-14.15pt;
1542 mso-ansi-font-size:9.0pt;
1543 mso-bidi-font-size:9.0pt;
1544 mso-ascii-font-family:Symbol;
1545 mso-hansi-font-family:Symbol;
1546 mso-bidi-font-family:StarSymbol;}
1548 {mso-level-number-format:bullet;
1549 mso-level-text:\F0B7;
1550 mso-level-tab-stop:113.4pt;
1551 mso-level-number-position:left;
1552 margin-left:113.4pt;
1553 text-indent:-14.15pt;
1554 mso-ansi-font-size:9.0pt;
1555 mso-bidi-font-size:9.0pt;
1556 mso-ascii-font-family:Symbol;
1557 mso-hansi-font-family:Symbol;
1558 mso-bidi-font-family:StarSymbol;}
1560 {mso-level-number-format:bullet;
1561 mso-level-text:\F0B7;
1562 mso-level-tab-stop:127.55pt;
1563 mso-level-number-position:left;
1564 margin-left:127.55pt;
1565 text-indent:-14.15pt;
1566 mso-ansi-font-size:9.0pt;
1567 mso-bidi-font-size:9.0pt;
1568 mso-ascii-font-family:Symbol;
1569 mso-hansi-font-family:Symbol;
1570 mso-bidi-font-family:StarSymbol;}
1573 mso-list-template-ids:8;}
1575 {mso-level-number-format:bullet;
1576 mso-level-text:\F0B7;
1577 mso-level-tab-stop:14.15pt;
1578 mso-level-number-position:left;
1579 margin-left:14.15pt;
1580 text-indent:-14.15pt;
1581 mso-ansi-font-size:9.0pt;
1582 mso-bidi-font-size:9.0pt;
1583 mso-ascii-font-family:Symbol;
1584 mso-hansi-font-family:Symbol;
1585 mso-bidi-font-family:StarSymbol;}
1587 {mso-level-number-format:bullet;
1588 mso-level-text:\F0B7;
1589 mso-level-tab-stop:28.35pt;
1590 mso-level-number-position:left;
1591 margin-left:28.35pt;
1592 text-indent:-14.15pt;
1593 mso-ansi-font-size:9.0pt;
1594 mso-bidi-font-size:9.0pt;
1595 mso-ascii-font-family:Symbol;
1596 mso-hansi-font-family:Symbol;
1597 mso-bidi-font-family:StarSymbol;}
1599 {mso-level-number-format:bullet;
1600 mso-level-text:\F0B7;
1601 mso-level-tab-stop:42.5pt;
1602 mso-level-number-position:left;
1604 text-indent:-14.15pt;
1605 mso-ansi-font-size:9.0pt;
1606 mso-bidi-font-size:9.0pt;
1607 mso-ascii-font-family:Symbol;
1608 mso-hansi-font-family:Symbol;
1609 mso-bidi-font-family:StarSymbol;}
1611 {mso-level-number-format:bullet;
1612 mso-level-text:\F0B7;
1613 mso-level-tab-stop:56.7pt;
1614 mso-level-number-position:left;
1616 text-indent:-14.15pt;
1617 mso-ansi-font-size:9.0pt;
1618 mso-bidi-font-size:9.0pt;
1619 mso-ascii-font-family:Symbol;
1620 mso-hansi-font-family:Symbol;
1621 mso-bidi-font-family:StarSymbol;}
1623 {mso-level-number-format:bullet;
1624 mso-level-text:\F0B7;
1625 mso-level-tab-stop:70.85pt;
1626 mso-level-number-position:left;
1627 margin-left:70.85pt;
1628 text-indent:-14.15pt;
1629 mso-ansi-font-size:9.0pt;
1630 mso-bidi-font-size:9.0pt;
1631 mso-ascii-font-family:Symbol;
1632 mso-hansi-font-family:Symbol;
1633 mso-bidi-font-family:StarSymbol;}
1635 {mso-level-number-format:bullet;
1636 mso-level-text:\F0B7;
1637 mso-level-tab-stop:85.05pt;
1638 mso-level-number-position:left;
1639 margin-left:85.05pt;
1640 text-indent:-14.15pt;
1641 mso-ansi-font-size:9.0pt;
1642 mso-bidi-font-size:9.0pt;
1643 mso-ascii-font-family:Symbol;
1644 mso-hansi-font-family:Symbol;
1645 mso-bidi-font-family:StarSymbol;}
1647 {mso-level-number-format:bullet;
1648 mso-level-text:\F0B7;
1649 mso-level-tab-stop:99.2pt;
1650 mso-level-number-position:left;
1652 text-indent:-14.15pt;
1653 mso-ansi-font-size:9.0pt;
1654 mso-bidi-font-size:9.0pt;
1655 mso-ascii-font-family:Symbol;
1656 mso-hansi-font-family:Symbol;
1657 mso-bidi-font-family:StarSymbol;}
1659 {mso-level-number-format:bullet;
1660 mso-level-text:\F0B7;
1661 mso-level-tab-stop:113.4pt;
1662 mso-level-number-position:left;
1663 margin-left:113.4pt;
1664 text-indent:-14.15pt;
1665 mso-ansi-font-size:9.0pt;
1666 mso-bidi-font-size:9.0pt;
1667 mso-ascii-font-family:Symbol;
1668 mso-hansi-font-family:Symbol;
1669 mso-bidi-font-family:StarSymbol;}
1671 {mso-level-number-format:bullet;
1672 mso-level-text:\F0B7;
1673 mso-level-tab-stop:127.55pt;
1674 mso-level-number-position:left;
1675 margin-left:127.55pt;
1676 text-indent:-14.15pt;
1677 mso-ansi-font-size:9.0pt;
1678 mso-bidi-font-size:9.0pt;
1679 mso-ascii-font-family:Symbol;
1680 mso-hansi-font-family:Symbol;
1681 mso-bidi-font-family:StarSymbol;}
1684 mso-list-template-ids:9;}
1686 {mso-level-number-format:bullet;
1687 mso-level-text:\F0B7;
1688 mso-level-tab-stop:14.15pt;
1689 mso-level-number-position:left;
1690 margin-left:14.15pt;
1691 text-indent:-14.15pt;
1692 mso-ansi-font-size:9.0pt;
1693 mso-bidi-font-size:9.0pt;
1694 mso-ascii-font-family:Symbol;
1695 mso-hansi-font-family:Symbol;
1696 mso-bidi-font-family:StarSymbol;}
1698 {mso-level-number-format:bullet;
1699 mso-level-text:\F0B7;
1700 mso-level-tab-stop:28.35pt;
1701 mso-level-number-position:left;
1702 margin-left:28.35pt;
1703 text-indent:-14.15pt;
1704 mso-ansi-font-size:9.0pt;
1705 mso-bidi-font-size:9.0pt;
1706 mso-ascii-font-family:Symbol;
1707 mso-hansi-font-family:Symbol;
1708 mso-bidi-font-family:StarSymbol;}
1710 {mso-level-number-format:bullet;
1711 mso-level-text:\F0B7;
1712 mso-level-tab-stop:42.5pt;
1713 mso-level-number-position:left;
1715 text-indent:-14.15pt;
1716 mso-ansi-font-size:9.0pt;
1717 mso-bidi-font-size:9.0pt;
1718 mso-ascii-font-family:Symbol;
1719 mso-hansi-font-family:Symbol;
1720 mso-bidi-font-family:StarSymbol;}
1722 {mso-level-number-format:bullet;
1723 mso-level-text:\F0B7;
1724 mso-level-tab-stop:56.7pt;
1725 mso-level-number-position:left;
1727 text-indent:-14.15pt;
1728 mso-ansi-font-size:9.0pt;
1729 mso-bidi-font-size:9.0pt;
1730 mso-ascii-font-family:Symbol;
1731 mso-hansi-font-family:Symbol;
1732 mso-bidi-font-family:StarSymbol;}
1734 {mso-level-number-format:bullet;
1735 mso-level-text:\F0B7;
1736 mso-level-tab-stop:70.85pt;
1737 mso-level-number-position:left;
1738 margin-left:70.85pt;
1739 text-indent:-14.15pt;
1740 mso-ansi-font-size:9.0pt;
1741 mso-bidi-font-size:9.0pt;
1742 mso-ascii-font-family:Symbol;
1743 mso-hansi-font-family:Symbol;
1744 mso-bidi-font-family:StarSymbol;}
1746 {mso-level-number-format:bullet;
1747 mso-level-text:\F0B7;
1748 mso-level-tab-stop:85.05pt;
1749 mso-level-number-position:left;
1750 margin-left:85.05pt;
1751 text-indent:-14.15pt;
1752 mso-ansi-font-size:9.0pt;
1753 mso-bidi-font-size:9.0pt;
1754 mso-ascii-font-family:Symbol;
1755 mso-hansi-font-family:Symbol;
1756 mso-bidi-font-family:StarSymbol;}
1758 {mso-level-number-format:bullet;
1759 mso-level-text:\F0B7;
1760 mso-level-tab-stop:99.2pt;
1761 mso-level-number-position:left;
1763 text-indent:-14.15pt;
1764 mso-ansi-font-size:9.0pt;
1765 mso-bidi-font-size:9.0pt;
1766 mso-ascii-font-family:Symbol;
1767 mso-hansi-font-family:Symbol;
1768 mso-bidi-font-family:StarSymbol;}
1770 {mso-level-number-format:bullet;
1771 mso-level-text:\F0B7;
1772 mso-level-tab-stop:113.4pt;
1773 mso-level-number-position:left;
1774 margin-left:113.4pt;
1775 text-indent:-14.15pt;
1776 mso-ansi-font-size:9.0pt;
1777 mso-bidi-font-size:9.0pt;
1778 mso-ascii-font-family:Symbol;
1779 mso-hansi-font-family:Symbol;
1780 mso-bidi-font-family:StarSymbol;}
1782 {mso-level-number-format:bullet;
1783 mso-level-text:\F0B7;
1784 mso-level-tab-stop:127.55pt;
1785 mso-level-number-position:left;
1786 margin-left:127.55pt;
1787 text-indent:-14.15pt;
1788 mso-ansi-font-size:9.0pt;
1789 mso-bidi-font-size:9.0pt;
1790 mso-ascii-font-family:Symbol;
1791 mso-hansi-font-family:Symbol;
1792 mso-bidi-font-family:StarSymbol;}
1795 mso-list-template-ids:10;}
1797 {mso-level-number-format:bullet;
1798 mso-level-text:\F0B7;
1799 mso-level-tab-stop:14.15pt;
1800 mso-level-number-position:left;
1801 margin-left:14.15pt;
1802 text-indent:-14.15pt;
1803 mso-ansi-font-size:9.0pt;
1804 mso-bidi-font-size:9.0pt;
1805 mso-ascii-font-family:Symbol;
1806 mso-hansi-font-family:Symbol;
1807 mso-bidi-font-family:StarSymbol;}
1809 {mso-level-number-format:bullet;
1810 mso-level-text:\F0B7;
1811 mso-level-tab-stop:28.35pt;
1812 mso-level-number-position:left;
1813 margin-left:28.35pt;
1814 text-indent:-14.15pt;
1815 mso-ansi-font-size:9.0pt;
1816 mso-bidi-font-size:9.0pt;
1817 mso-ascii-font-family:Symbol;
1818 mso-hansi-font-family:Symbol;
1819 mso-bidi-font-family:StarSymbol;}
1821 {mso-level-number-format:bullet;
1822 mso-level-text:\F0B7;
1823 mso-level-tab-stop:42.5pt;
1824 mso-level-number-position:left;
1826 text-indent:-14.15pt;
1827 mso-ansi-font-size:9.0pt;
1828 mso-bidi-font-size:9.0pt;
1829 mso-ascii-font-family:Symbol;
1830 mso-hansi-font-family:Symbol;
1831 mso-bidi-font-family:StarSymbol;}
1833 {mso-level-number-format:bullet;
1834 mso-level-text:\F0B7;
1835 mso-level-tab-stop:56.7pt;
1836 mso-level-number-position:left;
1838 text-indent:-14.15pt;
1839 mso-ansi-font-size:9.0pt;
1840 mso-bidi-font-size:9.0pt;
1841 mso-ascii-font-family:Symbol;
1842 mso-hansi-font-family:Symbol;
1843 mso-bidi-font-family:StarSymbol;}
1845 {mso-level-number-format:bullet;
1846 mso-level-text:\F0B7;
1847 mso-level-tab-stop:70.85pt;
1848 mso-level-number-position:left;
1849 margin-left:70.85pt;
1850 text-indent:-14.15pt;
1851 mso-ansi-font-size:9.0pt;
1852 mso-bidi-font-size:9.0pt;
1853 mso-ascii-font-family:Symbol;
1854 mso-hansi-font-family:Symbol;
1855 mso-bidi-font-family:StarSymbol;}
1857 {mso-level-number-format:bullet;
1858 mso-level-text:\F0B7;
1859 mso-level-tab-stop:85.05pt;
1860 mso-level-number-position:left;
1861 margin-left:85.05pt;
1862 text-indent:-14.15pt;
1863 mso-ansi-font-size:9.0pt;
1864 mso-bidi-font-size:9.0pt;
1865 mso-ascii-font-family:Symbol;
1866 mso-hansi-font-family:Symbol;
1867 mso-bidi-font-family:StarSymbol;}
1869 {mso-level-number-format:bullet;
1870 mso-level-text:\F0B7;
1871 mso-level-tab-stop:99.2pt;
1872 mso-level-number-position:left;
1874 text-indent:-14.15pt;
1875 mso-ansi-font-size:9.0pt;
1876 mso-bidi-font-size:9.0pt;
1877 mso-ascii-font-family:Symbol;
1878 mso-hansi-font-family:Symbol;
1879 mso-bidi-font-family:StarSymbol;}
1881 {mso-level-number-format:bullet;
1882 mso-level-text:\F0B7;
1883 mso-level-tab-stop:113.4pt;
1884 mso-level-number-position:left;
1885 margin-left:113.4pt;
1886 text-indent:-14.15pt;
1887 mso-ansi-font-size:9.0pt;
1888 mso-bidi-font-size:9.0pt;
1889 mso-ascii-font-family:Symbol;
1890 mso-hansi-font-family:Symbol;
1891 mso-bidi-font-family:StarSymbol;}
1893 {mso-level-number-format:bullet;
1894 mso-level-text:\F0B7;
1895 mso-level-tab-stop:127.55pt;
1896 mso-level-number-position:left;
1897 margin-left:127.55pt;
1898 text-indent:-14.15pt;
1899 mso-ansi-font-size:9.0pt;
1900 mso-bidi-font-size:9.0pt;
1901 mso-ascii-font-family:Symbol;
1902 mso-hansi-font-family:Symbol;
1903 mso-bidi-font-family:StarSymbol;}
1906 mso-list-template-ids:11;}
1908 {mso-level-number-format:bullet;
1909 mso-level-text:\F0B7;
1910 mso-level-tab-stop:14.15pt;
1911 mso-level-number-position:left;
1912 margin-left:14.15pt;
1913 text-indent:-14.15pt;
1914 mso-ansi-font-size:9.0pt;
1915 mso-bidi-font-size:9.0pt;
1916 mso-ascii-font-family:Symbol;
1917 mso-hansi-font-family:Symbol;
1918 mso-bidi-font-family:StarSymbol;}
1920 {mso-level-number-format:bullet;
1921 mso-level-text:\F0B7;
1922 mso-level-tab-stop:28.35pt;
1923 mso-level-number-position:left;
1924 margin-left:28.35pt;
1925 text-indent:-14.15pt;
1926 mso-ansi-font-size:9.0pt;
1927 mso-bidi-font-size:9.0pt;
1928 mso-ascii-font-family:Symbol;
1929 mso-hansi-font-family:Symbol;
1930 mso-bidi-font-family:StarSymbol;}
1932 {mso-level-number-format:bullet;
1933 mso-level-text:\F0B7;
1934 mso-level-tab-stop:42.5pt;
1935 mso-level-number-position:left;
1937 text-indent:-14.15pt;
1938 mso-ansi-font-size:9.0pt;
1939 mso-bidi-font-size:9.0pt;
1940 mso-ascii-font-family:Symbol;
1941 mso-hansi-font-family:Symbol;
1942 mso-bidi-font-family:StarSymbol;}
1944 {mso-level-number-format:bullet;
1945 mso-level-text:\F0B7;
1946 mso-level-tab-stop:56.7pt;
1947 mso-level-number-position:left;
1949 text-indent:-14.15pt;
1950 mso-ansi-font-size:9.0pt;
1951 mso-bidi-font-size:9.0pt;
1952 mso-ascii-font-family:Symbol;
1953 mso-hansi-font-family:Symbol;
1954 mso-bidi-font-family:StarSymbol;}
1956 {mso-level-number-format:bullet;
1957 mso-level-text:\F0B7;
1958 mso-level-tab-stop:70.85pt;
1959 mso-level-number-position:left;
1960 margin-left:70.85pt;
1961 text-indent:-14.15pt;
1962 mso-ansi-font-size:9.0pt;
1963 mso-bidi-font-size:9.0pt;
1964 mso-ascii-font-family:Symbol;
1965 mso-hansi-font-family:Symbol;
1966 mso-bidi-font-family:StarSymbol;}
1968 {mso-level-number-format:bullet;
1969 mso-level-text:\F0B7;
1970 mso-level-tab-stop:85.05pt;
1971 mso-level-number-position:left;
1972 margin-left:85.05pt;
1973 text-indent:-14.15pt;
1974 mso-ansi-font-size:9.0pt;
1975 mso-bidi-font-size:9.0pt;
1976 mso-ascii-font-family:Symbol;
1977 mso-hansi-font-family:Symbol;
1978 mso-bidi-font-family:StarSymbol;}
1980 {mso-level-number-format:bullet;
1981 mso-level-text:\F0B7;
1982 mso-level-tab-stop:99.2pt;
1983 mso-level-number-position:left;
1985 text-indent:-14.15pt;
1986 mso-ansi-font-size:9.0pt;
1987 mso-bidi-font-size:9.0pt;
1988 mso-ascii-font-family:Symbol;
1989 mso-hansi-font-family:Symbol;
1990 mso-bidi-font-family:StarSymbol;}
1992 {mso-level-number-format:bullet;
1993 mso-level-text:\F0B7;
1994 mso-level-tab-stop:113.4pt;
1995 mso-level-number-position:left;
1996 margin-left:113.4pt;
1997 text-indent:-14.15pt;
1998 mso-ansi-font-size:9.0pt;
1999 mso-bidi-font-size:9.0pt;
2000 mso-ascii-font-family:Symbol;
2001 mso-hansi-font-family:Symbol;
2002 mso-bidi-font-family:StarSymbol;}
2004 {mso-level-number-format:bullet;
2005 mso-level-text:\F0B7;
2006 mso-level-tab-stop:127.55pt;
2007 mso-level-number-position:left;
2008 margin-left:127.55pt;
2009 text-indent:-14.15pt;
2010 mso-ansi-font-size:9.0pt;
2011 mso-bidi-font-size:9.0pt;
2012 mso-ascii-font-family:Symbol;
2013 mso-hansi-font-family:Symbol;
2014 mso-bidi-font-family:StarSymbol;}
2017 mso-list-template-ids:12;}
2019 {mso-level-number-format:none;
2021 mso-level-tab-stop:0pt;
2022 mso-level-number-position:left;
2026 {mso-level-number-format:none;
2028 mso-level-tab-stop:0pt;
2029 mso-level-number-position:left;
2033 {mso-level-number-format:none;
2035 mso-level-tab-stop:0pt;
2036 mso-level-number-position:left;
2040 {mso-level-number-format:none;
2042 mso-level-tab-stop:0pt;
2043 mso-level-number-position:left;
2047 {mso-level-number-format:none;
2049 mso-level-tab-stop:0pt;
2050 mso-level-number-position:left;
2054 {mso-level-number-format:none;
2056 mso-level-tab-stop:0pt;
2057 mso-level-number-position:left;
2061 {mso-level-number-format:none;
2063 mso-level-tab-stop:0pt;
2064 mso-level-number-position:left;
2068 {mso-level-number-format:none;
2070 mso-level-tab-stop:0pt;
2071 mso-level-number-position:left;
2075 {mso-level-number-format:none;
2077 mso-level-tab-stop:0pt;
2078 mso-level-number-position:left;
2082 {mso-list-id:116531205;
2083 mso-list-template-ids:-1288027304;}
2085 {mso-level-text:"%1\)";
2086 mso-level-tab-stop:36.0pt;
2087 mso-level-number-position:left;
2088 text-indent:-18.0pt;}
2090 {mso-list-id:276641855;
2091 mso-list-template-ids:67698719;}
2093 {mso-level-tab-stop:18.0pt;
2094 mso-level-number-position:left;
2096 text-indent:-18.0pt;}
2098 {mso-level-text:"%1\.%2\.";
2099 mso-level-tab-stop:39.6pt;
2100 mso-level-number-position:left;
2102 text-indent:-21.6pt;}
2104 {mso-level-text:"%1\.%2\.%3\.";
2105 mso-level-tab-stop:72.0pt;
2106 mso-level-number-position:left;
2108 text-indent:-25.2pt;}
2110 {mso-level-text:"%1\.%2\.%3\.%4\.";
2111 mso-level-tab-stop:90.0pt;
2112 mso-level-number-position:left;
2114 text-indent:-32.4pt;}
2116 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.";
2117 mso-level-tab-stop:126.0pt;
2118 mso-level-number-position:left;
2119 margin-left:111.6pt;
2120 text-indent:-39.6pt;}
2122 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.";
2123 mso-level-tab-stop:144.0pt;
2124 mso-level-number-position:left;
2125 margin-left:136.8pt;
2126 text-indent:-46.8pt;}
2128 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.";
2129 mso-level-tab-stop:180.0pt;
2130 mso-level-number-position:left;
2131 margin-left:162.0pt;
2132 text-indent:-54.0pt;}
2134 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.";
2135 mso-level-tab-stop:198.0pt;
2136 mso-level-number-position:left;
2137 margin-left:187.2pt;
2138 text-indent:-61.2pt;}
2140 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.%9\.";
2141 mso-level-tab-stop:234.0pt;
2142 mso-level-number-position:left;
2143 margin-left:216.0pt;
2144 text-indent:-72.0pt;}
2146 {mso-list-id:291328403;
2147 mso-list-template-ids:1148726518;}
2149 {mso-level-tab-stop:18.0pt;
2150 mso-level-number-position:left;
2152 text-indent:-18.0pt;
2153 mso-ansi-font-size:9.0pt;
2154 mso-bidi-font-size:9.0pt;}
2156 {mso-level-number-format:bullet;
2157 mso-level-text:\F0B7;
2158 mso-level-tab-stop:28.35pt;
2159 mso-level-number-position:left;
2160 margin-left:28.35pt;
2161 text-indent:-14.15pt;
2162 mso-ansi-font-size:9.0pt;
2163 mso-bidi-font-size:9.0pt;
2164 mso-ascii-font-family:Symbol;
2165 mso-hansi-font-family:Symbol;
2166 mso-bidi-font-family:StarSymbol;}
2168 {mso-level-number-format:bullet;
2169 mso-level-text:\F0B7;
2170 mso-level-tab-stop:42.5pt;
2171 mso-level-number-position:left;
2173 text-indent:-14.15pt;
2174 mso-ansi-font-size:9.0pt;
2175 mso-bidi-font-size:9.0pt;
2176 mso-ascii-font-family:Symbol;
2177 mso-hansi-font-family:Symbol;
2178 mso-bidi-font-family:StarSymbol;}
2180 {mso-level-number-format:bullet;
2181 mso-level-text:\F0B7;
2182 mso-level-tab-stop:56.7pt;
2183 mso-level-number-position:left;
2185 text-indent:-14.15pt;
2186 mso-ansi-font-size:9.0pt;
2187 mso-bidi-font-size:9.0pt;
2188 mso-ascii-font-family:Symbol;
2189 mso-hansi-font-family:Symbol;
2190 mso-bidi-font-family:StarSymbol;}
2192 {mso-level-number-format:bullet;
2193 mso-level-text:\F0B7;
2194 mso-level-tab-stop:70.85pt;
2195 mso-level-number-position:left;
2196 margin-left:70.85pt;
2197 text-indent:-14.15pt;
2198 mso-ansi-font-size:9.0pt;
2199 mso-bidi-font-size:9.0pt;
2200 mso-ascii-font-family:Symbol;
2201 mso-hansi-font-family:Symbol;
2202 mso-bidi-font-family:StarSymbol;}
2204 {mso-level-number-format:bullet;
2205 mso-level-text:\F0B7;
2206 mso-level-tab-stop:85.05pt;
2207 mso-level-number-position:left;
2208 margin-left:85.05pt;
2209 text-indent:-14.15pt;
2210 mso-ansi-font-size:9.0pt;
2211 mso-bidi-font-size:9.0pt;
2212 mso-ascii-font-family:Symbol;
2213 mso-hansi-font-family:Symbol;
2214 mso-bidi-font-family:StarSymbol;}
2216 {mso-level-number-format:bullet;
2217 mso-level-text:\F0B7;
2218 mso-level-tab-stop:99.2pt;
2219 mso-level-number-position:left;
2221 text-indent:-14.15pt;
2222 mso-ansi-font-size:9.0pt;
2223 mso-bidi-font-size:9.0pt;
2224 mso-ascii-font-family:Symbol;
2225 mso-hansi-font-family:Symbol;
2226 mso-bidi-font-family:StarSymbol;}
2228 {mso-level-number-format:bullet;
2229 mso-level-text:\F0B7;
2230 mso-level-tab-stop:113.4pt;
2231 mso-level-number-position:left;
2232 margin-left:113.4pt;
2233 text-indent:-14.15pt;
2234 mso-ansi-font-size:9.0pt;
2235 mso-bidi-font-size:9.0pt;
2236 mso-ascii-font-family:Symbol;
2237 mso-hansi-font-family:Symbol;
2238 mso-bidi-font-family:StarSymbol;}
2240 {mso-level-number-format:bullet;
2241 mso-level-text:\F0B7;
2242 mso-level-tab-stop:127.55pt;
2243 mso-level-number-position:left;
2244 margin-left:127.55pt;
2245 text-indent:-14.15pt;
2246 mso-ansi-font-size:9.0pt;
2247 mso-bidi-font-size:9.0pt;
2248 mso-ascii-font-family:Symbol;
2249 mso-hansi-font-family:Symbol;
2250 mso-bidi-font-family:StarSymbol;}
2252 {mso-list-id:465316796;
2253 mso-list-type:hybrid;
2254 mso-list-template-ids:747157604 -1330584532 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
2256 {mso-level-start-at:0;
2257 mso-level-number-format:bullet;
2258 mso-level-text:\F0D8;
2259 mso-level-tab-stop:36.0pt;
2260 mso-level-number-position:left;
2261 text-indent:-18.0pt;
2262 font-family:Wingdings;
2263 mso-fareast-font-family:Cumberland;
2264 mso-bidi-font-family:Cumberland;}
2266 {mso-list-id:604534799;
2267 mso-list-template-ids:1659901228;}
2269 {mso-level-number-format:bullet;
2270 mso-level-text:\F0B7;
2271 mso-level-tab-stop:36.0pt;
2272 mso-level-number-position:left;
2273 text-indent:-18.0pt;
2274 font-family:Symbol;}
2276 {mso-level-number-format:bullet;
2278 mso-level-tab-stop:72.0pt;
2279 mso-level-number-position:left;
2280 text-indent:-18.0pt;
2281 font-family:"Courier New";}
2283 {mso-level-number-format:bullet;
2284 mso-level-text:\F0A7;
2285 mso-level-tab-stop:108.0pt;
2286 mso-level-number-position:left;
2287 text-indent:-18.0pt;
2288 font-family:Wingdings;}
2290 {mso-level-number-format:bullet;
2291 mso-level-text:\F0B7;
2292 mso-level-tab-stop:144.0pt;
2293 mso-level-number-position:left;
2294 text-indent:-18.0pt;
2295 font-family:Symbol;}
2297 {mso-level-number-format:bullet;
2299 mso-level-tab-stop:180.0pt;
2300 mso-level-number-position:left;
2301 text-indent:-18.0pt;
2302 font-family:"Courier New";}
2304 {mso-level-number-format:bullet;
2305 mso-level-text:\F0A7;
2306 mso-level-tab-stop:216.0pt;
2307 mso-level-number-position:left;
2308 text-indent:-18.0pt;
2309 font-family:Wingdings;}
2311 {mso-level-number-format:bullet;
2312 mso-level-text:\F0B7;
2313 mso-level-tab-stop:252.0pt;
2314 mso-level-number-position:left;
2315 text-indent:-18.0pt;
2316 font-family:Symbol;}
2318 {mso-level-number-format:bullet;
2320 mso-level-tab-stop:288.0pt;
2321 mso-level-number-position:left;
2322 text-indent:-18.0pt;
2323 font-family:"Courier New";}
2325 {mso-level-number-format:bullet;
2326 mso-level-text:\F0A7;
2327 mso-level-tab-stop:324.0pt;
2328 mso-level-number-position:left;
2329 text-indent:-18.0pt;
2330 font-family:Wingdings;}
2332 {mso-list-id:671564588;
2333 mso-list-template-ids:67698719;}
2335 {mso-level-tab-stop:18.0pt;
2336 mso-level-number-position:left;
2338 text-indent:-18.0pt;}
2340 {mso-level-text:"%1\.%2\.";
2341 mso-level-tab-stop:39.6pt;
2342 mso-level-number-position:left;
2344 text-indent:-21.6pt;}
2346 {mso-level-text:"%1\.%2\.%3\.";
2347 mso-level-tab-stop:72.0pt;
2348 mso-level-number-position:left;
2350 text-indent:-25.2pt;}
2352 {mso-level-text:"%1\.%2\.%3\.%4\.";
2353 mso-level-tab-stop:90.0pt;
2354 mso-level-number-position:left;
2356 text-indent:-32.4pt;}
2358 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.";
2359 mso-level-tab-stop:126.0pt;
2360 mso-level-number-position:left;
2361 margin-left:111.6pt;
2362 text-indent:-39.6pt;}
2364 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.";
2365 mso-level-tab-stop:144.0pt;
2366 mso-level-number-position:left;
2367 margin-left:136.8pt;
2368 text-indent:-46.8pt;}
2370 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.";
2371 mso-level-tab-stop:180.0pt;
2372 mso-level-number-position:left;
2373 margin-left:162.0pt;
2374 text-indent:-54.0pt;}
2376 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.";
2377 mso-level-tab-stop:198.0pt;
2378 mso-level-number-position:left;
2379 margin-left:187.2pt;
2380 text-indent:-61.2pt;}
2382 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.%9\.";
2383 mso-level-tab-stop:234.0pt;
2384 mso-level-number-position:left;
2385 margin-left:216.0pt;
2386 text-indent:-72.0pt;}
2388 {mso-list-id:696472061;
2389 mso-list-type:hybrid;
2390 mso-list-template-ids:986222236 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
2392 {mso-level-number-format:bullet;
2393 mso-level-text:\F0B7;
2394 mso-level-tab-stop:36.0pt;
2395 mso-level-number-position:left;
2396 text-indent:-18.0pt;
2397 font-family:Symbol;}
2399 {mso-list-id:718094992;
2400 mso-list-type:hybrid;
2401 mso-list-template-ids:-1288027304 67698705 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
2403 {mso-level-text:"%1\)";
2404 mso-level-tab-stop:36.0pt;
2405 mso-level-number-position:left;
2406 text-indent:-18.0pt;}
2408 {mso-list-id:753824527;
2409 mso-list-type:hybrid;
2410 mso-list-template-ids:-1854628230 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
2412 {mso-level-number-format:bullet;
2413 mso-level-text:\F0B7;
2414 mso-level-tab-stop:36.0pt;
2415 mso-level-number-position:left;
2416 text-indent:-18.0pt;
2417 font-family:Symbol;}
2419 {mso-list-id:803735998;
2420 mso-list-type:hybrid;
2421 mso-list-template-ids:58764522 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
2423 {mso-level-number-format:bullet;
2424 mso-level-text:\F0B7;
2425 mso-level-tab-stop:36.0pt;
2426 mso-level-number-position:left;
2427 text-indent:-18.0pt;
2428 font-family:Symbol;}
2430 {mso-list-id:858816198;
2431 mso-list-template-ids:1148726518;}
2433 {mso-level-tab-stop:18.0pt;
2434 mso-level-number-position:left;
2436 text-indent:-18.0pt;
2437 mso-ansi-font-size:9.0pt;
2438 mso-bidi-font-size:9.0pt;}
2440 {mso-level-number-format:bullet;
2441 mso-level-text:\F0B7;
2442 mso-level-tab-stop:28.35pt;
2443 mso-level-number-position:left;
2444 margin-left:28.35pt;
2445 text-indent:-14.15pt;
2446 mso-ansi-font-size:9.0pt;
2447 mso-bidi-font-size:9.0pt;
2448 mso-ascii-font-family:Symbol;
2449 mso-hansi-font-family:Symbol;
2450 mso-bidi-font-family:StarSymbol;}
2452 {mso-level-number-format:bullet;
2453 mso-level-text:\F0B7;
2454 mso-level-tab-stop:42.5pt;
2455 mso-level-number-position:left;
2457 text-indent:-14.15pt;
2458 mso-ansi-font-size:9.0pt;
2459 mso-bidi-font-size:9.0pt;
2460 mso-ascii-font-family:Symbol;
2461 mso-hansi-font-family:Symbol;
2462 mso-bidi-font-family:StarSymbol;}
2464 {mso-level-number-format:bullet;
2465 mso-level-text:\F0B7;
2466 mso-level-tab-stop:56.7pt;
2467 mso-level-number-position:left;
2469 text-indent:-14.15pt;
2470 mso-ansi-font-size:9.0pt;
2471 mso-bidi-font-size:9.0pt;
2472 mso-ascii-font-family:Symbol;
2473 mso-hansi-font-family:Symbol;
2474 mso-bidi-font-family:StarSymbol;}
2476 {mso-level-number-format:bullet;
2477 mso-level-text:\F0B7;
2478 mso-level-tab-stop:70.85pt;
2479 mso-level-number-position:left;
2480 margin-left:70.85pt;
2481 text-indent:-14.15pt;
2482 mso-ansi-font-size:9.0pt;
2483 mso-bidi-font-size:9.0pt;
2484 mso-ascii-font-family:Symbol;
2485 mso-hansi-font-family:Symbol;
2486 mso-bidi-font-family:StarSymbol;}
2488 {mso-level-number-format:bullet;
2489 mso-level-text:\F0B7;
2490 mso-level-tab-stop:85.05pt;
2491 mso-level-number-position:left;
2492 margin-left:85.05pt;
2493 text-indent:-14.15pt;
2494 mso-ansi-font-size:9.0pt;
2495 mso-bidi-font-size:9.0pt;
2496 mso-ascii-font-family:Symbol;
2497 mso-hansi-font-family:Symbol;
2498 mso-bidi-font-family:StarSymbol;}
2500 {mso-level-number-format:bullet;
2501 mso-level-text:\F0B7;
2502 mso-level-tab-stop:99.2pt;
2503 mso-level-number-position:left;
2505 text-indent:-14.15pt;
2506 mso-ansi-font-size:9.0pt;
2507 mso-bidi-font-size:9.0pt;
2508 mso-ascii-font-family:Symbol;
2509 mso-hansi-font-family:Symbol;
2510 mso-bidi-font-family:StarSymbol;}
2512 {mso-level-number-format:bullet;
2513 mso-level-text:\F0B7;
2514 mso-level-tab-stop:113.4pt;
2515 mso-level-number-position:left;
2516 margin-left:113.4pt;
2517 text-indent:-14.15pt;
2518 mso-ansi-font-size:9.0pt;
2519 mso-bidi-font-size:9.0pt;
2520 mso-ascii-font-family:Symbol;
2521 mso-hansi-font-family:Symbol;
2522 mso-bidi-font-family:StarSymbol;}
2524 {mso-level-number-format:bullet;
2525 mso-level-text:\F0B7;
2526 mso-level-tab-stop:127.55pt;
2527 mso-level-number-position:left;
2528 margin-left:127.55pt;
2529 text-indent:-14.15pt;
2530 mso-ansi-font-size:9.0pt;
2531 mso-bidi-font-size:9.0pt;
2532 mso-ascii-font-family:Symbol;
2533 mso-hansi-font-family:Symbol;
2534 mso-bidi-font-family:StarSymbol;}
2536 {mso-list-id:865482897;
2537 mso-list-type:hybrid;
2538 mso-list-template-ids:-2013987438 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
2540 {mso-level-tab-stop:36.0pt;
2541 mso-level-number-position:left;
2542 text-indent:-18.0pt;}
2544 {mso-list-id:1082213354;
2545 mso-list-type:hybrid;
2546 mso-list-template-ids:1622673204 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
2548 {mso-level-tab-stop:36.0pt;
2549 mso-level-number-position:left;
2550 text-indent:-18.0pt;}
2552 {mso-list-id:1281301046;
2553 mso-list-type:hybrid;
2554 mso-list-template-ids:1985279396 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
2556 {mso-level-tab-stop:36.0pt;
2557 mso-level-number-position:left;
2558 text-indent:-18.0pt;}
2560 {mso-list-id:1320424235;
2561 mso-list-template-ids:-1854628230;}
2563 {mso-level-number-format:bullet;
2564 mso-level-text:\F0B7;
2565 mso-level-tab-stop:36.0pt;
2566 mso-level-number-position:left;
2567 text-indent:-18.0pt;
2568 font-family:Symbol;}
2570 {mso-level-number-format:bullet;
2572 mso-level-tab-stop:72.0pt;
2573 mso-level-number-position:left;
2574 text-indent:-18.0pt;
2575 font-family:"Courier New";}
2577 {mso-level-number-format:bullet;
2578 mso-level-text:\F0A7;
2579 mso-level-tab-stop:108.0pt;
2580 mso-level-number-position:left;
2581 text-indent:-18.0pt;
2582 font-family:Wingdings;}
2584 {mso-level-number-format:bullet;
2585 mso-level-text:\F0B7;
2586 mso-level-tab-stop:144.0pt;
2587 mso-level-number-position:left;
2588 text-indent:-18.0pt;
2589 font-family:Symbol;}
2591 {mso-level-number-format:bullet;
2593 mso-level-tab-stop:180.0pt;
2594 mso-level-number-position:left;
2595 text-indent:-18.0pt;
2596 font-family:"Courier New";}
2598 {mso-level-number-format:bullet;
2599 mso-level-text:\F0A7;
2600 mso-level-tab-stop:216.0pt;
2601 mso-level-number-position:left;
2602 text-indent:-18.0pt;
2603 font-family:Wingdings;}
2605 {mso-level-number-format:bullet;
2606 mso-level-text:\F0B7;
2607 mso-level-tab-stop:252.0pt;
2608 mso-level-number-position:left;
2609 text-indent:-18.0pt;
2610 font-family:Symbol;}
2612 {mso-level-number-format:bullet;
2614 mso-level-tab-stop:288.0pt;
2615 mso-level-number-position:left;
2616 text-indent:-18.0pt;
2617 font-family:"Courier New";}
2619 {mso-level-number-format:bullet;
2620 mso-level-text:\F0A7;
2621 mso-level-tab-stop:324.0pt;
2622 mso-level-number-position:left;
2623 text-indent:-18.0pt;
2624 font-family:Wingdings;}
2626 {mso-list-id:1438016346;
2627 mso-list-type:hybrid;
2628 mso-list-template-ids:1659901228 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
2630 {mso-level-number-format:bullet;
2631 mso-level-text:\F0B7;
2632 mso-level-tab-stop:36.0pt;
2633 mso-level-number-position:left;
2634 text-indent:-18.0pt;
2635 font-family:Symbol;}
2637 {mso-list-id:1495950886;
2638 mso-list-type:hybrid;
2639 mso-list-template-ids:-898045188 -1269669692 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
2641 {mso-level-start-at:0;
2642 mso-level-number-format:bullet;
2643 mso-level-text:\F0D8;
2644 mso-level-tab-stop:36.0pt;
2645 mso-level-number-position:left;
2646 text-indent:-18.0pt;
2647 font-family:Wingdings;
2648 mso-fareast-font-family:Cumberland;
2649 mso-bidi-font-family:Cumberland;}
2651 {mso-list-id:1678120386;
2652 mso-list-template-ids:58764522;}
2654 {mso-level-number-format:bullet;
2655 mso-level-text:\F0B7;
2656 mso-level-tab-stop:36.0pt;
2657 mso-level-number-position:left;
2658 text-indent:-18.0pt;
2659 font-family:Symbol;}
2661 {mso-level-number-format:bullet;
2663 mso-level-tab-stop:72.0pt;
2664 mso-level-number-position:left;
2665 text-indent:-18.0pt;
2666 font-family:"Courier New";}
2668 {mso-level-number-format:bullet;
2669 mso-level-text:\F0A7;
2670 mso-level-tab-stop:108.0pt;
2671 mso-level-number-position:left;
2672 text-indent:-18.0pt;
2673 font-family:Wingdings;}
2675 {mso-level-number-format:bullet;
2676 mso-level-text:\F0B7;
2677 mso-level-tab-stop:144.0pt;
2678 mso-level-number-position:left;
2679 text-indent:-18.0pt;
2680 font-family:Symbol;}
2682 {mso-level-number-format:bullet;
2684 mso-level-tab-stop:180.0pt;
2685 mso-level-number-position:left;
2686 text-indent:-18.0pt;
2687 font-family:"Courier New";}
2689 {mso-level-number-format:bullet;
2690 mso-level-text:\F0A7;
2691 mso-level-tab-stop:216.0pt;
2692 mso-level-number-position:left;
2693 text-indent:-18.0pt;
2694 font-family:Wingdings;}
2696 {mso-level-number-format:bullet;
2697 mso-level-text:\F0B7;
2698 mso-level-tab-stop:252.0pt;
2699 mso-level-number-position:left;
2700 text-indent:-18.0pt;
2701 font-family:Symbol;}
2703 {mso-level-number-format:bullet;
2705 mso-level-tab-stop:288.0pt;
2706 mso-level-number-position:left;
2707 text-indent:-18.0pt;
2708 font-family:"Courier New";}
2710 {mso-level-number-format:bullet;
2711 mso-level-text:\F0A7;
2712 mso-level-tab-stop:324.0pt;
2713 mso-level-number-position:left;
2714 text-indent:-18.0pt;
2715 font-family:Wingdings;}
2717 {mso-list-id:1740133347;
2718 mso-list-template-ids:-5492374;}
2720 {mso-level-text:"%1\)";
2721 mso-level-tab-stop:18.0pt;
2722 mso-level-number-position:left;
2724 text-indent:-18.0pt;}
2726 {mso-level-number-format:alpha-lower;
2727 mso-level-tab-stop:54.0pt;
2728 mso-level-number-position:left;
2730 text-indent:-18.0pt;}
2732 {mso-level-number-format:roman-lower;
2733 mso-level-tab-stop:90.0pt;
2734 mso-level-number-position:right;
2736 text-indent:-9.0pt;}
2738 {mso-level-tab-stop:126.0pt;
2739 mso-level-number-position:left;
2740 margin-left:126.0pt;
2741 text-indent:-18.0pt;}
2743 {mso-level-number-format:alpha-lower;
2744 mso-level-tab-stop:162.0pt;
2745 mso-level-number-position:left;
2746 margin-left:162.0pt;
2747 text-indent:-18.0pt;}
2749 {mso-level-number-format:roman-lower;
2750 mso-level-tab-stop:198.0pt;
2751 mso-level-number-position:right;
2752 margin-left:198.0pt;
2753 text-indent:-9.0pt;}
2755 {mso-level-tab-stop:234.0pt;
2756 mso-level-number-position:left;
2757 margin-left:234.0pt;
2758 text-indent:-18.0pt;}
2760 {mso-level-number-format:alpha-lower;
2761 mso-level-tab-stop:270.0pt;
2762 mso-level-number-position:left;
2763 margin-left:270.0pt;
2764 text-indent:-18.0pt;}
2766 {mso-level-number-format:roman-lower;
2767 mso-level-tab-stop:306.0pt;
2768 mso-level-number-position:right;
2769 margin-left:306.0pt;
2770 text-indent:-9.0pt;}
2772 {mso-list-id:1781024997;
2773 mso-list-template-ids:67698719;}
2775 {mso-level-tab-stop:18.0pt;
2776 mso-level-number-position:left;
2778 text-indent:-18.0pt;}
2780 {mso-level-text:"%1\.%2\.";
2781 mso-level-tab-stop:39.6pt;
2782 mso-level-number-position:left;
2784 text-indent:-21.6pt;}
2786 {mso-level-text:"%1\.%2\.%3\.";
2787 mso-level-tab-stop:72.0pt;
2788 mso-level-number-position:left;
2790 text-indent:-25.2pt;}
2792 {mso-level-text:"%1\.%2\.%3\.%4\.";
2793 mso-level-tab-stop:90.0pt;
2794 mso-level-number-position:left;
2796 text-indent:-32.4pt;}
2798 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.";
2799 mso-level-tab-stop:126.0pt;
2800 mso-level-number-position:left;
2801 margin-left:111.6pt;
2802 text-indent:-39.6pt;}
2804 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.";
2805 mso-level-tab-stop:144.0pt;
2806 mso-level-number-position:left;
2807 margin-left:136.8pt;
2808 text-indent:-46.8pt;}
2810 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.";
2811 mso-level-tab-stop:180.0pt;
2812 mso-level-number-position:left;
2813 margin-left:162.0pt;
2814 text-indent:-54.0pt;}
2816 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.";
2817 mso-level-tab-stop:198.0pt;
2818 mso-level-number-position:left;
2819 margin-left:187.2pt;
2820 text-indent:-61.2pt;}
2822 {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.%9\.";
2823 mso-level-tab-stop:234.0pt;
2824 mso-level-number-position:left;
2825 margin-left:216.0pt;
2826 text-indent:-72.0pt;}
2828 {mso-list-id:1834448678;
2829 mso-list-template-ids:-5492374;}
2831 {mso-level-text:"%1\)";
2832 mso-level-tab-stop:18.0pt;
2833 mso-level-number-position:left;
2835 text-indent:-18.0pt;}
2837 {mso-level-number-format:alpha-lower;
2838 mso-level-tab-stop:54.0pt;
2839 mso-level-number-position:left;
2841 text-indent:-18.0pt;}
2843 {mso-level-number-format:roman-lower;
2844 mso-level-tab-stop:90.0pt;
2845 mso-level-number-position:right;
2847 text-indent:-9.0pt;}
2849 {mso-level-tab-stop:126.0pt;
2850 mso-level-number-position:left;
2851 margin-left:126.0pt;
2852 text-indent:-18.0pt;}
2854 {mso-level-number-format:alpha-lower;
2855 mso-level-tab-stop:162.0pt;
2856 mso-level-number-position:left;
2857 margin-left:162.0pt;
2858 text-indent:-18.0pt;}
2860 {mso-level-number-format:roman-lower;
2861 mso-level-tab-stop:198.0pt;
2862 mso-level-number-position:right;
2863 margin-left:198.0pt;
2864 text-indent:-9.0pt;}
2866 {mso-level-tab-stop:234.0pt;
2867 mso-level-number-position:left;
2868 margin-left:234.0pt;
2869 text-indent:-18.0pt;}
2871 {mso-level-number-format:alpha-lower;
2872 mso-level-tab-stop:270.0pt;
2873 mso-level-number-position:left;
2874 margin-left:270.0pt;
2875 text-indent:-18.0pt;}
2877 {mso-level-number-format:roman-lower;
2878 mso-level-tab-stop:306.0pt;
2879 mso-level-number-position:right;
2880 margin-left:306.0pt;
2881 text-indent:-9.0pt;}
2883 {mso-list-id:1954169307;
2884 mso-list-template-ids:986222236;}
2886 {mso-level-number-format:bullet;
2887 mso-level-text:\F0B7;
2888 mso-level-tab-stop:36.0pt;
2889 mso-level-number-position:left;
2890 text-indent:-18.0pt;
2891 font-family:Symbol;}
2893 {mso-level-number-format:bullet;
2895 mso-level-tab-stop:72.0pt;
2896 mso-level-number-position:left;
2897 text-indent:-18.0pt;
2898 font-family:"Courier New";}
2900 {mso-level-number-format:bullet;
2901 mso-level-text:\F0A7;
2902 mso-level-tab-stop:108.0pt;
2903 mso-level-number-position:left;
2904 text-indent:-18.0pt;
2905 font-family:Wingdings;}
2907 {mso-level-number-format:bullet;
2908 mso-level-text:\F0B7;
2909 mso-level-tab-stop:144.0pt;
2910 mso-level-number-position:left;
2911 text-indent:-18.0pt;
2912 font-family:Symbol;}
2914 {mso-level-number-format:bullet;
2916 mso-level-tab-stop:180.0pt;
2917 mso-level-number-position:left;
2918 text-indent:-18.0pt;
2919 font-family:"Courier New";}
2921 {mso-level-number-format:bullet;
2922 mso-level-text:\F0A7;
2923 mso-level-tab-stop:216.0pt;
2924 mso-level-number-position:left;
2925 text-indent:-18.0pt;
2926 font-family:Wingdings;}
2928 {mso-level-number-format:bullet;
2929 mso-level-text:\F0B7;
2930 mso-level-tab-stop:252.0pt;
2931 mso-level-number-position:left;
2932 text-indent:-18.0pt;
2933 font-family:Symbol;}
2935 {mso-level-number-format:bullet;
2937 mso-level-tab-stop:288.0pt;
2938 mso-level-number-position:left;
2939 text-indent:-18.0pt;
2940 font-family:"Courier New";}
2942 {mso-level-number-format:bullet;
2943 mso-level-text:\F0A7;
2944 mso-level-tab-stop:324.0pt;
2945 mso-level-number-position:left;
2946 text-indent:-18.0pt;
2947 font-family:Wingdings;}
2949 {mso-list-id:2000840094;
2950 mso-list-template-ids:519993794;}
2952 {mso-level-number-format:bullet;
2953 mso-level-text:\F0B7;
2954 mso-level-tab-stop:36.0pt;
2955 mso-level-number-position:left;
2956 text-indent:-18.0pt;
2957 font-family:Symbol;}
2959 {mso-level-number-format:bullet;
2961 mso-level-tab-stop:72.0pt;
2962 mso-level-number-position:left;
2963 text-indent:-18.0pt;
2964 font-family:"Courier New";}
2966 {mso-level-number-format:bullet;
2967 mso-level-text:\F0A7;
2968 mso-level-tab-stop:108.0pt;
2969 mso-level-number-position:left;
2970 text-indent:-18.0pt;
2971 font-family:Wingdings;}
2973 {mso-level-number-format:bullet;
2974 mso-level-text:\F0B7;
2975 mso-level-tab-stop:144.0pt;
2976 mso-level-number-position:left;
2977 text-indent:-18.0pt;
2978 font-family:Symbol;}
2980 {mso-level-number-format:bullet;
2982 mso-level-tab-stop:180.0pt;
2983 mso-level-number-position:left;
2984 text-indent:-18.0pt;
2985 font-family:"Courier New";}
2987 {mso-level-number-format:bullet;
2988 mso-level-text:\F0A7;
2989 mso-level-tab-stop:216.0pt;
2990 mso-level-number-position:left;
2991 text-indent:-18.0pt;
2992 font-family:Wingdings;}
2994 {mso-level-number-format:bullet;
2995 mso-level-text:\F0B7;
2996 mso-level-tab-stop:252.0pt;
2997 mso-level-number-position:left;
2998 text-indent:-18.0pt;
2999 font-family:Symbol;}
3001 {mso-level-number-format:bullet;
3003 mso-level-tab-stop:288.0pt;
3004 mso-level-number-position:left;
3005 text-indent:-18.0pt;
3006 font-family:"Courier New";}
3008 {mso-level-number-format:bullet;
3009 mso-level-text:\F0A7;
3010 mso-level-tab-stop:324.0pt;
3011 mso-level-number-position:left;
3012 text-indent:-18.0pt;
3013 font-family:Wingdings;}
3015 {mso-list-id:2140024448;
3016 mso-list-type:hybrid;
3017 mso-list-template-ids:519993794 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
3019 {mso-level-number-format:bullet;
3020 mso-level-text:\F0B7;
3021 mso-level-tab-stop:36.0pt;
3022 mso-level-number-position:left;
3023 text-indent:-18.0pt;
3024 font-family:Symbol;}
3026 {margin-bottom:0pt;}
3028 {margin-bottom:0pt;}
3031 <!--[if gte mso 10]>
3033 /* Style Definitions */
3034 table.MsoNormalTable
3035 {mso-style-name:"Table Normal";
3036 mso-tstyle-rowband-size:0;
3037 mso-tstyle-colband-size:0;
3038 mso-style-noshow:yes;
3039 mso-style-parent:"";
3040 mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
3041 mso-para-margin:0pt;
3042 mso-para-margin-bottom:.0001pt;
3043 mso-pagination:widow-orphan;
3045 font-family:"Times New Roman";
3046 mso-ansi-language:#0400;
3047 mso-fareast-language:#0400;
3048 mso-bidi-language:#0400;}
3050 {mso-style-name:"Table 3D effects 1";
3051 mso-tstyle-rowband-size:0;
3052 mso-tstyle-colband-size:0;
3053 mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
3054 mso-tstyle-shading:white;
3055 mso-tstyle-pattern:solid silver;
3056 mso-para-margin-top:7.2pt;
3057 mso-para-margin-right:0pt;
3058 mso-para-margin-bottom:7.2pt;
3059 mso-para-margin-left:0pt;
3060 mso-pagination:none;
3063 font-family:"Times New Roman";
3064 mso-ansi-language:#0400;
3065 mso-fareast-language:#0400;
3066 mso-bidi-language:#0400;}
3067 table.MsoTable3DFx1FirstRow
3068 {mso-style-name:"Table 3D effects 1";
3069 mso-table-condition:first-row;
3070 mso-tstyle-border-bottom:.75pt solid gray;
3071 mso-tstyle-diagonal-down:0pt none windowtext;
3072 mso-tstyle-diagonal-up:0pt none windowtext;
3074 mso-ansi-font-weight:bold;
3075 mso-bidi-font-weight:bold;}
3076 table.MsoTable3DFx1LastRow
3077 {mso-style-name:"Table 3D effects 1";
3078 mso-table-condition:last-row;
3079 mso-tstyle-border-top:.75pt solid white;
3080 mso-tstyle-diagonal-down:0pt none windowtext;
3081 mso-tstyle-diagonal-up:0pt none windowtext;}
3082 table.MsoTable3DFx1FirstCol
3083 {mso-style-name:"Table 3D effects 1";
3084 mso-table-condition:first-column;
3085 mso-tstyle-border-right:.75pt solid gray;
3086 mso-tstyle-diagonal-down:0pt none windowtext;
3087 mso-tstyle-diagonal-up:0pt none windowtext;
3088 mso-ansi-font-weight:bold;
3089 mso-bidi-font-weight:bold;}
3090 table.MsoTable3DFx1LastCol
3091 {mso-style-name:"Table 3D effects 1";
3092 mso-table-condition:last-column;
3093 mso-tstyle-border-left:.75pt solid white;
3094 mso-tstyle-diagonal-down:0pt none windowtext;
3095 mso-tstyle-diagonal-up:0pt none windowtext;}
3096 table.MsoTable3DFx1NECell
3097 {mso-style-name:"Table 3D effects 1";
3098 mso-table-condition:ne-cell;
3099 mso-tstyle-border-left:0pt none windowtext;
3100 mso-tstyle-border-bottom:0pt none windowtext;
3101 mso-tstyle-diagonal-down:0pt none windowtext;
3102 mso-tstyle-diagonal-up:0pt none windowtext;}
3103 table.MsoTable3DFx1NWCell
3104 {mso-style-name:"Table 3D effects 1";
3105 mso-table-condition:nw-cell;
3106 mso-tstyle-border-bottom:0pt none windowtext;
3107 mso-tstyle-border-right:0pt none windowtext;
3108 mso-tstyle-diagonal-down:0pt none windowtext;
3109 mso-tstyle-diagonal-up:0pt none windowtext;}
3110 table.MsoTable3DFx1SECell
3111 {mso-style-name:"Table 3D effects 1";
3112 mso-table-condition:se-cell;
3113 mso-tstyle-border-top:0pt none windowtext;
3114 mso-tstyle-border-left:0pt none windowtext;
3115 mso-tstyle-diagonal-down:0pt none windowtext;
3116 mso-tstyle-diagonal-up:0pt none windowtext;}
3117 table.MsoTable3DFx1SWCell
3118 {mso-style-name:"Table 3D effects 1";
3119 mso-table-condition:sw-cell;
3120 mso-tstyle-border-top:0pt none windowtext;
3121 mso-tstyle-border-right:0pt none windowtext;
3122 mso-tstyle-diagonal-down:0pt none windowtext;
3123 mso-tstyle-diagonal-up:0pt none windowtext;
3126 {mso-style-name:"Table Web 1";
3127 mso-tstyle-rowband-size:0;
3128 mso-tstyle-colband-size:0;
3129 mso-cellspacing:2.0pt;
3130 border:outset 1.0pt;
3131 mso-border-alt:outset windowtext .75pt;
3132 mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
3133 mso-border-insideh:.75pt outset windowtext;
3134 mso-border-insidev:.75pt outset windowtext;
3135 mso-para-margin-top:7.2pt;
3136 mso-para-margin-right:0pt;
3137 mso-para-margin-bottom:7.2pt;
3138 mso-para-margin-left:0pt;
3139 mso-pagination:none;
3142 font-family:"Times New Roman";
3143 mso-ansi-language:#0400;
3144 mso-fareast-language:#0400;
3145 mso-bidi-language:#0400;}
3146 table.MsoTableWeb1FirstRow
3147 {mso-style-name:"Table Web 1";
3148 mso-table-condition:first-row;
3149 mso-tstyle-diagonal-down:0pt none windowtext;
3150 mso-tstyle-diagonal-up:0pt none windowtext;
3153 {mso-style-name:"Table Web 3";
3154 mso-tstyle-rowband-size:0;
3155 mso-tstyle-colband-size:0;
3156 mso-cellspacing:2.0pt;
3157 border:outset 3.0pt;
3158 mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
3159 mso-border-insideh:.75pt outset windowtext;
3160 mso-border-insidev:.75pt outset windowtext;
3161 mso-para-margin-top:7.2pt;
3162 mso-para-margin-right:0pt;
3163 mso-para-margin-bottom:7.2pt;
3164 mso-para-margin-left:0pt;
3165 mso-pagination:none;
3168 font-family:"Times New Roman";
3169 mso-ansi-language:#0400;
3170 mso-fareast-language:#0400;
3171 mso-bidi-language:#0400;}
3172 table.MsoTableWeb3FirstRow
3173 {mso-style-name:"Table Web 3";
3174 mso-table-condition:first-row;
3175 mso-tstyle-diagonal-down:0pt none windowtext;
3176 mso-tstyle-diagonal-up:0pt none windowtext;
3179 {mso-style-name:"Table Grid";
3180 mso-tstyle-rowband-size:0;
3181 mso-tstyle-colband-size:0;
3182 border:solid windowtext 1.0pt;
3183 mso-border-alt:solid windowtext .5pt;
3184 mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
3185 mso-border-insideh:.5pt solid windowtext;
3186 mso-border-insidev:.5pt solid windowtext;
3187 mso-para-margin-top:7.2pt;
3188 mso-para-margin-right:0pt;
3189 mso-para-margin-bottom:7.2pt;
3190 mso-para-margin-left:0pt;
3191 mso-pagination:none;
3194 font-family:"Times New Roman";
3195 mso-ansi-language:#0400;
3196 mso-fareast-language:#0400;
3197 mso-bidi-language:#0400;}
3199 <![endif]--><!--[if gte mso 9]><xml>
3200 <o:shapedefaults v:ext="edit" spidmax="2050"/>
3201 </xml><![endif]--><!--[if gte mso 9]><xml>
3202 <o:shapelayout v:ext="edit">
3203 <o:idmap v:ext="edit" data="1"/>
3204 </o:shapelayout></xml><![endif]-->
3207 <body lang=EN-US link=navy vlink=maroon style='tab-interval:35.45pt;line-break:
3210 <div class=Section1>
3212 <p class=MsoTitle>OpenAFS for Windows 1.4.0<br>
3215 <p class=MsoBodyText>The Andrew File System (AFS) is a location-independent
3216 file system that uses a local cache to increase its performance.<span
3217 style='mso-spacerun:yes'> </span>An AFS client accesses files anonymously or
3218 via a Kerberos authentication.<span style='mso-spacerun:yes'> </span>The
3219 global AFS is partitioned into cells.<span style='mso-spacerun:yes'>
3220 </span>The AFS cell is a collection of AFS volumes that are administered by a
3221 common entity.<span style='mso-spacerun:yes'> </span>AFS cells can be
3222 administered by a department even when the Kerberos realm used for local
3223 authentication is managed by a much larger organization.<span
3224 style='mso-spacerun:yes'> </span>AFS clients and servers take advantage of
3225 Kerberos cross realm authentication to enable authenticated access by entities
3226 located outside the local realm.<span style='mso-spacerun:yes'>
3227 </span>Authorization is enforced by the use of directory level access control
3228 lists which can consist of individual or group identities.<span
3229 style='mso-spacerun:yes'> </span></p>
3231 <p class=MsoBodyText>The AFS volume is a tree of files and
3232 sub-directories.<span style='mso-spacerun:yes'> </span>AFS volumes are created
3233 by administrators and are joined to an AFS cell via the use of a mount
3234 point.<span style='mso-spacerun:yes'> </span>Once a volume is created, users
3235 can create files and directories as well as mount points and symlinks within
3236 the volume without regard for the physical location of the volume.<span
3237 style='mso-spacerun:yes'> </span>Administrators can move the volume to another
3238 server as necessary without the need to notify users.<span
3239 style='mso-spacerun:yes'> </span>In fact, the volume move can occur while
3240 files in the volume are in use.<span style='mso-spacerun:yes'> </span></p>
3242 <p class=MsoBodyText>AFS volumes can be replicated to read-only copies.<span
3243 style='mso-spacerun:yes'> </span>When accessing files from a read-only replica,
3244 clients will read all of the data from a single replica.<span
3245 style='mso-spacerun:yes'> </span>If that replica becomes unavailable, the
3246 clients will failover to any replica that is reachable.<span
3247 style='mso-spacerun:yes'> </span>Users of the data are unaware of where the
3248 replicas are stored or which one is being accessed.<span
3249 style='mso-spacerun:yes'> </span>The contents of the replicas can be updated
3250 at any time by <i style='mso-bidi-font-style:normal'>releasing</i> the current
3251 contents of the source volume.</p>
3253 <p class=MsoBodyText>OpenAFS for Windows (OAFW) provides AFS client access
3254 Microsoft Windows operating systems.<span style='mso-spacerun:yes'> </span>It
3255 strives to maintain transparency such that the user is unaware of the
3256 distinction between the use of AFS and Microsoft Windows file shares.<span
3257 style='mso-spacerun:yes'> </span>OAFW can be part of a single sign-on
3258 solution by allowing credentials for a Kerberos principal to be obtained at
3259 logon and for that principal to be used to obtain AFS tokens for one or more
3260 cells.<span style='mso-spacerun:yes'> </span>Although OAFW is implemented as
3261 a locally installed SMB to AFS gateway, OAFW maintains the portability of file
3262 paths by its use of the <a href="file:///\\AFS">\\AFS</a> UNC server name.</p>
3264 <p class=MsoBodyText>OpenAFS is the product of an open source development
3265 effort begun in July 2001.<span style='mso-spacerun:yes'> </span>OpenAFS is
3266 maintained and developed by a group of volunteers with the support of the user
3267 community.<span style='mso-spacerun:yes'> </span>If you use OpenAFS as part
3268 of your computing infrastructure please contribute to its continued growth.</p>
3270 <p class=MsoToc1><!--[if supportFields]><span style='mso-element:field-begin'></span><span
3271 style='mso-spacerun:yes'> </span>TOC \o "1-1" \h \z \u <span
3272 style='mso-element:field-separator'></span><![endif]--><span
3273 class=MsoHyperlink><span style='mso-no-proof:yes'><a
3274 href="#_Toc115417109">1.
3275 Installer Options<span style='color:windowtext;display:none;mso-hide:screen;
3276 text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
3277 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3278 text-underline:none'><span style='mso-element:field-begin'></span></span><span
3279 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3280 text-underline:none'> PAGEREF _Toc115417109 \h </span><span style='color:windowtext;
3281 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3282 style='mso-element:field-separator'></span></span><![endif]--><span
3283 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3284 text-underline:none'>1</span><span style='color:windowtext;display:none;
3285 mso-hide:screen;text-decoration:none;text-underline:none'><!--[if gte mso 9]><xml>
3286 <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100300039000000</w:data>
3287 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
3288 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3289 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
3290 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
3291 mso-fareast-language:JA;mso-no-proof:yes'><o:p></o:p></span></p>
3293 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
3294 href="#_Toc115417110">2.
3295 System Requirements<span style='color:windowtext;display:none;mso-hide:screen;
3296 text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
3297 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3298 text-underline:none'><span style='mso-element:field-begin'></span></span><span
3299 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3300 text-underline:none'> PAGEREF _Toc115417110 \h </span><span style='color:windowtext;
3301 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3302 style='mso-element:field-separator'></span></span><![endif]--><span
3303 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3304 text-underline:none'>2</span><span style='color:windowtext;display:none;
3305 mso-hide:screen;text-decoration:none;text-underline:none'><!--[if gte mso 9]><xml>
3306 <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310030000000</w:data>
3307 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
3308 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3309 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
3310 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
3311 mso-fareast-language:JA;mso-no-proof:yes'><o:p></o:p></span></p>
3313 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
3314 href="#_Toc115417111">3.
3315 Operational Notes<span style='color:windowtext;display:none;mso-hide:screen;
3316 text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
3317 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3318 text-underline:none'><span style='mso-element:field-begin'></span></span><span
3319 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3320 text-underline:none'> PAGEREF _Toc115417111 \h </span><span style='color:windowtext;
3321 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3322 style='mso-element:field-separator'></span></span><![endif]--><span
3323 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3324 text-underline:none'>2</span><span style='color:windowtext;display:none;
3325 mso-hide:screen;text-decoration:none;text-underline:none'><!--[if gte mso 9]><xml>
3326 <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310031000000</w:data>
3327 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
3328 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3329 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
3330 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
3331 mso-fareast-language:JA;mso-no-proof:yes'><o:p></o:p></span></p>
3333 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
3334 href="#_Toc115417112">4.
3335 How to Debug Problems with OpenAFS for Windows:<span style='color:windowtext;
3336 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3337 style='mso-tab-count:1 dotted'> </span></span><!--[if supportFields]><span
3338 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3339 text-underline:none'><span style='mso-element:field-begin'></span></span><span
3340 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3341 text-underline:none'> PAGEREF _Toc115417112 \h </span><span style='color:windowtext;
3342 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3343 style='mso-element:field-separator'></span></span><![endif]--><span
3344 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3345 text-underline:none'>11</span><span style='color:windowtext;display:none;
3346 mso-hide:screen;text-decoration:none;text-underline:none'><!--[if gte mso 9]><xml>
3347 <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310032000000</w:data>
3348 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
3349 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3350 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
3351 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
3352 mso-fareast-language:JA;mso-no-proof:yes'><o:p></o:p></span></p>
3354 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
3355 href="#_Toc115417113">5.
3356 Reporting Bugs:<span style='color:windowtext;display:none;mso-hide:screen;
3357 text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'> </span></span><!--[if supportFields]><span
3358 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3359 text-underline:none'><span style='mso-element:field-begin'></span></span><span
3360 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3361 text-underline:none'> PAGEREF _Toc115417113 \h </span><span style='color:windowtext;
3362 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3363 style='mso-element:field-separator'></span></span><![endif]--><span
3364 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3365 text-underline:none'>13</span><span style='color:windowtext;display:none;
3366 mso-hide:screen;text-decoration:none;text-underline:none'><!--[if gte mso 9]><xml>
3367 <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310033000000</w:data>
3368 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
3369 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3370 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
3371 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
3372 mso-fareast-language:JA;mso-no-proof:yes'><o:p></o:p></span></p>
3374 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
3375 href="#_Toc115417114">6.
3376 How to Contribute to the Development of OpenAFS for Windows<span
3377 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3378 text-underline:none'><span style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
3379 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3380 text-underline:none'><span style='mso-element:field-begin'></span></span><span
3381 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3382 text-underline:none'> PAGEREF _Toc115417114 \h </span><span style='color:windowtext;
3383 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3384 style='mso-element:field-separator'></span></span><![endif]--><span
3385 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3386 text-underline:none'>14</span><span style='color:windowtext;display:none;
3387 mso-hide:screen;text-decoration:none;text-underline:none'><!--[if gte mso 9]><xml>
3388 <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310034000000</w:data>
3389 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
3390 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3391 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
3392 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
3393 mso-fareast-language:JA;mso-no-proof:yes'><o:p></o:p></span></p>
3395 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
3396 href="#_Toc115417115">7.
3397 MSI Deployment Guide<span style='color:windowtext;display:none;mso-hide:screen;
3398 text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
3399 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3400 text-underline:none'><span style='mso-element:field-begin'></span></span><span
3401 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3402 text-underline:none'> PAGEREF _Toc115417115 \h </span><span style='color:windowtext;
3403 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3404 style='mso-element:field-separator'></span></span><![endif]--><span
3405 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3406 text-underline:none'>15</span><span style='color:windowtext;display:none;
3407 mso-hide:screen;text-decoration:none;text-underline:none'><!--[if gte mso 9]><xml>
3408 <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310035000000</w:data>
3409 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
3410 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3411 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
3412 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
3413 mso-fareast-language:JA;mso-no-proof:yes'><o:p></o:p></span></p>
3415 <p class=MsoToc1><span class=MsoHyperlink><span style='mso-no-proof:yes'><a
3416 href="#_Toc115417116">Appendix
3417 A: Registry Values<span style='color:windowtext;display:none;mso-hide:screen;
3418 text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span></span><!--[if supportFields]><span
3419 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3420 text-underline:none'><span style='mso-element:field-begin'></span></span><span
3421 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3422 text-underline:none'> PAGEREF _Toc115417116 \h </span><span style='color:windowtext;
3423 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3424 style='mso-element:field-separator'></span></span><![endif]--><span
3425 style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;
3426 text-underline:none'>26</span><span style='color:windowtext;display:none;
3427 mso-hide:screen;text-decoration:none;text-underline:none'><!--[if gte mso 9]><xml>
3428 <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003100310035003400310037003100310036000000</w:data>
3429 </xml><![endif]--></span><!--[if supportFields]><span style='color:windowtext;
3430 display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span
3431 style='mso-element:field-end'></span></span><![endif]--></a></span></span><span
3432 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
3433 mso-fareast-language:JA;mso-no-proof:yes'><o:p></o:p></span></p>
3435 <h1 style='margin-left:0pt;text-indent:0pt'><!--[if supportFields]><span
3436 style='mso-element:field-end'></span><![endif]--><a name="_Toc115417109"></a><a
3437 name="_Toc115417037"></a><a name="_Toc115416098"><span style='mso-bookmark:
3438 _Toc115417037'><span style='mso-bookmark:_Toc115417109'>1. Installer Options</span></span></a></h1>
3440 <p class=MsoNormal>It can be installed either as a new installation or an
3441 upgrade from previous versions of OpenAFS for Windows or IBM AFS for
3442 Windows.<span style='mso-spacerun:yes'> </span>Installers are provided in two
3445 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l10 level1 lfo1;
3446 tab-stops:list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;
3447 mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
3448 style='mso-list:Ignore'>1.<span style='font:7.0pt "Times New Roman"'>
3449 </span></span></span><![endif]>an executable (.exe) that is built using the
3450 Nullsoft Scriptable Installation System, or</p>
3452 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l10 level1 lfo1;
3453 tab-stops:list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;
3454 mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
3455 style='mso-list:Ignore'>2.<span style='font:7.0pt "Times New Roman"'>
3456 </span></span></span><![endif]>a Windows Installer package (.msi) that is built
3457 using WiX and can be customized for organizations via the use of MSI Transforms
3459 href="#_MSI_Deployment_Guide">MSI
3460 Deployment Guide</a>)</p>
3462 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417110"></a><a
3463 name="_Toc115417038"></a><a name="_Toc115416099"><span style='mso-bookmark:
3464 _Toc115417038'><span style='mso-bookmark:_Toc115417110'>2. System Requirements</span></span></a></h1>
3466 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417039"></a><a
3467 name="_Toc115416100"><span style='mso-bookmark:_Toc115417039'>2.1 Supported
3468 Operating Systems</span></a></h2>
3470 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3471 l11 level1 lfo2;tab-stops:list 14.15pt'><![if !supportLists]><span
3472 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3473 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3474 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Microsoft
3475 Windows 2000 Workstation</p>
3477 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3478 l11 level1 lfo2;tab-stops:list 14.15pt'><![if !supportLists]><span
3479 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3480 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3481 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Microsoft
3482 Windows 2000 Server</p>
3484 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3485 l11 level1 lfo2;tab-stops:list 14.15pt'><![if !supportLists]><span
3486 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3487 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3488 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Microsoft
3491 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3492 l11 level1 lfo2;tab-stops:list 14.15pt'><![if !supportLists]><span
3493 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3494 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3495 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Microsoft
3496 Windows XP Professional</p>
3498 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3499 l11 level1 lfo2;tab-stops:list 14.15pt'><![if !supportLists]><span
3500 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3501 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3502 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Microsoft
3503 Windows 2003 Server</p>
3505 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3506 l11 level1 lfo2;tab-stops:list 14.15pt'><![if !supportLists]><span
3507 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3508 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3509 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Microsoft
3510 Windows 2003 R2 Server</p>
3512 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416101">2.1.1 Unsupported
3513 Operating Systems</a></h3>
3515 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3516 l12 level1 lfo3;tab-stops:list 14.15pt'><![if !supportLists]><span
3517 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3518 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3519 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Microsoft
3522 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3523 l12 level1 lfo3;tab-stops:list 14.15pt'><![if !supportLists]><span
3524 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3525 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3526 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Microsoft
3529 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3530 l12 level1 lfo3;tab-stops:list 14.15pt'><![if !supportLists]><span
3531 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3532 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3533 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Microsoft
3536 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3537 l12 level1 lfo3;tab-stops:list 14.15pt'><![if !supportLists]><span
3538 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3539 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3540 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Microsoft
3543 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3544 l12 level1 lfo3;tab-stops:list 14.15pt'><![if !supportLists]><span
3545 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3546 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3547 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Microsoft
3550 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3551 l12 level1 lfo3;tab-stops:list 14.15pt'><![if !supportLists]><span
3552 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3553 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3554 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Microsoft
3555 Windows Vista (as of Beta 1 bugs in Windows prevent its use)</p>
3557 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
3558 l12 level1 lfo3;tab-stops:list 14.15pt'><![if !supportLists]><span
3559 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3560 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3561 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>All
3562 64-bit versions of Microsoft Windows on Itanium and x86-64 chipsets.</p>
3564 <p class=MsoNormal>Older releases of OpenAFS are available for download if
3565 those operating systems must be supported.<span style='mso-spacerun:yes'>
3566 </span>The last version of OpenAFS with support for Win9x is 1.2.2b.<span
3567 style='mso-spacerun:yes'> </span>The last version with support for Windows NT
3570 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417040"></a><a
3571 name="_Toc115416102"><span style='mso-bookmark:_Toc115417040'>2.2 Disk Space</span></a></h2>
3573 <p class=MsoNormal>Up to 60mb required for the OpenAFS binaries plus 100MB for
3574 the default AFSCache file.<span style='mso-spacerun:yes'> </span>(The size of
3575 the AFSCache file may be adjusted via the Registry after installation.)</p>
3577 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417041"></a><a
3578 name="_Toc115416103"><span style='mso-bookmark:_Toc115417041'>2.3 Additional
3579 Software</span></a></h2>
3581 <p class=MsoNormal><a href="http://web.mit.edu/kerberos/dist/index.html">MIT
3582 Kerberos for Windows</a> 2.6.x if Kerberos 5 authentication support is desired.</p>
3584 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417111"></a><a
3585 name="_Toc115417042"></a><a name="_Toc115416104"><span style='mso-bookmark:
3586 _Toc115417042'><span style='mso-bookmark:_Toc115417111'>3. Operational Notes</span></span></a></h1>
3588 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417043"></a><a
3589 name="_Toc115416105"><span style='mso-bookmark:_Toc115417043'>3.1. Requirements
3590 for Kerberos 5 Authentication</span></a></h2>
3592 <p class=MsoNormal>The Kerberos 4 infrastructure on which the OpenAFS 1.2
3593 series is reliant is no longer secure.<span style='mso-spacerun:yes'>
3594 </span>Cross-realm Kerberos is very important in the AFS context and most sites
3595 have or are migrating to Kerberos 5 environments.<span
3596 style='mso-spacerun:yes'> </span>The OpenAFS 1.4 series integrates with MIT
3597 Kerberos for Windows 2.6.5 to support Kerberos 5 authentication including
3598 automatic renewal of AFS tokens and single sign-on via the Microsoft Windows
3599 Kerberos Logon Service.</p>
3601 <p class=MsoNormal>When KFW is installed, the OpenAFS 1.4 client will obtain
3602 Kerberos 5 tickets and use them as tokens without modification.<span
3603 style='mso-spacerun:yes'> </span>The OpenAFS 1.4 client requires that all of
3604 the AFS Servers with which it communicates support the use of Kerberos 5
3605 tickets as tokens. If Kerberos 5 based tokens are presented to an AFS server
3606 that does not understand them, the server will be unable to communicate with
3607 the client when tokens are present. Kerberos 5 based tokens are supported by
3608 OpenAFS release 1.2.8 or later.<span style='mso-spacerun:yes'> </span>IBM
3609 Transarc servers do not support Kerberos 5.<!--[if supportFields]><span
3610 style='mso-element:field-begin'></span> XE "Kerberos 5" <![endif]--><!--[if supportFields]><span
3611 style='mso-element:field-end'></span><![endif]--></p>
3613 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416106">3.1.1. Active
3616 <p class=MsoNormal>There are two things to consider when using a Microsoft
3617 Windows Active Directory as the Kerberos realm that issues the AFS service
3618 ticket.<span style='mso-spacerun:yes'> </span>First, the Kerberos 5 tickets
3619 issued by Active Directory can be quite large when compared to tickets issued
3620 by a traditional KDC due to the incorporation of authorization data in the <st2:place
3621 w:st="on">PAC.</st2:place><span style='mso-spacerun:yes'> </span>If the issued
3622 tickets become larger than 344 bytes OpenAFS 1.2 servers will be unable to
3623 process them.<span style='mso-spacerun:yes'> </span>OpenAFS 1.4 servers can
3624 support the largest tickets that Active Directory can issue.<span
3625 style='mso-spacerun:yes'> </span>Second, the Kerberos 5 tickets issued by
3626 Windows 2003 Active Directory are encrypted with the DES-CBC-MD5 enctype.<span
3627 style='mso-spacerun:yes'> </span>OpenAFS 1.2 servers only support the
3628 DES-CBC-CRC enctype.<!--[if supportFields]><span style='mso-element:field-begin'></span>
3629 XE "Active Directory" <![endif]--><!--[if supportFields]><span
3630 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3631 style='mso-element:field-begin'></span><span
3632 style='mso-spacerun:yes'> </span>XE "DES enctypes" <![endif]--><!--[if supportFields]><span
3633 style='mso-element:field-end'></span><![endif]--></p>
3635 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416107">3.1.2. Using
3636 the krb524 service</a></h3>
3638 <p class=MsoNormal>Some organizations which have AFS cell names and Kerberos
3639 realm names which differ by more then just lower and upper case rely on a
3640 modification to krb524d which maps a Kerberos 5 ticket from realm FOO to a
3641 Kerberos 4 ticket in realm BAR.<span style='mso-spacerun:yes'> </span>This
3642 allows user@FOO to appear to be user@bar for the purposes of accessing the AFS
3643 cell.<span style='mso-spacerun:yes'> </span>As of OpenAFS 1.2.8, support was
3644 added to allow the immediate use of Kerberos 5 tickets as AFS (2b) tokens. This
3645 is the first building block necessary to break away from the limitations of
3646 Kerberos 4 with AFS.<span style='mso-spacerun:yes'> </span>By using Kerberos 5
3647 directly we avoid the security holes inherent in Kerberos 4 cross-realm.<span
3648 style='mso-spacerun:yes'> </span>We also gain access to cryptographically
3649 stronger algorithms for authentication and encryption. </p>
3651 <p class=MsoNormal>Another reason for using Kerberos 5 directly is because the
3652 krb524 service runs on a port (4444) which has become increasingly blocked by
3653 ISPs.<span style='mso-spacerun:yes'> </span>The port was used to spread a worm
3654 which attacked Microsoft Windows in the summer of 2003.<span
3655 style='mso-spacerun:yes'> </span>When the port is blocked users find that they
3656 are unable to authenticate.</p>
3658 <p class=MsoNormal>Replacing the Kerberos 4 ticket with a Kerberos 5 ticket is
3659 a win in all situations except when the cell name does not match the realm name
3660 and the principal names placed into the ACLs are not the principal names from
3661 the Kerberos 5 ticket.<span style='mso-spacerun:yes'> </span>To support this
3662 transition, OpenAFS for Windows 1.4 adds a new registry value, <i><a
3663 href="#_Value___: Use524">Use524</a></i>,
3664 to force the use of krb524d.<span style='mso-spacerun:yes'> </span>However,
3665 the availability of this option should only be used by individuals until such
3666 time as their organizations can provide a more permanent solution.<!--[if supportFields]><span
3667 style='mso-element:field-begin'></span> XE "Kerberos 5" <![endif]--><!--[if supportFields]><span
3668 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3669 style='mso-element:field-begin'></span><span
3670 style='mso-spacerun:yes'> </span>XE "krb524" <![endif]--><!--[if supportFields]><span
3671 style='mso-element:field-end'></span><![endif]--></p>
3673 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417044"></a><a
3674 name="_Toc115416108"><span style='mso-bookmark:_Toc115417044'>3.2. Use of the
3675 Microsoft Loopback Adapter</span></a></h2>
3677 <p class=MsoNormal>By itself the OpenAFS Client Service does not provide robust
3678 behavior in a plug-n-play network environment.<span style='mso-spacerun:yes'>
3679 </span>Changes to the number of network adapters or their assigned IP addresses
3680 will cause the service to terminate unexpectedly.<span
3681 style='mso-spacerun:yes'> </span>To avoid this behavior OpenAFS for Windows
3682 installs a single instance of the Microsoft Loopback Adapter (MLA) on the
3683 machine.<span style='mso-spacerun:yes'> </span>With the MLA installed, the
3684 OpenAFS Client Service will not be affected by the configuration changes of
3685 other network adapters installed on the system.<span style='mso-spacerun:yes'>
3688 <p class=MsoNormal>The MLA is installed with a name of "AFS" and a
3689 pre-assigned IP address in the 10.x.x.x range.<span style='mso-spacerun:yes'>
3690 </span>The MLA is bound to the Client for Microsoft Networks service and not
3691 bound to the File and Printer Sharing for Microsoft Networks.<span
3692 style='mso-spacerun:yes'> </span>If the MLA is unbound to "Client
3693 Microsoft Networks", the OpenAFS Client Service will become inaccessible
3694 when the machine is disconnected from the network.<span
3695 style='mso-spacerun:yes'> </span>If the MLA is bound to "File and Printer
3696 Sharing ..." there will be a service type collision between the name
3697 "AFS" and the name of the machine on the MLA's IP Address that will
3698 result in the OpenAFS client service becoming inaccessible and the "NET
3699 VIEW \\AFS" command will return a "System Error 52"
3700 message.<span style='mso-spacerun:yes'> </span>To correct the problem:</p>
3702 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
3703 l13 level1 lfo4;tab-stops:list 14.15pt'><![if !supportLists]><span
3704 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3705 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3706 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]><span
3707 style='mso-spacerun:yes'> </span>stop the AFS Client Service</p>
3709 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
3710 l13 level1 lfo4;tab-stops:list 14.15pt'><![if !supportLists]><span
3711 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3712 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3713 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]><span
3714 style='mso-spacerun:yes'> </span>bind the "Client for Microsoft
3715 Networks" to the MLA</p>
3717 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
3718 l13 level1 lfo4;tab-stops:list 14.15pt'><![if !supportLists]><span
3719 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3720 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3721 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]><span
3722 style='mso-spacerun:yes'> </span>unbind "File and Printer Sharing for
3723 Microsoft Networks" from the MLA</p>
3725 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
3726 l13 level1 lfo4;tab-stops:list 14.15pt'><![if !supportLists]><span
3727 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3728 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3729 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]><span
3730 style='mso-spacerun:yes'> </span>Disable and then re-enable the MLA</p>
3732 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
3733 l13 level1 lfo4;tab-stops:list 14.15pt'><![if !supportLists]><span
3734 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3735 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3736 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]><span
3737 style='mso-spacerun:yes'> </span>start the AFS Client Service</p>
3739 <p class=MsoNormal>When the MLA is not installed the unique NETBIOS name
3740 published by OpenAFS SMB server is "<i>MACHINE</i>-AFS".<span
3741 style='mso-spacerun:yes'> </span>One of the benefits of using the MLA is that
3742 the NETBIOS name does not have to be published on any adapter other than the
3743 MLA.<span style='mso-spacerun:yes'> </span>Therefore the chosen name is no
3744 longer required to be unique.<span style='mso-spacerun:yes'> </span>Instead
3745 the NETBIOS name associated with the AFS Client Service is simply
3746 "AFS" and portable UNC paths of the form \\AFS\cellname\path can now
3747 be used on all machines.<!--[if supportFields]><span style='mso-element:field-begin'></span>
3748 XE "loopback" <![endif]--><!--[if supportFields]><span
3749 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3750 style='mso-element:field-begin'></span><span
3751 style='mso-spacerun:yes'> </span>XE "UNC paths" <![endif]--><!--[if supportFields]><span
3752 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3753 style='mso-element:field-begin'></span><span
3754 style='mso-spacerun:yes'> </span>XE "NETBIOS" <![endif]--><!--[if supportFields]><span
3755 style='mso-element:field-end'></span><![endif]--></p>
3757 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417045"></a><a
3758 name="_Toc115416109"><span style='mso-bookmark:_Toc115417045'>3.3. Using
3759 Freelance (Dynamic Root) Mode to Improve Mobility</span></a></h2>
3761 <p class=MsoNormal>Traditionally, when the OpenAFS Client Service starts it
3762 must be able to access the "root.afs" volume of the default
3763 cell.<span style='mso-spacerun:yes'> </span>The "root.afs" volume
3764 contains the set of mount points to the "root.cell" volumes of
3765 various cells the administrator of the default cell believes should be accessible.<span
3766 style='mso-spacerun:yes'> </span>If the "root.afs" volume is
3767 inaccessible when the client service is started, the service will terminate
3768 unexpectedly.<span style='mso-spacerun:yes'> </span>Since many users now use
3769 laptops or otherwise operate in disconnected environments in which a VPN may be
3770 required to access the cell's servers, it is often the case that the
3771 "root.afs" volume for the default cell is not reachable and the
3772 OpenAFS Client Service will not successfully start. </p>
3774 <p class=MsoNormal>To allow the OpenAFS Client Service to operate in these
3775 environments, a fake "root.afs" volume is dynamically constructed
3776 from mount points and symlinks stored in the local registry.<span
3777 style='mso-spacerun:yes'> </span>This method of operation is referred to as
3780 <p class=MsoNormal>The content of the fake root.afs volume is dynamically
3781 modified as cells are accessed.<span style='mso-spacerun:yes'> </span>When the
3782 fake "root.afs" volume is initially constructed it will only contain
3783 two mount points: a <i>regular path </i>and <i>read-write path </i>mount point
3784 used to access the "root.cell" volume of the default AFS cell.<span
3785 style='mso-spacerun:yes'> </span>Any attempt to access a valid cell name will
3786 result in a new mount point being created in the fake "root.afs"
3787 volume.<span style='mso-spacerun:yes'> </span>If the cellname begins with a
3788 "." the mount point will be a <i>read-write path</i>; otherwise the
3789 mount point will be a <i>regular path</i>.<span style='mso-spacerun:yes'>
3790 </span>These mount points are preserved in the registry at key:</p>
3792 <p class=PreformattedText style='margin-left:35.45pt'><a
3793 href="#_Regkey:_[HKLMSOFTWAREOpenAFSClie">HKLM\SOFTWARE\OpenAFS\Client\Freelance</a></p>
3795 <p class=MsoNormal>Additional mount points may be manually created using the
3796 "fs mkmount" command.<span style='mso-spacerun:yes'> </span>Mount
3797 points may be removed using the "fs rmmount" command.</p>
3799 <p class=PreformattedText style='margin-left:35.45pt'>>fs mkmount
3800 \\AFS\athena.mit.edu root.cell athena.mit.edu</p>
3802 <p class=PreformattedText style='margin-left:35.45pt'>>fs mkmount
3803 \\AFS\.athena.mit.edu root.cell athena.mit.edu -rw</p>
3805 <p class=PreformattedText style='margin-left:35.45pt'>>fs rmmount
3806 \\AFS\athena.mit.edu</p>
3808 <p class=PreformattedText style='margin-left:35.45pt'>>fs rmmount
3809 \\AFS\.athena.mit.edu</p>
3811 <p class=MsoNormal>Symlinks may also be created within the Freelance root.afs
3814 <p class=PreformattedText style='margin-left:35.45pt'>>symlink make \\afs\link
3815 \\afs\athena.mit.edu\user\j\a\jaltman</p>
3817 <p class=PreformattedText><span style='mso-tab-count:1'> </span>>symlink
3820 <p class=PreformattedText><span style='mso-tab-count:1'> </span>'\\afs\link'
3821 is a symlink to 'athena.mit.edu\user\j\a\jaltman'</p>
3823 <p class=PreformattedText style='margin-left:35.45pt'>>symlink rm \\afs\link</p>
3825 <p class=MsoNormal>The symlinks are stored in the registry at:</p>
3827 <p class=PreformattedText style='margin-left:35.45pt'><a
3828 href="#_Regkey:_[HKLMSOFTWAREOpenAFSClie_1">HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks</a><!--[if supportFields]><span
3829 style='mso-element:field-begin'></span> XE "Freelance Mode" <![endif]--><!--[if supportFields]><span
3830 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3831 style='mso-element:field-begin'></span><span
3832 style='mso-spacerun:yes'> </span>XE "Dynamic Root" <![endif]--><!--[if supportFields]><span
3833 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3834 style='mso-element:field-begin'></span><span
3835 style='mso-spacerun:yes'> </span>XE "fs.exe" <![endif]--><!--[if supportFields]><span
3836 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3837 style='mso-element:field-begin'></span><span
3838 style='mso-spacerun:yes'> </span>XE "symlink.exe" <![endif]--><!--[if supportFields]><span
3839 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3840 style='mso-element:field-begin'></span><span
3841 style='mso-spacerun:yes'> </span>XE "root.afs" <![endif]--><!--[if supportFields]><span
3842 style='mso-element:field-end'></span><![endif]--><span
3843 style='mso-spacerun:yes'> </span></p>
3845 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417046"></a><a
3846 name="_Toc115416110"><span style='mso-bookmark:_Toc115417046'>3.4. Locating AFS
3847 Volume Database Servers</span></a> </h2>
3849 <p class=MsoNormal>The OpenAFS for Windows client will use DNS AFSDB records to
3850 discover the location of AFS Volume Database servers when entries are not present
3851 in the client's CellServDB file (\%PROGRAMFILES%\OpenAFS\Client\CellServDB).<!--[if supportFields]><span
3852 style='mso-element:field-begin'></span> XE "dns" <![endif]--><!--[if supportFields]><span
3853 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
3854 style='mso-element:field-begin'></span><span
3855 style='mso-spacerun:yes'> </span>XE "afsdb" <![endif]--><!--[if supportFields]><span
3856 style='mso-element:field-end'></span><![endif]--></p>
3858 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417047"></a><a
3859 name="_Toc115416111"><span style='mso-bookmark:_Toc115417047'>3.5. Obtaining
3860 AFS Tokens as a Part of Windows Logon</span></a></h2>
3862 <p class=MsoNormal>OpenAFS for Windows installs a WinLogon Network Provider to
3863 provide Single Sign-on functionality (aka Integrated Logon.)<span
3864 style='mso-spacerun:yes'> </span>Integrated Logon can be used when the Windows
3865 username and password match the username and password associated with the
3866 default cell's Kerberos realm.<span style='mso-spacerun:yes'> </span>For
3867 example, if the Windows username is "jaltman" and the default cell is
3868 "athena.mit.edu", then Integrated Logon can be successfully used if
3869 the windows password matches the password assigned to the Kerberos principal
3870 "<a href="mailto:jaltman@ATHENA.MIT.EDU">jaltman@ATHENA.MIT.EDU</a>".<span
3871 style='mso-spacerun:yes'> </span>The realm ATHENA.MIT.EDU is obtained by performing
3872 a domain name to realm mapping on the hostname of one of the cell's Volume
3873 Database servers.</p>
3875 <p class=MsoNormal>Integrated Logon is required if you desire the ability to
3876 store roaming user profiles within the AFS file system.<span
3877 style='mso-spacerun:yes'> </span>OpenAFS does not provide tools for synchronizing
3878 the Windows and Kerberos user accounts and passwords.</p>
3880 <p class=MsoNormal>When KFW is configured, Integrated Logon will use it to
3881 obtain tokens.<span style='mso-spacerun:yes'> </span>The Kerberos 5 tickets
3882 obtained during the process of generating AFS tokens are preserved and stored
3883 into the default ccache within the user logon session.</p>
3885 <p class=MsoNormal>Integrated Logon does not have the ability to cache the
3886 user's username and password for the purpose of obtaining tokens if the
3887 Kerberos KDC is inaccessible at logon time.</p>
3889 <p class=MsoNormal>Integrated Login supports the ability to obtain tokens for
3890 multiple cells.<span style='mso-spacerun:yes'> </span>For further information
3891 on how to configure this feature read the <a
3892 href="relnotes.htm#_Value:_TheseCells">TheseCells</a> value in <a
3893 href="#_Appendix_A:_Registry_Values">Appendix
3894 A</a>.<!--[if supportFields]><span style='mso-element:field-begin'></span> XE
3895 "integrated login" <![endif]--><!--[if supportFields]><span
3896 style='mso-element:field-end'></span><![endif]--></p>
3898 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417048"></a><a
3899 name="_Toc115416112"><span style='mso-bookmark:_Toc115417048'>3.6. AFS System
3900 Tray Command Line Options</span></a></h2>
3902 <p class=MsoNormal>The AFS System Tray tool (afscreds.exe) supports several
3903 command line options: </p>
3905 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>-A =
3908 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>-E = force
3909 existing afscreds to exit</p>
3911 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>-I =
3912 install startup shortcut</p>
3914 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>-M = renew
3917 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>-N = IP
3918 address change detection </p>
3920 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>-Q = quiet
3921 mode.<span style='mso-spacerun:yes'> </span>do not display start service
3924 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>if
3925 afsd_service is not already running</p>
3927 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>-S = show
3928 tokens dialog on startup</p>
3930 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>-U =
3931 uninstall startup shortcut</p>
3933 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>-X = test
3934 and do map share</p>
3936 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>-Z = unmap
3939 <p class=MsoNormal>autoinit will result in automated attempts to acquire AFS
3940 tokens when afscreds.exe is started.<span style='mso-spacerun:yes'>
3941 </span>afscreds.exe will attempt to utilize tickets stored in the MSLSA
3942 credentials cache; any existing CCAPI credentials cache; and finally display an
3943 Obtain Tokens dialog to the user.<span style='mso-spacerun:yes'> </span>When
3944 used in combination with IP address change detection, afscreds.exe will attempt
3945 to acquire AFS tokens whenever the IP address list changes and the Kerberos KDC
3948 <p class=MsoNormal>The renew drive maps option is used to ensure that the user
3949 drive maps constructed via the OpenAFS tools (not NET USE) are re-constructed
3950 each time afscreds.exe is started.</p>
3952 <p class=MsoNormal>By default afscreds.exe is configured by the OpenAFS.org
3953 installers to use -A -N -M -Q as startup options.<span
3954 style='mso-spacerun:yes'> </span>Currently, there is no user interface to
3955 change this selection after install time although these options may be altered
3956 via the registry on either per machine or per user basis.<span
3957 style='mso-spacerun:yes'> </span>See <span style='mso-bidi-font-style:italic'><a
3958 href="#_Value___: AfscredsShortcutParams">AfscredsShortcutParams</a></span>
3960 href="#_Appendix_A:_Registry_Values">Appendix
3961 A</a>.<!--[if supportFields]><span style='mso-element:field-begin'></span> XE
3962 "afscreds.exe" <![endif]--><!--[if supportFields]><span
3963 style='mso-element:field-end'></span><![endif]--></p>
3965 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417049"></a><a
3966 name="_Toc115416113"><span style='mso-bookmark:_Toc115417049'>3.7. The AFS
3967 Client Admins Authorization Group</span></a></h2>
3969 <p class=MsoNormal>The OpenAFS for Windows 1.4 client supports a local Windows
3970 authorization group named "AFS Client Admins".<span
3971 style='mso-spacerun:yes'> </span>This group is used in place of the
3972 "Administrators" group to determine which users are allowed to modify
3973 the AFS Client Service configuration via the AFS Control Panel (afs_config.exe)
3974 or fs.exe command line tool.<span style='mso-spacerun:yes'> </span>The
3975 following fs.exe commands are now restricted to members of the "AFS Client
3976 Admins" group:</p>
3978 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3979 mso-list:l14 level1 lfo5;tab-stops:list 14.15pt'><![if !supportLists]><span
3980 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3981 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3982 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>checkservers
3983 with a non-zero timer value</p>
3985 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3986 mso-list:l14 level1 lfo5;tab-stops:list 14.15pt'><![if !supportLists]><span
3987 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3988 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3989 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>setcachesize</p>
3991 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3992 mso-list:l14 level1 lfo5;tab-stops:list 14.15pt'><![if !supportLists]><span
3993 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
3994 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
3995 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>newcell</p>
3997 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
3998 mso-list:l14 level1 lfo5;tab-stops:list 14.15pt'><![if !supportLists]><span
3999 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4000 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4001 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>sysname
4002 with a new sysname list</p>
4004 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
4005 mso-list:l14 level1 lfo5;tab-stops:list 14.15pt'><![if !supportLists]><span
4006 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4007 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4008 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>exportafs</p>
4010 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
4011 mso-list:l14 level1 lfo5;tab-stops:list 14.15pt'><![if !supportLists]><span
4012 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4013 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4014 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>setcell</p>
4016 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
4017 mso-list:l14 level1 lfo5;tab-stops:list 14.15pt'><![if !supportLists]><span
4018 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4019 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4020 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>setserverprefs</p>
4022 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
4023 mso-list:l14 level1 lfo5;tab-stops:list 14.15pt'><![if !supportLists]><span
4024 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4025 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4026 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>storebehind</p>
4028 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
4029 mso-list:l14 level1 lfo5;tab-stops:list 14.15pt'><![if !supportLists]><span
4030 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4031 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4032 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>setcrypt</p>
4034 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
4035 mso-list:l14 level1 lfo5;tab-stops:list 14.15pt'><![if !supportLists]><span
4036 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4037 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4038 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>cscpolicy</p>
4040 <p class=PreformattedText style='margin-left:49.6pt;text-indent:-14.15pt;
4041 mso-list:l14 level1 lfo5;tab-stops:list 14.15pt'><![if !supportLists]><span
4042 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4043 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4044 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>trace</p>
4046 <p class=MsoNormal>The creation or removal of mount points and symlinks in the
4047 Freelance root.afs volume are also restricted to members of the AFS Client
4050 <p class=MsoNormal>The initial membership of the "AFS Client Admins"
4051 group when created by the installer is equivalent to the local
4052 "Administrators" group.<span style='mso-spacerun:yes'> </span>If a
4053 user is added to the "Administrators" group after the creation of the
4054 "AFS Client Admin" group, that user will not be an AFS Client
4055 Administrator.<span style='mso-spacerun:yes'> </span>Only users that are
4056 members of the "AFS Client Admins" group are AFS Client
4057 Administrators.<span style='mso-spacerun:yes'> </span>The local
4058 "SYSTEM" account is an implicit member of the "AFS Client
4059 Admins" group.</p>
4061 <p class=MsoNormal>Setting the default sysname for a machine should be done via
4063 href="#_Value_:_SysName">registry</a>
4064 and not via "fs sysname".<!--[if supportFields]><span
4065 style='mso-element:field-begin'></span> XE "AFS Client Admins" <![endif]--><!--[if supportFields]><span
4066 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
4067 style='mso-element:field-begin'></span><span
4068 style='mso-spacerun:yes'> </span>XE "fs.exe" <![endif]--><!--[if supportFields]><span
4069 style='mso-element:field-end'></span><![endif]--></p>
4071 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417050"></a><a
4072 name="_Toc115416114"><span style='mso-bookmark:_Toc115417050'>3.8. OpenAFS
4073 support for UNC paths</span></a> </h2>
4075 <p class=MsoNormal>The OpenAFS 1.4 client supports UNC paths everywhere.<span
4076 style='mso-spacerun:yes'> </span>UNC paths provide a canonical name for
4077 resources stored within AFS.<span style='mso-spacerun:yes'> </span>UNC paths
4078 should be used instead of drive letter mappings whenever possible.<span
4079 style='mso-spacerun:yes'> </span>This is especially true when specifying the
4080 location of roaming profiles and redirected folders.<!--[if supportFields]><span
4081 style='mso-element:field-begin'></span> XE "UNC paths" <![endif]--><!--[if supportFields]><span
4082 style='mso-element:field-end'></span><![endif]--><span
4083 style='mso-spacerun:yes'> </span></p>
4085 <p class=MsoNormal>Power users that make extensive use of the command line
4086 shell, cmd.exe, should consider using JP Software's 4NT or Take Command command
4087 processors.<span style='mso-spacerun:yes'> </span>Unlike cmd.exe, the
4088 JPSoftware shells fully support UNC paths as the current directory.<span
4089 style='mso-spacerun:yes'> </span>With the release of version 4NT 7.0 and Take
4090 Command 7.0, JPSoftware is adding special recognition of OpenAFS.<span
4091 style='mso-spacerun:yes'> </span>AFS paths can be entered in UNIX notation
4092 (e.g., <a href="file:///\\afs\openafs.org\software">/afs/openafs.org/software</a>),
4093 space utilization reports the output of the volume status for the specified
4094 path, and many AFS specific functions and variables have been added to the
4095 command language.</p>
4097 <p class=MsoNormal>JPSoftware's web site is <span class=MsoHyperlink>http://www.jpsoft.com</span>.<!--[if supportFields]><span
4098 style='mso-element:field-begin'></span> XE "JP Software" <![endif]--><!--[if supportFields]><span
4099 style='mso-element:field-end'></span><![endif]--><!--[if supportFields]><span
4100 style='mso-element:field-begin'></span><span
4101 style='mso-spacerun:yes'> </span>XE "4nt.exe" <![endif]--><!--[if supportFields]><span
4102 style='mso-element:field-end'></span><![endif]--></p>
4104 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417051"></a><a
4105 name="_Toc115416115"><span style='mso-bookmark:_Toc115417051'>3.9. OpenAFS
4106 includes aklog.exe</span></a></h2>
4108 <p class=MsoNormal>The OpenAFS 1.4 Client ships with its own version of
4109 aklog.exe which should be used in preference to those obtained by third party
4110 sources.<span style='mso-spacerun:yes'> </span>The OpenAFS aklog.exe supports
4111 Kerberos 5 as well as the ability to auto-generate pts IDs for user's obtaining
4112 tokens<span style='mso-spacerun:yes'> </span>for access to foreign cells.</p>
4114 <p class=PreformattedText>Usage: aklog [-d] [[-cell | -c] cell [-k krb_realm]]</p>
4116 <p class=PreformattedText><span style='mso-spacerun:yes'>
4117 </span>[[-p | -path] pathname]</p>
4119 <p class=PreformattedText><span style='mso-spacerun:yes'>
4120 </span>[-noprdb] [-force]</p>
4122 <p class=PreformattedText><span style='mso-spacerun:yes'>
4123 </span>[-5 [-m]| -4]</p>
4125 <p class=PreformattedText><o:p> </o:p></p>
4127 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>-d = output
4128 debugging information.</p>
4130 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>cell = zero
4131 or more cells for which tokens will be obtained</p>
4133 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>krb_realm =
4134 the kerberos realm of the cell.</p>
4136 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>pathname =
4137 the directory for which authentication is required</p>
4139 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>-noprdb =
4140 don't try to determine AFS ID.</p>
4142 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>-5 or -4 =
4143 use Kerberos V (default) or Kerberos IV tickets</p>
4145 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>-m = use
4146 krb524d to convert Kerberos V tickets to Kerberos IV<!--[if supportFields]><span
4147 style='mso-element:field-begin'></span> XE "aklog.exe" <![endif]--><!--[if supportFields]><span
4148 style='mso-element:field-end'></span><![endif]--></p>
4150 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417052"></a><a
4151 name="_Toc115416116"><span style='mso-bookmark:_Toc115417052'>3.10. OpenAFS
4152 Servers on Windows are Unsupported</span></a></h2>
4154 <p class=MsoNormal>The AFS Server functionality provided with OpenAFS 1.4 might
4155 work but should be considered highly experimental.<span
4156 style='mso-spacerun:yes'> </span>It has not been thoroughly tested.<span
4157 style='mso-spacerun:yes'> </span>Any data which would cause pain if lost
4158 should not be stored in an OpenAFS Server on Windows.</p>
4160 <p class=MsoNormal>A few notes on the usage of the AFS Client Service if it is
4161 going to be used with the OpenAFS AFS Server:</p>
4163 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
4164 l15 level1 lfo6;tab-stops:list 14.15pt'><![if !supportLists]><span
4165 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4166 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4167 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>When
4168 installed on the same machine as the AFS Server, Freelance mode must be turned
4169 off.<span style='mso-spacerun:yes'> </span>Otherwise, you will be unable to
4170 manipulate the contents of the root.afs volume for the hosted cell.</p>
4172 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
4173 l15 level1 lfo6;tab-stops:list 14.15pt'><![if !supportLists]><span
4174 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4175 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4176 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>The
4177 AFS Server and related tools only support the built in kaserver (Kerberos
4178 IV).<span style='mso-spacerun:yes'> </span>If the AFS Server is being used,
4179 MIT Kerberos for Windows should not be installed or must be disabled.<!--[if supportFields]><span
4180 style='mso-element:field-begin'></span> XE "AFS Servers" <![endif]--><!--[if supportFields]><span
4181 style='mso-element:field-end'></span><![endif]--></p>
4183 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417053"></a><a
4184 name="_Toc115416117"><span style='mso-bookmark:_Toc115417053'>3.11. OpenAFS
4185 Debugging Symbol files</span></a></h2>
4187 <p class=MsoNormal>The OpenAFS for Windows installers now include Debugging
4188 Symbol files which should be installed if you are experiencing problems and
4189 need to send crash reports.<span style='mso-spacerun:yes'> </span>This is true
4190 for both the release and the debug versions of the installers.<span
4191 style='mso-spacerun:yes'> </span>The difference between the release and debug
4194 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
4195 l16 level1 lfo7;tab-stops:list 14.15pt'><![if !supportLists]><span
4196 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4197 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4198 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>whether
4199 or not the binaries were compiled with optimization</p>
4201 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
4202 l16 level1 lfo7;tab-stops:list 14.15pt'><![if !supportLists]><span
4203 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4204 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4205 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>whether
4206 the debug symbols are installed by default</p>
4208 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
4209 l16 level1 lfo7;tab-stops:list 14.15pt'><![if !supportLists]><span
4210 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4211 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4212 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>whether
4213 additional debug statements were compiled into the binaries<!--[if supportFields]><span
4214 style='mso-element:field-begin'></span> XE "Symbol files" <![endif]--><!--[if supportFields]><span
4215 style='mso-element:field-end'></span><![endif]--></p>
4217 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417054"></a><a
4218 name="_Toc115416118"><span style='mso-bookmark:_Toc115417054'>3.12. Maximum
4219 File Size is 2GB</span></a></h2>
4221 <p class=MsoNormal>OpenAFS for Windows does not support files larger than
4222 2GB.<span style='mso-spacerun:yes'> </span>The version of the SMB/CIFS
4223 protocol implemented imposes this limitation.<span style='mso-spacerun:yes'>
4224 </span>Upgrading the SMB/CIFS implementation or replacing it with an
4225 Installable File System will allow larger files to be supported.<!--[if supportFields]><span
4226 style='mso-element:field-begin'></span> XE "large file support" <![endif]--><!--[if supportFields]><span
4227 style='mso-element:field-end'></span><![endif]--></p>
4229 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417055"></a><a
4230 name="_Toc115416119"><span style='mso-bookmark:_Toc115417055'>3.13. Encrypted
4231 AFS File Access</span></a></h2>
4233 <p class=MsoNormal>The OpenAFS for Windows installer by default activates a
4234 weak form of encrypted data transfer between the AFS client and the AFS
4235 servers.<span style='mso-spacerun:yes'> </span>This is often referred to as
4236 "fcrypt" mode.</p>
4238 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417056"></a><a
4239 name="_Toc115416120"><span style='mso-bookmark:_Toc115417056'>3.14.
4240 Authenticated Access to the OpenAFS Client Service</span></a></h2>
4242 <p class=MsoNormal>OpenAFS 1.4 supports authenticated SMB connections using
4243 either NTLM or GSS SPNEGO (NTLM).<span style='mso-spacerun:yes'> </span>In
4244 previous versions of OpenAFS, the SMB connections were unauthenticated which
4245 opened the door for several attacks which could be used to obtain access to
4246 another user's tokens on shared machines.<span style='mso-spacerun:yes'>
4249 <p class=MsoNormal>When GSS SPNEGO attempts a Kerberos 5 authentication, the
4250 Windows SMB client will attempt to retrieve service tickets for
4251 "cifs/afs@REALM" (if the loopback adapter is in use) or
4252 "cifs/machine-afs@REALM" (if the loopback adapter is not being
4253 used).<span style='mso-spacerun:yes'> </span>It is extremely important that
4254 this service principal not exist in the KDC database as the Kerberos
4255 authentication must fail allowing automatic fallback to NTLM.<span
4256 style='mso-spacerun:yes'> </span>When NTLM is used a special local
4257 authentication mode will be used that does not require access to the user's
4258 password.<span style='mso-spacerun:yes'> </span>Instead, Windows will
4259 internally recognize the request as coming from a local logon session.</p>
4261 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417057"></a><a
4262 name="_Toc115416121"><span style='mso-bookmark:_Toc115417057'>3.15. No More INI
4263 Files</span></a></h2>
4265 <p class=MsoNormal>Previous AFS clients for Windows stored configuration data
4266 in Windows .INI files. <span style='mso-spacerun:yes'> </span>OpenAFS 1.4 does
4267 not use Windows .INI files for the storage of configuration data.<span
4268 style='mso-spacerun:yes'> </span>All settings are now stored in the registry
4270 href="#_Appendix_A:_Registry_Values">Appendix
4271 A</a>).<span style='mso-spacerun:yes'> </span>The CellServDB file is now
4272 stored in the %PROGRAMFILES%\OpenAFS\Client directory.<span
4273 style='mso-spacerun:yes'> </span>The <i style='mso-bidi-font-style:normal'><a
4274 href="#_Value___: CellServDBDir">CellServDBDir</a></i>
4275 registry value can be used to specify an alternative location.</p>
4277 <p class=MsoNormal>OpenAFS 1.4 will relocate the contents of the afsdcell.ini
4278 file to the new CellServDB file.<span style='mso-spacerun:yes'> </span>OpenAFS
4279 1.4 will also import the contents of the afs_freelance.ini file to the
4280 Windows registry.<span style='mso-spacerun:yes'> </span>OpenAFS 1.4 will not
4281 process the contents of the afsddbmt.ini.</p>
4283 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417058"></a><a
4284 name="_Toc115416122"><span style='mso-bookmark:_Toc115417058'>3.16. Microsoft
4285 Windows Internet Connection Firewall</span></a></h2>
4287 <p class=MsoNormal>The OpenAFS 1.4 Client is compatible with the Internet Connection
4288 Firewall that debuted with Windows XP SP2 and Windows 2003 SP1.<span
4289 style='mso-spacerun:yes'> </span>The Internet Connection Firewall will be
4290 automatically adjusted to allow the receipt of incoming callback messages from
4291 the AFS file server.<span style='mso-spacerun:yes'> </span>In addition, the
4292 appropriate <i>Back Connection</i> registry entries are added to allow SMB
4293 authentication to be performed across the Microsoft Loopback Adapter.</p>
4295 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417059"></a><a
4296 name="_Toc115416123"><span style='mso-bookmark:_Toc115417059'>3.17. Browsing
4297 AFS from the Explorer Shell and Office</span></a></h2>
4299 <p class=MsoNormal>The OpenAFS 1.4 Client Service implements the CIFS Remote
4300 Admin Protocol which allows Explorer to browse server and share information.
4301 This significantly enhances the interoperability of AFS volumes within the
4302 Explorer Shell and Microsoft Office applications.</p>
4304 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417060"></a><a
4305 name="_Toc115416124"><span style='mso-bookmark:_Toc115417060'>3.18. No Support
4306 for </span></a><st2:place w:st="on"><st2:PlaceName w:st="on"><span
4307 style='mso-bookmark:_Toc115417060'><span style='mso-bookmark:_Toc115416124'>Byte</span></span></st2:PlaceName><span
4308 style='mso-bookmark:_Toc115417060'><span style='mso-bookmark:_Toc115416124'> <st2:PlaceType
4309 w:st="on">Range</st2:PlaceType></span></span></st2:place><span
4310 style='mso-bookmark:_Toc115417060'><span style='mso-bookmark:_Toc115416124'>
4311 Locking</span></span></h2>
4313 <p class=MsoBodyText>Many applications on Windows (e.g. Microsoft Office)
4314 require the use of byte range locks applied to a file either to protect against
4315 simultaneous file access or as a signaling mechanism.<span
4316 style='mso-spacerun:yes'> </span>OpenAFS does not currently support byte
4317 range locks.<span style='mso-spacerun:yes'> </span>It is strongly recommended
4318 that files not be edited within AFS if they might be accessed by multiple users
4319 or multiple processes on a single machine.</p>
4321 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417061"></a><a
4322 name="_Toc115416125"><span style='mso-bookmark:_Toc115417061'>3.19. Automatic
4323 Discarding of AFS Tokens at Logoff</span></a></h2>
4325 <p class=MsoNormal>OpenAFS 1.4 will automatically forget a user's tokens upon
4326 Logoff unless the user's profile was loaded from an AFS volume.<span
4327 style='mso-spacerun:yes'> </span>In this situation there is no mechanism to
4328 determine when the profile has been successfully written back to the
4329 network.<span style='mso-spacerun:yes'> </span>It is therefore unsafe to
4330 release the user's tokens.<span style='mso-spacerun:yes'> </span>Whether or
4331 not the profile has been loaded from the registry can be determined for Local
4332 Accounts, Active Directory accounts and NT4 accounts.</p>
4334 <p class=MsoNormal>If there is a need to disable this functionality, the <span
4335 style='mso-bidi-font-style:italic'><a
4336 href="#_Value_:_LogoffPreserveTokens">LogoffPreserveTokens</a></span>
4337 registry value can be used. (see <a
4338 href="#_Appendix_A:_Registry_Values">Appendix
4341 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417062"></a><a
4342 name="_Toc115416126"><span style='mso-bookmark:_Toc115417062'>3.20. Terminal
4343 Server installations</span></a></h2>
4345 <p class=MsoNormal>When installing the NSIS (.exe) installer under Terminal
4346 Server, you must execute it from within the Add/Remove Programs Control
4347 Panel.<span style='mso-spacerun:yes'> </span>Failure to do so will result in
4348 AFS not running properly.<span style='mso-spacerun:yes'> </span>The AFS Server
4349 should not be installed on a machine with Terminal Server installed.</p>
4351 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417063"></a><a
4352 name="_Toc115416127"><span style='mso-bookmark:_Toc115417063'>3.21. Hidden Dot
4353 Files</span></a></h2>
4355 <p class=MsoNormal>AFS is a UNIX native file system.<span
4356 style='mso-spacerun:yes'> </span>The OpenAFS client attempts to treat the
4357 files stored in AFS as they would be on UNIX.<span style='mso-spacerun:yes'>
4358 </span>File and directory names beginning with a "." are
4359 automatically given the Hidden attribute so they will not normally be
4362 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417064"></a><a
4363 name="_Toc115416128"><span style='mso-bookmark:_Toc115417064'>3.22. Status
4364 Cache Limits</span></a></h2>
4366 <p class=MsoNormal>The Status Cache (AFS Configuration Control Panel: Advanced
4367 Page) is defined to have a maximum number of entries.<span
4368 style='mso-spacerun:yes'> </span>Each entry represents a single file or
4369 directory entry accessed within the AFS file system.<span
4370 style='mso-spacerun:yes'> </span>When the maximum number of entries are
4371 allocated, entries will begin to be reused according to a least recently used
4372 (LRU) algorithm.<span style='mso-spacerun:yes'> </span>If the number of files
4373 or directories being accessed repeatedly by your applications is greater then
4374 the maximum number of entries, your host will begin to experience thrashing of
4375 the Status Cache and all requests will result in network operations.</p>
4377 <p class=MsoNormal>If you are experiencing poor performance try increasing the
4378 maximum number of Status Cache entries.<span style='mso-spacerun:yes'>
4379 </span>Each entry requires approximately 1.2K.<span style='mso-spacerun:yes'>
4380 </span>In OpenAFS 1.4, the default number of Status Cache entries is 10,000.</p>
4382 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417065"></a><a
4383 name="_Toc115416129"><span style='mso-bookmark:_Toc115417065'>3.23. NETBIOS
4384 over TCP/IP must be enabled</span></a></h2>
4386 <p class=MsoNormal>"Netbios over TCP/IP" must be active on the
4387 machine in order for communication with the AFS Client Service to succeed.<span
4388 style='mso-spacerun:yes'> </span>If "Netbios over TCP/IP" is
4389 disabled on the machine, then communication with the AFS Client Service will be
4392 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417066"></a><a
4393 name="_Toc115416130"><span style='mso-bookmark:_Toc115417066'>3.24. OpenAFS
4394 binaries are digitally signed</span></a></h2>
4396 <p class=MsoNormal>The OpenAFS Client Service and related binaries distributed
4397 by OpenAFS.org are digitally signed by "Secure Endpoints Inc.".<span
4398 style='mso-spacerun:yes'> </span>The OpenAFS Client Service will perform a
4399 run-time verification check to ensure that all OpenAFS related DLLs loaded by
4400 the service match the same file version number and were signed by the same
4401 entity.<span style='mso-spacerun:yes'> </span>This check has been added to
4402 prevent the stability problems caused by more than one AFS installation present
4403 on a machine at the same time.<span style='mso-spacerun:yes'> </span>Many
4404 hours of support time have been wasted tracking down problems caused by the
4405 mixture of files from different releases.<span style='mso-spacerun:yes'>
4408 <p class=MsoNormal><a
4409 href="#_Appendix_A:_Registry_Values">Appendix
4410 A</a> documents the "<a
4411 href="#_Value___: VerifyServiceSignature">VerifyServiceSignature</a>"
4412 registry value which can be used to disable the signature check.<span
4413 style='mso-spacerun:yes'> </span>The file version check cannot be disabled.</p>
4415 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417067"></a><a
4416 name="_Toc115416131"><span style='mso-bookmark:_Toc115417067'>3.25. Maximum
4417 Size of the AFSCache File</span></a></h2>
4419 <p class=MsoNormal>The maximum cache size is approximately 1.3GB.<span
4420 style='mso-spacerun:yes'> </span>This is the largest contiguous block of
4421 memory in the 2GB process address space which can be used for constructing a
4422 memory mapped file.<span style='mso-spacerun:yes'> </span>Due to fragmentation
4423 of the process space caused by the loading of libraries required by the digital
4424 signature verification code, any attempt to specify a cache size greater then
4425 700MB will result in the automatic disabling of the signature check.</p>
4427 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417068"></a><a
4428 name="_Toc115416132"><span style='mso-bookmark:_Toc115417068'>3.26. Filename
4429 Character Sets</span></a></h2>
4431 <p class=MsoNormal>OpenAFS for Windows implements an SMB server which is used
4432 as a gateway to the AFS filesystem.<span style='mso-spacerun:yes'>
4433 </span>Because of limitations of the SMB implementation, Windows stores all
4434 files into AFS using OEM code pages such as CP437 (United States) or CP850
4435 (Western Europe).<span style='mso-spacerun:yes'> </span>These code pages are
4436 incompatible with the ISO Latin-1 character set typically used as the default
4437 on UNIX systems in both the <st2:country-region w:st="on">United States</st2:country-region>
4438 and <st2:place w:st="on">Western Europe</st2:place>.<span
4439 style='mso-spacerun:yes'> </span>Filenames stored by OpenAFS for Windows are
4440 therefore unreadable on UNIX systems if they include any of the following
4443 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
4444 style='border-collapse:collapse;border:none;mso-border-alt:solid windowtext .5pt;
4445 mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;mso-border-insideh:
4446 .5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
4447 <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
4449 <td width=590 valign=top style='width:442.8pt;border:solid windowtext 1.0pt;
4450 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt;height:399.5pt'>
4451 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[Ç]<span
4452 style='mso-spacerun:yes'> </span>128<span style='mso-spacerun:yes'>
4453 </span>08/00<span style='mso-spacerun:yes'> </span>200<span
4454 style='mso-spacerun:yes'> </span>80<span style='mso-spacerun:yes'> </span>C
4456 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ü]<span
4457 style='mso-spacerun:yes'> </span>129<span style='mso-spacerun:yes'>
4458 </span>08/01<span style='mso-spacerun:yes'> </span>201<span
4459 style='mso-spacerun:yes'> </span>81<span style='mso-spacerun:yes'> </span>u
4461 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[é]<span
4462 style='mso-spacerun:yes'> </span>130<span style='mso-spacerun:yes'>
4463 </span>08/02<span style='mso-spacerun:yes'> </span>202<span
4464 style='mso-spacerun:yes'> </span>82<span style='mso-spacerun:yes'> </span>e
4466 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[â]<span
4467 style='mso-spacerun:yes'> </span>131<span style='mso-spacerun:yes'>
4468 </span>08/03<span style='mso-spacerun:yes'> </span>203<span
4469 style='mso-spacerun:yes'> </span>83<span style='mso-spacerun:yes'> </span>a
4471 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ä]<span
4472 style='mso-spacerun:yes'> </span>132<span style='mso-spacerun:yes'>
4473 </span>08/04<span style='mso-spacerun:yes'> </span>204<span
4474 style='mso-spacerun:yes'> </span>84<span style='mso-spacerun:yes'> </span>a
4476 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[à]<span
4477 style='mso-spacerun:yes'> </span>133<span style='mso-spacerun:yes'>
4478 </span>08/05<span style='mso-spacerun:yes'> </span>205<span
4479 style='mso-spacerun:yes'> </span>85<span style='mso-spacerun:yes'> </span>a
4481 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[å]<span
4482 style='mso-spacerun:yes'> </span>134<span style='mso-spacerun:yes'>
4483 </span>08/06<span style='mso-spacerun:yes'> </span>206<span
4484 style='mso-spacerun:yes'> </span>86<span style='mso-spacerun:yes'> </span>a
4486 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ç]<span
4487 style='mso-spacerun:yes'> </span>135<span style='mso-spacerun:yes'>
4488 </span>08/07<span style='mso-spacerun:yes'> </span>207<span
4489 style='mso-spacerun:yes'> </span>87<span style='mso-spacerun:yes'> </span>c
4491 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ê]<span
4492 style='mso-spacerun:yes'> </span>136<span style='mso-spacerun:yes'>
4493 </span>08/08<span style='mso-spacerun:yes'> </span>210<span
4494 style='mso-spacerun:yes'> </span>88<span style='mso-spacerun:yes'> </span>e
4496 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ë]<span
4497 style='mso-spacerun:yes'> </span>137<span style='mso-spacerun:yes'>
4498 </span>08/09<span style='mso-spacerun:yes'> </span>211<span
4499 style='mso-spacerun:yes'> </span>89<span style='mso-spacerun:yes'> </span>e
4501 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[è]<span
4502 style='mso-spacerun:yes'> </span>138<span style='mso-spacerun:yes'>
4503 </span>08/10<span style='mso-spacerun:yes'> </span>212<span
4504 style='mso-spacerun:yes'> </span>8A<span style='mso-spacerun:yes'> </span>e
4506 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ï]<span
4507 style='mso-spacerun:yes'> </span>139<span style='mso-spacerun:yes'>
4508 </span>08/11<span style='mso-spacerun:yes'> </span>213<span
4509 style='mso-spacerun:yes'> </span>8B<span style='mso-spacerun:yes'> </span>i
4511 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[î]<span
4512 style='mso-spacerun:yes'> </span>140<span style='mso-spacerun:yes'>
4513 </span>08/12<span style='mso-spacerun:yes'> </span>214<span
4514 style='mso-spacerun:yes'> </span>8C<span style='mso-spacerun:yes'> </span>i
4516 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ì]<span
4517 style='mso-spacerun:yes'> </span>141<span style='mso-spacerun:yes'>
4518 </span>08/13<span style='mso-spacerun:yes'> </span>215<span
4519 style='mso-spacerun:yes'> </span>8D<span style='mso-spacerun:yes'> </span>i
4521 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[Ä]<span
4522 style='mso-spacerun:yes'> </span>142<span style='mso-spacerun:yes'>
4523 </span>08/14<span style='mso-spacerun:yes'> </span>216<span
4524 style='mso-spacerun:yes'> </span>8E<span style='mso-spacerun:yes'> </span>A
4526 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[Å]<span
4527 style='mso-spacerun:yes'> </span>143<span style='mso-spacerun:yes'>
4528 </span>08/15<span style='mso-spacerun:yes'> </span>217<span
4529 style='mso-spacerun:yes'> </span>8F<span style='mso-spacerun:yes'> </span>A
4531 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[É]<span
4532 style='mso-spacerun:yes'> </span>144<span style='mso-spacerun:yes'>
4533 </span>09/00<span style='mso-spacerun:yes'> </span>220<span
4534 style='mso-spacerun:yes'> </span>90<span style='mso-spacerun:yes'> </span>E
4536 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[æ]<span
4537 style='mso-spacerun:yes'> </span>145<span style='mso-spacerun:yes'>
4538 </span>09/01<span style='mso-spacerun:yes'> </span>221<span
4539 style='mso-spacerun:yes'> </span>91<span style='mso-spacerun:yes'>
4540 </span>ae diphthong</p>
4541 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[Æ]<span
4542 style='mso-spacerun:yes'> </span>146<span style='mso-spacerun:yes'>
4543 </span>09/02<span style='mso-spacerun:yes'> </span>222<span
4544 style='mso-spacerun:yes'> </span>92<span style='mso-spacerun:yes'>
4545 </span>AE diphthong</p>
4546 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ô]<span
4547 style='mso-spacerun:yes'> </span>147<span style='mso-spacerun:yes'>
4548 </span>09/03<span style='mso-spacerun:yes'> </span>223<span
4549 style='mso-spacerun:yes'> </span>93<span style='mso-spacerun:yes'> </span>o
4551 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ö]<span
4552 style='mso-spacerun:yes'> </span>148<span style='mso-spacerun:yes'>
4553 </span>09/04<span style='mso-spacerun:yes'> </span>224<span
4554 style='mso-spacerun:yes'> </span>94<span style='mso-spacerun:yes'> </span>o
4556 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ò]<span
4557 style='mso-spacerun:yes'> </span>149<span style='mso-spacerun:yes'>
4558 </span>09/05<span style='mso-spacerun:yes'> </span>225 <span
4559 style='mso-spacerun:yes'> </span>95<span style='mso-spacerun:yes'> </span>o
4561 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[û]<span
4562 style='mso-spacerun:yes'> </span>150<span style='mso-spacerun:yes'>
4563 </span>09/06<span style='mso-spacerun:yes'> </span>226<span
4564 style='mso-spacerun:yes'> </span>96<span style='mso-spacerun:yes'> </span>u
4566 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ù]<span
4567 style='mso-spacerun:yes'> </span>151<span style='mso-spacerun:yes'>
4568 </span>09/07<span style='mso-spacerun:yes'> </span>227<span
4569 style='mso-spacerun:yes'> </span>97<span style='mso-spacerun:yes'> </span>u
4571 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ÿ]<span
4572 style='mso-spacerun:yes'> </span>152<span style='mso-spacerun:yes'>
4573 </span>09/08<span style='mso-spacerun:yes'> </span>230<span
4574 style='mso-spacerun:yes'> </span>98<span style='mso-spacerun:yes'> </span>y
4576 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[Ö]<span
4577 style='mso-spacerun:yes'> </span>153<span style='mso-spacerun:yes'>
4578 </span>09/09<span style='mso-spacerun:yes'> </span>231<span
4579 style='mso-spacerun:yes'> </span>99<span style='mso-spacerun:yes'> </span>O
4581 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[Ü]<span
4582 style='mso-spacerun:yes'> </span>154<span style='mso-spacerun:yes'>
4583 </span>09/10<span style='mso-spacerun:yes'> </span>232<span
4584 style='mso-spacerun:yes'> </span>9A<span style='mso-spacerun:yes'> </span>U
4586 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[ø]<span
4587 style='mso-spacerun:yes'> </span>155<span style='mso-spacerun:yes'>
4588 </span>09/11<span style='mso-spacerun:yes'> </span>233<span
4589 style='mso-spacerun:yes'> </span>9B<span style='mso-spacerun:yes'> </span>o
4591 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[£]<span
4592 style='mso-spacerun:yes'> </span>156<span style='mso-spacerun:yes'>
4593 </span>09/12<span style='mso-spacerun:yes'> </span>234<span
4594 style='mso-spacerun:yes'> </span>9C<span style='mso-spacerun:yes'>
4595 </span>Pound sterling sign</p>
4596 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[Ø]<span
4597 style='mso-spacerun:yes'> </span>157<span style='mso-spacerun:yes'>
4598 </span>09/13<span style='mso-spacerun:yes'> </span>235<span
4599 style='mso-spacerun:yes'> </span>9D<span style='mso-spacerun:yes'> </span>O
4601 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[×]<span
4602 style='mso-spacerun:yes'> </span>158<span style='mso-spacerun:yes'>
4603 </span>09/14<span style='mso-spacerun:yes'> </span>236<span
4604 style='mso-spacerun:yes'> </span>9E<span style='mso-spacerun:yes'>
4605 </span>Multiplication sign</p>
4606 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>[]<span
4607 style='mso-spacerun:yes'> </span>159<span style='mso-spacerun:yes'>
4608 </span>09/15<span style='mso-spacerun:yes'> </span>237<span
4609 style='mso-spacerun:yes'> </span>9F<span style='mso-spacerun:yes'> </span><st2:place
4610 w:st="on">Florin</st2:place> sign</p>
4615 <p class=PreformattedText><o:p> </o:p></p>
4617 <p class=MsoNormal>OpenAFS 1.4 provides an optional registry value, <i><a
4618 href="#_Value___: StoreAnsiFilenames">StoreAnsiFilenames</a></i>,
4619 that can be set to instruct OpenAFS to store filenames using the ANSI Code Page
4620 instead of the OEM Code Page.<span style='mso-spacerun:yes'> </span>The ANSI
4621 Code Page is a compatible superset of Latin-1.<span style='mso-spacerun:yes'>
4622 </span>This setting is not the default setting because making this change would
4623 prevent OpenAFS for Windows from being able to access filenames containing the
4624 above characters which were created without this setting.</p>
4626 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417069"></a><a
4627 name="_Toc115416133"><span style='mso-bookmark:_Toc115417069'>3.27. Known
4628 Character Set Issues with Roaming Profiles</span></a></h2>
4630 <p class=MsoNormal>There is a known issue with storing Windows Roaming Profiles
4631 when the profile contains either directories or files with names which cannot
4632 be represented in the local OEM character set.<span style='mso-spacerun:yes'>
4633 </span>In this case, attempts to write the profile back to AFS will fail.<span
4634 style='mso-spacerun:yes'> </span>OpenAFS for Windows does not currently
4635 support UNICODE.<span style='mso-spacerun:yes'> </span>To avoid this problem
4636 some sites run logoff scripts (assigned by group policy) which rename all files
4637 to use only the supported characters for the locale.</p>
4639 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417070"></a><a
4640 name="_Toc115416134"><span style='mso-bookmark:_Toc115417070'>3.28. The
4641 AFSCache File</span></a></h2>
4643 <p class=MsoNormal>The AFS Cache file is stored by default at %TEMP%\AFSCache
4644 in a persistent file marked with the Hidden and System attributes.<span
4645 style='mso-spacerun:yes'> </span>The persistent nature of the data stored in
4646 the cache file improves the performance of OpenAFS by reducing the number of
4647 times data must be read from the AFS file servers.<span
4648 style='mso-spacerun:yes'> </span></p>
4650 <p class=MsoNormal>The performance of the AFS Client Service is significantly
4651 affected by the access times associated with the AFSCache paging file.<span
4652 style='mso-spacerun:yes'> </span>When given the choice, the AFSCache file
4653 should be placed on a fast disk, preferably NTFS, the file should not be
4654 compressed and should consist of as few fragments as possible.<span
4655 style='mso-spacerun:yes'> </span>Significant performance gains can be
4656 achieved by defragmenting the AFSCache file with Sysinternal's Contig utility.</p>
4658 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417071"></a><a
4659 name="_Toc115416135"><span style='mso-bookmark:_Toc115417071'>3.29. Restricting
4660 OpenAFS Client Service Start and Stop</span></a></h2>
4662 <p class=MsoNormal>A new command line tool, afsdacl.exe, can be used to
4663 restrict the ability to start and stop the OpenAFS Client Service.</p>
4665 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>afsdacl :
4666 Set or reset the DACL to allow starting or stopping</p>
4668 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>the
4669 afsd service by any ordinary user.</p>
4671 <p class=PreformattedText><o:p> </o:p></p>
4673 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>Usage :
4674 afsdacl [-set | -reset] [-show]</p>
4676 <p class=PreformattedText><span style='mso-spacerun:yes'> </span><span
4677 style='mso-spacerun:yes'> </span>-set<span style='mso-spacerun:yes'>
4678 </span>: Sets the DACL</p>
4680 <p class=PreformattedText><span style='mso-spacerun:yes'>
4681 </span>-reset : Reset the DACL</p>
4683 <p class=PreformattedText><span style='mso-spacerun:yes'>
4684 </span>-show<span style='mso-spacerun:yes'> </span>: Show current DACL (SDSF)</p>
4686 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417072"></a><a
4687 name="_Toc115416136"><span style='mso-bookmark:_Toc115417072'>3.30. The @sys
4688 Name List</span></a></h2>
4690 <p class=MsoNormal>The default @sys name list in OpenAFS 1.4 is set to
4691 "x86_win32 i386_w2k i386_nt40" for 32-bit x86 systems.<span
4692 style='mso-spacerun:yes'> </span>The default for itanium will be
4693 "ia64_win64" and "amd64_win64" for amd 64-bit processors
4694 when those platforms are supported.</p>
4696 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417073"></a><a
4697 name="_Toc115416137"><span style='mso-bookmark:_Toc115417073'>3.31. Symlinks to
4698 AFS UNC paths</span></a></h2>
4700 <p class=MsoNormal>In OpenAFS 1.4, symlinks to AFS UNC paths, \\AFS[\all]\...,
4701 are treated the same as symlinks to /afs/...<span style='mso-spacerun:yes'>
4702 </span>However, please use /afs/... as the Windows UNC form will not work on UNIX.</p>
4704 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417074"></a><a
4705 name="_Toc115416138"><span style='mso-bookmark:_Toc115417074'>3.32. Cache
4706 Manager Debugging Now Supported</span></a></h2>
4708 <p class=MsoNormal>OpenAFS for Windows 1.4 implements the Cache Manager
4709 Debugging RPC Interface.<span style='mso-spacerun:yes'> </span>The CM debugger
4710 can be queried with cmdebug.exe.</p>
4712 <p class=PreformattedText>Usage: cmdebug -servers <server machine> [-port
4713 <IP port>] [-long]</p>
4715 <p class=PreformattedText><span style='mso-spacerun:yes'>
4716 </span>[-addrs] [-cache] [-help]</p>
4718 <p class=PreformattedText>Where: -long<span style='mso-spacerun:yes'>
4719 </span>print all info</p>
4721 <p class=PreformattedText><span style='mso-spacerun:yes'>
4722 </span>-addrs<span style='mso-spacerun:yes'> </span>print only host interfaces</p>
4724 <p class=PreformattedText><span style='mso-spacerun:yes'>
4725 </span>-cache<span style='mso-spacerun:yes'> </span>print only cache
4728 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417075"></a><a
4729 name="_Toc115416139"><span style='mso-bookmark:_Toc115417075'>3.33. Windows
4730 Logon Caching vs. Kerberos Logons</span></a></h2>
4732 <p class=MsoNormal>If you are a site which utilizes MIT/Heimdal Kerberos
4733 principals to logon to Windows via a cross-realm relationship with a
4734 multi-domain Windows forest, you must enable Windows logon caching unless the
4735 workstation is Windows Vista Beta 1 or later.</p>
4737 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417076"></a><a
4738 name="_Toc115416140"><span style='mso-bookmark:_Toc115417076'>3.34. Initial
4739 Server Preferences</span></a></h2>
4741 <p class=MsoNormal>VLDB and File Server Preferences can now be provided initial
4742 values using registry keys.<span style='mso-spacerun:yes'> </span>This is
4743 useful for managed machines in a Windows domain which are centrally located
4744 (e.g., in a computing lab.)<span style='mso-spacerun:yes'> </span>See <a
4745 href="#_Appendix_A:_Registry_Values">Appendix
4746 A</a> for details on the "<a
4747 href="#_Regkey:_[HKLMSOFTWAREOpenAFSClie_2">Server
4748 Preferences</a>" keys.</p>
4750 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417077"></a><a
4751 name="_Toc115416141"><span style='mso-bookmark:_Toc115417077'>3.35. File
4752 Timestamps</span></a></h2>
4754 <p class=MsoNormal>OpenAFS 1.4 reports timestamps on files stored in AFS in UTC
4755 all year round.<span style='mso-spacerun:yes'> </span>In locales with daylight
4756 savings time, previous versions of AFS for Windows reported the time when DST
4757 is active as UTC+1.<span style='mso-spacerun:yes'> </span>This was done to
4758 preserve the relative local time for the user.<span style='mso-spacerun:yes'>
4759 </span>A file stored at 11:00am EST in January would be reported as having been
4760 stored at 11:00am EDT in June.<span style='mso-spacerun:yes'>
4761 </span>Unfortunately, this has the negative side effect of changing the
4762 reported timestamp from 16:00UTC to 15:00UTC.<span style='mso-spacerun:yes'>
4763 </span>Since Windows treats all file times in UTC, data synchronization
4764 applications which rely on the timestamp would believe that all files stored in
4765 AFS had changed.</p>
4767 <p class=MsoNormal>It should be noted that UNIX based operating systems (such
4768 as Solaris) do not appear to report file times to applications in UTC.<span
4769 style='mso-spacerun:yes'> </span>They do preserve the relative local
4770 time.<span style='mso-spacerun:yes'> </span>This may confuse some users who are
4771 used to being able to compare the timestamp in an UNIX shell with the timestamp
4772 from the Windows explorer.<span style='mso-spacerun:yes'> </span>During DST,
4773 these two times will no longer agree even though they are in fact representing
4774 the same moment in time.</p>
4776 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417078"></a><a
4777 name="_Toc115416142"><span style='mso-bookmark:_Toc115417078'>3.36. Windows RPC
4778 client support must be installed</span></a> </h2>
4780 <p class=MsoNormal>If the installer refuses to install and complains about an
4781 RPC configuration error, check to ensure that the following registry entries
4782 are present and that they refer to the dll "rpcrt4.dll":</p>
4784 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>HKLM
4785 "SOFTWARE\Microsoft\RPC\ClientProtocols" "ncacn_np"</p>
4787 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>HKLM
4788 "SOFTWARE\Microsoft\RPC\ClientProtocols" "ncacn_ip_tcp"</p>
4790 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>HKLM
4791 "SOFTWARE\Microsoft\RPC\ClientProtocols" "ncadg_ip_udp"</p>
4793 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>HKLM
4794 "SOFTWARE\Microsoft\RPC\ClientProtocols" "ncacn_http"</p>
4796 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417079"></a><a
4797 name="_Toc115416143"><span style='mso-bookmark:_Toc115417079'>3.37. Generating
4798 Minidumps of the OpenAFS Client Service</span></a></h2>
4800 <p class=MsoNormal>OpenAFS 1.4 adds a new command, "fs
4801 minidump".<span style='mso-spacerun:yes'> </span>This command can be used
4802 at any time to generate a mini dump file containing the current stack of the
4803 afsd_service.exe process.<span style='mso-spacerun:yes'> </span>This output
4804 can be very helpful when debugging the AFS Client Service when it is
4805 unresponsive to SMB/CIFS requests.</p>
4807 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417080"></a><a
4808 name="_Toc115416144"><span style='mso-bookmark:_Toc115417080'>3.38. AFS Client
4809 Universally Unique Identifiers</span></a></h2>
4811 <p class=MsoNormal>The OpenAFS for Windows 1.4 client implements Universally
4812 Unique Identifiers (UUIDs).<span style='mso-spacerun:yes'> </span>They are
4813 used to provide the server with a method of identifying the client that is
4814 independent of IP address.<span style='mso-spacerun:yes'> </span>The UUID is
4815 generated when the AFSCache file is created and is maintained as long as the
4816 contents of the AFSCache file are kept intact.<span style='mso-spacerun:yes'>
4817 </span>The UUID is stored in the AFSCache file.<span
4818 style='mso-spacerun:yes'> </span>When cloning machines that have Windows AFS
4819 client installed, the AFSCache files must be deleted as part of the cloning
4822 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417112"></a><a
4823 name="_Toc115417081"></a><a name="_Toc115416145"><span style='mso-bookmark:
4824 _Toc115417081'><span style='mso-bookmark:_Toc115417112'>4. How to Debug
4825 Problems with OpenAFS for Windows:</span></span></a></h1>
4827 <p class=MsoNormal>OpenAFS for Windows provides a wide range of tools to assist
4828 you in debugging problems.<span style='mso-spacerun:yes'> </span>The
4829 techniques available to you are varied because of the wide range of issues that
4830 have been discovered over the years.</p>
4832 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417082"></a><a
4833 name="_Toc115416146"><span style='mso-bookmark:_Toc115417082'>4.1. pioctl
4834 debugging (</span></a><a
4835 href="#_Value___: IoctlDebug"><span
4836 style='mso-bookmark:_Toc115416146'><span style='mso-bookmark:_Toc115417082'>IoctlDebug</span></span><span
4837 style='mso-bookmark:_Toc115416146'><span style='mso-bookmark:_Toc115417082'></span></span></a><span
4838 style='mso-bookmark:_Toc115416146'><span style='mso-bookmark:_Toc115417082'>
4839 registry key)</span></span></h2>
4841 <p class=MsoNormal>pioctl (path-based ioctl) calls are used by various tools to
4842 communicate with the AFS Client Service.<span style='mso-spacerun:yes'>
4843 </span>Some of the operations performed include:</p>
4845 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4846 l17 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
4847 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4848 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4849 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>setting/querying
4850 tokens<span style='mso-spacerun:yes'> </span>(tokens.exe, aklog.exe,
4853 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4854 l17 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
4855 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4856 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4857 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>setting/querying
4860 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4861 l17 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
4862 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4863 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4864 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>setting/querying
4865 cache parameters</p>
4867 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4868 l17 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
4869 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4870 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4871 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>flushing
4872 files or volumes</p>
4874 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4875 l17 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
4876 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4877 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4878 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>setting/querying
4879 server preferences</p>
4881 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4882 l17 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
4883 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4884 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4885 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>querying
4888 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4889 l17 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
4890 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4891 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4892 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>checking
4893 the status of servers and volumes</p>
4895 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
4896 l17 level1 lfo8;tab-stops:list 14.15pt'><![if !supportLists]><span
4897 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
4898 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
4899 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>setting/querying
4900 the sysname list</p>
4902 <p class=MsoNormal>pioctl calls are implemented by writing to a special UNC
4903 path that is processed by the AFS Client Service.<span
4904 style='mso-spacerun:yes'> </span>If there is a failure to communicate with
4905 the AFS Client Service via SMB/CIFS, it will be impossible to perform any of
4906 the above operations.<span style='mso-spacerun:yes'> </span></p>
4908 <p class=MsoNormal>To assist in debugging these problems, the registry value:</p>
4910 <p class=PreformattedText><span style='mso-spacerun:yes'>
4911 </span>[HKLM\SOFTWARE\OpenAFS\Client]</p>
4913 <p class=PreformattedText><span style='mso-spacerun:yes'>
4914 </span>REG_DWORD:<span style='mso-spacerun:yes'> </span>IoctlDebug<span
4915 style='mso-spacerun:yes'> </span>= 0x01</p>
4917 <p class=MsoNormal>should be set.<span style='mso-spacerun:yes'> </span>Then
4918 any of the commands that perform pioctl calls should be executed from the
4919 command prompt.<span style='mso-spacerun:yes'> </span>With this key set the
4920 pioctl library will generate debugging output to stderr.<span
4921 style='mso-spacerun:yes'> </span>The output will contain the Win32 API calls
4922 executed along with their most important parameters and their return code.<span
4923 style='mso-spacerun:yes'> </span>The MSDN Library and the Microsoft
4924 KnowledgeBase can be used as a reference to help you determine the
4925 configuration probem with your system.</p>
4927 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417083"></a><a
4928 name="_Toc115416147"><span style='mso-bookmark:_Toc115417083'>4.2. afsd_service
4929 initialization log (%WinDir%\TEMP\afsd_init.log)</span></a></h2>
4931 <p class=MsoNormal>Every time the AFS Client Service starts it appends data
4932 about its progress and configuration to a file.<span style='mso-spacerun:yes'>
4933 </span>This file provides information crucial to determining why the service
4934 cannot start when there are problems.<span style='mso-spacerun:yes'>
4935 </span>When the process terminates due to a panic condition it will write to
4936 this file the source code file and line number of the error.<span
4937 style='mso-spacerun:yes'> </span>In many cases the panic condition is due to a
4938 misconfiguration of the machine.<span style='mso-spacerun:yes'> </span>In
4939 other cases it might be due to a programming error in the software.<span
4940 style='mso-spacerun:yes'> </span>A quick review of the location in the source
4941 code will quickly reveal the reason for the termination.</p>
4943 <p class=MsoNormal>The <i style='mso-bidi-font-style:normal'><a
4944 href="#_Value___: MaxLogSize">MaxLogSize</a></i>
4945 registry value determines the maximum size of the %WINDIR%\TEMP\afsd_init.log
4946 file.<span style='mso-spacerun:yes'> </span>If the file is larger than this
4947 value when OpenAFS Client Service starts, the file will be reset to 0
4948 bytes.<span style='mso-spacerun:yes'> </span>If value is set to 0, the file
4949 will be allowed to grow indefinitely.</p>
4951 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417084"></a><a
4952 name="_Toc115416148"><span style='mso-bookmark:_Toc115417084'>4.3. afsd_service
4953 debug logs (fs trace {-on, -off, -dump} ->%WinDir%\TEMP\afsd.log)</span></a></h2>
4955 <p class=MsoNormal>When attempting to debug the behavior of the SMB/CIFS Server
4956 and the Cache Manager it is often useful to examine a log of the operations
4957 being performed.<span style='mso-spacerun:yes'> </span>While running the AFS
4958 Client Service keeps an in memory log of many of its actions.<span
4959 style='mso-spacerun:yes'> </span>The default number of actions preserved at
4960 any one time is 5000.<span style='mso-spacerun:yes'> </span>This can be
4961 adjusted with the <a
4962 href="#_Value_:_TraceBufferSize">registry
4965 <p class=PreformattedText><span style='mso-spacerun:yes'>
4966 </span>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
4968 <p class=PreformattedText><span style='mso-spacerun:yes'>
4969 </span>REG_DWORD<span style='mso-spacerun:yes'> </span>TraceBufferSize </p>
4971 <p class=MsoNormal>A restart of the service is necessary when adjusting this
4972 value.<span style='mso-spacerun:yes'> </span>Execute "fs trace -on"
4973 to clear to the log and "fs trace -dump" to output the contents of
4974 the log to the file.</p>
4976 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417085"></a><a
4977 name="_Toc115416149"><span style='mso-bookmark:_Toc115417085'>4.4. Using
4978 SysInternals DbgView and FileMon Tools</span></a></h2>
4980 <p class=MsoNormal>An alternatve option to the use of "fs trace -dump"
4981 to capture internal OpenAFS Client Service events is to use a tool such as
4982 Sysinternal's DbgView to capture real-time debugging output.<span
4983 style='mso-spacerun:yes'> </span>When the OpenAFS Client Service starts and Bit
4985 href="#_Value__:_TraceOption">TraceOption</a>
4986 value in the registry is set, all trace log events are output using the Windows
4987 Debug Monitor interface (OutputDebugString).<span style='mso-spacerun:yes'>
4990 <p class=PreformattedText><span style='mso-spacerun:yes'>
4991 </span>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
4993 <p class=PreformattedText style='text-indent:12.0pt'>REG_DWORD<span
4994 style='mso-spacerun:yes'> </span>TraceOption = 0x04</p>
4996 <p class=MsoNormal>Use fs trace on and fs trace off to toggle the
4997 generation of log messages. </p>
4999 <p class=MsoNormal>Sysinternals FileMon utility can be use to monitor the file
5000 operations requested by applications and their success or failure.<span
5001 style='mso-spacerun:yes'> </span>Restrict FileMon to monitor Network Volumes
5002 only in order to reduce the output to just the CIFS requests. <span
5003 style='mso-spacerun:yes'> </span></p>
5005 <p class=MsoNormal>Turn on the <i style='mso-bidi-font-style:normal'>Clock Time</i>
5006 option in both tools to make it easier to synchronize the application requests
5007 and the resulting OpenAFS Client Service operations.<span
5008 style='mso-spacerun:yes'> </span>The captured data can be stored to files for
5009 inclusion in bug reports.</p>
5011 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417086"></a><a
5012 name="_Toc115416150"><span style='mso-bookmark:_Toc115417086'>4.5. Microsoft
5014 (fs minidump -> %WinDir%\TEMP\afsd.dmp)</span></a></h2>
5016 <p class=MsoNormal>If the AFS Client Service become unresponsive to any form of
5017 communication there may be a serious error that can only be debugged by someone
5018 with access to the source code and a debugger.<span style='mso-spacerun:yes'>
5019 </span>The "fs minidump" command can be used to force the generation
5020 of a MiniDump file containing the state of all of the threads in the AFS Client
5021 Service process.</p>
5023 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417087"></a><a
5024 name="_Toc115416151"><span style='mso-bookmark:_Toc115417087'>4.6. Single
5025 Sign-on (Integrated Logon) debugging</span></a></h2>
5027 <p class=MsoNormal>If you are having trouble with the Integrated Logon
5028 operations it is often useful to be able to obtain a log of what it is
5029 attempting to do.<span style='mso-spacerun:yes'> </span>Setting Bit 0 of the <a
5030 href="#_Value__:_TraceOption">TraceOption</a>
5033 <p class=PreformattedText><span style='mso-spacerun:yes'>
5034 </span>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
5036 <p class=PreformattedText><span style='mso-spacerun:yes'>
5037 </span>REG_DWORD<span style='mso-spacerun:yes'> </span>TraceOption = 0x01</p>
5039 <p class=MsoNormal>will instruct the Integrated Logon Network Provider and
5040 Event Handlers to log information to the Windows Event Log: Application under
5041 the name AFS Logon".</p>
5043 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417088"></a><a
5044 name="_Toc115416152"><span style='mso-bookmark:_Toc115417088'>4.7. RX (AFS RPC)
5045 debugging (rxdebug)</span></a></h2>
5047 <p class=MsoNormal>The rxdebug.exe tool can be used to query a variety of
5048 information about the AFS services installed on a given machine.<span
5049 style='mso-spacerun:yes'> </span>The port for the AFS Cache Manager is
5050 7001.<span style='mso-spacerun:yes'> </span></p>
5052 <p class=PreformattedText>Usage: rxdebug -servers <server machine> [-port
5053 <IP port>] [-nodally] </p>
5055 <p class=PreformattedText style='margin-left:35.45pt;text-indent:35.45pt'><span
5056 style='mso-spacerun:yes'> </span>[-allconnections] [-rxstats] [-onlyserver]
5059 <p class=PreformattedText style='margin-left:70.9pt'><span
5060 style='mso-spacerun:yes'> </span>[-onlyport <show only <port>>] </p>
5062 <p class=PreformattedText style='margin-left:70.9pt'><span
5063 style='mso-spacerun:yes'> </span>[-onlyhost <show only <host>>] </p>
5065 <p class=PreformattedText style='margin-left:70.9pt'><span
5066 style='mso-spacerun:yes'> </span>[-onlyauth <show only <auth
5067 level>>] [-version] </p>
5069 <p class=PreformattedText style='margin-left:70.9pt'><span
5070 style='mso-spacerun:yes'> </span>[-noconns] [-peers] [-help]</p>
5072 <p class=PreformattedText>Where: -nodally<span
5073 style='mso-spacerun:yes'> </span>don't show dallying conns</p>
5075 <p class=PreformattedText><span style='mso-spacerun:yes'>
5076 </span>-allconnections<span style='mso-spacerun:yes'> </span>don't filter out
5077 uninteresting connections</p>
5079 <p class=PreformattedText><span style='mso-spacerun:yes'>
5080 </span>-rxstats<span style='mso-spacerun:yes'> </span>show Rx
5083 <p class=PreformattedText><span style='mso-spacerun:yes'>
5084 </span>-onlyserver<span style='mso-spacerun:yes'> </span>only show server
5087 <p class=PreformattedText><span style='mso-spacerun:yes'>
5088 </span>-onlyclient<span style='mso-spacerun:yes'> </span>only show client
5091 <p class=PreformattedText><span style='mso-spacerun:yes'>
5092 </span>-version<span style='mso-spacerun:yes'> </span>show AFS version
5095 <p class=PreformattedText><span style='mso-spacerun:yes'>
5096 </span>-noconns<span style='mso-spacerun:yes'> </span>show no
5099 <p class=PreformattedText><span style='mso-spacerun:yes'>
5100 </span>-peers<span style='mso-spacerun:yes'> </span>show peers</p>
5102 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417089"></a><a
5103 name="_Toc115416153"><span style='mso-bookmark:_Toc115417089'>4.8. Cache
5104 Manager debugging (cmdebug)</span></a></h2>
5106 <p class=MsoNormal>The cmdebug.exe tool can be used to query the state of the
5107 AFS Cache Manager on a given machine.</p>
5109 <p class=PreformattedText>Usage: cmdebug -servers <server machine> [-port
5110 <IP port>] [-long] </p>
5112 <p class=PreformattedText style='margin-left:70.9pt'><span
5113 style='mso-spacerun:yes'> </span>[-refcounts] [-callbacks] [-addrs] [-cache]
5116 <p class=PreformattedText>Where: -long<span style='mso-spacerun:yes'>
5117 </span>print all info</p>
5119 <p class=PreformattedText><span style='mso-spacerun:yes'>
5120 </span>-refcounts<span style='mso-spacerun:yes'> </span>print only cache
5121 entries with positive reference counts</p>
5123 <p class=PreformattedText><span style='mso-spacerun:yes'>
5124 </span>-callbacks<span style='mso-spacerun:yes'> </span>print only cache
5125 entries with callbacks</p>
5127 <p class=PreformattedText><span style='mso-spacerun:yes'>
5128 </span>-addrs<span style='mso-spacerun:yes'> </span>print only host
5131 <p class=PreformattedText><span style='mso-spacerun:yes'>
5132 </span>-cache<span style='mso-spacerun:yes'> </span>print only cache
5135 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417090"></a><a
5136 name="_Toc115416154"><span style='mso-bookmark:_Toc115417090'>4.9. Persistent
5137 Cache consistency check</span></a></h2>
5139 <p class=MsoNormal>The persistent cache is stored in a Hidden System file at
5140 %WinDir%\TEMP\AFSCache.<span style='mso-spacerun:yes'> </span>If there is a
5141 problem with the persistent cache that prevent the AFS Client Service from
5142 being able to start a validation check on the file can be performed.</p>
5144 <p class=PreformattedText><span style='mso-spacerun:yes'>
5145 </span>afsd_service.exe --validate-cache <cache-path></p>
5147 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417113"></a><a
5148 name="_Toc115417091"></a><a name="_Toc115416155"><span style='mso-bookmark:
5149 _Toc115417091'><span style='mso-bookmark:_Toc115417113'>5. Reporting Bugs:</span></span></a></h1>
5151 <p class=MsoNormal>Bug reports should be sent to <a
5152 href="mailto:openafs-bugs@openafs.org?subject=Bug%20Report">openafs-bugs@openafs.org</a>.<span
5153 style='mso-spacerun:yes'> </span>Please include as much information as
5154 possible about the issue.<span style='mso-spacerun:yes'> </span>If you are
5155 reporting a crash, please install the debugging symbols by re-running the
5156 installer.<span style='mso-spacerun:yes'> </span>If a dump file is available
5157 for the problem, %WINDIR%\TEMP\afsd.dmp, include it along with the AFS Client
5158 Trace file<span style='mso-spacerun:yes'> </span>%WINDIR%\TEMP\afsd.log.<span
5159 style='mso-spacerun:yes'> </span>The AFS Client startup log is
5160 %WINDIR%\TEMP\afsd_init.log.<span style='mso-spacerun:yes'> </span>Send the
5161 last continuous block of<span style='mso-spacerun:yes'> </span>log information
5164 <p class=MsoNormal>Configuring DrWatson to generate dump files for crashes:</p>
5166 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
5167 l18 level1 lfo9;tab-stops:list 14.15pt'><![if !supportLists]><span
5168 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
5169 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
5170 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Run
5171 drwtsn32.exe to configure or to identify where the log and the crash dump files
5174 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
5175 l19 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
5176 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
5177 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
5178 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>click
5179 Start > Run...<span style='mso-spacerun:yes'> </span></p>
5181 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
5182 l19 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
5183 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
5184 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
5185 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>type
5186 drwtsn32 <enter>. </p>
5188 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
5189 l19 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
5190 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
5191 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
5192 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Select
5193 either a Crash Dump Type: Mini or Full. </p>
5195 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
5196 l19 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
5197 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
5198 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
5199 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Clear
5200 Dump Symbol Table</p>
5202 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
5203 l19 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
5204 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
5205 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
5206 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Clear
5207 Append to Existing Log file. </p>
5209 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
5210 l19 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
5211 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
5212 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
5213 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Check
5214 Dump All Thread Contexts.</p>
5216 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
5217 l19 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
5218 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
5219 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
5220 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Check
5221 Create Crash Dump File</p>
5223 <p class=MsoNormal style='margin-left:14.15pt;text-indent:-14.15pt;mso-list:
5224 l19 level1 lfo10;tab-stops:list 14.15pt'><![if !supportLists]><span
5225 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
5226 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
5227 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Next
5228 run the monitoring module of Dr. Watson: </p>
5230 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
5231 l20 level1 lfo11;tab-stops:list 14.15pt'><![if !supportLists]><span
5232 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
5233 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
5234 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>click
5235 Start > Run...</p>
5237 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
5238 l20 level1 lfo11;tab-stops:list 14.15pt'><![if !supportLists]><span
5239 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
5240 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
5241 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>type
5242 drwatson <enter>. </p>
5244 <p class=MsoNormal style='margin-left:49.6pt;text-indent:-14.15pt;mso-list:
5245 l20 level1 lfo11;tab-stops:list 14.15pt'><![if !supportLists]><span
5246 style='font-size:9.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
5247 mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
5248 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Once
5249 a crash happens, Dr. Watson generates a dump file and a report in the log file,
5250 including the address of the crash and the stack dump.</p>
5252 <p class=MsoNormal>Once you have the Dr. Watson's logfile and minidump, zip
5253 them and attach them to your e-mail.</p>
5255 <p class=MsoNormal>When reporting a error, please be sure to include the
5256 version of OpenAFS.</p>
5258 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417114"></a><a
5259 name="_Toc115417092"></a><a name="_Toc115416156"><span style='mso-bookmark:
5260 _Toc115417092'><span style='mso-bookmark:_Toc115417114'>6. How to Contribute to
5261 the Development of OpenAFS for Windows</span></span></a></h1>
5263 <p class=MsoNormal>Contributions to the development of OpenAFS for Windows are
5264 continuously needed.<span style='mso-spacerun:yes'> </span>Contributions may
5265 take many forms including cash donations, support contracts, donated developer
5266 time, and even donated tech writer time.</p>
5268 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417093"></a><a
5269 name="_Toc115416157"><span style='mso-bookmark:_Toc115417093'>6.1. The USENIX
5270 OpenAFS Fund</span></a> </h2>
5272 <p class=MsoBodyText><a href="http://www.usenix.org/">USENIX</a>, a 501c3
5273 non-profit corporation, has formed the USENIX OpenAFS Fund in order to accept
5274 tax deductible donations on behalf of the OpenAFS Elders. The donated funds
5275 will be allocated by the OpenAFS Elders to fund OpenAFS development,
5276 documentation, project management, and maintaining openafs.org. </p>
5278 <div style='mso-element:frame;mso-element-frame-height:66.05pt;mso-element-wrap:
5279 no-wrap-beside;mso-element-anchor-vertical:page;mso-element-left:.05pt;
5280 mso-element-top:372.8pt'>
5282 <table cellspacing=0 cellpadding=0 hspace=0 vspace=0 width=540 height=88>
5284 <td valign=top align=left height=88 style='padding-top:0pt;padding-right:
5285 9.0pt;padding-bottom:0pt;padding-left:9.0pt'>
5286 <p class=MsoEnvelopeAddress style='mso-element:frame;mso-element-frame-height:
5287 66.05pt;mso-element-wrap:no-wrap-beside;mso-element-anchor-vertical:page;
5288 mso-element-left:.05pt;mso-element-top:372.8pt'>USENIX OpenAFS Fund<br>
5289 USENIX Association <br>
5290 <st2:address w:st="on"><st2:Street w:st="on">2560 Ninth St., Suite 215</st2:Street>
5292 <st2:City w:st="on">Berkeley</st2:City>, <st2:State w:st="on">CA</st2:State> <st2:PostalCode
5293 w:st="on">94710</st2:PostalCode></st2:address> </p>
5300 <![if !supportTextWrap]><br clear=ALL>
5303 <p class=MsoBodyText>Donations can be made by sending a check, drawn on a U.S.
5304 bank, made out to the USENIX OpenAFS Fund or by making a <a
5305 href="https://db.usenix.org/cgi-bin/openafs/openafs.cgi">donation online</a>.</p>
5307 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417094"><span
5308 style='mso-fareast-language:JA'>6.2. Secure Endpoints Inc.</span></a><span
5309 style='mso-fareast-language:JA'> <o:p></o:p></span></h2>
5311 <p class=MsoBodyText><span style='mso-fareast-language:JA'><a
5312 href="http://www.secure-endpoints.com/">Secure Endpoints Inc.</a> provides
5313 development and support services for OpenAFS for Windows and MIT Kerberos for
5314 Windows. <span style='mso-spacerun:yes'> </span>Donations provided to Secure
5315 Endpoints Inc. for the development of OpenAFS are used to cover the OpenAFS
5316 gatekeeper responsibilities; providing support to the OpenAFS community via the
5317 OpenAFS mailing lists; and furthering development of desired features that are
5318 either too small to be financed by development contracts.<o:p></o:p></span></p>
5320 <p class=MsoBodyText><span style='mso-fareast-language:JA'>Secure Endpoints
5321 Inc. accepts software development agreements from organizations who wish to
5322 fund a well-defined set of bug fixes or new features. <o:p></o:p></span></p>
5324 <p class=MsoBodyText><span style='mso-fareast-language:JA'>Secure Endpoints Inc.
5325 provides contract based support for the OpenAFS for Windows and the MIT
5326 Kerberos for Windows products. <o:p></o:p></span></p>
5328 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417095"><span
5329 style='mso-fareast-language:JA'>6.3. The MIT Kerberos Account</span></a><span
5330 style='mso-fareast-language:JA'> <o:p></o:p></span></h2>
5332 <p class=MsoNormal style='margin:0pt;margin-bottom:.0001pt;mso-pagination:widow-orphan;
5333 mso-hyphenate:auto;mso-layout-grid-align:none;text-autospace:none'><span
5334 style='font-family:"Times New Roman";mso-fareast-font-family:"MS Mincho";
5335 color:black;mso-fareast-language:JA'>Th</span><span class=BodyTextChar><span
5336 style='mso-fareast-language:JA'>e <a href="http://web.mit.edu/kerberos/">MIT
5337 Kerberos</a> development team accepts unrestricted grants. <span
5338 style='mso-spacerun:yes'> </span>Grants are tax deductible and the full amount
5339 of the grant will be used to fund the development of Kerberos 5 and/or Kerberos
5340 for Windows. <span style='mso-spacerun:yes'> </span>OpenAFS for Windows is
5341 dependent on MIT Kerberos for Windows for authentication and shares many of the
5342 same re</span></span><span style='font-family:"Times New Roman";mso-fareast-font-family:
5343 "MS Mincho";color:black;mso-fareast-language:JA'>quirements for credential
5344 management. <span style='mso-spacerun:yes'> </span>Future releases of both
5345 products will share a common identity management user interface. <o:p></o:p></span></p>
5347 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417096"><span
5348 style='mso-fareast-language:JA'>6.4. Direct contributions of code and/or
5349 documentation</span></a><span style='mso-fareast-language:JA'> <o:p></o:p></span></h2>
5351 <p class=MsoBodyText><span style='mso-fareast-language:JA'>Organizations that
5352 use OpenAFS in house and have development staffs are encouraged to contribute
5353 any code modifications they make to OpenAFS.org via <u><span style='color:blue'>openafs-bugs@openafs.org</span></u>.
5354 <span style='mso-spacerun:yes'> </span>Contributions of documentation are
5355 highly desired. <o:p></o:p></span></p>
5357 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417097">6.5.
5358 OpenAFS for Windows Mailing Lists</a></h2>
5360 <p class=MsoNormal>If you wish to participate in OpenAFS for Windows
5361 development please join the <i><a
5362 href="mailto:openafs-win32-devel@openafs.org?subject=OpenAFS%20for%20Windows%20Development%20Contribution">openafs-win32-devel@openafs.org</a></i>
5365 <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>
5367 <p class=MsoNormal>User questions should be sent to the <a
5368 href="mailto:openafs-info@openafs.org?subject=OpenAFS%20for%20Windows%20User%20Question">openafs-info@openafs.org</a>
5369 mailing list.<span style='mso-spacerun:yes'> </span></p>
5371 <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>
5373 <p class=MsoNormal>You must join the mailing lists if you wish to post to the
5374 list without incurring a moderation delay.</p>
5376 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417115"></a><a
5377 name="_Toc115417098"></a><a name="_Toc115416158"></a><a
5378 name="_MSI_Deployment_Guide"></a><![if !supportLists]><span style='mso-bookmark:
5379 _Toc115417115'><span style='mso-bookmark:_Toc115417098'><span style='mso-bookmark:
5380 _Toc115416158'></span></span></span><![endif]><span style='mso-bookmark:_Toc115417115'><span
5381 style='mso-bookmark:_Toc115417098'><span style='mso-bookmark:_Toc115416158'>7. MSI
5382 Deployment Guide</span></span></span></h1>
5386 <b><span style='font-size:16.0pt;font-family:Albany;mso-fareast-font-family:
5387 "MS Mincho";mso-bidi-font-family:Tahoma;mso-ansi-language:EN-US;mso-fareast-language:
5388 #00FF;mso-bidi-language:AR-SA'><br clear=all style='page-break-before:always;
5389 mso-break-type:section-break'>
5392 <div class=Section2>
5394 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417099"></a><a
5395 name="_Toc115416159"><span style='mso-bookmark:_Toc115417099'>7.1. Introduction</span></a></h2>
5397 <p class=MsoNormal>A MSI installer option is available for those who wish to
5398 use Windows Installer for installing OpenAFS and for organizations that wish to
5399 deploy OpenAFS through Group Policy.<span style='mso-spacerun:yes'> </span>The
5400 first version of OpenAFS for Windows available as an MSI was 1.3.65.</p>
5402 <p class=MsoNormal>This document provides a guide for authoring transforms used
5403 to customize the MSI package for a particular organization.<span
5404 style='mso-spacerun:yes'> </span>Although many settings can be deployed via
5405 transforms, in an Active Directory environment it is advisable to deploy
5406 registry settings<span style='mso-spacerun:yes'> </span>and configuration
5407 files through group policy and/or startup scripts so that machines where
5408 OpenAFS for Windows is already installed will pick up these customizations.</p>
5410 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416160">7.1.1
5411 Requirements</a></h3>
5413 <p class=MsoNormal>The information in this document applies to MSI packages
5414 distributed with OpenAFS for Windows releases from 1.3.65 and onwards or MSI
5415 packages built from corresponding source releases. <span
5416 style='mso-spacerun:yes'> </span>Not all releases support all the configuration
5417 options documented here.</p>
5419 <p class=MsoNormal>Authoring a "Windows Installer" transform requires
5420 additional software for editing the MSI database tables and generating the
5421 transform from the modified MSI package.<span style='mso-spacerun:yes'>
5422 </span>ORCA.EXE and MSITRAN.EXE which are included in the Windows Platform SDK ("Windows
5423 Installer" SDK) can be used for this purpose.</p>
5425 <p class=MsoNormal>For reference, the schema for the MSI package is based on
5426 SCHEMA.MSI distributed with the Platform SDK.</p>
5428 <p class=MsoNormal>For general information about "Windows Installer",
5431 <p class=MsoNormal><span style='mso-spacerun:yes'> </span><a
5432 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>
5434 <p class=MsoNormal>For general information about authoring MSI transforms,
5437 <p class=MsoNormal><span style='mso-spacerun:yes'> </span><a
5438 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>
5440 <p class=MsoNormal>The remainder of this document assumes some familiarity with
5441 authoring transforms.<span style='mso-spacerun:yes'> </span>While the MSDN
5442 documentation for Windows Installer is a bit dense, the guide on MSI transforms
5443 found at the second link above is recommended reading.<span
5444 style='mso-spacerun:yes'> </span>MSDN also includes a step-by-step example for
5445 creating a transform at:</p>
5447 <p class=MsoNormal><span style='mso-spacerun:yes'> </span><a
5448 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>
5450 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416161">7.1.2 Authoring
5451 a Transform</a></h3>
5453 <p class=MsoNormal>Transforms describe a set of modifications to be performed
5454 on an existing MSI for the purpose of customizing it.<span
5455 style='mso-spacerun:yes'> </span>This is ordinarily done by making a copy of
5456 the MSI to be customized, modifying the copy and then using the old and the new
5457 MSI to generate a transform.<span style='mso-spacerun:yes'> </span>For
5460 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
5461 mso-list:l35 level1 lfo14;tab-stops:list 36.0pt'><![if !supportLists]><span
5462 style='mso-list:Ignore'>1.<span style='font:7.0pt "Times New Roman"'>
5463 </span></span><![endif]>copy openafs.msi openafs-modified.msi</p>
5465 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
5466 mso-list:l35 level1 lfo14;tab-stops:list 36.0pt'><![if !supportLists]><span
5467 style='mso-list:Ignore'>2.<span style='font:7.0pt "Times New Roman"'>
5468 </span></span><![endif]>(edit the openafs-modified.msi to include the necessary
5471 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
5472 mso-list:l35 level1 lfo14;tab-stops:list 36.0pt'><![if !supportLists]><span
5473 style='mso-list:Ignore'>3.<span style='font:7.0pt "Times New Roman"'>
5474 </span></span><![endif]>msitran -g openafs.msi openafs-modified.msi
5475 openafs-transform.mst</p>
5477 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
5478 mso-list:l35 level1 lfo14;tab-stops:list 36.0pt'><![if !supportLists]><span
5479 style='mso-list:Ignore'>4.<span style='font:7.0pt "Times New Roman"'>
5480 </span></span><![endif]>(generates openafs-transform.mst, which is the
5483 <p class=MsoNormal>Transforms have an extension of .mst.<span
5484 style='mso-spacerun:yes'> </span>'msitran' is a tool distributed as part of the
5485 "Windows Installer" SDK (part of the Windows Platform SDK).</p>
5487 <p class=MsoNormal>You can test a transform by:</p>
5489 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
5490 mso-list:l34 level1 lfo16;tab-stops:list 36.0pt'><![if !supportLists]><span
5491 style='mso-list:Ignore'>1.<span style='font:7.0pt "Times New Roman"'>
5492 </span></span><![endif]>copy openafs.msi openafs-test.msi</p>
5494 <p class=PreformattedText style='margin-left:36.0pt;text-indent:-18.0pt;
5495 mso-list:l34 level1 lfo16;tab-stops:list 36.0pt'><![if !supportLists]><span
5496 style='mso-list:Ignore'>2.<span style='font:7.0pt "Times New Roman"'>
5497 </span></span><![endif]>msitran -a openafs-transform.mst openafs-test.msi</p>
5499 <p class=MsoNormal>and then checking the resulting openafs-test.msi to see if
5500 all changes you have made above to openafs-modified.msi is present in
5501 openafs-test.msi.<span style='mso-spacerun:yes'> </span>'msitran' will
5502 complain if some modification in the transform can not be successfully applied.</p>
5504 <p class=MsoNormal>As mentioned above, you can use a tool like ORCA.EXE to edit
5505 the MSI databases directly when editing openafs-modified.msi.<span
5506 style='mso-spacerun:yes'> </span>More details are given below.</p>
5508 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417100"></a><a
5509 name="_Toc115416162"><span style='mso-bookmark:_Toc115417100'>7.2. Configuration
5510 Options</span></a></h2>
5512 <p class=MsoNormal>The logic necessary to implement many of the settings
5514 href="#_Appendix_A:_Registry_Values">Appendix
5515 A</a> are present in the MSI.<span style='mso-spacerun:yes'> </span>Most of
5516 these can be controlled by setting the corresponding properties to the desired
5517 value.<span style='mso-spacerun:yes'> </span>Some settings may require
5518 modifying existing registry entries (though not recommended) or adding new
5519 resources (like files or registry keys).<span style='mso-spacerun:yes'>
5520 </span>Instructions for performing these tasks are below.</p>
5522 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416163">7.2.1
5523 Configurable Properties</a></h3>
5525 <p class=MsoNormal>Most configurable properties correspond to registry keys or
5526 values.<span style='mso-spacerun:yes'> </span>Due to the logic invoked based
5527 on the existence of these registry keys or values, they are only set if the
5528 associated property is defined to have a non null value.<span
5529 style='mso-spacerun:yes'> </span>If the associated property is not defined in
5530 the MSI, the registry key or value will not be touched.<span
5531 style='mso-spacerun:yes'> </span>By default, the MSI does not contain these
5532 properties and hence will not set the registry keys.<span
5533 style='mso-spacerun:yes'> </span>You will need to add properties as needed to
5536 <p class=MsoNormal>When one of the configurable properties is set, the
5537 installer will use the property value to set the corresponding setting in the
5538 HKEY_LOCAL_MACHINE registry hive.<span style='mso-spacerun:yes'> </span>The HKEY_CURRENT_USER
5539 hive is not touched by the installer.</p>
5541 <p class=MsoNormal>For each property, the associated registry setting is
5542 referenced by the same text used in <a
5543 href="#_Appendix_A:_Registry_Values">Appendix
5546 <p class=MsoNormal>Strings are quoted using single quotes (e.g. 'a string'). An
5547 empty string is denoted as ''.<span style='mso-spacerun:yes'> </span>Note that
5548 you can't author null values into the 'Property' table.</p>
5550 <p class=MsoNormal>Numeric values should be authored as decimal strings.</p>
5552 <h4><a name="_Toc115416164">7.2.1.1 Setting Properties</a></h4>
5554 <p class=MsoNormal>In order to set a property,</p>
5556 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5557 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l32 level1 lfo18;tab-stops:
5558 list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;mso-fareast-font-family:
5559 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.<span
5560 style='font:7.0pt "Times New Roman"'>
5561 </span></span></span><![endif]>Open the MSI in ORCA.EXE</p>
5563 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5564 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l32 level1 lfo18;tab-stops:
5565 list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;mso-fareast-font-family:
5566 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.<span
5567 style='font:7.0pt "Times New Roman"'>
5568 </span></span></span><![endif]>Select the 'Property' table from the list of
5569 tables on the left.</p>
5571 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5572 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l32 level1 lfo18;tab-stops:
5573 list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;mso-fareast-font-family:
5574 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3.<span
5575 style='font:7.0pt "Times New Roman"'>
5576 </span></span></span><![endif]>Find the property in the list of properties on
5577 the right, double click the value and type the new value.</p>
5579 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5580 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l32 level1 lfo18;tab-stops:
5581 list 18.0pt'><![if !supportLists]><span style='font-size:9.0pt;mso-fareast-font-family:
5582 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>4.<span
5583 style='font:7.0pt "Times New Roman"'>
5584 </span></span></span><![endif]>If the property does not exist in the property
5585 list, right click the list and select 'Add Row', type the property name and the
5588 <h4><a name="_Toc115416165">7.2.1.2 OpenAFS for Windows Properties</a></h4>
5590 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
5591 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5592 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
5593 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
5594 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5595 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416166"></a><a
5596 name="_(Service_parameters):"></a><span style='mso-bookmark:_Toc115416166'>(Service
5597 parameters):</span></h5>
5598 <p class=ListContents style='margin-left:0pt;mso-yfti-cnfc:1'>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]<span
5599 style='mso-bidi-language:#00FF'><o:p></o:p></span></p>
5602 <tr style='mso-yfti-irow:0'>
5603 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5604 <h5 style='mso-outline-level:5'><a name="_Toc115416167"></a><a
5605 name="_(Network_provider):"></a><span style='mso-bookmark:_Toc115416167'>(Network
5606 provider):</span></h5>
5607 <p class=ListContents style='margin-left:0pt'>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]</p>
5610 <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
5611 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5612 <h5 style='mso-outline-level:5'><a name="_Toc115416168"></a><a
5613 name="_(OpenAFS_Client):"></a><span style='mso-bookmark:_Toc115416168'>(OpenAFS
5614 Client):</span></h5>
5615 <p class=ListContents style='margin-left:0pt'>[HKLM\SOFTWARE\OpenAFS\Client]<span
5616 style='mso-bidi-language:#00FF'><o:p></o:p></span></p>
5621 <h5><a name="_Toc115416169">7.2.1.2.1 Registry Properties</a></h5>
5623 <p class=MsoNormal>These properties are used to set the values of registry
5624 entries associated with OpenAFS for Windows.</p>
5626 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
5627 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5628 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
5629 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
5630 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5631 <h6 style='mso-outline-level:6;mso-yfti-cnfc:1'><a name="_Toc115416170">AFSCACHEPATH</a></h6>
5632 <p class=MsoList style='mso-yfti-cnfc:1'>Registry key<span
5633 style='mso-spacerun:yes'> </span>: <a
5634 href="#_(Service_parameters):">(Service
5636 <p class=MsoList style='mso-yfti-cnfc:1'>Registry value : <a
5637 href="#_Value_:_CachePath">CachePath</a></p>
5638 <p class=MsoList style='mso-yfti-cnfc:1'>Valid values<span
5639 style='mso-spacerun:yes'> </span>: string .</p>
5642 <tr style='mso-yfti-irow:0'>
5643 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5644 <h6 style='mso-outline-level:6'><a name="_Toc115416171">AFSCACHESIZE</a></h6>
5645 <p class=MsoList>Registry key<span style='mso-spacerun:yes'> </span>: <a
5646 href="#_(Service_parameters):">(Service
5648 <p class=MsoList>Registry value : <a
5649 href="#_Value___: CacheSize">CacheSize</a></p>
5650 <p class=MsoList>Valid values<span style='mso-spacerun:yes'> </span>:
5654 <tr style='mso-yfti-irow:1'>
5655 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5656 <h6 style='mso-outline-level:6'><a name="_Toc115416172">AFSCELLNAME</a></h6>
5657 <p class=MsoList>Registry key<span style='mso-tab-count:1'> </span>: <a
5658 href="#_(Service_parameters):">(Service
5660 <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
5661 href="#_Value_:_Cell">Cell</a></p>
5662 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>:
5666 <tr style='mso-yfti-irow:2'>
5667 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5668 <h6 style='mso-outline-level:6'><a name="_Toc115416173">FREELANCEMODE</a></h6>
5669 <p class=MsoList>Registry key<span style='mso-tab-count:1'> </span>: <a
5670 href="#_(Service_parameters):">(Service
5672 <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
5673 href="#_Value_:_FreelanceClient">FreelanceClient</a></p>
5674 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>: '1'
5678 <tr style='mso-yfti-irow:3'>
5679 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5680 <h6 style='mso-outline-level:6'><a name="_Toc115416174">HIDEDOTFILES</a></h6>
5681 <p class=MsoList>Registry key<span style='mso-tab-count:1'> </span>: <a
5682 href="#_(Service_parameters):">(Service
5684 <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
5685 href="#_Value_:_HideDotFiles">HideDotFiles</a></p>
5686 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>: '1'
5690 <tr style='mso-yfti-irow:4'>
5691 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5692 <h6 style='mso-outline-level:6'><a name="_Toc115416175">LOGONOPTIONS</a></h6>
5693 <p class=MsoList>Registry key<span style='mso-tab-count:1'> </span>: <a
5694 href="#_(Network_provider):">(Network
5696 <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
5697 href="#_Value___: LogonOptions">LogonOptions</a></p>
5698 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>: '0', '1'
5700 <p class=MsoNormal>See <a
5701 href="#_Appendix_A:_Registry_Values">Appendix
5703 href="#_A.2.1_Domain_specific_configuration">section
5704 2.1 (Domain specific configuration keys for Network Provider)</a> for more
5708 <tr style='mso-yfti-irow:5'>
5709 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5710 <h6 style='mso-outline-level:6'><a name="_Toc115416176">MOUNTROOT</a></h6>
5711 <p class=MsoList>Registry key<span style='mso-tab-count:1'> </span>: <a
5712 href="#_(Service_parameters):">(Service
5714 <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
5715 href="#_Value_:_Mountroot">Mountroot</a></p>
5716 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>:
5720 <tr style='mso-yfti-irow:6'>
5721 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5722 <h6 style='mso-outline-level:6'><a name="_Toc115416177">NETBIOSNAME</a></h6>
5723 <p class=MsoList>Registry key<span style='mso-tab-count:1'> </span>: <a
5724 href="#_(Service_parameters):">(Service
5726 <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
5727 href="#_Value___: NetbiosName">NetbiosName</a></p>
5728 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>:
5729 string (at most 15 characters)</p>
5732 <tr style='mso-yfti-irow:7'>
5733 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5734 <h6 style='mso-outline-level:6'><a name="_Toc115416178">NOFINDLANABYNAME</a></h6>
5735 <p class=MsoList>Registry key<span style='mso-tab-count:1'> </span>: <a
5736 href="#_(Service_parameters):">(Service
5738 <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
5739 href="#_Value___: NoFindLanaByName">NoFindLanaByName</a></p>
5740 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>: '1'
5744 <tr style='mso-yfti-irow:8'>
5745 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5746 <h6 style='mso-outline-level:6'><a name="_Toc115416179">RXMAXMTU</a></h6>
5747 <p class=MsoList>Registry key<span style='mso-tab-count:1'> </span>: <a
5748 href="#_(Service_parameters):">(Service
5750 <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
5751 href="#_Value_:_RxMaxMTU">RxMaxMTU</a></p>
5752 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>:
5756 <tr style='mso-yfti-irow:9'>
5757 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5758 <h6 style='mso-outline-level:6'><a name="_Toc115416180">SECURITYLEVEL</a></h6>
5759 <p class=MsoList>Registry key<span style='mso-tab-count:1'> </span>: <a
5760 href="#_(Service_parameters):">(Service
5762 <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
5763 href="#_Value_:_SecurityLevel">SecurityLevel</a></p>
5764 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>: '1'
5768 <tr style='mso-yfti-irow:10'>
5769 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5770 <h6 style='mso-outline-level:6'><a name="_Toc115416181">SMBAUTHTYPE</a></h6>
5771 <p class=MsoList>Registry key<span style='mso-tab-count:1'> </span>: <a
5772 href="#_(Service_parameters):">(Service
5774 <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
5775 href="#_Value___: smbAuthType">SMBAuthType</a></p>
5776 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>:
5780 <tr style='mso-yfti-irow:11'>
5781 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5782 <h6 style='mso-outline-level:6'><a name="_Toc115416182">STOREANSIFILENAMES</a></h6>
5783 <p class=MsoList>Registry key<span style='mso-tab-count:1'> </span>: <a
5784 href="#_(OpenAFS_Client):">(OpenAFS
5786 <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
5787 href="#_Value___: StoreAnsiFilenames">StoreAnsiFilenames</a></p>
5788 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>: '0' or
5792 <tr style='mso-yfti-irow:12;mso-yfti-lastrow:yes'>
5793 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5794 <h6 style='mso-outline-level:6'><a name="_Toc115416183">USEDNS</a></h6>
5795 <p class=MsoList>Registry key<span style='mso-tab-count:1'> </span>: <a
5796 href="#_(Service_parameters):">(Service
5798 <p class=MsoList>Registry value<span style='mso-tab-count:1'> </span>: <a
5799 href="#_Value_:_UseDNS">UseDNS</a></p>
5800 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>: '1'
5806 <h5><a name="_Toc115416184"></a><a name="_7.2.1.2.2_AFSCreds.exe_Properties"></a><span
5807 style='mso-bookmark:_Toc115416184'>7.2.1.2.2 AFSCreds.exe Properties</span></h5>
5809 <p class=MsoNormal>These properties are combined to add a command line option
5810 to the shortcut that will be created in the Start:Programs:OpenAFS and
5811 Start:Programs:Startup folders (see CREDSSTARTUP).<span
5812 style='mso-spacerun:yes'> </span>The method of specifying the option was
5813 chosen for easy integration with the Windows Installer user interface.<span
5814 style='mso-spacerun:yes'> </span>Although other methods can be used to specify
5815 options to AFSCREDS.EXE, it is advised that they be avoided as transforms
5816 including such options may not apply to future releases of OpenAFS.</p>
5818 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
5819 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5820 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
5821 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
5822 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5823 <h6 style='mso-outline-level:6;mso-yfti-cnfc:1'><a name="_Toc115416185">CREDSSTARTUP</a></h6>
5824 <p class=MsoList style='mso-yfti-cnfc:1'>Valid values<span
5825 style='mso-spacerun:yes'> </span>: '1' or '0'</p>
5826 <p class=MsoList style='mso-yfti-cnfc:1'>Controls whether AFSCreds.exe starts
5827 up automatically when the user logs on.<span style='mso-spacerun:yes'>
5828 </span>When CREDSSTARTUP is '1' a shortcut is added to the 'Startup' folder
5829 in the 'Program menu' which starts AFSCREDS.EXE with the options that are
5830 determined by the other CREDS* properties.</p>
5833 <tr style='mso-yfti-irow:0'>
5834 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5835 <h6 style='mso-outline-level:6'><a name="_Toc115416186">CREDSAUTOINIT</a></h6>
5836 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>: '-a'
5838 <p class=MsoList>Enables automatic initialization.</p>
5841 <tr style='mso-yfti-irow:1'>
5842 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5843 <h6 style='mso-outline-level:6'><a name="_Toc115416187">CREDSIPCHDET</a></h6>
5844 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>: '-n'
5846 <p class=MsoList>Enables IP address change detection.</p>
5849 <tr style='mso-yfti-irow:2'>
5850 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5851 <h6 style='mso-outline-level:6'><a name="_Toc115416188">CREDSQUIET</a></h6>
5852 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>: '-q'
5854 <p class=MsoList>Enables quiet mode.</p>
5857 <tr style='mso-yfti-irow:3'>
5858 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5859 <h6 style='mso-outline-level:6'><a name="_Toc115416189">CREDSRENEWDRMAP</a></h6>
5860 <p class=MsoList>Valid values<span style='mso-tab-count:1'> </span>: '-m'
5862 <p class=MsoList>Enables renewing drive map at startup.</p>
5865 <tr style='mso-yfti-irow:4;mso-yfti-lastrow:yes'>
5866 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
5867 <h6 style='mso-outline-level:6'><a name="_Toc115416190">CREDSSHOW</a></h6>
5868 <p class=MsoList>Valid values<span style='mso-spacerun:yes'> </span>: '-s'
5870 <p class=MsoList>Enables displaying the credential manager window when
5871 AFSCREDS starts up.</p>
5876 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416191">7.2.2
5877 Existing Registry Entries</a></h3>
5879 <p class=MsoNormal>You can change existing registry values subject to the
5880 restrictions mentioned in the Windows Platform SDK.<span
5881 style='mso-spacerun:yes'> </span>Pay special attention to component key paths
5882 and try to only change the 'Value' column in the 'Registry' table.<span
5883 style='mso-spacerun:yes'> </span>If you want to add additional registry keys
5884 please refer to section 3 (Additional resources).</p>
5886 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416192">7.2.3
5887 Replacing Configuration Files</a></h3>
5889 <p class=MsoNormal>The OpenAFS configuration files (CellServDB) can be replaced
5890 by your own configuration files.<span style='mso-spacerun:yes'> </span>These
5891 files are contained in separate MSI components so that you can disable them
5894 <p class=MsoNormal>The recommended method for replacing these files is to first
5895 disable the components containing the configuration files that you want to
5896 replace, and then add new components for the replacement files.<span
5897 style='mso-spacerun:yes'> </span>This is outlined below (assuming you are
5898 using ORCA.EXE to author the transform).</p>
5900 <p class=MsoNormal>Note that transforms are not a good way to add a new file as
5901 an embedded stream.<span style='mso-spacerun:yes'> </span>The method outlined
5902 here places the file in the same directory as the MSI for deployment.</p>
5904 <p class=MsoNormal>The walkthrough below is to add a custom 'CellServDB' file.</p>
5906 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5907 margin-left:18.0pt;text-indent:-18.0pt;mso-list:l23 level1 lfo32;tab-stops:
5908 list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5909 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.<span
5910 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Disable
5911 the component that contains the configuration file that you want to replace.</p>
5913 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5914 margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;tab-stops:
5915 list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5916 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.1.<span
5917 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Locate
5918 and select the 'Component' table in the 'Tables' list.</p>
5920 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5921 margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;tab-stops:
5922 list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5923 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.2.<span
5924 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>In
5925 the Component table, locate the component you need to change ( Ctrl-F invokes
5926 the 'Find' dialog).<span style='mso-spacerun:yes'> </span>The component names
5927 are listed below in section <a
5928 href="#_2.3.1_Components_for_Configuration ">7.2.3.1</a>.<span
5929 style='mso-spacerun:yes'> </span>For this example, the component name is
5930 'elf_CellServDB'.</p>
5932 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5933 margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;tab-stops:
5934 list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5935 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.3.<span
5936 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Go
5937 to the 'Condition' column of the component.</p>
5939 <p class=MsoNormal style='margin-top:4.3pt;margin-right:0pt;margin-bottom:4.3pt;
5940 margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;tab-stops:
5941 list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:Thorndale;
5942 mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1.4.<span
5943 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Enter
5944 a condition that evaluates to false. I.e. 'DONOTINSTALL'. (Note that an
5945 undefined property always evaluates to false).</p>
5947 <p class=MsoNormal>Note that you can also use this step to disable other
5948 configuration files without providing replacements.</p>
5950 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l23 level1 lfo32;
5951 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
5952 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.<span
5953 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Add
5954 a new component containing the new configuration file.</p>
5956 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;
5957 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5958 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.1.<span
5959 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Select
5960 the 'Component' table in the 'Tables' list.</p>
5962 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;
5963 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5964 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.2.<span
5965 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Select
5966 'Tables'->'Add Row' (Ctrl-R).</p>
5968 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;
5969 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
5970 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2.3.<span
5971 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Enter
5974 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
5975 style='margin-left:39.35pt;border-collapse:collapse;border:none;mso-border-alt:
5976 solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
5977 mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
5978 <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;height:23.35pt'>
5979 <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
5980 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt;height:23.35pt'>
5981 <p class=PreformattedText>Component</p>
5983 <td width=475 valign=top style='width:356.55pt;border:solid windowtext 1.0pt;
5984 border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
5985 solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt;height:23.35pt'>
5986 <p class=PreformattedText>cmf_my_CellServDB</p>
5989 <tr style='mso-yfti-irow:1'>
5990 <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
5991 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
5992 padding:0pt 5.4pt 0pt 5.4pt'>
5993 <p class=PreformattedText>ComponentID</p>
5995 <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
5996 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
5997 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
5998 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
5999 <p class=PreformattedText>{7019836F-BB2C-4AF6-9463-0D6EC9035CF1}</p>
6002 <tr style='mso-yfti-irow:2'>
6003 <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
6004 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6005 padding:0pt 5.4pt 0pt 5.4pt'>
6006 <p class=PreformattedText>Directory_</p>
6008 <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
6009 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6010 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6011 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6012 <p class=PreformattedText>dirClient</p>
6015 <tr style='mso-yfti-irow:3'>
6016 <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
6017 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6018 padding:0pt 5.4pt 0pt 5.4pt'>
6019 <p class=PreformattedText>Attributes</p>
6021 <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
6022 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6023 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6024 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6025 <p class=PreformattedText>144</p>
6028 <tr style='mso-yfti-irow:4'>
6029 <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
6030 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6031 padding:0pt 5.4pt 0pt 5.4pt'>
6032 <p class=PreformattedText>Condition</p>
6034 <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
6035 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6036 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6037 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6038 <p class=PreformattedText><o:p> </o:p></p>
6041 <tr style='mso-yfti-irow:5;mso-yfti-lastrow:yes'>
6042 <td width=115 valign=top style='width:86.25pt;border:solid windowtext 1.0pt;
6043 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6044 padding:0pt 5.4pt 0pt 5.4pt'>
6045 <p class=PreformattedText>KeyPath</p>
6047 <td width=475 valign=top style='width:356.55pt;border-top:none;border-left:
6048 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6049 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6050 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6051 <p class=PreformattedText>fil_my_CellServDB</p>
6056 <p class=MsoNormal style='margin-left:35.45pt'>Note that the ComponentId is an
6057 uppercase GUID.<span style='mso-spacerun:yes'> </span>You can generate one
6058 using GUIDGEN.EXE or UUIDGEN.EXE, both of which are included in the Platform
6061 <p class=MsoNormal style='margin-left:35.45pt'>The Attributes value of 144 is a
6062 sum of msidbComponentAttributesPermanent (16) and
6063 msidbComponentAttributesNeverOverwrite (128).<span style='mso-spacerun:yes'>
6064 </span>This ensures that local modifications are not overwritten or lost during
6065 an installation or uninstallation.<span style='mso-spacerun:yes'> </span>These
6066 are the same settings used on the default configuration files.</p>
6068 <p class=MsoNormal><span style='mso-tab-count:1'> </span>'fil_my_CellServDB'
6069 is a key into the 'File' table which we will fill later.</p>
6071 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l23 level1 lfo32;
6072 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
6073 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3.<span
6074 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Add
6075 a new feature to hold the new component.</p>
6077 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;
6078 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
6079 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3.1.<span
6080 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Select
6081 the 'Feature' table.</p>
6083 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;
6084 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
6085 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3.2.<span
6086 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Add
6087 a new row (Ctrl-R or 'Tables'->'Add Row') with the following values:</p>
6089 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
6090 style='margin-left:40.1pt;border-collapse:collapse;border:none;mso-border-alt:
6091 solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6092 mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
6093 <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
6094 <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
6095 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6096 <p class=PreformattedText>Feature</p>
6098 <td width=462 valign=top style='width:346.2pt;border:solid windowtext 1.0pt;
6099 border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
6100 solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6101 <p class=PreformattedText>fea_my_CellServDB</p>
6104 <tr style='mso-yfti-irow:1'>
6105 <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
6106 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6107 padding:0pt 5.4pt 0pt 5.4pt'>
6108 <p class=PreformattedText>Feature_Parent</p>
6110 <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
6111 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6112 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6113 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6114 <p class=PreformattedText>feaClient</p>
6117 <tr style='mso-yfti-irow:2'>
6118 <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
6119 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6120 padding:0pt 5.4pt 0pt 5.4pt'>
6121 <p class=PreformattedText>Title</p>
6123 <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
6124 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6125 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6126 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6127 <p class=PreformattedText><o:p> </o:p></p>
6130 <tr style='mso-yfti-irow:3'>
6131 <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
6132 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6133 padding:0pt 5.4pt 0pt 5.4pt'>
6134 <p class=PreformattedText>Description</p>
6136 <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
6137 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6138 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6139 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6140 <p class=PreformattedText><o:p> </o:p></p>
6143 <tr style='mso-yfti-irow:4'>
6144 <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
6145 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6146 padding:0pt 5.4pt 0pt 5.4pt'>
6147 <p class=PreformattedText>Display</p>
6149 <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
6150 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6151 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6152 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6153 <p class=PreformattedText>0</p>
6156 <tr style='mso-yfti-irow:5'>
6157 <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
6158 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6159 padding:0pt 5.4pt 0pt 5.4pt'>
6160 <p class=PreformattedText>Level</p>
6162 <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
6163 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6164 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6165 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6166 <p class=PreformattedText>30</p>
6169 <tr style='mso-yfti-irow:6'>
6170 <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
6171 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6172 padding:0pt 5.4pt 0pt 5.4pt'>
6173 <p class=PreformattedText>Directory_</p>
6175 <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
6176 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6177 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6178 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6179 <p class=PreformattedText><o:p> </o:p></p>
6182 <tr style='mso-yfti-irow:7;mso-yfti-lastrow:yes'>
6183 <td width=126 valign=top style='width:94.8pt;border:solid windowtext 1.0pt;
6184 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6185 padding:0pt 5.4pt 0pt 5.4pt'>
6186 <p class=PreformattedText>Attributes</p>
6188 <td width=462 valign=top style='width:346.2pt;border-top:none;border-left:
6189 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6190 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6191 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6192 <p class=PreformattedText>8</p>
6197 <p class=MsoNormal style='margin-left:35.45pt'>It is important to create the
6198 new feature under the 'feaClient' feature, which will ensure that the configuration
6199 file will be installed when the client binaries are installed.</p>
6201 <p class=MsoNormal style='margin-left:35.45pt'>Setting 'Display' to 0 will hide
6202 this feature from the feature selection dialog during an interactive installation.<span
6203 style='mso-spacerun:yes'> </span>A value of 30 for 'Level' allows this feature
6204 to be installed by default (on a 'Typical' installation).</p>
6206 <p class=MsoNormal style='margin-left:35.45pt'>The 'Attributes' value is msidbFeatureAttributesDisallowAdvertise
6207 (8), which is set on all features in the OpenAFS MSI.<span
6208 style='mso-spacerun:yes'> </span>The OpenAFS MSI is not designed for an
6209 advertised installation.</p>
6211 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l23 level1 lfo32;
6212 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
6213 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>4.<span
6214 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Join
6215 the component and the feature.</p>
6217 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;
6218 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
6219 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>4.1.<span
6220 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Select
6221 the 'FeatureComponents' table.</p>
6223 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;
6224 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
6225 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>4.2.<span
6226 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Add
6227 a new row with the following values:</p>
6229 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
6230 style='margin-left:40.1pt;border-collapse:collapse;border:none;mso-border-alt:
6231 solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6232 mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
6233 <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
6234 <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
6235 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6236 <p class=PreformattedText>Feature</p>
6238 <td width=462 valign=top style='width:346.5pt;border:solid windowtext 1.0pt;
6239 border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
6240 solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6241 <p class=PreformattedText>fea_my_CellServDB</p>
6244 <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
6245 <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
6246 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6247 padding:0pt 5.4pt 0pt 5.4pt'>
6248 <p class=PreformattedText>Component</p>
6250 <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
6251 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6252 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6253 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6254 <p class=PreformattedText>cmf_my_CellServDB</p>
6259 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l23 level1 lfo32;
6260 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
6261 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>5.<span
6262 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Add
6263 an entry to the 'File' table.</p>
6265 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;
6266 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
6267 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>5.1.<span
6268 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Select
6269 the 'File' table.</p>
6271 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;
6272 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
6273 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>5.2.<span
6274 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Add
6275 a new row with the following values:</p>
6277 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
6278 style='margin-left:40.1pt;border-collapse:collapse;border:none;mso-border-alt:
6279 solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6280 mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
6281 <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
6282 <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
6283 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6284 <p class=PreformattedText>File</p>
6286 <td width=462 valign=top style='width:346.5pt;border:solid windowtext 1.0pt;
6287 border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
6288 solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6289 <p class=PreformattedText>fil_my_CellServDB</p>
6292 <tr style='mso-yfti-irow:1'>
6293 <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
6294 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6295 padding:0pt 5.4pt 0pt 5.4pt'>
6296 <p class=PreformattedText>Component_</p>
6298 <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
6299 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6300 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6301 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6302 <p class=PreformattedText>cmf_my_CellServDB</p>
6305 <tr style='mso-yfti-irow:2'>
6306 <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
6307 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6308 padding:0pt 5.4pt 0pt 5.4pt'>
6309 <p class=PreformattedText>FileName</p>
6311 <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
6312 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6313 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6314 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6315 <p class=PreformattedText>CellServDB</p>
6318 <tr style='mso-yfti-irow:3'>
6319 <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
6320 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6321 padding:0pt 5.4pt 0pt 5.4pt'>
6322 <p class=PreformattedText>FileSize</p>
6324 <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
6325 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6326 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6327 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6328 <p class=PreformattedText>(enter file size here)</p>
6331 <tr style='mso-yfti-irow:4'>
6332 <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
6333 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6334 padding:0pt 5.4pt 0pt 5.4pt'>
6335 <p class=PreformattedText>Attributes</p>
6337 <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
6338 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6339 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6340 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6341 <p class=PreformattedText>8192</p>
6344 <tr style='mso-yfti-irow:5;mso-yfti-lastrow:yes'>
6345 <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
6346 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6347 padding:0pt 5.4pt 0pt 5.4pt'>
6348 <p class=PreformattedText>Sequence</p>
6350 <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
6351 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6352 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6353 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6354 <p class=PreformattedText>1000</p>
6359 <p class=MsoNormal><span style='mso-tab-count:1'> </span><span
6360 style='mso-spacerun:yes'> </span>(leave other fields blank)</p>
6362 <p class=MsoNormal style='margin-left:35.45pt'>The 'Attributes' value is
6363 msidbFileAttributesNonCompressed (8192).<span style='mso-spacerun:yes'>
6364 </span>This is because we will be placing this file in the same directory as
6365 the MSI instead of embedding the file in it.<span style='mso-spacerun:yes'>
6366 </span>Transforms do not support updating compressed sources or adding new
6367 cabinet streams.</p>
6369 <p class=MsoNormal style='margin-left:35.45pt'>Finally, the 'Sequence' value of
6370 1000 will be used later to distinguish the file as being in a separate source location
6371 than the other files in the MSI.</p>
6373 <p class=MsoNormal style='margin-left:18.0pt;text-indent:-18.0pt;mso-list:l23 level1 lfo32;
6374 tab-stops:list 18.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
6375 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>6.<span
6376 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Set
6377 a media source for the file.</p>
6379 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;
6380 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
6381 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>6.1.<span
6382 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Select
6383 the 'Media' table.</p>
6385 <p class=MsoNormal style='margin-left:39.6pt;text-indent:-21.6pt;mso-list:l23 level2 lfo32;
6386 tab-stops:list 39.6pt'><![if !supportLists]><span style='mso-fareast-font-family:
6387 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>6.2.<span
6388 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>Add
6389 a row with the following values :</p>
6391 <table class=MsoTableGrid border=1 cellspacing=0 cellpadding=0
6392 style='margin-left:40.1pt;border-collapse:collapse;border:none;mso-border-alt:
6393 solid windowtext .5pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6394 mso-border-insideh:.5pt solid windowtext;mso-border-insidev:.5pt solid windowtext'>
6395 <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes'>
6396 <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
6397 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6398 <p class=PreformattedText>DiskId</p>
6400 <td width=462 valign=top style='width:346.5pt;border:solid windowtext 1.0pt;
6401 border-left:none;mso-border-left-alt:solid windowtext .5pt;mso-border-alt:
6402 solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6403 <p class=PreformattedText>2</p>
6406 <tr style='mso-yfti-irow:1;mso-yfti-lastrow:yes'>
6407 <td width=126 valign=top style='width:94.5pt;border:solid windowtext 1.0pt;
6408 border-top:none;mso-border-top-alt:solid windowtext .5pt;mso-border-alt:solid windowtext .5pt;
6409 padding:0pt 5.4pt 0pt 5.4pt'>
6410 <p class=PreformattedText>LastSequence</p>
6412 <td width=462 valign=top style='width:346.5pt;border-top:none;border-left:
6413 none;border-bottom:solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;
6414 mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;
6415 mso-border-alt:solid windowtext .5pt;padding:0pt 5.4pt 0pt 5.4pt'>
6416 <p class=PreformattedText>1000</p>
6421 <p class=MsoNormal><span style='mso-tab-count:1'> </span><span
6422 style='mso-spacerun:yes'> </span>(leave other fields blank)</p>
6424 <p class=MsoNormal style='margin-left:35.45pt'>The sequence number of 1000
6425 designates this as the media source for the newly added file.</p>
6427 <h4><a name="_Toc115416193"></a><a name="_2.3.1_Components_for_Configuration "></a><span
6428 style='mso-bookmark:_Toc115416193'>7.2.3.1 Components for Configuration Files</span></h4>
6430 <p class=PreformattedText style='text-indent:35.45pt'>CellServDB:
6431 'cpf_CellServDB' (ID {D5BA4C15-DBEC-4292-91FC-B54C30F24F2A})</p>
6433 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416194">7.2.4
6434 Adding Domain Specific Registry Keys</a></h3>
6436 <p class=MsoNormal>Following is an example for adding domain specific registry
6439 <p class=MsoNormal style='tab-stops:204.0pt'><span style='mso-spacerun:yes'>
6441 href="#_Appendix_A:_Registry_Values">Appendix
6442 A</a> section 2.1 for more information.</p>
6444 <p class=MsoNormal><span style='mso-spacerun:yes'> </span>Columns that are
6445 unspecified should be left empty.</p>
6447 <p class=MsoNormal><span style='mso-spacerun:yes'> </span>We create a new
6448 feature and component to hold the new registry keys.</p>
6450 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6451 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6452 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6453 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
6454 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6455 <p class=MsoNormal style='mso-yfti-cnfc:1'><span style='mso-spacerun:yes'>
6456 </span>'Feature' table:</p>
6459 <tr style='mso-yfti-irow:0'>
6460 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6461 <p class=MsoNormal><span style='mso-spacerun:yes'> </span><span
6462 style='mso-tab-count:1'> </span>(new row)<br>
6463 <span style='mso-tab-count:1'> </span>Feature<span
6464 style='mso-tab-count:1'> </span>: 'feaDomainKeys'<br>
6465 <span style='mso-tab-count:1'> </span>Feature Parent<span
6466 style='mso-tab-count:1'> </span>: 'feaClient'<br>
6467 <span style='mso-tab-count:1'> </span>Display<span
6468 style='mso-tab-count:1'> </span>: 0<br>
6469 <span style='mso-tab-count:1'> </span>Level<span style='mso-tab-count:
6471 <span style='mso-tab-count:1'> </span>Attributes<span
6472 style='mso-tab-count:1'> </span>: 10</p>
6475 <tr style='mso-yfti-irow:1'>
6476 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6477 <p class=MsoNormal><span style='mso-spacerun:yes'> </span>'Component'
6481 <tr style='mso-yfti-irow:2'>
6482 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6483 <p class=MsoNormal><span style='mso-spacerun:yes'> </span><span
6484 style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'> </span>(new
6486 <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'> </span>Component<span
6487 style='mso-tab-count:1'> </span>: 'rcm_DomainKeys'<br>
6488 <span style='mso-tab-count:1'> </span>ComponentId<span
6489 style='mso-tab-count:1'> </span>: '{4E3FCBF4-8BE7-40B2-A108-C47CF743C627}'<br>
6490 <span style='mso-tab-count:1'> </span>Directory<span
6491 style='mso-tab-count:1'> </span>: 'TARGETDIR'<br>
6492 <span style='mso-tab-count:1'> </span>Attributes<span
6493 style='mso-tab-count:1'> </span>: 4<br>
6494 <span style='mso-tab-count:1'> </span>KeyPath<span
6495 style='mso-tab-count:1'> </span>: 'reg_domkey0'</p>
6498 <tr style='mso-yfti-irow:3'>
6499 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6500 <p class=MsoNormal><span style='mso-spacerun:yes'>
6501 </span>'FeatureComponents' table:</p>
6504 <tr style='mso-yfti-irow:4'>
6505 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6506 <p class=MsoNormal><span style='mso-spacerun:yes'> </span><span
6507 style='mso-tab-count:1'> </span>(new row)<br>
6508 <span style='mso-tab-count:1'> </span>Feature<span
6509 style='mso-tab-count:1'> </span>: 'feaDomainKeys'<br>
6510 <span style='mso-tab-count:1'> </span>Component<span
6511 style='mso-tab-count:1'> </span>: 'rcm_DomainKeys'</p>
6514 <tr style='mso-yfti-irow:5'>
6515 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6516 <p class=MsoNormal><span style='mso-spacerun:yes'> </span>'Registry'
6520 <tr style='mso-yfti-irow:6'>
6521 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6522 <p class=MsoNormal><span style='mso-tab-count:1'> </span>(new row)<br>
6523 <span style='mso-tab-count:1'> </span>Registry<span
6524 style='mso-tab-count:1'> </span>: 'reg_domkey0'<br>
6525 <span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
6527 <span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
6529 'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain'<br>
6530 <span style='mso-tab-count:1'> </span>Component<span
6531 style='mso-tab-count:1'> </span>: 'rcm_DomainKeys'</p>
6534 <tr style='mso-yfti-irow:7'>
6535 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6536 <p class=MsoNormal><span style='mso-tab-count:1'> </span>(new row)<br>
6537 <span style='mso-tab-count:1'> </span>Registry<span
6538 style='mso-tab-count:1'> </span>: 'reg_domkey1'<br>
6539 <span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
6541 <span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
6543 'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain'<br>
6544 <span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
6545 2'> </span>: '*'<br>
6546 <span style='mso-tab-count:1'> </span>Component<span
6547 style='mso-tab-count:1'> </span>: 'rcm_DomainKeys'</p>
6550 <tr style='mso-yfti-irow:8'>
6551 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6552 <p class=MsoNormal><span style='mso-tab-count:1'> </span>(new row)<br>
6553 <span style='mso-tab-count:1'> </span>Registry<span
6554 style='mso-tab-count:1'> </span>: 'reg_domkey2'<br>
6555 <span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
6557 <span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
6559 'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\ATHENA.MIT.EDU'<br>
6560 <span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
6561 2'> </span>: '*'<br>
6562 <span style='mso-tab-count:1'> </span>Component<span
6563 style='mso-tab-count:1'> </span>: 'rcm_DomainKeys'</p>
6566 <tr style='mso-yfti-irow:9'>
6567 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6568 <p class=MsoNormal><span style='mso-tab-count:1'> </span>(new row)<br>
6569 <span style='mso-tab-count:1'> </span>Registry<span
6570 style='mso-tab-count:1'> </span>: 'reg_domkey3'<br>
6571 <span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
6573 <span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
6575 'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\ATHENA.MIT.EDU'<br>
6576 <span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
6577 2'> </span>: 'LogonOptions'<br>
6578 <span style='mso-tab-count:1'> </span>Value<span style='mso-tab-count:
6580 <span style='mso-tab-count:1'> </span>Component<span
6581 style='mso-tab-count:1'> </span>: 'rcm_DomainKeys'</p>
6584 <tr style='mso-yfti-irow:10'>
6585 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6586 <p class=MsoNormal><span style='mso-tab-count:1'> </span>(new row)<br>
6587 <span style='mso-tab-count:1'> </span>Registry<span
6588 style='mso-tab-count:1'> </span>: 'reg_domkey4'<br>
6589 <span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
6591 <span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
6592 2'> </span>: SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST'<br>
6593 <span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
6594 2'> </span>: '*'<br>
6595 <span style='mso-tab-count:1'> </span>Component<span
6596 style='mso-tab-count:1'> </span>: 'rcm_DomainKeys'</p>
6599 <tr style='mso-yfti-irow:11'>
6600 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6601 <p class=MsoNormal><span style='mso-tab-count:1'> </span>(new row)<br>
6602 <span style='mso-tab-count:1'> </span>Registry<span
6603 style='mso-tab-count:1'> </span>: 'reg_domkey5'<br>
6604 <span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
6606 <span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
6608 'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST'<br>
6609 <span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
6610 2'> </span>: 'LogonOptions'<br>
6611 <span style='mso-tab-count:1'> </span>Value<span style='mso-tab-count:
6613 <span style='mso-tab-count:1'> </span>Component<span
6614 style='mso-tab-count:1'> </span>: 'rcm_DomainKeys'</p>
6617 <tr style='mso-yfti-irow:12;mso-yfti-lastrow:yes'>
6618 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6619 <p class=MsoNormal><span style='mso-tab-count:1'> </span>(new row)<br>
6620 <span style='mso-tab-count:1'> </span>Registry<span
6621 style='mso-tab-count:1'> </span>: 'reg_domkey6'<br>
6622 <span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
6624 <span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
6625 2'> </span>: 'SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST'<br>
6626 <span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
6627 2'> </span>: 'FailLoginsSilently'<br>
6628 <span style='mso-tab-count:1'> </span>Value<span style='mso-tab-count:
6630 <span style='mso-tab-count:1'> </span>Component<span
6631 style='mso-tab-count:1'> </span>: 'rcm_DomainKeys'<br style='mso-special-character:
6633 <![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'>
6639 <p class=MsoNormal><o:p> </o:p></p>
6641 <p class=MsoNormal>The example adds domain specific keys for 'ATHENA.MIT.EDU'
6642 (enable integrated logon) and 'LOCALHOST' (disable integrated logon and fail
6643 logins silently).</p>
6645 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416195">7.2.5
6646 Adding Site Specific Freelance Registry Keys</a></h3>
6648 <p class=MsoNormal>Following is an example for adding site specific Freelance
6649 registry keys to pre-populate the Mountpoints and Symlinks in the fake root.afs
6652 <p class=MsoNormal><span style='mso-spacerun:yes'> </span>Columns that are
6653 unspecified should be left empty.</p>
6655 <p class=MsoNormal><span style='mso-spacerun:yes'> </span>We create a new
6656 feature and component to hold the new registry keys.</p>
6658 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6659 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6660 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6661 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
6662 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6663 <p class=MsoNormal style='mso-yfti-cnfc:1'><span style='mso-spacerun:yes'>
6664 </span>'Feature' table:</p>
6667 <tr style='mso-yfti-irow:0'>
6668 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6669 <p class=MsoNormal><span style='mso-spacerun:yes'> </span><span
6670 style='mso-tab-count:1'> </span>(new row)<br>
6671 <span style='mso-tab-count:1'> </span>Feature<span
6672 style='mso-tab-count:1'> </span>: 'feaFreelanceKeys'<br>
6673 <span style='mso-tab-count:1'> </span>Feature Parent<span
6674 style='mso-tab-count:1'> </span>: 'feaClient'<br>
6675 <span style='mso-tab-count:1'> </span>Display<span
6676 style='mso-tab-count:1'> </span>: 0<br>
6677 <span style='mso-tab-count:1'> </span>Level<span style='mso-tab-count:
6679 <span style='mso-tab-count:1'> </span>Attributes<span
6680 style='mso-tab-count:1'> </span>: 10</p>
6683 <tr style='mso-yfti-irow:1'>
6684 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6685 <p class=MsoNormal><span style='mso-spacerun:yes'> </span>'Component'
6689 <tr style='mso-yfti-irow:2'>
6690 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6691 <p class=MsoNormal><span style='mso-spacerun:yes'> </span><span
6692 style='mso-tab-count:1'> </span>(new row)<br>
6693 <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'> </span>Component<span
6694 style='mso-tab-count:1'> </span>: 'rcm_FreelanceKeys'<br>
6695 <span style='mso-tab-count:1'> </span>ComponentId<span
6696 style='mso-tab-count:1'> </span>: '{4E3B3CBF4-9AE7-40C3-7B09-C48CF842C583}'<br>
6697 <span style='mso-tab-count:1'> </span>Directory<span
6698 style='mso-tab-count:1'> </span>: 'TARGETDIR'<br>
6699 <span style='mso-tab-count:1'> </span>Attributes<span
6700 style='mso-tab-count:1'> </span>: 4<br>
6701 <span style='mso-tab-count:1'> </span>KeyPath<span
6702 style='mso-tab-count:1'> </span>: 'reg_freekey0'</p>
6705 <tr style='mso-yfti-irow:3'>
6706 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6707 <p class=MsoNormal><span style='mso-spacerun:yes'>
6708 </span>'FeatureComponents' table:</p>
6711 <tr style='mso-yfti-irow:4'>
6712 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6713 <p class=MsoNormal><span style='mso-spacerun:yes'> </span><span
6714 style='mso-tab-count:1'> </span>(new row)<br>
6715 <span style='mso-tab-count:1'> </span>Feature<span
6716 style='mso-tab-count:1'> </span>: 'feaFreelanceKeys'<br>
6717 <span style='mso-tab-count:1'> </span>Component<span
6718 style='mso-tab-count:1'> </span>: 'rcm_FreelanceKeys'</p>
6721 <tr style='mso-yfti-irow:5'>
6722 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6723 <p class=MsoNormal><span style='mso-spacerun:yes'> </span>'Registry'
6727 <tr style='mso-yfti-irow:6'>
6728 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6729 <p class=MsoNormal><span style='mso-tab-count:1'> </span>(new row)<br>
6730 <span style='mso-tab-count:1'> </span>Registry<span
6731 style='mso-tab-count:1'> </span>: 'reg_freekey0'<br>
6732 <span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
6734 <span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
6735 2'> </span>: 'SOFTWARE\OpenAFS\Client\Freelance'<br>
6736 <span style='mso-tab-count:1'> </span>Component<span
6737 style='mso-tab-count:1'> </span>: 'rcm_FreelanceKeys'</p>
6740 <tr style='mso-yfti-irow:7'>
6741 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6742 <p class=MsoNormal><span style='mso-tab-count:1'> </span>(new row)<br>
6743 <span style='mso-tab-count:1'> </span>Registry<span
6744 style='mso-tab-count:1'> </span>: 'reg_freekey1'<br>
6745 <span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
6747 <span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
6748 2'> </span>: 'SOFTWARE\OpenAFS\Client\Freelance'<br>
6749 <span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
6750 2'> </span>: '0'<br>
6751 <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'> </span>Value<span
6752 style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'> </span>:
6753 'athena.mit.edu#athena.mit.edu:root.cell.'<br>
6754 <span style='mso-tab-count:1'> </span>Component<span
6755 style='mso-tab-count:1'> </span>: 'rcm_FreelanceKeys'</p>
6758 <tr style='mso-yfti-irow:8'>
6759 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6760 <p class=MsoNormal><span style='mso-tab-count:1'> </span>(new row)<br>
6761 <span style='mso-tab-count:1'> </span>Registry<span
6762 style='mso-tab-count:1'> </span>: 'reg_freekey2'<br>
6763 <span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
6765 <span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
6766 2'> </span>: 'SOFTWARE\OpenAFS\Client\Freelance'<br>
6767 <span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
6768 2'> </span>: '1'<br>
6769 <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'> </span>Value<span
6770 style='mso-spacerun:yes'> </span><span
6771 style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'> </span>:
6772 '.athena.mit.edu%athena.mit.edu:root.cell.'<br>
6773 <span style='mso-tab-count:1'> </span>Component<span
6774 style='mso-tab-count:1'> </span>: 'rcm_FreelanceKeys'</p>
6777 <tr style='mso-yfti-irow:9'>
6778 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6779 <p class=MsoNormal><span style='mso-tab-count:1'> </span>(new row)<br>
6780 <span style='mso-tab-count:1'> </span>Registry<span
6781 style='mso-tab-count:1'> </span>: 'reg_freekey3'<br>
6782 <span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
6784 <span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
6785 2'> </span>: 'SOFTWARE\OpenAFS\Client\Freelance\Symlinks'<br>
6786 <span style='mso-tab-count:1'> </span>Component<span
6787 style='mso-tab-count:1'> </span>: 'rcm_FreelanceKeys'</p>
6790 <tr style='mso-yfti-irow:10'>
6791 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6792 <p class=MsoNormal><span style='mso-tab-count:1'> </span>(new row)<br>
6793 <span style='mso-tab-count:1'> </span>Registry<span
6794 style='mso-tab-count:1'> </span>: 'reg_freekey4'<br>
6795 <span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
6797 <span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
6798 2'> </span>: 'SOFTWARE\OpenAFS\Client\Freelance\Symlinks'<br>
6799 <span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
6800 2'> </span>: '0'<br>
6801 <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'> </span>Value<span
6802 style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'> </span>:
6803 '<st1:GivenName w:st="on">athena</st1:GivenName>:athena.mit.edu.'<br>
6804 <span style='mso-tab-count:1'> </span>Component<span
6805 style='mso-tab-count:1'> </span>: 'rcm_FreelanceKeys'</p>
6808 <tr style='mso-yfti-irow:11;mso-yfti-lastrow:yes'>
6809 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
6810 <p class=MsoNormal><span style='mso-tab-count:1'> </span>(new row)<br>
6811 <span style='mso-tab-count:1'> </span>Registry<span
6812 style='mso-tab-count:1'> </span>: 'reg_freekey5'<br>
6813 <span style='mso-tab-count:1'> </span>Root<span style='mso-tab-count:
6815 <span style='mso-tab-count:1'> </span>Key<span style='mso-tab-count:
6816 2'> </span>: 'SOFTWARE\OpenAFS\Client\Freelance\Symlinks'<br>
6817 <span style='mso-tab-count:1'> </span>Name<span style='mso-tab-count:
6818 2'> </span>: '1'<br>
6819 <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'> </span>Value<span
6820 style='mso-spacerun:yes'> </span><span style='mso-tab-count:1'> </span>:
6821 '.athena:.athena.mit.edu.'<br>
6822 <span style='mso-tab-count:1'> </span>Component<span
6823 style='mso-tab-count:1'> </span>: 'rcm_FreelanceKeys'</p>
6828 <p class=MsoNormal>The example adds a read-only mountpoint to the
6829 athena.mit.edu cell's root.afs volume as well as a read-write mountpoint.<span
6830 style='mso-spacerun:yes'> </span>Aliases are also provided using symlinks.</p>
6832 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417101"></a><a
6833 name="_Toc115416196"></a><a name="_Ref115275867"><span style='mso-bookmark:
6834 _Toc115416196'><span style='mso-bookmark:_Toc115417101'>7.3 Additional
6835 Resources</span></span></a></h2>
6837 <p class=MsoNormal>If you want to add registry keys or files you need to create
6838 new components and features for those.<span style='mso-spacerun:yes'>
6839 </span>Refer to the Windows Platform SDK for details.</p>
6841 <p class=MsoNormal>It is beyond the scope of this document to provide a
6842 comprehensive overview of how to add new resources through a transform.<span
6843 style='mso-spacerun:yes'> </span>Please refer to the "Windows
6844 Installer" documentation for details.<span style='mso-spacerun:yes'>
6845 </span>The relevant section is at :</p>
6847 <p class=MsoNormal>http://msdn.microsoft.com/library/en-us/msi/setup/using_transforms_to_add_resources.asp</p>
6849 <p class=MsoNormal>A sample walkthrough of adding a new configuration file is
6852 <p class=MsoNormal>Add new features under the 'feaClient' or 'feaServer' as appropriate
6853 and set the 'Level' column for those features to equal the 'Level' for their
6854 parent features for consistency.<span style='mso-spacerun:yes'> </span>Note
6855 that none of the features in the OpenAFS for Windows MSI package are designed
6856 to be installed to run from 'source' or 'advertised'.<span
6857 style='mso-spacerun:yes'> </span>It is recommended that you set
6858 'msidbFeatureAttributesFavorLocal' (0), 'msidbFeatureAttributesFollowParent'
6859 (2) and 'msidbFeatureAttributesDisallowAdvertise' (8) attributes for new features.</p>
6861 <p class=MsoNormal>If you are creating new components, retain the same
6862 component GUID when creating new transforms against new releases of the OpenAFS
6865 <p class=MsoNormal>After making the adjustments to the MSI database using ORCA.EXE
6866 you can generate a transform with MSITRAN.EXE as follows :</p>
6868 <p class=MsoNormal>(Modified MSI package is 'openafs-en_US_new.msi' and the
6869 original MSI package is 'openafs-en_US.msi'.<span style='mso-spacerun:yes'>
6870 </span>Generates transform 'openafs-transform.mst')</p>
6872 <p class=MsoNormal><span style='mso-spacerun:yes'> </span>> msitran.exe
6873 -g openafs-en_US.msi openafs-en_US_new.msi openafs-transform.mst</p>
6875 <p class=MsoNormal>See the Platform SDK documentation for information on
6876 command line options for MSITRAN.EXE.</p>
6878 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417102"></a><a
6879 name="_Toc115416197"><span style='mso-bookmark:_Toc115417102'>7.4. Upgrades</span></a></h2>
6881 <p class=MsoNormal>The MSI package is designed to uninstall previous versions
6882 of OpenAFS for Windows during installation.<span style='mso-spacerun:yes'>
6883 </span>Note that it doesn't directly upgrade an existing installation.<span
6884 style='mso-spacerun:yes'> </span>This is intentional and ensures that
6885 development releases which do not have strictly increasing version numbers are
6886 properly upgraded.</p>
6888 <p class=MsoNormal>Versions of OpenAFS that are upgraded by the MSI package are:</p>
6890 <p class=MsoNormal style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:l22 level1 lfo31;
6891 tab-stops:list 36.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
6892 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>1)<span
6893 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>OpenAFS
6895 Upgrade code {6823EEDD-84FC-4204-ABB3-A80D25779833}<br>
6896 Up to current release</p>
6898 <p class=MsoNormal style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:l22 level1 lfo31;
6899 tab-stops:list 36.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
6900 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>2)<span
6901 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>MIT's
6902 Transarc AFS MSI package<br>
6903 Upgrade code {5332B94F-DE38-4927-9EAB-51F4A64193A7}<br>
6904 Up to version 3.6.2</p>
6906 <p class=MsoNormal style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:l22 level1 lfo31;
6907 tab-stops:list 36.0pt'><![if !supportLists]><span style='mso-fareast-font-family:
6908 Thorndale;mso-bidi-font-family:Thorndale'><span style='mso-list:Ignore'>3)<span
6909 style='font:7.0pt "Times New Roman"'> </span></span></span><![endif]>OpenAFS
6913 <p class=MsoNormal>Note that versions of the OpenAFS NSIS package prior to
6914 1.3.65 had a bug where it couldn't be uninstalled properly in unattended
6915 mode.<span style='mso-spacerun:yes'> </span>Therefore the MSI package will not
6916 try to uninstall an OpenAFS NSIS package if running unattended.<span
6917 style='mso-spacerun:yes'> </span>This means that group policy based deployments
6918 will fail on machines that have the OpenAFS NSIS package installed.</p>
6920 <p class=MsoNormal>If you have used a different MSI package to install OpenAFS
6921 and wish to upgrade it you can author rows into the 'Upgrade' table as described
6922 in the Platform SDK.</p>
6924 <p class=MsoNormal>When performing an upgrade with msiexec.exe execute the MSI
6925 with the repair options "vomus".</p>
6927 <h1 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417116"></a><a
6928 name="_Toc115417103"></a><a name="_Toc115416198"></a><a
6929 name="_Appendix_A:_Registry_Values"></a><![if !supportLists]><span
6930 style='mso-bookmark:_Toc115417116'><span style='mso-bookmark:_Toc115417103'><span
6931 style='mso-bookmark:_Toc115416198'></span></span></span><![endif]><span
6932 style='mso-bookmark:_Toc115417116'><span style='mso-bookmark:_Toc115417103'><span
6933 style='mso-bookmark:_Toc115416198'>Appendix A: Registry Values</span></span></span></h1>
6935 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417104"></a><a
6936 name="_Toc115416199"><span style='mso-bookmark:_Toc115417104'>A.1. Service
6937 parameters</span></a></h2>
6939 <p class=MsoBodyText>The service parameters primarily affect the behavior of
6940 the AFS client service (afsd_service.exe).</p>
6942 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416200">Regkey:<br>
6943 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</a></h3>
6945 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
6946 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
6947 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
6948 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:145.25pt'>
6949 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6951 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416201">Value:
6953 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD<br>
6955 Variable: LANadapter</p>
6956 <p class=MsoBodyText style='mso-yfti-cnfc:1'>LAN adapter number to use.<span
6957 style='mso-spacerun:yes'> </span>This is the lana number of the LAN adapter
6958 that the SMB server should bind to.<span style='mso-spacerun:yes'> </span>If
6959 unspecified or set to -1, a LAN adapter with named 'AFS' or a loopback
6960 adapter will be selected.<span style='mso-spacerun:yes'> </span>If neither
6961 are present, then all available adapters will be bound to.<span
6962 style='mso-spacerun:yes'> </span>When binding to a non-loopback adapter, the
6963 NetBIOS name hostname%-AFS' will be used (where %hostname% is the NetBIOS
6964 name of the host truncated to 11 characters). Otherwise, the NetBIOS name
6968 <tr style='mso-yfti-irow:0;height:79.25pt'>
6969 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6971 <h5 style='mso-outline-level:5'><a name="_Toc115416202"></a><a
6972 name="_Value___: CacheSize"></a><span style='mso-bookmark:_Toc115416202'>Value:
6973 CacheSize</span></h5>
6974 <p class=MsoBodyText>Type: DWORD<br>
6975 Default: 98304 (CM_CONFIGDEFAULT_CACHESIZE)<br>
6976 Variable: cm_initParams.cacheSize</p>
6977 <p class=MsoBodyText>Size of the AFS cache in 1k blocks.</p>
6980 <tr style='mso-yfti-irow:1;height:79.25pt'>
6981 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6983 <h5 style='mso-outline-level:5'><a name="_Toc115416203">Value: ChunkSize</a></h5>
6984 <p class=MsoBodyText>Type: DWORD<br>
6985 Default: 17 (CM_CONFIGDEFAULT_CHUNKSIZE)<br>
6986 Variable: cm_logChunkSize (cm_chunkSize = 1 << cm_logChunkSize)</p>
6987 <p class=MsoBodyText>Size of chunk for reading and writing. Actual chunk size
6988 is 2^cm_logChunkSize.</p>
6991 <tr style='mso-yfti-irow:2;height:92.0pt'>
6992 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
6994 <h5 style='mso-outline-level:5'><a name="_Toc115416204">Value: Daemons</a></h5>
6995 <p class=MsoBodyText>Type: DWORD<br>
6996 Default: 2 (CM_CONFIGDEFAULT_DAEMONS)<br>
6997 Variable: numBkgD</p>
6998 <p class=MsoBodyText>Number of background daemons (number of threads of
6999 cm_BkgDaemon). (see cm_BkgDaemon in cm_daemon.c)</p>
7002 <tr style='mso-yfti-irow:3;height:92.0pt'>
7003 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7005 <h5 style='mso-outline-level:5'><a name="_Toc115416205">Value: ServerThreads</a></h5>
7006 <p class=MsoBodyText>Type: DWORD<br>
7007 Default: 25 (CM_CONFIGDEFAULT_SVTHREADS)<br>
7008 Variable: numSvThreads</p>
7009 <p class=MsoBodyText>Number of SMB server threads (number of threads of
7010 smb_Server). (see smb_Server in smb.c).</p>
7013 <tr style='mso-yfti-irow:4;height:79.25pt'>
7014 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7016 <h5 style='mso-outline-level:5'><a name="_Toc115416206">Value: Stats</a></h5>
7017 <p class=MsoBodyText>Type: DWORD<br>
7018 Default: 10000 (CM_CONFIGDEFAULT_STATS)<br>
7019 Variable: cm_initParams.nStatCaches</p>
7020 <p class=MsoBodyText>Cache configuration.</p>
7023 <tr style='mso-yfti-irow:5;height:78.5pt'>
7024 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7026 <h5 style='mso-outline-level:5'><a name="_Toc115416207"></a><a
7027 name="_Value_:_LogoffPreserveTokens"></a><span style='mso-bookmark:_Toc115416207'>Value:
7028 LogoffPreserveTokens</span></h5>
7029 <p class=MsoBodyText>Type: DWORD {1,0}<br>
7031 <p class=MsoBodyText>If enabled (set to 1), the Logoff Event handler will not
7032 attempt to delete the user's tokens<span style='mso-spacerun:yes'> </span>if
7033 the user's profile is stored outside of AFS.</p>
7036 <tr style='mso-yfti-irow:6;height:79.25pt'>
7037 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7039 <h5 style='mso-outline-level:5'><a name="_Toc115416208">Value: RootVolume</a></h5>
7040 <p class=MsoBodyText>Type: REG_SZ<br>
7041 Default: "root.afs"<br>
7042 Variable: cm_rootVolumeName</p>
7043 <p class=MsoBodyText>Root volume name.</p>
7046 <tr style='mso-yfti-irow:7;height:145.25pt'>
7047 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7049 <h5 style='mso-outline-level:5'><a name="_Toc115416209"></a><a
7050 name="_Value_:_Mountroot"></a><span style='mso-bookmark:_Toc115416209'>Value:
7051 Mountroot</span></h5>
7052 <p class=MsoBodyText>Type: REG_SZ<br>
7053 Default: "/afs"<br>
7054 Variable: cm_mountRoot</p>
7055 <p class=MsoBodyText>Name of root mount point.<span
7056 style='mso-spacerun:yes'> </span>In symlinks, if a path starts with
7057 cm_mountRoot, it is assumed that the path is absolute (as opposed to
7058 relative) and is adjusted accordingly. Eg: if a path is specified as
7059 /afs/athena.mit.edu/foo/bar/baz and cm_mountRoot is "/afs", then
7060 the path is interpreted as \\afs\all\athena.mit.edu\foo\bar\baz.<span
7061 style='mso-spacerun:yes'> </span>If a path does not start with with
7062 cm_mountRoot, the path is assumed to be relative and suffixed to the reference
7063 directory (i.e. directory where the symlink exists)</p>
7066 <tr style='mso-yfti-irow:8;height:92.0pt'>
7067 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7069 <h5 style='mso-outline-level:5'><a name="_Toc115416210"></a><a
7070 name="_Value_:_CachePath"></a><span style='mso-bookmark:_Toc115416210'>Value:
7071 CachePath</span></h5>
7072 <p class=MsoBodyText>Type: REG_SZ or REG_EXPAND_SZ<br>
7073 Default: "%TEMP%\AFSCache"<br>
7074 Variable: cm_CachePath</p>
7075 <p class=MsoBodyText>Location of on-disk cache file.<span
7076 style='mso-spacerun:yes'> </span>The default is the SYSTEM account's TEMP
7077 directory.<span style='mso-spacerun:yes'> </span>The attributes assigned to
7078 the file are HIDDEN and SYSTEM.</p>
7081 <tr style='mso-yfti-irow:9;height:119.0pt'>
7082 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7084 <h5 style='mso-outline-level:5'><a name="_Toc115416211">Value:
7085 NonPersistentCaching</a></h5>
7086 <p class=MsoBodyText>Type: DWORD [0..1]<br>
7088 Variable: buf_CacheType</p>
7089 <p class=MsoBodyText>When this registry value is set to a non-zero value, the
7090 CachePath value is ignored and the cache data is stored in the windows paging
7091 file.<span style='mso-spacerun:yes'> </span>This prevents the use of
7092 persistent caching (when available) as well as the ability to alter the size
7093 of the cache at runtime using the "fs setcachesize" command.</p>
7096 <tr style='mso-yfti-irow:10;height:125.5pt'>
7097 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7099 <h5 style='mso-outline-level:5'><a name="_Toc115416212">Value: ValidateCache</a></h5>
7100 <p class=MsoBodyText>Type: DWORD [0..2]<br>
7102 Variable: buf_CacheType</p>
7103 <p class=MsoBodyText>This value determines if and when persistent cache validation
7105 <p class=MsoBodyText>0 - Validation is disabled<br>
7106 1 - Validation is performed at startup<br>
7107 2 - Validation is performed at shutdown</p>
7110 <tr style='mso-yfti-irow:11;height:79.25pt'>
7111 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7113 <h5 style='mso-outline-level:5'><a name="_Toc115416213">Value: TrapOnPanic</a></h5>
7114 <p class=MsoBodyText>Type: DWORD {1,0}<br>
7116 Variable: traceOnPanic</p>
7117 <p class=MsoBodyText>Issues a breakpoint in the event of a panic. (breakpoint:
7121 <tr style='mso-yfti-irow:12;height:92.0pt'>
7122 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7124 <h5 style='mso-outline-level:5'><a name="_Toc115416214"></a><a
7125 name="_Value___: NetbiosName"></a><span style='mso-bookmark:_Toc115416214'>Value:
7126 NetbiosName</span></h5>
7127 <p class=MsoBodyText>Type: REG_EXPAND_SZ<br>
7128 Default: "AFS"<br>
7129 Variable: cm_NetbiosName</p>
7130 <p class=MsoBodyText>Specifies the NetBIOS name to be used when binding to a
7131 Loopback adapter.<span style='mso-spacerun:yes'> </span>To provide the old
7132 behavior specify a value of<span style='mso-spacerun:yes'>
7133 </span>"%COMPUTERNAME%-AFS".</p>
7136 <tr style='mso-yfti-irow:13;height:152.0pt'>
7137 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7139 <h5 style='mso-outline-level:5'><a name="_Toc115416215">Value: IsGateway</a></h5>
7140 <p class=MsoBodyText>Type: DWORD {1,0}<br>
7142 Variable: isGateway</p>
7143 <p class=MsoBodyText>Select whether or not this AFS client should act as a
7144 gateway.<span style='mso-spacerun:yes'> </span>If set and the NetBIOS name
7145 hostname-AFS is bound to a physical NIC, other machines in the subnet can
7146 access AFS via SMB connections to hostname-AFS.</p>
7147 <p class=MsoBodyText>When IsGateway is non-zero, the LAN adapter detection
7148 code will avoid binding to a loopback adapter.<span
7149 style='mso-spacerun:yes'> </span>This will ensure that the NetBIOS name will
7150 be of the form hostname-AFS instead of the value set by the "NetbiosName"
7154 <tr style='mso-yfti-irow:14;height:92.0pt'>
7155 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7157 <h5 style='mso-outline-level:5'><a name="_Toc115416216">Value: ReportSessionStartups</a></h5>
7158 <p class=MsoBodyText>Type: DWORD {1,0}<br>
7160 Variable: reportSessionStartups</p>
7161 <p class=MsoBodyText>If enabled, all SMB sessions created are recorded in the
7162 Application event log.<span style='mso-spacerun:yes'> </span>This also
7163 enables other events such as drive mappings or various error types to be
7167 <tr style='mso-yfti-irow:15;height:79.25pt'>
7168 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7170 <h5 style='mso-outline-level:5'><a name="_Toc115416217"></a><a
7171 name="_Value_:_TraceBufferSize"></a><span style='mso-bookmark:_Toc115416217'>Value:
7172 TraceBufferSize</span></h5>
7173 <p class=MsoBodyText>Type: DWORD<br>
7174 Default: 5000 (CM_CONFIGDEFAULT_TRACEBUFSIZE)<br>
7175 Variable: traceBufSize</p>
7176 <p class=MsoBodyText>Number of entries to keep in trace log.</p>
7179 <tr style='mso-yfti-irow:16;height:92.0pt'>
7180 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7182 <h5 style='mso-outline-level:5'><a name="_Toc115416218"></a><a
7183 name="_Value_:_SysName"></a><span style='mso-bookmark:_Toc115416218'>Value:
7185 <p class=MsoBodyText>Type: REG_SZ<br>
7186 Default: "i386_nt40"<br>
7187 Variable: cm_sysName</p>
7188 <p class=MsoBodyText>Provides an initial value for "fs sysname".<span
7189 style='mso-spacerun:yes'> </span>The string can contain one or more
7190 replacement values for @sys in order of preference separated by whitespace.</p>
7193 <tr style='mso-yfti-irow:17;height:79.25pt'>
7194 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7196 <h5 style='mso-outline-level:5'><a name="_Toc115416219"></a><a
7197 name="_Value_:_SecurityLevel"></a><span style='mso-bookmark:_Toc115416219'>Value:
7198 SecurityLevel</span></h5>
7199 <p class=MsoBodyText>Type: DWORD {1,0}<br>
7201 Variable: cryptall</p>
7202 <p class=MsoBodyText>Enables encryption on RX calls.</p>
7205 <tr style='mso-yfti-irow:18;height:112.25pt'>
7206 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7208 <h5 style='mso-outline-level:5'><a name="_Toc115416220"></a><a
7209 name="_Value_:_UseDNS"></a><span style='mso-bookmark:_Toc115416220'>Value:
7211 <p class=MsoBodyText>Type: DWORD {1,0}<br>
7213 Variable: cm_dnsEnabled</p>
7214 <p class=MsoBodyText>Enables resolving volservers using AFSDB DNS queries.</p>
7215 <p class=MsoBodyText>As of 1.3.60, this value is ignored as the DNS query
7216 support utilizes the Win32 DNSQuery API which is available on Win2000 and
7220 <tr style='mso-yfti-irow:19;height:79.25pt'>
7221 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7223 <h5 style='mso-outline-level:5'><a name="_Toc115416221"></a><a
7224 name="_Value_:_FreelanceClient"></a><span style='mso-bookmark:_Toc115416221'>Value:
7225 FreelanceClient</span></h5>
7226 <p class=MsoBodyText>Type: DWORD {1,0}<br>
7228 Variable: cm_freelanceEnabled</p>
7229 <p class=MsoBodyText>Enables freelance client.</p>
7232 <tr style='mso-yfti-irow:20;height:92.0pt'>
7233 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7235 <h5 style='mso-outline-level:5'><a name="_Toc115416222"></a><a
7236 name="_Value_:_HideDotFiles"></a><span style='mso-bookmark:_Toc115416222'>Value:
7237 HideDotFiles</span></h5>
7238 <p class=MsoBodyText>Type: DWORD {1,0}<br>
7240 Variable: smb_hideDotFiles</p>
7241 <p class=MsoBodyText>Enables marking dotfiles with the hidden attribute.<span
7242 style='mso-spacerun:yes'> </span>Dot files are files whose name starts with
7243 a period (excluding "." and "..").</p>
7246 <tr style='mso-yfti-irow:21;height:79.25pt'>
7247 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7249 <h5 style='mso-outline-level:5'><a name="_Toc115416223">Value: MaxMpxRequests</a></h5>
7250 <p class=MsoBodyText>Type: DWORD<br>
7252 Variable: smb_maxMpxRequests</p>
7253 <p class=MsoBodyText>Maximum number of multiplexed SMB requests that can be
7257 <tr style='mso-yfti-irow:22;height:79.25pt'>
7258 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7260 <h5 style='mso-outline-level:5'><a name="_Toc115416224">Value: MaxVCPerServer</a></h5>
7261 <p class=MsoBodyText>Type: DWORD<br>
7263 Variable: smb_maxVCPerServer</p>
7264 <p class=MsoBodyText>Maximum number of SMB virtual circuits.</p>
7267 <tr style='mso-yfti-irow:23;height:79.25pt'>
7268 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7270 <h5 style='mso-outline-level:5'><a name="_Toc115416225"></a><a
7271 name="_Value_:_Cell"></a><span style='mso-bookmark:_Toc115416225'>Value: Cell</span></h5>
7272 <p class=MsoBodyText>Type: REG_SZ<br>
7273 Default: <none><br>
7274 Variable: rootCellName</p>
7275 <p class=MsoBodyText>Name of root cell (the cell from which root.afs should
7276 be mounted in \\afs\all).</p>
7279 <tr style='mso-yfti-irow:24;height:79.25pt'>
7280 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7282 <h5 style='mso-outline-level:5'><a name="_Toc115416226">Value: RxNoJumbo</a></h5>
7283 <p class=MsoBodyText>Type: DWORD {0,1}<br>
7285 Variable: rx_nojumbo</p>
7286 <p class=MsoBodyText>If enabled, does not send or indicate that we are able
7287 to send or receive RX jumbograms.</p>
7290 <tr style='mso-yfti-irow:25;height:124.75pt'>
7291 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7293 <h5 style='mso-outline-level:5'><a name="_Toc115416227"></a><a
7294 name="_Value_:_RxMaxMTU"></a><span style='mso-bookmark:_Toc115416227'>Value:
7295 RxMaxMTU</span></h5>
7296 <p class=MsoBodyText>Type: DWORD<br>
7298 Variable: rx_mtu</p>
7299 <p class=MsoBodyText>If set to anything other than -1, uses that value as the
7300 maximum MTU supported by the RX interface.</p>
7301 <p class=MsoBodyText>In order to enable OpenAFS to operate across the Cisco
7302 IPSec VPN client, this value must be set to 1264 or smaller.</p>
7305 <tr style='mso-yfti-irow:26;height:151.75pt'>
7306 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7308 <h5 style='mso-outline-level:5'><a name="_Toc115416228">Value:
7309 ConnDeadTimeout</a></h5>
7310 <p class=MsoBodyText>Type: DWORD<br>
7311 Default: 60 (seconds)<br>
7312 Variable: ConnDeadtimeout</p>
7313 <p class=MsoBodyText>The Connection Dead Time is enforced to be at a minimum
7314 15 seconds longer than the minimum SMB timeout as specified by
7315 [HKLM\SYSTEM\CurrentControlSet\Services\lanmanworkstation\parameters]
7317 <p class=MsoBodyText>If the minimum SMB timeout is not specified the value is
7318 45 seconds.<span style='mso-spacerun:yes'> </span>See <a
7319 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>
7322 <tr style='mso-yfti-irow:27;height:92.0pt'>
7323 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7325 <h5 style='mso-outline-level:5'><a name="_Toc115416229">Value:
7326 HardDeadTimeout</a></h5>
7327 <p class=MsoBodyText>Type: DWORD<br>
7328 Default: 120 (seconds)<br>
7329 Variable: HardDeadtimeout</p>
7330 <p class=MsoBodyText>The Hard Dead Time is enforced to be at least double the
7331 ConnDeadTimeout.<span style='mso-spacerun:yes'> </span>The provides an opportunity
7332 for at least one retry.</p>
7335 <tr style='mso-yfti-irow:28;height:158.5pt'>
7336 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7338 <h5 style='mso-outline-level:5'><a name="_Toc115416230"></a><a
7339 name="_Value__:_TraceOption"></a><span style='mso-bookmark:_Toc115416230'>Value:
7340 TraceOption</span></h5>
7341 <p class=MsoBodyText>Type: DWORD {0-15}<br>
7343 <p class=MsoBodyText>Enables logging of debug output to the Windows Event
7345 <p class=MsoBodyText>Bit 0 enables logging of "Logon Events"
7346 processed by the Network Provider and Winlogon Event Notification Handler.<span
7347 style='mso-spacerun:yes'> </span></p>
7348 <p class=MsoBodyText>Bit 1 enables logging of events captured by the AFS
7350 <p class=MsoBodyText>Bit 2 enables real-time viewing of "fs trace"
7351 logging with DbgView or similar tools.</p>
7352 <p class=MsoBodyText>Bit 3 enables "fs trace" logging on startup.</p>
7355 <tr style='mso-yfti-irow:29;height:98.5pt'>
7356 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7358 <h5 style='mso-outline-level:5'><a name="_Toc115416231">Value: AllSubmount</a></h5>
7359 <p class=MsoBodyText>Type: DWORD {0, 1}<br>
7361 <p class=MsoBodyText>Variable: allSubmount (smb.c)</p>
7362 <p class=MsoBodyText>By setting this value to 0, the
7363 "\\NetbiosName\all" mount point will not be created.<span
7364 style='mso-spacerun:yes'> </span>This allows the read-write versions of
7365 root.afs to be hidden.</p>
7368 <tr style='mso-yfti-irow:30;height:78.5pt'>
7369 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7371 <h5 style='mso-outline-level:5'><a name="_Toc115416232"></a><a
7372 name="_Value___: NoFindLanaByName"></a><span style='mso-bookmark:_Toc115416232'>Value:
7373 NoFindLanaByName</span></h5>
7374 <p class=MsoBodyText>Type: DWORD {0, 1}<br>
7376 <p class=MsoBodyText>Disables the attempt to identity the network adapter to
7377 use by looking for an adapter with a display name of "AFS".</p>
7380 <tr style='mso-yfti-irow:31;height:78.5pt'>
7381 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7383 <h5 style='mso-outline-level:5'><a name="_Toc115416233">Value: MaxCPUs</a></h5>
7384 <p class=MsoBodyText>Type: DWORD {1..32} or {1..64} depending on the
7386 Default: <no default></p>
7387 <p class=MsoBodyText>If this value is specified, afsd_service.exe will
7388 restrict itself to executing on the specified number of CPUs if there are a
7389 greater number installed in the machine.<span style='mso-spacerun:yes'>
7393 <tr style='mso-yfti-irow:32;height:151.75pt'>
7394 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7396 <h5 style='mso-outline-level:5'><a name="_Toc115416234"></a><a
7397 name="_Value___: smbAuthType"></a><span style='mso-bookmark:_Toc115416234'>Value:
7398 smbAuthType</span></h5>
7399 <p class=MsoBodyText>Type: DWORD {0..2}<br>
7401 <p class=MsoBodyText>If this value is specified, it defines the type of SMB
7402 authentication which must be present in order for the Windows SMB client to
7403 connect to the AFS Client Service's SMB server.<span
7404 style='mso-spacerun:yes'> </span>The values are:</p>
7405 <p class=MsoBodyText>0 = No authentication required<br>
7406 1 = NTLM authentication required<br>
7407 2 = Extended (GSS SPNEGO) authentication required<br>
7408 The default is Extended authentication</p>
7411 <tr style='mso-yfti-irow:33;height:92.0pt'>
7412 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7414 <h5 style='mso-outline-level:5'><a name="_Toc115416235"></a><a
7415 name="_Value___: MaxLogSize"></a><span style='mso-bookmark:_Toc115416235'>Value:
7416 MaxLogSize</span></h5>
7417 <p class=MsoBodyText>Type: DWORD {0 .. MAXDWORD}<br>
7419 <p class=MsoBodyText>This entry determines the maximum size of the
7420 %WINDIR%\TEMP\afsd_init.log file.<span style='mso-spacerun:yes'> </span>If
7421 the file is larger than this value when afsd_service.exe starts the file will
7422 be reset to 0 bytes.<span style='mso-spacerun:yes'> </span>If this value is
7423 0, it means the file should be allowed to grow indefinitely.</p>
7426 <tr style='mso-yfti-irow:34;mso-yfti-lastrow:yes;height:65.75pt'>
7427 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7429 <h5 style='mso-outline-level:5'><a name="_Toc115416236">Value: FlushOnHibernate</a></h5>
7430 <p class=MsoBodyText>Type: DWORD {0,1}<br>
7432 <p class=MsoBodyText>If set, flushes all volumes before the machine goes on
7433 hibernate or stand-by.</p>
7438 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416237">Regkey:<br>
7439 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters\GlobalAutoMapper]</a></h3>
7441 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7442 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7443 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7444 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7446 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7448 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416238">Value:
7449 <Drive Letter:> for example "G:"</a></h5>
7450 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ</p>
7451 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Specifies the submount name to
7452 be mapped by afsd_service.exe at startup to the provided drive letter.</p>
7457 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416239">Regkey:<br>
7458 [HKLM\SOFTWARE\OpenAFS\Client]</a></h3>
7460 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7461 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7462 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7463 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:78.5pt'>
7464 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7466 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416240"></a><a
7467 name="_Value___: CellServDBDir"></a><span style='mso-bookmark:_Toc115416240'>Value:
7468 CellServDBDir</span></h5>
7469 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
7470 Default: <not defined></p>
7471 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Specifies the directory
7472 containing the CellServDB file.<span style='mso-spacerun:yes'> </span>When
7473 this value is not specified, the AFS Client install directory is used.</p>
7476 <tr style='mso-yfti-irow:0;height:145.25pt'>
7477 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7479 <h5 style='mso-outline-level:5'><a name="_Toc115416241"></a><a
7480 name="_Value___: VerifyServiceSignature"></a><span style='mso-bookmark:_Toc115416241'>Value:
7481 VerifyServiceSignature</span></h5>
7482 <p class=MsoBodyText>Type: REG_DWORD<br>
7484 <p class=MsoBodyText>This value can be used to disable the runtime
7485 verification of the digital signatures applied to afsd_service.exe and the
7486 OpenAFS DLLs it loads.<span style='mso-spacerun:yes'> </span>This test is
7487 performed to verify that<span style='mso-spacerun:yes'> </span>the DLLs
7488 which are loaded by afsd_service.exe are from the same distribution as
7489 afsd_service.exe.<span style='mso-spacerun:yes'> </span>This is to prevent
7490 random errors caused when DLLs from one distribution of AFS are loaded by
7491 another one.<span style='mso-spacerun:yes'> </span>This is not a security
7492 test.<span style='mso-spacerun:yes'> </span>The reason for disabling this
7493 test is to free up additional memory which can be used for a large cache
7497 <tr style='mso-yfti-irow:1;height:105.5pt'>
7498 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7500 <h5 style='mso-outline-level:5'><a name="_Toc115416242"></a><a
7501 name="_Value___: IoctlDebug"></a><span style='mso-bookmark:_Toc115416242'>Value:
7502 IoctlDebug</span></h5>
7503 <p class=MsoBodyText>Type: REG_DWORD<br>
7505 <p class=MsoBodyText>This value can be used to debug the cause of pioctl()
7506 failures.<span style='mso-spacerun:yes'> </span>Set a non-zero value and the
7507 pioctl() library will output status information to stdout.<span
7508 style='mso-spacerun:yes'> </span>Executing command line tools such as
7509 tokens.exe, fs.exe, etc can then be used to determine why the pioctl() call
7513 <tr style='mso-yfti-irow:2;height:330.75pt'>
7514 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7516 <h5 style='mso-outline-level:5'><a name="_Toc115416243">Value: MiniDumpType</a></h5>
7517 <p class=MsoBodyText>Type: REG_DWORD<br>
7518 Default: 0x0 (MiniDumpNormal)</p>
7519 <p class=MsoBodyText>This value is used to specify the type of minidump
7520 generated by afsd_service.exe either when the process crashes or when a user
7521 initiated is dump file is generated with the "fs.exe minidump"
7523 <p class=MsoBodyText>Valid values are dependent on the version of DbgHelp.dll
7524 installed on the machine.<span style='mso-spacerun:yes'> </span>See the
7525 Microsoft Developer Library for further information.</p>
7526 <p class=MsoBodyText>MiniDumpNormal = 0x00000000,<br>
7527 MiniDumpWithDataSegs = 0x00000001,<br>
7528 MiniDumpWithFullMemory = 0x00000002,<br>
7529 MiniDumpWithHandleData = 0x00000004,<br>
7530 MiniDumpFilterMemory = 0x00000008,<br>
7531 MiniDumpScanMemory = 0x00000010,<br>
7532 MiniDumpWithUnloadedModules = 0x00000020,<br>
7533 MiniDumpWithIndirectlyReferencedMemory = 0x00000040,<br>
7534 MiniDumpFilterModulePaths = 0x00000080,<br>
7535 MiniDumpWithProcessThreadData = 0x00000100,<br>
7536 MiniDumpWithPrivateReadWriteMemory = 0x00000200,<br>
7537 MiniDumpWithoutOptionalData = 0x00000400,<br>
7538 MiniDumpWithFullMemoryInfo = 0x00000800,<br>
7539 MiniDumpWithThreadInfo = 0x00001000,<br>
7540 MiniDumpWithCodeSegs = 0x00002000</p>
7543 <tr style='mso-yfti-irow:3;mso-yfti-lastrow:yes;height:138.25pt'>
7544 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7546 <h5 style='mso-outline-level:5'><a name="_Toc115416244"></a><a
7547 name="_Value___: StoreAnsiFilenames"></a><span style='mso-bookmark:_Toc115416244'>Value:
7548 StoreAnsiFilenames</span></h5>
7549 <p class=MsoBodyText>Type: REG_DWORD<br>
7551 <p class=MsoBodyText>This value can be used to force the AFS Client Service
7552 to store filenames using the Windows system's ANSI character set instead of
7553 the OEM Code Page character set which has traditionally been used by SMB file
7554 systems.<span style='mso-spacerun:yes'> </span></p>
7555 <p class=MsoBodyText>Note: The use of ANSI characters will render access to
7556 files with 8-bit OEM file names unaccessible from Windows.<span
7557 style='mso-spacerun:yes'> </span>This option is of use primarily when you
7558 wish to allow file names produced on Windows to be accessible from Latin-1 UNIX
7559 systems and vice versa.</p>
7564 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416245">Regkey:<br>
7565 [HKLM\SOFTWARE\OpenAFS\Client\CSCPolicy]</a></h3>
7567 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7568 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7569 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7570 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7572 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7574 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416246">Value:
7575 "smb/cifs share name"</a></h5>
7576 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
7577 Default: <none></p>
7578 <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to map SMB/CIFS
7579 shares to Client Side Caching (off-line access) policies. For each share one
7580 of the following policies may be used: "manual",
7581 "programs", "documents", "disable".<span
7582 style='mso-spacerun:yes'> </span></p>
7583 <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
7589 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416247"></a><a
7590 name="_Regkey:_[HKLM\SOFTWARE\OpenAFS\Clie"></a><![if !supportLists]><span
7591 style='mso-bookmark:_Toc115416247'></span><![endif]><span style='mso-bookmark:
7592 _Toc115416247'>Regkey:<br>
7593 [HKLM\SOFTWARE\OpenAFS\Client\Freelance]</span></h3>
7595 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7596 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7597 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7598 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7600 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7602 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416248">Value:
7603 "numeric value"</a></h5>
7604 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
7605 Default: <none></p>
7606 <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to store dot
7607 terminated mount point strings for use in constructing the fake root.afs
7608 volume when Freelance (dynamic roots) mode is activated.</p>
7609 <p class=MsoBodyText style='mso-yfti-cnfc:1'>"athena.mit.edu#athena.mit.edu:root.cell."</p>
7610 <p class=MsoBodyText style='mso-yfti-cnfc:1'>".athena.mit.edu%athena.mit.edu:root.cell."</p>
7611 <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
7612 in afs_freelance.ini</p>
7617 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416249"></a><a
7618 name="_Regkey:_[HKLM\SOFTWARE\OpenAFS\Clie_1"></a><![if !supportLists]><span
7619 style='mso-bookmark:_Toc115416249'></span><![endif]><span style='mso-bookmark:
7620 _Toc115416249'>Regkey:<br>
7621 [HKLM\SOFTWARE\OpenAFS\Client\Freelance\Symlinks]</span></h3>
7623 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7624 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7625 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7626 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7628 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7630 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416250">Value:
7631 "numeric value"</a></h5>
7632 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
7633 Default: <none></p>
7634 <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to store a dot
7635 terminated symlink strings for use in constructing the fake root.afs volume
7636 when Freelance (dynamic roots) mode is activated.</p>
7637 <p class=MsoBodyText style='mso-yfti-cnfc:1'>"linkname:destination-path."</p>
7638 <p class=MsoBodyText style='mso-yfti-cnfc:1'>"<st1:GivenName w:st="on">athena</st1:GivenName>:athena.mit.edu."</p>
7639 <p class=MsoBodyText style='mso-yfti-cnfc:1'>"home:athena.mit.edu\user\j\a\jaltman."</p>
7640 <p class=MsoBodyText style='mso-yfti-cnfc:1'>"filename:path\file."</p>
7645 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416251">Regkey:<br>
7646 [HKLM\SOFTWARE\OpenAFS\Client\Submounts]</a></h3>
7648 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7649 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7650 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7651 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7653 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7655 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416252">Value:
7656 "submount name"</a></h5>
7657 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_EXPAND_SZ<br>
7658 Default: <none></p>
7659 <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to store
7660 mappings of UNIX style AFS paths to submount names which can be referenced as
7661 UNC paths.<span style='mso-spacerun:yes'> </span>For example the submount
7662 string /athena.mit.edu/user/j/a/jaltman" can be associated with the
7663 submount name "jaltman.home".<span style='mso-spacerun:yes'>
7664 </span>This can then be referenced as the UNC path \\AFS\jaltman.home.</p>
7665 <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
7667 <p class=MsoBodyText style='mso-yfti-cnfc:1'>NOTE: Submounts should no longer
7668 be used with OpenAFS. Use the Windows Explorer to create drive mappings to
7669 AFS UNC paths instead of using the AFS Submount mechanism.</p>
7674 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416253"></a><a
7675 name="_Regkey:_[HKLM\SOFTWARE\OpenAFS\Clie_2"></a><![if !supportLists]><span
7676 style='mso-bookmark:_Toc115416253'></span><![endif]><span style='mso-bookmark:
7677 _Toc115416253'>Regkey:<br>
7678 [HKLM\SOFTWARE\OpenAFS\Client\Server Preferences\VLDB]</span></h3>
7680 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7681 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7682 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7683 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7685 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7687 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416254">Value:
7688 "hostname or ip address"</a></h5>
7689 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_DWORD<br>
7690 Default: <none></p>
7691 <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to specify a
7692 default set of VLDB server preferences. For each entry the value name will be
7693 either the IP address of a server or a fully qualified domain name.<span
7694 style='mso-spacerun:yes'> </span>The value will be the ranking.<span
7695 style='mso-spacerun:yes'> </span>The ranking will be adjusted by a random
7696 value between 0 and 256 prior to the preference being set.</p>
7701 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416255">Regkey:<br>
7702 [HKLM\SOFTWARE\OpenAFS\Client\Server Preferences\File]</a></h3>
7704 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7705 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7706 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7707 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7709 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7711 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416256">Value:
7712 "hostname or ip address"</a></h5>
7713 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_DWORD<br>
7714 Default: <none></p>
7715 <p class=MsoBodyText style='mso-yfti-cnfc:1'>This key is used to specify a
7716 default set of File server preferences. For each entry the value name will be
7717 either the IP address of a server or a fully qualified domain name.<span
7718 style='mso-spacerun:yes'> </span>The value will be the ranking.<span
7719 style='mso-spacerun:yes'> </span>The ranking will be adjusted by a random
7720 value between 0 and 256 prior to the preference being set.</p>
7725 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417105"></a><a
7726 name="_Toc115416257"><span style='mso-bookmark:_Toc115417105'>A.2. Integrated
7727 Logon Network provider parameters</span></a></h2>
7729 <p class=MsoBodyText>Affects the network provider (afslogon.dll).</p>
7731 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416258">Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</a></h3>
7733 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7734 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7735 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7736 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
7738 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7740 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416259">Value:
7741 FailLoginsSilently</a></h5>
7742 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD<br>
7744 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Do not display message boxes if
7745 the login fails.</p>
7750 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416260">Regkey:<br>
7751 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]</a></h3>
7753 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7754 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7755 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7756 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:65.75pt'>
7757 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7759 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416261">Value:
7761 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD<br>
7763 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Disables visible warnings during
7767 <tr style='mso-yfti-irow:0;height:65.75pt'>
7768 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7770 <h5 style='mso-outline-level:5'><a name="_Toc115416262">Value:
7771 AuthentProviderPath</a></h5>
7772 <p class=MsoBodyText>Type: REG_SZ<br>
7773 NSIS: %WINDIR%\SYSTEM32\afslogon.dll</p>
7774 <p class=MsoBodyText>Specifies the install location of the authentication
7778 <tr style='mso-yfti-irow:1;height:65.75pt'>
7779 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7781 <h5 style='mso-outline-level:5'><a name="_Toc115416263">Value: Class</a></h5>
7782 <p class=MsoBodyText>Type: DWORD<br>
7784 <p class=MsoBodyText>Specifies the class of network provider</p>
7787 <tr style='mso-yfti-irow:2;height:92.0pt'>
7788 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7790 <h5 style='mso-outline-level:5'><a name="_Toc115416264">Value: DependOnGroup</a></h5>
7791 <p class=MsoBodyText>Type: REG_MULTI_SZ<br>
7793 <p class=MsoBodyText>Specifies the service groups upon which the AFS Client
7794 Service depends.<span style='mso-spacerun:yes'> </span>Windows should not
7795 attempt to start the AFS Client Service until all of the services within
7796 these groups have successfully started.</p>
7799 <tr style='mso-yfti-irow:3;height:92.0pt'>
7800 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7802 <h5 style='mso-outline-level:5'><a name="_Toc115416265">Value:
7803 DependOnService</a></h5>
7804 <p class=MsoBodyText>Type: REG_MULTI_SZ<br>
7805 NSIS: Tcpip NETBIOS RpcSs</p>
7806 <p class=MsoBodyText>Specifies a list of services upon which the AFS Client
7807 Service depends.<span style='mso-spacerun:yes'> </span>Windows should not
7808 attempt to start the AFS Client Service until all of the specified services
7809 have successfully started.</p>
7812 <tr style='mso-yfti-irow:4;height:65.75pt'>
7813 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7815 <h5 style='mso-outline-level:5'><a name="_Toc115416266">Value: Name</a></h5>
7816 <p class=MsoBodyText>Type: REG_SZ<br>
7817 NSIS: "OpenAFSDaemon"</p>
7818 <p class=MsoBodyText>Specifies the display name of the AFS Client Service</p>
7821 <tr style='mso-yfti-irow:5;mso-yfti-lastrow:yes;height:65.75pt'>
7822 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7824 <h5 style='mso-outline-level:5'><a name="_Toc115416267">Value: ProviderPath</a></h5>
7825 <p class=MsoBodyText>Type: REG_SZ<br>
7826 NSIS: %WINDIR%\SYSTEM32\afslogon.dll</p>
7827 <p class=MsoBodyText>Specifies the DLL to use for the network provider</p>
7832 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417106"></a><a
7833 name="_Toc115416268"></a><a name="_A.2.1_Domain_specific_configuration"></a><![if !supportLists]><span
7834 style='mso-bookmark:_Toc115417106'><span style='mso-bookmark:_Toc115416268'></span></span><![endif]><span
7835 style='mso-bookmark:_Toc115417106'><span style='mso-bookmark:_Toc115416268'>A.2.1
7836 Domain specific configuration keys for the Network Provider</span></span></h2>
7838 <p class=MsoBodyText>The network provider can be configured to have different
7839 behavior depending on the domain that the user logs into.<span
7840 style='mso-spacerun:yes'> </span>These settings are only relevant when using
7841 integrated login.<span style='mso-spacerun:yes'> </span>A domain refers to an Active
7842 Directory (AD) domain, a trusted Kerberos (non-AD) realm or the local machine
7843 (i.e. local account logins).<span style='mso-spacerun:yes'> </span>The domain
7844 name that is used for selecting the domain would be the domain that is passed
7845 into the NPLogonNotify function of the network provider.</p>
7847 <p class=MsoBodyText>Domain specific registry keys are:</p>
7849 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416269">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]</a></h3>
7851 <p class=MsoBodyText><span style='mso-spacerun:yes'> </span>(NP key)</p>
7853 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416270">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain]</a></h3>
7855 <p class=MsoBodyText><span style='mso-spacerun:yes'> </span>(Domains key)</p>
7857 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416271">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\"domain
7858 name"]</a></h3>
7860 <p class=MsoBodyText><span style='mso-spacerun:yes'> </span>(Specific domain
7861 key. One per domain.)</p>
7863 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416272">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]</a></h3>
7865 <p class=MsoBodyText><span style='mso-spacerun:yes'> </span>(Localhost key)</p>
7867 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416273">Example:</a></h3>
7869 <p class=PreformattedText><span
7870 style='mso-spacerun:yes'> </span>HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider</p>
7872 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>|</p>
7874 <p class=PreformattedText><span style='mso-spacerun:yes'> </span>+- Domain</p>
7876 <p class=PreformattedText><span style='mso-spacerun:yes'>
7877 </span>+-AD1.EXAMPLE.COM</p>
7879 <p class=PreformattedText><span style='mso-spacerun:yes'>
7880 </span>+-AD2.EXAMPLE.NET</p>
7882 <p class=PreformattedText><span style='mso-spacerun:yes'>
7883 </span>+-LOCALHOST</p>
7885 <p class=MsoBodyText>Each of the domain specific keys can have the set of
7886 values described in 2.1.1.<span style='mso-spacerun:yes'> </span>The effective
7887 values are chosen as described in 2.1.2.</p>
7889 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416274">A.2.1.1 Domain
7890 specific configuration values</a></h3>
7892 <h4><a name="_Toc115416275">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]<br>
7893 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain]<br>
7894 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\"domain
7896 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]</a></h4>
7898 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
7899 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
7900 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
7901 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:191.0pt'>
7902 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7904 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416276"></a><a
7905 name="_Value___: LogonOptions"></a><span style='mso-bookmark:_Toc115416276'>Value:
7906 LogonOptions</span></h5>
7907 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD<br>
7909 <p class=MsoBodyText style='mso-yfti-cnfc:1'>NSIS/WiX: depends on user
7911 <p class=MsoBodyText style='mso-yfti-cnfc:1'>0x00 - Integrated Logon is not
7913 0x01 - Integrated Logon is used<br>
7914 0x02 - High Security Mode is used (deprecated)<br>
7915 0x03 - Integrated Logon with High Security Mode is used (deprecated)</p>
7916 <p class=MsoBodyText style='mso-yfti-cnfc:1'>High Security Mode generates
7917 random SMB names for the creation of Drive Mappings.<span
7918 style='mso-spacerun:yes'> </span>This mode should not be used without
7919 Integrated Logon.</p>
7920 <p class=MsoBodyText style='mso-yfti-cnfc:1'>As of 1.3.65 the SMB server
7921 supports SMB authentication.<span style='mso-spacerun:yes'> </span>The High
7922 Security Mode should not be used when using SMB authentication (SMBAuthType
7923 setting is non zero).</p>
7926 <tr style='mso-yfti-irow:0;height:92.0pt'>
7927 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7929 <h5 style='mso-outline-level:5'><a name="_Toc115416277">Value:
7930 FailLoginsSilentl</a></h5>
7931 <p class=MsoBodyText>Type: DWORD (1|0)<br>
7933 NSIS/WiX: (not set)</p>
7934 <p class=MsoBodyText>If true, does not display any visible warnings in the
7935 event of an error during the integrated login process.</p>
7938 <tr style='mso-yfti-irow:1;height:139.0pt'>
7939 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7941 <h5 style='mso-outline-level:5'><a name="_Toc115416278">Value: LogonScript</a></h5>
7942 <p class=MsoBodyText>Type: REG_SZ or REG_EXPAND_SZ<br>
7944 NSIS/WiX: (only value under NP key) <install path>\afscreds.exe -:%s -x
7946 <p class=MsoBodyText>A logon script that will be scheduled to be run after
7947 the profile load is complete.<span style='mso-spacerun:yes'> </span>If using
7948 the REG_EXPAND_SZ type, you can use any system environment variable as
7949 "%varname%" which would be expanded at the time the network provider
7950 is run.<span style='mso-spacerun:yes'> </span>Optionally using a
7951 "%s" in the value would result in it being expanded into the AFS
7952 SMB username for the session.</p>
7955 <tr style='mso-yfti-irow:2;height:105.5pt'>
7956 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7958 <h5 style='mso-outline-level:5'><a name="_Toc115416279">Value: LoginRetryInterval</a></h5>
7959 <p class=MsoBodyText>Type: DWORD<br>
7961 NSIS/WiX: (not set)</p>
7962 <p class=MsoBodyText>If the OpenAFS client service has not started yet, the network
7963 provider will wait for a maximum of "LoginRetryInterval" seconds
7964 while retrying every "LoginSleepInterval" seconds to check if the
7968 <tr style='mso-yfti-irow:3;height:79.25pt'>
7969 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7971 <h5 style='mso-outline-level:5'><a name="_Toc115416280">Value:
7972 LoginSleepInterval</a></h5>
7973 <p class=MsoBodyText>Type: DWORD<br>
7975 NSIS/WiX: (not set)</p>
7976 <p class=MsoBodyText>See description of LoginRetryInterval.</p>
7979 <tr style='mso-yfti-irow:4;mso-yfti-lastrow:yes;height:78.5pt'>
7980 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7982 <h5 style='mso-outline-level:5'><a name="_Toc115416281"></a><a
7983 name="_Value:_TheseCells"></a><span style='mso-bookmark:_Toc115416281'>Value:
7984 TheseCells</span></h5>
7985 <p class=MsoBodyText>Type: REG_MULTI_SZ<br>
7986 NSIS: <not set></p>
7987 <p class=MsoBodyText>When Kerberos 5 is being used, TheseCells provides a
7988 list of additional cells for which tokens should be obtained with the default
7989 Kerberos 5 principal.</p>
7994 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416282">A.2.1.2<span
7995 style='mso-spacerun:yes'> </span>Selection of effective values for domain
7996 specific configuration</a></h3>
7998 <p class=MsoBodyText>During login to domain X, where X is the domain passed
7999 into NPLogonNotify as lpAuthentInfo->LogonDomainName or the string 'LOCALHOST'
8000 if lpAuthentInfo->LogonDomainName equals the name of the computer, the
8001 following keys will be looked up.</p>
8003 <p class=MsoBodyText style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:
8004 l33 level1 lfo13;tab-stops:list 36.0pt'><![if !supportLists]><span
8005 style='mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
8006 style='mso-list:Ignore'>1.<span style='font:7.0pt "Times New Roman"'>
8007 </span></span></span><![endif]>NP key. ("HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider")</p>
8009 <p class=MsoBodyText style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:
8010 l33 level1 lfo13;tab-stops:list 36.0pt'><![if !supportLists]><span
8011 style='mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
8012 style='mso-list:Ignore'>2.<span style='font:7.0pt "Times New Roman"'>
8013 </span></span></span><![endif]>Domains key. (NP key\"Domain")</p>
8015 <p class=MsoBodyText style='margin-left:36.0pt;text-indent:-18.0pt;mso-list:
8016 l33 level1 lfo13;tab-stops:list 36.0pt'><![if !supportLists]><span
8017 style='mso-fareast-font-family:Thorndale;mso-bidi-font-family:Thorndale'><span
8018 style='mso-list:Ignore'>3.<span style='font:7.0pt "Times New Roman"'>
8019 </span></span></span><![endif]>Specific domain key. (Domains key\X)</p>
8021 <p class=MsoBodyText>If the specific domain key does not exist, then the
8022 domains key will be ignored.<span style='mso-spacerun:yes'> </span>All the
8023 configuration information in this case will come from the NP key.</p>
8025 <p class=MsoBodyText>If the specific domain key exists, then for each of the
8026 values metioned in (2), they will be looked up in the specific domain key, domains
8027 key and the NP key successively until the value is found. The first instance of
8028 the value found this way will be the effective for the login session.<span
8029 style='mso-spacerun:yes'> </span>If no such instance can be found, the default
8030 will be used.<span style='mso-spacerun:yes'> </span>To re-iterate, a value in
8031 a more specific key supercedes a value in a less specific key.<span
8032 style='mso-spacerun:yes'> </span>The exceptions to this rule are stated below.</p>
8034 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416283">A.2.1.3 Exceptions
8037 <p class=MsoBodyText>To retain backwards compatibility, the following
8038 exceptions are made to 2.1.2.</p>
8040 <h4><a name="_Toc115416284">2.1.3.1 'FailLoginsSilently'</a></h4>
8042 <p class=MsoBodyText>Historically, the 'FailLoginsSilently' value was in HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters
8043 key and not in the NP key.<span style='mso-spacerun:yes'> </span>Therefore,
8044 for backwards compatibility, the value in the Parameters key will supercede all
8045 instances of this value in other keys.<span style='mso-spacerun:yes'>
8046 </span>In the absence of this value in the Parameters key, normal scope rules
8049 <h4><a name="_Toc115416285">2.1.3.2 'LogonScript'</a></h4>
8051 <p class=MsoBodyText>If a 'LogonScript' is not specified in the specific domain
8052 key nor in the domains key, the value in the NP key will only be checked if the
8053 effective 'LogonOptions' specify a high security integrated login.<span
8054 style='mso-spacerun:yes'> </span>If a logon script is specified in the
8055 specific domain key or the domains key, it will be used regardless of the high
8056 security setting.<span style='mso-spacerun:yes'> </span>Please be aware of
8057 this when setting this value.</p>
8059 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417107"></a><a
8060 name="_Toc115416286"><span style='mso-bookmark:_Toc115417107'>A.3. AFS
8061 Credentials System Tray Tool parameters</span></a></h2>
8063 <p class=MsoBodyText>Affects the behavior of afscreds.exe</p>
8065 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416287">Regkey:<br>
8066 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</a></h3>
8068 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
8069 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
8070 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
8071 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:92.0pt'>
8072 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
8074 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416288">Value:
8076 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
8077 Default: ""<br>
8078 Function: GetGatewayName()</p>
8079 <p class=MsoBodyText style='mso-yfti-cnfc:1'>If the AFS client is utilizing a
8080 gateway to obtain AFS access, the name of the gateway is specified by this
8084 <tr style='mso-yfti-irow:0;mso-yfti-lastrow:yes;height:92.0pt'>
8085 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
8087 <h5 style='mso-outline-level:5'><a name="_Toc115416289">Value: Cell</a></h5>
8088 <p class=MsoBodyText>Type: REG_SZ<br>
8089 Default: <none><br>
8090 Variable: IsServiceConfigured()</p>
8091 <p class=MsoBodyText>The value Cell is used to determine if the AFS Client
8092 Service has been properly configured or not.</p>
8097 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416290">Regkey:<br>
8098 [HKLM\SOFTWARE\OpenAFS\Client]<br>
8099 [HKCU\SOFTWARE\OpenAFS\Client]</a></h3>
8101 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
8102 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
8103 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
8104 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;height:157.5pt'>
8105 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
8107 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416291">Value:
8108 ShowTrayIcon</a></h5>
8109 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD {0, 1}<br>
8111 Function: InitApp(), Main_OnCheckTerminate()</p>
8112 <p class=MsoBodyText style='mso-yfti-cnfc:1'>This value is used to determine
8113 whether or not a shortcut should be maintained in the user's Start
8114 Menu->Programs->Startup folder. </p>
8115 <p class=MsoBodyText style='mso-yfti-cnfc:1'>This value used to be stored at
8116 [HKLM\Software\TransarcCorporation\AFS Client\AfsCreds].</p>
8117 <p class=MsoBodyText style='mso-yfti-cnfc:1'>The current user value is
8118 checked first; if it does not exist the local machine value is checked.</p>
8121 <tr style='mso-yfti-irow:0;height:119.0pt'>
8122 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
8124 <h5 style='mso-outline-level:5'><a name="_Toc115416292">Value: EnableKFW</a></h5>
8125 <p class=MsoBodyText>Type: DWORD {0, 1}<br>
8127 Function: KFW_is_available()</p>
8128 <p class=MsoBodyText>When MIT Kerberos for Windows can be loaded, Kerberos 5
8129 will be used to obtain AFS credentials.<span style='mso-spacerun:yes'>
8130 </span>By setting this value to 0, the internal Kerberos 4 implementation
8131 will be used instead.<span style='mso-spacerun:yes'> </span>The current user
8132 value is checked first; if it does not exist the local machine value is
8136 <tr style='mso-yfti-irow:1;height:119.0pt'>
8137 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
8139 <h5 style='mso-outline-level:5'><a name="_Toc115416293"></a><a
8140 name="_Value___: Use524"></a><span style='mso-bookmark:_Toc115416293'>Value:
8142 <p class=MsoBodyText>Type: DWORD {0, 1}<br>
8144 Function: KFW_use_krb524()</p>
8145 <p class=MsoBodyText>When MIT Kerberos for Windows can be loaded, Kerberos 5
8146 will be used to obtain AFS credentials.<span style='mso-spacerun:yes'>
8147 </span>By setting this value to 1, the Kerberos 5 tickets will be converted
8148 to Kerberos 4 tokens via a call to the krb524 daemon.<span
8149 style='mso-spacerun:yes'> </span>The current user value is checked first; if
8150 it does not exist the local machine value is checked.</p>
8153 <tr style='mso-yfti-irow:2;mso-yfti-lastrow:yes;height:251.5pt'>
8154 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
8156 <h5 style='mso-outline-level:5'><a name="_Toc115416294"></a><a
8157 name="_Value___: AfscredsShortcutParams"></a><span style='mso-bookmark:_Toc115416294'>Value:
8158 AfscredsShortcutParams</span></h5>
8159 <p class=MsoBodyText>Type: REG_SZ<br>
8160 Default: "-A -M -N -Q"<br>
8161 Function: Shortcut_FixStartup</p>
8162 <p class=MsoBodyText>This value specifies the command line options which
8163 should be set as part of the shortcut to afscreds.exe.<span
8164 style='mso-spacerun:yes'> </span>afscreds.exe rewrites the shortcut each
8165 time it exits so as to ensure that the shortcut points to the latest version
8166 of the program.<span style='mso-spacerun:yes'> </span>This value is used to
8167 determine which values should be used for command line parameters.<span
8168 style='mso-spacerun:yes'> </span>The current user value is checked first; if
8169 it does not exist the local machine value is checked.</p>
8170 <p class=MsoBodyText>The following subset of the command line options is
8171 appropriate for use in this registry setting:</p>
8172 <p class=MsoBodyText>-A = autoinit<br>
8173 -M = renew drive maps<br>
8174 -N = ip address change detection<br>
8175 -Q = quiet mode.<span style='mso-spacerun:yes'> </span>do not display start
8176 service dialog if afsd_service is not already running<br>
8177 -S = show tokens dialog on startup<br>
8178 -Z = unmap drives</p>
8183 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416295">Regkey:<br>
8184 [HKCU\SOFTWARE\OpenAFS\Client]</a></h3>
8186 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
8187 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
8188 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
8189 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
8191 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
8193 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416296">Value:
8194 Authentication Cell</a></h5>
8195 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
8196 Default: <none><br>
8197 Function: Afscreds.exe GetDefaultCell()</p>
8198 <p class=MsoBodyText style='mso-yfti-cnfc:1'>This value allows the user to
8199 configure a different cell name to be used as the default cell when acquiring
8200 tokens in afscreds.exe.</p>
8205 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416297">Regkey:<br>
8206 [HKCU\SOFTWARE\OpenAFS\Client\Reminders]</a></h3>
8208 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
8209 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
8210 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
8211 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
8213 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
8215 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416298">Value:
8216 "afs cell name"</a></h5>
8217 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD {0, 1}<br>
8218 Default: <none><br>
8219 Function: LoadRemind(), SaveRemind()</p>
8220 <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values are used to save
8221 and restore the state of the reminder flag for each cell for which the user
8222 has obtained tokens.</p>
8223 <p class=MsoBodyText style='mso-yfti-cnfc:1'>This value used to be stored at
8224 [HKLM\Software\TransarcCorporation\AFS Client\AfsCreds].</p>
8229 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416299">Regkey:<br>
8230 [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]</a></h3>
8232 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
8233 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
8234 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
8235 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
8237 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
8239 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416300">Value:
8240 "upper case drive letter"</a></h5>
8241 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD {0, 1}<br>
8242 Default: <none></p>
8243 <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values are used to store
8244 the persistence state of the AFS drive mappings as listed in the
8245 [...\Client\Mappings] key.</p>
8246 <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
8247 in the afsdsbmt.ini file</p>
8252 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416301">Regkey:<br>
8253 [HKCU\SOFTWARE\OpenAFS\Client\Mappings]</a></h3>
8255 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
8256 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
8257 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
8258 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes;
8260 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
8262 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416302">Value:
8263 "upper case drive letter"</a></h5>
8264 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
8265 Default: <none></p>
8266 <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values are used to store
8267 the AFS path in UNIX notation to which the drive letter is to be mapped.</p>
8268 <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
8269 in the afsdsbmt.ini file.</p>
8274 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417108"></a><a
8275 name="_Toc115416303"><span style='mso-bookmark:_Toc115417108'>A.4 OpenAFS
8276 Client Service Environment Variables</span></a></h2>
8278 <table class=MsoTableWeb1 border=1 cellspacing=3 cellpadding=0
8279 style='mso-cellspacing:2.0pt;mso-yfti-tbllook:480;mso-padding-alt:0pt 5.4pt 0pt 5.4pt;
8280 mso-border-insideh:.75pt outset windowtext;mso-border-insidev:.75pt outset windowtext'>
8281 <tr style='mso-yfti-irow:-1;mso-yfti-firstrow:yes'>
8282 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
8283 <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416304">Variable:
8284 AFS_RPC_ENCRYPT</a></h5>
8285 <p class=MsoBodyText style='mso-yfti-cnfc:1'>Values:<span
8286 style='mso-spacerun:yes'> </span>"OFF" disables the use of RPC
8287 encryption any other value allows RPC encryption to be used<br>
8288 Default:<span style='mso-spacerun:yes'> </span>RPC encryption is on</p>
8291 <tr style='mso-yfti-irow:0;mso-yfti-lastrow:yes'>
8292 <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt'>
8293 <h5 style='mso-outline-level:5'><a name="_Toc115416305">Variable:
8294 AFS_RPC_PROTSEQ</a></h5>
8295 <p class=MsoBodyText>Values:<span style='mso-tab-count:1'> </span>"ncalrpc"<span
8296 style='mso-spacerun:yes'> </span>- local RPC<br>
8297 <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:2'> </span>"ncacn_np"
8299 <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:2'> </span>"ncacn_ip_tcp"
8301 Default:<span style='mso-spacerun:yes'> </span>local RPC</p>
8306 <p class=MsoBodyText><o:p> </o:p></p>