Bug 51966 - Документация docs-alt-server, п.⁠ ⁠ ⁠56.6. Управление удалёнными PBS: корректировки по команде добавления удалённых PBS
Summary: Документация docs-alt-server, п.⁠ ⁠ ⁠56.6. Управление удалёнными PBS: коррек...
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-06 17:15 MSK by Tatyana Gagina
Modified: 2024-11-12 19:10 MSK (History)
4 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-06 17:15:00 MSK
Версия: 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 'SECRET' --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 'SECRET' --fingerprint f6:6e:0a:93:a6...:43:33:b6:85:f1:99:27

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

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

# proxmox-backup-manager remote create pbs2 --host pbs2.test.alt \
--userid root@pam --password 'SECRET' --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) в правом верхнем углу "Документация").
Однако и там команда без опции --auth-id.

Ожидаемый результат: команда в документации указана со всеми необходимыми параметрами (в качестве примера): 
# proxmox-backup-manager remote create pbs2 --host pbs2.test.alt \
--userid root@pam --password 'SECRET' --fingerprint 42:5d:ff:3a:50:38:53:5a:9b:f7:50:...:ab:1b --auth-id root@pam
Comment 1 Tatyana Gagina 2024-11-06 18:01:11 MSK
В этой же главе добавить уточнение касаемо команды удаления задачи синхронизации:
# proxmox-backup-manager remote remove pbs2

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

Причина: задача 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
Comment 2 Repository Robot 2024-11-12 19:10:06 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)