Skip to main content

Установка балансировщика HAProxy

Цель

Установка балансировщика нагрузки HAProxy для кластерной конфигурации ПринтМенеджеров.

Предусловия

  • Подготовлена база PostgreSQL и NFS-хранилище.
  • Получены дистрибутивы Мониторинга, ПринтМенеджера и Балансировщика с файлами контрольных сумм.

Варианты развёртывания схемы с балансировкой

Возможно два варианта развёртывания схемы балансировки:

  • массовое развертывание с помощью скрипта;
  • ручное развёртывание.

Шаги установки Массового развёртывания схемы с балансировкой

Скрипт массового развертывания предназначен для автоматической установки и обновления балансировщика, мониторинга и серверов ПринтМенеджеров, обеспечивая минимизацию ручного вмешательства.

Требования для выполнения массового развертывания

Подключение по SSH

  • Сервер балансировщика должен иметь возможность подключаться к остальным серверам (ПринтМенеджеры и Мониторинг) по протоколу SSH.
  • Для исключения необходимости ввода паролей, настройте SSH-аутентификацию с использованием ключа:
    • Создайте ключ SSH на сервере балансировщика (если его еще нет):​ 
      ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
    • Скопируйте публичный ключ на все удаленные сервера:​ 
      ssh-copy-id root@<remote_server_IP>​

Подтверждение доверия SSH-сертификатов

  • Перед запуском скрипта подключитесь к каждому серверу вручную из ВМ с балансировщиком:​ 
    ssh root@<remote_server_IP>
  • Подтвердите добавление отпечатка сервера в файл доверенных хостов (~/.ssh/known_hosts).

Права пользователя

  • Каждый сервер должен иметь пользователя с правами sudo.
  • Для удобства и безопасности рекомендуется:
    • Создать отдельные служебные учетные записи
    • Отключить запрос пароля для команд с использованием sudo, добавив в конфигурацию /etc/sudoers соответствующую строку:​ 
      <username> ALL=(ALL) NOPASSWD:ALL​​

Проверка конфигурации

Убедитесь, что файл config.ini заполнен корректно:

  • Все необходимые секции ([Balancer], [Monitoring], [PrintManager_1] и т.д.) присутствуют.
  • Значения переменных указаны без ошибок (путь к сертификатам, пароли, адреса и т.д.).
  • Если некоторые сервера уже настроены, используйте параметр SKIP = true для их пропуска при развёртывании.

Инструкция по запуску скрипта

  1. Перейдите в директорию со скриптом массовой установки:​

    cd /path/to/script

  2. Запустите скрипт:​

    sudo ./install_all_offline.sh

  3. Если требуются детализированные логи для диагностики, используйте отладочный режим:​

    sudo DEBUG=1 ./install_all_offline.sh

Порядок установки

Шаг 1. Подготовка базы данных и NFS-хранилища​

Подготовка описана в разделах:

Шаг 2. Получение сертификатов

Если используются собственные SSL-сертификаты:

  • Сгенерируйте или получите их у авторизованного центра сертификации (CA).
  • Убедитесь, что пути к сертификатам (SSL_CERT и SSL_KEY) корректно указаны в конфигурационном файле.
  • Если сертификаты корневого центра сертификации требуются, укажите путь к ним в SSL_CERT_CA.

Шаг 3. Запуск установки

Скопируйте дистрибутивы на сервер балансировщика

Скопируйте на сервер балансировщика дистрибутивы Мониторинга, ПринтМенеджера и Балансировщика вместе с файлами контрольных сумм:

  • printmanager-X1.Y1.Z1.tar.gz
  • printmanager-X1.Y1.Z1.tar.gz.sha512
  • printum-X2.Y2.Z2.tar.gz
  • printum-X2.Y2.Z2.tar.gz.sha512
  • printum-balancer-X3.Y3.Z3.tar.gz
  • printum-balancer-X3.Y3.Z3.tar.gz.sha512
Проверьте контрольные суммы
sha512sum -c <имя_файла>.sha512
Распакуйте архив балансировщика
tar xzvf printum-balancer-X3.Y3.Z3.tar.gz
cd printum-balancer-X3.Y3.Z3
Создайте файл конфигурации
cp config_example.ini config.ini
Отредактируйте файл config.ini

Внесите необходимые значения для каждой секции, указывая необходимые значения и опираясь на раздел "Описание конфигурационного файла".

Сохраните файл config.ini. Этот файл понадобится для будущих обновлений

Выполните установку

Используйте скрипт install_all_offline.sh с правами администратора:​

sudo ./install_all_offline.sh

Если при этом появляется ошибка Permission denied, сделайте файл исполняемым и повторите запуск:

chmod +x install_all_offline.sh
sudo ./install_all_offline.sh
Ожидайте завершения процесса установки

В случае необходимости введите пароль для подключения по SSH и копирования файлов с использованием SCP.

Проверьте корректность установки

Используйте раздел Проверка корректности установки кластера.

Описание конфигурационного файла

Конфигурационный файл config.ini используется для автоматического развёртывания и обновления системы. Он должен содержать обязательные секции, которые обозначаются квадратными скобками: [General].

Каждая секция содержит параметры в формате КОНСТАНТА = ЗНАЧЕНИЕ. Между константой и её значением должен быть знак равенства, обрамлённый пробелами.

Пример: PM_HTTP_PORT = 8010

Если константа не требует значения, её можно удалить, закомментировать или оставить пустой (с пробелом после знака равно).

Пример: SSL_CERT_CA =

Файл должен включать не менее шести секций:

  • [General]
  • [Balancer]
  • [Monitoring]
  • [PrintManager_1]
  • [PrintManager_2]
  • [PrintManager_N]

Секция [General]

Секция [General] содержит общие параметры для всех серверов. Ниже приведён перечень доступных констант:

  • MON_DIST_PATH — полный путь до дистрибутива мониторинга.
  • PM_DIST_PATH — полный путь до дистрибутива PrintManager.
  • PM_HTTP_PORT — порт для подключения к админке PrintManager по протоколу HTTP.
  • PM_HTTPS_PORT — порт для подключения к админке PrintManager по протоколу HTTPS.
  • SSL_CERT_CA — полный путь до корневого сертификата (CA certificate).
  • DATABASE_URL — настройки для подключения к базе данных PrintManager PostgreSQL в формате URL: 
    DATABASE_URL=postgres://<POSTGRES_LOGIN>:<POSTGRES_PASSWORD>@<DB_HOST>:<PORT>/<BASE_NAME>
    или со схемой базы данных: 
    DATABASE_URL=postgres://<POSTGRES_LOGIN>:<POSTGRES_PASSWORD>@<DB_HOST>:<PORT>/<BASE_NAME>?currentSchema=<POSTGRES_SCHEMA>
    • <POSTGRES_LOGIN> — логин пользователя с необходимыми разрешениями (запись, удаление, чтение, обновление).
    • <POSTGRES_PASSWORD> — пароль пользователя.
    • <DB_HOST> — адрес сервера базы данных или балансировщика кластера.
    • <PORT> — порт для подключения к базе.
    • <BASE_NAME> — имя базы данных.
    • <POSTGRES_SCHEMA> — схема базы данных (опционально).
    • <DATABASE_TABLESPACE> — табличное пространство (указать, если не используется значение по умолчанию).​
  • NFS_ADDR — IP-адрес или доменное имя для подключения к серверу NFS.
  • NFS_PATH — полный путь к директории на сервере NFS.
  • NFS_TLS (опционально) — укажите 1 или true, чтобы использовать шифрованное соединение с NFS. Если шифрование не используется, укажите 0 или false, либо удалите переменную.
  • NFS_STUNNEL_PORT (опционально) — порт, указанный для Stunnel. Должен совпадать с портом в конфигурационном файле Stunnel. По умолчанию используется 20490.

Секция [Balancer]

Секция [Balancer] содержит параметры, необходимые для настройки сервера балансировки.

Доступные параметры:

  • EXT_HOSTNAME — IP-адрес или hostname сервера балансировки.
  • SSL_CERT — полный путь до сертификата.
  • SSL_KEY — полный путь до закрытого ключа сертификата.
  • SKIP (опционально) — флаг, указывающий, нужно ли пропустить установку или обновление на указанном сервере.
    • Если указано false (по умолчанию), установка выполняется.
    • Если указано true, выполнение команд на данном сервере будет пропущено.
  • STATS_USER — логин пользователя для авторизации в панели администратора балансировщика.
  • STATS_PASSWORD — пароль пользователя для доступа к странице статистики.

Секция [Monitoring]

Секция [Monitoring] содержит параметры для сервера, выделенного под систему мониторинга.

Доступные параметры:

  • MON_HOSTNAME — IP-адрес или hostname сервера мониторинга.
  • USER — пользователь с правами sudo или суперпользователь root.
  • PASSWORD — пароль пользователя, указанного в параметре USER.
  • SSL_CERT — полный путь до сертификата.
  • SSL_KEY — полный путь до закрытого ключа сертификата.
  • SKIP (опционально) — флаг, указывающий, нужно ли пропустить установку или обновление на данном сервере.
    • Если указано false (по умолчанию), установка выполняется.
    • Если указано true, выполнение команд на данном сервере будет пропущено. Пропустить (SKIP = True) можно в том случае, если нужно обновить только балансировщик и/или ПМы.

Секции [PrintManager_1], [PrintManager_2], ..., [PrintManager_N]

Секции [PrintManager_X] (где X — номер сервера) содержат настройки для подключения к соответствующим серверам с ПринтМенеджером.

Доступные параметры:

  • PM_HOSTNAME — IP-адрес или hostname сервера ПринтМенеджера.
  • USER — пользователь с правами sudo или суперпользователь root.
  • PASSWORD — пароль пользователя, указанного в параметре USER.
  • SSL_CERT — полный путь до сертификата.
  • SSL_KEY — полный путь до закрытого ключа сертификата.
  • SKIP (опционально) — флаг, указывающий, нужно ли пропустить установку или обновление на данном сервере.
    • Если указано false (по умолчанию), установка выполняется.
    • Если указано true, выполнение команд на данном сервере будет пропущено. Пропустить (SKIP = True) можно в том случае, если нужно обновить балансировщик и/или Мониторинг.

Шаги установки схемы балансировщика в ручном режиме

Шаг 1. Скопируйте дистрибутивы на сервер балансировщика

Скопируйте на сервер балансировщика дистрибутивы Мониторинга, ПринтМенеджера и Балансировщика вместе с файлами контрольных сумм:

  • printmanager-X1.Y1.Z1.tar.gz
  • printmanager-X1.Y1.Z1.tar.gz.sha512
  • printum-X2.Y2.Z2.tar.gz
  • printum-X2.Y2.Z2.tar.gz.sha512
  • printum-balancer-X3.Y3.Z3.tar.gz
  • printum-balancer-X3.Y3.Z3.tar.gz.sha512

Шаг 2. Проверьте контрольные суммы

sha512sum -c <имя_файла>.sha512

Шаг 3. Распакуйте архив балансировщика

tar xzvf printum-balancer-X3.Y3.Z3.tar.gz
cd printum-balancer-X3.Y3.Z3

Шаг 4. Настройте переменные окружения

Введите следующие команды для настройки (оставайтесь в этом же терминале до завершения установки):

export NFS_ADDR=<NFS_ADDR>
export NFS_PATH=<NFS_FOLDER_PATH>
export DATABASE_URL=postgres://<POSTGRES_LOGIN>:<POSTGRES_PASSWORD>@<DB_HOST>:<PORT>/<BASE_NAME>

Если требуется указать схему базы данных:

export DATABASE_URL=postgres://<POSTGRES_LOGIN>:<POSTGRES_PASSWORD>@<DB_HOST>:<PORT>/<BASE_NAME>?currentSchema=<POSTGRES_SCHEMA>

Если база использует нестандартное табличное пространство:

export DATABASE_TABLESPACE=<DATABASE_TABLESPACE>

где:

  • <POSTGRES_LOGIN> — логин пользователя с необходимыми разрешениями (запись, удаление, чтение, обновление).
  • POSTGRES_PASSWORD> — пароль пользователя POSTGRES_LOGIN.
  • <DB_HOST> — реальный адрес базы или балансировщика кластера баз.
  • <PORT> — порт для подключения к базе.
  • <BASE_NAME> — Имя базы.
  • <POSTGRES_SCHEMA> — схема базы данных, указывать, если не используется схема public.
  • <DATABASE_TABLESPACE> — Табличное пространство.
  • <NFS_ADDR> — IP-адрес или доменное имя NFS сервера.
  • <NFS_FOLDER_PATH> — путь директории NFS сервера.

Если вы настроили NFS через туннель stunnel, то обязательно укажите:

export NFS_TLS=true

Если порт stunnel отличается от 20490, то укажите еще порт:​

export NFS_STUNNEL_PORT=<NFS_STUNNEL_PORT>

где:

  • NFS_STUNNEL_PORT - порт для stunnel

Также вы можете указать логин и пароль для страницы HAProxy:

export STATS_USER=<STATS_USER>
export STATS_PASSWORD=<STATS_PASSWORD>

Если пароль и логин не указан, то будет установлен логин admin и пароль admin. Логин и пароль записаны в файле /opt/printum_balancer/.env.

Шаг 5. Запустите установку

С автоматическими сертификатами:

sudo -E ./install.sh -balancer <BALANCER_ADR> -pm <PM_1> -pm <PM_2> -pm <PM_3>

С собственными сертификатами:

export SSL_CERT=<client.crt>
export SSL_KEY=<client.key>
export SSL_CERT_CA=<ca.crt>
sudo -E ./install.sh -balancer <BALANCER_ADR> -pm <PM_1> -pm <PM_2> -pm <PM_3>

где:

  • <BALANCER_ADR> — IP адрес или доменное имя балансировщика.
  • <PM_1> — IP адрес или доменное имя первого ПринтМенеджер.
  • <PM_2>, <PM_3> , … — IP адрес или имя остальных ПринтМенеджеров.

Ожидаемый результат

Если установка прошла без ошибок, то в консоли будет выведено сообщение об успехе и http-адрес для доступа к панели HAProxy:

Статус HAProxy доступен по адресу: https://BALANCER_ADR:7000/

Во время установки балансировщика будут автоматически записаны настройки для балансировщика и ПМов. Архивы находятся в директории /opt/printum_balancer/certificates.

Как проверить установку

Откройте страницу по адресу https://BALANCER_ADR:7000/.

Вы увидите несколько групп строк, группы отделяются заголовками бордового цвета. Каждая группа обозначает часть системы и её статус. После установки всех ПМов строки станут зелеными.

Следующие шаги

Типовые ошибки

Ошибка Причина Решение
Страница состояния балансировщика (HAProxy) и ПринтМенеджеров загружается с ошибкой. Отсутствует или некорректен FQDN (hostname) в DNS для ВМ в составе конфигурации. Проверить наличие и корректность FQDN (hostname) в DNS для всех ВМ в составе отказоустойчивой конфигурации.

Связанные страницы

Back to top