Восстановление на новом сервере

Этот сценарий нужен, когда прежний сервер потерян или трекер переезжает на другой сервер. Данные берутся из резервной копии на SFTP-хранилище, домены и лицензия задаются заново. Чтобы вернуть данные на работающей установке, используйте восстановление на месте.

Что подготовить

• Пустой сервер по странице Требования к серверу и подготовка и два домена с DNS-записями на его IP.
• Доступ к серверу хранения с копией: публичный IP, порт SSH, логин, пароль или приватный SSH-ключ и папка. Папка та же, что в поле Папка на сервере при подключении хранилища, например /backups.
• Отпечаток ключа сервера хранения: с ним сверяется отпечаток, который покажет мастер.
• Логин и пароль владельца на момент создания копии: после восстановления вход выполняется ими.
• Новый ключ лицензии. Ключ и привязка из копии не переносятся, новый ключ кабинет выдаёт после отвязки прежнего сервера — см. Перенос лицензии на другой сервер.

Копия подходит только к выпуску с той же схемой данных и теми же версиями баз, что были при её создании. Установщик ставит на новый сервер текущий выпуск. Если прежний сервер работает, обновите на нём трекер и создайте свежую копию.

Установка и первый шаг мастера

Восстановление в мастере доступно только на пустом сервере, до первого запуска трекера.

1. Установите трекер на новый сервер по странице Установка.
2. Откройте ссылку на мастер с кодом доступа.
3. Заполните Домен панели, Домен трекинга и Email для уведомлений.
4. Нажмите Проверить и продолжить.

Мастер выпустит HTTPS-сертификаты и откроет шаг 2 на защищённом адресе. Экраны шага 1 разобраны на странице Мастер первого запуска.

Форму владельца на шаге 2 не заполняйте и кнопку Запустить трекер не нажимайте. Она создаёт пустую установку, после этого восстановить копию в мастере нельзя.

Подключение хранилища

На шаге 2 над формой раскройте блок Восстановить из резервной копии.

1. Заполните IP сервера копий, Порт SSH, Логин SSH и Каталог хранилища.
2. Нажмите Проверить сервер. Под кнопкой появится строка SHA256: … — отпечаток сервера. Пароль и ключ серверу хранения на этом шаге не отправляются.
3. Сравните отпечаток с отпечатком вашего сервера хранения.
4. Отметьте Отпечаток совпадает с ключом моего сервера, если отпечатки совпали.
5. Выберите способ в поле Авторизация.
6. Введите пароль или вставьте ключ.
7. Нажмите Показать копии.

В списке Завершённая копия появятся копии от новых к старым, у каждой — дата создания и размер в мегабайтах. Незавершённые загрузки в список не попадают.

Ход операции показан строкой под кнопкой Скачать и проверить, например «Читаем резервные копии». Сообщения об ошибках появляются внизу страницы, под формой владельца.

Выбор и проверка копии

1. Выберите копию в списке Завершённая копия.
2. Нажмите Скачать и проверить.
3. Дождитесь, пока статус «Скачиваем и проверяем копию» сменится сводкой.

Мастер скачивает копию на новый сервер и проверяет:

• состав копии и контрольные суммы архивов;
• совпадение схемы данных с установленным выпуском;
• совпадение версий баз;
• свободное место: после скачивания должно оставаться не меньше размера распакованных данных с запасом 20% и ещё 2 ГБ.

Сводка начинается словом «Проверено:». В ней дата создания копии, её версия, домен прежней панели и новый домен панели с шага 1. Под сводкой появятся поля Новый ключ лицензии и Введите ВОССТАНОВИТЬ.

Запуск восстановления

1. Вставьте ключ в поле Новый ключ лицензии. Формат — XXXX-XXXX-XXXX-XXXX. Поле можно оставить пустым и ввести ключ после восстановления.
2. В поле Введите ВОССТАНОВИТЬ наберите ВОССТАНОВИТЬ заглавными буквами без пробелов.
3. Нажмите Восстановить трекер.

Откроется экран «Запускаем трекер». В строке Владелец показан логин владельца из копии. Статус меняется по порядку: «Подготавливаем трекер», «Восстанавливаем геобазы», «Восстанавливаем: …» для каждой части копии, «Проверяем базу и очередь отправок», «Запускаем базы и панель», «Проверяем готовность». Трафик открывается только после проверки готовности. Вкладку можно закрыть: восстановление продолжится на сервере.

Когда всё готово, появится экран «Трекер готов», и браузер откроет страницу входа. Ключ, введённый в мастере, трекер активирует сам.

Что берётся из копии

Вход и проверка

1. Откройте https://panel.example.com/login.
2. Войдите логином и паролем владельца из копии. Новый владелец не создаётся, пароли пользователей не меняются.
3. Откройте Настройки → Лицензия. Состояние должно быть «Лицензия активна».
4. Откройте Настройки → Резервные копии и подключите сервер хранения заново.
5. Откройте Логи → Доставка событий и найдите записи с результатом Восстановлено из копии · нужна сверка.

Если вместо панели открылся экран «Доступ к трекеру закрыт», лицензия не активна. Введите новый ключ в поле Ключ лицензии и нажмите Активировать. Если ключ введён в мастере, дождитесь окончания подтверждения прежнего сервера — см. Ожидание после отвязки.

Записи с результатом Восстановлено из копии · нужна сверка — задачи, которые на момент создания копии не были завершены. Сами они не отправятся: прежний сервер мог отправить их уже после создания копии. Сверьте их у получателя и только потом повторяйте — см. Ручной повтор.

Файл /opt/tracker/owner-access.txt после восстановления содержит адрес панели и напоминание войти учётной записью владельца из копии. Пароля в нём нет.

Вариант в терминале: --restore-env

Вариант для установки без браузера. Установщик получает файл .env.production из копии и создаёт новую установку с прежними серверными ключами: без них копия не пройдёт проверку в панели. Данные затем восстанавливаются из панели. Требование к выпуску то же, что в мастере.

1. Скачайте с сервера хранения архив server.tar нужной копии. Он лежит в подпапке tracker-backups папки хранилища, в папке этой копии.
2. Достаньте из архива файл .env.production.
3. Положите файл на новый сервер вне каталога установки, например в /root/recovery/, с правами 0600. Каталог /opt/tracker до установки должен оставаться пустым.
4. Запустите установщик командой ниже. В --admin-email укажите логин владельца прежней установки.
5. Дождитесь строки «Готово. Панель: https://panel.example.com».
6. Войдите в панель с логином и паролем из файла /opt/tracker/owner-access.txt.
7. Подключите прежнее хранилище копий.
8. Выполните проверку и восстановление нужной копии.

sudo bash install.sh --restore-env /root/recovery/.env.production --panel panel.example.com --track track.example.com --email [email protected] --admin-email admin

После восстановления резервные копии, обновления и ключ лицензии доступны только учётной записи с логином из --admin-email, поэтому он должен совпадать с логином владельца из копии. При повторном запуске установщика укажите тот же файл. Неполный файл установщик не принимает: «Файл восстановления не содержит все необходимые серверные секреты.» Все параметры — на странице Параметры install.sh и установка в терминале.

Лицензия в этом варианте сама не сбрасывается. Если панель после установки или после восстановления показывает экран «Доступ к трекеру закрыт», отвяжите сервер в кабинете и активируйте новый ключ — см. Перенос лицензии на другой сервер.

Если не получилось

Команда docker завершилась ошибкой (1).

Общее сообщение блока восстановления: мастер не смог проверить сервер, прочитать хранилище или скачать копию. Проверьте:

• в поле IP сервера копий стоит публичный IP, а не домен;
• Порт SSH и Логин SSH верны, сервер хранения принимает SSH-соединения с нового сервера;
• Каталог хранилища — полный путь от / без / в конце, и в этой папке есть tracker-backups;
• пароль или ключ введены и верны. После обновления страницы поля блока заполняются заново;
• отпечаток сервера хранения не изменился после нажатия Проверить сервер;
• на диске нового сервера свободно не меньше размера копии и ещё 2 ГБ.

Сообщения проверки и запуска

Схема копии отличается. Установите выпуск, на котором создана копия, затем обновите трекер.

Копия создана на другом выпуске трекера.

• Прежний сервер работает: обновите на нём трекер, создайте новую копию и выберите её в мастере. Кнопка Показать копии перечитывает список.
• Прежнего сервера нет: нужен пустой сервер с выпуском, на котором создана копия. Адрес или файл выпуска передаётся установщику параметром --bundle, см. Параметры install.sh и установка в терминале. После восстановления обновите трекер из панели.

Нужно повторить запуск

Восстановление остановилось с ошибкой, её текст показан на экране. Выбранная копия закреплена за установкой: выбрать другую копию или создать пустую установку уже нельзя. Устраните причину и нажмите Повторить запуск. Сообщения запуска разобраны на странице Ошибки установки и их устранение.

Сообщение «Копия содержит неподдерживаемый файл геобазы.» повтором не устраняется: причина в самой копии — см. Геобазы трекера.