Перейти к основному содержимому

Валидация контрольных сумм файлов в CWL-архиве

примечание

Исполнять сценарий необходимо от имени пользователя qdrant.

Описание сценария​

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

Алгоритм расчета контрольных сумм файлов и метаданных архива настраивается путем добавления или изменения поля archive_settings.checksum_algorithm в конфигурационном файле copywala-vdb.yaml:

  • Значение по умолчанию: CRC32.
  • Возможные значения: CRC32, SHA256, DISABLED.

Чтобы отключить контрольные суммы, укажите явно: DISABLED.

Предусловие​

Включена опция проверки целостности метаданных (поле archive_settings.checksum_algorithm).

Последовательность выполнения​

Чтобы удостовериться в отсутствии повреждений сформированного архива резервной копии, запустите процедуру проверки контрольных сумм CWL-архива через CLI компонента Copywala VDB командой copywala-vdb cwl verify <path to cwl archive>.

Результат​

В случае успешного результата будет выведено:

INF copywala-vdb 1.3.0 (35ab33bc) compiled at 2026-05-04_11:02:27
INF finished reading parts package=cwl
INF Verification succeeded without errors

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

  • Файл с архивом не найден:

    $ copywala-vdb cwl verify /home/qdrant/backups/test-agent_019df6e2-2d1f-78a1-8374-4951d51721ea/backups/2026-05-05-10-31_019df70c-b2e3-7e58-b1f3-58259053796c_full_vdb.cwl
    2026-05-07 12:26:31.958 [217892] INF copywala-vdb 1.3.0 (35ab33bc) compiled at 2026-05-04_11:02:27
    2026-05-07 12:26:31.959 [217892] ERR failed to init verify command components err="open /home/qdrant/backups/test-agent_019df6e2-2d1f-78a1-8374-4951d51721ea/backups/2026-05-05-10-31_019df70c-b2e3-7e58-b1f3-58259053796c_full_vdb.cwl: no such file or directory"

Также будет выведено соответствующее сообщение для случаев:

  • Неверный формат файла.
  • Поврежден заголовок архива.
  • Если при создании резервной копии отключено вычисление контрольных сумм метаданных архива.