ClickHouse/doc/build.txt

140 lines
4.2 KiB
Plaintext

# How to build ClickHouse
#
# Build should work on Linux Ubuntu 12.04, 14.04 or newer.
# With appropriate changes, build should work on any other Linux distribution.
# Build is not intended to work on Mac OS X.
# Only x86_64 is supported. Support for AArch64 is experimental.
sudo apt-get install git cmake
# Install GCC 5.
# There are several ways to do it.
#
# 1. If you run on Ubuntu 15.10 or newer, just do
# sudo apt-get install g++-5
#
# 2. Install from PPA package.
sudo apt-get install software-properties-common
sudo apt-add-repository ppa:ubuntu-toolchain-r/test
sudo apt-get update
sudo apt-get install gcc-5 g++-5
export THREADS=$(grep -c ^processor /proc/cpuinfo)
# 3. Install GCC 5 from sources.
#
# Download gcc from https://gcc.gnu.org/mirrors.html
# Example:
# wget ftp://ftp.fu-berlin.de/unix/languages/gcc/releases/gcc-5.3.0/gcc-5.3.0.tar.bz2
# tar xf gcc-5.3.0.tar.bz2
# cd gcc-5.3.0
# ./contrib/download_prerequisites
# cd ..
# mkdir gcc-build
# cd gcc-build
# ../gcc-5.3.0/configure --enable-languages=c,c++
# make -j $THREADS
# sudo make install
# hash gcc g++
# gcc --version
# sudo ln -s /usr/local/bin/gcc /usr/local/bin/gcc-5
# sudo ln -s /usr/local/bin/g++ /usr/local/bin/g++-5
# sudo ln -s /usr/local/bin/cc /usr/local/bin/gcc-5
# sudo ln -s /usr/local/bin/c++ /usr/local/bin/g++-5
# /usr/local/bin/ should be in $PATH
#
# Note that these ways of installation differs.
# When installing from PPA, by default, "old C++ ABI" is used,
# and when installing from sources, "new C++ ABI" is used.
# When using different C++ ABI, you need to recompile all C++ libraries,
# otherwise libraries will not link.
# ClickHouse works with both old and new C++ ABI,
# but production releases is built with old C++ ABI.
export CC=gcc-5
export CXX=g++-5
# Install required libraries from packages
sudo apt-get install libicu-dev libglib2.0-dev libreadline-dev libzookeeper-mt-dev libmysqlclient-dev libssl-dev unixodbc-dev libunwind8-dev
# Install recent version of boost. Version 1.57 or newer will be Ok.
wget http://downloads.sourceforge.net/project/boost/boost/1.60.0/boost_1_60_0.tar.bz2
tar xf boost_1_60_0.tar.bz2
cd boost_1_60_0
./bootstrap.sh
./b2 --toolset=gcc-5 -j $THREADS
sudo ./b2 install --toolset=gcc-5 -j $THREADS
cd ..
# Install mongoclient. This library is needed only for 'external dictionaries' with MongoDB source.
# This is rarely used but enabled by default.
# If you don't need it, you could set variable and skip installation step:
# export DISABLE_MONGODB=1
sudo apt-get install scons
git clone -b legacy https://github.com/mongodb/mongo-cxx-driver.git
cd mongo-cxx-driver
sudo scons --c++11 --release --cc=$CC --cxx=$CXX --disable-warnings-as-errors -j $THREADS --prefix=/usr/local install
cd ..
# Checkout ClickHouse sources.
git clone git@███████████.yandex-team.ru:Metrika/ClickHouse.git # TODO Change path.
cd ClickHouse
# There are two variants of build.
# 1. Build release package.
# Install prerequisites to build debian packages.
sudo apt-get install devscripts dupload fakeroot debhelper
# Install recent version of clang. Clang is embedded into ClickHouse package and used at runtime. It is optional.
cd ..
sudo apt-get install subversion
mkdir llvm
cd llvm
svn co http://llvm.org/svn/llvm-project/llvm/tags/RELEASE_380/final llvm
cd llvm/tools
svn co http://llvm.org/svn/llvm-project/cfe/tags/RELEASE_380/final clang
cd ..
cd projects/
svn co http://llvm.org/svn/llvm-project/compiler-rt/tags/RELEASE_380/final compiler-rt
cd ../..
mkdir build
cd build/
cmake -D CMAKE_BUILD_TYPE:STRING=Release ../llvm
make -j $THREADS
sudo make install
hash clang
# You may also build ClickHouse with clang for development purposes.
# For production releases, GCC is used.
# Run release script.
rm -f ../clickhouse*.deb
./release
# debsign and dupload will not work by default.
# It's Ok. You will find built packages in parent directory.
# ls -l ../clickhouse*.deb
# Note that usage of debian packages is not required.
# ClickHouse has no runtime dependencies except libc,
# so it could work on almost any Linux.
# Installing just built packages on development server.
sudo dpkg -i ../clickhouse*.deb
sudo service clickhouse-server start
# 2. Build to work with code.
#
# mkdir build
# cd build
# cmake ..
# make -j $THREADS
# cd ..