Инструмент "tibxread" для получения данных из резервной копии

Cyber Protection предоставляет tibxread для ручной проверки целостности резервной копии диска. Этот инструмент позволяет получить данные из резервной копии и рассчитать хэш указанного диска. Инструмент устанавливается автоматически со следующими компонентами: агент для Windows, агент для Linux и агент для Mac.

Путь установки: та же папка, что и на агенте (например, C:\Program Files\BackupClient\BackupAndRecovery).

Поддерживаемые расположения

Локальный диск
Сетевая папка (CIFS/SMB), которая доступна без ввода учетных данных.

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

Необходимо указать URL-адрес, порт и сертификат. URL-адрес и порт можно получить в разделе реестра Windows или конфигурационных файлах на машинах Linux/Mac.

Для Windows:
```
HKEY_LOCAL_MACHINE\SOFTWARE\Acronis\BackupAndRecovery\Settings\OnlineBackup\FesAddressCache\Default\<имя_клиента>\FesUri
```
Для Linux:
```
/etc/Acronis/BackupAndRecovery.config
```
Для macOS:
```
/Library/Application Support/Acronis/Registry/BackupAndRecovery.config
```
Сертификат находится в следующих расположениях:

Для Windows:
```
%allusersprofile%\Acronis\BackupAndRecovery\OnlineBackup\Default
```
Для Linux:
```
/var/lib/Acronis/BackupAndRecovery/OnlineBackup/Default
```
Для macOS:
```
/Library/Application Support/Acronis/BackupAndRecovery/OnlineBackup/Default
```

Инструмент позволяет выполнить следующие команды:

list backups
list content
get content
calculate hash

list backups

Выводит точки восстановления в резервной копии.

ФОРМАТ:

tibxread list backups --loc=URI --arc=BACKUP_NAME --raw

Параметры

--loc=URI
--arc=BACKUP_NAME
--raw
--utc
--log=PATH

Шаблон вывода:

GUID   Date   Date timestamp
----   ------ --------------
<guid> <дата> <метка времени>

<guid>: GUID резервной копии.

<date>: дата создания резервной копии. Используется формат “ДД.ММ.ГГГГ ЧЧ24:ММ:СС”. В локальном часовом поясе по умолчанию (можно изменить, используя параметр --utc).

Пример вывода:

GUID   Date   Date timestamp
----   ------ --------------
516FCE73-5E5A-49EF-B673-A9EACB4093B8 18.12.2019 16:01:05 1576684865
516FCE73-5E5A-49EF-B673-A9EACB4093B9 18.12.2019 16:02:05 1576684925

list content

Выводит содержимое точки восстановления.

ФОРМАТ:

tibxread list content --loc=URI --arc=BACKUP_NAME --password --backup=RECOVERY_POINT_ID --raw --log=PATH

Параметры

--loc=URI
--arc=BACKUP_NAME
--password
--backup=RECOVERY_POINT_ID 
--raw
--log=PATH

Шаблон вывода:

Disk     Size   Notarization status
-------- ------ ---------------------
<номер> <размер> <состояние_нотаризации>

<number>: идентификатор диска.

<size>: размер в байтах.

Для <notarization_status> используются следующие статусы: "Без нотаризации", "Нотаризовано", "Следующая резервная копия".

Пример вывода:

Disk     Size   Notary status
-------- ------ --------------
1        123123465798 Notarized
2        123123465798 Notarized

get content

Записывает содержимое указанного диска в точке восстановления в стандартный вывод (stdout).

ФОРМАТ:

tibxread get content --loc=URI --arc=BACKUP_NAME --password --backup=RECOVERY_POINT_ID --disk=DISK_NUMBER --raw --log=PATH --progress

Параметры

--loc=URI
--arc=BACKUP_NAME
--password
--backup=RECOVERY_POINT_ID
--disk=DISK_NUMBER
--raw
--log=PATH
--progress

calculate hash

Рассчитывает хэш указанного диска в точке восстановления, используя алгоритм SHA-256, и записывает его в stdout.

ФОРМАТ:

tibxread calculate hash --loc=URI --arc=BACKUP_NAME --password --backup=RECOVERY_POINT_ID --disk=DISK_NUMBER --raw --log=PATH --progress

Параметры

--loc=URI
--arc=BACKUP_NAME 
--password
--backup=RECOVERY_POINT_ID
--disk=DISK_NUMBER
--raw
--log=PATH

Описание параметров

Параметр	Описание
--arc=BACKUP_NAME	Имя файла резервной копии, который можно получить из свойств резервной копии на веб-консоли. Файл резервной копии должен иметь расширение .tibx.
--backup=RECOVERY_POINT_ID	Идентификатор точки восстановления
--disk=DISK_NUMBER	Номер диска (идентичный записанному в вывод команды "получить содержимое")
--loc=URI	URI хранилища резервных копий. Возможные форматы параметра "--loc": Имя локального пути (Windows) `c:/upload/backups` Имя локального пути (Linux) `/var/tmp` SMB/CIFS `\\server\folder` Облачное хранилище данных `--loc=<IP-адрес>:443 --cert=<путь_к_сертификату> [--storage_path=/1]` `<IP-адрес>` можно найти в следующем разделе реестра Windows: HKEY_LOCAL_MACHINE\SOFTWARE\Acronis\BackupAndRecovery\Settings\OnlineBackup\FesAddressCache\Default\<имя_клиента>\FesUri `<путь_к_сертификату>` — путь к файлу сертификата для доступа к Cyber Cloud. Например, в Windows этот сертификат расположен в папке `C:\ProgramData\Acronis\BackupAndRecovery\OnlineBackup\Default\<имя_пользователя>.crt`, где <имя_пользователя> — имя вашей учетной записи для доступа к Cyber Cloud.
--log=PATH	Включает запись журналов по указанному пути PATH (только локальный путь, формат такой же, как для параметра `--loc=URI`). Для уровня ведения журнала используется ОТЛАДКА.
--password=ПАРОЛЬ	Пароль шифрования для резервной копии. Если резервная копия не зашифрована, оставьте это поле пустым.
--raw	Скрывает заголовки (2 первых строки) в выводе команды. Используется, когда нужно проанализировать вывод команды. Пример ввода без `--raw`: GUID Date Date timestamp ---- ------ -------------- 516FCE73-5E5A-49EF-B673-A9EACB4093B8 18.12.2019 16:01:05 1576684865 516FCE73-5E5A-49EF-B673-A9EACB4093B9 18.12.2019 16:02:05 1576684925 Вывод без использования `--raw`: 516FCE73-5E5A-49EF-B673-A9EACB4093B8 18.12.2019 16:01:05 1576684865 516FCE73-5E5A-49EF-B673-A9EACB4093B9 18.12.2019 16:02:05 1576684925
--utc	Показывает даты в часовом поясе UTC
--progress	Показывает ход выполнения операции. Пример: 1% 2% 3% 4% ... 100%