Полезные утилиты
Сбор журналов работы системы и базовой диагностики
Внимание
Утилита дорабатывается, представлена ее бета-версия.
Чтобы собрать логи, нужно выполнить следующие действия:
-
Скачать архив logs.tgz.
-
Скопировать архив logs.tgz на один из серверов системы.
-
Распаковать архив.
-
Запустить скрипт.
-
Скачать сформированный по результатам выполнения скрипта архив.
В процессе выполнения скрипта могут быть запрошены пароли для пользователя, под которым запущен скрипт, для входа на остальные сервера, на которых установлена система. Пользователь должен иметь права sudo.
Резервное копирование через утилиту mnt-backup
Внимание
Чтобы получить утилиту mnt-backup для резервного копирования, обратитесь в техническую поддержку.
Установка и настройка утилиты
Предварительные условия
Для корректной работы утилиты требуется следующий пакет: rsync.
Создание каталога для установки
Обязательно создайте в директории (/home) пользователя с правами sudo отдельный каталог для распаковки архива с дистрибутивом и запуска программы. Не рекомендуется распаковывать архив и запускать программу в домашней директории пользователя. Не забудьте установить приложение для распаковки архива, например unzip.
Создание пользователя и авторизация
Перед началом работы:
- создайте отдельного пользователя с правами sudo (группа wheel). Подключаться к серверу под учетной записью root нельзя по требованиям безопасности;
- авторизуйтесь под этим пользователем перед выполнением дальнейших шагов.
Распаковка архива
Скопируйте или переместите архив с дистрибутивом в специально созданный каталог (в домашней директории пользователя с правами sudo). Затем распакуйте архив. Состав дистрибутива:
- файлы программы mnt-backup;
- каталог tars со вспомогательными образами;
При работе запускайте файл mnt-backup от имени специально созданного пользователя и именно из той директории, в которой находится файл программы.
Подготовка к резервному копированию
-
Выполните загрузку вспомогательных образов:
-
Подготовьте гипервизор к резервному копированию:
Утилита выполнит резервное копирование баз данных (физическое) по указанному пути.
Данные, подлежащие резервному копированию
Резервное копирование всех сущностей Docker за исключением постоянных дисков:
- /var/lib/docker/
Резервное копирование утилиты по установке и настройке системы:
- /home/deployer/
- Директория с установщиком Почты onpremise-deployer_linux. Необходимо, если при установке Почты вы распаковали архив с дистрибутивом в другую директорию.
Резервное копирование юнит-файлов установщика и системы:
-
/etc/systemd/system/onpremise-*
-
/etc/systemd/system/deployer.service
Резервное копирование постоянных дисков:
- /opt/mailOnPremise/
Резервное копирование баз данных (путь, указанный при подготовке к резервному копированию):
- /backup/2023-03-30/
Из директории постоянных дисков стоит исключить файлы баз данных, которые были подготовлены ранее и перечислены в файле pathToExclude.txt, расположенном по пути, указанному при подготовке к резервному копированию.
Восстановление гипервизора
-
Выполните восстановление установщика (из директории в директорию):
- /home/deployer/ -> /home/deployer/
- /etc/systemd/system/deployer.service -> /etc/systemd/system/deployer.service
Внимание
Если при установке Почты вы распаковали архив с дистрибутивом не в /home/deployer/, а в другую директорию, например, /opt/VKWorkmail/deployer/, то также нужно выполнить восстановление:
- /opt/VKWorkmail/deployer/ -> /opt/VKWorkmail/deployer/
-
Выполните шаги по настройке машины из программы-установщика:
-
Остановите сервисы:
-
Восстановите директорию Docker:
/var/lib/docker/ -> /var/lib/docker/
-
Восстановите юнит-файлы:
/etc/systemd/system/* -> /etc/systemd/system/
-
Восстановите постоянные диски:
-
Запустите сервисы:
-
Для всех сервисов поочередно запустите задачи up_container из установщика.
-
Перейдите в программу-установщик (http://<ip_or_domain_name>:8888).
-
Перейдите в настройки сервиса и выполните шаг:
up_container
. Пункт 8.b необходимо выполнить последовательно для каждого сервиса.
Примечание
Для автоматической установки можно воспользоваться утилитой yq. Установите ее и выполните команду:
, где deployer_path - путь, по которому установлена система.yq '(.[][] | select (.name == "up_container")).status = "needRefresh"' -i <deployer_path>/computesPlaybooks.yaml systemctl restart deployer
После проделанной операции все задачи up_container перейдут в статус «Необходимо обновление» ─ теперь можно начинать автоматическую установку.
Перейдите в программу-установщик (http://<ip_or_domain_name>:8888). Запустите автоматическую установку без проверки:
-