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

Как обновлять Почту до версий ниже 26.1

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

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

Дополнительная документация

Как обновить SSL-сертификаты

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

Внимание

Обновиться до версии 26.1 можно только с версии 25.4. Для версии 25.4 и ниже не пропускайте больше одной версии при обновлении.

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

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

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

3. Проверьте наличие лицензий Почты на каждом домене. Отсутсвие лицензии приведет к неработоспособности продукта после обновления.

4. Проверьте дисковое пространство:

   • На разделах выделенных для хранения данных должно быть свободно более 15% дискового пространства и обязательно более 25 Гб.
   • На всех остальных разделах должно быть занято не более 10% дискового пространства.

5. Чтобы Почта VK WorkSpace работала корректно, нужно установить оперативное обновление ядра ОС указанной ниже версии. Версия должна быть актуальной на момент обновления. Поддерживаемые операционные системы:

   • Astra Linux SE Орел — версия 1.7.5+, версия ядра — 5.15.
   • Astra Linux SE Орел — версия 1.8, версия ядра — 6.1.
   • РЕД ОС — версия 7.3.5, версия ядра — 6.1.
   • РЕД ОС — версия 7.3с (сертифицированная), версия ядра — 6.1.
   • РЕД ОС — версия 8, версия ядра — 6.6 или 6.12.
   • MosOS Arbat — версия 15.5, версия ядра — 5.14.

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

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

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. Вернитесь в верхнюю часть страницы и проверьте, отображается ли в правом верхнем углу зеленая кнопка Далее.

Что делать если при обновлении возникнут проблемы с cld-stock?

Симптомы:

При попытке инициализировать схему на новой версии Tarantool на ролях cld-stock возникает ошибка.

Решение:

Для версии 26.1Для версии 26.1.1

1. В веб-интерфейсе установщика перейдите в Настройки -> Шардирование и репликация БД.

2. Найдите на странице кластера cld-stock и определите какие контейнеры являются мастерами.

   

3. Остановите контейнеры, которые являются мастерами. Для примера выше нужно будет выполнить 2 команды:

   systemctl stop onpremise-container-cld-stock4
   systemctl stop onpremise-container-cld-stock1
   

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

5. В левом боковом меню найдите cld-stock.

6. Нажмите кнопку редактирования .

7. Нажмите на кнопку + Добавить.

8. В поле Название переменной введите TARANTOOL_BOX_SCHEMA_UPGRADE_ON_START, в поле Значение переменной введите значение 1.

9. Нажмите Сохранить:

10. Для всех контейнеров cld-stock* выполните шаг up_container.

11. В веб-интерфейсе установщика перейдите в Настройки -> Шардирование и репликация БД.

12. В списке кластеров кликните правой кнопкой мыши по строке с кластером cld-stock и нажмите Опросить кластер.

    

13. Для всех контейнеров cld-stock-proxy* выполните шаги init_VShard и up_container.

14. Когда шаг up_container для контейнеров cld-stock-proxy* завершится, перейдите в раздел Настройки → Переменные окружения.

15. В левом меню найдите cld-stock и для переменной TARANTOOL_BOX_SCHEMA_UPGRADE_ON_START установите значение 0.

16. Для всех контейнеров cld-stock* выполните шаг up_container.

1. В веб-интерфейсе установщика перейдите в Настройки -> Шардирование и репликация БД.

2. В списке кластеров кликните правой кнопкой мыши по строке с кластером cld-stock и нажмите Опросить кластер.

   

3. Вам нужно сохранить номера реплик, которые выделены красным цветом. Мастер помечается значком короны, все остальные контейнеры -- реплики.

   

4. Перейдите на главную страницу веб-интерфейса установщика и для проблемных реплик выполните шаг up_container.

Шаг 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. Убедитесь, что письма отправляются и доходят до адресата. Для проверки лучше написать письмо от одного пользователя (не от admin@admin.qdit) другому пользователю и убедиться, что оно будет доставлено.

Шаг 3. Выполните компактизацию и дефрагментацию etcd

Данный шаг не является обязательным, но рекомендуется выполнить его, чтобы сохранить скорость работы системы. После завершения обновления и миграции хранилищ метаданных:

1. Перейдите в раздел Настройки -> Шардирование и репликация БД.
2. Найдите БД infraetcd.

3. Кликните правой кнопкой мыши по строчке с infraetcd и нажмите кнопку Compact & defrag.

   

4. Найдите БД mailetcd.

5. Кликните правой кнопкой мыши по строчке с mailetcd и нажмите кнопку Compact & defrag.

   

Шаг 4. Проведите тестирование пользовательских интерфейсов

Чтобы убедиться, что обновление прошло успешно, рекомендуем пройти проверки из инструкции:
Как вручную проверить состояние Почты.