Связаться с намиПодключиться

Обновить или восстановить агент Yandex Cloud Backup на виртуальной машине

Статья создана
Обновлена 5 марта 2025 г.

В некоторых ситуациях, чтобы обеспечить бесперебойное автоматическое резервное копирование виртуальных машин Yandex Compute Cloud, может понадобиться обновить агент Cloud Backup или восстановить нарушенную работоспособность агента.

Обновление агента Cloud Backup

Обновление агента Cloud Backup может потребоваться при технических обновлениях на стороне провайдера резервного копирования. О подобных случаях Yandex Cloud заблаговременно предупреждает клиентов.

Примечание

Обновление агента Cloud Backup не влияет на данные в существующих резервных копиях.

Чтобы обновить агент Cloud Backup на ВМ:

  1. Подключитесь к ВМ по SSH.

  2. В терминале выполните команду:

    curl \
  --output backup_agent_linux_installer.bin \
  https://storage.yandexcloud.net/backup-distributions/backup_agent_linux_installer.bin && \
sudo bash ./backup_agent_linux_installer.bin -a

    Результат:

    ...
Congratulations!
Cyber Backup Agent has been successfully installed in the system.

    Обновление агента Cloud Backup может занимать около 15 минут.

  3. Отключитесь от ВМ.

  1. Подключитесь к ВМ по RDP.

  2. Запустите Windows PowerShell.

  3. Выполните команды:

    Invoke-WebRequest `
  "https://storage.yandexcloud.net/backup-distributions/backup_agent_windows_installer.exe" `
  -OutFile ".\backup_agent_windows_installer.exe"
Invoke-Expression .\backup_agent_windows_installer.exe

  4. В открывшемся окне нажмите Repair.

  5. Дождитесь сообщения The installation was successfully repaired и нажмите CLOSE.

    Обновление агента Cloud Backup может занимать около 15 минут.

  6. Отключитесь от ВМ.

Если по какой-либо причине обновить агент Cloud Backup не удалось, обратитесь в техническую поддержку.

Восстановление работоспособности агента Cloud Backup

При обновлении ядра операционной системы Linux виртуальной машины или сервера BareMetal, подключенных к Cloud Backup, работоспособность агента Cloud Backup может оказаться нарушена: будет невозможно создать резервную копию ВМ/сервера или восстановить ВМ/сервер из резервной копии.

Функционирование агента может нарушиться, потому что модуль SnapAPI, разработанный провайдером резервного копирования для работы агента с дисками и собираемый фреймворком DKMS под конкретное ядро Linux, после обновления ядра может не обновиться и перестать соответствовать версии ядра.

Чтобы восстановить работоспособность агента Cloud Backup, нарушенную после обновления ядра ОС, необходимо обновить версию заголовков ядра Linux, на которую ориентируется DKMS при сборке модуля SnapAPI. Как только версия заголовков ядра станет соответствовать версии ядра, DKMS пересоберет модуль SnapAPI под нужную версию ядра Linux при следующем запуске ВМ или сервера BareMetal.

  1. Убедитесь, что версия ядра Linux расходится с версией заголовков ядра:

    • Чтобы узнать версию ядра Linux, в терминале выполните команду:

      uname -r

      Результат:

      6.1.0-31-amd64

    • Чтобы узнать версию заголовков ядра Linux, выполните команду:

      sudo apt list --installed | grep header

      Результат:

      linux-headers-6.1.0-27-amd64/stable,now 6.1.115-1 amd64 [installed]
linux-headers-6.1.0-27-common/stable,now 6.1.115-1 all [installed,automatic]

    Как видно из вывода команд, значения версий различаются: версия ядра Linux — 6.1.0-31, версия заголовков ядра Linux — 6.1.0-27.

  2. Установите пакет linux-headers для нового ядра Linux:

    sudo apt install linux-headers-$(uname -r)

  3. Убедитесь, что новые заголовки ядра были добавлены:

    sudo apt list --installed | grep header

    Результат:

    linux-headers-6.1.0-27-amd64/stable,now 6.1.115-1 amd64 [installed]
linux-headers-6.1.0-27-common/stable,now 6.1.115-1 all [installed,automatic]
linux-headers-6.1.0-31-amd64/stable-security,now 6.1.128-1 amd64 [installed]
linux-headers-6.1.0-31-common/stable-security,now 6.1.128-1 all [installed,automatic]

  4. Перезапустите операционную систему:

    sudo reboot

    В процессе перезагрузки фреймворк DKMS пересоберет модуль SnapAPI под нужную версию ядра Linux и агент Cloud Backup заработает.

  1. Убедитесь, что версия ядра Linux расходится с версией заголовков ядра:

    • Чтобы узнать версию ядра Linux, в терминале выполните команду:

      uname -r

      Результат:

      3.10.0.1160.81.1.el7.x86_64

    • Чтобы узнать версию заголовков ядра Linux, выполните команду:

      sudo yum list installed | grep kernel-dev*

      Результат:

      kernel-devel.x86_64             3.10.0-1160.76.1.el7            @updates

    Как видно из вывода команд, значения версий различаются: версия ядра Linux — 3.10.0.1160.81.1.el7, версия заголовков ядра Linux — 3.10.0-1160.76.1.el7.

  2. Установите пакет linux-headers для нового ядра Linux:

    sudo yum install kernel-$(uname -r)

  3. Убедитесь, что новые заголовки ядра были добавлены:

    sudo yum list installed | grep kernel-dev*

    Результат:

    kernel-devel.x86_64             3.10.0-1160.76.1.el7            @updates
kernel-devel.x86_64             3.10.0.1160.81.1.el7            @updates

  4. Перезапустите операционную систему:

    sudo reboot

    В процессе перезагрузки фреймворк DKMS пересоберет модуль SnapAPI под нужную версию ядра Linux и агент Cloud Backup заработает.

Если по какой-либо причине восстановить работу агента Cloud Backup не удалось, обратитесь в техническую поддержку.

Предыдущая
Переподключить ВМ на Linux с OS Login к Cloud Backup
Следующая
Посмотреть статус подключения ВМ