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

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

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

Внимание

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

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

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

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

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

Внимание

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

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

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

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

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

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

Внимание

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

1. Перейдите в раздел Настройки компонентов -> Конфигурация распределённой инсталляции.

   

2. В поле Список разрешённых IP введите адрес инсталляции, с которой настраивается соединение.

3. Нажмите кнопку Добавить новое подключение. В открывшемся окне введите необходимую информацию.

   Внимание

   В полях IP-адрес и порт Kafka и IP-адрес SMTP должны быть обязательно указаны порты. Порт для IP-адрес SMTP должен быть указан через два двоеточия. Порт для Kafka открыт в VK Workspace по умолчанию — 60032.

   Для заполнения поля Уникальный идентификатор удалённой инсталляции вам потребуется ввести geomail id инсталляции, соединение с которой вы хотите настроить. Найти его можно во вкладке Настройки компонентов -> Конфигурация распределённой инсталляции под заголовком раздела.

   

4. Нажмите кнопку Сохранить.

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

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

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

   Примечание

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

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

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

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

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

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

1. В веб-интерфейсе установщика перейдите в раздел Переменные окружения.

2. В левом столбце найдите calendarapi.

   

3. Нажмите на значок редактирования, затем на кнопку Добавить.

4. В поле Имя переменной введите CALENDARAPI_GEOMANT_ENABLED, в поле Значение переменной введите true.
5. Нажмите кнопку Сохранить.
6. В левом столбце найдите calendarapi-internal.
7. Нажмите на значок редактирования, затем на кнопку Добавить.
8. В поле Имя переменной введите CALENDARAPI_GEOMANT_ENABLED, в поле Значение переменной введите true.
9. Нажмите кнопку Сохранить.

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

Внимание

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

1. После завершения Шага 15. Завершение установки, инициализация домена и вход в панель администратора перейдите по адресу https://biz.<domain>/admin/misc/django_celery_beat/periodictask/add/.

2. Откроется страница создания периодческой задачи в панели администратора /admin/misc.

   

3. Придумайте и задайте название периодической задачи.

4. В выпадающем меню Задача (зарегистрированные) выберите pdd.onpremise.tasks.sync_geo_users (внизу списка).
5. В меню Crontab выберите * * * * * (m/h/dM/MY/d) Europe/Moscow. При этом значении задача будет выполняться раз в минуту.
6. Сохраните изменения.

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

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

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

1. Перейдите в веб-интерфейс установщика, в раздел Настройки -> Переменные окружения.
2. В левом столбце найдите ics-router.

3. Создайте переменные окружения:

   • ICS_ROUTER_REPLY_TRUSTED_SENDER_FEATURE_EMAILS — в поле Значение переменной укажите почтовые адреса для писем календаря всех инсталляций из панели администратора.
   • ICS_ROUTER_REPLY_TRUSTED_SENDER_PERMILLE — в поле Значение переменной укажите 1000.
   • ICS_ROUTER_cancel_trusted_sender_feature_emails — в поле Значение переменной добавьте почтовые адреса для писем календаря всех инсталляций, объединив их квадратными скобками.

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