Browse Source

Merge branch 'H10141-MultiCT' into candidate-4.2.4

Signed-off-by: Richard Chapman <rchapman@hpccsystems.com>
Richard Chapman 11 năm trước cách đây
mục cha
commit
79c5377b94
1 tập tin đã thay đổi với 95 bổ sung6 xóa
  1. 95 6
      docs/HPCCClientTools/CT_Mods/CT_Overview_withoutIDE.xml

+ 95 - 6
docs/HPCCClientTools/CT_Mods/CT_Overview_withoutIDE.xml

@@ -82,8 +82,8 @@
 
         <para><itemizedlist>
             <listitem>
-              <para>Keyboard and mouse actions are shown in small caps, such
-              as: DOUBLE-CLICK, or press the ENTER key. word.</para>
+              <para>Keyboard and mouse actions are shown in all caps, such as:
+              DOUBLE-CLICK, or press the ENTER keyword.</para>
             </listitem>
 
             <listitem>
@@ -106,7 +106,8 @@
           url="http://hpccsystems.com/download/free-community-edition/client-tools">http://hpccsystems.com/download/free-community-edition/client-tools</ulink></para>
 
           <para>Download the appropriate Client Tools for your Operating
-          System. (available for CentOS, Ubuntu, Mac OSX, or Windows)</para>
+          System. (available for RPM-Based systems, Debian-Based systems, Mac
+          OSX, or Windows)</para>
         </listitem>
 
         <listitem>
@@ -135,11 +136,99 @@
 
           <para><emphasis role="bold">Mac OSX:</emphasis></para>
 
-          <para>Run the installation file, for example:
-          hpccsystems-clienttools_community-4.X.X-XDarwin-x86_64.dmg. Follow
-          the prompts to complete the installation.</para>
+          <para>Open the Apple disk image file (.dmg) and then run the
+          installation package (.pkg). Follow the prompts to complete the
+          installation.</para>
         </listitem>
       </orderedlist>
     </sect2>
+
+    <sect2 id="Other_Installs">
+      <title>Multiple Version Installations</title>
+
+      <para>It is possible to install multiple versions of the client tools if
+      you need to work with multiple versions of the platform.</para>
+
+      <para>To install the client tools, obtain the appropriate installation
+      package for your operating system and the version to match your HPCC
+      Systems server:</para>
+
+      <orderedlist>
+        <listitem>
+          <para>Download the appropriate Client Tools for your Operating
+          System and version.</para>
+
+          <para>Client tools can be found at the HPCC Systems download
+          page:</para>
+
+          <para><ulink
+          url="http://hpccsystems.com/download/free-community-edition/client-tools">http://hpccsystems.com/download/free-community-edition/client-tools</ulink></para>
+
+          <variablelist>
+            <varlistentry>
+              <term>NOTE:</term>
+
+              <listitem>
+                <para>There is a link at the bottom of the list "<emphasis
+                role="blue">view older downloads</emphasis>" if you are
+                looking for previous versions.</para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
+        </listitem>
+
+        <listitem>
+          <para>Install the Client Tools on to your system. Take note of the
+          following considerations:</para>
+        </listitem>
+      </orderedlist>
+
+      <para>Client tool packages starting with 4.2 have built in logic to
+      allow for multiple installations. Prior versions of the client tools
+      package would just overwrite the existing components. The default
+      behavior is that the client tools will use the last one installed,
+      except if you are working directly on the platform. If you are working
+      directly on the platform then it would use the client tools package that
+      gets installed with the platform.</para>
+
+      <para>If you install a version other than the delivered client tools you
+      will have a folder in /opt/HPCCSystems that corresponds to the set of
+      client tools. So you could have a client tools 4.0.x, 4.2.x, 4.4.x,
+      etc.</para>
+
+      <para>For older versions, download the package(s), and install. Install
+      the one you want to use last. Copy to a different folder or Rename the
+      client tools found in /opt/HPCCSystems after installing the older
+      version and before installing the newer version. This is to prevent the
+      newer client tools from overwriting the older one. </para>
+
+      <para>To use the Client tools for the various version number(s)
+      explicitly call the client tool you wish to use, or set up an alias to
+      call the client tool using the proper path or name for the version you
+      intend to use. This would depend on how you chose to save off the older
+      client tools you installed.</para>
+
+      <para><emphasis role="bold">For example</emphasis>, if you wanted to run
+      eclplus:</para>
+
+      <programlisting>eclplus action=view wuid=W12345678</programlisting>
+
+      <para>To run eclplus for an older or another version of client tools,
+      for instance 4.0.x:</para>
+
+      <para><programlisting>/opt/HPCCSystems/4.0.x/clienttools/bin/eclplus action=view wuid=W12345678</programlisting></para>
+
+      <para><emphasis role="bold">Windows</emphasis></para>
+
+      <para>Client tools for Windows installs in a directory such as:
+      C:\Program Files (x86)\HPCCSystems\4.2.0\clientools where the number
+      (4.2.0 for example) corresponds to the version of the client tools.
+      </para>
+
+      <para>The Windows installer will prompt you to delete the previous
+      version during installation. If you want to keep both, decline the offer
+      to uninstall, and choose a different installation directory at the next
+      prompt.</para>
+    </sect2>
   </sect1>
 </chapter>