Включение/выключение ClickHouse

Начиная с версии 10.4, в сервисе онлайн-консультирования Webim появилась возможность пользоваться улучшенным модулем Статистики, работающим на СУБД ClickHouse. Ниже приведены инструкции по включению и отключению ClickHouse и модуля Статистики v2.

Ручная установка и настройка ClickHouse

Установите ClickHouse на отдельном сервере согласно официальной инструкции. Аппаратные требования к серверу можно найти на этой странице.
Установите пароль для пользователя default. Для этого откройте файл /etc/clickhouse-server/users.xml, найдите в нём элемент <password>, находящийся по умолчанию в подразделе <default> раздела <users>. Между тегами элемента <password> введите новый пароль:
```
<users>
<default>
<password>your-password</password>
```
Разрешите пользователю default создавать других пользователей и выдавать им права. Для этого вам необходимо в открытом ранее файле users.xml найти элемент <access_management> и раскомментировать его, приведя к следующему виду:
```
<access_management>1</access_management>
```
В файле конфигурации /etc/webim/db.json.d/db.json допишите в объект "dbs" параметры БД ClickHouse:
```
"stats_root":
  "default": {
    "type": "clickhouse",
    "host": "<DB IP address>",
    "port": 9000,
    "user": "default",
    "password": "<your-password>"
  }
},
"stats": {}
```
Менеджмент БД со стороны сервера будет происходить через пользователя default. Позднее в ClickHouse будет созданы учётная запись для Вашего аккаунта в Webim.
Перейдите в account config. Найдите в нём опцию clickhouse_stats, переведите её в значение True, после чего перезагрузите Chat Backend.
После перезагрузки активируйте нужные вам опции account config для отображения в меню разделов ClickHouse-статистики:
- stats_v2: модуль Статистики на ClickHouse
- dashboard_v2: Панель управления на ClickHouse
Ссылки на новую версию статистики заменят аналогичные ссылки на предыдущую версию.

Отключение ClickHouse

Для отключения ClickHouse достаточно проделать следующие шаги:

Удостоверьтесь, что опции account config, отвечающие за ClickHouse-статистику выключены (stats_v2, dashboard_v2 и clickhouse_stats).
В файле конфигурации /etc/webim/db.json.d/db.json удалите объекты "stats_root" и "stats".
Перезагрузите Chat Backend.

После этого вы можете отключить сервер ClickHouse:

systemctl stop clickhouse-server