INSTALL.Ubuntu.md

Ubuntu 16.04 on x86_64, i686

Build system

Cmake with gcc or clang. Here in this description we build with gcc >= 4.9 (has C++11 support). Build with C++98 is possible but not with WITH_WEBREQUEST=YES

Prerequisites

Install packages with 'apt-get'/aptitude.

CMake flags

-DWITH_LUA=YES
to enable build with Lua (>= 5.2) language bindings.
-DWITH_PHP=YES
to enable build with Php 7 language bindings.
-DWITH_PYTHON=YES
to enable build with Python 3 language bindings.
-DWITH_WEBREQUEST=YES
to enable web request bindings
-DWITH_STRUS_VECTOR=YES
to build with a module for vector search (e.g. word2vec).
-DWITH_STRUS_PATTERN=YES
to build with a module for fast pattern matching based on hyperscan.

The prerequisites are listen in 5 sections, a common section (first) and for each of these flags toggled to YES another section.

Required packages

boost-all >= 1.57
snappy-dev leveldb-dev libuv-dev

Required packages with -DWITH_STRUS_PATTERN=YES

ragel libtre-dev boost-all >= 1.57 hyperscan >= 4.7

Install hyperscan from sources

git clone https://github.com/intel/hyperscan.git
mkdir hyperscan/build
cd hyperscan/build
git checkout v5.1.1
cmake ..
make
make install

Required packages with -DWITH_STRUS_VECTOR=YES

atlas-dev lapack-dev blas-dev libarmadillo-dev

Required packages with -DWITH_LUA=YES

lua5.2

Required packages with -DWITH_PYTHON=YES

python3-dev

Required packages with -DWITH_PHP=YES

php7.0-dev zlib1g-dev libxml2-dev

Required packages with -DWITH_WEBREQUEST=YES

libcurl4-openssl-dev

Strus prerequisite packages to install before

strusBase strus strusAnalyzer strusTrace strusModule strusRpc  

Strus prerequisite packages to install before with -DWITH_STRUS_VECTOR=YES

strusVector

Strus prerequisite packages to install before with -DWITH_STRUS_VECTOR=YES

strusPattern

Configure build and install strus prerequisite packages with GNU C/C++

With strusVector and strusPattern enabled:
for strusprj in strusBase strus strusAnalyzer strusTrace \
	strusModule strusRpc strusVector strusPattern
do
git clone https://github.com/patrickfrey/$strusprj $strusprj
cd $strusprj
cmake -DCMAKE_BUILD_TYPE=Release -DLIB_INSTALL_DIR=lib .
make
make install
cd ..
done

Fetch sources

git clone https://github.com/patrickfrey/strusBindings
cd strusBindings
git submodule update --init --recursive
git submodule foreach --recursive git checkout master
git submodule foreach --recursive git pull

Configure build and install strus prerequisite packages with Clang C/C++

Minimal build, only Lua bindings without Vector and Pattern and
a reasonable default for library installation directory:
for strusprj in strusBase strus strusAnalyzer strusTrace \
	strusModule strusRpc
do
git clone https://github.com/patrickfrey/$strusprj $strusprj
cd $strusprj
cmake -DCMAKE_BUILD_TYPE=Release \
	-DCMAKE_C_COMPILER="clang" -DCMAKE_CXX_COMPILER="clang++" -DWITH_LUA=YES .
make
make install
cd ..
done

Configure with GNU C/C++

With Lua, Php and Python bindings and strusVector and strusPattern enabled:
cmake -DCMAKE_BUILD_TYPE=Release \
	-DWITH_PYTHON=YES \
	-DWITH_PHP=YES \
	-DWITH_LUA=YES \
	-DWITH_STRUS_VECTOR=YES \
	-DWITH_STRUS_PATTERN=YES \
	-DLIB_INSTALL_DIR=lib .

Configure with Clang C/C++

Minimal build without Vector and Pattern and
a reasonable default for library installation directory:

cmake -DCMAKE_BUILD_TYPE=Release \
	-DCMAKE_C_COMPILER="clang" -DCMAKE_CXX_COMPILER="clang++" .

Build

make

Run tests

make test

Install

make install