doc/xml/AdminGuide/auagd005.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <preface id="Header_3">
   3   <title>About This Guide</title>
   4
   5   <para>This section describes the purpose, organization, and conventions of this document.</para>
   6
   7   <sect1 id="HDRWQ1">
   8     <title>Audience and Purpose</title>
   9
  10     <para>This guide describes the concepts and procedures that an AFS(R) system administrator needs to know. It assumes familiarity
  11     with UNIX(R) administration, but no previous knowledge of AFS.</para>
  12
  13     <para>This document describes AFS commands in the context of specific tasks. Thus, it does not describe all commands in detail.
  14     Refer to the OpenAFS Administration Reference for detailed command descriptions.</para>
  15   </sect1>
  16
  17   <sect1 id="HDRWQ2">
  18     <title>Document Organization</title>
  19
  20     <para>This document groups AFS administrative tasks into the following conceptual sections: <itemizedlist>
  21         <listitem>
  22           <para>Concepts and Configuration Issues</para>
  23         </listitem>
  24
  25         <listitem>
  26           <para>Managing File Server Machines</para>
  27         </listitem>
  28
  29         <listitem>
  30           <para>Managing Client Machines</para>
  31         </listitem>
  32
  33         <listitem>
  34           <para>Managing Users and Groups</para>
  35         </listitem>
  36       </itemizedlist></para>
  37
  38     <para>The individual chapters in each section contain the following: <itemizedlist>
  39         <listitem>
  40           <para>A chapter overview</para>
  41         </listitem>
  42
  43         <listitem>
  44           <para>A quick reference list of the tasks and commands described in the chapter</para>
  45         </listitem>
  46
  47         <listitem>
  48           <para>An introduction to concepts that pertain to all of the tasks described in the chapter</para>
  49         </listitem>
  50
  51         <listitem>
  52           <para>A set of sections devoted to specific tasks. Each section begins with a discussion of concepts specific to that
  53           task, followed by step-by-step instructions for performing the task. The instructions are as specific as has been judged
  54           practical. If two related procedures differ from one another in important details, separate sets of instructions are
  55           usually provided.</para>
  56         </listitem>
  57       </itemizedlist></para>
  58   </sect1>
  59
  60   <sect1 id="HDRWQ3">
  61     <title>How to Use This Document</title>
  62
  63     <para>When you need to perform a specific administrative task, follow these steps:
  64
  65     <orderedlist>
  66       <listitem>
  67         <para>Determine if the task concerns file server machines, client machines, or users and groups. Turn to the appropriate
  68         section in this document and then to the appropriate chapter.</para>
  69       </listitem>
  70
  71       <listitem>
  72         <para>Read or review the general introductory material at the beginning of the chapter.</para>
  73       </listitem>
  74
  75       <listitem>
  76         <para>Read or review the introductory material concerning the specific task you wish to perform.</para>
  77       </listitem>
  78
  79       <listitem>
  80         <para>Follow the step-by-step instructions for the task.</para>
  81       </listitem>
  82
  83       <listitem>
  84         <para>If necessary, refer to the OpenAFS Administration Reference for more detailed information about the commands.</para>
  85       </listitem>
  86     </orderedlist>
  87 </para>
  88   </sect1>
  89
  90   <sect1 id="HDRWQ4">
  91     <title>Related Documents</title>
  92
  93     <para>The following documents are also included in the AFS documentation set.
  94
  95     <variablelist>
  96       <varlistentry>
  97         <term>OpenAFS Administration Reference</term>
  98
  99         <listitem>
 100           <para>This reference manual details the syntax and effect of each AFS command. It is intended for the experienced AFS
 101           administrator, programmer, or user. The OpenAFS Administration Reference lists AFS files and commands in alphabetical
 102           order. The reference page for each command specifies its syntax, including the acceptable aliases and abbreviations. It
 103           then describes the command's function, arguments, and output if any. Examples and a list of related commands are provided,
 104           as are warnings where appropriate.</para>
 105
 106           <para>This manual complements the OpenAFS Administration Guide: it does not include procedural information, but describes
 107           commands in more detail than the OpenAFS Administration Guide.</para>
 108         </listitem>
 109       </varlistentry>
 110
 111       <varlistentry>
 112         <term>OpenAFS Quick Beginnings</term>
 113
 114         <listitem>
 115           <para>This guide provides instructions for installing AFS server and client machines. It is assumed that the installer is
 116           an experienced UNIX(R) system administrator.</para>
 117
 118           <para>For predictable performance, machines must be installed and configured in accordance with the instructions in this
 119           guide.</para>
 120         </listitem>
 121       </varlistentry>
 122
 123       <varlistentry>
 124         <term>OpenAFS Release Notes</term>
 125
 126         <listitem>
 127           <para>This document provides information specific to each release of AFS, such as a list of new features and commands, a
 128           list of requirements and limitations, and instructions for upgrading server and client machines.</para>
 129         </listitem>
 130       </varlistentry>
 131
 132       <varlistentry>
 133         <term>OpenAFS User Guide</term>
 134
 135         <listitem>
 136           <para>This guide presents the basic concepts and procedures necessary for using AFS effectively. It assumes that the
 137           reader has some experience with UNIX, but does not require familiarity with networking or AFS.</para>
 138
 139           <para>The guide explains how to perform basic functions, including authenticating, changing a password, protecting AFS
 140           data, creating groups, and troubleshooting. It provides illustrative examples for each function and describes some of the
 141           differences between the UNIX file system and AFS.</para>
 142         </listitem>
 143       </varlistentry>
 144     </variablelist>
 145 </para>
 146   </sect1>
 147
 148   <sect1 id="HDRTYPO_CONV">
 149     <title>Typographical Conventions</title>
 150
 151     <para>This document uses the following typographical conventions:
 152
 153     <itemizedlist>
 154       <listitem>
 155         <para>Command and option names appear in <emphasis role="bold">bold type</emphasis> in syntax definitions, examples, and
 156         running text. Names of directories, files, machines, partitions, volumes, and users also appear in <emphasis
 157         role="bold">bold type</emphasis>.</para>
 158       </listitem>
 159
 160       <listitem>
 161         <para>Variable information appears in <emphasis>italic type</emphasis>. This includes user-supplied information on command
 162         lines and the parts of prompts that differ depending on who issues the command. New terms also appear in <emphasis>italic
 163         type</emphasis>.</para>
 164       </listitem>
 165
 166       <listitem>
 167         <para>Examples of screen output and file contents appear in <computeroutput>monospace type</computeroutput>.</para>
 168       </listitem>
 169     </itemizedlist>
 170 </para>
 171
 172     <para>In addition, the following symbols appear in command syntax definitions, both in the documentation and in AFS online help
 173     statements. When issuing a command, do not type these symbols. <itemizedlist>
 174         <listitem>
 175           <para>Square brackets <emphasis role="bold">[ ]</emphasis> surround optional items.</para>
 176         </listitem>
 177
 178         <listitem>
 179           <para>Angle brackets <emphasis role="bold">&lt; &gt;</emphasis> surround user-supplied values in AFS commands.</para>
 180         </listitem>
 181
 182         <listitem>
 183           <para>A superscripted plus sign <emphasis role="bold">+</emphasis> follows an argument that accepts more than one
 184           value.</para>
 185         </listitem>
 186
 187         <listitem>
 188           <para>The percent sign <computeroutput>%</computeroutput> represents the regular command shell prompt. Some operating systems possibly use a different
 189           character for this prompt.</para>
 190         </listitem>
 191
 192         <listitem>
 193           <para>The number sign <computeroutput>#</computeroutput> represents the command shell prompt for the local superuser <emphasis role="bold">root</emphasis>.
 194           Some operating systems possibly use a different character for this prompt.</para>
 195         </listitem>
 196
 197         <listitem>
 198           <para>The pipe symbol <emphasis role="bold">|</emphasis> in a command syntax statement separates mutually exclusive values
 199           for an argument.</para>
 200         </listitem>
 201       </itemizedlist></para>
 202
 203     <para>For additional information on AFS commands, including a description of command string components, acceptable abbreviations
 204     and aliases, and how to get online help for commands, see <link linkend="HDRCOMMANDS">Appendix B, Using AFS
 205     Commands</link>.</para>
 206   </sect1>
 207 </preface>