Перейти к содержанию

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

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

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

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

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

Внимание

Обновление до версии 1.24 возможно только с версии 1.22 и выше. Если у вас установлена версия 1.21 и ниже, то вам нужно будет обновить систему до версии 1.22 и только после этого можно будет обновиться до версии 1.24.

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

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

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

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

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

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

Внимание

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

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

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

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

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

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

    Внимание

    Шаги 4 и 5 из этого раздела актуальны только для обновления на версию 1.24.

  4. Откройте для редактирования файл $DEPLOYER_HOME/configs/rimap/zubr/picker-zubr.yaml, где $DEPLOYER_HOME — папка в которую распаковывался установщик. Например, /home/deployer:

    vim /home/deployer/configs/rimap/zubr/picker-zubr.yaml

  5. Добавьте сервис - 94 # arbuzapi в раздел:

    constructor:
    services:

    Общий вид раздела после изменения:

    services:
    - 12 # MEMC_NEWMAIL
    - 25 # ADDRBOOK
    - 36 # autoreply_limiter
    - 37 # PDD
    - 41 # RIMA
    - 46 # IRINA
    - 57 # SPAMABUSE
    - 62 # DOMEN
    - 64 # HERMES
    - 76 # RICO
    - 94 # arbuzapi
    - 103 # USPATH 2
    - 108 # XTAZIK
    - 130 # RIMAP-API

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

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

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

    chmod +x onpremise-deployer_linux

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

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

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

    GenerateAutomatically

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

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

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

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

    xtaz

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

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

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

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

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

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

    Play

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

    Confirm

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

    SetupCompleted

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

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

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

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

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

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

    StartMigration

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

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

    StartMigration