#format text/xml
<!-- Chapitre 20. Les tâches liées aux opérations de plug-in-->
<chapter id="plugin"><title>Les tâches liées aux opérations de plug-in</title>
<para>Ce chapitre traite des tâches liées aux opérations de plug-in et explique comment les réaliser  avec l'interface EVMS, Ncurses et la ligne de commande.</para>

<!--20.1 Qu'est-ce qu'une tâche de plug-in ?-->
<sect1 id="plugintask"><title>Qu'est-ce qu'une tâche de plug-in ?</title>
<para>Les tâches de plug-in sont des fonctionnalités qui ne sont disponibles que dans le contexte d'un plug-in particulier. Ces fonctionnalités ne sont pas communes à tous les plug-ins. Par exemple, ajouter des disques de rechange à un système RAID n'a de sens que dans le contexte du plug-in MD, de même que mettre à jour un instantané de sauvegarde de disque n'a de sens que dans le contexte du plug-in Snapshot.</para>
</sect1>

<!--20.2 Exemple : Réaliser une tâche de plug-in.-->
<sect1 id="explugin"><title>Exemple : Réaliser une tâche de plug-in.</title>
<para>Cette section explique comment réaliser une tâche de plug-in avec les interfaces EVMS, Ncurses et en ligne de commande.</para>

<blockquote>
  <example><title>Ajouter un disque de rechange à un volume de compatibilité à partir d'une région MDRaid5.</title>
    <para>Dans cet exemple, on ajoute le disque sde en tant que disque de rechange au volume /dev/evms/md/md0, qui est un volume de compatibilité créé dans une région MDRaid5.</para>
  </example>
</blockquote>

<!--20.2.1 Utilisation de l'interface d'EVMS-->
<sect2 id="expluginevms"><title>Utilisation de l'interface d'EVMS</title>
<para>Pour ajouter le disque sde au volume /dev/evms/md/md0 avec l'interface d'EVMS :</para>
<orderedlist>
<listitem><para>Sélectionnez Other->Storage Object Tasks...</para></listitem>
<listitem><para>Sélectionnez md/md0.</para></listitem>
<listitem><para>Cliquez sur "Next".</para></listitem>
<listitem><para>Sélectionnez "Add spare object".</para></listitem>
<listitem><para>Cliquez sur "Next".</para></listitem>
<listitem><para>Sélectionnez sde.</para></listitem>
<listitem><para>Cliquez sur "Add".</para></listitem>
<listitem><para>L'opération est réalisée lorsque vous enregistrez.</para></listitem>
</orderedlist>
<para>Vous pouvez aussi utiliser le menu contextuel :</para>
<orderedlist>
<listitem><para>Visualisez la région md/md0. On peut visualiser la région en cliquant sur la petite croix "+" à coté du nom de volume (/dev/evms/md/md0) dans l'onglet des volumes, ou en sélectionnant l'onglet des régions.</para></listitem>
<listitem><para>Faites un clic droit sur la région (md/md0). Une liste d'actions réalisables et de raccourcis de navigation apparaît. Les derniers éléments de la liste sont les tâches réalisables à ce moment précis.</para></listitem>
<listitem><para>Pointez "Add spare object" et cliquez.</para></listitem>
<listitem><para>Sélectionnez sde.</para></listitem>
<listitem><para>Cliquez sur "Add".</para></listitem>
</orderedlist>
</sect2>

<!--20.2.2 Utilisation de Ncurses-->
<sect2 id="expluginncurses"><title>Utilisation de Ncurses</title>
<para>Pour ajouter le disque sde au volume /dev/evms/md/md0 avec Ncurses :</para>
<orderedlist>
<listitem><para>Sélectionnez Other->Storage Object Tasks...</para></listitem>
<listitem><para>Sélectionnez md/md0.</para></listitem>
<listitem><para>Activez "Next".</para></listitem>
<listitem><para>Sélectionnez "Add spare object".</para></listitem>
<listitem><para>Activez "Next".</para></listitem>
<listitem><para>Sélectionnez sde.</para></listitem>
<listitem><para>Activez "Add".</para></listitem>
</orderedlist>
<para>Vous pouvez aussi utiliser le menu contextuel :</para>
<orderedlist>
<listitem><para>A partir de la vue des régions, faites Entrée sur md/md0</para></listitem>
<listitem><para>Activez l'élément du menu "Add spare object"</para></listitem>
<listitem><para>Sélectionnez sde</para></listitem>
<listitem><para>Activez "Add"</para></listitem>
</orderedlist>
</sect2>

<!--20.2.3 Utilisation de la ligne de commande [CLI]-->
<sect2 id="explugincli"><title>Utilisation de la ligne de commande [CLI]</title>
<para>Avec la ligne de commande d'EVMS, toutes les tâches de plug-in doivent être réalisées avec la commande "task".</para>
<para>Voici les étapes à suivre pour ajouter le disque sde au volume /dev/evms/md/md0 à partir de la ligne de commande :</para>
<orderedlist>
<listitem><para>La requête suivante, avec le filtre "list options", détermine les tâches réalisables pour un objet en particulier, et les paires nom-valeur qu'il accepte. Avec cette commande, on obtient une information qui indique quelles tâches plug-in sont réalisables ainsi que les informations dont on aura besoin pour construire la commande.</para>
<para><programlisting>query: objects, object=md/md0, list options</programlisting></para></listitem>

<listitem><para>La commande prend en argument le nom de la tâche (qui a été fourni suite à la requête précédente), l'objet sur lequel opérer (ici, md/md0), toute option nécessaire (ici, aucune) et, le cas échéant, un autre objet devant être manipulé (dans notre exemple, sde, qui est le disque de rechange que nous voulons ajouter) :</para>
<para><programlisting>task: addspare, md/md0, sde</programlisting></para>
<para>La commande est réalisée lors de l'enregistrement.</para></listitem>
</orderedlist>
</sect2>
</sect1>
</chapter>