Whamcloud - gitweb
LUDOC-392 lnet: clarify lnetctl usage 23/29323/2
authorAmir Shehata <amir.shehata@intel.com>
Wed, 4 Oct 2017 22:33:45 +0000 (15:33 -0700)
committerJoseph Gmitter <joseph.gmitter@intel.com>
Tue, 24 Oct 2017 20:19:01 +0000 (20:19 +0000)
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>
ConfiguringLNet.xml

index da67cbb..d4077af 100755 (executable)
     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>