Whamcloud - gitweb
874b4c539e71f773f85a20926afe8681bc93b561
[doc/manual.git] / Preface.xml
1 <?xml version='1.0' encoding='UTF-8'?>
2 <preface xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en-US">
3   <title>Preface</title>
4   <para>The <emphasis role="italic">Lustre<superscript>*</superscript>Software Release 2.x
5       Operations Manual</emphasis> provides detailed information and procedures to install,
6     configure and tune a Lustre file system. The manual covers topics such as failover, quotas,
7     striping, and bonding. This manual also contains troubleshooting information and tips to improve
8     the operation and performance of a Lustre file system.</para>
9   <section remap="h2">
10     <title>About this Document</title>
11     <para>This document is maintained by Whamcloud in Docbook format. The
12     canonical version is available at
13     <link xl:href="http://wiki.whamcloud.com/display/PUB/Documentation">http://wiki.whamcloud.com/display/PUB/Documentation</link>. </para>
14
15     <section remap="h2">
16       <title>UNIX<superscript>*</superscript> Commands</title>
17       <para>This document may not contain information about basic UNIX<superscript>*</superscript>
18         operating system commands and procedures such as shutting down the system, booting the
19         system, and configuring devices. Refer to the following for this information:</para>
20       <itemizedlist>
21         <listitem>
22           <para> Software documentation that you received with your system</para>
23         </listitem>
24         <listitem>
25           <para> Red Hat<superscript>*</superscript> Enterprise Linux<superscript>*</superscript>
26             documentation, which is at: <link xl:href="http://docs.redhat.com/docs/en-US/index.html"
27               >http://docs.redhat.com/docs/en-US/index.html</link></para>
28   <note><para> The Lustre client module is available for many different Linux<superscript>*</superscript>
29               versions and distributions. The Red Hat Enterprise Linux distribution is the best
30               supported and tested platform for Lustre servers. </para></note>
31         </listitem>
32       </itemizedlist>
33     </section>
34     <section remap="h2">
35       <title>Shell Prompts</title>
36       <para>The shell prompt used in the example text indicates whether a
37       command can or should be executed by a regular user, or whether it
38       requires superuser permission to run.  Also, the machine type is often
39       included in the prompt to indicate whether the command should be run
40       on a client node, on an MDS node, an OSS node, or the MGS node.</para>
41       <para>Some examples are listed below, but other prompt combinations
42       are also used as needed for the example.</para>
43       <informaltable frame="all">
44         <tgroup cols="2">
45           <colspec colname="c1" colwidth="50*"/>
46           <colspec colname="c2" colwidth="50*"/>
47           <thead>
48             <row>
49               <entry>
50                 <para><emphasis role="bold">Shell</emphasis></para>
51               </entry>
52               <entry>
53                 <para><emphasis role="bold">Prompt</emphasis></para>
54               </entry>
55             </row>
56           </thead>
57           <tbody>
58             <row>
59               <entry>
60                 <para> Regular user</para>
61               </entry>
62               <entry>
63                 <para> <prompt>machine$</prompt></para>
64               </entry>
65             </row>
66             <row>
67               <entry>
68                 <para> Superuser (root)</para>
69               </entry>
70               <entry>
71                 <para> <prompt>machine#</prompt></para>
72               </entry>
73             </row>
74             <row>
75               <entry>
76                 <para> Regular user on the client</para>
77               </entry>
78               <entry>
79                 <para> <prompt>client$</prompt></para>
80               </entry>
81             </row>
82             <row>
83               <entry>
84                 <para> Superuser on the MDS</para>
85               </entry>
86               <entry>
87                 <para> <prompt>mds#</prompt></para>
88               </entry>
89             </row>
90             <row>
91               <entry>
92                 <para> Superuser on the OSS</para>
93               </entry>
94               <entry>
95                 <para> <prompt>oss#</prompt></para>
96               </entry>
97             </row>
98             <row>
99               <entry>
100                 <para> Superuser on the MGS</para>
101               </entry>
102               <entry>
103                 <para> <prompt>mgs#</prompt></para>
104               </entry>
105             </row>
106           </tbody>
107         </tgroup>
108       </informaltable>
109     </section>
110     <section remap="h2">
111       <title>Related Documentation</title>
112       <informaltable frame="all">
113         <tgroup cols="4">
114           <colspec colname="c1" colwidth="25*"/>
115           <colspec colname="c2" colwidth="25*"/>
116           <colspec colname="c3" colwidth="15*"/>
117           <colspec colname="c4" colwidth="35*"/>
118           <thead>
119             <row>
120               <entry>
121                 <para><emphasis role="bold">Application</emphasis></para>
122               </entry>
123               <entry>
124                 <para><emphasis role="bold">Title</emphasis></para>
125               </entry>
126               <entry>
127                 <para><emphasis role="bold">Format</emphasis></para>
128               </entry>
129               <entry>
130                 <para><emphasis role="bold">Location</emphasis></para>
131               </entry>
132             </row>
133           </thead>
134           <tbody>
135             <row>
136               <entry>
137                 <para> Latest information</para>
138               </entry>
139               <entry>
140                 <para>
141                   <emphasis>Lustre Software Release 2.x Change Logs</emphasis></para>
142               </entry>
143               <entry>
144                 <para> Wiki page</para>
145               </entry>
146               <entry>
147                 <para> Online at <link
148                     xl:href="http://wiki.whamcloud.com/display/PUB/Documentation"
149                     >http://wiki.whamcloud.com/display/PUB/Documentation</link></para>
150               </entry>
151             </row>
152             <row>
153               <entry>
154                 <para> Service</para>
155               </entry>
156               <entry>
157                 <para>
158                   <emphasis>Lustre Software Release 2.x Operations Manual</emphasis></para>
159               </entry>
160               <entry>
161                 <para> PDF</para>
162                 <para>HTML</para>
163               </entry>
164               <entry>
165                 <para> Online at <link
166                     xl:href="http://wiki.whamcloud.com/display/PUB/Documentation"
167                     >http://wiki.whamcloud.com/display/PUB/Documentation</link></para>
168               </entry>
169             </row>
170           </tbody>
171         </tgroup>
172       </informaltable>
173     </section>
174     <section remap="h2">
175       <title>Documentation and Support</title>
176       <para>These web sites provide additional resources:</para>
177       <itemizedlist>
178         <listitem>
179                                         <para> Documentation
180                                                 <link xl:href="http://wiki.whamcloud.com/display/PUB/Documentation">
181                                                 http://wiki.whamcloud.com/display/PUB/Documentation</link>
182                                                 <link xl:href="http://www.lustre.org">
183                                                 http://www.lustre.org</link></para>
184         </listitem>
185         <listitem>
186           <para> Support <link xl:href="https://jira.whamcloud.com/">https://jira.whamcloud.com/</link></para>
187         </listitem>
188       </itemizedlist>
189     </section>
190   </section>
191     <xi:include href="Revision.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
192 </preface>