<?xml version="1.0" encoding="UTF-8" ?>

<bugzilla version="5.2"
          urlbase="https://bugzilla.altlinux.org/"
          
          maintainer="jenya@basealt.ru"
>

    <bug>
          <bug_id>51973</bug_id>
          
          <creation_ts>2024-11-07 10:43:43 +0300</creation_ts>
          <short_desc>Документация docs-alt-server, п.⁠ ⁠56.7. Клиент резервного копирования: корректировки по описанию работы с клиентом резервного копирования</short_desc>
          <delta_ts>2024-11-12 19:10:05 +0300</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>4</classification_id>
          <classification>Development</classification>
          <product>Sisyphus</product>
          <component>docs-alt-server</component>
          <version>unstable</version>
          <rep_platform>x86_64</rep_platform>
          <op_sys>Linux</op_sys>
          <bug_status>CLOSED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P5</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Tatyana Gagina">tatyana</reporter>
          <assigned_to name="lepata@altlinux.org">lepata</assigned_to>
          <cc>azol</cc>
    
    <cc>boyarsh</cc>
    
    <cc>cas</cc>
    
    <cc>lepata</cc>
    
    <cc>lepata</cc>
          
          <qa_contact>qa-sisyphus</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>254050</commentid>
    <comment_count>0</comment_count>
    <who name="Tatyana Gagina">tatyana</who>
    <bug_when>2024-11-07 10:43:43 +0300</bug_when>
    <thetext>Версия: 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 &quot;root@pam&quot;: ******

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 &quot;root@pam&quot;: ***
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 │


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

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


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

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

Дождаться завершения процесса (может занять до 5 минут), будет висеть информация в терминале:
Previous manifest does not contain an archive called &apos;mydata.img.fidx&apos;, 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

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

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 &apos;/home/user/&apos; to &apos;pbs.test.alt:store1&apos; 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
Убедиться в том, что скачивание идёт можно в веб-интерфейсе: в правом верхнем углу &quot;Задачи&quot; → Длительность → увидим запущенный таймер процесса.
Готовый результат можно просмотреть также в веб-интерфейсе, для этого достаточно перейти в &quot;Задачи&quot; (нажать на кнопку Задачи).

Ожидаемый результат: добавлено примечание по процессу создания резервной копии.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>254150</commentid>
    <comment_count>1</comment_count>
    <who name="Elena Mishina">lepata</who>
    <bug_when>2024-11-08 14:20:45 +0300</bug_when>
    <thetext>Во-втором пункте как-то всё смешалось...
Приведена команда просмотра списка резервных копий, а дальше идет информация про необходимость дождаться окончания резервного копирования. Судя по всему, речь идет о команде создания резервной копии блочного устройства? Но к чему тогда вывод команды, в которой создается резервная копия домашнего каталога?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>254226</commentid>
    <comment_count>2</comment_count>
    <who name="Tatyana Gagina">tatyana</who>
    <bug_when>2024-11-11 11:18:39 +0300</bug_when>
    <thetext>(Ответ для Elena Mishina на комментарий #1)
&gt; Во-втором пункте как-то всё смешалось...
&gt; Приведена команда просмотра списка резервных копий, а дальше идет информация
&gt; про необходимость дождаться окончания резервного копирования. Судя по всему,
&gt; речь идет о команде создания резервной копии блочного устройства? Но к чему
&gt; тогда вывод команды, в которой создается резервная копия домашнего каталога?

Поправка: во втором пункте команда эта
# proxmox-backup-client backup user.pxar:/home/user/ --repository pbs.test.alt:store1
Здесь можно добавить только то, что &quot;готовый результат можно просмотреть в веб-интерфейсе во вкладке Задачи → Показать все задачи&quot;.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>254325</commentid>
    <comment_count>3</comment_count>
    <who name="Repository Robot">repository-robot</who>
    <bug_when>2024-11-12 19:10:05 +0300</bug_when>
    <thetext>docs-alt-server-10.4-alt2 -&gt; sisyphus:

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

    </bug>

</bugzilla>