docbook-quickguide-makefile-20061201
[openafs.git] / doc / xml / QuickStartUnix / f24.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >About This Guide</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
9 REL="HOME"
10 TITLE="AFS Quick Beginnings"
11 HREF="book1.html"><LINK
12 REL="PREVIOUS"
13 TITLE="AFS Quick Beginnings"
14 HREF="book1.html"><LINK
15 REL="NEXT"
16 TITLE="Installation Overview"
17 HREF="c104.html"></HEAD
18 ><BODY
19 CLASS="preface"
20 BGCOLOR="#FFFFFF"
21 TEXT="#000000"
22 LINK="#0000FF"
23 VLINK="#840084"
24 ALINK="#0000FF"
25 ><DIV
26 CLASS="NAVHEADER"
27 ><TABLE
28 SUMMARY="Header navigation table"
29 WIDTH="100%"
30 BORDER="0"
31 CELLPADDING="0"
32 CELLSPACING="0"
33 ><TR
34 ><TH
35 COLSPAN="3"
36 ALIGN="center"
37 >AFS Quick Beginnings: Version 3.6</TH
38 ></TR
39 ><TR
40 ><TD
41 WIDTH="10%"
42 ALIGN="left"
43 VALIGN="bottom"
44 ><A
45 HREF="book1.html"
46 ACCESSKEY="P"
47 >Prev</A
48 ></TD
49 ><TD
50 WIDTH="80%"
51 ALIGN="center"
52 VALIGN="bottom"
53 ></TD
54 ><TD
55 WIDTH="10%"
56 ALIGN="right"
57 VALIGN="bottom"
58 ><A
59 HREF="c104.html"
60 ACCESSKEY="N"
61 >Next</A
62 ></TD
63 ></TR
64 ></TABLE
65 ><HR
66 ALIGN="LEFT"
67 WIDTH="100%"></DIV
68 ><DIV
69 CLASS="preface"
70 ><H1
71 ><A
72 NAME="HDRWQ1"
73 ></A
74 >About This Guide</H1
75 ><P
76 >This section describes the purpose, organization, and conventions of this document.</P
77 ><DIV
78 CLASS="sect1"
79 ><H1
80 CLASS="sect1"
81 ><A
82 NAME="HDRWQ2"
83 >Audience and Purpose</A
84 ></H1
85 ><P
86 >This guide explains how to install and configure AFS<SUP
87 >(R)</SUP
88 > server and client machines. It assumes
89     that the reader is familiar with UNIX<SUP
90 >(R)</SUP
91 > system administration, but not AFS.</P
92 ><P
93 >The instructions explain how to issue AFS commands in the context of specific tasks, but do not describe a command's
94     function or arguments in detail. Refer to the <SPAN
95 CLASS="emphasis"
96 ><I
97 CLASS="emphasis"
98 >IBM AFS Administration Reference</I
99 ></SPAN
100 > as necessary.</P
101 ></DIV
102 ><DIV
103 CLASS="sect1"
104 ><H1
105 CLASS="sect1"
106 ><A
107 NAME="HDRWQ3"
108 >Organization of the Document</A
109 ></H1
110 ><P
111 >See <A
112 HREF="c104.html#HDRWQ7"
113 >The Procedures Described in this Guide</A
114 >.</P
115 ></DIV
116 ><DIV
117 CLASS="sect1"
118 ><H1
119 CLASS="sect1"
120 ><A
121 NAME="HDRWQ4"
122 >How to Use This Document</A
123 ></H1
124 ><P
125 >See <A
126 HREF="c104.html#HDRWQ7"
127 >The Procedures Described in this Guide</A
128 > and <A
129 HREF="c104.html#HDRWQ16"
130 >How to
131     Continue</A
132 >.</P
133 ></DIV
134 ><DIV
135 CLASS="sect1"
136 ><H1
137 CLASS="sect1"
138 ><A
139 NAME="HDRWQ5"
140 >Related Documents</A
141 ></H1
142 ><P
143 >The AFS documentation set also includes the following documents.</P
144 ><P
145 >&#13;      <SPAN
146 CLASS="emphasis"
147 ><I
148 CLASS="emphasis"
149 >IBM AFS Administration Guide</I
150 ></SPAN
151 >
152     </P
153 ><P
154 >This guide describes the concepts and procedures that a system administrator must know to manage an AFS cell. It assumes
155     familiarity with UNIX, but requires no previous knowledge of AFS.</P
156 ><P
157 >The first chapters of the <SPAN
158 CLASS="emphasis"
159 ><I
160 CLASS="emphasis"
161 >IBM AFS Administration Guide</I
162 ></SPAN
163 > present basic concepts and guidelines.
164     Understanding them is crucial to successful administration of an AFS cell. The remaining chapters in the guide provide
165     step-by-step instructions for specific administrative tasks, along with discussions of the concepts important to that particular
166     task.</P
167 ><P
168 >&#13;      <SPAN
169 CLASS="emphasis"
170 ><I
171 CLASS="emphasis"
172 >IBM AFS Administration Reference</I
173 ></SPAN
174 >
175     </P
176 ><P
177 >This reference manual details the syntax and effect of each AFS command. It is intended for the experienced AFS
178     administrator, programmer, or user.</P
179 ><P
180 >The <SPAN
181 CLASS="emphasis"
182 ><I
183 CLASS="emphasis"
184 >IBM AFS Administration Reference</I
185 ></SPAN
186 > lists AFS files and commands in alphabetical order. The
187     reference page for each command specifies its syntax, including the acceptable aliases and abbreviations. It then describes the
188     command's function, arguments, and output if any. Examples and a list of related commands are provided, as are warnings where
189     appropriate.</P
190 ><P
191 >This manual complements the <SPAN
192 CLASS="emphasis"
193 ><I
194 CLASS="emphasis"
195 >IBM AFS Administration Guide</I
196 ></SPAN
197 >: it does not include procedural information,
198     but describes commands in more detail than the <SPAN
199 CLASS="emphasis"
200 ><I
201 CLASS="emphasis"
202 >IBM AFS Administration Guide</I
203 ></SPAN
204 >.</P
205 ><P
206 >&#13;      <SPAN
207 CLASS="emphasis"
208 ><I
209 CLASS="emphasis"
210 >IBM AFS User Guide</I
211 ></SPAN
212 >
213     </P
214 ><P
215 >This guide presents the basic concepts and procedures necessary for using AFS effectively. It assumes that the reader has
216     some experience with UNIX, but does not require familiarity with networking or AFS.</P
217 ><P
218 >The guide explains how to perform basic functions, including authenticating, changing a password, protecting AFS data,
219     creating groups, and troubleshooting. It provides illustrative examples for each function and describes some of the differences
220     between the UNIX file system and AFS.</P
221 ><P
222 >&#13;      <SPAN
223 CLASS="emphasis"
224 ><I
225 CLASS="emphasis"
226 >IBM AFS Release Notes</I
227 ></SPAN
228 >
229     </P
230 ><P
231 >This document provides information specific to each release of AFS, such as a list of new features and commands, a list of
232     requirements and limitations, and instructions for upgrading server and client machines.</P
233 ></DIV
234 ><DIV
235 CLASS="sect1"
236 ><H1
237 CLASS="sect1"
238 ><A
239 NAME="HDRTYPO_CONV"
240 >Typographical Conventions</A
241 ></H1
242 ><P
243 >This document uses the following typographical conventions: <UL
244 ><LI
245 ><P
246 >Command and option names appear in <SPAN
247 CLASS="bold"
248 ><B
249 CLASS="emphasis"
250 >bold type</B
251 ></SPAN
252 > in syntax definitions, examples, and
253           running text. Names of directories, files, machines, partitions, volumes, and users also appear in <SPAN
254 CLASS="bold"
255 ><B
256 CLASS="emphasis"
257 >bold type</B
258 ></SPAN
259 >.</P
260 ></LI
261 ><LI
262 ><P
263 >Variable information appears in <SPAN
264 CLASS="emphasis"
265 ><I
266 CLASS="emphasis"
267 >italic type</I
268 ></SPAN
269 >. This includes user-supplied information on command
270           lines and the parts of prompts that differ depending on who issues the command. New terms also appear in <SPAN
271 CLASS="emphasis"
272 ><I
273 CLASS="emphasis"
274 >italic
275           type</I
276 ></SPAN
277 >.</P
278 ></LI
279 ><LI
280 ><P
281 >Examples of screen output and file contents appear in <SAMP
282 CLASS="computeroutput"
283 >monospace type</SAMP
284 >.</P
285 ></LI
286 ></UL
287 > </P
288 ><P
289 >In addition, the following symbols appear in command syntax definitions, both in the documentation and in AFS online help
290     statements. When issuing a command, do not type these symbols. <UL
291 ><LI
292 ><P
293 >Square brackets <SPAN
294 CLASS="bold"
295 ><B
296 CLASS="emphasis"
297 >[ ]</B
298 ></SPAN
299 > surround optional items.</P
300 ></LI
301 ><LI
302 ><P
303 >Angle brackets <SPAN
304 CLASS="bold"
305 ><B
306 CLASS="emphasis"
307 >&#60; &#62;</B
308 ></SPAN
309 > surround user-supplied values in AFS commands.</P
310 ></LI
311 ><LI
312 ><P
313 >A superscripted plus sign <SPAN
314 CLASS="bold"
315 ><B
316 CLASS="emphasis"
317 >+</B
318 ></SPAN
319 > follows an argument that accepts more than one
320           value.</P
321 ></LI
322 ><LI
323 ><P
324 >The percent sign <SAMP
325 CLASS="computeroutput"
326 >%</SAMP
327 > represents the regular command shell prompt. Some operating
328           systems possibly use a different character for this prompt.</P
329 ></LI
330 ><LI
331 ><P
332 >The number sign <SAMP
333 CLASS="computeroutput"
334 >#</SAMP
335 > represents the command shell prompt for the local superuser
336           <SPAN
337 CLASS="bold"
338 ><B
339 CLASS="emphasis"
340 >root</B
341 ></SPAN
342 >. Some operating systems possibly use a different character for this prompt.</P
343 ></LI
344 ><LI
345 ><P
346 >The pipe symbol <SPAN
347 CLASS="bold"
348 ><B
349 CLASS="emphasis"
350 >|</B
351 ></SPAN
352 > in a command syntax statement separates mutually exclusive values
353           for an argument.</P
354 ></LI
355 ></UL
356 > </P
357 ><P
358 >For additional information on AFS commands, including a description of command string components, acceptable abbreviations
359     and aliases, and how to get online help for commands, see the appendix to the <SPAN
360 CLASS="emphasis"
361 ><I
362 CLASS="emphasis"
363 >IBM AFS Administration
364     Guide</I
365 ></SPAN
366 >.</P
367 ></DIV
368 ></DIV
369 ><DIV
370 CLASS="NAVFOOTER"
371 ><HR
372 ALIGN="LEFT"
373 WIDTH="100%"><TABLE
374 SUMMARY="Footer navigation table"
375 WIDTH="100%"
376 BORDER="0"
377 CELLPADDING="0"
378 CELLSPACING="0"
379 ><TR
380 ><TD
381 WIDTH="33%"
382 ALIGN="left"
383 VALIGN="top"
384 ><A
385 HREF="book1.html"
386 ACCESSKEY="P"
387 >Prev</A
388 ></TD
389 ><TD
390 WIDTH="34%"
391 ALIGN="center"
392 VALIGN="top"
393 ><A
394 HREF="book1.html"
395 ACCESSKEY="H"
396 >Home</A
397 ></TD
398 ><TD
399 WIDTH="33%"
400 ALIGN="right"
401 VALIGN="top"
402 ><A
403 HREF="c104.html"
404 ACCESSKEY="N"
405 >Next</A
406 ></TD
407 ></TR
408 ><TR
409 ><TD
410 WIDTH="33%"
411 ALIGN="left"
412 VALIGN="top"
413 >AFS Quick Beginnings</TD
414 ><TD
415 WIDTH="34%"
416 ALIGN="center"
417 VALIGN="top"
418 >&nbsp;</TD
419 ><TD
420 WIDTH="33%"
421 ALIGN="right"
422 VALIGN="top"
423 >Installation Overview</TD
424 ></TR
425 ></TABLE
426 ></DIV
427 ></BODY
428 ></HTML
429 >