Геораспределенная Почта VK WorkSpace

Назначение документа

Распределенная инсталляция — продукт VK WorkSpace, с помощью которого можно настроить связи между отдельно развернутыми инсталляциями для управления маршрутизацией почты, просмотра занятости пользователей в календарях и объединения контактов в общую адресную книгу.

Внимание

Функциональность можно включить только на кластерных инсталляциях VK WorkSpace, развернутых с нуля. Настроить геораспределенную почту на уже готовой инсталляции невозможно.

Предварительные действия

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

Шаг 1. Включите продукт в веб-интерфейсе установщика

При установке, на Шаге 2. Выбор продуктов и опций включите продукт Распределённая инсталляция.

Внимание

Одновременно с Распределённой инсталляцией запрещено включать продукт Интеграция с другими инсталляциями VK WorkMail.

Шаг 2. Включите общую адресную книгу

Этот шаг выполняется при установке на Шаге 11. Настройка компонентов.

Перейдите в раздел Настройки компонентов -> Адресная книга.
Включите в нем Общую адресную книгу для всех доменов.
Создайте организацию и добавьте в нее все домены инсталляций, которые будут объединены.

Шаг 3. Выполните настройку распределенной инсталляции на всех узлах

Этот шаг выполняется при установке на Шаге 11. Настройка компонентов.

Внимание

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

Перейдите в раздел Настройки компонентов -> Конфигурация распределённой инсталляции.
В поле Список разрешённых IP введите адреса инсталляций, с которыми настраивается соединение. Для моноинсталляций введите адрес сервера Почты VK WorkSpace. Для кластерных инсталляций введите адреса всех серверов, отведенных под хранилища. Адреса серверов можно получить в веб-интерфейсе установщика на странице со списком ролей.
Нажмите кнопку Добавить новое подключение. В открывшемся окне введите необходимую информацию:
- В поле Название подключения введите название. Название может содержать латинские буквы в нижнем регистре, цифры, нижнее подчеркивание, дефис.
- В поле IP-адрес и порт Kafka введите данные в формате IP-адрес:порт. Для моноинсталляций необходимо ввести адрес сервера Почт. Для кластерных инсталляций нужно ввести адреса всех серверов, отведенных под хранилища. Порт Kafka по умолчанию — 60032.
- В поле IP-адрес SMTP введите данные в формате IP-адрес::порт. Для моноинсталляций введите адрес сервера Почты. Для кластерной инсталляции введите адрес одного из серверов, отведенных под фронты. Порт по умолчанию: 25. В качестве порта указывается порт MX. Если при установке для MX был указан другой порт, то введите его.
- Для заполнения поля Уникальный идентификатор удалённой инсталляции вам потребуется ввести geomail id инсталляции, соединение с которой вы хотите настроить. Найти его можно во вкладке Настройки компонентов -> Конфигурация распределённой инсталляции под заголовком раздела.
Нажмите кнопку Сохранить.

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

Если синхронизация прошла успешно, значок будет гореть зеленым. В случае неполадок — красным. При возникновении проблем с синхронизацией проверьте сетевую связность между инсталляциями. Если все настроено верно, но ошибка сохраняется, обратитесь к представителю VK.
При необходимости включите Безусловную переадресацию почты, тогда вся получаемая почта будет приходить сначала на один из центральных узлов, после чего пересылаться получателю. Если опция выключена, письма будут приходить напрямую получателю. Чтобы включить Безусловную переадресацию почты, в выпадающем меню выберите подключение, на которое централизованно будет пересылаться почта и нажмите Включить.

Примечание

Фактическая пересылка будет производиться на адрес из поля IP-адрес SMTP, который был указан при создании подключения.

Что происходит при неполадках

При неполадках вы получите информацию о конфликтах. Все конфликты решаются вручную. Кнопка Очистить запись не разрешает конфликты.

В левом столбце будет указана инсталляция, являющаяся источником конфликта, в среднем — email, с которым возник конфликт. Чтобы увидеть подробную информацию о конфликте, наведите курсор на конфликтный email.

Шаг 4. Выполните настройки для работы Календаря

Этот шаг выполняется при установке на Шаге 13. Переменные окружения.

В веб-интерфейсе установщика перейдите в раздел Переменные окружения.
В левом столбце найдите calendarapi.
Нажмите на значок редактирования, затем на кнопку Добавить.
В поле Имя переменной введите CALENDARAPI_GEOMANT_ENABLED, в поле Значение переменной введите true.
Нажмите кнопку Сохранить.
В левом столбце найдите calendarapi-internal.
Нажмите на значок редактирования, затем на кнопку Добавить.
В поле Имя переменной введите CALENDARAPI_GEOMANT_ENABLED, в поле Значение переменной введите true.
Нажмите кнопку Сохранить.

Шаг 5. Настройте задачи в панели администратора /admin/misc

Внимание

Настройки ниже производятся после включения геораспределенной почты на всех инсталляциях.

После завершения Шага 15. Завершение установки, инициализация домена и вход в панель администратора перейдите по адресу https://biz.<domain>/admin/misc/django_celery_beat/periodictask/add/.
Откроется страница создания периодческой задачи в панели администратора /admin/misc.
Придумайте и задайте название периодической задачи.
В выпадающем меню Задача (зарегистрированные) выберите pdd.onpremise.tasks.sync_geo_users.
В меню Crontab выберите * * * * * (m/h/dM/MY/d) Europe/Moscow. При этом значении задача будет выполняться раз в минуту. Если нужного значения Crontab в списке нет, нажмите на зеленый значок +, не изменяйте значений по умолчанию, нажмите на кнопку Сохранить.
Сохраните изменения.

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

Чтобы изменить периодическую задачу, кликните на ее название:

Шаг 6. Настройте сервис ics-router

Для корректной работы уведомлений календаря нужно, чтобы в переменных ICS_ROUTER_REPLY_TRUSTED_SENDER_FEATURE_EMAILS и ICS_ROUTER_cancel_trusted_sender_feature_emails были указаны email для писем календаря всех инсталляций, с которыми будет происходить объединение. Чтобы найти email для писем календаря, перейдите в панель администратора (biz), в раздел Почта —> Настройки -> Письма календаря. Необходимый email содержится в поле Email отправителя писем.

Далее:

Перейдите в веб-интерфейс установщика, в раздел Настройки -> Переменные окружения.
В левом столбце найдите ics-router.
Создайте переменные окружения:
- ICS_ROUTER_REPLY_TRUSTED_SENDER_FEATURE_EMAILS — в поле Значение переменной укажите почтовые адреса для писем календаря всех инсталляций из панели администратора.
- ICS_ROUTER_REPLY_TRUSTED_SENDER_PERMILLE — в поле Значение переменной укажите 1000.
- ICS_ROUTER_cancel_trusted_sender_feature_emails — в поле Значение переменной добавьте почтовые адреса для писем календаря всех инсталляций, объединив их квадратными скобками.

Пример заполнения переменных:

Шаг 7. Настройте пересылку писем на несуществующие адреса

Для писем, которые отправляются на несуществующие адреса, нужно создать специальный почтовый ящик:

Перейдите в панель администратора VK WorkSpace (biz.<your domain>).
Перейдите в раздел Пользователи и нажмите на кнопку Создать, в открывшемся окне введите необходимую для создание пользователя информацию. Сохраните адрес электронной почты созданного пользователя.
Перейдите в раздел Почта -> Настройки -> Общие заполните чекбокс Пересылать все письма на несуществующие адреса на специальный ящик и введите в поле сохраненный адрес электронной почты.