windows-release-notes-20050925
[openafs.git] / src / WINNT / doc / install / Documentation / en_US / html / ReleaseNotes / relnotes.htm
1 <html xmlns:v="urn:schemas-microsoft-com:vml"
2 xmlns:o="urn:schemas-microsoft-com:office:office"
3 xmlns:w="urn:schemas-microsoft-com:office:word"
4 xmlns:st2="urn:schemas-microsoft-com:office:smarttags"
5 xmlns:st1="urn:schemas:contacts" xmlns="http://www.w3.org/TR/REC-html40">
6
7 <head>
8 <meta http-equiv=Content-Type content="text/html; charset=windows-1252">
9 <meta name=ProgId content=Word.Document>
10 <meta name=Generator content="Microsoft Word 11">
11 <meta name=Originator content="Microsoft Word 11">
12 <link rel=File-List href="relnotes_files/filelist.xml">
13 <link rel=Preview href="relnotes_files/preview.wmf">
14 <title>OpenAFS for Windows 1.4.0 Release Notes</title>
15 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
16  name="Street"/>
17 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
18  name="PostalCode"/>
19 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
20  name="State"/>
21 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
22  name="City"/>
23 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
24  name="address"/>
25 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
26  name="country-region"/>
27 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
28  name="place"/>
29 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
30  name="PlaceName"/>
31 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
32  name="PlaceType"/>
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>
44   <o:Pages>1</o:Pages>
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>
54  <w:WordDocument>
55   <w:DrawingGridHorizontalSpacing>0 pt</w:DrawingGridHorizontalSpacing>
56   <w:DrawingGridVerticalSpacing>0 pt</w:DrawingGridVerticalSpacing>
57   <w:DisplayHorizontalDrawingGridEvery>0</w:DisplayHorizontalDrawingGridEvery>
58   <w:DisplayVerticalDrawingGridEvery>0</w:DisplayVerticalDrawingGridEvery>
59   <w:UseMarginsForDrawingGridOrigin/>
60   <w:ValidateAgainstSchemas/>
61   <w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid>
62   <w:IgnoreMixedContent>false</w:IgnoreMixedContent>
63   <w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText>
64   <w:DrawingGridHorizontalOrigin>0 pt</w:DrawingGridHorizontalOrigin>
65   <w:DrawingGridVerticalOrigin>0 pt</w:DrawingGridVerticalOrigin>
66   <w:Compatibility>
67    <w:NoLeading/>
68    <w:SpaceForUL/>
69    <w:BalanceSingleByteDoubleByteWidth/>
70    <w:DoNotLeaveBackslashAlone/>
71    <w:ULTrailSpace/>
72    <w:DoNotExpandShiftReturn/>
73    <w:AdjustLineHeightInTable/>
74    <w:SelectEntireFieldWithStartOrEnd/>
75    <w:UseWord2002TableStyleRules/>
76   </w:Compatibility>
77   <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
78  </w:WordDocument>
79 </xml><![endif]--><!--[if gte mso 9]><xml>
80  <w:LatentStyles DefLockedState="false" LatentStyleCount="156">
81  </w:LatentStyles>
82 </xml><![endif]--><!--[if !mso]><object
83  classid="clsid:38481807-CA0E-42D2-BF39-B33AF135CC4D" id=ieooui></object>
84 <style>
85 st2\:*{behavior:url(#ieooui) }st1\:*{behavior:url(#ieooui) }
86 </style>
87 <![endif]-->
88 <style>
89 <!--
90  /* Font Definitions */
91  @font-face
92         {font-family:Wingdings;
93         panose-1:5 0 0 0 0 0 0 0 0 0;
94         mso-font-charset:2;
95         mso-generic-font-family:auto;
96         mso-font-pitch:variable;
97         mso-font-signature:0 268435456 0 0 -2147483648 0;}
98 @font-face
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;}
106 @font-face
107         {font-family:Tahoma;
108         panose-1:2 11 6 4 3 5 4 4 2 4;
109         mso-font-charset:0;
110         mso-generic-font-family:swiss;
111         mso-font-pitch:variable;
112         mso-font-signature:1627421319 -2147483648 8 0 66047 0;}
113 @font-face
114         {font-family:Thorndale;
115         panose-1:2 2 6 3 5 4 5 2 3 4;
116         mso-font-charset:0;
117         mso-generic-font-family:roman;
118         mso-font-pitch:variable;
119         mso-font-signature:647 0 0 0 159 0;}
120 @font-face
121         {font-family:"Andale Sans UI";
122         panose-1:2 11 5 2 0 0 0 0 0 1;
123         mso-font-charset:0;
124         mso-generic-font-family:swiss;
125         mso-font-pitch:variable;
126         mso-font-signature:647 0 0 0 159 0;}
127 @font-face
128         {font-family:StarSymbol;
129         panose-1:5 0 0 0 0 0 0 0 0 0;
130         mso-font-charset:0;
131         mso-generic-font-family:auto;
132         mso-font-pitch:variable;
133         mso-font-signature:3 268468224 0 0 1 0;}
134 @font-face
135         {font-family:Albany;
136         panose-1:2 11 6 4 2 2 2 2 2 4;
137         mso-font-charset:0;
138         mso-generic-font-family:swiss;
139         mso-font-pitch:variable;
140         mso-font-signature:647 0 0 0 159 0;}
141 @font-face
142         {font-family:Cumberland;
143         panose-1:2 7 3 9 2 2 5 2 4 4;
144         mso-font-charset:0;
145         mso-generic-font-family:modern;
146         mso-font-pitch:fixed;
147         mso-font-signature:647 0 0 0 159 0;}
148 @font-face
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:"";
158         margin-top:7.2pt;
159         margin-right:0pt;
160         margin-bottom:7.2pt;
161         margin-left:0pt;
162         mso-pagination:none;
163         mso-hyphenate:none;
164         font-size:12.0pt;
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;}
169 h1
170         {mso-style-parent:Heading;
171         mso-style-next:"Body Text";
172         margin-top:12.0pt;
173         margin-right:0pt;
174         margin-bottom:6.0pt;
175         margin-left:0pt;
176         text-indent:0pt;
177         mso-pagination:none;
178         page-break-after:avoid;
179         mso-outline-level:1;
180         mso-list:l21 level1 lfo12;
181         mso-hyphenate:none;
182         tab-stops:list 0pt;
183         font-size:16.0pt;
184         font-family:Albany;
185         mso-fareast-font-family:"MS Mincho";
186         mso-bidi-font-family:Tahoma;
187         mso-font-kerning:0pt;
188         mso-fareast-language:#00FF;}
189 h2
190         {mso-style-parent:Heading;
191         mso-style-next:"Body Text";
192         margin-top:12.0pt;
193         margin-right:0pt;
194         margin-bottom:6.0pt;
195         margin-left:0pt;
196         text-indent:0pt;
197         mso-pagination:none;
198         page-break-after:avoid;
199         mso-outline-level:2;
200         mso-list:l21 level2 lfo12;
201         mso-hyphenate:none;
202         tab-stops:list 0pt;
203         font-size:14.0pt;
204         font-family:Albany;
205         mso-fareast-font-family:"MS Mincho";
206         mso-bidi-font-family:Tahoma;
207         mso-fareast-language:#00FF;
208         font-style:italic;}
209 h3
210         {mso-style-parent:Heading;
211         mso-style-link:"Heading 3 Char";
212         mso-style-next:"Body Text";
213         margin-top:12.0pt;
214         margin-right:0pt;
215         margin-bottom:6.0pt;
216         margin-left:0pt;
217         text-indent:0pt;
218         mso-pagination:none;
219         page-break-after:avoid;
220         mso-outline-level:3;
221         mso-list:l21 level3 lfo12;
222         mso-hyphenate:none;
223         tab-stops:list 0pt;
224         font-size:14.0pt;
225         font-family:Albany;
226         mso-fareast-font-family:"MS Mincho";
227         mso-bidi-font-family:Tahoma;
228         mso-fareast-language:#00FF;}
229 h4
230         {mso-style-link:"Heading 4 Char";
231         mso-style-next:Normal;
232         margin-top:12.0pt;
233         margin-right:0pt;
234         margin-bottom:3.0pt;
235         margin-left:0pt;
236         mso-pagination:none;
237         page-break-after:avoid;
238         mso-outline-level:4;
239         mso-hyphenate:none;
240         font-size:14.0pt;
241         font-family:"Times New Roman";
242         mso-fareast-font-family:"Andale Sans UI";
243         mso-fareast-language:#00FF;}
244 h5
245         {mso-style-next:Normal;
246         margin-top:12.0pt;
247         margin-right:0pt;
248         margin-bottom:3.0pt;
249         margin-left:0pt;
250         mso-pagination:none;
251         mso-outline-level:5;
252         mso-hyphenate:none;
253         font-size:13.0pt;
254         font-family:Thorndale;
255         mso-fareast-font-family:"Andale Sans UI";
256         mso-fareast-language:#00FF;
257         font-style:italic;}
258 h6
259         {mso-style-next:Normal;
260         margin-top:12.0pt;
261         margin-right:0pt;
262         margin-bottom:3.0pt;
263         margin-left:0pt;
264         mso-pagination:none;
265         mso-outline-level:6;
266         mso-hyphenate:none;
267         font-size:11.0pt;
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;
274         margin-top:7.2pt;
275         margin-right:0pt;
276         margin-bottom:7.2pt;
277         margin-left:0pt;
278         mso-pagination:no-line-numbers;
279         mso-hyphenate:none;
280         tab-stops:right dotted 432.0pt;
281         font-size:12.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;
289         margin-top:7.2pt;
290         margin-right:0pt;
291         margin-bottom:7.2pt;
292         margin-left:14.15pt;
293         mso-pagination:no-line-numbers;
294         mso-hyphenate:none;
295         tab-stops:right dotted 432.0pt;
296         font-size:12.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;
304         margin-top:7.2pt;
305         margin-right:0pt;
306         margin-bottom:7.2pt;
307         margin-left:28.3pt;
308         mso-pagination:no-line-numbers;
309         mso-hyphenate:none;
310         tab-stops:right dotted 432.0pt;
311         font-size:12.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;
318         margin-top:7.2pt;
319         margin-right:0pt;
320         margin-bottom:7.2pt;
321         margin-left:0pt;
322         mso-pagination:none;
323         mso-hyphenate:none;
324         font-size:10.0pt;
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
330         {margin-top:7.2pt;
331         margin-right:0pt;
332         margin-bottom:7.2pt;
333         margin-left:0pt;
334         mso-pagination:none;
335         mso-hyphenate:none;
336         tab-stops:center 216.0pt right 432.0pt;
337         font-size:12.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
343         {margin-top:7.2pt;
344         margin-right:0pt;
345         margin-bottom:7.2pt;
346         margin-left:0pt;
347         mso-pagination:none;
348         mso-hyphenate:none;
349         tab-stops:center 216.0pt right 432.0pt;
350         font-size:12.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
356         {margin-top:7.2pt;
357         margin-right:0pt;
358         margin-bottom:7.2pt;
359         margin-left:144.0pt;
360         mso-pagination:none;
361         mso-hyphenate:none;
362         mso-element:frame;
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;
371         font-size:12.0pt;
372         font-family:Arial;
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";
380         margin-top:0pt;
381         margin-right:0pt;
382         margin-bottom:6.0pt;
383         margin-left:0pt;
384         mso-pagination:none;
385         mso-hyphenate:none;
386         font-size:12.0pt;
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;
394         margin-top:12.0pt;
395         margin-right:0pt;
396         margin-bottom:6.0pt;
397         margin-left:0pt;
398         text-align:center;
399         mso-pagination:none;
400         page-break-after:avoid;
401         mso-hyphenate:none;
402         font-size:18.0pt;
403         font-family:Albany;
404         mso-fareast-font-family:"MS Mincho";
405         mso-bidi-font-family:Tahoma;
406         mso-fareast-language:#00FF;
407         font-weight:bold;}
408 p.MsoBodyText, li.MsoBodyText, div.MsoBodyText
409         {mso-style-link:"Body Text Char";
410         margin-top:0pt;
411         margin-right:0pt;
412         margin-bottom:6.0pt;
413         margin-left:0pt;
414         mso-pagination:none;
415         mso-hyphenate:none;
416         font-size:12.0pt;
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";
423         margin-top:0pt;
424         margin-right:0pt;
425         margin-bottom:6.0pt;
426         margin-left:14.15pt;
427         mso-pagination:none;
428         mso-hyphenate:none;
429         font-size:12.0pt;
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";
437         margin-top:12.0pt;
438         margin-right:0pt;
439         margin-bottom:6.0pt;
440         margin-left:0pt;
441         text-align:center;
442         mso-pagination:none;
443         page-break-after:avoid;
444         mso-hyphenate:none;
445         font-size:14.0pt;
446         font-family:Albany;
447         mso-fareast-font-family:"MS Mincho";
448         mso-bidi-font-family:Tahoma;
449         mso-fareast-language:#00FF;
450         font-style:italic;}
451 a:link, span.MsoHyperlink
452         {mso-style-parent:"";
453         color:navy;
454         text-decoration:underline;
455         text-underline:single;}
456 a:visited, span.MsoHyperlinkFollowed
457         {mso-style-parent:"";
458         color:maroon;
459         text-decoration:underline;
460         text-underline:single;}
461 span.NumberingSymbols
462         {mso-style-name:"Numbering Symbols";
463         mso-style-parent:"";}
464 span.Bullets
465         {mso-style-name:Bullets;
466         mso-style-parent:"";
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";
484         margin-top:12.0pt;
485         margin-right:0pt;
486         margin-bottom:6.0pt;
487         margin-left:0pt;
488         mso-pagination:none;
489         page-break-after:avoid;
490         mso-hyphenate:none;
491         font-size:14.0pt;
492         font-family:Albany;
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;
498         margin-top:6.0pt;
499         margin-right:0pt;
500         margin-bottom:6.0pt;
501         margin-left:0pt;
502         mso-pagination:no-line-numbers;
503         mso-hyphenate:none;
504         font-size:10.0pt;
505         font-family:Thorndale;
506         mso-fareast-font-family:"Andale Sans UI";
507         mso-bidi-font-family:Tahoma;
508         mso-fareast-language:#00FF;
509         font-style:italic;}
510 p.Index, li.Index, div.Index
511         {mso-style-name:Index;
512         margin-top:7.2pt;
513         margin-right:0pt;
514         margin-bottom:7.2pt;
515         margin-left:0pt;
516         mso-pagination:no-line-numbers;
517         mso-hyphenate:none;
518         font-size:12.0pt;
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;
526         margin-top:12.0pt;
527         margin-right:0pt;
528         margin-bottom:6.0pt;
529         margin-left:0pt;
530         mso-pagination:no-line-numbers;
531         page-break-after:avoid;
532         mso-hyphenate:none;
533         font-size:16.0pt;
534         font-family:Albany;
535         mso-fareast-font-family:"MS Mincho";
536         mso-bidi-font-family:Tahoma;
537         mso-fareast-language:#00FF;
538         font-weight:bold;}
539 p.PreformattedText, li.PreformattedText, div.PreformattedText
540         {mso-style-name:"Preformatted Text";
541         margin:0pt;
542         margin-bottom:.0001pt;
543         mso-pagination:none;
544         mso-hyphenate:none;
545         font-size:10.0pt;
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";
552         margin-top:7.2pt;
553         margin-right:0pt;
554         margin-bottom:7.2pt;
555         margin-left:28.35pt;
556         mso-pagination:none;
557         mso-hyphenate:none;
558         font-size:12.0pt;
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";
566         margin-top:4.3pt;
567         margin-right:0pt;
568         margin-bottom:4.3pt;
569         margin-left:0pt;
570         mso-pagination:none;
571         mso-hyphenate:none;
572         font-size:12.0pt;
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;}
577 span.HeadingChar
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;
583         font-family:Albany;
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;}
591 span.Heading3Char
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;
598         font-family:Albany;
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;
606         font-weight:bold;}
607 p.Header5, li.Header5, div.Header5
608         {mso-style-name:"Header 5";
609         margin-top:7.2pt;
610         margin-right:0pt;
611         margin-bottom:7.2pt;
612         margin-left:0pt;
613         mso-pagination:none;
614         mso-hyphenate:none;
615         font-size:12.0pt;
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;
622         margin-top:7.2pt;
623         margin-right:0pt;
624         margin-bottom:7.2pt;
625         margin-left:0pt;
626         mso-pagination:none;
627         mso-hyphenate:none;
628         font-size:12.0pt;
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;}
633 span.Heading4Char
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;
644         font-weight:bold;}
645 p.Default, li.Default, div.Default
646         {mso-style-name:Default;
647         mso-style-parent:"";
648         margin:0pt;
649         margin-bottom:.0001pt;
650         mso-pagination:widow-orphan;
651         mso-layout-grid-align:none;
652         text-autospace:none;
653         font-size:12.0pt;
654         font-family:Arial;
655         mso-fareast-font-family:"MS Mincho";
656         color:black;}
657 span.BodyTextChar
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 */
671  @page
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;}
677 @page Section1
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;
682         mso-paper-source:0;}
683 div.Section1
684         {page:Section1;
685         mso-footnote-position:beneath-text;}
686 @page Section2
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;
692         mso-paper-source:0;}
693 div.Section2
694         {page:Section2;}
695  /* List Definitions */
696  @list l0
697         {mso-list-id:-132;
698         mso-list-type:simple;
699         mso-list-template-ids:-1234375184;}
700 @list l0:level1
701         {mso-level-tab-stop:90.0pt;
702         mso-level-number-position:left;
703         margin-left:90.0pt;
704         text-indent:-18.0pt;}
705 @list l1
706         {mso-list-id:-131;
707         mso-list-type:simple;
708         mso-list-template-ids:1628742212;}
709 @list l1:level1
710         {mso-level-tab-stop:72.0pt;
711         mso-level-number-position:left;
712         margin-left:72.0pt;
713         text-indent:-18.0pt;}
714 @list l2
715         {mso-list-id:-130;
716         mso-list-type:simple;
717         mso-list-template-ids:1598849380;}
718 @list l2:level1
719         {mso-level-tab-stop:54.0pt;
720         mso-level-number-position:left;
721         margin-left:54.0pt;
722         text-indent:-18.0pt;}
723 @list l3
724         {mso-list-id:-129;
725         mso-list-type:simple;
726         mso-list-template-ids:-1708084928;}
727 @list l3:level1
728         {mso-level-tab-stop:36.0pt;
729         mso-level-number-position:left;
730         text-indent:-18.0pt;}
731 @list l4
732         {mso-list-id:-128;
733         mso-list-type:simple;
734         mso-list-template-ids:-573116274;}
735 @list l4:level1
736         {mso-level-number-format:bullet;
737         mso-level-text:\F0B7;
738         mso-level-tab-stop:90.0pt;
739         mso-level-number-position:left;
740         margin-left:90.0pt;
741         text-indent:-18.0pt;
742         font-family:Symbol;}
743 @list l5
744         {mso-list-id:-127;
745         mso-list-type:simple;
746         mso-list-template-ids:-1674157402;}
747 @list l5:level1
748         {mso-level-number-format:bullet;
749         mso-level-text:\F0B7;
750         mso-level-tab-stop:72.0pt;
751         mso-level-number-position:left;
752         margin-left:72.0pt;
753         text-indent:-18.0pt;
754         font-family:Symbol;}
755 @list l6
756         {mso-list-id:-126;
757         mso-list-type:simple;
758         mso-list-template-ids:-855098526;}
759 @list l6:level1
760         {mso-level-number-format:bullet;
761         mso-level-text:\F0B7;
762         mso-level-tab-stop:54.0pt;
763         mso-level-number-position:left;
764         margin-left:54.0pt;
765         text-indent:-18.0pt;
766         font-family:Symbol;}
767 @list l7
768         {mso-list-id:-125;
769         mso-list-type:simple;
770         mso-list-template-ids:1629288942;}
771 @list l7:level1
772         {mso-level-number-format:bullet;
773         mso-level-text:\F0B7;
774         mso-level-tab-stop:36.0pt;
775         mso-level-number-position:left;
776         text-indent:-18.0pt;
777         font-family:Symbol;}
778 @list l8
779         {mso-list-id:-120;
780         mso-list-type:simple;
781         mso-list-template-ids:1092749420;}
782 @list l8:level1
783         {mso-level-tab-stop:18.0pt;
784         mso-level-number-position:left;
785         margin-left:18.0pt;
786         text-indent:-18.0pt;}
787 @list l9
788         {mso-list-id:-119;
789         mso-list-type:simple;
790         mso-list-template-ids:-593317242;}
791 @list l9:level1
792         {mso-level-number-format:bullet;
793         mso-level-text:\F0B7;
794         mso-level-tab-stop:18.0pt;
795         mso-level-number-position:left;
796         margin-left:18.0pt;
797         text-indent:-18.0pt;
798         font-family:Symbol;}
799 @list l10
800         {mso-list-id:1;
801         mso-list-template-ids:1148726518;}
802 @list l10:level1
803         {mso-level-tab-stop:18.0pt;
804         mso-level-number-position:left;
805         margin-left:18.0pt;
806         text-indent:-18.0pt;
807         mso-ansi-font-size:9.0pt;
808         mso-bidi-font-size:9.0pt;}
809 @list l10:level2
810         {mso-level-number-format:bullet;
811         mso-level-text:\F0B7;
812         mso-level-tab-stop:28.35pt;
813         mso-level-number-position:left;
814         margin-left:28.35pt;
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;}
821 @list l10:level3
822         {mso-level-number-format:bullet;
823         mso-level-text:\F0B7;
824         mso-level-tab-stop:42.5pt;
825         mso-level-number-position:left;
826         margin-left:42.5pt;
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;}
833 @list l10:level4
834         {mso-level-number-format:bullet;
835         mso-level-text:\F0B7;
836         mso-level-tab-stop:56.7pt;
837         mso-level-number-position:left;
838         margin-left:56.7pt;
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;}
845 @list l10:level5
846         {mso-level-number-format:bullet;
847         mso-level-text:\F0B7;
848         mso-level-tab-stop:70.85pt;
849         mso-level-number-position:left;
850         margin-left:70.85pt;
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;}
857 @list l10:level6
858         {mso-level-number-format:bullet;
859         mso-level-text:\F0B7;
860         mso-level-tab-stop:85.05pt;
861         mso-level-number-position:left;
862         margin-left:85.05pt;
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;}
869 @list l10:level7
870         {mso-level-number-format:bullet;
871         mso-level-text:\F0B7;
872         mso-level-tab-stop:99.2pt;
873         mso-level-number-position:left;
874         margin-left:99.2pt;
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;}
881 @list l10:level8
882         {mso-level-number-format:bullet;
883         mso-level-text:\F0B7;
884         mso-level-tab-stop:113.4pt;
885         mso-level-number-position:left;
886         margin-left:113.4pt;
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;}
893 @list l10:level9
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;}
905 @list l11
906         {mso-list-id:2;
907         mso-list-template-ids:2;}
908 @list l11:level1
909         {mso-level-number-format:bullet;
910         mso-level-text:\F0B7;
911         mso-level-tab-stop:14.15pt;
912         mso-level-number-position:left;
913         margin-left:14.15pt;
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;}
920 @list l11:level2
921         {mso-level-number-format:bullet;
922         mso-level-text:\F0B7;
923         mso-level-tab-stop:28.35pt;
924         mso-level-number-position:left;
925         margin-left:28.35pt;
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;}
932 @list l11:level3
933         {mso-level-number-format:bullet;
934         mso-level-text:\F0B7;
935         mso-level-tab-stop:42.5pt;
936         mso-level-number-position:left;
937         margin-left:42.5pt;
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;}
944 @list l11:level4
945         {mso-level-number-format:bullet;
946         mso-level-text:\F0B7;
947         mso-level-tab-stop:56.7pt;
948         mso-level-number-position:left;
949         margin-left:56.7pt;
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;}
956 @list l11:level5
957         {mso-level-number-format:bullet;
958         mso-level-text:\F0B7;
959         mso-level-tab-stop:70.85pt;
960         mso-level-number-position:left;
961         margin-left:70.85pt;
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;}
968 @list l11:level6
969         {mso-level-number-format:bullet;
970         mso-level-text:\F0B7;
971         mso-level-tab-stop:85.05pt;
972         mso-level-number-position:left;
973         margin-left:85.05pt;
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;}
980 @list l11:level7
981         {mso-level-number-format:bullet;
982         mso-level-text:\F0B7;
983         mso-level-tab-stop:99.2pt;
984         mso-level-number-position:left;
985         margin-left:99.2pt;
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;}
992 @list l11:level8
993         {mso-level-number-format:bullet;
994         mso-level-text:\F0B7;
995         mso-level-tab-stop:113.4pt;
996         mso-level-number-position:left;
997         margin-left:113.4pt;
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;}
1004 @list l11:level9
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;}
1016 @list l12
1017         {mso-list-id:3;
1018         mso-list-template-ids:3;}
1019 @list l12:level1
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;}
1031 @list l12:level2
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;}
1043 @list l12:level3
1044         {mso-level-number-format:bullet;
1045         mso-level-text:\F0B7;
1046         mso-level-tab-stop:42.5pt;
1047         mso-level-number-position:left;
1048         margin-left:42.5pt;
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;}
1055 @list l12:level4
1056         {mso-level-number-format:bullet;
1057         mso-level-text:\F0B7;
1058         mso-level-tab-stop:56.7pt;
1059         mso-level-number-position:left;
1060         margin-left:56.7pt;
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;}
1067 @list l12:level5
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;}
1079 @list l12:level6
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;}
1091 @list l12:level7
1092         {mso-level-number-format:bullet;
1093         mso-level-text:\F0B7;
1094         mso-level-tab-stop:99.2pt;
1095         mso-level-number-position:left;
1096         margin-left:99.2pt;
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;}
1103 @list l12:level8
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;}
1115 @list l12:level9
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;}
1127 @list l13
1128         {mso-list-id:4;
1129         mso-list-template-ids:4;}
1130 @list l13:level1
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;}
1142 @list l13:level2
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;}
1154 @list l13:level3
1155         {mso-level-number-format:bullet;
1156         mso-level-text:\F0B7;
1157         mso-level-tab-stop:42.5pt;
1158         mso-level-number-position:left;
1159         margin-left:42.5pt;
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;}
1166 @list l13:level4
1167         {mso-level-number-format:bullet;
1168         mso-level-text:\F0B7;
1169         mso-level-tab-stop:56.7pt;
1170         mso-level-number-position:left;
1171         margin-left:56.7pt;
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;}
1178 @list l13:level5
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;}
1190 @list l13:level6
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;}
1202 @list l13:level7
1203         {mso-level-number-format:bullet;
1204         mso-level-text:\F0B7;
1205         mso-level-tab-stop:99.2pt;
1206         mso-level-number-position:left;
1207         margin-left:99.2pt;
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;}
1214 @list l13:level8
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;}
1226 @list l13:level9
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;}
1238 @list l14
1239         {mso-list-id:5;
1240         mso-list-template-ids:5;}
1241 @list l14:level1
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;}
1253 @list l14:level2
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;}
1265 @list l14:level3
1266         {mso-level-number-format:bullet;
1267         mso-level-text:\F0B7;
1268         mso-level-tab-stop:42.5pt;
1269         mso-level-number-position:left;
1270         margin-left:42.5pt;
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;}
1277 @list l14:level4
1278         {mso-level-number-format:bullet;
1279         mso-level-text:\F0B7;
1280         mso-level-tab-stop:56.7pt;
1281         mso-level-number-position:left;
1282         margin-left:56.7pt;
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;}
1289 @list l14:level5
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;}
1301 @list l14:level6
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;}
1313 @list l14:level7
1314         {mso-level-number-format:bullet;
1315         mso-level-text:\F0B7;
1316         mso-level-tab-stop:99.2pt;
1317         mso-level-number-position:left;
1318         margin-left:99.2pt;
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;}
1325 @list l14:level8
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;}
1337 @list l14:level9
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;}
1349 @list l15
1350         {mso-list-id:6;
1351         mso-list-template-ids:6;}
1352 @list l15:level1
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;}
1364 @list l15:level2
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;}
1376 @list l15:level3
1377         {mso-level-number-format:bullet;
1378         mso-level-text:\F0B7;
1379         mso-level-tab-stop:42.5pt;
1380         mso-level-number-position:left;
1381         margin-left:42.5pt;
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;}
1388 @list l15:level4
1389         {mso-level-number-format:bullet;
1390         mso-level-text:\F0B7;
1391         mso-level-tab-stop:56.7pt;
1392         mso-level-number-position:left;
1393         margin-left:56.7pt;
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;}
1400 @list l15:level5
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;}
1412 @list l15:level6
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;}
1424 @list l15:level7
1425         {mso-level-number-format:bullet;
1426         mso-level-text:\F0B7;
1427         mso-level-tab-stop:99.2pt;
1428         mso-level-number-position:left;
1429         margin-left:99.2pt;
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;}
1436 @list l15:level8
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;}
1448 @list l15:level9
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;}
1460 @list l16
1461         {mso-list-id:7;
1462         mso-list-template-ids:7;}
1463 @list l16:level1
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;}
1475 @list l16:level2
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;}
1487 @list l16:level3
1488         {mso-level-number-format:bullet;
1489         mso-level-text:\F0B7;
1490         mso-level-tab-stop:42.5pt;
1491         mso-level-number-position:left;
1492         margin-left:42.5pt;
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;}
1499 @list l16:level4
1500         {mso-level-number-format:bullet;
1501         mso-level-text:\F0B7;
1502         mso-level-tab-stop:56.7pt;
1503         mso-level-number-position:left;
1504         margin-left:56.7pt;
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;}
1511 @list l16:level5
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;}
1523 @list l16:level6
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;}
1535 @list l16:level7
1536         {mso-level-number-format:bullet;
1537         mso-level-text:\F0B7;
1538         mso-level-tab-stop:99.2pt;
1539         mso-level-number-position:left;
1540         margin-left:99.2pt;
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;}
1547 @list l16:level8
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;}
1559 @list l16:level9
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;}
1571 @list l17
1572         {mso-list-id:8;
1573         mso-list-template-ids:8;}
1574 @list l17:level1
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;}
1586 @list l17:level2
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;}
1598 @list l17:level3
1599         {mso-level-number-format:bullet;
1600         mso-level-text:\F0B7;
1601         mso-level-tab-stop:42.5pt;
1602         mso-level-number-position:left;
1603         margin-left:42.5pt;
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;}
1610 @list l17:level4
1611         {mso-level-number-format:bullet;
1612         mso-level-text:\F0B7;
1613         mso-level-tab-stop:56.7pt;
1614         mso-level-number-position:left;
1615         margin-left:56.7pt;
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;}
1622 @list l17:level5
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;}
1634 @list l17:level6
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;}
1646 @list l17:level7
1647         {mso-level-number-format:bullet;
1648         mso-level-text:\F0B7;
1649         mso-level-tab-stop:99.2pt;
1650         mso-level-number-position:left;
1651         margin-left:99.2pt;
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;}
1658 @list l17:level8
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;}
1670 @list l17:level9
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;}
1682 @list l18
1683         {mso-list-id:9;
1684         mso-list-template-ids:9;}
1685 @list l18:level1
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;}
1697 @list l18:level2
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;}
1709 @list l18:level3
1710         {mso-level-number-format:bullet;
1711         mso-level-text:\F0B7;
1712         mso-level-tab-stop:42.5pt;
1713         mso-level-number-position:left;
1714         margin-left:42.5pt;
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;}
1721 @list l18:level4
1722         {mso-level-number-format:bullet;
1723         mso-level-text:\F0B7;
1724         mso-level-tab-stop:56.7pt;
1725         mso-level-number-position:left;
1726         margin-left:56.7pt;
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;}
1733 @list l18:level5
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;}
1745 @list l18:level6
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;}
1757 @list l18:level7
1758         {mso-level-number-format:bullet;
1759         mso-level-text:\F0B7;
1760         mso-level-tab-stop:99.2pt;
1761         mso-level-number-position:left;
1762         margin-left:99.2pt;
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;}
1769 @list l18:level8
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;}
1781 @list l18:level9
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;}
1793 @list l19
1794         {mso-list-id:10;
1795         mso-list-template-ids:10;}
1796 @list l19:level1
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;}
1808 @list l19:level2
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;}
1820 @list l19:level3
1821         {mso-level-number-format:bullet;
1822         mso-level-text:\F0B7;
1823         mso-level-tab-stop:42.5pt;
1824         mso-level-number-position:left;
1825         margin-left:42.5pt;
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;}
1832 @list l19:level4
1833         {mso-level-number-format:bullet;
1834         mso-level-text:\F0B7;
1835         mso-level-tab-stop:56.7pt;
1836         mso-level-number-position:left;
1837         margin-left:56.7pt;
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;}
1844 @list l19:level5
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;}
1856 @list l19:level6
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;}
1868 @list l19:level7
1869         {mso-level-number-format:bullet;
1870         mso-level-text:\F0B7;
1871         mso-level-tab-stop:99.2pt;
1872         mso-level-number-position:left;
1873         margin-left:99.2pt;
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;}
1880 @list l19:level8
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;}
1892 @list l19:level9
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;}
1904 @list l20
1905         {mso-list-id:11;
1906         mso-list-template-ids:11;}
1907 @list l20:level1
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;}
1919 @list l20:level2
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;}
1931 @list l20:level3
1932         {mso-level-number-format:bullet;
1933         mso-level-text:\F0B7;
1934         mso-level-tab-stop:42.5pt;
1935         mso-level-number-position:left;
1936         margin-left:42.5pt;
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;}
1943 @list l20:level4
1944         {mso-level-number-format:bullet;
1945         mso-level-text:\F0B7;
1946         mso-level-tab-stop:56.7pt;
1947         mso-level-number-position:left;
1948         margin-left:56.7pt;
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;}
1955 @list l20:level5
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;}
1967 @list l20:level6
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;}
1979 @list l20:level7
1980         {mso-level-number-format:bullet;
1981         mso-level-text:\F0B7;
1982         mso-level-tab-stop:99.2pt;
1983         mso-level-number-position:left;
1984         margin-left:99.2pt;
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;}
1991 @list l20:level8
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;}
2003 @list l20:level9
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;}
2015 @list l21
2016         {mso-list-id:12;
2017         mso-list-template-ids:12;}
2018 @list l21:level1
2019         {mso-level-number-format:none;
2020         mso-level-text:"";
2021         mso-level-tab-stop:0pt;
2022         mso-level-number-position:left;
2023         margin-left:0pt;
2024         text-indent:0pt;}
2025 @list l21:level2
2026         {mso-level-number-format:none;
2027         mso-level-text:"";
2028         mso-level-tab-stop:0pt;
2029         mso-level-number-position:left;
2030         margin-left:0pt;
2031         text-indent:0pt;}
2032 @list l21:level3
2033         {mso-level-number-format:none;
2034         mso-level-text:"";
2035         mso-level-tab-stop:0pt;
2036         mso-level-number-position:left;
2037         margin-left:0pt;
2038         text-indent:0pt;}
2039 @list l21:level4
2040         {mso-level-number-format:none;
2041         mso-level-text:"";
2042         mso-level-tab-stop:0pt;
2043         mso-level-number-position:left;
2044         margin-left:0pt;
2045         text-indent:0pt;}
2046 @list l21:level5
2047         {mso-level-number-format:none;
2048         mso-level-text:"";
2049         mso-level-tab-stop:0pt;
2050         mso-level-number-position:left;
2051         margin-left:0pt;
2052         text-indent:0pt;}
2053 @list l21:level6
2054         {mso-level-number-format:none;
2055         mso-level-text:"";
2056         mso-level-tab-stop:0pt;
2057         mso-level-number-position:left;
2058         margin-left:0pt;
2059         text-indent:0pt;}
2060 @list l21:level7
2061         {mso-level-number-format:none;
2062         mso-level-text:"";
2063         mso-level-tab-stop:0pt;
2064         mso-level-number-position:left;
2065         margin-left:0pt;
2066         text-indent:0pt;}
2067 @list l21:level8
2068         {mso-level-number-format:none;
2069         mso-level-text:"";
2070         mso-level-tab-stop:0pt;
2071         mso-level-number-position:left;
2072         margin-left:0pt;
2073         text-indent:0pt;}
2074 @list l21:level9
2075         {mso-level-number-format:none;
2076         mso-level-text:"";
2077         mso-level-tab-stop:0pt;
2078         mso-level-number-position:left;
2079         margin-left:0pt;
2080         text-indent:0pt;}
2081 @list l22
2082         {mso-list-id:116531205;
2083         mso-list-template-ids:-1288027304;}
2084 @list l22:level1
2085         {mso-level-text:"%1\)";
2086         mso-level-tab-stop:36.0pt;
2087         mso-level-number-position:left;
2088         text-indent:-18.0pt;}
2089 @list l23
2090         {mso-list-id:276641855;
2091         mso-list-template-ids:67698719;}
2092 @list l23:level1
2093         {mso-level-tab-stop:18.0pt;
2094         mso-level-number-position:left;
2095         margin-left:18.0pt;
2096         text-indent:-18.0pt;}
2097 @list l23:level2
2098         {mso-level-text:"%1\.%2\.";
2099         mso-level-tab-stop:39.6pt;
2100         mso-level-number-position:left;
2101         margin-left:39.6pt;
2102         text-indent:-21.6pt;}
2103 @list l23:level3
2104         {mso-level-text:"%1\.%2\.%3\.";
2105         mso-level-tab-stop:72.0pt;
2106         mso-level-number-position:left;
2107         margin-left:61.2pt;
2108         text-indent:-25.2pt;}
2109 @list l23:level4
2110         {mso-level-text:"%1\.%2\.%3\.%4\.";
2111         mso-level-tab-stop:90.0pt;
2112         mso-level-number-position:left;
2113         margin-left:86.4pt;
2114         text-indent:-32.4pt;}
2115 @list l23:level5
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;}
2121 @list l23:level6
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;}
2127 @list l23:level7
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;}
2133 @list l23:level8
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;}
2139 @list l23:level9
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;}
2145 @list l24
2146         {mso-list-id:291328403;
2147         mso-list-template-ids:1148726518;}
2148 @list l24:level1
2149         {mso-level-tab-stop:18.0pt;
2150         mso-level-number-position:left;
2151         margin-left:18.0pt;
2152         text-indent:-18.0pt;
2153         mso-ansi-font-size:9.0pt;
2154         mso-bidi-font-size:9.0pt;}
2155 @list l24:level2
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;}
2167 @list l24:level3
2168         {mso-level-number-format:bullet;
2169         mso-level-text:\F0B7;
2170         mso-level-tab-stop:42.5pt;
2171         mso-level-number-position:left;
2172         margin-left:42.5pt;
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;}
2179 @list l24:level4
2180         {mso-level-number-format:bullet;
2181         mso-level-text:\F0B7;
2182         mso-level-tab-stop:56.7pt;
2183         mso-level-number-position:left;
2184         margin-left:56.7pt;
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;}
2191 @list l24:level5
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;}
2203 @list l24:level6
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;}
2215 @list l24:level7
2216         {mso-level-number-format:bullet;
2217         mso-level-text:\F0B7;
2218         mso-level-tab-stop:99.2pt;
2219         mso-level-number-position:left;
2220         margin-left:99.2pt;
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;}
2227 @list l24:level8
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;}
2239 @list l24:level9
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;}
2251 @list l25
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;}
2255 @list l25:level1
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;}
2265 @list l26
2266         {mso-list-id:604534799;
2267         mso-list-template-ids:1659901228;}
2268 @list l26:level1
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;}
2275 @list l26:level2
2276         {mso-level-number-format:bullet;
2277         mso-level-text:o;
2278         mso-level-tab-stop:72.0pt;
2279         mso-level-number-position:left;
2280         text-indent:-18.0pt;
2281         font-family:"Courier New";}
2282 @list l26:level3
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;}
2289 @list l26:level4
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;}
2296 @list l26:level5
2297         {mso-level-number-format:bullet;
2298         mso-level-text:o;
2299         mso-level-tab-stop:180.0pt;
2300         mso-level-number-position:left;
2301         text-indent:-18.0pt;
2302         font-family:"Courier New";}
2303 @list l26:level6
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;}
2310 @list l26:level7
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;}
2317 @list l26:level8
2318         {mso-level-number-format:bullet;
2319         mso-level-text:o;
2320         mso-level-tab-stop:288.0pt;
2321         mso-level-number-position:left;
2322         text-indent:-18.0pt;
2323         font-family:"Courier New";}
2324 @list l26:level9
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;}
2331 @list l27
2332         {mso-list-id:671564588;
2333         mso-list-template-ids:67698719;}
2334 @list l27:level1
2335         {mso-level-tab-stop:18.0pt;
2336         mso-level-number-position:left;
2337         margin-left:18.0pt;
2338         text-indent:-18.0pt;}
2339 @list l27:level2
2340         {mso-level-text:"%1\.%2\.";
2341         mso-level-tab-stop:39.6pt;
2342         mso-level-number-position:left;
2343         margin-left:39.6pt;
2344         text-indent:-21.6pt;}
2345 @list l27:level3
2346         {mso-level-text:"%1\.%2\.%3\.";
2347         mso-level-tab-stop:72.0pt;
2348         mso-level-number-position:left;
2349         margin-left:61.2pt;
2350         text-indent:-25.2pt;}
2351 @list l27:level4
2352         {mso-level-text:"%1\.%2\.%3\.%4\.";
2353         mso-level-tab-stop:90.0pt;
2354         mso-level-number-position:left;
2355         margin-left:86.4pt;
2356         text-indent:-32.4pt;}
2357 @list l27:level5
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;}
2363 @list l27:level6
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;}
2369 @list l27:level7
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;}
2375 @list l27:level8
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;}
2381 @list l27:level9
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;}
2387 @list l28
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;}
2391 @list l28:level1
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;}
2398 @list l29
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;}
2402 @list l29:level1
2403         {mso-level-text:"%1\)";
2404         mso-level-tab-stop:36.0pt;
2405         mso-level-number-position:left;
2406         text-indent:-18.0pt;}
2407 @list l30
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;}
2411 @list l30:level1
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;}
2418 @list l31
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;}
2422 @list l31:level1
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;}
2429 @list l32
2430         {mso-list-id:858816198;
2431         mso-list-template-ids:1148726518;}
2432 @list l32:level1
2433         {mso-level-tab-stop:18.0pt;
2434         mso-level-number-position:left;
2435         margin-left:18.0pt;
2436         text-indent:-18.0pt;
2437         mso-ansi-font-size:9.0pt;
2438         mso-bidi-font-size:9.0pt;}
2439 @list l32:level2
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;}
2451 @list l32:level3
2452         {mso-level-number-format:bullet;
2453         mso-level-text:\F0B7;
2454         mso-level-tab-stop:42.5pt;
2455         mso-level-number-position:left;
2456         margin-left:42.5pt;
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;}
2463 @list l32:level4
2464         {mso-level-number-format:bullet;
2465         mso-level-text:\F0B7;
2466         mso-level-tab-stop:56.7pt;
2467         mso-level-number-position:left;
2468         margin-left:56.7pt;
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;}
2475 @list l32:level5
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;}
2487 @list l32:level6
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;}
2499 @list l32:level7
2500         {mso-level-number-format:bullet;
2501         mso-level-text:\F0B7;
2502         mso-level-tab-stop:99.2pt;
2503         mso-level-number-position:left;
2504         margin-left:99.2pt;
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;}
2511 @list l32:level8
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;}
2523 @list l32:level9
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;}
2535 @list l33
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;}
2539 @list l33:level1
2540         {mso-level-tab-stop:36.0pt;
2541         mso-level-number-position:left;
2542         text-indent:-18.0pt;}
2543 @list l34
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;}
2547 @list l34:level1
2548         {mso-level-tab-stop:36.0pt;
2549         mso-level-number-position:left;
2550         text-indent:-18.0pt;}
2551 @list l35
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;}
2555 @list l35:level1
2556         {mso-level-tab-stop:36.0pt;
2557         mso-level-number-position:left;
2558         text-indent:-18.0pt;}
2559 @list l36
2560         {mso-list-id:1320424235;
2561         mso-list-template-ids:-1854628230;}
2562 @list l36:level1
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;}
2569 @list l36:level2
2570         {mso-level-number-format:bullet;
2571         mso-level-text:o;
2572         mso-level-tab-stop:72.0pt;
2573         mso-level-number-position:left;
2574         text-indent:-18.0pt;
2575         font-family:"Courier New";}
2576 @list l36:level3
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;}
2583 @list l36:level4
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;}
2590 @list l36:level5
2591         {mso-level-number-format:bullet;
2592         mso-level-text:o;
2593         mso-level-tab-stop:180.0pt;
2594         mso-level-number-position:left;
2595         text-indent:-18.0pt;
2596         font-family:"Courier New";}
2597 @list l36:level6
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;}
2604 @list l36:level7
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;}
2611 @list l36:level8
2612         {mso-level-number-format:bullet;
2613         mso-level-text:o;
2614         mso-level-tab-stop:288.0pt;
2615         mso-level-number-position:left;
2616         text-indent:-18.0pt;
2617         font-family:"Courier New";}
2618 @list l36:level9
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;}
2625 @list l37
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;}
2629 @list l37:level1
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;}
2636 @list l38
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;}
2640 @list l38:level1
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;}
2650 @list l39
2651         {mso-list-id:1678120386;
2652         mso-list-template-ids:58764522;}
2653 @list l39:level1
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;}
2660 @list l39:level2
2661         {mso-level-number-format:bullet;
2662         mso-level-text:o;
2663         mso-level-tab-stop:72.0pt;
2664         mso-level-number-position:left;
2665         text-indent:-18.0pt;
2666         font-family:"Courier New";}
2667 @list l39:level3
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;}
2674 @list l39:level4
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;}
2681 @list l39:level5
2682         {mso-level-number-format:bullet;
2683         mso-level-text:o;
2684         mso-level-tab-stop:180.0pt;
2685         mso-level-number-position:left;
2686         text-indent:-18.0pt;
2687         font-family:"Courier New";}
2688 @list l39:level6
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;}
2695 @list l39:level7
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;}
2702 @list l39:level8
2703         {mso-level-number-format:bullet;
2704         mso-level-text:o;
2705         mso-level-tab-stop:288.0pt;
2706         mso-level-number-position:left;
2707         text-indent:-18.0pt;
2708         font-family:"Courier New";}
2709 @list l39:level9
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;}
2716 @list l40
2717         {mso-list-id:1740133347;
2718         mso-list-template-ids:-5492374;}
2719 @list l40:level1
2720         {mso-level-text:"%1\)";
2721         mso-level-tab-stop:18.0pt;
2722         mso-level-number-position:left;
2723         margin-left:18.0pt;
2724         text-indent:-18.0pt;}
2725 @list l40:level2
2726         {mso-level-number-format:alpha-lower;
2727         mso-level-tab-stop:54.0pt;
2728         mso-level-number-position:left;
2729         margin-left:54.0pt;
2730         text-indent:-18.0pt;}
2731 @list l40:level3
2732         {mso-level-number-format:roman-lower;
2733         mso-level-tab-stop:90.0pt;
2734         mso-level-number-position:right;
2735         margin-left:90.0pt;
2736         text-indent:-9.0pt;}
2737 @list l40:level4
2738         {mso-level-tab-stop:126.0pt;
2739         mso-level-number-position:left;
2740         margin-left:126.0pt;
2741         text-indent:-18.0pt;}
2742 @list l40:level5
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;}
2748 @list l40:level6
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;}
2754 @list l40:level7
2755         {mso-level-tab-stop:234.0pt;
2756         mso-level-number-position:left;
2757         margin-left:234.0pt;
2758         text-indent:-18.0pt;}
2759 @list l40:level8
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;}
2765 @list l40:level9
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;}
2771 @list l41
2772         {mso-list-id:1781024997;
2773         mso-list-template-ids:67698719;}
2774 @list l41:level1
2775         {mso-level-tab-stop:18.0pt;
2776         mso-level-number-position:left;
2777         margin-left:18.0pt;
2778         text-indent:-18.0pt;}
2779 @list l41:level2
2780         {mso-level-text:"%1\.%2\.";
2781         mso-level-tab-stop:39.6pt;
2782         mso-level-number-position:left;
2783         margin-left:39.6pt;
2784         text-indent:-21.6pt;}
2785 @list l41:level3
2786         {mso-level-text:"%1\.%2\.%3\.";
2787         mso-level-tab-stop:72.0pt;
2788         mso-level-number-position:left;
2789         margin-left:61.2pt;
2790         text-indent:-25.2pt;}
2791 @list l41:level4
2792         {mso-level-text:"%1\.%2\.%3\.%4\.";
2793         mso-level-tab-stop:90.0pt;
2794         mso-level-number-position:left;
2795         margin-left:86.4pt;
2796         text-indent:-32.4pt;}
2797 @list l41:level5
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;}
2803 @list l41:level6
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;}
2809 @list l41:level7
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;}
2815 @list l41:level8
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;}
2821 @list l41:level9
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;}
2827 @list l42
2828         {mso-list-id:1834448678;
2829         mso-list-template-ids:-5492374;}
2830 @list l42:level1
2831         {mso-level-text:"%1\)";
2832         mso-level-tab-stop:18.0pt;
2833         mso-level-number-position:left;
2834         margin-left:18.0pt;
2835         text-indent:-18.0pt;}
2836 @list l42:level2
2837         {mso-level-number-format:alpha-lower;
2838         mso-level-tab-stop:54.0pt;
2839         mso-level-number-position:left;
2840         margin-left:54.0pt;
2841         text-indent:-18.0pt;}
2842 @list l42:level3
2843         {mso-level-number-format:roman-lower;
2844         mso-level-tab-stop:90.0pt;
2845         mso-level-number-position:right;
2846         margin-left:90.0pt;
2847         text-indent:-9.0pt;}
2848 @list l42:level4
2849         {mso-level-tab-stop:126.0pt;
2850         mso-level-number-position:left;
2851         margin-left:126.0pt;
2852         text-indent:-18.0pt;}
2853 @list l42:level5
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;}
2859 @list l42:level6
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;}
2865 @list l42:level7
2866         {mso-level-tab-stop:234.0pt;
2867         mso-level-number-position:left;
2868         margin-left:234.0pt;
2869         text-indent:-18.0pt;}
2870 @list l42:level8
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;}
2876 @list l42:level9
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;}
2882 @list l43
2883         {mso-list-id:1954169307;
2884         mso-list-template-ids:986222236;}
2885 @list l43:level1
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;}
2892 @list l43:level2
2893         {mso-level-number-format:bullet;
2894         mso-level-text:o;
2895         mso-level-tab-stop:72.0pt;
2896         mso-level-number-position:left;
2897         text-indent:-18.0pt;
2898         font-family:"Courier New";}
2899 @list l43:level3
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;}
2906 @list l43:level4
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;}
2913 @list l43:level5
2914         {mso-level-number-format:bullet;
2915         mso-level-text:o;
2916         mso-level-tab-stop:180.0pt;
2917         mso-level-number-position:left;
2918         text-indent:-18.0pt;
2919         font-family:"Courier New";}
2920 @list l43:level6
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;}
2927 @list l43:level7
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;}
2934 @list l43:level8
2935         {mso-level-number-format:bullet;
2936         mso-level-text:o;
2937         mso-level-tab-stop:288.0pt;
2938         mso-level-number-position:left;
2939         text-indent:-18.0pt;
2940         font-family:"Courier New";}
2941 @list l43:level9
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;}
2948 @list l44
2949         {mso-list-id:2000840094;
2950         mso-list-template-ids:519993794;}
2951 @list l44:level1
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;}
2958 @list l44:level2
2959         {mso-level-number-format:bullet;
2960         mso-level-text:o;
2961         mso-level-tab-stop:72.0pt;
2962         mso-level-number-position:left;
2963         text-indent:-18.0pt;
2964         font-family:"Courier New";}
2965 @list l44:level3
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;}
2972 @list l44:level4
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;}
2979 @list l44:level5
2980         {mso-level-number-format:bullet;
2981         mso-level-text:o;
2982         mso-level-tab-stop:180.0pt;
2983         mso-level-number-position:left;
2984         text-indent:-18.0pt;
2985         font-family:"Courier New";}
2986 @list l44:level6
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;}
2993 @list l44:level7
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;}
3000 @list l44:level8
3001         {mso-level-number-format:bullet;
3002         mso-level-text:o;
3003         mso-level-tab-stop:288.0pt;
3004         mso-level-number-position:left;
3005         text-indent:-18.0pt;
3006         font-family:"Courier New";}
3007 @list l44:level9
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;}
3014 @list l45
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;}
3018 @list l45:level1
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;}
3025 ol
3026         {margin-bottom:0pt;}
3027 ul
3028         {margin-bottom:0pt;}
3029 -->
3030 </style>
3031 <!--[if gte mso 10]>
3032 <style>
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;
3044         font-size:10.0pt;
3045         font-family:"Times New Roman";
3046         mso-ansi-language:#0400;
3047         mso-fareast-language:#0400;
3048         mso-bidi-language:#0400;}
3049 table.MsoTable3DFx1
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;
3061         mso-hyphenate:none;
3062         font-size:10.0pt;
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;
3073         color:purple;
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;
3124         color:navy;}
3125 table.MsoTableWeb1
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;
3140         mso-hyphenate:none;
3141         font-size:10.0pt;
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;
3151         color:windowtext;}
3152 table.MsoTableWeb3
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;
3166         mso-hyphenate:none;
3167         font-size:10.0pt;
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;
3177         color:windowtext;}
3178 table.MsoTableGrid
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;
3192         mso-hyphenate:none;
3193         font-size:10.0pt;
3194         font-family:"Times New Roman";
3195         mso-ansi-language:#0400;
3196         mso-fareast-language:#0400;
3197         mso-bidi-language:#0400;}
3198 </style>
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]-->
3205 </head>
3206
3207 <body lang=EN-US link=navy vlink=maroon style='tab-interval:35.45pt;line-break:
3208 strict'>
3209
3210 <div class=Section1>
3211
3212 <p class=MsoTitle>OpenAFS for Windows 1.4.0<br>
3213 Release Notes</p>
3214
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>
3230
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>
3241
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>
3252
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>
3263
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>
3269
3270 <p class=MsoToc1><!--[if supportFields]><span style='mso-element:field-begin'></span><span
3271 style='mso-spacerun:yes'> </span>TOC \o &quot;1-1&quot; \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>
3292
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>
3312
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>
3332
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>
3353
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>
3373
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>
3394
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>
3414
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>
3434
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>
3439
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
3443 forms:</p>
3444
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
3449 </span></span></span><![endif]>an executable (.exe) that is built using the
3450 Nullsoft Scriptable Installation System, or</p>
3451
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
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
3458 (see <a
3459 href="#_MSI_Deployment_Guide">MSI
3460 Deployment Guide</a>)</p>
3461
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>
3465
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>
3469
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
3475 Windows 2000 Workstation</p>
3476
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
3482 Windows 2000 Server</p>
3483
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
3489 Windows XP Home</p>
3490
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
3496 Windows XP Professional</p>
3497
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
3503 Windows 2003 Server</p>
3504
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
3510 Windows 2003 R2 Server</p>
3511
3512 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416101">2.1.1 Unsupported
3513 Operating Systems</a></h3>
3514
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
3520 Windows 95</p>
3521
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
3527 Windows 98</p>
3528
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
3534 Windows 98 OSR2</p>
3535
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
3541 Windows ME</p>
3542
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
3548 NT</p>
3549
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Microsoft
3555 Windows Vista (as of Beta 1 bugs in Windows prevent its use)</p>
3556
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>All
3562 64-bit versions of Microsoft Windows on Itanium and x86-64 chipsets.</p>
3563
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
3568 4.0 is 1.2.10.</p>
3569
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>
3572
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>
3576
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>
3580
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>
3583
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>
3587
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>
3591
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>
3600
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 &quot;Kerberos 5&quot; <![endif]--><!--[if supportFields]><span
3611 style='mso-element:field-end'></span><![endif]--></p>
3612
3613 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416106">3.1.1. Active
3614 Directory</a></h3>
3615
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 &quot;Active Directory&quot; <![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 &quot;DES enctypes&quot; <![endif]--><!--[if supportFields]><span
3633 style='mso-element:field-end'></span><![endif]--></p>
3634
3635 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416107">3.1.2. Using
3636 the krb524 service</a></h3>
3637
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>
3650
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>
3657
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 ACL’s 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 &quot;Kerberos 5&quot; <![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 &quot;krb524&quot; <![endif]--><!--[if supportFields]><span
3671 style='mso-element:field-end'></span><![endif]--></p>
3672
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>
3676
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'> 
3686 </span></p>
3687
3688 <p class=MsoNormal>The MLA is installed with a name of &quot;AFS&quot; 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 &quot;Client
3693 Microsoft Networks&quot;, 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 &quot;File and Printer
3696 Sharing ...&quot; there will be a service type collision between the name
3697 &quot;AFS&quot; 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 &quot;NET
3699 VIEW \\AFS&quot; command will return a &quot;System Error 52&quot;
3700 message.<span style='mso-spacerun:yes'>  </span>To correct the problem:</p>
3701
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
3707 style='mso-spacerun:yes'> </span>stop the AFS Client Service</p>
3708
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
3714 style='mso-spacerun:yes'> </span>bind the &quot;Client for Microsoft
3715 Networks&quot; to the MLA</p>
3716
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
3722 style='mso-spacerun:yes'> </span>unbind &quot;File and Printer Sharing for
3723 Microsoft Networks&quot; from the MLA</p>
3724
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
3730 style='mso-spacerun:yes'> </span>Disable and then re-enable the MLA</p>
3731
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]><span
3737 style='mso-spacerun:yes'> </span>start the AFS Client Service</p>
3738
3739 <p class=MsoNormal>When the MLA is not installed the unique NETBIOS name
3740 published by OpenAFS SMB server is &quot;<i>MACHINE</i>-AFS&quot;.<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 &quot;AFS&quot; 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 &quot;loopback&quot; <![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 &quot;UNC paths&quot; <![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 &quot;NETBIOS&quot; <![endif]--><!--[if supportFields]><span
3755 style='mso-element:field-end'></span><![endif]--></p>
3756
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>
3760
3761 <p class=MsoNormal>Traditionally, when the OpenAFS Client Service starts it
3762 must be able to access the &quot;root.afs&quot; volume of the default
3763 cell.<span style='mso-spacerun:yes'>  </span>The &quot;root.afs&quot; volume
3764 contains the set of mount points to the &quot;root.cell&quot; volumes of
3765 various cells the administrator of the default cell believes should be accessible.<span
3766 style='mso-spacerun:yes'>  </span>If the &quot;root.afs&quot; 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 &quot;root.afs&quot; volume for the default cell is not reachable and the
3772 OpenAFS Client Service will not successfully start. </p>
3773
3774 <p class=MsoNormal>To allow the OpenAFS Client Service to operate in these
3775 environments, a fake &quot;root.afs&quot; 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
3778 Freelance mode.</p>
3779
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 &quot;root.afs&quot; 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 &quot;root.cell&quot; 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 &quot;root.afs&quot;
3787 volume.<span style='mso-spacerun:yes'>  </span>If the cellname begins with a
3788 &quot;.&quot; 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>
3791
3792 <p class=PreformattedText style='margin-left:35.45pt'><a
3793 href="#_Regkey:_[HKLMSOFTWAREOpenAFSClie">HKLM\SOFTWARE\OpenAFS\Client\Freelance</a></p>
3794
3795 <p class=MsoNormal>Additional mount points may be manually created using the
3796 &quot;fs mkmount&quot; command.<span style='mso-spacerun:yes'>  </span>Mount
3797 points may be removed using the &quot;fs rmmount&quot; command.</p>
3798
3799 <p class=PreformattedText style='margin-left:35.45pt'>&gt;fs mkmount
3800 \\AFS\athena.mit.edu root.cell athena.mit.edu</p>
3801
3802 <p class=PreformattedText style='margin-left:35.45pt'>&gt;fs mkmount
3803 \\AFS\.athena.mit.edu root.cell athena.mit.edu -rw</p>
3804
3805 <p class=PreformattedText style='margin-left:35.45pt'>&gt;fs rmmount
3806 \\AFS\athena.mit.edu</p>
3807
3808 <p class=PreformattedText style='margin-left:35.45pt'>&gt;fs rmmount
3809 \\AFS\.athena.mit.edu</p>
3810
3811 <p class=MsoNormal>Symlinks may also be created within the Freelance “root.afs”
3812 volume.</p>
3813
3814 <p class=PreformattedText style='margin-left:35.45pt'>&gt;symlink make \\afs\link
3815 \\afs\athena.mit.edu\user\j\a\jaltman</p>
3816
3817 <p class=PreformattedText><span style='mso-tab-count:1'>      </span>&gt;symlink
3818 list \\afs\link</p>
3819
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>
3822
3823 <p class=PreformattedText style='margin-left:35.45pt'>&gt;symlink rm \\afs\link</p>
3824
3825 <p class=MsoNormal>The symlinks are stored in the registry at:</p>
3826
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 &quot;Freelance Mode&quot; <![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 &quot;Dynamic Root&quot; <![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 &quot;fs.exe&quot; <![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 &quot;symlink.exe&quot; <![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 &quot;root.afs&quot; <![endif]--><!--[if supportFields]><span
3842 style='mso-element:field-end'></span><![endif]--><span
3843 style='mso-spacerun:yes'> </span></p>
3844
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>
3848
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 &quot;dns&quot; <![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 &quot;afsdb&quot; <![endif]--><!--[if supportFields]><span
3856 style='mso-element:field-end'></span><![endif]--></p>
3857
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>
3861
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 &quot;jaltman&quot; and the default cell is
3868 &quot;athena.mit.edu&quot;, then Integrated Logon can be successfully used if
3869 the windows password matches the password assigned to the Kerberos principal
3870 &quot;<a href="mailto:jaltman@ATHENA.MIT.EDU">jaltman@ATHENA.MIT.EDU</a>&quot;.<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>
3874
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>
3879
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>
3884
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>
3888
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 &quot;integrated login&quot; <![endif]--><!--[if supportFields]><span
3896 style='mso-element:field-end'></span><![endif]--></p>
3897
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>
3901
3902 <p class=MsoNormal>The AFS System Tray tool (afscreds.exe) supports several
3903 command line options: </p>
3904
3905 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-A =
3906 autoinit </p>
3907
3908 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-E = force
3909 existing afscreds to exit</p>
3910
3911 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-I =
3912 install startup shortcut</p>
3913
3914 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-M = renew
3915 drive maps </p>
3916
3917 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-N = IP
3918 address change detection </p>
3919
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
3922 dialog</p>
3923
3924 <p class=PreformattedText><span style='mso-spacerun:yes'>         </span>if
3925 afsd_service is not already running</p>
3926
3927 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-S = show
3928 tokens dialog on startup</p>
3929
3930 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-U =
3931 uninstall startup shortcut</p>
3932
3933 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-X = test
3934 and do map share</p>
3935
3936 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>-Z = unmap
3937 drives</p>
3938
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
3946 is accessible.</p>
3947
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>
3951
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>
3959 in <a
3960 href="#_Appendix_A:_Registry_Values">Appendix
3961 A</a>.<!--[if supportFields]><span style='mso-element:field-begin'></span> XE
3962 &quot;afscreds.exe&quot; <![endif]--><!--[if supportFields]><span
3963 style='mso-element:field-end'></span><![endif]--></p>
3964
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>
3968
3969 <p class=MsoNormal>The OpenAFS for Windows 1.4 client supports a local Windows
3970 authorization group named &quot;AFS Client Admins&quot;.<span
3971 style='mso-spacerun:yes'>  </span>This group is used in place of the
3972 &quot;Administrators&quot; 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 &quot;AFS Client
3976 Admins&quot; group:</p>
3977
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>checkservers
3983 with a non-zero timer value</p>
3984
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setcachesize</p>
3990
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>newcell</p>
3996
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>sysname
4002 with a new sysname list</p>
4003
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>exportafs</p>
4009
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setcell</p>
4015
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setserverprefs</p>
4021
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>storebehind</p>
4027
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setcrypt</p>
4033
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>cscpolicy</p>
4039
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>trace</p>
4045
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
4048 Admins” group.</p>
4049
4050 <p class=MsoNormal>The initial membership of the &quot;AFS Client Admins&quot;
4051 group when created by the installer is equivalent to the local
4052 &quot;Administrators&quot; group.<span style='mso-spacerun:yes'>  </span>If a
4053 user is added to the &quot;Administrators&quot; group after the creation of the
4054 &quot;AFS Client Admin&quot; 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 &quot;AFS Client Admins&quot; group are AFS Client
4057 Administrators.<span style='mso-spacerun:yes'>  </span>The local
4058 &quot;SYSTEM&quot; account is an implicit member of the &quot;AFS Client
4059 Admins&quot; group.</p>
4060
4061 <p class=MsoNormal>Setting the default sysname for a machine should be done via
4062 the <a
4063 href="#_Value_:_SysName">registry</a>
4064 and not via &quot;fs sysname&quot;.<!--[if supportFields]><span
4065 style='mso-element:field-begin'></span> XE &quot;AFS Client Admins&quot; <![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 &quot;fs.exe&quot; <![endif]--><!--[if supportFields]><span
4069 style='mso-element:field-end'></span><![endif]--></p>
4070
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>
4074
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 &quot;UNC paths&quot; <![endif]--><!--[if supportFields]><span
4082 style='mso-element:field-end'></span><![endif]--><span
4083 style='mso-spacerun:yes'>  </span></p>
4084
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>
4096
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 &quot;JP Software&quot; <![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 &quot;4nt.exe&quot; <![endif]--><!--[if supportFields]><span
4102 style='mso-element:field-end'></span><![endif]--></p>
4103
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>
4107
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>
4113
4114 <p class=PreformattedText>Usage: aklog [-d] [[-cell | -c] cell [-k krb_realm]]</p>
4115
4116 <p class=PreformattedText><span style='mso-spacerun:yes'>            
4117 </span>[[-p | -path] pathname]</p>
4118
4119 <p class=PreformattedText><span style='mso-spacerun:yes'>            
4120 </span>[-noprdb] [-force]</p>
4121
4122 <p class=PreformattedText><span style='mso-spacerun:yes'>            
4123 </span>[-5 [-m]| -4]</p>
4124
4125 <p class=PreformattedText><o:p>&nbsp;</o:p></p>
4126
4127 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>-d = output
4128 debugging information.</p>
4129
4130 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>cell = zero
4131 or more cells for which tokens will be obtained</p>
4132
4133 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>krb_realm =
4134 the kerberos realm of the cell.</p>
4135
4136 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>pathname =
4137 the directory for which authentication is required</p>
4138
4139 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>-noprdb =
4140 don't try to determine AFS ID.</p>
4141
4142 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>-5 or -4 =
4143 use Kerberos V (default) or Kerberos IV tickets</p>
4144
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 &quot;aklog.exe&quot; <![endif]--><!--[if supportFields]><span
4148 style='mso-element:field-end'></span><![endif]--></p>
4149
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>
4153
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>
4159
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>
4162
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </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>
4171
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </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 &quot;AFS Servers&quot; <![endif]--><!--[if supportFields]><span
4181 style='mso-element:field-end'></span><![endif]--></p>
4182
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>
4186
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
4192 versions are:</p>
4193
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>whether
4199 or not the binaries were compiled with optimization</p>
4200
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>whether
4206 the debug symbols are installed by default</p>
4207
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </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 &quot;Symbol files&quot; <![endif]--><!--[if supportFields]><span
4215 style='mso-element:field-end'></span><![endif]--></p>
4216
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>
4220
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 &quot;large file support&quot; <![endif]--><!--[if supportFields]><span
4227 style='mso-element:field-end'></span><![endif]--></p>
4228
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>
4232
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 &quot;fcrypt&quot; mode.</p>
4237
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>
4241
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'>   
4247 </span></p>
4248
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 &quot;cifs/afs@REALM&quot; (if the loopback adapter is in use) or
4252 &quot;cifs/machine-afs@REALM&quot; (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>
4260
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>
4264
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
4269 (see <a
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>
4276
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>
4282
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>
4286
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>
4294
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>
4298
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>
4303
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>
4312
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>
4320
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>
4324
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>
4333
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
4339 A</a>.)</p>
4340
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>
4344
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>
4350
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>
4354
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 &quot;.&quot; are
4359 automatically given the Hidden attribute so they will not normally be
4360 displayed.</p>
4361
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>
4365
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>
4376
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>
4381
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>
4385
4386 <p class=MsoNormal>&quot;Netbios over TCP/IP&quot; 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 &quot;Netbios over TCP/IP&quot; is
4389 disabled on the machine, then communication with the AFS Client Service will be
4390 impossible.</p>
4391
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>
4395
4396 <p class=MsoNormal>The OpenAFS Client Service and related binaries distributed
4397 by OpenAFS.org are digitally signed by &quot;Secure Endpoints Inc.&quot;.<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'> 
4406 </span></p>
4407
4408 <p class=MsoNormal><a
4409 href="#_Appendix_A:_Registry_Values">Appendix
4410 A</a> documents the &quot;<a
4411 href="#_Value___: VerifyServiceSignature">VerifyServiceSignature</a>&quot;
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>
4414
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>
4418
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>
4426
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>
4430
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
4441 characters:</p>
4442
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;
4448   height:399.5pt'>
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
4455   cedilla</p>
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
4460   diaeresis</p>
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
4465   acute</p>
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
4470   circumflex</p>
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
4475   diaeresis</p>
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
4480   grave</p>
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
4485   ring</p>
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
4490   cedilla</p>
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
4495   circumflex</p>
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
4500   diaeresis</p>
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
4505   grave</p>
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
4510   diaeresis</p>
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
4515   circumflex</p>
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
4520   grave</p>
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
4525   diaeresis</p>
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
4530   ring</p>
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
4535   acute</p>
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
4550   circumflex</p>
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
4555   diaeresis</p>
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
4560   grave</p>
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
4565   circumflex</p>
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
4570   grave</p>
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
4575   diaeresis</p>
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
4580   diaeresis</p>
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
4585   diaeresis</p>
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
4590   slash</p>
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
4600   slash</p>
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>
4611   </td>
4612  </tr>
4613 </table>
4614
4615 <p class=PreformattedText><o:p>&nbsp;</o:p></p>
4616
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>
4625
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>
4629
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>
4638
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>
4642
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>
4649
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>
4657
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>
4661
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>
4664
4665 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>afsdacl :
4666 Set or reset the DACL to allow starting or stopping</p>
4667
4668 <p class=PreformattedText><span style='mso-spacerun:yes'>         </span>the
4669 afsd service by any ordinary user.</p>
4670
4671 <p class=PreformattedText><o:p>&nbsp;</o:p></p>
4672
4673 <p class=PreformattedText><span style='mso-spacerun:yes'>    </span>Usage :
4674 afsdacl [-set | -reset] [-show]</p>
4675
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>
4679
4680 <p class=PreformattedText><span style='mso-spacerun:yes'>         
4681 </span>-reset : Reset the DACL</p>
4682
4683 <p class=PreformattedText><span style='mso-spacerun:yes'>         
4684 </span>-show<span style='mso-spacerun:yes'>  </span>: Show current DACL (SDSF)</p>
4685
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>
4689
4690 <p class=MsoNormal>The default @sys name list in OpenAFS 1.4 is set to
4691 &quot;x86_win32 i386_w2k i386_nt40&quot; for 32-bit x86 systems.<span
4692 style='mso-spacerun:yes'>  </span>The default for itanium will be
4693 &quot;ia64_win64&quot; and &quot;amd64_win64&quot; for amd 64-bit processors
4694 when those platforms are supported.</p>
4695
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>
4699
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>
4703
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>
4707
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>
4711
4712 <p class=PreformattedText>Usage: cmdebug -servers &lt;server machine&gt; [-port
4713 &lt;IP port&gt;] [-long]</p>
4714
4715 <p class=PreformattedText><span style='mso-spacerun:yes'>              
4716 </span>[-addrs] [-cache] [-help]</p>
4717
4718 <p class=PreformattedText>Where: -long<span style='mso-spacerun:yes'>  
4719 </span>print all info</p>
4720
4721 <p class=PreformattedText><span style='mso-spacerun:yes'>      
4722 </span>-addrs<span style='mso-spacerun:yes'>  </span>print only host interfaces</p>
4723
4724 <p class=PreformattedText><span style='mso-spacerun:yes'>      
4725 </span>-cache<span style='mso-spacerun:yes'>  </span>print only cache
4726 configuration</p>
4727
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>
4731
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>
4736
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>
4740
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 &quot;<a
4747 href="#_Regkey:_[HKLMSOFTWAREOpenAFSClie_2">Server
4748 Preferences</a>&quot; keys.</p>
4749
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>
4753
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>
4766
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>
4775
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>
4779
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 &quot;rpcrt4.dll&quot;:</p>
4783
4784 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>HKLM
4785 &quot;SOFTWARE\Microsoft\RPC\ClientProtocols&quot; &quot;ncacn_np&quot;</p>
4786
4787 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>HKLM
4788 &quot;SOFTWARE\Microsoft\RPC\ClientProtocols&quot; &quot;ncacn_ip_tcp&quot;</p>
4789
4790 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>HKLM
4791 &quot;SOFTWARE\Microsoft\RPC\ClientProtocols&quot; &quot;ncadg_ip_udp&quot;</p>
4792
4793 <p class=PreformattedText><span style='mso-spacerun:yes'>   </span>HKLM
4794 &quot;SOFTWARE\Microsoft\RPC\ClientProtocols&quot; &quot;ncacn_http&quot;</p>
4795
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>
4799
4800 <p class=MsoNormal>OpenAFS 1.4 adds a new command, &quot;fs
4801 minidump&quot;.<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>
4806
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>
4810
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
4820 process.</p>
4821
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>
4826
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>
4831
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>
4840
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>
4844
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4850 tokens<span style='mso-spacerun:yes'>  </span>(tokens.exe, aklog.exe,
4851 afscreds.exe)</p>
4852
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4858 ACLs </p>
4859
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4865 cache parameters</p>
4866
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>flushing
4872 files or volumes</p>
4873
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4879 server preferences</p>
4880
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>querying
4886 path location</p>
4887
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>checking
4893 the status of servers and volumes</p>
4894
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>setting/querying
4900 the sysname list</p>
4901
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>
4907
4908 <p class=MsoNormal>To assist in debugging these problems, the registry value:</p>
4909
4910 <p class=PreformattedText><span style='mso-spacerun:yes'> 
4911 </span>[HKLM\SOFTWARE\OpenAFS\Client]</p>
4912
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>
4916
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>
4926
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>
4930
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>
4942
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>
4950
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} -&gt;%WinDir%\TEMP\afsd.log)</span></a></h2>
4954
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
4963 value</a>:</p>
4964
4965 <p class=PreformattedText><span style='mso-spacerun:yes'> 
4966 </span>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
4967
4968 <p class=PreformattedText><span style='mso-spacerun:yes'> 
4969 </span>REG_DWORD<span style='mso-spacerun:yes'>  </span>TraceBufferSize </p>
4970
4971 <p class=MsoNormal>A restart of the service is necessary when adjusting this
4972 value.<span style='mso-spacerun:yes'>   </span>Execute &quot;fs trace -on&quot;
4973 to clear to the log and &quot;fs trace -dump&quot; to output the contents of
4974 the log to the file.</p>
4975
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 SysInternal’s DbgView and FileMon Tools</span></a></h2>
4979
4980 <p class=MsoNormal>An alternatve option to the use of &quot;fs trace -dump&quot;
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
4984 2 of the <a
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'> 
4988 </span></p>
4989
4990 <p class=PreformattedText><span style='mso-spacerun:yes'> 
4991 </span>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
4992
4993 <p class=PreformattedText style='text-indent:12.0pt'>REG_DWORD<span
4994 style='mso-spacerun:yes'>   </span>TraceOption = 0x04</p>
4995
4996 <p class=MsoNormal>Use “fs trace –on” and “fs trace –off” to toggle the
4997 generation of log messages. </p>
4998
4999 <p class=MsoNormal>Sysinternal’s 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>
5004
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>
5010
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
5013 MiniDumps <br>
5014 (fs minidump -&gt; %WinDir%\TEMP\afsd.dmp)</span></a></h2>
5015
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 &quot;fs minidump&quot; 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>
5022
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>
5026
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>
5031 registry value:</p>
5032
5033 <p class=PreformattedText><span style='mso-spacerun:yes'> 
5034 </span>[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</p>
5035
5036 <p class=PreformattedText><span style='mso-spacerun:yes'> 
5037 </span>REG_DWORD<span style='mso-spacerun:yes'>   </span>TraceOption = 0x01</p>
5038
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&quot;.</p>
5042
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>
5046
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>
5051
5052 <p class=PreformattedText>Usage: rxdebug -servers &lt;server machine&gt; [-port
5053 &lt;IP port&gt;] [-nodally] </p>
5054
5055 <p class=PreformattedText style='margin-left:35.45pt;text-indent:35.45pt'><span
5056 style='mso-spacerun:yes'>   </span>[-allconnections] [-rxstats] [-onlyserver]
5057 [-onlyclient] </p>
5058
5059 <p class=PreformattedText style='margin-left:70.9pt'><span
5060 style='mso-spacerun:yes'>   </span>[-onlyport &lt;show only &lt;port&gt;&gt;] </p>
5061
5062 <p class=PreformattedText style='margin-left:70.9pt'><span
5063 style='mso-spacerun:yes'>   </span>[-onlyhost &lt;show only &lt;host&gt;&gt;] </p>
5064
5065 <p class=PreformattedText style='margin-left:70.9pt'><span
5066 style='mso-spacerun:yes'>   </span>[-onlyauth &lt;show only &lt;auth
5067 level&gt;&gt;] [-version] </p>
5068
5069 <p class=PreformattedText style='margin-left:70.9pt'><span
5070 style='mso-spacerun:yes'>   </span>[-noconns] [-peers] [-help]</p>
5071
5072 <p class=PreformattedText>Where: -nodally<span
5073 style='mso-spacerun:yes'>         </span>don't show dallying conns</p>
5074
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>
5078
5079 <p class=PreformattedText><span style='mso-spacerun:yes'>      
5080 </span>-rxstats<span style='mso-spacerun:yes'>         </span>show Rx
5081 statistics</p>
5082
5083 <p class=PreformattedText><span style='mso-spacerun:yes'>      
5084 </span>-onlyserver<span style='mso-spacerun:yes'>      </span>only show server
5085 conns</p>
5086
5087 <p class=PreformattedText><span style='mso-spacerun:yes'>      
5088 </span>-onlyclient<span style='mso-spacerun:yes'>      </span>only show client
5089 conns</p>
5090
5091 <p class=PreformattedText><span style='mso-spacerun:yes'>      
5092 </span>-version<span style='mso-spacerun:yes'>         </span>show AFS version
5093 id</p>
5094
5095 <p class=PreformattedText><span style='mso-spacerun:yes'>      
5096 </span>-noconns<span style='mso-spacerun:yes'>         </span>show no
5097 connections</p>
5098
5099 <p class=PreformattedText><span style='mso-spacerun:yes'>      
5100 </span>-peers<span style='mso-spacerun:yes'>           </span>show peers</p>
5101
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>
5105
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>
5108
5109 <p class=PreformattedText>Usage: cmdebug -servers &lt;server machine&gt; [-port
5110 &lt;IP port&gt;] [-long] </p>
5111
5112 <p class=PreformattedText style='margin-left:70.9pt'><span
5113 style='mso-spacerun:yes'>   </span>[-refcounts] [-callbacks] [-addrs] [-cache]
5114 [-help]</p>
5115
5116 <p class=PreformattedText>Where: -long<span style='mso-spacerun:yes'>      
5117 </span>print all info</p>
5118
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>
5122
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>
5126
5127 <p class=PreformattedText><span style='mso-spacerun:yes'>      
5128 </span>-addrs<span style='mso-spacerun:yes'>      </span>print only host
5129 interfaces</p>
5130
5131 <p class=PreformattedText><span style='mso-spacerun:yes'>      
5132 </span>-cache<span style='mso-spacerun:yes'>      </span>print only cache
5133 configuration</p>
5134
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>
5138
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>
5143
5144 <p class=PreformattedText><span style='mso-spacerun:yes'> 
5145 </span>afsd_service.exe --validate-cache &lt;cache-path&gt;</p>
5146
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>
5150
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
5162 from this file.</p>
5163
5164 <p class=MsoNormal>Configuring DrWatson to generate dump files for crashes:</p>
5165
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Run
5171 drwtsn32.exe to configure or to identify where the log and the crash dump files
5172 are created: </p>
5173
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>click
5179 Start &gt; Run...<span style='mso-spacerun:yes'>  </span></p>
5180
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>type
5186 drwtsn32 &lt;enter&gt;. </p>
5187
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Select
5193 either a Crash Dump Type: Mini or Full. </p>
5194
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Clear
5200 Dump Symbol Table</p>
5201
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Clear
5207 Append to Existing Log file. </p>
5208
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Check
5214 Dump All Thread Contexts.</p>
5215
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Check
5221 Create Crash Dump File</p>
5222
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Next
5228 run the monitoring module of Dr. Watson: </p>
5229
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>click
5235 Start &gt; Run...</p>
5236
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>type
5242 drwatson &lt;enter&gt;. </p>
5243
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </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>
5251
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>
5254
5255 <p class=MsoNormal>When reporting a error, please be sure to include the
5256 version of OpenAFS.</p>
5257
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>
5262
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>
5267
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>
5271
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>
5277
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'>
5281
5282 <table cellspacing=0 cellpadding=0 hspace=0 vspace=0 width=540 height=88>
5283  <tr>
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>
5291    <br>
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>
5294   </td>
5295  </tr>
5296 </table>
5297
5298 </div>
5299
5300 <![if !supportTextWrap]><br clear=ALL>
5301 <![endif]>
5302
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>
5306
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>
5310
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>
5319
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>
5323
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>
5327
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>
5331
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>
5346
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>
5350
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>
5356
5357 <h2 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115417097">6.5.
5358 OpenAFS for Windows Mailing Lists</a></h2>
5359
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>
5363 mailing list.</p>
5364
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>
5366
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>
5370
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>
5372
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>
5375
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>
5383
5384 </div>
5385
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'>
5390 </span></b>
5391
5392 <div class=Section2>
5393
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>
5396
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>
5401
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>
5409
5410 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416160">7.1.1
5411 Requirements</a></h3>
5412
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>
5418
5419 <p class=MsoNormal>Authoring a &quot;Windows Installer&quot; 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 (&quot;Windows
5423 Installer&quot; SDK) can be used for this purpose.</p>
5424
5425 <p class=MsoNormal>For reference, the schema for the MSI package is based on
5426 SCHEMA.MSI distributed with the Platform SDK.</p>
5427
5428 <p class=MsoNormal>For general information about &quot;Windows Installer&quot;,
5429 refer to:</p>
5430
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>
5433
5434 <p class=MsoNormal>For general information about authoring MSI transforms,
5435 refer to:</p>
5436
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>
5439
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>
5446
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>
5449
5450 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416161">7.1.2 Authoring
5451 a Transform</a></h3>
5452
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
5458 example:</p>
5459
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"'>&nbsp;&nbsp;&nbsp;
5463 </span></span><![endif]>copy openafs.msi openafs-modified.msi</p>
5464
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"'>&nbsp;&nbsp;&nbsp;
5468 </span></span><![endif]>(edit the openafs-modified.msi to include the necessary
5469 changes)</p>
5470
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"'>&nbsp;&nbsp;&nbsp;
5474 </span></span><![endif]>msitran -g openafs.msi openafs-modified.msi
5475 openafs-transform.mst</p>
5476
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"'>&nbsp;&nbsp;&nbsp;
5480 </span></span><![endif]>(generates openafs-transform.mst, which is the
5481 transform)</p>
5482
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 &quot;Windows Installer&quot; SDK (part of the Windows Platform SDK).</p>
5486
5487 <p class=MsoNormal>You can test a transform by:</p>
5488
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"'>&nbsp;&nbsp;&nbsp;
5492 </span></span><![endif]>copy openafs.msi openafs-test.msi</p>
5493
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"'>&nbsp;&nbsp;&nbsp;
5497 </span></span><![endif]>msitran -a openafs-transform.mst openafs-test.msi</p>
5498
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>
5503
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>
5507
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>
5511
5512 <p class=MsoNormal>The logic necessary to implement many of the settings
5513 described in <a
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>
5521
5522 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416163">7.2.1
5523 Configurable Properties</a></h3>
5524
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
5534 the MSI.</p>
5535
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>
5540
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
5544 A</a>.</p>
5545
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>
5549
5550 <p class=MsoNormal>Numeric values should be authored as decimal strings.</p>
5551
5552 <h4><a name="_Toc115416164">7.2.1.1 Setting Properties</a></h4>
5553
5554 <p class=MsoNormal>In order to set a property,</p>
5555
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
5561 </span></span></span><![endif]>Open the MSI in ORCA.EXE</p>
5562
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
5568 </span></span></span><![endif]>Select the 'Property' table from the list of
5569 tables on the left.</p>
5570
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
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>
5578
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
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
5586 desired value.</p>
5587
5588 <h4><a name="_Toc115416165">7.2.1.2 OpenAFS for Windows Properties</a></h4>
5589
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>
5600   </td>
5601  </tr>
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>
5608   </td>
5609  </tr>
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>
5617   </td>
5618  </tr>
5619 </table>
5620
5621 <h5><a name="_Toc115416169">7.2.1.2.1 Registry Properties</a></h5>
5622
5623 <p class=MsoNormal>These properties are used to set the values of registry
5624 entries associated with OpenAFS for Windows.</p>
5625
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
5635   parameters)</a></p>
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>
5640   </td>
5641  </tr>
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
5647   parameters)</a></p>
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>:
5651   numeric</p>
5652   </td>
5653  </tr>
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
5659   parameters)</a></p>
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>:
5663   string</p>
5664   </td>
5665  </tr>
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
5671   parameters)</a></p>
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'
5675   or '0'</p>
5676   </td>
5677  </tr>
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
5683   parameters)</a></p>
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'
5687   or '0'</p>
5688   </td>
5689  </tr>
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
5695   provider)</a></p>
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'
5699   or '3'</p>
5700   <p class=MsoNormal>See <a
5701   href="#_Appendix_A:_Registry_Values">Appendix
5702   A</a> <a
5703   href="#_A.2.1_Domain_specific_configuration">section
5704   2.1 (Domain specific configuration keys for Network Provider)</a> for more
5705   details.</p>
5706   </td>
5707  </tr>
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
5713   parameters)</a></p>
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>:
5717   string</p>
5718   </td>
5719  </tr>
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
5725   parameters)</a></p>
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>
5730   </td>
5731  </tr>
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
5737   parameters)</a></p>
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'
5741   or '0'</p>
5742   </td>
5743  </tr>
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
5749   parameters)</a></p>
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>:
5753   numeric</p>
5754   </td>
5755  </tr>
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
5761   parameters)</a></p>
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'
5765   or '0'</p>
5766   </td>
5767  </tr>
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
5773   parameters)</a></p>
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>:
5777   '0','1' or '2'</p>
5778   </td>
5779  </tr>
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
5785   Client)</a></p>
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
5789   '1'</p>
5790   </td>
5791  </tr>
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
5797   parameters)</a></p>
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'
5801   or '0'</p>
5802   </td>
5803  </tr>
5804 </table>
5805
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>
5808
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>
5817
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>
5831   </td>
5832  </tr>
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'
5837   or ''</p>
5838   <p class=MsoList>Enables automatic initialization.</p>
5839   </td>
5840  </tr>
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'
5845   or ''</p>
5846   <p class=MsoList>Enables IP address change detection.</p>
5847   </td>
5848  </tr>
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'
5853   or ''</p>
5854   <p class=MsoList>Enables quiet mode.</p>
5855   </td>
5856  </tr>
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'
5861   or '’</p>
5862   <p class=MsoList>Enables renewing drive map at startup.</p>
5863   </td>
5864  </tr>
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'
5869   or ''</p>
5870   <p class=MsoList>Enables displaying the credential manager window when
5871   AFSCREDS starts up.</p>
5872   </td>
5873  </tr>
5874 </table>
5875
5876 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416191">7.2.2
5877 Existing Registry Entries</a></h3>
5878
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>
5885
5886 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416192">7.2.3
5887 Replacing Configuration Files</a></h3>
5888
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
5892 individually.</p>
5893
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>
5899
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>
5903
5904 <p class=MsoNormal>The walkthrough below is to add a custom 'CellServDB' file.</p>
5905
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Disable
5911 the component that contains the configuration file that you want to replace.</p>
5912
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"'>&nbsp;&nbsp; </span></span></span><![endif]>Locate
5918 and select the 'Component' table in the 'Tables' list.</p>
5919
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"'>&nbsp;&nbsp; </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>
5931
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"'>&nbsp;&nbsp; </span></span></span><![endif]>Go
5937 to the 'Condition' column of the component.</p>
5938
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"'>&nbsp;&nbsp; </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>
5946
5947 <p class=MsoNormal>Note that you can also use this step to disable other
5948 configuration files without providing replacements.</p>
5949
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Add
5954 a new component containing the new configuration file.</p>
5955
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"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
5960 the 'Component' table in the 'Tables' list.</p>
5961
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"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
5966 'Tables'-&gt;'Add Row' (Ctrl-R).</p>
5967
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"'>&nbsp;&nbsp; </span></span></span><![endif]>Enter
5972 the following :</p>
5973
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>
5982   </td>
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>
5987   </td>
5988  </tr>
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>
5994   </td>
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>
6000   </td>
6001  </tr>
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>
6007   </td>
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>
6013   </td>
6014  </tr>
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>
6020   </td>
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>
6026   </td>
6027  </tr>
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>
6033   </td>
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>&nbsp;</o:p></p>
6039   </td>
6040  </tr>
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>
6046   </td>
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>
6052   </td>
6053  </tr>
6054 </table>
6055
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
6059 SDK.</p>
6060
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>
6067
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>
6070
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Add
6075 a new feature to hold the new component.</p>
6076
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"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
6081 the 'Feature' table.</p>
6082
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"'>&nbsp;&nbsp; </span></span></span><![endif]>Add
6087 a new row (Ctrl-R or 'Tables'-&gt;'Add Row') with the following values:</p>
6088
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>
6097   </td>
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>
6102   </td>
6103  </tr>
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>
6109   </td>
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>
6115   </td>
6116  </tr>
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>
6122   </td>
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>&nbsp;</o:p></p>
6128   </td>
6129  </tr>
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>
6135   </td>
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>&nbsp;</o:p></p>
6141   </td>
6142  </tr>
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>
6148   </td>
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>
6154   </td>
6155  </tr>
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>
6161   </td>
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>
6167   </td>
6168  </tr>
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>
6174   </td>
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>&nbsp;</o:p></p>
6180   </td>
6181  </tr>
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>
6187   </td>
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>
6193   </td>
6194  </tr>
6195 </table>
6196
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>
6200
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>
6205
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>
6210
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Join
6215 the component and the feature.</p>
6216
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"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
6221 the 'FeatureComponents' table.</p>
6222
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"'>&nbsp;&nbsp; </span></span></span><![endif]>Add
6227 a new row with the following values:</p>
6228
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>
6237   </td>
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>
6242   </td>
6243  </tr>
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>
6249   </td>
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>
6255   </td>
6256  </tr>
6257 </table>
6258
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Add
6263 an entry to the 'File' table.</p>
6264
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"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
6269 the 'File' table.</p>
6270
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"'>&nbsp;&nbsp; </span></span></span><![endif]>Add
6275 a new row with the following values:</p>
6276
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>
6285   </td>
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>
6290   </td>
6291  </tr>
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>
6297   </td>
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>
6303   </td>
6304  </tr>
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>
6310   </td>
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>
6316   </td>
6317  </tr>
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>
6323   </td>
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>
6329   </td>
6330  </tr>
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>
6336   </td>
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>
6342   </td>
6343  </tr>
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>
6349   </td>
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>
6355   </td>
6356  </tr>
6357 </table>
6358
6359 <p class=MsoNormal><span style='mso-tab-count:1'>            </span><span
6360 style='mso-spacerun:yes'>    </span>(leave other fields blank)</p>
6361
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>
6368
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>
6372
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>Set
6377 a media source for the file.</p>
6378
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"'>&nbsp;&nbsp; </span></span></span><![endif]>Select
6383 the 'Media' table.</p>
6384
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"'>&nbsp;&nbsp; </span></span></span><![endif]>Add
6389 a row with the following values :</p>
6390
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>
6399   </td>
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>
6404   </td>
6405  </tr>
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>
6411   </td>
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>
6417   </td>
6418  </tr>
6419 </table>
6420
6421 <p class=MsoNormal><span style='mso-tab-count:1'>            </span><span
6422 style='mso-spacerun:yes'>    </span>(leave other fields blank)</p>
6423
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>
6426
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>
6429
6430 <p class=PreformattedText style='text-indent:35.45pt'>CellServDB:
6431 'cpf_CellServDB' (ID {D5BA4C15-DBEC-4292-91FC-B54C30F24F2A})</p>
6432
6433 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416194">7.2.4
6434 Adding Domain Specific Registry Keys</a></h3>
6435
6436 <p class=MsoNormal>Following is an example for adding domain specific registry
6437 keys.</p>
6438
6439 <p class=MsoNormal style='tab-stops:204.0pt'><span style='mso-spacerun:yes'>   
6440 </span>Refer to <a
6441 href="#_Appendix_A:_Registry_Values">Appendix
6442 A</a> section 2.1 for more information.</p>
6443
6444 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>Columns that are
6445 unspecified should be left empty.</p>
6446
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>
6449
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>
6457   </td>
6458  </tr>
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:
6470   2'>               </span>: 30<br>
6471   <span style='mso-tab-count:1'>            </span>Attributes<span
6472   style='mso-tab-count:1'>        </span>: 10</p>
6473   </td>
6474  </tr>
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'
6478   table:</p>
6479   </td>
6480  </tr>
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
6485   row)<br>
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>
6496   </td>
6497  </tr>
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>
6502   </td>
6503  </tr>
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>
6512   </td>
6513  </tr>
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'
6517   table:</p>
6518   </td>
6519  </tr>
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:
6526   2'>                </span>: 2<br>
6527   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
6528   2'>                 </span>:
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>
6532   </td>
6533  </tr>
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:
6540   2'>                </span>: 2<br>
6541   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
6542   2'>                 </span>:
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>
6548   </td>
6549  </tr>
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:
6556   2'>                </span>: 2<br>
6557   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
6558   2'>                 </span>:
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>
6564   </td>
6565  </tr>
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:
6572   2'>                </span>: 2<br>
6573   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
6574   2'>                 </span>:
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:
6579   2'>              </span>: 1<br>
6580   <span style='mso-tab-count:1'>            </span>Component<span
6581   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'</p>
6582   </td>
6583  </tr>
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:
6590   2'>                </span>: 2<br>
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>
6597   </td>
6598  </tr>
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:
6605   2'>                </span>: 2<br>
6606   <span style='mso-tab-count:1'>            </span>Key<span style='mso-tab-count:
6607   2'>                 </span>:
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:
6612   2'>              </span>: 0<br>
6613   <span style='mso-tab-count:1'>            </span>Component<span
6614   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'</p>
6615   </td>
6616  </tr>
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:
6623   2'>                </span>: 2<br>
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:
6629   2'>              </span>: 1<br>
6630   <span style='mso-tab-count:1'>            </span>Component<span
6631   style='mso-tab-count:1'>     </span>: 'rcm_DomainKeys'<br style='mso-special-character:
6632   line-break'>
6633   <![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'>
6634   <![endif]></p>
6635   </td>
6636  </tr>
6637 </table>
6638
6639 <p class=MsoNormal><o:p>&nbsp;</o:p></p>
6640
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>
6644
6645 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416195">7.2.5
6646 Adding Site Specific Freelance Registry Keys</a></h3>
6647
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
6650 volume.</p>
6651
6652 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>Columns that are
6653 unspecified should be left empty.</p>
6654
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>
6657
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>
6665   </td>
6666  </tr>
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:
6678   2'>               </span>: 30<br>
6679   <span style='mso-tab-count:1'>            </span>Attributes<span
6680   style='mso-tab-count:1'>        </span>: 10</p>
6681   </td>
6682  </tr>
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'
6686   table:</p>
6687   </td>
6688  </tr>
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>
6703   </td>
6704  </tr>
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>
6709   </td>
6710  </tr>
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>
6719   </td>
6720  </tr>
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'
6724   table:</p>
6725   </td>
6726  </tr>
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:
6733   2'>                </span>: 2<br>
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>
6738   </td>
6739  </tr>
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:
6746   2'>                </span>: 2<br>
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>
6756   </td>
6757  </tr>
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:
6764   2'>                </span>: 2<br>
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>
6775   </td>
6776  </tr>
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:
6783   2'>                </span>: 2<br>
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>
6788   </td>
6789  </tr>
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:
6796   2'>                </span>: 2<br>
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>
6806   </td>
6807  </tr>
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:
6814   2'>                </span>: 2<br>
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>
6824   </td>
6825  </tr>
6826 </table>
6827
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>
6831
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>
6836
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>
6840
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 &quot;Windows
6844 Installer&quot; documentation for details.<span style='mso-spacerun:yes'> 
6845 </span>The relevant section is at :</p>
6846
6847 <p class=MsoNormal>http://msdn.microsoft.com/library/en-us/msi/setup/using_transforms_to_add_resources.asp</p>
6848
6849 <p class=MsoNormal>A sample walkthrough of adding a new configuration file is
6850 in section 2.3.</p>
6851
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>
6860
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
6863 MSI package.</p>
6864
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>
6867
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>
6871
6872 <p class=MsoNormal><span style='mso-spacerun:yes'>    </span>&gt; msitran.exe
6873 -g openafs-en_US.msi openafs-en_US_new.msi openafs-transform.mst</p>
6874
6875 <p class=MsoNormal>See the Platform SDK documentation for information on
6876 command line options for MSITRAN.EXE.</p>
6877
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>
6880
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>
6887
6888 <p class=MsoNormal>Versions of OpenAFS that are upgraded by the MSI package are:</p>
6889
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>OpenAFS
6894 MSI package<br>
6895 Upgrade code {6823EEDD-84FC-4204-ABB3-A80D25779833}<br>
6896 Up to current release</p>
6897
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </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>
6905
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></span><![endif]>OpenAFS
6910 NSIS package<br>
6911 All versions</p>
6912
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>
6919
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>
6923
6924 <p class=MsoNormal>When performing an upgrade with msiexec.exe execute the MSI
6925 with the repair options &quot;vomus&quot;.</p>
6926
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>
6934
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>
6938
6939 <p class=MsoBodyText>The service parameters primarily affect the behavior of
6940 the AFS client service (afsd_service.exe).</p>
6941
6942 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416200">Regkey:<br>
6943 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</a></h3>
6944
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;
6950   height:145.25pt'>
6951   <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416201">Value:
6952   LANadapter</a></h5>
6953   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD<br>
6954   Default: -1<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
6965   will be 'AFS'.</p>
6966   </td>
6967  </tr>
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;
6970   height:79.25pt'>
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>
6978   </td>
6979  </tr>
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;
6982   height:79.25pt'>
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 &lt;&lt; cm_logChunkSize)</p>
6987   <p class=MsoBodyText>Size of chunk for reading and writing. Actual chunk size
6988   is 2^cm_logChunkSize.</p>
6989   </td>
6990  </tr>
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;
6993   height:92.0pt'>
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>
7000   </td>
7001  </tr>
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;
7004   height:92.0pt'>
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>
7011   </td>
7012  </tr>
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;
7015   height:79.25pt'>
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>
7021   </td>
7022  </tr>
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;
7025   height:78.5pt'>
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>
7030   Default : 0</p>
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>
7034   </td>
7035  </tr>
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;
7038   height:79.25pt'>
7039   <h5 style='mso-outline-level:5'><a name="_Toc115416208">Value: RootVolume</a></h5>
7040   <p class=MsoBodyText>Type: REG_SZ<br>
7041   Default: &quot;root.afs&quot;<br>
7042   Variable: cm_rootVolumeName</p>
7043   <p class=MsoBodyText>Root volume name.</p>
7044   </td>
7045  </tr>
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;
7048   height:145.25pt'>
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: &quot;/afs&quot;<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 &quot;/afs&quot;, 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>
7064   </td>
7065  </tr>
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;
7068   height:92.0pt'>
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: &quot;%TEMP%\AFSCache&quot;<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>
7079   </td>
7080  </tr>
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;
7083   height:119.0pt'>
7084   <h5 style='mso-outline-level:5'><a name="_Toc115416211">Value:
7085   NonPersistentCaching</a></h5>
7086   <p class=MsoBodyText>Type: DWORD [0..1]<br>
7087   Default: 0<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 &quot;fs setcachesize&quot; command.</p>
7094   </td>
7095  </tr>
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;
7098   height:125.5pt'>
7099   <h5 style='mso-outline-level:5'><a name="_Toc115416212">Value: ValidateCache</a></h5>
7100   <p class=MsoBodyText>Type: DWORD [0..2]<br>
7101   Default: 1<br>
7102   Variable: buf_CacheType</p>
7103   <p class=MsoBodyText>This value determines if and when persistent cache validation
7104   is performed.</p>
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>
7108   </td>
7109  </tr>
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;
7112   height:79.25pt'>
7113   <h5 style='mso-outline-level:5'><a name="_Toc115416213">Value: TrapOnPanic</a></h5>
7114   <p class=MsoBodyText>Type: DWORD {1,0}<br>
7115   Default: 0<br>
7116   Variable: traceOnPanic</p>
7117   <p class=MsoBodyText>Issues a breakpoint in the event of a panic. (breakpoint:
7118   _asm int 3).</p>
7119   </td>
7120  </tr>
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;
7123   height:92.0pt'>
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: &quot;AFS&quot;<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>&quot;%COMPUTERNAME%-AFS&quot;.</p>
7134   </td>
7135  </tr>
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;
7138   height:152.0pt'>
7139   <h5 style='mso-outline-level:5'><a name="_Toc115416215">Value: IsGateway</a></h5>
7140   <p class=MsoBodyText>Type: DWORD {1,0}<br>
7141   Default: 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 &quot;NetbiosName&quot;
7151   registry value.</p>
7152   </td>
7153  </tr>
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;
7156   height:92.0pt'>
7157   <h5 style='mso-outline-level:5'><a name="_Toc115416216">Value: ReportSessionStartups</a></h5>
7158   <p class=MsoBodyText>Type: DWORD {1,0}<br>
7159   Default: 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
7164   logged.</p>
7165   </td>
7166  </tr>
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;
7169   height:79.25pt'>
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>
7177   </td>
7178  </tr>
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;
7181   height:92.0pt'>
7182   <h5 style='mso-outline-level:5'><a name="_Toc115416218"></a><a
7183   name="_Value_:_SysName"></a><span style='mso-bookmark:_Toc115416218'>Value:
7184   SysName</span></h5>
7185   <p class=MsoBodyText>Type: REG_SZ<br>
7186   Default: &quot;i386_nt40&quot;<br>
7187   Variable: cm_sysName</p>
7188   <p class=MsoBodyText>Provides an initial value for &quot;fs sysname&quot;.<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>
7191   </td>
7192  </tr>
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;
7195   height:79.25pt'>
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>
7200   Default: 0<br>
7201   Variable: cryptall</p>
7202   <p class=MsoBodyText>Enables encryption on RX calls.</p>
7203   </td>
7204  </tr>
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;
7207   height:112.25pt'>
7208   <h5 style='mso-outline-level:5'><a name="_Toc115416220"></a><a
7209   name="_Value_:_UseDNS"></a><span style='mso-bookmark:_Toc115416220'>Value:
7210   UseDNS</span></h5>
7211   <p class=MsoBodyText>Type: DWORD {1,0}<br>
7212   Default: 1<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
7217   above.</p>
7218   </td>
7219  </tr>
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;
7222   height:79.25pt'>
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>
7227   Default: 0<br>
7228   Variable: cm_freelanceEnabled</p>
7229   <p class=MsoBodyText>Enables freelance client.</p>
7230   </td>
7231  </tr>
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;
7234   height:92.0pt'>
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>
7239   Default: 1<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 &quot;.&quot; and &quot;..&quot;).</p>
7244   </td>
7245  </tr>
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;
7248   height:79.25pt'>
7249   <h5 style='mso-outline-level:5'><a name="_Toc115416223">Value: MaxMpxRequests</a></h5>
7250   <p class=MsoBodyText>Type: DWORD<br>
7251   Default: 50<br>
7252   Variable: smb_maxMpxRequests</p>
7253   <p class=MsoBodyText>Maximum number of multiplexed SMB requests that can be
7254   made.</p>
7255   </td>
7256  </tr>
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;
7259   height:79.25pt'>
7260   <h5 style='mso-outline-level:5'><a name="_Toc115416224">Value: MaxVCPerServer</a></h5>
7261   <p class=MsoBodyText>Type: DWORD<br>
7262   Default: 100<br>
7263   Variable: smb_maxVCPerServer</p>
7264   <p class=MsoBodyText>Maximum number of SMB virtual circuits.</p>
7265   </td>
7266  </tr>
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;
7269   height:79.25pt'>
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: &lt;none&gt;<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>
7277   </td>
7278  </tr>
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;
7281   height:79.25pt'>
7282   <h5 style='mso-outline-level:5'><a name="_Toc115416226">Value: RxNoJumbo</a></h5>
7283   <p class=MsoBodyText>Type: DWORD {0,1}<br>
7284   Default: 0<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>
7288   </td>
7289  </tr>
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;
7292   height:124.75pt'>
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>
7297   Default: -1<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>
7303   </td>
7304  </tr>
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;
7307   height:151.75pt'>
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]
7316   SessTimeout</p>
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>
7320   </td>
7321  </tr>
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;
7324   height:92.0pt'>
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>
7333   </td>
7334  </tr>
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;
7337   height:158.5pt'>
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>
7342   Default: 0</p>
7343   <p class=MsoBodyText>Enables logging of debug output to the Windows Event
7344   Log.</p>
7345   <p class=MsoBodyText>Bit 0 enables logging of &quot;Logon Events&quot;
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
7349   Client Service.</p>
7350   <p class=MsoBodyText>Bit 2 enables real-time viewing of &quot;fs trace&quot;
7351   logging with DbgView or similar tools.</p>
7352   <p class=MsoBodyText>Bit 3 enables &quot;fs trace&quot; logging on startup.</p>
7353   </td>
7354  </tr>
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;
7357   height:98.5pt'>
7358   <h5 style='mso-outline-level:5'><a name="_Toc115416231">Value: AllSubmount</a></h5>
7359   <p class=MsoBodyText>Type: DWORD {0, 1}<br>
7360   Default: 1</p>
7361   <p class=MsoBodyText>Variable: allSubmount (smb.c)</p>
7362   <p class=MsoBodyText>By setting this value to 0, the
7363   &quot;\\NetbiosName\all&quot; 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>
7366   </td>
7367  </tr>
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;
7370   height:78.5pt'>
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>
7375   Default: 0</p>
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 &quot;AFS&quot;.</p>
7378   </td>
7379  </tr>
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;
7382   height:78.5pt'>
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
7385   architecture<br>
7386   Default: &lt;no default&gt;</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'> 
7390   </span></p>
7391   </td>
7392  </tr>
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;
7395   height:151.75pt'>
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>
7400   Default: 2</p>
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>
7409   </td>
7410  </tr>
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;
7413   height:92.0pt'>
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>
7418   Default: 100K</p>
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>
7424   </td>
7425  </tr>
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;
7428   height:65.75pt'>
7429   <h5 style='mso-outline-level:5'><a name="_Toc115416236">Value: FlushOnHibernate</a></h5>
7430   <p class=MsoBodyText>Type: DWORD {0,1}<br>
7431   Default: 1</p>
7432   <p class=MsoBodyText>If set, flushes all volumes before the machine goes on
7433   hibernate or stand-by.</p>
7434   </td>
7435  </tr>
7436 </table>
7437
7438 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416237">Regkey:<br>
7439 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters\GlobalAutoMapper]</a></h3>
7440
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;
7445   height:65.0pt'>
7446   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7447   height:65.0pt'>
7448   <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416238">Value:
7449   &lt;Drive Letter:&gt; for example &quot;G:&quot;</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>
7453   </td>
7454  </tr>
7455 </table>
7456
7457 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416239">Regkey:<br>
7458 [HKLM\SOFTWARE\OpenAFS\Client]</a></h3>
7459
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;
7465   height:78.5pt'>
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: &lt;not defined&gt;</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>
7474   </td>
7475  </tr>
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;
7478   height:145.25pt'>
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>
7483   Default: 0x1</p>
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
7494   size.</p>
7495   </td>
7496  </tr>
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;
7499   height:105.5pt'>
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>
7504   Default: 0x0</p>
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
7510   is failing. </p>
7511   </td>
7512  </tr>
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;
7515   height:330.75pt'>
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 &quot;fs.exe minidump&quot;
7522   command.</p>
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>
7541   </td>
7542  </tr>
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;
7545   height:138.25pt'>
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>
7550   Default: 0x0</p>
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>
7560   </td>
7561  </tr>
7562 </table>
7563
7564 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416245">Regkey:<br>
7565 [HKLM\SOFTWARE\OpenAFS\Client\CSCPolicy]</a></h3>
7566
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;
7571   height:112.0pt'>
7572   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7573   height:112.0pt'>
7574   <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416246">Value:
7575   &quot;smb/cifs share name&quot;</a></h5>
7576   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
7577   Default: &lt;none&gt;</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: &quot;manual&quot;,
7581   &quot;programs&quot;, &quot;documents&quot;, &quot;disable&quot;.<span
7582   style='mso-spacerun:yes'>  </span></p>
7583   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
7584   in afsdsbmt.ini</p>
7585   </td>
7586  </tr>
7587 </table>
7588
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>
7594
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;
7599   height:138.5pt'>
7600   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7601   height:138.5pt'>
7602   <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416248">Value:
7603   &quot;numeric value&quot;</a></h5>
7604   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
7605   Default: &lt;none&gt;</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'>&quot;athena.mit.edu#athena.mit.edu:root.cell.&quot;</p>
7610   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;.athena.mit.edu%athena.mit.edu:root.cell.&quot;</p>
7611   <p class=MsoBodyText style='mso-yfti-cnfc:1'>These values used to be stored
7612   in afs_freelance.ini</p>
7613   </td>
7614  </tr>
7615 </table>
7616
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>
7622
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;
7627   height:145.0pt'>
7628   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7629   height:145.0pt'>
7630   <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416250">Value:
7631   &quot;numeric value&quot;</a></h5>
7632   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
7633   Default: &lt;none&gt;</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'>&quot;linkname:destination-path.&quot;</p>
7638   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;<st1:GivenName w:st="on">athena</st1:GivenName>:athena.mit.edu.&quot;</p>
7639   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;home:athena.mit.edu\user\j\a\jaltman.&quot;</p>
7640   <p class=MsoBodyText style='mso-yfti-cnfc:1'>&quot;filename:path\file.&quot;</p>
7641   </td>
7642  </tr>
7643 </table>
7644
7645 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416251">Regkey:<br>
7646 [HKLM\SOFTWARE\OpenAFS\Client\Submounts]</a></h3>
7647
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;
7652   height:171.75pt'>
7653   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7654   height:171.75pt'>
7655   <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416252">Value:
7656   &quot;submount name&quot;</a></h5>
7657   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_EXPAND_SZ<br>
7658   Default: &lt;none&gt;</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&quot; can be associated with the
7663   submount name &quot;jaltman.home&quot;.<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
7666   in afsdsbmt.ini</p>
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>
7670   </td>
7671  </tr>
7672 </table>
7673
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>
7679
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;
7684   height:105.5pt'>
7685   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7686   height:105.5pt'>
7687   <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416254">Value:
7688   &quot;hostname or ip address&quot;</a></h5>
7689   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_DWORD<br>
7690   Default: &lt;none&gt;</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>
7697   </td>
7698  </tr>
7699 </table>
7700
7701 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416255">Regkey:<br>
7702 [HKLM\SOFTWARE\OpenAFS\Client\Server Preferences\File]</a></h3>
7703
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;
7708   height:105.5pt'>
7709   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7710   height:105.5pt'>
7711   <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416256">Value:
7712   &quot;hostname or ip address&quot;</a></h5>
7713   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_DWORD<br>
7714   Default: &lt;none&gt;</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>
7721   </td>
7722  </tr>
7723 </table>
7724
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>
7728
7729 <p class=MsoBodyText>Affects the network provider (afslogon.dll).</p>
7730
7731 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416258">Regkey: [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</a></h3>
7732
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;
7737   height:65.75pt'>
7738   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
7739   height:65.75pt'>
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>
7743   Default: 0</p>
7744   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Do not display message boxes if
7745   the login fails.</p>
7746   </td>
7747  </tr>
7748 </table>
7749
7750 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416260">Regkey:<br>
7751 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]</a></h3>
7752
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;
7758   height:65.75pt'>
7759   <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416261">Value:
7760   NoWarnings</a></h5>
7761   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD<br>
7762   Default: 0</p>
7763   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Disables visible warnings during
7764   logon.</p>
7765   </td>
7766  </tr>
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;
7769   height:65.75pt'>
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
7775   provider dll.</p>
7776   </td>
7777  </tr>
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;
7780   height:65.75pt'>
7781   <h5 style='mso-outline-level:5'><a name="_Toc115416263">Value: Class</a></h5>
7782   <p class=MsoBodyText>Type: DWORD<br>
7783   NSIS: 0x02</p>
7784   <p class=MsoBodyText>Specifies the class of network provider</p>
7785   </td>
7786  </tr>
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;
7789   height:92.0pt'>
7790   <h5 style='mso-outline-level:5'><a name="_Toc115416264">Value: DependOnGroup</a></h5>
7791   <p class=MsoBodyText>Type: REG_MULTI_SZ<br>
7792   NSIS: PNP_TDI</p>
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>
7797   </td>
7798  </tr>
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;
7801   height:92.0pt'>
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>
7810   </td>
7811  </tr>
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;
7814   height:65.75pt'>
7815   <h5 style='mso-outline-level:5'><a name="_Toc115416266">Value: Name</a></h5>
7816   <p class=MsoBodyText>Type: REG_SZ<br>
7817   NSIS: &quot;OpenAFSDaemon&quot;</p>
7818   <p class=MsoBodyText>Specifies the display name of the AFS Client Service</p>
7819   </td>
7820  </tr>
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;
7823   height:65.75pt'>
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>
7828   </td>
7829  </tr>
7830 </table>
7831
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>
7837
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>
7846
7847 <p class=MsoBodyText>Domain specific registry keys are:</p>
7848
7849 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416269">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider]</a></h3>
7850
7851 <p class=MsoBodyText><span style='mso-spacerun:yes'>  </span>(NP key)</p>
7852
7853 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416270">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain]</a></h3>
7854
7855 <p class=MsoBodyText><span style='mso-spacerun:yes'>  </span>(Domains key)</p>
7856
7857 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416271">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\&quot;domain
7858 name&quot;]</a></h3>
7859
7860 <p class=MsoBodyText><span style='mso-spacerun:yes'>  </span>(Specific domain
7861 key. One per domain.)</p>
7862
7863 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416272">[HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]</a></h3>
7864
7865 <p class=MsoBodyText><span style='mso-spacerun:yes'>  </span>(Localhost key)</p>
7866
7867 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416273">Example:</a></h3>
7868
7869 <p class=PreformattedText><span
7870 style='mso-spacerun:yes'> </span>HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider</p>
7871
7872 <p class=PreformattedText><span style='mso-spacerun:yes'>  </span>|</p>
7873
7874 <p class=PreformattedText><span style='mso-spacerun:yes'>  </span>+- Domain</p>
7875
7876 <p class=PreformattedText><span style='mso-spacerun:yes'>    
7877 </span>+-AD1.EXAMPLE.COM</p>
7878
7879 <p class=PreformattedText><span style='mso-spacerun:yes'>    
7880 </span>+-AD2.EXAMPLE.NET</p>
7881
7882 <p class=PreformattedText><span style='mso-spacerun:yes'>    
7883 </span>+-LOCALHOST</p>
7884
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>
7888
7889 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416274">A.2.1.1 Domain
7890 specific configuration values</a></h3>
7891
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\&quot;domain
7895 name&quot;]<br>
7896 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider\Domain\LOCALHOST]</a></h4>
7897
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;
7903   height:191.0pt'>
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>
7908   Default: 0x01</p>
7909   <p class=MsoBodyText style='mso-yfti-cnfc:1'>NSIS/WiX: depends on user
7910   configuration</p>
7911   <p class=MsoBodyText style='mso-yfti-cnfc:1'>0x00 - Integrated Logon is not
7912   used<br>
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>
7924   </td>
7925  </tr>
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;
7928   height:92.0pt'>
7929   <h5 style='mso-outline-level:5'><a name="_Toc115416277">Value:
7930   FailLoginsSilentl</a></h5>
7931   <p class=MsoBodyText>Type: DWORD (1|0)<br>
7932   Default: 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>
7936   </td>
7937  </tr>
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;
7940   height:139.0pt'>
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>
7943   Default: (null)<br>
7944   NSIS/WiX: (only value under NP key) &lt;install path&gt;\afscreds.exe -:%s -x
7945   -a -m -n -q</p>
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   &quot;%varname%&quot; which would be expanded at the time the network provider
7950   is run.<span style='mso-spacerun:yes'>  </span>Optionally using a
7951   &quot;%s&quot; in the value would result in it being expanded into the AFS
7952   SMB username for the session.</p>
7953   </td>
7954  </tr>
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;
7957   height:105.5pt'>
7958   <h5 style='mso-outline-level:5'><a name="_Toc115416279">Value: LoginRetryInterval</a></h5>
7959   <p class=MsoBodyText>Type: DWORD<br>
7960   Default: 30<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 &quot;LoginRetryInterval&quot; seconds
7964   while retrying every &quot;LoginSleepInterval&quot; seconds to check if the
7965   service is up.</p>
7966   </td>
7967  </tr>
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;
7970   height:79.25pt'>
7971   <h5 style='mso-outline-level:5'><a name="_Toc115416280">Value:
7972   LoginSleepInterval</a></h5>
7973   <p class=MsoBodyText>Type: DWORD<br>
7974   Default: 5<br>
7975   NSIS/WiX: (not set)</p>
7976   <p class=MsoBodyText>See description of LoginRetryInterval.</p>
7977   </td>
7978  </tr>
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;
7981   height:78.5pt'>
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: &lt;not set&gt;</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>
7990   </td>
7991  </tr>
7992 </table>
7993
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>
7997
7998 <p class=MsoBodyText>During login to domain X, where X is the domain passed
7999 into NPLogonNotify as lpAuthentInfo-&gt;LogonDomainName or the string 'LOCALHOST'
8000 if lpAuthentInfo-&gt;LogonDomainName equals the name of the computer, the
8001 following keys will be looked up.</p>
8002
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
8007 </span></span></span><![endif]>NP key. (&quot;HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\NetworkProvider&quot;)</p>
8008
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
8013 </span></span></span><![endif]>Domains key. (NP key\&quot;Domain&quot;)</p>
8014
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"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
8019 </span></span></span><![endif]>Specific domain key. (Domains key\X)</p>
8020
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>
8024
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>
8033
8034 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416283">A.2.1.3 Exceptions
8035 to A.2.1.2</a></h3>
8036
8037 <p class=MsoBodyText>To retain backwards compatibility, the following
8038 exceptions are made to 2.1.2.</p>
8039
8040 <h4><a name="_Toc115416284">2.1.3.1 'FailLoginsSilently'</a></h4>
8041
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
8047 apply.</p>
8048
8049 <h4><a name="_Toc115416285">2.1.3.2 'LogonScript'</a></h4>
8050
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>
8058
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>
8062
8063 <p class=MsoBodyText>Affects the behavior of afscreds.exe</p>
8064
8065 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416287">Regkey:<br>
8066 [HKLM\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters]</a></h3>
8067
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;
8073   height:92.0pt'>
8074   <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416288">Value:
8075   Gateway</a></h5>
8076   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
8077   Default: &quot;&quot;<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
8081   value.</p>
8082   </td>
8083  </tr>
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;
8086   height:92.0pt'>
8087   <h5 style='mso-outline-level:5'><a name="_Toc115416289">Value: Cell</a></h5>
8088   <p class=MsoBodyText>Type: REG_SZ<br>
8089   Default: &lt;none&gt;<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>
8093   </td>
8094  </tr>
8095 </table>
8096
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>
8100
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;
8106   height:157.5pt'>
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>
8110   Default: 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-&gt;Programs-&gt;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>
8119   </td>
8120  </tr>
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;
8123   height:119.0pt'>
8124   <h5 style='mso-outline-level:5'><a name="_Toc115416292">Value: EnableKFW</a></h5>
8125   <p class=MsoBodyText>Type: DWORD {0, 1}<br>
8126   Default: 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
8133   checked.</p>
8134   </td>
8135  </tr>
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;
8138   height:119.0pt'>
8139   <h5 style='mso-outline-level:5'><a name="_Toc115416293"></a><a
8140   name="_Value___: Use524"></a><span style='mso-bookmark:_Toc115416293'>Value:
8141   Use524</span></h5>
8142   <p class=MsoBodyText>Type: DWORD {0, 1}<br>
8143   Default: 0<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>
8151   </td>
8152  </tr>
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;
8155   height:251.5pt'>
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: &quot;-A -M -N -Q&quot;<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>
8179   </td>
8180  </tr>
8181 </table>
8182
8183 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416295">Regkey:<br>
8184 [HKCU\SOFTWARE\OpenAFS\Client]</a></h3>
8185
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;
8190   height:92.0pt'>
8191   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
8192   height:92.0pt'>
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: &lt;none&gt;<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>
8201   </td>
8202  </tr>
8203 </table>
8204
8205 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416297">Regkey:<br>
8206 [HKCU\SOFTWARE\OpenAFS\Client\Reminders]</a></h3>
8207
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;
8212   height:124.75pt'>
8213   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
8214   height:124.75pt'>
8215   <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416298">Value:
8216   &quot;afs cell name&quot;</a></h5>
8217   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD {0, 1}<br>
8218   Default: &lt;none&gt;<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>
8225   </td>
8226  </tr>
8227 </table>
8228
8229 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416299">Regkey:<br>
8230 [HKCU\SOFTWARE\OpenAFS\Client\Active Maps]</a></h3>
8231
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;
8236   height:98.5pt'>
8237   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
8238   height:98.5pt'>
8239   <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416300">Value:
8240   &quot;upper case drive letter&quot;</a></h5>
8241   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: DWORD {0, 1}<br>
8242   Default: &lt;none&gt;</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>
8248   </td>
8249  </tr>
8250 </table>
8251
8252 <h3 style='margin-left:0pt;text-indent:0pt'><a name="_Toc115416301">Regkey:<br>
8253 [HKCU\SOFTWARE\OpenAFS\Client\Mappings]</a></h3>
8254
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;
8259   height:98.5pt'>
8260   <td width=590 valign=top style='width:442.8pt;padding:0pt 5.4pt 0pt 5.4pt;
8261   height:98.5pt'>
8262   <h5 style='mso-outline-level:5;mso-yfti-cnfc:1'><a name="_Toc115416302">Value:
8263   &quot;upper case drive letter&quot;</a></h5>
8264   <p class=MsoBodyText style='mso-yfti-cnfc:1'>Type: REG_SZ<br>
8265   Default: &lt;none&gt;</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>
8270   </td>
8271  </tr>
8272 </table>
8273
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>
8277
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>&quot;OFF&quot; 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>
8289   </td>
8290  </tr>
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>&quot;ncalrpc&quot;<span
8296   style='mso-spacerun:yes'>  </span>- local RPC<br>
8297   <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:2'>                       </span>&quot;ncacn_np&quot;
8298   - named pipes<br>
8299   <span style='mso-spacerun:yes'> </span><span style='mso-tab-count:2'>                       </span>&quot;ncacn_ip_tcp&quot;
8300   - tcp/ip<br>
8301   Default:<span style='mso-spacerun:yes'>  </span>local RPC</p>
8302   </td>
8303  </tr>
8304 </table>
8305
8306 <p class=MsoBodyText><o:p>&nbsp;</o:p></p>
8307
8308 </div>
8309
8310 </body>
8311
8312 </html>