Bug 51973 - Документация docs-alt-server, п.⁠ ⁠56.7. Клиент резервного копирования: корректировки по описанию работы с клиентом резервного копирования
Summary: Документация docs-alt-server, п.⁠ ⁠56.7. Клиент резервного копирования: корре...
Status: CLOSED FIXED
Alias: None
Product: Sisyphus
Classification: Development
Component: docs-alt-server (show other bugs)
Version: unstable
Hardware: x86_64 Linux
: P5 normal
Assignee: lepata@altlinux.org
QA Contact: qa-sisyphus
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2024-11-07 10:43 MSK by Tatyana Gagina
Modified: 2024-11-12 19:10 MSK (History)
5 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Tatyana Gagina 2024-11-07 10:43:43 MSK
Версия: 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
Убедиться в том, что скачивание идёт можно в веб-интерфейсе: в правом верхнем углу "Задачи" → Длительность → увидим запущенный таймер процесса.
Готовый результат можно просмотреть также в веб-интерфейсе, для этого достаточно перейти в "Задачи" (нажать на кнопку Задачи).

Ожидаемый результат: добавлено примечание по процессу создания резервной копии.
Comment 1 Elena Mishina 2024-11-08 14:20:45 MSK
Во-втором пункте как-то всё смешалось...
Приведена команда просмотра списка резервных копий, а дальше идет информация про необходимость дождаться окончания резервного копирования. Судя по всему, речь идет о команде создания резервной копии блочного устройства? Но к чему тогда вывод команды, в которой создается резервная копия домашнего каталога?
Comment 2 Tatyana Gagina 2024-11-11 11:18:39 MSK
(Ответ для Elena Mishina на комментарий #1)
> Во-втором пункте как-то всё смешалось...
> Приведена команда просмотра списка резервных копий, а дальше идет информация
> про необходимость дождаться окончания резервного копирования. Судя по всему,
> речь идет о команде создания резервной копии блочного устройства? Но к чему
> тогда вывод команды, в которой создается резервная копия домашнего каталога?

Поправка: во втором пункте команда эта
# proxmox-backup-client backup user.pxar:/home/user/ --repository pbs.test.alt:store1
Здесь можно добавить только то, что "готовый результат можно просмотреть в веб-интерфейсе во вкладке Задачи → Показать все задачи".
Comment 3 Repository Robot 2024-11-12 19:10:05 MSK
docs-alt-server-10.4-alt2 -> sisyphus:

 Tue Nov 12 2024 Elena Mishina <lepata@altlinux> 10.4-alt2
 - fix some typos (#51918, #51955)
 - fix PBS (closes: #51979, #51973, #51966, #51965, #51915, #51988, #52022)