mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-30 19:42:00 +00:00
67c2e50331
* update presentations * CLICKHOUSE-2936: redirect from clickhouse.yandex.ru and clickhouse.yandex.com * update submodule * lost files * CLICKHOUSE-2981: prefer sphinx docs over original reference * CLICKHOUSE-2981: docs styles more similar to main website + add flags to switch language links * update presentations * Less confusing directory structure (docs -> doc/reference/) * Minify sphinx docs too * Website release script: fail fast + pass docker hash on deploy * Do not underline links in docs * shorter * cleanup docker images * tune nginx config * CLICKHOUSE-3043: get rid of habrastorage links * Lost translation * CLICKHOUSE-2936: temporary client-side redirect * behaves weird in test * put redirect back * CLICKHOUSE-3047: copy docs txts to public too * move to proper file * remove old pages to avoid confusion * Remove reference redirect warning for now * Refresh README.md * Yellow buttons in docs * Use svg flags instead of unicode ones in docs * fix test website instance * Put flags to separate files * wrong flag * Copy Yandex.Metrica introduction from main page to docs * Yet another home page structure change, couple new blocks (CLICKHOUSE-3045) * Update Contacts section * CLICKHOUSE-2849: more detailed legal information * CLICKHOUSE-2978 preparation - split by files * More changes in Contacts block * Tune texts on index page * update presentations * One more benchmark * Add usage sections to index page, adapted from slides * Get the roadmap started, based on slides from last ClickHouse Meetup * CLICKHOUSE-2977: some rendering tuning * Get rid of excessive section in the end of getting started * Make headers linkable * CLICKHOUSE-2981: links to editing reference - https://github.com/yandex/ClickHouse/issues/849 * CLICKHOUSE-2981: fix mobile styles in docs * Ban crawling of duplicating docs * Open some external links in new tab * Ban old docs too * Lots of trivial fixes in english docs * Lots of trivial fixes in russian docs * Remove getting started copies in markdown * Add Yandex.Webmaster * Fix some sphinx warnings * More warnings fixed in english docs * More sphinx warnings fixed * Add code-block:: text * More code-block:: text * These headers look not that well * Better switch between documentation languages * merge use_case.rst into ya_metrika_task.rst * Edit the agg_functions.rst texts * Add lost empty lines * Lost blank lines * Add new logo sizes * update presentations * Next step in migrating to new documentation * Fix all warnings in en reference * Fix all warnings in ru reference * Re-arrange existing reference * Move operation tips to main reference * Fix typos noticed by milovidov@ * Get rid of zookeeper.md * Looks like duplicate of tutorial.html * Fix some mess with html tags in tutorial * No idea why nobody noticed this before, but it was completely not clear whet to get the data * Match code block styling between main and tutorial pages (in favor of the latter) * Get rid of some copypaste in tutorial * Normalize header styles * Move example_datasets to sphinx * Move presentations submodule to website * Move and update README.md * No point in duplicating articles from habrahabr here * Move development-related docs as is for now * doc/reference/ -> docs/ (to match the URL on website) * Adapt links to match the previous commit * Adapt development docs to rst (still lacks translation and strikethrough support) * clean on release * blacklist presentations in gulp * strikethrough support in sphinx * just copy development folder for now * fix weird introduction in style article * Style guide translation (WIP) * Finish style guide translation to English * gulp clean separately * Update year in LICENSE * Initial CONTRIBUTING.md * Fix remaining links to old docs in tutorial * Some tutorial fixes * Typo * Another typo * Update list of authors from yandex-team accoding to git log
196 lines
4.3 KiB
ReStructuredText
196 lines
4.3 KiB
ReStructuredText
How to build ClickHouse on Linux
|
|
================================
|
|
|
|
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 with SSE 4.2 is supported. Support for AArch64 is experimental.
|
|
|
|
To test for SSE 4.2, do
|
|
|
|
.. code-block:: bash
|
|
|
|
grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
|
|
|
|
|
|
Install Git and CMake
|
|
---------------------
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install git cmake
|
|
|
|
|
|
Detect number of threads
|
|
------------------------
|
|
|
|
.. code-block:: bash
|
|
|
|
export THREADS=$(grep -c ^processor /proc/cpuinfo)
|
|
|
|
Install GCC 6
|
|
-------------
|
|
|
|
There are several ways to do it.
|
|
|
|
Install from PPA package
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: bash
|
|
|
|
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-6 g++-6
|
|
|
|
|
|
Install from sources
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Example:
|
|
|
|
.. code-block:: bash
|
|
|
|
# Download gcc from https://gcc.gnu.org/mirrors.html
|
|
wget ftp://ftp.fu-berlin.de/unix/languages/gcc/releases/gcc-6.2.0/gcc-6.2.0.tar.bz2
|
|
tar xf gcc-6.2.0.tar.bz2
|
|
cd gcc-6.2.0
|
|
./contrib/download_prerequisites
|
|
cd ..
|
|
mkdir gcc-build
|
|
cd gcc-build
|
|
../gcc-6.2.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-6
|
|
sudo ln -s /usr/local/bin/g++ /usr/local/bin/g++-6
|
|
sudo ln -s /usr/local/bin/gcc /usr/local/bin/cc
|
|
sudo ln -s /usr/local/bin/g++ /usr/local/bin/c++
|
|
# /usr/local/bin/ should be in $PATH
|
|
|
|
|
|
Use GCC 6 for builds
|
|
--------------------
|
|
|
|
.. code-block:: bash
|
|
|
|
export CC=gcc-6
|
|
export CXX=g++-6
|
|
|
|
|
|
Install required libraries from packages
|
|
----------------------------------------
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install libicu-dev libreadline-dev libmysqlclient-dev libssl-dev unixodbc-dev
|
|
|
|
|
|
Checkout ClickHouse sources
|
|
---------------------------
|
|
|
|
To get latest stable version:
|
|
|
|
.. code-block:: bash
|
|
|
|
git clone -b stable git@github.com:yandex/ClickHouse.git
|
|
# or: git clone -b stable https://github.com/yandex/ClickHouse.git
|
|
|
|
cd ClickHouse
|
|
|
|
|
|
For development, switch to the ``master`` branch.
|
|
For latest release candidate, switch to the ``testing`` branch.
|
|
|
|
Build ClickHouse
|
|
----------------
|
|
|
|
There are two variants of build.
|
|
|
|
Build release package
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Install prerequisites to build debian packages.
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install devscripts dupload fakeroot debhelper
|
|
|
|
Install recent version of clang.
|
|
|
|
Clang is embedded into ClickHouse package and used at runtime. Minimum version is 3.8.0. It is optional.
|
|
|
|
|
|
You can build clang from sources:
|
|
|
|
.. code-block:: bash
|
|
|
|
cd ..
|
|
sudo apt-get install subversion
|
|
mkdir llvm
|
|
cd llvm
|
|
svn co http://llvm.org/svn/llvm-project/llvm/tags/RELEASE_400/final llvm
|
|
cd llvm/tools
|
|
svn co http://llvm.org/svn/llvm-project/cfe/tags/RELEASE_400/final clang
|
|
cd ..
|
|
cd projects/
|
|
svn co http://llvm.org/svn/llvm-project/compiler-rt/tags/RELEASE_400/final compiler-rt
|
|
cd ../..
|
|
mkdir build
|
|
cd build/
|
|
cmake -D CMAKE_BUILD_TYPE:STRING=Release ../llvm
|
|
make -j $THREADS
|
|
sudo make install
|
|
hash clang
|
|
|
|
Or install it from packages. On Ubuntu 16.04 or newer:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install clang
|
|
|
|
|
|
You may also build ClickHouse with clang for development purposes.
|
|
For production releases, GCC is used.
|
|
|
|
Run release script:
|
|
|
|
.. code-block:: bash
|
|
|
|
rm -f ../clickhouse*.deb
|
|
./release
|
|
|
|
You will find built packages in parent directory:
|
|
|
|
.. code-block:: bash
|
|
|
|
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:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo dpkg -i ../clickhouse*.deb
|
|
sudo service clickhouse-server start
|
|
|
|
|
|
Build to work with code
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: bash
|
|
|
|
mkdir build
|
|
cd build
|
|
cmake ..
|
|
make -j $THREADS
|
|
cd ..
|
|
|
|
To create an executable, run ``make clickhouse``.
|
|
This will create the ``dbms/src/Server/clickhouse`` executable, which can be used with --client or --server arguments.
|