From: Amir Shehata <amir.shehata@intel.com>
Date: Wed, 4 Oct 2017 22:33:45 +0000 (-0700)
Subject: LUDOC-392 lnet: clarify lnetctl usage
X-Git-Tag: 2.11.0~17
X-Git-Url: https://git.whamcloud.com/?a=commitdiff_plain;h=fae83cf58a7e0a4830d67979ac7f1d4fa2ee5ceb;p=doc%2Fmanual.git

LUDOC-392 lnet: clarify lnetctl usage

When using lnetctl to manage an LNet configured outside of
lnetctl, lnetctl lnet configure must be called first before
lnetctl can add or remove networks and interfaces.

Signed-off-by: Amir Shehata <amir.shehata@intel.com>
Change-Id: Ie61dad46bb40353701e19a28dc96c15d80a7afb7
Reviewed-on: https://review.whamcloud.com/29323
Tested-by: Jenkins
Reviewed-by: Sonia Sharma <sonia.sharma@intel.com>
Reviewed-by: Joseph Gmitter <joseph.gmitter@intel.com>
---

diff --git a/ConfiguringLNet.xml b/ConfiguringLNet.xml
index da67cbb..d4077af 100755
--- a/ConfiguringLNet.xml
+++ b/ConfiguringLNet.xml
@@ -45,9 +45,12 @@
     required if you are using Infiniband or multiple Ethernet
     interfaces.</para>
     <para condition='l27'>The <literal>lnetctl</literal> utility can be used
-    to initialize LNet without bringing up any network interfaces.  This
-    gives flexibility to the user to add interfaces after LNet has been
-    loaded.</para>
+    to initialize LNet without bringing up any network interfaces. Network
+    interfaces can be added after configuring LNet via <literal>lnetctl</literal>. 
+    <literal>lnetctl</literal> can also be used to manage an operational LNet.
+    However, if it wasn't initialized by <literal>lnetctl</literal> then 
+    <literal>lnetctl lnet configure</literal> must be invoked before 
+    <literal>lnetctl</literal> can be used to manage LNet.</para>
     <para condition='l27'>DLC also introduces a C-API to enable
     configuring LNet programatically.  See <xref
     linkend="lnetconfigurationapi"/></para>