<?xml version="1.0" encoding="UTF-8"?>
<page>
<title>Actions sur un serveur</title>
<section>
  <title>Généralités sur les actions</title>
  <para>Zephir vous permet d'agir à distance sur les serveurs. Toutes les actions décrites ci-dessous fonctionnent selon le principe suivant :
	<list>
	  <item>Préparation d'une archive si un envoi de fichier est nécessaire</item>
	  <item>Mise en file d'attente du fichier à envoyer</item>
	  <item>Mise en file d'attente de l'action à exécuter</item>
	  <item>Récupération des fichier, puis exécution des commandes par le serveur lorsque celui-ci se connecte à Zephir</item>
	</list>
	<note>La communication est toujours à l'initiative du serveur (client) qui vient vérifier si il a des actions à effectuer lorsqu'il envoie ses statistiques de surveillance à Zephir. Vous pouvez annuler une action mise en attente tant que le serveur ne l'a pas récupérée, via le lien <file>liste des commandes en attente</file> de la page d'état du serveur.</note>
  </para>
  <image src="images/etat_serveur.eps">
      <legend>Page d'état d'un serveur</legend>
    </image>
  <para>Lorsque les actions ci-dessous sont effectuées, des logs remontent sur zephir et mettent à jour les voyants dans la page d'état du serveur de l'application web (vert : ok, jaune : en cours, rouge : erreur)</para>
  <note>Dans l'état actuel, Zephir ne fait pas de vérification sur l'enchainement des actions que vous demandez, il faut donc veiller à rester cohérent (par exemple, ne pas demander une mise à jour suivi d'une reconfiguration, et un envoi de configuration en meme temps).</note>
</section>
  <section>
	<title>Envoyer <cmd>zephir.eol</cmd> sur Zephir</title>
  <para>Cette action consiste à envoyer à zephir un fichier de configuration pour un serveur. Ce fichier sera envoyé au serveur la prochaine fois que l'action 'Envoyer la configuration au serveur' sera utilisée (cf. paragraphe suivant).</para>
  <para>Dans le cas d'un groupe de serveurs, cette action n'est pas disponible. Elle est remplacée par l'action 'Modifier un paramètre sur le groupe'. Cette action permet de modifier un des paramètres suivants sur  l'ensemble des serveurs d'un groupe:
	  <list>
		  <item>Une variable eole (valeur de zephir.eol) commune à tous les serveurs.</item>
		  <item>le délai de connexion des serveurs</item>
		  <item>la variante des serveurs (seulement si tous les serveurs sont du même type)</item>
	  </list>
  </para>
  </section>
  <section>
  <title>Envoyer la configuration sur le serveur</title>
  <para>Cette action va préparer une archive contenant les fichiers de configuration d'un serveur définis sur zephir et la mettre en attente d'envoi au serveur. Lorsque le serveur se connectera à Zephir, il récupérera l'archive et modifiera sa configuration en fonction des fichiers envoyés (vous pouvez demander au serveur faire un reconfigure automatiquement après réception de l'archive en cliquant la case à cocher correspondante). <note>La configuration envoyée sera celle définie au moment ou vous avez mis l'action en attente. Si vous modifiez la configuration, annulez cette commande et relancez là pour regénérer l'archive à envoyer.</note></para>
  </section>
  <section>
  <title>Sauvegarder l'état actuel du serveur</title>
  <para>Récupère la configuration du serveur en question.</para>
  </section>
  <section>
  <title>Mettre à jour le serveur</title>
  <para>Demande au serveur d'effectuer une mise à jour automatique.</para>
  </section>
  <section>
	<title>Mise à jour de zephir-client</title>
	<para>Cette action permet d'envoyer aux clients la version de zephir-client mise à disposition sur zephir (voir le chapitre 10). Il faut noter que si une mise à jour est effectuée ensuite sur un client, la version présente dans la mise à jour écrasera celle envoyée par zephir.</para>
  </section>
  <section>
	<title>Interdiction de fonctions</title>
	<para>Vous pouvez interdire à un serveur d'exécuter certaines procédures. Les procédures actuellement blocables sont:
	  <list>
		<item>Mise à jour (auto ou cd)</item>
		<item>Reconfiguration</item>
		<item>Instance</item>
	  </list>
	  une procédure bloquée ne peut plus s'exécuter, meme si elle est lancée localement (par exemple, Maj-Auto ou par l'ead sur un amon). Le blocage prend effet immédiatement (sauf si le serveur n'arrive pas à contacter zephir, auquel cas il utilisera les derniers blocages reçus).
	</para>
  </section>
  <section>
	<title>Purge des logs (groupe de serveurs seulement)</title>
	<para>Vous pouvez ici purger les logs de l'application zephir (logs consultables depuis la page d'état du serveur).  Vous pouvez spécifier des paramètres comme le type de logs à purger, et une date limite (tous les logs antérieurs seront purgés).<note>Cela concerne seulement les logs de l'application, les logs locaux des serveurs (syslog, logs quid, ...) ne sont pas concernés. </note></para>
  </section>
  <section>
	<title>Annulation des actions en attente (groupe également)</title>
	<para>Annule toutes les actions en attente pour un groupe de serveurs.</para>
  </section>
</page>
