Резервное копирование платформы

Вы можете создать резервную копию VMmanager, содержащую все настройки платформы. Резервная копия сохраняется в формате архива tar и содержит файлы:

• config.json — конфигурационный файл платформы;
• docker-compose.yaml — конфигурационный файл Docker;
• vm_dump.sql — дамп базы данных платформы.

Имена копий имеют вид YYYY_MM_DD__HH_MM.tar.gz.

Вы можете настроить создание резервных копий платформы по расписанию и их экспорт на внешнее хранилище. В качестве хранилища может использоваться физический или виртуальный сервер с доступом по SSH или FTP. Пять последних резервных копий платформы дополнительно сохраняются на сервере с VMmanager в директории /opt/ispsystem/vm/backup/.

Резервное копирование и восстановление из резервной копии выполняет сервис установки платформы vm. Если на восстанавливаемом сервере VMmanager не установлен или повреждён, сервис проведёт установку платформы, а затем восстановит данные из резервной копии.

Определение необходимого дискового пространства

При создании резервной копии её данные сохраняются в директорию /tmp на сервере с платформой. Убедитесь, что в разделе с этой директорией достаточно свободного места. Если места недостаточно, то резервная копия не будет создана.

Основной объём резервной копии составляет дамп базы данных. Чтобы узнать его размер:

1. Подключитесь к серверу с платформой по SSH.
2. Выполните команду: 
   
   MySQL

   sudo docker exec -it mysql bash -c "mysqldump --all-databases --single-transaction --extended-insert -p\$MYSQL_ROOT_PASSWORD --log-error=/dev/null > /tmp/platform_dump.sql" && sudo docker exec -it mysql du -h /tmp/platform_dump.sql && sudo docker exec -it mysql rm -f /tmp/platform_dump.sql

   PostgreSQL

   sudo docker exec -it pgsql bash -c "pg_dump isp > /tmp/platform_dump.sql" && sudo docker exec -it pgsql du -h /tmp/platform_dump.sql && sudo docker exec -it pgsql rm -f /tmp/platform_dump.sql

Создание резервных копий

Через командную строку

1. Подключитесь к серверу с VMmanager по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.

2. Введите команду:

   vm backup

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

Копия будет сохранена в директории /opt/ispsystem/vm/backup/.

Через интерфейс платформы

Чтобы создавать копии, настройте расписание резервного копирования платформы. Для этого перейдите в  → Резервное копирование → Добавить расписание:

1. Выберите когда нужно Создавать копии:
   • Ежедневно;
   • Еженедельно → выберите день недели;
   • Ежемесячно → введите число месяца с 1 по 28 → Применить;
   • задайте время в формате планировщика cron. Например, 15 10 * * 0 — создавать копии по воскресеньям в 10:15 UTC или 00 12 1,16 * * — создавать копии по 1-м и 16-м числам месяца в 12:00 UTC.
2. Введите время в UTC, после которого будет запущено создание копии.
3. Укажите Название расписания. По умолчанию платформа создаёт расписание с именем, соответствующим настройкам расписания. Например, "Ежедневно в 0:00 по SSH".
4. Укажите произвольное Примечание к расписанию.
5. Выберите хранилище для резервных копий:
   • внешнее хранилище с подключением по SSH;

   • внешнее хранилище с подключением по FTP;

     Обратите внимание!

     Платформа не сможет сохранить резервную копию, если у FTP-сервера недействительный SSL-сертификат.

   • Хранить локально — копия будет создана на сервере с платформой.

     Обратите внимание!

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

6. Если вы используете внешнее хранилище, укажите его настройки:

   1. IP-адрес или доменное имя;
   2. Порт;
   3. Логин;
   4. Пароль или нажмите Хочу использовать публичный ssh-ключ для настройки соединения по SSH-ключу;
   5. Путь хранения — директория на сервере, в которую платформа будет сохранять резервные копии.
7. Нажмите Добавить.

Вы можете управлять созданными расписаниями через меню в разделе Настройки → Резервное копирование. Возможные действия с расписанием:

• Запустить расписание — выполнить внеочередной запуск;
• Редактировать — изменить расписание;
  При изменении расписания потребуется повторно ввести пароль к FTP или SSH-серверу.
• Включить/Выключить;
• Примечание — добавить примечание;
• Удалить.

Также в этом разделе вы можете скачать пять последних резервных копий платформы.

Восстановление из резервной копии

Если VMmanager на сервере не установлен

1. Сгенерируйте новый токен лицензии.
   

   Вы можете сделать это в личном кабинете на my.ispsystem.com или обратиться в техническую поддержку.

2. Подключитесь к серверу по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.
3. Обновите минорную версию операционной системы до последней стабильной.
4. Если в системе не установлен архиватор tar или утилита curl, установите их: 

   dnf install tar curl || apt install curl tar

5. Cкачайте установщик:

   curl -O https://download.ispsystem.com/6/installer/vm/vm

6. Сделайте файл установщика исполняемым:

   chmod +x vm

7. Запустите восстановление:

   ./vm restore -b=<backup_file>

   Пояснения к команде

   <backup_file> — полный путь к файлу с резервной копией. Например, /opt/ispsystem/vm/backup/2022_03_30__00_00.tar.gz
8. Если требуется, введите пароль к архиву резервной копии.
9. Если у сервера изменилось доменное имя: 
   1. Укажите новое доменное имя в параметре DomainName файла /opt/ispsystem/vm/config.json.
   2. Перезапустите платформу:
      

      vm stop && vm start

10. Активируйте лицензию:
    1. В интерфейсе VMmanager перейдите в → Обзор системы.
    2. Введите Токен лицензии.
    3. Нажмите кнопку Активировать.

Если VMmanager на сервере установлен

1. Сгенерируйте новый токен лицензии.
   

   Вы можете сделать это в личном кабинете на my.ispsystem.com или обратиться в техническую поддержку.

2. Подключитесь к серверу по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.
3. Обновите минорную версию операционной системы до последней стабильной.
4. Если в системе не установлен архиватор tar, установите его: 

   dnf install tar || apt install tar

5. Запустите восстановление:

   vm restore -b=<backup_file>

   Пояснения к команде

   <backup_file> — полный путь к файлу с резервной копией. Например, /opt/ispsystem/vm/backup/2022_03_30__00_00.tar.gz
6. Если требуется, введите пароль к архиву резервной копии.

7. Перейдите в директорию с файлами лицензий: 

   cd /opt/ispsystem/license

8. Удалите из директории все файлы, кроме machine_id: 

   rm -v !("machine_id")

9. Если у сервера изменилось доменное имя: 
   1. Укажите новое доменное имя в параметре DomainName файла /opt/ispsystem/vm/config.json.
   2. Перезапустите платформу:
      

      vm stop && vm start

10. Активируйте лицензию:
    1. В интерфейсе VMmanager перейдите в → Обзор системы.
    2. Введите Токен лицензии.
    3. Нажмите кнопку Активировать.

Если VMmanager в закрытом контуре

1. Подключитесь к серверу платформы по SSH. Подробнее о подключении по SSH см. в статье Настройка рабочего места.
2. Если VMmanager на сервере не установлен, установите ту же версию платформы, для которой была создана резервная копия. Подробнее об установке см. в статье Установка в закрытом информационном контуре. 
3. Если в системе не установлен архиватор tar, установите его:

   dnf install tar || apt install tar

4. Запустите восстановление:

   sudo vm restore -i -b=<backup_file>

   Пояснения к команде

   <backup_file> — полный путь к файлу с резервной копией. Например, /opt/ispsystem/vm/backup/2022_03_30__00_00.tar.gz
5. Если требуется, введите пароль к архиву резервной копии.
6. Если у сервера изменилось доменное имя: 
   1. Укажите новое доменное имя в параметре DomainName файла /opt/ispsystem/vm/config.json.
   2. Перезапустите платформу:
      

      vm stop && vm start

7. Активируйте лицензию:
   

   Активация лицензии в закрытом контуре

   1. Если вы активируете лицензию впервые, пропустите этот пункт. Если вы активируете лицензию повторно:
      1. Подключитесь к серверу с платформой по SSH.

      2. Удалите из директории /opt/ispsystem/license/ все файлы, кроме machine_id: 

         find /opt/ispsystem/license/ -type f -not -name 'machine_id' -delete

      3. Подождите несколько минут для генерации нового ключа привязки.
   2. В правом меню нажмите значок → вкладка Обзор системы.
   3. В разделе Активация лицензии скачайте Ключ привязки — файл binding-key.txt. 
      Не закрывайте и не обновляйте эту вкладку до получения файла лицензии. При обновлении страницы будет сформирован новый ключ привязки, к которому не подойдёт файл лицензии.
   4. Отправьте ключ привязки, id и токен лицензии в техническую поддержку ISPsystem или отдел продаж вашего дистрибьютора. В ответ вы получите файл лицензии.
   5. В разделе Активация лицензии загрузите файл лицензии и нажмите кнопку Активировать.
      

   За один месяц до окончания срока лицензии в интерфейсе появится баннер с напоминанием о продлении. Чтобы продлить лицензию, повторно выполните действия для активации лицензии.