Bug 51966

Summary:	Документация docs-alt-server, п.⁠ ⁠ ⁠56.6. Управление удалёнными PBS: корректировки по команде добавления удалённых PBS
Product:	Sisyphus	Reporter:	Tatyana Gagina <tatyana>
Component:	docs-alt-server	Assignee:	lepata <lepata>
Status:	CLOSED FIXED	QA Contact:	qa-sisyphus
Severity:	normal
Priority:	P5	CC:	azol, boyarsh, cas, lepata
Version:	unstable
Hardware:	x86_64
OS:	Linux

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)