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

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

    <bug>
          <bug_id>51966</bug_id>
          
          <creation_ts>2024-11-06 17:15:00 +0300</creation_ts>
          <short_desc>Документация docs-alt-server, п.⁠ ⁠ ⁠56.6. Управление удалёнными PBS:  корректировки по команде добавления удалённых PBS</short_desc>
          <delta_ts>2024-11-12 19:10:06 +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>
          
          <qa_contact>qa-sisyphus</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>254032</commentid>
    <comment_count>0</comment_count>
    <who name="Tatyana Gagina">tatyana</who>
    <bug_when>2024-11-06 17:15:00 +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.6. Управление удалёнными PBS → перейти к абзацу: 
 добавить удалённый PBS:
# proxmox-backup-manager remote create pbs2 --host pbs2.test.alt \
--userid root@pam --password &apos;SECRET&apos; --fingerprint 42:5d:ff:3a:50:38:53:5a:9b:f7:50:...:ab:1b

2) выполнить на сервере, указав параметры данного сервера:
# proxmox-backup-manager remote create pbs2 --host pbs2.test.alt \
--userid root@pam --password &apos;SECRET&apos; --fingerprint f6:6e:0a:93:a6...:43:33:b6:85:f1:99:27

Результат: удалённое хранилище не добавлено, в командной строке 
&quot;Error: parameter verification failed - &apos;auth-id&apos;: parameter is missing and it is not optional&quot;

Workround: добавить параметр --auth-id,  который необходим для аутентификации на удалённом сервере PBS.

# proxmox-backup-manager remote create pbs2 --host pbs2.test.alt \
--userid root@pam --password &apos;SECRET&apos; --fingerprint f6:6e:0a:93:a6...:43:33:b6:85:f1:99:27 --auth-id root@pam

Проверить в веб-интерфейсе: Конфигурация → Удалённые хранилища или просмотреть в консоли, выполнив: 
# proxmox-backup-manager remote list
name │  host                    │ auth-id  │ fingerprint                                                                                    
╞══════╪═════════════════════════╪══════════╪════════════════════════════════
│ pbs2 │ pbs2.test.alt │ root@pam │ f6:6e:0a:93:a6...:43:33:b6:85:f1:99:27  │
Хранилище pbs2 добавлено.

Для сравнения, использовалась документация из источников: 
https://sysadminium.ru/pbs-doc/#Upravlenie_udalennymi_PBS
При просмотре документации из веб-интерфейса PBS (https://ip_сервера:8007) в правом верхнем углу &quot;Документация&quot;).
Однако и там команда без опции --auth-id.

Ожидаемый результат: команда в документации указана со всеми необходимыми параметрами (в качестве примера): 
# proxmox-backup-manager remote create pbs2 --host pbs2.test.alt \
--userid root@pam --password &apos;SECRET&apos; --fingerprint 42:5d:ff:3a:50:38:53:5a:9b:f7:50:...:ab:1b --auth-id root@pam</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>254037</commentid>
    <comment_count>1</comment_count>
    <who name="Tatyana Gagina">tatyana</who>
    <bug_when>2024-11-06 18:01:11 +0300</bug_when>
    <thetext>В этой же главе добавить уточнение касаемо команды удаления задачи синхронизации:
# proxmox-backup-manager remote remove pbs2

Результат: Error: parameter verification failed - &apos;name&apos;: remote &apos;pbs2&apos; is used by sync job &apos;test_job&apos; 

Причина: задача test_job всё ещё используется pbs2 и proxmox-backup-manager не может удалить pbs2.

Ожидаемый результат: внести уточнение в документацию, что команда # proxmox-backup-manager remote remove pbs2 может не сразу удалиться, для этого потребуется сначала удалить задачу test_job:
# proxmox-backup-manager sync-job remove test_job
Затем: 
proxmox-backup-manager remote remove pbs2</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>254326</commentid>
    <comment_count>2</comment_count>
    <who name="Repository Robot">repository-robot</who>
    <bug_when>2024-11-12 19:10:06 +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>