IVA ДОКУМЕНТАЦИЯ ОБНОВЛЕНИЯ

Кластерная установка

Кластерная установка используется для развертывания IVA Mail в отказоустойчивой конфигурации с несколькими узлами и общим кластерным хранилищем.

Описание архитектуры кластера приведено в разделе Архитектура кластера.

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

Назначение

Кластерная установка позволяет:

  • объединить несколько узлов IVA Mail в единый кластер;

  • обеспечить отказоустойчивость серверной части;

  • использовать общее файловое хранилище для кластерных данных;

  • синхронизировать состояние узлов через CMD-взаимодействие;

  • распределять клиентские подключения через сетевой балансировщик.



Общий принцип установки

Кластерная установка включает следующие этапы:

  1. Установка IVA Mail на каждый узел.

  2. Подготовка общего хранилища.

  3. Подключение общего хранилища на каждом узле.

  4. Создание символьной ссылки Cluster.

  5. Установка лицензии на первый запускаемый узел — Dispatcher.

  6. Настройка параметров кластера в панели администратора.

  7. Создание файла параметров запуска.

  8. Последовательный запуск узлов.

  9. Проверка состояния кластера.


Установка IVA Mail на узлы кластера

Выполните установку сервера IVA Mail на каждый узел кластера согласно разделу Установка одиночного сервера.


Подключение общего хранилища

На каждом узле необходимо:

  • подключить общее файловое хранилище;

  • создать символьную ссылку Cluster в директории /var/ivamail.

Пример:

cd /var/ivamail
ln -s <точка-монтирования> Cluster
Символьная ссылка Cluster обязательна для запуска узлов в кластерном режиме.

Права доступа

Все файлы и директории внутри кластерного хранилища должны принадлежать: ivamail:ivamail.

Пример:

chown -R ivamail:ivamail /var/ivamail

Установка лицензии

Лицензия устанавливается только на первый запускаемый узел.

Остальные узлы получают лицензию после подключения к кластеру.

Подробнее см. раздел Лицензирование.


Настройка параметров кластера

На каждом узле необходимо настроить параметры кластера.

Для настройки:

  1. В панели администратора перейдите:

    Модули → Кластер

  2. Заполните параметры согласно разделу Настройки кластера.

    Параметры узлов, CMD-порта, шифрования и пароля должны совпадать на всех узлах.
  3. Выполните остановку сервера IVA Mail:

    systemctl stop ivamail

Настройка кластерного запуска

  1. На каждом узле создайте файл:

    /var/ivamail/parameters.conf
  2. В файл parameters.conf добавьте строку запуска.

    На backend-серверах:

    ARGS="--backend"

    На frontend-серверах:

    ARGS="--frontend"

    Параметры --backend и --frontend переводят сервер в режим backend или frontend-узла кластера.

    Сервер не сможет запуститься в backend или frontend-режиме без доступа к кластерной директории Cluster.

Последовательность запуска

После настройки кластерного запуска:

  1. Запустите первый узел (на котором установлена лицензия):

    systemctl start ivamail
  2. Дождитесь его появления в разделе Мониторинг → Кластер → Статистика:

    Мониторинг состояния узлов кластера
  3. Запускайте последовательно следующий узел.

После запуска каждого узла дождитесь его появления в разделе Мониторинг → Кластер → Статистика. Только после этого запускайте следующий узел.

Проверка состояния кластера

Проверка состояния узлов кластера выполняется в панели администратора в разделе:

Мониторинг → Кластер → Статистика

Раздел отображает:

  • текущую роль узла;

  • состояние узлов;

  • доступность узлов;

  • состояние кластера.


Часто встречающиеся проблемы

Узел кластера не запускается или запускается с ошибкой

Возможная причина:

  • Сервер IVA Mail запущен с параметром `--backend `, но не имеет доступа к файлам кластерной директории.

Возможное решение:

Проверьте:

  • доступность примонтированной кластерной директории;

  • корректность точки монтирования;

  • права доступа к файлам и каталогам кластера.


Не удается выполнить вход в кластерный аккаунт

Возможная причина:

  • Для общего хранилища используется NFS версии 4.

Возможное решение:

Для кластерного хранилища рекомендуется использовать NFS версии 3.


Не синхронизируются или не сохраняются настройки кластерных объектов

Возможная причина:

  • Сервер IVA Mail не имеет необходимых прав доступа к файлам кластерного хранилища.

Возможное решение:

  1. Проверьте права доступа к директории:

    /var/ivamail/Cluster
  2. Права в ней должны принадлежать ivamail:ivamail.


Отсутствуют почтовые папки у кластерных аккаунтов

Возможная причина:

  • Нарушена сетевая связанность между узлами кластера.

Возможное решение:

Проверьте доступность порта 106 между всеми узлами кластера.

Необходимо обеспечить:

  • входящие подключения по порту 106;

  • исходящие подключения по порту 106;

  • отсутствие блокировок со стороны межсетевых экранов.


Узел не отображается в разделе Мониторинг

Возможная причина:

Узел не завершил процедуру подключения к кластеру или был запущен до полной инициализации предыдущего узла.

Возможное решение:

  1. Запускайте узлы последовательно.

  2. После запуска каждого узла дождитесь его появления в разделе Мониторинг → Кластер → Статистика.

  3. Только после этого запускайте следующий узел.