Bug 51973

Версия: docs-alt-server-10.4-alt1

В качестве тестового стенда, на котором выполнялась проверка:
P10 Server x86-64
Версия: proxmox-backup-server-3.1.4.1-alt3 на P10

1) По-разному представлен результат выполненной команды.
Шаги: 
перейти в документации к п.56.7.3. Восстановление данных → на сервер просмотреть список снимков на сервере:
$ proxmox-backup-client snapshot list --repository pbs.test.alt:store1
Password for "root@pam": ******

snapshot                           size         files
host/host-01/2023-09-17T12:10:47Z  409.13 MiB   catalog.pcat1 index.json user.pxar
host/host-01/2023-09-17T12:14:27Z  409.147 MiB  catalog.pcat1 index.json user_s.pxar

Выполнить на сервере данную команду: $ proxmox-backup-client snapshot list --repository pbs.test.alt:store1

Результат: получен вариант в табличном виде, в документации указано в обычном виде.

На сервере:
$ proxmox-backup-client snapshot list --repository pbs.test.alt:store1
Password for "root@pam": ***
storing login ticket failed: $XDG_RUNTIME_DIR must be set
┌────────────────────────────────┬─────────────┬──────────────────────────────────────┐
│ snapshot                       │        size │ files                                │
╞════════════════════════════════╪═════════════╪══════════════════════════════════════╡
│ host/pbs/2024-11-07T06:39:45Z │ 411.177 KiB │ catalog.pcat1 index.json user.pxar   │
├────────────────────────────────┼─────────────┼──────────────────────────────────────┤
│ host/pbs/2024-11-07T06:46:35Z │      32 GiB │ index.json mydata.img                │
├────────────────────────────────┼─────────────┼──────────────────────────────────────┤
│ host/pbs/2024-11-07T07:09:30Z │ 412.031 KiB │ catalog.pcat1 index.json user_s.pxar │


'storing login ticket failed: $XDG_RUNTIME_DIR must be set' - не ошибка документации.

Ожидаемый результат: в документации указан результат команды в табличном виде, как на стенде.


2) Добавить примечание по процессу создания резервной копии.
Шаги: 
перейти в документации к п.⁠56.7.1. Создание резервной копии
Абзац: "Создать резервную копию домашнего каталога пользователя user (будет создан архив user.pxar)".
Выполнить на сервере команду:
# proxmox-backup-client list --repository pbs.test.alt:store1

Можно добавить примечание о том, что может быть получен и такой вывод в терминале 'Previous manifest does not contain an archive called 'mydata.img.fidx', skipping download..',
который нельзя сбрасывать, иначе процесс резервного копирования так и не завершится.

Дождаться завершения процесса (может занять до 5 минут), будет висеть информация в терминале:
Previous manifest does not contain an archive called 'mydata.img.fidx', skipping download..

Далее:

mydata.img: had to backup 4 MiB of 32 GiB (compressed 158 B) in 271.14s
mydata.img: average backup speed: 15.106 KiB/s
mydata.img: backup was done incrementally, reused 31.996 GiB (100.0%)
Duration: 271.18s
End Time: Thu Nov  7 09:51:06 2024

Потому как при зависающей в терминале информации 'skipping download' может быть не понятно, идёт ли процесс или нет.
В документации указан результат вывода команды:

Starting backup: host/host-197/2023-09-17T13:12:05Z
Client name: host-01
Starting backup protocol: Sun Sep 17 15:12:05 2023
No previous manifest available.
Upload directory '/home/user/' to 'pbs.test.alt:store1' as user.pxar.didx
user.pxar: had to backup 667.04 MiB of 667.04 MiB (compressed 190.182 MiB) in 26.22s
user.pxar: average backup speed: 25.436 MiB/s
Uploaded backup catalog (109.948 KiB)
Duration: 26.36s
End Time: Sun Sep 17 15:12:12 2023
Убедиться в том, что скачивание идёт можно в веб-интерфейсе: в правом верхнем углу "Задачи" → Длительность → увидим запущенный таймер процесса.
Готовый результат можно просмотреть также в веб-интерфейсе, для этого достаточно перейти в "Задачи" (нажать на кнопку Задачи).

Ожидаемый результат: добавлено примечание по процессу создания резервной копии.