mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-01 20:12:02 +00:00
387cbca505
* Create SECURITY.md
* [experimental] auto-mark documentation PRs with labels
* revert #6544
* Sync RPM packages instructions to other docs languages
* Move tutorial to documentation with old content (for now)
* refactor installation guide a bit
* add ../en/getting_started/index.md
* Rename ya_metrica_task.md
* Rename ya_metrica_task.md
* Refactor Yandex.Metrica dataset description
* WIP on rewriting tutorial
* tmp commit
* lots of docs fixes
* partially revert c136bee4ce
* try to fix docs build in CI
* try to fix docs build in CI
* few minor improvements
* Quick refactoring of last portion of tutorial (not thoroughly tested though)
* fix link
145 lines
8.0 KiB
Markdown
145 lines
8.0 KiB
Markdown
# Установка
|
||
|
||
## Системные требования
|
||
|
||
ClickHouse может работать на любой операционной системе Linux, FreeBSD или Mac OS X с архитектурой процессора x86\_64, AArch64 или PowerPC64LE.
|
||
|
||
Предварительно собранные пакеты компилируются для x86\_64 и используют набор инструкций SSE 4.2, поэтому, если не указано иное, его поддержка в используемом процессоре, становится дополнительным требованием к системе. Вот команда, чтобы проверить, поддерживает ли текущий процессор SSE 4.2:
|
||
|
||
``` bash
|
||
$ grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
|
||
```
|
||
|
||
Чтобы запустить ClickHouse на процессорах, которые не поддерживают SSE 4.2, либо имеют архитектуру AArch64 или PowerPC64LE, необходимо самостоятельно [собрать ClickHouse из исходного кода](#from-sources) с соответствующими настройками конфигурации.
|
||
|
||
## Доступные варианты установки
|
||
|
||
### Из DEB пакетов {#from-deb-packages}
|
||
|
||
Яндекс рекомендует использовать официальные скомпилированные `deb` пакеты для Debian или Ubuntu.
|
||
|
||
Чтобы установить официальные пакеты, пропишите репозиторий Яндекса в `/etc/apt/sources.list` или в отдельный файл `/etc/apt/sources.list.d/clickhouse.list`:
|
||
|
||
```
|
||
deb http://repo.yandex.ru/clickhouse/deb/stable/ main/
|
||
```
|
||
|
||
Если вы хотите использовать наиболее свежую тестовую, замените `stable` на `testing` (не рекомендуется для production окружений).
|
||
|
||
Затем для самой установки пакетов выполните:
|
||
|
||
```bash
|
||
sudo apt-get install dirmngr # optional
|
||
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4 # optional
|
||
sudo apt-get update
|
||
sudo apt-get install clickhouse-client clickhouse-server
|
||
```
|
||
|
||
Также эти пакеты можно скачать и установить вручную отсюда: <https://repo.yandex.ru/clickhouse/deb/stable/main/>.
|
||
|
||
### Из RPM пакетов {#from-rpm-packages}
|
||
|
||
Команда ClickHouse в Яндексе рекомендует использовать официальные предкомпилированные `rpm` пакеты для CentOS, RedHad и всех остальных дистрибутивов Linux, основанных на rpm.
|
||
|
||
Сначала нужно подключить официальный репозиторий:
|
||
```bash
|
||
sudo yum install yum-utils
|
||
sudo rpm --import https://repo.yandex.ru/clickhouse/CLICKHOUSE-KEY.GPG
|
||
sudo yum-config-manager --add-repo https://repo.yandex.ru/clickhouse/rpm/stable/x86_64
|
||
```
|
||
|
||
Для использования наиболее свежих версий нужно заменить `stable` на `testing` (рекомендуется для тестовых окружений).
|
||
|
||
Then run these commands to actually install packages:
|
||
Для, собственно, установки пакетов необходимо выполнить следующие команды:
|
||
|
||
```bash
|
||
sudo yum install clickhouse-server clickhouse-client
|
||
```
|
||
|
||
Также есть возможность установить пакеты вручную, скачав отсюда: <https://repo.yandex.ru/clickhouse/rpm/stable/x86_64>.
|
||
|
||
### Из Docker образа {#from-docker-image}
|
||
|
||
Для запуска ClickHouse в Docker нужно следовать инструкции на [Docker Hub](https://hub.docker.com/r/yandex/clickhouse-server/). Внутри образов используются официальные `deb` пакеты.
|
||
|
||
### Из исходного кода {#from-sources}
|
||
|
||
Для компиляции ClickHouse вручную, используйте инструкцию для [Linux](../development/build.md) или [Mac OS X](../development/build_osx.md).
|
||
|
||
Можно скомпилировать пакеты и установить их, либо использовать программы без установки пакетов. Также при ручой сборке можно отключить необходимость поддержки набора инструкций SSE 4.2 или собрать под процессоры архитектуры AArch64.
|
||
|
||
```
|
||
Client: dbms/programs/clickhouse-client
|
||
Server: dbms/programs/clickhouse-server
|
||
```
|
||
|
||
Для работы собранного вручную сервера необходимо создать директории для данных и метаданных, а также сделать их `chown` для желаемого пользователя. Пути к этим директориям могут быть изменены в конфигурационном файле сервера (src/dbms/programs/server/config.xml), по умолчанию используются следующие:
|
||
|
||
```
|
||
/opt/clickhouse/data/default/
|
||
/opt/clickhouse/metadata/default/
|
||
```
|
||
|
||
На Gentoo для установки ClickHouse из исходного кода можно использовать просто `emerge clickhouse`.
|
||
|
||
## Запуск
|
||
|
||
Для запуска сервера в качестве демона, выполните:
|
||
|
||
``` bash
|
||
$ sudo service clickhouse-server start
|
||
```
|
||
|
||
Смотрите логи в директории `/var/log/clickhouse-server/`.
|
||
|
||
Если сервер не стартует, проверьте корректность конфигурации в файле `/etc/clickhouse-server/config.xml`
|
||
|
||
Также можно запустить сервер вручную из консоли:
|
||
|
||
``` bash
|
||
$ clickhouse-server --config-file=/etc/clickhouse-server/config.xml
|
||
```
|
||
|
||
При этом, лог будет выводиться в консоль, что удобно для разработки.
|
||
Если конфигурационный файл лежит в текущей директории, то указывать параметр `--config-file` не требуется, по умолчанию будет использован файл `./config.xml`.
|
||
|
||
После запуска сервера, соединиться с ним можно с помощью клиента командной строки:
|
||
|
||
``` bash
|
||
$ clickhouse-client
|
||
```
|
||
|
||
По умолчанию он соединяется с localhost:9000, от имени пользователя `default` без пароля. Также клиент может быть использован для соединения с удалённым сервером с помощью аргумента `--host`.
|
||
|
||
Терминал должен использовать кодировку UTF-8.
|
||
|
||
Более подробная информация о клиенте располагается в разделе [«Клиент командной строки»](../interfaces/cli.md).
|
||
|
||
Пример проверки работоспособности системы:
|
||
|
||
``` bash
|
||
$ ./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.
|
||
|
||
:)
|
||
```
|
||
|
||
**Поздравляем, система работает!**
|
||
|
||
Для дальнейших экспериментов можно попробовать загрузить один из тестовых наборов данных или пройти [пошаговое руководство для начинающих](https://clickhouse.yandex/tutorial.html).
|
||
|
||
[Оригинальная статья](https://clickhouse.yandex/docs/ru/getting_started/install/) <!--hide-->
|