Это старая версия документа!
Инсталляция и обновление
Инсталляция
Перед инсталляцией:
- Перед установкой или обновлением проверить наличие интернета. Запуски скриптов выполнять под пользователем root или sudo.
- Проверить правильность установки времени и временной зоны на сервере. При необходимости поправить и перезапустить сервер.
Процесс инсталляции:
Не отключайте стандартный firewall-cmd. Скрипт установки использует его для самонастройки.
Не используйте команду
yum update fastor. Устанавливайте / обновляйте скриптом ниже.
Для установки или обновления в автоматическом режиме, выполнить последовательно:
- Выполнить скрипт
fastor-rpm_install.sh:source <(curl https://vasexperts.ru/install/fastor-rpm_install.sh)
Будет произведена установка rpm-пакетов:
ipfixreceiver,clickhouse,fastor. Будет произведена автоматическая настройка конфигурации. - Перезапустить SSH-терминал. Нужно, чтобы стали доступны алиасы команд.
- Выполнить команду для обновления схемы БД:
fastor-db-scheme
ERROR: while updating DB scheme
Дождитесь запуска БД. Статус запуска можно проверять по логам tail, они расположены по пути /var/log/clickhouse-server/clickhouse-server.log, либо попробовать запустить клиент clickhouse-client — если есть соединение, значит БД стартовала и готова к подключениям.
После старта БД выполните команду
fastor-db-scheme
Это страхует случаи, когда схема не успевает обновиться в результате долгого перезапуска БД.
Обновление
Если у вас большой объем принимаемых данных, перед обновлением рекомендуется
- Остановить ресиверы
fastor-stop
- Дождаться завершения вставок в БД
clickhouse-client --query="select * from system.processes sp where sp.query like 'insert into%'" | wc -l
- Остановить БД
fastor-db-stop
- Выполнить скрипт
fastor-rpm_install.sh:source <(curl https://vasexperts.ru/install/fastor-rpm_install.sh)
Обновление на CentOS 7
Ввиду определённых ограничений в ClickHouse, необходимо было внести изменения в зависимости нашего пакета fastor. Эти изменения позволили обеспечить корректную работу пакета на операционных системах CentOS 8 и VEOS, но могут вызвать проблемы на CentOS 7 из-за невозможности обработки указанных зависимостей.
Пошаговая инструкция
Шаг 1. Если у вас принимаются большие объемы данных, перед обновлением рекомендуется:
- Остановить ресиверы:
fastor-stop
- Дождаться завершения вставок в БД:
clickhouse-client --query="select * from system.processes sp where sp.query like 'insert into%'" | wc -l
- Остановить БД:
fastor-db-stop
Шаг 2. Очистить кеш yum:
yum clean all
Шаг 3. Выполнить скрипт инсталляции, чтобы обновить репозитории:
source <(curl https://vasexperts.ru/install/fastor-rpm_install.sh)
Шаг 4. Проверить вывод команды:
rpm -qa | grep clickhouse
Если в выводе у всех пакетов разное состояние:
clickhouse-client-23.4.2.11-1.x86_64 clickhouse-server-23.4.2.11-1.x86_64 clickhouse-common-static-23.4.2.11-1.x86_64
то нужно удалить эти пакеты:
rpm -e fastor clickhouse-client-23.4.2.11-1.x86_64 clickhouse-server-23.4.2.11-1.x86_64 clickhouse-common-static-23.4.2.11-1.x86_64
Шаг 5. Обновить ClickHouse:
yum install clickhouse-common-static-24.2.2.71 clickhouse-server-24.2.2.71 clickhouse-client-24.2.2.71
Шаг 6. Если в файле /usr/lib/systemd/system/clickhouse-server.service содержится параметр TimeoutStartSec=0 — нужно его убрать. Это влияет на запуск ClickHouse на CentOS 7.
Затем выполнить команду
systemctl daemon-reload
Шаг 7. Установить последнюю версию fastor:
yum install fastor
Шаг 8. Перезапустить СlickHouse в режиме восстановления:
fastor-db-restart-repair
Шаг 9. Обновить схему БД:
fastor-db-scheme
Шаг 10. Восстановить .env файл:
mv "/var/qoestor/backend/.env.rpmsave" "/var/qoestor/backend/.env"
Шаг 11. Перезапустить ресиверы:
fastor-restart
Деинсталляция (полное удаление)
В некоторых случаях требуется полностью удалить QoE Stor (например, если продукт был установлен на тестовый DPI или на другой сервер по ошибке).
Для полного удаления выполните скрипт деинсталляции fastor-rpm_uninstall.sh:
source <(curl https://vasexperts.ru/install/fastor-rpm_uninstall.sh)
Будет произведено удаление пакетов: ipfixreceiver, clickhouse, fastor. А также полное удаление данных!
Была ли полезна эта информация?