Инструкция по обновлению кластера Почты
Предварительные условия для установки обновления
-
Убедитесь, что представители VK предоставили вам следующие данные:
- Ссылку на скачивание дистрибутива новой версии Почты.
- Пароль от архива с дистрибутивом.
-
У вас есть архитектурная схема кластера, показывающая, на каком гипервизоре какие компоненты системы установлены. Эти данные потребуются на этапе генерации новых контейнеров.
Обновление необходимо проводить в нерабочее время, когда приложением не пользуются сотрудники (в технологическое окно).
Внимание
Если предполагается обновление более чем на одну версию, например у вас стоит версия 1.19, а вы хотите обновиться сразу на 1.21.1, то проконсультируйтесь с представителями VK, иначе могут возникнуть проблемы при обновлении.
Предварительные действия
Перед установкой обновления необходимо удостовериться в консистентном состоянии кластеров баз данных:
- В веб-интерфейсе установщика перейдите в Настройки -> Шардирование и репликация БД.
- Нажмите на кнопку Опросить все Overlord'ы. Таким образом будет проверено состояние баз данных.
- Авторизуйтесь в панели администратора Почты
https://biz.<main-domain>
. - Перейдите в панель управления кластерами БД MySQL
https://biz.<main-domain>/orchestrator/web/clusters/
. - Проверьте отсутствие ошибок в процессе репликации баз данных.
Распакуйте zip-архив c новой версией. Используйте учетную запись пользователя, от имени которого производилась первичная установка:
- Поместите zip-архив с дистрибутивом новой версии в ту же папку, которая использовалась при первичной установке. То есть туда же, где находится файл-установщик
onpremise-deployer_linux
. -
Распакуйте архив под той же учетной записью поверх имеющегося дистрибутива с заменой всех изменившихся файлов.
Примечание
Архив защищен паролем, который потребуется указать при распаковке.
-
Проверьте, есть ли у файла
onpremise-deployer_linux
флаг на исполнение (x) с помощью команды: -
Если флаг отсутствует, выполните команду:
-
Выполните команду
sudo systemctl restart deployer
.
Добавьте новые контейнеры, соблюдая распределение по гипервизорам как при первичной установке: базы данных добавить на гипервизоры с базами данных, хранилища — на гипервизоры с хранилищами и так далее.
- Перейдите в веб-интерфейс установщика
http://server-address:8888
, где server-address — ip-адрес машины, на которую производится установка, либо ее доменное имя. -
Пролистайте список контейнеров, в нижней части страницы нажмите на кнопку Добавить и выберите пункт Несколько контейнеров.
Откроется всплывающее окно Выберите роли для добавления.
-
Задайте фильтры:
-
Выберите все доступные для установки контейнеры.
-
Прокрутите список контейнеров вниз и выберите гипервизоры, на которые нужно произвести установку.
-
Выберите режим генерации На каждом гипервизоре.
-
Нажмите на синюю кнопку Добавить. Всплывающее окно, в котором выполнялись предыдущие действия, закроется.
- Откройте окно добавления контейнеров, нажав Добавить -> Несколько контейнеров.
- Повторите шаги 1-6 для всех оставшихся компонентов в поле Теги.
-
Убедитесь, что все контейнеры добавлены:
- Откройте окно добавления контейнеров, нажав Добавить -> Несколько контейнеров.
- Выберите фильтр Установлено не более: 0.
- Список контейнеров, доступных для добавления, должен быть пустым.
Вернитесь в верхнюю часть страницы и проверьте: отображается ли в правом верхнем углу зеленая кнопка Далее. Если зеленая кнопка Далее отображается и активна, то донастройте параметры системы. Логика: «Cледуем за кнопкой Далее то тех пор, пока она активна». Когда зеленая кнопка Далее перестанет отображаться в верхнем углу страницы, можно запускать обновление.
Если вы планируете провести подготовительные действия днем, а непосредственную установку ночью, необходимо заранее запустить проверку и кэширование образов:
- Днем нажмите кнопку Запустить проверку в выпадающем меню рядом с кнопкой Play.
- Дождитесь завершения проверки.
- Нажмите кнопку Кэшировать образы в выпадающем меню. Это позволит сэкономить время ночной установки.
При таком подходе ночью достаточно будет нажать на кнопку Play и завершить обновление согласно инструкции.
Шаг 1. Запустите обновление
Для обновления версии Почты:
- Запустите установку, нажав на кнопку Play напротив индикатора состояния.
- Подтвердите запуск автоматической установки, нажав на кнопку Запустить во всплывающем окне. В этом окне также есть возможность увеличить процент контейнеров одной роли, устанавливаемых одновременно. Допустима установка значений: 25, 50, 100. Это ускорит процесс обновления.
- Дождитесь завершения установки.
- Перейдите в панель администратора
https://biz.main-domain
. - Авторизуйтесь под учетной записью администратора
admin@admin.qdit
. - Убедитесь, что письма отправляются и доходят до адресата. Для проверки лучше написать письмо от одного пользователя другому пользователю и убедиться, что оно будет доставлено.
Шаг 2. Мигрируйте хранилища метаданных
Внимание
Пропустить шаг миграции при обновлении с версии 1.20 на 1.21 нельзя! В противном случае вы можете столкнуться с критическими ошибками. При обновлении на 1.21 с более ранних версий необходимо обратиться к представителю ВК.
- После завершения обновления перейдите в раздел Обслуживание -> Миграции.
- Нажмите кнопку Далее.
- Нажмите кнопку Запустить миграцию. В процессе миграции есть возможность ее остановить. По завершении миграции появится соответствующее сообщение и данные о перенесенной информации.
- Нажмите кнопку Далее. На этой странице есть возможность скачать файл с отчетом о миграции.
- Нажмите кнопку Далее. Появится сообщение об успешности миграции.
- Нажмите на кнопку Удалить контейнеры и записи из БД.
- После перехода к списку ролей запустите автоматическую установку и дождитесь ее завершения.
Дата обновления документа: 16.09.2024