Browse Source

Merge pull request #14124 from JamesDeFabia/HPCC-21110installBundlesOnServer

HPCC-21110 Document how to install bundles on server

Reviewed-By: Greg Panagiotatos <Greg.Panagiotatos@lexisnexis.com>
Reviewed-By: Richard Chapman <rchapman@hpccsystems.com>
Richard Chapman 4 years ago
parent
commit
15e514ef1f
1 changed files with 37 additions and 0 deletions
  1. 37 0
      docs/EN_US/HPCCClientTools/CT_Mods/CT_ECL_CLI.xml

+ 37 - 0
docs/EN_US/HPCCClientTools/CT_Mods/CT_ECL_CLI.xml

@@ -4765,6 +4765,43 @@ ecl bundle install mybundle --keepprior</programlisting>
         <para>To use the "ecl bundle install &lt;git url&gt;" command, you
         must have git installed and configured on your system. Git must be
         accessible to the user (in the path).</para>
+
+        <para><emphasis role="bold">Server-side Installation</emphasis></para>
+
+        <para>A system using ECL Server and a remote MySQL repository or ECLCC
+        Server with git hooks can only access bundles if they are installed on
+        the server. Using a bundle in the ECL Playground also requires
+        installation on the ECLCC Server node.</para>
+
+        <para></para>
+
+        <orderedlist>
+          <listitem>
+            <para>In a terminal window on your ECLCC Server (or ECL Server),
+            use this command:</para>
+
+            <para><programlisting>sudo su hpcc</programlisting>This switches
+            the user to <emphasis role="bold">hpcc</emphasis>.</para>
+          </listitem>
+
+          <listitem>
+            <para>Next install the bundle using this command:</para>
+
+            <programlisting>ecl bundle install &lt;bundle URL&gt;.git </programlisting>
+
+            <para>For example: </para>
+
+            <para><programlisting>ecl bundle install https://github.com/hpcc-systems/Visualizer.git</programlisting></para>
+          </listitem>
+
+          <listitem>
+            <para>Close the terminal window or use the <emphasis
+            role="bold">exit</emphasis> command to return to acting as the
+            original user.</para>
+          </listitem>
+        </orderedlist>
+
+        <para></para>
       </sect2>
 
       <sect2 id="CT_CLI_SyntaxECLBundleUninstall" role="brk">