Инвентаризация резервных копий в указанных хранилищах

Шаги сценария

1. Пользователь выполняет команду copywala backups inventory.

   Справка по команде copywala backups inventory

   Описание:

   Выполняет проверку резервных копий путем сопоставления записей о них в служебной БД (задается в copywala.yaml в секции pbra_db) с фактически существующими архивами резервных копий в хранилищах. Проверка позволяет убедиться, что архивы присутствуют, доступны и готовы к использованию. По умолчанию (без указания флагов) проверка выполняется по всем хранилищам.

   Проверка возможна в одном из режимов:

Режим	Что проверяется	Результат
Базовая проверка (без флага --detail)	наличие файла по указанному URI; доступность файла для чтения; корректность заголовка архива; контрольная сумма архива.	Если файл доступен и читается — статус устанавливается в success. Если файл не найден, не доступен или возникла ошибка чтения — статус устанавливается в failed.
Детальная проверка (c флагом --detail)	Все то же, что в базовой проверке + сравниваются метаданные из архива резервной копии с данными в служебной БД.	Если файл доступен, читается и метаданные совпадают — статус success. Если файл доступен, но метаданные не совпадают — статус failed с ошибкой "backup info mismatch". В выводе отображаются конкретные различия между полями. Если файл не найден или не читается — статус failed с соответствующей ошибкой.

Синтаксис:

    
copywala backups inventory [flags]

Обязательные параметры:

Нет.

примечание

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

Это требование связано с тем, что URI содержит символ &, который интерпретируется Bash как оператор фонового запуска команды.

Ниже приведен пример для команды copywala cwl info:

    
copywala cwl info "s2://<s2-host>/<ddboost-storage-unit>/path/in/ddboost/storage/unit?driver=ddboost&data_domain_host=<ddboost-host>"

Опциональные параметры:

[flags] – доступны следующие флаги:

Флаг	Описание
-h|--help	Показать справку по команде
-c|--config <path to copywala config>	Использовать конфигурационный файл, отличный от файла по умолчанию: /etc/pbr/copywala.yaml
--detail	Выполнить инвентаризацию с детальной проверкой
--local	Проверка резервных копий, находящихся в хранилище Local FS (local-fs://)
--s2	Проверка резервных копий, находящихся в хранилище S2 (s2://)
--s3	Проверка резервных копий, находящихся в хранилище S3 (s3://)
--ddboost	Проверка резервных копий, находящихся в хранилище DDBoost (ddboost://)

примечание

Подробное описание типов хранилищ приведено в разделе Хранилища резервных копий.

::::

2. Продукт выполнят команду, в CLI выводится сообщение о резервных копиях в хранилищах.

Исключительные сценарии

2. В CLI выводится сообщение об ошибке для случаев:

   • Недостаточно прав для проведения инвентаризации.
   • Не удалось установить подключение к целевой базе данных.