Bug 51258

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

Description Tatyana Gagina 2024-08-23 12:35:38 MSK

На Sisyphus версия: docs-alt-server-v-10.2-alt4

Шаги: 
1) В документации перейти к пункту 42.4. Скрипты-ловушки (hookscripts) → на подготовленном кластере PVE (на одном из узлов) создать VM 103;
2) Cоздать скрипт в каталоге сниппетов (например, для хранилища local по умолчанию это /var/lib/vz/snippets) и добавить его к ВМ;
3) Выполнить команду, как указано в примере: 
# qm set 103 --hookscript snippet:snippets/guest-hookscript.pl update VM 103: -hookscript snippet:snippets/guest-hookscript.pl

Результат: 400 too many arguments
qm set <vmid> [OPTIONS]

Разъяснение: выполнять команду по частям: 
1) Перед тем, как создать сниппет, необходимо изменить  права  доступа  к  скрипту (сделать файл guest-hookscript.pl исполняемым):
# chmod +x guest-hookscript.pl
Иначе получим результат:
400 Parameter verification failed.
hookscript: script 'snippets:snippets/guest-hookscript.pl' is not executable

2) qm set 103 --hookscript snippets:snippets/guest-hookscript.pl
Успешно (в документации результат не нужно указывать, это для отчётности, что команда выполнена): 
update VM 103: -hookscript snippets:snippets/guest-hookscript.pl
Проверено в веб-интерфейсе, сценарий добавлен.

Для сравнения: в pve-docs https://pve01:8006/pve-docs/pve-admin-guide.html указана команда вида:
# qm set 100 --hookscript local:snippets/hookscript.pl (без блока "update VM 103: -hookscript snippet:snippets/guest-hookscript.pl").


Ожидаемый результат: указана команда в примере в таком виде:

# qm set 103 --hookscript snippets:snippets/guest-hookscript.pl

без блока "update VM 103: -hookscript snippet:snippets/guest-hookscript.pl"
с уточнением, что перед выполнением необходимо проверить права доступа к скрипту guest-hookscript.pl.

Comment 1 Elena Mishina 2024-08-23 12:46:09 MSK

(In reply to Tatyana Gagina from comment #0)
> На Sisyphus версия: docs-alt-server-v-10.2-alt4
> 


> 3) Выполнить команду, как указано в примере: 
> # qm set 103 --hookscript snippet:snippets/guest-hookscript.pl update VM
> 103: -hookscript snippet:snippets/guest-hookscript.pl

Да, тут потерялся перевод строки между командой и её выводом

> 1) Перед тем, как создать сниппет, необходимо изменить  права  доступа  к 
> скрипту (сделать файл guest-hookscript.pl исполняемым):
> # chmod +x guest-hookscript.pl
> Иначе получим результат:
> 400 Parameter verification failed.
В команде с добавлением скрипта написано: где <script_file> — исполняемый файл скрипта.
Поэтому уточнение считаю лишним.

Comment 2 Repository Robot 2024-08-27 16:37:06 MSK

docs-alt-server-v-10.2-alt5 -> sisyphus:

 Tue Aug 27 2024 Elena Mishina <lepata@altlinux> 10.2-alt5
 - fix some typos (ALT 51175, 51218, 51228, 51254, 51258, 51266, 51276, 51279, 51286)
 - small improvements (ALT 51219, 51200, 51213, 51232, 51263, 51291)