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

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

    <bug>
          <bug_id>51258</bug_id>
          
          <creation_ts>2024-08-23 12:35:38 +0300</creation_ts>
          <short_desc>Документация docs-alt-server-v, п. ⁠42.4. Скрипты-ловушки (hookscripts): не отрабатывает команда из примера целиком для добавления скрипта-ловушки, поправки</short_desc>
          <delta_ts>2024-08-27 16:37: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-v</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>250487</commentid>
    <comment_count>0</comment_count>
    <who name="Tatyana Gagina">tatyana</who>
    <bug_when>2024-08-23 12:35:38 +0300</bug_when>
    <thetext>На 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 &lt;vmid&gt; [OPTIONS]

Разъяснение: выполнять команду по частям: 
1) Перед тем, как создать сниппет, необходимо изменить  права  доступа  к  скрипту (сделать файл guest-hookscript.pl исполняемым):
# chmod +x guest-hookscript.pl
Иначе получим результат:
400 Parameter verification failed.
hookscript: script &apos;snippets:snippets/guest-hookscript.pl&apos; 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 (без блока &quot;update VM 103: -hookscript snippet:snippets/guest-hookscript.pl&quot;).


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

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

без блока &quot;update VM 103: -hookscript snippet:snippets/guest-hookscript.pl&quot;
с уточнением, что перед выполнением необходимо проверить права доступа к скрипту guest-hookscript.pl.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>250488</commentid>
    <comment_count>1</comment_count>
    <who name="Elena Mishina">lepata</who>
    <bug_when>2024-08-23 12:46:09 +0300</bug_when>
    <thetext>(In reply to Tatyana Gagina from comment #0)
&gt; На Sisyphus версия: docs-alt-server-v-10.2-alt4
&gt; 


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

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

&gt; 1) Перед тем, как создать сниппет, необходимо изменить  права  доступа  к 
&gt; скрипту (сделать файл guest-hookscript.pl исполняемым):
&gt; # chmod +x guest-hookscript.pl
&gt; Иначе получим результат:
&gt; 400 Parameter verification failed.
В команде с добавлением скрипта написано: где &lt;script_file&gt; — исполняемый файл скрипта.
Поэтому уточнение считаю лишним.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>250663</commentid>
    <comment_count>2</comment_count>
    <who name="Repository Robot">repository-robot</who>
    <bug_when>2024-08-27 16:37:06 +0300</bug_when>
    <thetext>docs-alt-server-v-10.2-alt5 -&gt; sisyphus:

 Tue Aug 27 2024 Elena Mishina &lt;lepata@altlinux&gt; 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)</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>