-
Notifications
You must be signed in to change notification settings - Fork 0
Building HPCC
Assuming you already have your git repository set up (see Git-step-by-step), you can build and install HPCC.
On Linux (Ubuntu 11.10) the build process requires some additional packages:
sudo apt-get install g++ gcc make bison flex binutils-dev libldap2-dev libicu-dev libxalan110-dev zlib1g-dev libboost-regex-dev libssl-dev
On Mac (Snow Leopard) the build process requires some additional packages:
sudo port install bison flex binutils openldap icu xalanc zlib boost openssl
When building with CMake, it is recommended to create a separate directory for the built files. You can create it either inside the source tree or outside, depends much on personal preference. I'll assume you're creating it outside. If your source is under, say, ~/hpcc/src, create a build directory outside of the tree at ~/hpcc/build.
Now you need to run CMake to populate your build directory with Makefiles and special configuration to build HPCC, packages, tests, etc.
For release builds, do:
cd ~/hpcc/build
cmake ../src
If you're running a debug build, do:
cd ~/hpcc/build
cmake -DCMAKE_BUILD_TYPE:STRING=Debug ../src
CMake will check for necessary dependencis like binutils, boost regex, cppunit, pthreads, etc. If everything is correct, it'll create the necessary Makefiles and you're ready to build HPCC.
It doesn't take too long to compile HPCC, but it's highly recommended that you use all your CPUs to do so. When building complex projects (where I/O plays an important part), it's often recommended to use 50% more threads than the number of CPUs you have.
So, on a quad-core machine, the command you should type is:
make -j6
That will make all binaries, libraries and scripts necessary to create the package.
The recommended way to install HPCC in your machine (even for testing) is to use distro packages. CMake has already detected your system, so it know whether to generate TGZ files, DEP or RPM packages.
Just type:
make package
and it'll create the appropriate package for you to install. The package will be inside the build directory.
In my system (Ubuntu 11.04), it created a package called hpccsystems-platform-community_3.3.0-1trunk-Debugnatty_amd64.deb.
The HPCC package has dependencies built in, and your system might not have them all (you can have the source package in order to build, but not the library package installed by your package manager, for example).
Install the package:
sudo dpkg -i hpccsystems-platform-community_3.3.0-1trunk-Debugnatty_amd64.deb
And fix the dependencies:
sudo apt-get -f install
(see here for Ubuntu based installation).
If your installation succeeded, you should see the service in /etc/init.d (or /etc/rc.d/init.d on RPM based distros) called hpcc-init. This service follows the standard Linux service interface, where you can use commands like:
sudo /etc/init.d/hpcc-init status
sudo /etc/init.d/hpcc-init start
sudo /etc/init.d/hpcc-init stop
Use hpcc-init start and make sure there are no error messages. If everything went ok, check that the cluster is up and running by visiting the admin page on your browser.
- How to cross compile to other architectures
- More Windows details