Whamcloud - gitweb
LUDOC-326 mxlnd: Remove references to mxlnd 59/27359/2
authorCory Spitz <spitzcor@cray.com>
Wed, 31 May 2017 21:39:02 +0000 (16:39 -0500)
committerAndreas Dilger <andreas.dilger@intel.com>
Thu, 1 Jun 2017 05:04:54 +0000 (05:04 +0000)
LU-6209 (resolved for 2.8.0) removed the mxlnd from the source
tree.  References to the mxlnd should have been removed from the
manual at that time.

Signed-off-by: Cory Spitz <spitzcor@cray.com>
Change-Id: I1348e0aea58f2240ba307d072fa86c754d0b6d2e
Reviewed-on: https://review.whamcloud.com/27359
Tested-by: Jenkins
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
ConfigurationFilesModuleParameters.xml
ManagingSecurity.xml
SystemConfigurationUtilities.xml
UnderstandingLustreNetworking.xml

index 56e94de..0b354bd 100644 (file)
@@ -83,22 +83,6 @@ Network Topology</title>
                   <para> OFED Version 2</para>
                 </entry>
               </row>
-              <row>
-                <entry>
-                  <para> mx</para>
-                </entry>
-                <entry>
-                  <para> Myrinet MX</para>
-                </entry>
-              </row>
-              <row>
-                <entry>
-                  <para> gm</para>
-                </entry>
-                <entry>
-                  <para> Myrinet GM-2</para>
-                </entry>
-              </row>
             </tbody>
           </tgroup>
         </informaltable>
@@ -490,120 +474,5 @@ forwarding (&quot;&quot;)</title>
         </tgroup>
       </informaltable>
     </section>
-    <section remap="h3">
-      <title><indexterm><primary>configuring</primary><secondary>MX LND</secondary></indexterm>MX LND</title>
-      <para><literal>MXLND</literal> supports a number of load-time parameters using Linux&apos;s module parameter system. The following variables are available:</para>
-      <informaltable frame="all">
-        <tgroup cols="2">
-          <colspec colname="c1" colwidth="50*"/>
-          <colspec colname="c2" colwidth="50*"/>
-          <thead>
-            <row>
-              <entry>
-                <para><emphasis role="bold">Variable</emphasis></para>
-              </entry>
-              <entry>
-                <para><emphasis role="bold">Description</emphasis></para>
-              </entry>
-            </row>
-          </thead>
-          <tbody>
-            <row>
-              <entry>
-                <para> <literal>n_waitd</literal></para>
-              </entry>
-              <entry>
-                <para>Number of completion daemons.</para>
-              </entry>
-            </row>
-            <row>
-              <entry>
-                <para> <literal>max_peers</literal></para>
-              </entry>
-              <entry>
-                <para>Maximum number of peers that may connect.</para>
-              </entry>
-            </row>
-            <row>
-              <entry>
-                <para> <literal>cksum</literal></para>
-              </entry>
-              <entry>
-                <para>Enables small message (below 4 KB) checksums if set to a non-zero value.</para>
-              </entry>
-            </row>
-            <row>
-              <entry>
-                <para> <literal>ntx</literal></para>
-              </entry>
-              <entry>
-                <para>Number of total tx message descriptors.</para>
-              </entry>
-            </row>
-            <row>
-              <entry>
-                <para> <literal>credits</literal></para>
-              </entry>
-              <entry>
-                <para>Number of concurrent sends to a single peer.</para>
-              </entry>
-            </row>
-            <row>
-              <entry>
-                <para> <literal>board</literal></para>
-              </entry>
-              <entry>
-                <para>Index value of the Myrinet board (NIC).</para>
-              </entry>
-            </row>
-            <row>
-              <entry>
-                <para> <literal>ep_id</literal></para>
-              </entry>
-              <entry>
-                <para>MX endpoint ID.</para>
-              </entry>
-            </row>
-            <row>
-              <entry>
-                <para> <literal>polling</literal></para>
-              </entry>
-              <entry>
-                <para>Use zero (0) to block (wait). A value greater than 0 will poll that many times before blocking.</para>
-              </entry>
-            </row>
-            <row>
-              <entry>
-                <para> <literal>hosts</literal></para>
-              </entry>
-              <entry>
-                <para>IP-to-hostname resolution file.</para>
-              </entry>
-            </row>
-          </tbody>
-        </tgroup>
-      </informaltable>
-      <para>Of the described variables, only hosts is required. It must be the absolute path to the MXLND hosts file.</para>
-      <para>For example:</para>
-      <screen>options kmxlnd hosts=/etc/hosts.mxlnd</screen>
-      <para>The file format for the hosts file is:</para>
-      <screen>IP  HOST  BOARD   EP_ID</screen>
-      <para>The values must be space and/or tab separated where:</para>
-      <para><literal>IP</literal> is a valid IPv4 address</para>
-      <para><literal>HOST</literal> is the name returned by <literal>`hostname`</literal> on that machine</para>
-      <para><literal>BOARD</literal> is the index of the Myricom NIC (0 for the first card, etc.)</para>
-      <para><literal>EP_ID</literal> is the MX endpoint ID</para>
-      <para>To obtain the optimal performance for your platform, you may want to vary the remaining options.</para>
-      <para><literal>n_waitd(1)</literal> sets the number of threads that process completed MX requests (sends and receives).</para>
-      <para><literal>max_peers(1024)</literal> tells MXLND the upper limit of machines that it will need to communicate with. This affects how many receives it will pre-post and each receive will use one page of memory. Ideally, on clients, this value will be equal to the total number of Lustre servers (MDS and OSS). On servers, it needs to equal the total number of machines in the storage system. cksum (0) turns on small message checksums. It can be used to aid in troubleshooting. MX also provides an optional checksumming feature which can check all messages (large and small). For details, see the MX README.</para>
-      <para><literal>ntx(256)</literal> is the number of total sends in flight from this machine. In actuality, MXLND reserves half of them for connect messages so make this value twice as large as you want for the total number of sends in flight.</para>
-      <para><literal>credits(8)</literal> is the number of in-flight messages for a specific peer.
-        This is part of the flow-control system in provided by the Lustre software. Increasing this
-        value may improve performance but it requires more memory because each message requires at
-        least one page.</para>
-      <para><literal>board(0)</literal> is the index of the Myricom NIC. Hosts can have multiple Myricom NICs and this identifies which one MXLND should use. This value must match the board value in your MXLND hosts file for this host.</para>
-      <para><literal>ep_id(3)</literal> is the MX endpoint ID. Each process that uses MX is required to have at least one MX endpoint to access the MX library and NIC. The ID is a simple index starting at zero (0). This value must match the endpoint ID value in your MXLND hosts file for this host.</para>
-      <para><literal>polling(0)</literal> determines whether this host will poll or block for MX request completions. A value of 0 blocks and any positive value will poll that many times before blocking. Since polling increases CPU usage, we suggest that you set this to zero (0) on the client and experiment with different values for servers.</para>
-    </section>
   </section>
 </chapter>
index f83ca48..58069ff 100644 (file)
@@ -198,7 +198,7 @@ lctl get_param mdt.*.nosquash_nids</screen>
            &lt;number&gt; &apos;-&apos; &lt;number&gt; &apos;/&apos; &lt;number&gt;
 &lt;net&gt;        :== &lt;netname&gt; | &lt;netname&gt;&lt;number&gt;
 &lt;netname&gt;    :== &quot;lo&quot; | &quot;tcp&quot; | &quot;o2ib&quot; | &quot;cib&quot; | &quot;openib&quot; | &quot;iib&quot; | 
-           &quot;vib&quot; | &quot;ra&quot; | &quot;elan&quot; | &quot;gm&quot; | &quot;mx&quot;
+           &quot;vib&quot; | &quot;ra&quot; | &quot;elan&quot;
 &lt;number&gt;     :== &lt;nonnegative decimal&gt; | &lt;hexadecimal&gt;</screen>
       <note>
         <para>For networks using numeric addresses (e.g. elan), the address range must be specified in the <literal>&lt;numaddr_range&gt;</literal> syntax. For networks using IP addresses, the address range must be in the <literal>&lt;ipaddr_range&gt;</literal>. For example, if elan is using numeric addresses, <literal>1.2.3.4@elan</literal> is incorrect.</para>
index 0299cd0..2e6a08f 100644 (file)
@@ -258,7 +258,7 @@ $ lctl conf_param testfs.llite.max_read_ahead_mb=16 </screen>
           <tbody>
             <row>
               <entry>
-                <para> <literal>network up|down|tcp|elan|myrinet</literal></para>
+                <para> <literal>network up|down|tcp|elan</literal></para>
               </entry>
               <entry>
                 <para> Starts or stops LNet, or selects a network type for other <literal>lctl</literal> LNet commands.</para>
index 27a65b1..35ef92c 100644 (file)
         <para> TCP (any network carrying TCP traffic, including GigE, 10GigE, and IPoIB)</para>
       </listitem>
       <listitem>
-        <para> Myrinet: MX</para>
-      </listitem>
-      <listitem>
         <para> RapidArray: ra</para>
       </listitem>
       <listitem>