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

Установка одиночного сервера

Системные требования

Требования к аппаратной части

Минимальные требования к серверному аппаратному обеспечению представлены в таблице.

Кол. аккаунтов vCPU RAM, Гб HDD, Гб Кол-во операций ввода-вывода в секунду IOPS

100

1

2

20

125

500

2

4

40

625

1000

2

4

40

1250

3000

4

6

60

3750

5000

4

8

60

6250

10000

6

10

100

12500

Требования к операционной системе

Сервер функционирует под управлением операционных систем семейства Linux:

  • CentOS версия 7.4 и выше;

  • Debian версия 9 и выше;

  • Альт Линукс СПТ;

  • РЕД ОС Муром;

  • Astra Linux версия 1.7 и выше.

Установка сервера

Установка осуществляется с использованием стандартного менеджера пакетов операционной системы.

Перед установкой убедитесь, что у вас есть пакет сервера:

  • ivamail.deb — для ОС, использующих менеджер пакетов формата deb;

  • ivamail.rpm — для ОС, использующих менеджер пакетов формата rpm.

Установка пакета

Для Debian-совместимых ОС выполните команду:

apt-get install ./ivamail.deb

Для RPM-совместимых ОС выполните команду:

dnf install ./ivamail.rpm

или:

apt-get install ./ivamail.rpm
Команда установки RPM-пакета зависит от используемого дистрибутива ОС и настроенного менеджера пакетов.

Результат установки

  1. В процессе установки создаются директории:

    Директория Назначение

    /opt/ivamail

    Директория приложения и служебных атрибутов.

    /var/ivamail

    Директория данных сервера.

  2. Автоматически регистрируется сервис с именем ivamail, который используется для запуска и остановки сервера.

  3. Автоматически настраивается скрипт запуска, чтобы сервер запускался при старте ОС.

Запуск сервера

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

systemctl start ivamail

Проверьте состояние служб командой:

systemctl status ivamail

Служба должна находиться в состоянии active (running).

Создание первого домена и аккаунта администратора

При первом запуске сервера автоматически создаются:

  • первый домен;

  • аккаунт администратора postmaster;

  • псевдоним admin для аккаунта администратора.

Имя первого домена совпадает с hostname машины, на которую установлен сервер.

Если серверу не удается определить hostname — создается домен с именем ivamail.local.

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

Параметры аккаунта администратора:

Параметр Значение

Аккаунт

postmaster

Псевдоним

admin

Пароль по умолчанию

admin
После первого входа в панель администратора рекомендуется сразу изменить пароль по умолчанию.

Доступ к панели администратора

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

https://<server-IP_or_domain-name>/Admin/

где <server-IP_or_domain-name> — IP-адрес или доменное имя сервера.

На странице входа укажите:

  • имя аккаунта администратора: postmaster или admin;

  • пароль: admin.

После успешной аутентификации откроется панель администратора IVA Mail.

Настройка базы данных и Справочника

После установки и запуска сервера необходимо настроить PostgreSQL и подключить Справочник IVA Mail.

Назначение PostgreSQL

PostgreSQL используется модулем Справочник для хранения своей информации.

Справочник обеспечивает хранение и доступ к объектам глобальной адресной книги.

Установка PostgreSQL

Для Debian-подобных ОС выполните:

apt install postgresql -y

Для RPM-совместимых ОС выполните:

dnf install postgresql-server
postgresql-setup --initdb
systemctl enable postgresql
systemctl start postgresql

Проверьте состояние службы PostgreSQL:

systemctl status postgresql

Конфигурация PostgreSQL

Для работы с базой данных требуется аккаунт PostgreSQL с полными правами на создания таблиц, аккаунтов и управления базами данных.

  1. Откройте интерактивную оболочку PostgreSQL:

    sudo -u postgres psql

  2. Задайте пароль аккаунту postgres и убедитесь, что он обладает правами суперпользователя:

    ALTER USER postgres WITH PASSWORD 'postgres';
ALTER ROLE postgres SUPERUSER;

  3. Выйдите из интерактивной оболочки.

Значение postgres в качестве пароля приведено как пример. Рекомендуется использовать более надежный пароль.

Установка дополнительных пакетов

Для выполнения скрипта настройки базы данных требуются дополнительные пакеты:

  • dialog;

  • postgresql-contrib;

  • netcat (nc).

Для Debian-совместимых ОС выполните:

sudo apt install dialog postgresql-contrib netcat (nc)

Для RPM-совместимых ОС выполните:

sudo dnf install dialog postgresql-contrib netcat (nc)

Инициализация базы данных

После установки сервера в директории /opt/ivamail находится скрипт:

/opt/ivamail/ivamail-db-setup.sh

Скрипт выполняет:

  • проверку зависимостей;

  • подключение к PostgreSQL;

  • создание аккаунта PostgreSQL ivamail;

  • установку пароля для аккаунта ivamail;

  • создание таблиц для хранения и синхронизации данных;

  • настройку модуля Справочник;

  • создание тома Справочник;

  • конфигурацию Справочника для отображения доменов и аккаунтов в адресной книге.

Запуск скрипта

Выполните команду:

/opt/ivamail/ivamail-db-setup.sh

Проверка зависимостей

После запуска скрипт проверяет наличие необходимых программных пакетов, от которых зависит работа продукта.

Если зависимость не удовлетворена, появляется сообщение об ошибке:

Ошибка. Отсутствие зависимости

Установите недостающий пакет и повторите запуск скрипта.

Приветственное сообщение

После успешной проверки зависимостей появится приветственное сообщение с описанием действий, которые выполнит скрипт.

Приветственное письмо

Нажмите ОК для продолжения.

Параметры подключения к PostgreSQL

Укажите параметры подключения к PostgreSQL и нажмите ОК для продолжения.

Параметр Описание

Host

IP-адрес или имя сервера PostgreSQL.

Port

Порт PostgreSQL. По умолчанию используется 5432.

Db

Имя базы данных.

User

Имя аккаунта PostgreSQL с административными правами.

Password

Пароль аккаунта PostgreSQL.
Окно параметров доступа к базе данных PostgreSQL

При успешном подключении будет отображено сообщение:

Успешное подключение к базе данных PostgreSQL

Нажмите ОК для продолжения.

Если подключение завершилось ошибкой, будет отображено сообщение:

Ошибка при подключении к базе данных PostgreSQL

Создание таблиц IVA Mail

После успешного подключения скрипт предложит создать необходимые таблицы IVA Mail в базе данных:

Запрос на создание таблиц

Нажмите Да.

После успешного создания таблиц появится сообщение:

Успешное создание таблиц

Нажмите ОК для продолжения.

Настройка аккаунта ivamail

Далее скрипт предложит изменить пароль аккаунта PostgreSQL ivamail:

Запрос на создание пароля

Аккаунт ivamail используется сервером IVA Mail для доступа к данным Справочника и создается вместе с таблицами.

Этот аккаунт обладает минимальным набором прав, необходимым для работы с созданной схемой базы данных.

Введите пароль и нажмите ОК:

Ввод пароля для аккаунта

После успешной установки пароля появится сообщение:

Успешная установка пароля

Нажмите ОК для продолжения.

Параметры подключения сервера IVA Mail к базе данных

После настройки аккаунта ivamail укажите параметры подключения, которые сервер IVA Mail будет использовать для работы с базой данных, и нажмите ОК для продолжения.

Параметр Описание

Host

IP-адрес или имя сервера PostgreSQL для подключения сервером IVA Mail.

Port

Порт PostgreSQL. По умолчанию используется 5432.

Db

Имя базы данных.

User

Имя аккаунта базы данных. По умолчанию используется ivamail.

Password

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

При успешной проверке доступа появится сообщение:

Успешный доступ к базе данных

Нажмите ОК для продолжения.

Настройка тома Справочника

Далее укажите параметры доступа к CLI сервера IVA Mail и нажмите ОК.

Параметр Описание

Host

IP-адрес или имя сервера IVA Mail.

Port

Порт CLI. По умолчанию используется 106.

User

Имя аккаунта администратора сервера.

Password

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

Volume Base DN

DN создаваемого тома Справочника. Для корневого тома остается пустым.
Параметры доступа к серверу

После успешного создания или изменения тома Справочника появится сообщение:

Успешный результат запроса к серверу

Нажмите ОК для завершения настройки.

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

После завершения установки и настройки сервера и базы данных проверьте, что:

  • служба ivamail запущена;

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

  • вход под аккаунтом администратора выполняется успешно;

  • аккаунт postmaster отображается в домене;

  • Справочник настроен и доступен.

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

Не удается установить соединение с PostgreSQL

Возможные причины:

  • служба PostgreSQL не запущена;

  • порт PostgreSQL закрыт.

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

  1. Проверьте доступность порта PostgreSQL в ufw командой:

    sudo ufw allow 5432/tcp

  2. Проверьте файл postgresql.conf.

  3. Параметр listen_addresses="*" показывает с каких IP-адресов разрешено принимать соединения. Убедитесь, что строка port=5432 раскомментирована.

  4. После изменения конфигурации перезапустите PostgreSQL:

    systemctl restart postgresql

Не проходит аутентификация в PostgreSQL

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

  • в файле pg_hba.conf отсутствует разрешение на подключение сервера IVA Mail.

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

  1. Проверьте файл pg_hba.conf.

  2. Убедитесь, что добавлена строка, указывающая метод аутентификации:

    host all all <ip севера Mail>/32 scram-sha-256

  3. После изменения файла перезагрузите PostgreSQL:

    systemctl restart postgresql