Whamcloud - gitweb
LUDOC-390 misc: Document shutdown procedure
[doc/manual.git] / LustreMaintenance.xml
index cdad1b6..b9600c3 100644 (file)
@@ -242,7 +242,7 @@ Changing a Server NID</title>
       <para>To change a server NID:</para>
       <orderedlist>
         <listitem>
-               <para>Update the LNET configuration in the <literal>/etc/modprobe.conf</literal> file so the list of server NIDs is correct. Use <literal>lctl list_nids</literal> to view the list of server NIDS.</para>
+               <para>Update the LNet configuration in the <literal>/etc/modprobe.conf</literal> file so the list of server NIDs is correct. Use <literal>lctl list_nids</literal> to view the list of server NIDS.</para>
           <para>The <literal>lctl list_nids</literal> command indicates which network(s) are
           configured to work with the Lustre file system.</para>
         </listitem>
@@ -381,10 +381,18 @@ Removing and Restoring OSTs</title>
       </itemizedlist>
       <section condition="l24" xml:id="dbdoclet.rmremotedir">
       <title><indexterm><primary>maintenance</primary><secondary>removing a MDT</secondary></indexterm>Removing a MDT from the File System</title>
-       <para>If the MDT is permanently inaccessible, <literal>lfs rmdir {directory}</literal> can be used to delete the directory entry. A normal <literal>rmdir</literal> will report an IO error due to the remote MDT being inactive. After the remote directory has been removed, the administrator should mark the MDT as permanently inactive with:</para>
+       <para>If the MDT is permanently inaccessible,
+    <literal>lfs rm_entry {directory}</literal> can be used to delete the
+    directory entry on the unavailable MDT. A normal <literal>rmdir</literal>
+    will report an IO error due to the remote MDT being inactive. Please note
+    that if the MDT is available, a standard <literal>rm -r</literal> should
+    be used to delete the remote directory.  After the remote directory has been
+    removed, the administrator should mark the MDT as permanently inactive
+    with:</para>
 <screen>lctl conf_param {MDT name}.mdc.active=0
 </screen>
-<para>A user can identify the location of a remote sub-directory using the <literal>lfs</literal> utility. For example:</para>
+<para>A user can identify which MDT holds a remote sub-directory using
+the <literal>lfs</literal> utility. For example:</para>
 <screen>client$ lfs getstripe -M /mnt/lustre/remote_dir1
 1
 client$ mkdir /mnt/lustre/local_dir0
@@ -471,21 +479,26 @@ client$ lfs getstripe -M /mnt/lustre/local_dir0
           <para>Deactivate the OST.</para>
           <orderedlist>
             <listitem>
-              <para>To temporarily disable the deactivated OST, enter:
-                <screen>[client]# lctl set_param osc.<replaceable>fsname</replaceable>-<replaceable>OSTnumber</replaceable>-*.active=0</screen>If
-                there is expected to be a replacement OST in some short time (a few days), the OST
-                can temporarily be deactivated on the clients: <note>
-                  <para>This setting is only temporary and will be reset if the clients or MDS are
-                    rebooted. It needs to be run on all clients.</para>
+              <para>
+               If there is expected to be a replacement OST in some short
+               time (a few days), the OST can temporarily be deactivated on
+               the clients using:
+                <screen>client# lctl set_param osc.<replaceable>fsname</replaceable>-OST<replaceable>number</replaceable>-*.active=0</screen>
+               <note><para>This setting is only temporary and will be reset
+               if the clients are remounted or rebooted. It needs to be run
+               on all clients.</para>
                 </note></para>
             </listitem>
           </orderedlist>
-          <para>If there is not expected to be a replacement for this OST in the near future,
-            permanently deactivate the OST on all clients and the MDS:
-            <screen>[mgs]# lctl conf_param <replaceable>ost_name</replaceable>.osc.active=0</screen></para>
+          <para>If there is not expected to be a replacement for this OST in
+         the near future, permanently deactivate it on all clients and the MDS
+         by running the following command on the MGS:
+            <screen>mgs# lctl conf_param <replaceable>ost_name</replaceable>.osc.active=0</screen></para>
           <note>
-            <para>A removed OST still appears in the file system; do not create a new OST with the
-              same name.</para>
+            <para>A deactivated OST still appears in the file system
+           configuration, though a new OST with the same name can be
+           created using the <literal>--replace</literal> option for
+           <literal>mkfs.lustre</literal>.</para>
           </note>
         </listitem>
       </orderedlist>
@@ -583,13 +596,14 @@ oss0# dd if=/tmp/ldd of=/mnt/ost/CONFIGS/mountdata bs=4 count=1 seek=5 skip=5 co
       <title><indexterm>
           <primary>maintenance</primary>
           <secondary>reintroducing an OSTs</secondary>
-        </indexterm> Returning a Deactivated OST to Service</title>
-      <para> If the OST was permanently deactivated, it needs to be reactivated in the MGS
-        configuration.
-        <screen>mgs# lctl conf_param <replaceable>ost_name</replaceable>.osc.active=1</screen> If
-        the OST was temporarily deactivated, it needs to be reactivated on the MDS and clients.
+        </indexterm>Returning a Deactivated OST to Service</title>
+      <para>If the OST was permanently deactivated, it needs to be
+      reactivated in the MGS configuration.
+        <screen>mgs# lctl conf_param <replaceable>ost_name</replaceable>.osc.active=1</screen>
+       If the OST was temporarily deactivated, it needs to be reactivated on
+       the MDS and clients.
         <screen>mds# lctl --device <replaceable>lustre_devno</replaceable> activate
-                    client# lctl set_param osc.<replaceable>fsname</replaceable>-<replaceable>OSTnumber</replaceable>-*.active=0</screen></para>
+client# lctl set_param osc.<replaceable>fsname</replaceable>-OST<replaceable>number</replaceable>-*.active=1</screen></para>
     </section>
     </section>
     <section xml:id="dbdoclet.50438199_77819">
@@ -607,11 +621,11 @@ Determining Which Machine is Serving an OST </title>
       <para>In the course of administering a Lustre file system, you may need to determine which
       machine is serving a specific OST. It is not as simple as identifying the machine’s IP
       address, as IP is only one of several networking protocols that the Lustre software uses and,
-      as such, LNET does not use IP addresses as node identifiers, but NIDs instead. To identify the
+      as such, LNet does not use IP addresses as node identifiers, but NIDs instead. To identify the
       NID that is serving a specific OST, run one of the following commands on a client (you do not
       need to be a root user):
-      <screen>client$ lctl get_param osc.<replaceable>fsname</replaceable>-<replaceable>OSTnumber</replaceable>*.ost_conn_uuid</screen>For
-      example:
+      <screen>client$ lctl get_param osc.<replaceable>fsname</replaceable>-OST<replaceable>number</replaceable>*.ost_conn_uuid</screen>
+      For example:
       <screen>client$ lctl get_param osc.*-OST0000*.ost_conn_uuid 
 osc.testfs-OST0000-osc-f1579000.ost_conn_uuid=192.168.20.1@tcp</screen>-
       OR -