Инструкция по установке обновлений Почты на одну машину

Предварительные условия для установки обновления

Убедитесь, что представители VK предоставили вам следующие данные:

• Ссылку на скачивание дистрибутива новой версии Почты.
• Пароль от архива с дистрибутивом.

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

Внимание

Если предполагается обновление более чем на одну версию, например у вас стоит версия 1.19, а вы хотите обновиться сразу на 1.21.1, то проконсультируйтесь с представителями VK, иначе могут возникнуть проблемы при обновлении.

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

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

1. Используйте учетную запись пользователя, от имени которого производилась первичная установка.

2. Поместите zip-архив с дистрибутивом новой версии в ту же папку, которая использовалась при первичной установке. То есть туда же, где находится файл-установщик onpremise-deployer_linux.

3. Распакуйте архив под той же учетной записью поверх имеющегося дистрибутива с заменой всех изменившихся файлов.

   Примечание

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

4. Проверьте, есть ли у файла onpremise-deployer_linux флаг на исполнение (x) с помощью команды:

   ls -la <путь к каталогу с файлом>`.
   

5. Если флаг отсутствует, выполните команду:

   chmod +x onpremise-deployer_linux
   

6. Выполните команду sudo systemctl restart deployer.

7. Перейдите в веб-интерфейс установщика http://server-address:8888, где server-address — ip-адрес машины, на которую производится установка, либо ее доменное имя.

8. Пролистайте список контейнеров и в нижней части страницы нажмите на кнопку Сгенерировать автоматически.

   

9. Вернитесь в верхнюю часть страницы и проверьте, отображается ли в правом верхнем углу зеленая кнопка Далее.

Внимание

При обновлении с версии 1.20.0 и 1.21.0 необходимо провести дополнительную настройку в разделе Хранилища -> Mescalito.

Шаг 1. Добавьте контейнер xtaz в разделе Mescalito

Перед автоматической установкой необходимо добавить контейнер xtaz в разделе Хранилища -> Mescalito:

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

   

2. Добавьте в кластер №1 контейнер xtaz2, который был создан при автоматической генерации.

3. Сохраните изменения.
4. Проведите донастройку других параметров системы.

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

Шаг 2. Запустите обновление

Для обновления версии Почты:

1. Запустите установку, нажав на кнопку Play напротив индикатора состояния.

   

2. Подтвердите запуск автоматической установки, нажав на кнопку Запустить во всплывающем окне.

   

3. Дождитесь завершения установки.

   

4. Перейдите в панель администратора https://biz.main-domain.

5. Авторизуйтесь под учетной записью администратора admin@admin.qdit.
6. Убедитесь, что письма отправляются и доходят до адресата. Для проверки лучше написать письмо от одного пользователя другому пользователю и убедиться, что оно будет доставлено.

Шаг 3. Мигрируйте хранилища метаданных

Внимание

Пропустить шаг миграции при обновлении с версии 1.20 на 1.21.1 нельзя! В противном случае вы можете столкнуться с критическими ошибками. При обновлении на 1.21 с более ранних версий необходимо обратиться к представителю ВК.

После завершения обновления:

1. Перейдите в раздел Обслуживание -> Миграции.

   

2. Нажмите кнопку Далее.

3. На следующем шаге нажмите кнопку Запустить миграцию. По завершении миграции появится соответствующее сообщение и данные о перенесенной информации.
4. Нажмите кнопку Далее. На этой странице есть возможность скачать файл с отчетом о миграции.
5. Нажмите кнопку Далее. Появится сообщение об успешности миграции.
6. Нажмите на кнопку Удалить контейнеры и записи из БД.
7. После перехода к списку ролей запустите автоматическую установку и дождитесь ее завершения.

Дата обновления документа: 16.09.2024