Before you can install Confluo, make sure you have the following prerequisites:
- MacOS X or Unix-based OS; Windows is not yet supported.
- C++ compiler that supports C++11 standard (e.g., GCC 5.3 or later)
- CMake 3.2 or later
- Boost 1.58 or later
For python client, you will additionally require:
- Python 2.7 or later
- Python Packages: setuptools, six 1.7.2 or later
For java client, you will additionally require:
- Java 1.7 or later
- ant 1.6.2 or later
You can obtain the latest version of Confluo by cloning the GitHub repository:
git clone https://github.com/ucbrise/confluo.git
To configure the build, Confluo uses CMake as its build system. Confluo only supports out of source builds; the simplest way to configure the build would be as follows:
cd confluo mkdir -p build cd build cmake ..
It is possible to configure the build specifying certain options based on requirements; the supported options are:
BUILD_TESTS: Builds all tests (ON by default)
BUILD_RPC: Builds the rpc daemon and client libraries (ON by default)
BUILD_EXAMPLES: Builds Confluo examples (ON by default)
BUILD_DOC: Builds Confluo documentation (OFF by default)
WITH_PY_CLIENT: Builds Confluo python rpc client (ON by default)
WITH_JAVA_CLIENT: Builds Confluo java rpc client (ON by default)
In order to explicitly enable or disable any of these options, set the value of
the corresponding variable to
OFF as follows:
Finally, you can configure the install location for Confluo by modifying the
CMAKE_INSTALL_PREFIX variable (which is set to /usr/local by default):
Once the build is configured, you can proceed to compile, test and install Confluo.
To build, use:
to speed up the build on multi-core systems.
To run the various unit tests, run:
and finally, to install, use: