mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-10-02 14:40:50 +00:00
e8a5804e76
* 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
136 lines
5.5 KiB
ReStructuredText
136 lines
5.5 KiB
ReStructuredText
Начало работы
|
||
=============
|
||
|
||
Системные требования
|
||
--------------------
|
||
|
||
Система некроссплатформенная. Требуется ОС Linux Ubuntu не более старая, чем Precise (12.04); архитектура x86_64 с поддержкой набора инструкций SSE 4.2.
|
||
Для проверки наличия SSE 4.2, выполните:
|
||
|
||
.. code-block:: bash
|
||
|
||
grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
|
||
|
||
Рекомендуется использовать Ubuntu Trusty или Ubuntu Xenial или Ubuntu Precise.
|
||
Терминал должен работать в кодировке UTF-8 (как по умолчанию в Ubuntu).
|
||
|
||
Установка
|
||
---------
|
||
|
||
В целях тестирования и разработки, система может быть установлена на один сервер или на рабочий компьютер.
|
||
|
||
Установка из пакетов
|
||
~~~~~~~~~~~~~~~~~~~~
|
||
|
||
Пропишите в `/etc/apt/sources.list` (или в отдельный файл `/etc/apt/sources.list.d/clickhouse.list`) репозитории:
|
||
.. code-block:: text
|
||
|
||
deb http://repo.yandex.ru/clickhouse/trusty stable main
|
||
|
||
На других версиях Ubuntu, замените `trusty` на `xenial` или `precise`.
|
||
|
||
Затем выполните:
|
||
.. code-block:: bash
|
||
|
||
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv E0C56BD4 # optional
|
||
sudo apt-get update
|
||
sudo apt-get install clickhouse-client clickhouse-server-common
|
||
|
||
Также можно скачать и установить пакеты вручную, отсюда:
|
||
http://repo.yandex.ru/clickhouse/trusty/pool/main/c/clickhouse/,
|
||
http://repo.yandex.ru/clickhouse/xenial/pool/main/c/clickhouse/,
|
||
http://repo.yandex.ru/clickhouse/precise/pool/main/c/clickhouse/.
|
||
|
||
ClickHouse содержит настройки ограничения доступа. Они расположены в файле users.xml (рядом с config.xml).
|
||
По умолчанию, разрешён доступ отовсюду для пользователя default без пароля. См. секцию users/default/networks.
|
||
Подробнее смотрите в разделе "конфигурационные файлы".
|
||
|
||
Установка из исходников
|
||
~~~~~~~~~~~~~~~~~~~~~~~
|
||
Для сборки воспользуйтесь инструкцией: build.md
|
||
|
||
Вы можете собрать пакеты и установить их.
|
||
Также вы можете использовать программы без установки пакетов.
|
||
.. code-block:: text
|
||
|
||
Клиент: dbms/src/Client/
|
||
Сервер: dbms/src/Server/
|
||
|
||
Для сервера создаёте директории с данными, например:
|
||
.. code-block:: text
|
||
|
||
/opt/clickhouse/data/default/
|
||
/opt/clickhouse/metadata/default/
|
||
|
||
(Настраивается в конфиге сервера.)
|
||
Сделайте chown под нужного пользователя.
|
||
|
||
Обратите внимание на путь к логам в конфиге сервера (src/dbms/src/Server/config.xml).
|
||
|
||
Другие методы установки
|
||
~~~~~~~~~~~~~~~~~~~~~~~
|
||
Docker образ: https://hub.docker.com/r/yandex/clickhouse-server/
|
||
|
||
Gentoo overlay: https://github.com/kmeaw/clickhouse-overlay
|
||
|
||
|
||
Запуск
|
||
------
|
||
|
||
Для запуска сервера (в качестве демона), выполните:
|
||
|
||
.. code-block:: bash
|
||
|
||
sudo service clickhouse-server start
|
||
|
||
Смотрите логи в директории `/var/log/clickhouse-server/`
|
||
|
||
Если сервер не стартует - проверьте правильность конфигурации в файле `/etc/clickhouse-server/config.xml`
|
||
|
||
Также можно запустить сервер из консоли:
|
||
|
||
.. code-block:: bash
|
||
|
||
clickhouse-server --config-file=/etc/clickhouse-server/config.xml
|
||
|
||
При этом, лог будет выводиться в консоль - удобно для разработки.
|
||
Если конфигурационный файл лежит в текущей директории, то указывать параметр --config-file не требуется - по умолчанию будет использован файл ./config.xml
|
||
|
||
Соединиться с сервером можно с помощью клиента командной строки:
|
||
|
||
.. code-block:: bash
|
||
|
||
clickhouse-client
|
||
|
||
Параметры по умолчанию обозначают - соединяться с localhost:9000, от имени пользователя default без пароля.
|
||
Клиент может быть использован для соединения с удалённым сервером. Пример:
|
||
|
||
.. code-block:: bash
|
||
|
||
clickhouse-client --host=example.com
|
||
|
||
Подробнее смотри раздел "Клиент командной строки".
|
||
|
||
Проверим работоспособность системы:
|
||
|
||
.. code-block:: bash
|
||
|
||
milovidov@hostname:~/work/metrica/src/dbms/src/Client$ ./clickhouse-client
|
||
ClickHouse client version 0.0.18749.
|
||
Connecting to localhost:9000.
|
||
Connected to ClickHouse server version 0.0.18749.
|
||
|
||
:) SELECT 1
|
||
|
||
SELECT 1
|
||
|
||
┌─1─┐
|
||
│ 1 │
|
||
└───┘
|
||
|
||
1 rows in set. Elapsed: 0.003 sec.
|
||
|
||
:)
|
||
|
||
Поздравляю, система работает!
|