1 <?xml version='1.0' encoding='UTF-8'?>
2 <preface xmlns="http://docbook.org/ns/docbook"
3 xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en-US">
5 <para>The <emphasis role="italic">Lustre<superscript>*</superscript>Software
6 Release 2.x Operations Manual</emphasis> provides detailed information and
7 procedures to install, configure and tune a Lustre file system. The manual
8 covers topics such as failover, quotas, striping, and bonding. This manual
9 also contains troubleshooting information and tips to improve
10 the operation and performance of a Lustre file system.</para>
12 <title>About this Document</title>
13 <para>This document is maintained by Whamcloud in Docbook format. The
14 canonical version is available at
15 <link xl:href="https://wiki.whamcloud.com/display/PUB/Documentation">
16 https://wiki.whamcloud.com/display/PUB/Documentation
20 <title>UNIX<superscript>*</superscript> Commands</title>
21 <para>This document does not contain information about basic
22 UNIX<superscript>*</superscript> operating system commands and
23 procedures such as shutting down the system, booting the system, and
24 configuring devices. Refer to the following for this information:</para>
27 <para>Software documentation that you received with your system</para>
30 <para>Red Hat<superscript>*</superscript> Enterprise
31 Linux<superscript>*</superscript> documentation, which is at:
32 <link xl:href="https://docs.redhat.com/docs/en-US/index.html">
33 https://docs.redhat.com/docs/en-US/index.html</link>
35 <note><para>The Lustre client module is available for many different
36 Linux<superscript>*</superscript> versions and distributions. The
37 Red Hat Enterprise Linux distribution is the best supported and
38 tested platform for Lustre servers.</para></note>
43 <title>Shell Prompts</title>
44 <para>The shell prompt used in the example text indicates whether a
45 command can or should be executed by a regular user, or whether it
46 requires superuser permission to run. Also, the machine type is often
47 included in the prompt to indicate whether the command should be run
48 on a client node, on an MDS node, an OSS node, or the MGS node.</para>
49 <para>Some examples are listed below, but other prompt combinations
50 are also used as needed for the example.</para>
51 <informaltable frame="all">
53 <colspec colname="c1" colwidth="50*"/>
54 <colspec colname="c2" colwidth="50*"/>
58 <para><emphasis role="bold">Shell</emphasis></para>
61 <para><emphasis role="bold">Prompt</emphasis></para>
68 <para> Regular user</para>
71 <para> <prompt>machine$</prompt></para>
76 <para> Superuser (root)</para>
79 <para> <prompt>machine#</prompt></para>
84 <para> Regular user on the client</para>
87 <para> <prompt>client$</prompt></para>
92 <para> Superuser on the MDS</para>
95 <para> <prompt>mds#</prompt></para>
100 <para> Superuser on the OSS</para>
103 <para> <prompt>oss#</prompt></para>
108 <para> Superuser on the MGS</para>
111 <para> <prompt>mgs#</prompt></para>
119 <title>Related Documentation</title>
120 <informaltable frame="all">
122 <colspec colname="c1" colwidth="25*"/>
123 <colspec colname="c2" colwidth="25*"/>
124 <colspec colname="c3" colwidth="15*"/>
125 <colspec colname="c4" colwidth="35*"/>
129 <para><emphasis role="bold">Application</emphasis></para>
132 <para><emphasis role="bold">Title</emphasis></para>
135 <para><emphasis role="bold">Format</emphasis></para>
138 <para><emphasis role="bold">Location</emphasis></para>
145 <para> Latest information</para>
149 <emphasis>Lustre Software Release 2.x Change Logs</emphasis></para>
152 <para> Wiki page</para>
155 <para> Online at <link
156 xl:href="https://wiki.whamcloud.com/display/PUB/Documentation"
157 >https://wiki.whamcloud.com/display/PUB/Documentation</link></para>
162 <para> Service</para>
166 <emphasis>Lustre Software Release 2.x Operations Manual</emphasis></para>
173 <para> Online at <link
174 xl:href="https://wiki.whamcloud.com/display/PUB/Documentation"
175 >https://wiki.whamcloud.com/display/PUB/Documentation</link></para>
183 <title>Documentation and Support</title>
184 <para>These web sites provide additional resources:</para>
188 <link xl:href="https://wiki.whamcloud.com/display/PUB/Documentation">
189 https://wiki.whamcloud.com/display/PUB/Documentation</link>
190 <link xl:href="https://www.lustre.org">https://www.lustre.org</link>
194 <para> Support <link xl:href="https://jira.whamcloud.com/">https://jira.whamcloud.com/</link></para>
199 <xi:include href="Revision.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
202 vim:expandtab:shiftwidth=2:tabstop=8: