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

Описание программы

Программа IVA Mail представляет собой многопоточный почтово-календарный сервер (далее по тексту — сервер), реализованный на языке C++. Сервер имеет монолитную архитектуру: все модули реализованы в виде подпрограмм и выполняются в рамках одного процесса.

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

Сервер поддерживает мультидоменную архитектуру, то есть предоставляет возможность создавать и обслуживать несколько доменов.

Вся информация сервера, включая почтовую, хранится в файлах и не требует внешней базы данных.

Сервер поддерживает стандартные протоколы SMTP, IMAP, POP3, HTTP и другие.

Для взаимодействия сервера IVA Mail с клиентом IVA Mail используется собственный протокол JUMP, основанный на протоколах JSON и HTTP.

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

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

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

Кол. аккаунтов	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 и выше;
Альт Линукс СПТ;
Ред ОС Муром.

Установка

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

Скачайте пакет сервера. Убедитесь, что у вас есть доступ к пакету сервера (далее ivamail.deb или ivamail.rpm);
Установите пакет. Выполните от имени администратора команду установки в терминале:

Для Debian-подобных ОС:

apt-get install ./ivamail.deb

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

dnf install ./ivamail.rpm

или

apt-get install ./ivamail.rpm

В процессе установки будут созданы две директории:

директория приложения: /opt/ivamail;
директория данных: /var/ivamail.

Регистрация сервиса:
- установка автоматически зарегистрирует сервис с именем ivamail;
- также будет настроен скрипт запуска, чтобы сервер запускался при старте ОС.

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

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

systemctl start ivamail

Настройка базы данных

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

Для работы требуется установленный пакет PostgreSQL.

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

apt install postgresql -y

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

dnf isntall postgresql-server

postgresql-setup --initdb

systemctl enable postgresql

systemctl start postgresql

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

Для работы с базой данных PostgreSQL требуется создать аккаунт postgres с паролем postgres, обладающий полными правами на создание таблиц, аккаунтов и управление базами данных. Для этого нужно ввести команду:

sudo -u postgres psql

В интерактивной оболочке PostgreSQL выполнить команды:

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

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

После установки сервера в директории /opt/ivamail находится скрипт ivamail-db-setup.sh, который автоматически создаст аккаунт ivamail, необходимые таблицы и подключит сервер к базе данных.

Запуск скрипта инициализации

Запуск скрипта осуществляется командой:

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

Скрипт выполнит следующие действия:

подключится к локальному серверу PostgreSQL;
предложит создать аккаунт ivamail;
создаст необходимые таблицы для хранения и синхронизации данных;
настроит модуль PostgreSQL БД на сервере для работы с базой данных;
сконфигурирует Справочник для отображения доменов и аккаунтов в адресных книгах.

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

При первом запуске сервера автоматически создается домен и аккаунт администратора postmaster с паролем по умолчанию admin. Имя домена совпадает с hostname машины, на которую установлен сервер.

Кроме этого автоматически создается псевдоним admin для аккаунта администратора.

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

Если серверу по каким-то причинам не удалось выяснить hostname машины, то создается домен с именем ivamail.local.

Доступ к веб-интерфейсу панели администратора

После создания аккаунта администратора вы можете войти в веб-интерфейс администрирования, используя следующий URL:

https://%server-IP_or_domain-name%/Admin/

где %server-IP_or_domain-name% замените на IP-адрес или доменное имя вашего сервера.

На странице входа введите имя и пароль от аккаунта администратора и нажмите Войти.

Описание веб-интерфейса панели администратора приведено в руководстве администратора.