|
@@ -2,10 +2,10 @@
|
|
|
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
|
|
<book lang="en_US" xml:base="../">
|
|
|
- <title>Installing & Running the HPCC Platform</title>
|
|
|
+ <title>Installing & Running the HPCC Systems<superscript>®</superscript> Platform</title>
|
|
|
|
|
|
<bookinfo>
|
|
|
- <title>Installing & Running the HPCC Platform</title>
|
|
|
+ <title>Installing & Running the HPCC Systems<superscript>®</superscript> Platform</title>
|
|
|
|
|
|
<mediaobject>
|
|
|
<imageobject>
|
|
@@ -74,16 +74,16 @@
|
|
|
<ulink
|
|
|
url="https://hpccsystems.com/Why-HPCC/How-it-works">https://hpccsystems.com/Why-HPCC/How-it-works</ulink>
|
|
|
for more details.</para>
|
|
|
- </footnote> Community Edition on a single node to start and then
|
|
|
+ </footnote> Systems<superscript>®</superscript> Community Edition on a single node to start and then
|
|
|
optionally, expand it to a larger cluster of nodes.</para>
|
|
|
|
|
|
- <para>The HPCC Thor technology is designed to effectively process,
|
|
|
+ <para>The HPCC Systems Thor technology is designed to effectively process,
|
|
|
analyze, and find links and associations within high volumes of complex
|
|
|
data. This can detect non-obvious relationships, scale to support
|
|
|
petabytes of data, and is significantly faster than competing technologies
|
|
|
while requiring less hardware and resources.</para>
|
|
|
|
|
|
- <para>The HPCC Roxie technology - also known as the Rapid Data Delivery
|
|
|
+ <para>The HPCC Systems Roxie technology - also known as the Rapid Data Delivery
|
|
|
Engine or RDDE - uses a combination of technologies and techniques that
|
|
|
produce extremely fast throughput for queries on indexed data.</para>
|
|
|
|
|
@@ -116,14 +116,14 @@
|
|
|
|
|
|
<para>We recommend taking the time to read this manual in its entirety;
|
|
|
however, the following is a quick start summary of steps. There are many
|
|
|
- aspects of the HPCC System platform and this guide is intended to help
|
|
|
+ aspects of the HPCC Systems platform and this guide is intended to help
|
|
|
you get the most out of your system. This section is not intended to
|
|
|
replace the more comprehensive material in the remainder of this
|
|
|
book.</para>
|
|
|
|
|
|
<orderedlist>
|
|
|
<listitem>
|
|
|
- <para>Install HPCC.</para>
|
|
|
+ <para>Install HPCC Systems platform.</para>
|
|
|
|
|
|
<para>Download the installation package from <ulink
|
|
|
url="https://hpccsystems.com/download/free-community-edition">https://hpccsystems.com/download</ulink>
|
|
@@ -142,7 +142,7 @@
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
- <para>Start your HPCC System.</para>
|
|
|
+ <para>Start your HPCC Systems platform.</para>
|
|
|
|
|
|
<xi:include href="Installing_and_RunningTheHPCCPlatform/Inst-Mods/SysDStart.xml"
|
|
|
xpointer="element(/1)"
|
|
@@ -162,7 +162,7 @@
|
|
|
system.</para>
|
|
|
|
|
|
<para>Using a browser, go to <emphasis role="bold">ECL
|
|
|
- Watch</emphasis> running on port 8010 of your HPCC Node.</para>
|
|
|
+ Watch</emphasis> running on port 8010 of your HPCC Systems Node.</para>
|
|
|
|
|
|
<para>For example, http://nnn.nnn.nnn.nnn:8010, where
|
|
|
nnn.nnn.nnn.nnn is your node's IP address.</para>
|
|
@@ -186,7 +186,7 @@
|
|
|
<sect2 id="Installing_NowWhat">
|
|
|
<title>Now What?</title>
|
|
|
|
|
|
- <para>Now that you have HPCC started and running, what do you want to
|
|
|
+ <para>Now that you have HPCC Systems started and running, what do you want to
|
|
|
do? Maybe evaluate your needs and proceed to develop a custom
|
|
|
configuration suitable for those needs. Maybe you want to expand your
|
|
|
system and add nodes. Those topics and several others are covered in
|
|
@@ -195,7 +195,7 @@
|
|
|
<para>To familiarize yourself with what your system can do we
|
|
|
recommend following the steps in:<itemizedlist spacing="compact">
|
|
|
<listitem>
|
|
|
- <para>The <emphasis role="bold">HPCC Data
|
|
|
+ <para>The <emphasis role="bold">HPCC Systems Data
|
|
|
Tutorial</emphasis></para>
|
|
|
</listitem>
|
|
|
|
|
@@ -206,7 +206,7 @@
|
|
|
|
|
|
<listitem>
|
|
|
<para>Read <emphasis role="bold">Using Config Manager</emphasis>
|
|
|
- to learn how to configure an HPCC platform using Advanced
|
|
|
+ to learn how to configure an HPCC Systems platform using Advanced
|
|
|
View.</para>
|
|
|
</listitem>
|
|
|
|
|
@@ -220,7 +220,7 @@
|
|
|
</chapter>
|
|
|
|
|
|
<chapter id="HPCC-installation-and-startup">
|
|
|
- <title>HPCC Installation and Startup</title>
|
|
|
+ <title>HPCC Systems Installation and Startup</title>
|
|
|
|
|
|
<para>Follow these steps to install the packages and start components in a
|
|
|
single-node configuration to begin. Once it is successfully installed, you
|
|
@@ -228,7 +228,7 @@
|
|
|
system.</para>
|
|
|
|
|
|
<para>Configuration Manager is the utility with which we configure the
|
|
|
- HPCC platform. It is run on your Linux Server and you access its interface
|
|
|
+ HPCC Systems platform. It is run on your Linux Server and you access its interface
|
|
|
using a browser.<figure>
|
|
|
<title>System Overview: Thor</title>
|
|
|
|
|
@@ -250,9 +250,9 @@
|
|
|
<sect1 id="initial-set-up-single-node">
|
|
|
<title>Initial Setup-Single Node</title>
|
|
|
|
|
|
- <para>This section covers installing the HPCC on a single node. This
|
|
|
- will enable the HPCC system to operate successfully; however, the real
|
|
|
- strength of the HPCC is when it is run in a multi-node environment and
|
|
|
+ <para>This section covers installing the HPCC Systems on a single node. This
|
|
|
+ will enable the HPCC Systems platform to operate successfully; however, the real
|
|
|
+ strength of the HPCC Systems platform is when it is run in a multi-node environment and
|
|
|
can leverage the ability to perform operations using Massively Parallel
|
|
|
Processing (MPP).</para>
|
|
|
|
|
@@ -446,14 +446,14 @@ gpgcheck=0</programlisting></para>
|
|
|
role="bold">L</emphasis>anguage (ECL) is a declarative, data
|
|
|
centric programming language used to manage all aspects of the
|
|
|
massive data joins, sorts, and builds that truly differentiate
|
|
|
- HPCC (High Performance Computing Cluster) from other technologies
|
|
|
+ HPCC Systems (High Performance Computing Cluster) from other technologies
|
|
|
in its ability to provide flexible data analysis on a massive
|
|
|
scale.</para>
|
|
|
</footnote> code using either ECL IDE, the command line ECL
|
|
|
compiler, or the ECL Command line tool.</para>
|
|
|
|
|
|
<sect3 id="InstallTheECLIDEandClientTools">
|
|
|
- <title>Install the ECL IDE and HPCC Client Tools</title>
|
|
|
+ <title>Install the ECL IDE and HPCC Systems Client Tools</title>
|
|
|
|
|
|
<para><orderedlist>
|
|
|
<listitem>
|
|
@@ -502,7 +502,7 @@ gpgcheck=0</programlisting></para>
|
|
|
</mediaobject>
|
|
|
</figure></para>
|
|
|
|
|
|
- <para>Follow the link to the HPCC System's portal download
|
|
|
+ <para>Follow the link to the HPCC Systems portal download
|
|
|
page.</para>
|
|
|
|
|
|
<para>Alternatively, you could use your browser to go directly
|
|
@@ -612,17 +612,17 @@ gpgcheck=0</programlisting></para>
|
|
|
used to submit it to a target cluster for compilation by the remote
|
|
|
compiler server (eclccserver).</para>
|
|
|
|
|
|
- <para>To submit a job using the ecl CLI, make sure the HPCC has been
|
|
|
+ <para>To submit a job using the ECL CLI, make sure the HPCC Systems platform has been
|
|
|
started and use the following syntax: <programlisting>ecl run hello.ecl --target=hthor --server=<IP Address of the ESP node>:8010</programlisting></para>
|
|
|
|
|
|
<para>The workunit<footnote>
|
|
|
- <para>A Workunit is a record of a task submitted to an HPCC. It
|
|
|
+ <para>A Workunit is a record of a task submitted to an HPCC Systems cluster. It
|
|
|
contains an identifier--workunit ID, the ECL code, results, and
|
|
|
other information about the job.</para>
|
|
|
</footnote> result is returned to the command line.</para>
|
|
|
|
|
|
<para>View the full details of the workunit using the ECL Watch
|
|
|
- interface for your HPCC at this location
|
|
|
+ interface for your HPCC Systems platform at this location
|
|
|
http://nnn.nnn.nnn.nnn:8010, where nnn.nnn.nnn.nnn is the IP of your
|
|
|
ESP server node. Either search for the workunit using the workunit
|
|
|
ID or select ECL Workunits/Browse and find your workunit in the list
|
|
@@ -631,7 +631,7 @@ gpgcheck=0</programlisting></para>
|
|
|
<para>Setting up an <emphasis role="bold">ecl.ini</emphasis> file
|
|
|
makes running a workunit a little easier when you want to use the
|
|
|
same settings every time you submit a workunit in this way. See the
|
|
|
- <emphasis>HPCC Client Tools </emphasis>manual for details.</para>
|
|
|
+ <emphasis>HPCC Systems Client Tools </emphasis>manual for details.</para>
|
|
|
|
|
|
<para>If your ECL is more complex than a single source file, you can
|
|
|
use the eclcc compiler locally to create an archive to be sent to
|
|
@@ -716,7 +716,7 @@ gpgcheck=0</programlisting></para>
|
|
|
target cluster.</para>
|
|
|
|
|
|
<para><emphasis role="bold">Thor</emphasis> is the Data
|
|
|
- Refinery component of your HPCC. It is a disk based massively
|
|
|
+ Refinery component of your HPCC Systems platform. It is a disk based massively
|
|
|
parallel computer cluster, optimized for sorting,
|
|
|
manipulating, and transforming massive data.</para>
|
|
|
|
|
@@ -792,7 +792,7 @@ gpgcheck=0</programlisting></para>
|
|
|
<title>Configuring a Multi-Node System</title>
|
|
|
|
|
|
<para>While the single-node system is fully-functional, it does not take
|
|
|
- advantage of the true power of an HPCC--the ability to perform
|
|
|
+ advantage of the true power of HPCC Systems--the ability to perform
|
|
|
operations using Massively Parallel Processing (MPP). This section
|
|
|
provides the steps to expand your single-node system into a multi-node
|
|
|
system using the Configuration Manager Wizard.</para>
|
|
@@ -813,7 +813,7 @@ gpgcheck=0</programlisting></para>
|
|
|
|
|
|
<orderedlist>
|
|
|
<listitem>
|
|
|
- <para>If it is running, stop the HPCC system, using this
|
|
|
+ <para>If it is running, stop the HPCC Systems platform, using this
|
|
|
command:</para>
|
|
|
|
|
|
<xi:include href="Installing_and_RunningTheHPCCPlatform/Inst-Mods/SysDStop.xml"
|
|
@@ -833,7 +833,7 @@ gpgcheck=0</programlisting></para>
|
|
|
<entry><inlinegraphic
|
|
|
fileref="images/OSSgr3.png" /></entry>
|
|
|
|
|
|
- <entry>You can use this command to confirm HPCC
|
|
|
+ <entry>You can use this command to confirm HPCC Systems
|
|
|
processes are stopped:<para><programlisting>sudo systemctl status hpccsystems-platform.target</programlisting></para></entry>
|
|
|
</row>
|
|
|
</tbody>
|
|
@@ -888,7 +888,7 @@ gpgcheck=0</programlisting></para>
|
|
|
<listitem>
|
|
|
<?dbfo keep-together="always"?>
|
|
|
|
|
|
- <para>Enter all the IP addresses you want to use for this HPCC.
|
|
|
+ <para>Enter all the IP addresses you want to use for this HPCC Systems cluster.
|
|
|
Alternatively, you could enter the hostname(s).</para>
|
|
|
|
|
|
<para>The IP addresses do not need to be contiguous. In the image
|
|
@@ -1102,9 +1102,9 @@ sudo cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/environment.
|
|
|
|
|
|
<listitem>
|
|
|
<para>If you have added new machines to the cluster, you need to
|
|
|
- copy and install the HPCC package onto all nodes, and generate and
|
|
|
+ copy and install the HPCC Systems package onto all nodes, and generate and
|
|
|
clone the SSH keys. This can be done using the install-cluster.sh
|
|
|
- script which is provided with HPCC. Use the following
|
|
|
+ script which is provided with HPCC Systems. Use the following
|
|
|
command:</para>
|
|
|
|
|
|
<programlisting>/opt/HPCCSystems/sbin/install-cluster.sh -k <package-file-name></programlisting>
|
|
@@ -1124,7 +1124,7 @@ sudo cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/environment.
|
|
|
role="bold">every</emphasis> node.</para>
|
|
|
|
|
|
<para>You may want to create a script to push out the XML file to
|
|
|
- all nodes. A sample script is provided with HPCC. The following
|
|
|
+ all nodes. A sample script is provided with HPCC Systems. The following
|
|
|
command copies the XML files out to all nodes as required:</para>
|
|
|
|
|
|
<para><programlisting>sudo /opt/HPCCSystems/sbin/hpcc-push.sh -s <sourcefile> -t <destinationfile>
|
|
@@ -1140,9 +1140,9 @@ sudo cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/environment.
|
|
|
|
|
|
<orderedlist continuation="continues">
|
|
|
<listitem>
|
|
|
- <para>Restart the HPCC system on <emphasis
|
|
|
+ <para>Restart the HPCC Systems on <emphasis
|
|
|
role="bold">every</emphasis> node. The following command starts
|
|
|
- the HPCC system on an individual node:</para>
|
|
|
+ HPCC Systems on an individual node:</para>
|
|
|
|
|
|
<xi:include href="Installing_and_RunningTheHPCCPlatform/Inst-Mods/SysDStart.xml"
|
|
|
xpointer="element(/1)"
|
|
@@ -1163,14 +1163,14 @@ sudo cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/environment.
|
|
|
|
|
|
<entry><para>You may want to use a script to push this
|
|
|
command out to every node. A sample script is provided
|
|
|
- with HPCC. Use the following command to start HPCC on all
|
|
|
+ with HPCC Systems. Use the following command to start HPCC Systems on all
|
|
|
nodes:</para><para><programlisting>sudo /opt/HPCCSystems/sbin/hpcc-run.sh systemctl start hpccsystems-platform.target</programlisting></para></entry>
|
|
|
</row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</informaltable>
|
|
|
|
|
|
- <para>This script can also be used to stop HPCC on all nodes and
|
|
|
+ <para>This script can also be used to stop HPCC Systems on all nodes and
|
|
|
to start and stop individual components on all nodes. See the
|
|
|
appendix (<link linkend="Example-Scripts">Appendix:Example
|
|
|
Scripts</link>) for more details.</para>
|
|
@@ -1180,7 +1180,7 @@ sudo cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/environment.
|
|
|
<sect3 id="Addl_SSH_KeyInfo">
|
|
|
<title>Additional SSH Key Information</title>
|
|
|
|
|
|
- <para>On a multi-node HPCC system, certificates and SSH keys must
|
|
|
+ <para>On multi-node HPCC Systems, certificates and SSH keys must
|
|
|
all match across all nodes for the system to work properly. If you
|
|
|
used the <emphasis>install-cluster.sh</emphasis> script as outlined
|
|
|
in the steps above, this would make sure that everything is properly
|
|
@@ -1219,7 +1219,7 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
<sect3 id="StartStop_ToStartSystem">
|
|
|
<title>To start the system:</title>
|
|
|
|
|
|
- <para>To start your HPCC system issue the following command;</para>
|
|
|
+ <para>To start your HPCC Systems platform issue the following command;</para>
|
|
|
|
|
|
<xi:include href="Installing_and_RunningTheHPCCPlatform/Inst-Mods/SysDStart.xml"
|
|
|
xpointer="element(/1)"
|
|
@@ -1232,7 +1232,7 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
<sect3 id="StartStop_StopTheSystem">
|
|
|
<title>To stop the system:</title>
|
|
|
|
|
|
- <para>To stop your HPCC system issue the following command;</para>
|
|
|
+ <para>To stop your HPCC Systems platform issue the following command;</para>
|
|
|
|
|
|
<xi:include href="Installing_and_RunningTheHPCCPlatform/Inst-Mods/SysDStop.xml"
|
|
|
xpointer="element(/1)"
|
|
@@ -1289,7 +1289,7 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
|
|
|
<orderedlist>
|
|
|
<listitem>
|
|
|
- <para>If the system is running, stop the HPCC system, using this
|
|
|
+ <para>If the system is running, stop the HPCC Systems platform, using this
|
|
|
command on <emphasis role="bold">every</emphasis> node:</para>
|
|
|
|
|
|
<xi:include href="Installing_and_RunningTheHPCCPlatform/Inst-Mods/SysDStop.xml"
|
|
@@ -1340,14 +1340,14 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
<title>More Examples</title>
|
|
|
|
|
|
<para>This section contains additional ECL examples you can use on your
|
|
|
- HPCC cluster. You can run these on a single-node system or a larger
|
|
|
+ HPCC Systems cluster. You can run these on a single-node system or a larger
|
|
|
multi-node cluster.</para>
|
|
|
|
|
|
<sect1 id="IR_AnagramExamples" role="nobrk">
|
|
|
<title>Anagram Examples</title>
|
|
|
|
|
|
- <para>The following examples display some of things that HPCC can do.
|
|
|
- Running through these examples will help your understanding of HPCC and
|
|
|
+ <para>The following examples display some of things that HPCC Systems can do.
|
|
|
+ Running through these examples will help your understanding of HPCC Systems and
|
|
|
ECL.</para>
|
|
|
|
|
|
<xi:include href="Installing_and_RunningTheHPCCPlatform/Inst-Mods/anagram1.xml"
|
|
@@ -1364,7 +1364,7 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
<title>Next Steps</title>
|
|
|
|
|
|
<para>Available from the menu in the ECL IDE there are several documents
|
|
|
- which provide details on various aspects of the HPCC.</para>
|
|
|
+ which provide details on various aspects of the HPCC Systems.</para>
|
|
|
|
|
|
<para>You can access them from the help menu: Help <emphasis
|
|
|
role="bold">>></emphasis> Documentation.</para>
|
|
@@ -1390,7 +1390,7 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
<para>To familiarize yourself with what your system can do we recommend
|
|
|
following the steps in<itemizedlist spacing="compact">
|
|
|
<listitem>
|
|
|
- <para>The <emphasis role="bold">HPCC Data Tutorial</emphasis></para>
|
|
|
+ <para>The <emphasis role="bold">HPCC Systems Data Tutorial</emphasis></para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
@@ -1400,7 +1400,7 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
|
|
|
<listitem>
|
|
|
<para>Read <emphasis role="bold">Using Config Manager</emphasis> to
|
|
|
- learn how to configure an HPCC platform using Advanced View.</para>
|
|
|
+ learn how to configure an HPCC Systems platform using Advanced View.</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
@@ -1488,7 +1488,7 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
<row>
|
|
|
<entry><package-name></entry>
|
|
|
|
|
|
- <entry>Name of the HPCC package to install. Required</entry>
|
|
|
+ <entry>Name of the HPCC Systems package to install. Required</entry>
|
|
|
</row>
|
|
|
|
|
|
<row>
|
|
@@ -1538,7 +1538,7 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
- <para>installs the HPCC platform package(s) on all nodes
|
|
|
+ <para>installs the HPCC Systems platform package(s) on all nodes
|
|
|
specified.</para>
|
|
|
</listitem>
|
|
|
|
|
@@ -1568,7 +1568,7 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
<para><?hard-pagebreak ?><emphasis
|
|
|
role="bold">Examples:</emphasis></para>
|
|
|
|
|
|
- <para>This example installs the HPCC Platform packages to remaining
|
|
|
+ <para>This example installs the HPCC Systems platform packages to remaining
|
|
|
nodes and pushes out the active environment.xml file to those
|
|
|
nodes.:</para>
|
|
|
|
|
@@ -1577,7 +1577,7 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
|
|
|
<para>(where <emphasis>n.n.nnnn</emphasis> is the build number)</para>
|
|
|
|
|
|
- <para>This example installs the HPCC Platform packages to all nodes
|
|
|
+ <para>This example installs the HPCC Systems platform packages to all nodes
|
|
|
and pushes out the active environment.xml file to those nodes. It also
|
|
|
generates ssh keys and pushes them out to all nodes.</para>
|
|
|
|
|
@@ -1586,7 +1586,7 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
|
|
|
<para>(where <emphasis>n.n.nnnn</emphasis> is the build number)</para>
|
|
|
|
|
|
- <para>This example installs the HPCC Platform packages and pushes out
|
|
|
+ <para>This example installs the HPCC Systems platform packages and pushes out
|
|
|
the active environment.xml file to 8 concurrent nodes.:</para>
|
|
|
|
|
|
<para><programlisting>sudo /opt/HPCCSystems/sbin/install-cluster.sh -n 8 hpccsystems-platform-xxxx-<emphasis>n.n.nnnn</emphasis>
|
|
@@ -1688,7 +1688,7 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
</informaltable></para>
|
|
|
|
|
|
<para>The <emphasis role="bold">deploy-java-files.sh</emphasis>
|
|
|
- script, is used to deploy java files (source) to HPCC cluster hosts
|
|
|
+ script, is used to deploy java files (source) to HPCC Systems cluster hosts
|
|
|
and update the classpath variable in environment.conf.</para>
|
|
|
|
|
|
<para>This script runs a command on all IP addresses or host names in
|
|
@@ -1802,7 +1802,7 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
<row>
|
|
|
<entry>-c, --comp</entry>
|
|
|
|
|
|
- <entry>HPCC component. For example, dali@mydali.service,
|
|
|
+ <entry>HPCC Systems component. For example, dali@mydali.service,
|
|
|
roxie@myroxie.service, etc.</entry>
|
|
|
</row>
|
|
|
|
|
@@ -1865,9 +1865,9 @@ sudo /opt/HPCCSystems/sbin/hpcc-push.sh \
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="Uninstalling-the-HPCC">
|
|
|
- <title>Uninstalling the HPCC Platform</title>
|
|
|
+ <title>Uninstalling the HPCC Systems Platform</title>
|
|
|
|
|
|
- <para>To uninstall the HPCC platform, issue the appropriate commands for
|
|
|
+ <para>To uninstall the HPCC Systems platform, issue the appropriate commands for
|
|
|
your system. If necessary, do so on each node that it is installed
|
|
|
on.</para>
|
|
|
|
|
@@ -1915,7 +1915,7 @@ init_start_thor--></property></para>
|
|
|
<title>hpcc-init</title>
|
|
|
|
|
|
<para>CentOS 6 and other System V based operating systems do not support
|
|
|
- the systemd calls utilized by the HPCC System. We will continue to
|
|
|
+ the systemd calls utilized by HPCC Systems. We will continue to
|
|
|
support the old System V style init.d calls.</para>
|
|
|
|
|
|
<para><emphasis role="bold">hpcc-init
|
|
@@ -2016,7 +2016,7 @@ init_start_thor--></property></para>
|
|
|
</tgroup>
|
|
|
</informaltable>The <emphasis role="bold">hpcc-init
|
|
|
</emphasis>function is used to start, stop, restart, setup, or check the
|
|
|
- status of any or all HPCC components.</para>
|
|
|
+ status of any or all HPCC Systems components.</para>
|
|
|
|
|
|
<?hard-pagebreak ?>
|
|
|
|
|
@@ -2032,7 +2032,7 @@ sudo /etc/init.d/hpcc-init -c esp start
|
|
|
</programlisting>
|
|
|
|
|
|
<sect2 id="HPCC_systemd_svc">
|
|
|
- <title>HPCC systemd services</title>
|
|
|
+ <title>HPCC Systems systemd services</title>
|
|
|
|
|
|
<para>HPCC Systems is extending support and development to more
|
|
|
systemd services. We intend to continue support for Cent OS 6 and
|
|
@@ -2040,7 +2040,7 @@ sudo /etc/init.d/hpcc-init -c esp start
|
|
|
system service will support "start", "stop" and "restart"
|
|
|
options.</para>
|
|
|
|
|
|
- <para>The reporting and logging for HPCC systemd will differ from the
|
|
|
+ <para>The reporting and logging for HPCC Systems systemd will differ from the
|
|
|
previous hpcc-init type. The systemd logs do not have any output to
|
|
|
STDOUT/STDERROR, instead it logs to /var/log/syslog. To view the
|
|
|
output:</para>
|
|
@@ -2060,14 +2060,14 @@ sudo /etc/init.d/hpcc-init -c esp start
|
|
|
|
|
|
<programlisting>/etc/init.d/hpcc-init status</programlisting>
|
|
|
|
|
|
- <para>HPCC services started through systemd will be listed as active
|
|
|
+ <para>HPCC Systems services started through systemd will be listed as active
|
|
|
in systemd. They can be listed as "sudo systemctl list-units
|
|
|
[PATTERN...]". To remove them from the systemd active service list,
|
|
|
you must run the stop service from the "service" or "systemctl"
|
|
|
commands (as shown above) even though it is already stopped by
|
|
|
directly calling /etc/init.d/<hpcc-init|dafilesrv> stop.</para>
|
|
|
|
|
|
- <para>HPCC uninstall will automatically remove HPCC services from
|
|
|
+ <para>HPCC Systems uninstall will automatically remove HPCC Systems services from
|
|
|
active list and /etc/systemd/system/ directory.</para>
|
|
|
</sect2>
|
|
|
</sect1>
|
|
@@ -2129,7 +2129,7 @@ sudo /etc/init.d/hpcc-init -c esp start
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
- <para>Install the HPCC ECL IDE (Double-click the setup.msi file and
|
|
|
+ <para>Install the HPCC Systems ECL IDE (Double-click the installation file and
|
|
|
Wine will install it).</para>
|
|
|
</listitem>
|
|
|
</orderedlist>
|
|
@@ -2139,10 +2139,10 @@ sudo /etc/init.d/hpcc-init -c esp start
|
|
|
<title>External Language Support</title>
|
|
|
|
|
|
<para>This section covers the steps to add external language support to
|
|
|
- the HPCC platform. HPCC offers support for several programming
|
|
|
+ the HPCC Systems platform. HPCC Systems offers support for several programming
|
|
|
languages, some have additional dependencies that must be installed.
|
|
|
External language support is included with the platform installation
|
|
|
- package, however there are RPM-based HPCC Platform installation packages
|
|
|
+ package, however there are RPM-based HPCC Systems platform installation packages
|
|
|
that explicitly state <emphasis role="bold">with
|
|
|
plugins</emphasis>.</para>
|
|
|
|
|
@@ -2192,7 +2192,7 @@ sudo /etc/init.d/hpcc-init -c esp start
|
|
|
</itemizedlist>
|
|
|
|
|
|
<para>The following sections detail what is required to utilize these
|
|
|
- languages in your HPCC platform.</para>
|
|
|
+ languages in your HPCC Systems platform.</para>
|
|
|
|
|
|
<para>In addition to these languages, you can add support for additional
|
|
|
languages by creating your own plugin. This is not very difficult to do.
|
|
@@ -2203,7 +2203,7 @@ sudo /etc/init.d/hpcc-init -c esp start
|
|
|
<sect2 id="Add_On_Java" role="brk">
|
|
|
<title>Java</title>
|
|
|
|
|
|
- <para>You can run external Java code on the HPCC platform. Compiled
|
|
|
+ <para>You can run external Java code on the HPCC Systems platform. Compiled
|
|
|
Java can be used either as a .class (or a .jar) and called from ECL
|
|
|
just like any other ECL function.</para>
|
|
|
|
|
@@ -2211,7 +2211,7 @@ sudo /etc/init.d/hpcc-init -c esp start
|
|
|
|
|
|
<programlisting>javap -s</programlisting>
|
|
|
|
|
|
- <para>To set up Java to integrate with the HPCC platform:</para>
|
|
|
+ <para>To set up Java to integrate with the HPCC Systems platform:</para>
|
|
|
|
|
|
<orderedlist>
|
|
|
<listitem>
|
|
@@ -2238,7 +2238,7 @@ sudo /etc/init.d/hpcc-init -c esp start
|
|
|
<listitem>
|
|
|
<para>using classpath value in environment.conf</para>
|
|
|
|
|
|
- <para>The default configuration file for the HPCC platform
|
|
|
+ <para>The default configuration file for the HPCC Systems platform
|
|
|
is <emphasis
|
|
|
role="bold">/etc/HPCCSystems/environment.conf</emphasis> you
|
|
|
will need to edit this file to point to your Java build
|
|
@@ -2267,7 +2267,7 @@ sudo /etc/init.d/hpcc-init -c esp start
|
|
|
|
|
|
<para>For more information see the <link
|
|
|
linkend="Starting-and-stopping">Starting-and-stopping</link> the
|
|
|
- HPCC System in the <emphasis>Installing and Running The HPCC
|
|
|
+ HPCC Systems platform in the <emphasis>Installing and Running The HPCC Systems
|
|
|
Platform</emphasis> document.</para>
|
|
|
</listitem>
|
|
|
|
|
@@ -2288,7 +2288,7 @@ integer add1(integer val) := IMPORT(java, 'JavaCat.add1:(I)I');
|
|
|
|
|
|
add1(10);
|
|
|
</programlisting>If this successfully executes, you have correctly set up Java
|
|
|
- to work with your HPCC platform.</para>
|
|
|
+ to work with your HPCC Systems platform.</para>
|
|
|
|
|
|
<para>If you get a "unable to load libjvm.so" error you should
|
|
|
reinstall or try a different Java package.</para>
|
|
@@ -2298,7 +2298,7 @@ add1(10);
|
|
|
<para>You can call Java from ECL just like any other ECL function.
|
|
|
Java static functions can be easily prototyped using ECL types.</para>
|
|
|
|
|
|
- <para>Additional examples of Java for HPCC can be found at:</para>
|
|
|
+ <para>Additional examples of Java for HPCC Systems can be found at:</para>
|
|
|
|
|
|
<para><ulink
|
|
|
url="https://github.com/hpcc-systems/HPCC-Platform/tree/master/testing/ecl/embedjava.ecl">https://github.com/hpcc-systems/HPCC-Platform/tree/master/testing/ecl/embedjava.ecl</ulink></para>
|
|
@@ -2359,9 +2359,9 @@ ENDEMBED;
|
|
|
|
|
|
add1(10);
|
|
|
</programlisting>If this successfully executes, you have correctly set up
|
|
|
- JavaScript to work with your HPCC platform.</para>
|
|
|
+ JavaScript to work with your HPCC Systems platform.</para>
|
|
|
|
|
|
- <para>Additional examples of HPCC code can be found at:</para>
|
|
|
+ <para>Additional examples of HPCC Systems code can be found at:</para>
|
|
|
|
|
|
<para><ulink
|
|
|
url="https://github.com/hpcc-systems/HPCC-Platform/tree/master/testing/ecl/embedjava.ecl">https://github.com/hpcc-systems/HPCC-Platform/tree/master/testing/ecl/embedjava.ecl</ulink></para>
|
|
@@ -2372,7 +2372,7 @@ add1(10);
|
|
|
<sect2 id="Add_Python_support" role="brk">
|
|
|
<title>Python</title>
|
|
|
|
|
|
- <para>HPCC supports Python2 by default. The HPCC platform includes
|
|
|
+ <para>HPCC Systems supports Python2 by default. The HPCC Systems platform includes
|
|
|
plugins for both Python2 and Python3, but only one may be safely
|
|
|
enabled at a time as the Python libraries export the same symbols for
|
|
|
both versions. Enabling both may lead to unpredictable results
|
|
@@ -2430,10 +2430,10 @@ ENDEMBED;
|
|
|
split_words('Once upon a time');
|
|
|
|
|
|
</programlisting>If this successfully executes, you have correctly set up
|
|
|
- Python to work with your HPCC platform. You can now embed Python
|
|
|
- anywhere you would use ECL within with your HPCC System.</para>
|
|
|
+ Python to work with your HPCC Systems platform. You can now embed Python
|
|
|
+ anywhere you would use ECL within with your HPCC Systems platform.</para>
|
|
|
|
|
|
- <para>Additional examples of HPCC code can be found at:</para>
|
|
|
+ <para>Additional examples of HPCC Systems code can be found at:</para>
|
|
|
|
|
|
<para><ulink
|
|
|
url="https://github.com/hpcc-systems/HPCC-Platform/tree/master/testing/regress/ecl">https://github.com/hpcc-systems/HPCC-Platform/tree/master/testing/regress/ecl/</ulink></para>
|
|
@@ -2441,7 +2441,7 @@ split_words('Once upon a time');
|
|
|
</orderedlist>
|
|
|
|
|
|
<para>In order for Python to work properly it is important that the
|
|
|
- version of Python and the HPCC system are set up correctly to support
|
|
|
+ version of Python and HPCC Systems are set up correctly to support
|
|
|
using the installed version of Python. If you see "ld: cannot find
|
|
|
--lpy2embed" error then your system is likely set up for Python3.
|
|
|
Likewise, if you see "ld: cannot find --lpy3embed" then your system is
|
|
@@ -2484,7 +2484,7 @@ split_words('Once upon a time');
|
|
|
<sect2 id="R" role="brk">
|
|
|
<title>R</title>
|
|
|
|
|
|
- <para>The HPCC Platform supports embedded R code. To enable R support
|
|
|
+ <para>The HPCC Systems platform supports embedded R code. To enable R support
|
|
|
within The HPCC Systems<superscript>®</superscript> Platform:</para>
|
|
|
|
|
|
<orderedlist>
|
|
@@ -2630,9 +2630,9 @@ s1b :=DATASET(250000, TRANSFORM({ integer a }, SELF.a := COUNTER+1));
|
|
|
s2b :=DATASET(250000, TRANSFORM({ integer a }, SELF.a := (COUNTER/2)+1));
|
|
|
SUM(NOFOLD(s1b + s2b), a);
|
|
|
</programlisting>If this successfully executes, you have correctly set up R to
|
|
|
- work with your HPCC platform.</para>
|
|
|
+ work with your HPCC Systems platform.</para>
|
|
|
|
|
|
- <para>Additional examples of HPCC code can be found at:</para>
|
|
|
+ <para>Additional examples of HPCC Systems code can be found at:</para>
|
|
|
|
|
|
<para><ulink
|
|
|
url="https://github.com/hpcc-systems/HPCC-Platform/tree/master/testing/ecl/regress/embedR.ecl">https://github.com/hpcc-systems/HPCC-Platform/tree/master/testing/regress/ecl/embedR.ecl</ulink></para>
|
|
@@ -2647,7 +2647,7 @@ SUM(NOFOLD(s1b + s2b), a);
|
|
|
<para>Some additional considerations for mapping data types in
|
|
|
R.</para>
|
|
|
|
|
|
- <para>In HPCC the ECL <emphasis role="bold">RECORD</emphasis> maps
|
|
|
+ <para>In HPCC Systems the ECL <emphasis role="bold">RECORD</emphasis> maps
|
|
|
to an R <emphasis>list</emphasis>.</para>
|
|
|
|
|
|
<para>An ECL <emphasis role="bold">DATASET</emphasis> including a
|
|
@@ -2657,8 +2657,8 @@ SUM(NOFOLD(s1b + s2b), a);
|
|
|
<para>An ECL <emphasis role="bold">SET</emphasis> is mapped to an R
|
|
|
<emphasis>vector</emphasis>.</para>
|
|
|
|
|
|
- <para>These principals apply to passing data from HPCC to R or data
|
|
|
- returning to HPCC from R. There are usage examples of these concepts
|
|
|
+ <para>These principals apply to passing data from HPCC Systems to R or data
|
|
|
+ returning to HPCC Systems from R. There are usage examples of these concepts
|
|
|
available at:</para>
|
|
|
|
|
|
<para><ulink
|