<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
  <page>
    <title>Personnalisation d'un serveur</title>
    <section>
      <title>Gestion des modifications personnelles</title>
      <para>En dehors du fichier <file>zephir.eol</file>, un certain nombre de fichiers du serveur sont sauvegardés sur zephir, en fonction du module installé sur celui-ci. La liste de ces fichiers apparait sur la page <file>Liste des fichiers personnalisés</file> accessible depuis la page d'état des serveurs de l'application web. Les fichiers sauvegardés sont les suivants :
	<list>
	  <item>Les dictionnaires additionnels installés sur le serveur (fichiers .eol situés dans <file>/etc/eole/dicos</file> (cf. documentation sur les dictionnaires locaux)</item>
	  <item>Les fichiers situés dans /etc/eole/ qui apparaissent dans les liste de fichiers des dictionnaires locaux</item>
	  <item>Des fichiers spécifiques à chaque module (exemple de bastion.xml pour Amon)</item>
	  <item>Des fichiers spécifiques à une variante du module (voir ci-après)</item>
	  <item>Les patchs situés dans <file>/etc/eole/patch</file></item>
	  <item>Des RPMS additionnels (si disponibles sur le serveur de mise à jour)</item>
      </list>
    </para>
    </section>
    <section>
      <title>Création/modification d'une variante</title>
      <para>La notion de variante est une fonctionnalité majeure de Zephir. Une variante est une version modifiée d'un module de base Eole que l'on veut pouvoir utiliser de façon simple sur plusieurs serveurs. Cette notion peut être considérée comme une extension des patchs et de la procédure gen_dico des modules Eole. </para>
      <para>Le processus de création d'une variante est le suivant (sur un serveur)
	<list>
	  <item>Installation d'un serveur avec le module Eole de base</item>
	  <item>Création des modifications sur le serveur par la création de patchs, de dictionnaires locaux, ou l'installation de paquetages supplémentaires. Testez les modifications sur ce serveur avant de créer une variante.</item>
	  <item>Une fois le résultat désiré obtenu, déplacez les patchs dans <file>/etc/eole/patch/variante</file>, et les dictionnaires additionnels dans <file>/etc/eole/dicos/variante</file>. Si vous avez ajouté des rpms ou des fichiers qui ne sont pas référencés dans des dictionnaires locaux, vous pouvez les spécifier dans le fichier <file>/usr/share/eole/zephir/zephir_conf/fichiers_variante</file></item>
	  <note>Si vous souhaitez faire des modifications sur un serveur sans en faire une variante (vous ne pourrez pas réutiliser ces modifications sur d'autres serveurs), suivez la même procédure, mais laissez les patchs dans /etc/eole/patch et les dictionnaires locaux dans /etc/eole/dicos. Vous devez spécifier les fichiers et rpms supplémentaires dans /usr/share/eole/zephir/zephir_conf/fichiers_zephir. Les modifications seront ainsi sauvegardées sur Zephir pour ce serveur.</note>
	  <item>Une fois ces étapes réalisées, lancez la procédure <file>creation_variante</file> située dans <file>/usr/share/eole/zephir</file>. Le mot de passe donné lors de la création de la variante sera demandé pour mettre à jour cette variante.</item>
      </list></para>
      <para>
	  Une fois la procédure terminée, les données de la variante sont stockées sur le serveur zephir, et le serveur est déclaré comme inscrit à cette variante.
	  <note>Pour le vérifier, vous pouvez consulter la page de ce serveur dans l'application web de zephir : le nom de votre variante doit apparaitre. La liste des fichiers ajoutés peut se retrouver depuis le lien <file>voir les fichiers personnalisés</file> de la page <file>Etat actuel</file> du serveur.</note>
	  Vous pouvez mettre à jour une variante après avoir effectué des corrections sur un serveur l'utilisant. Utilisez pour cela la procédure maj_variante (située dans <file>/usr/share/eole/zephir</file>. La mise à jour de variante est déconseillée une fois que plusieurs serveurs utilisent celle-ci.</para>
      <para></para>
    </section>
    <section>
      <title>Modifier une variante depuis l'interface web</title>
      <para>Depuis la page <file>modules</file>, il est possible de modifier certains aspects d'une variante. Cliquez sur le module choisi, puis sur <file>modifier</file> sur la ligne de la variante en modifier. La page suivante apparait :</para>
      <image src="images/variante.eps"/>
      Les modifications possibles sont:
      <list>
	<item>changer libellé de la variante</item>
	<item>renseignement des valeurs par défaut (équivalent de gen_dico via un formulaire)</item>
	<item>ajouter des fichiers à la variante (dictionnaires, templates eole, ...)</item>
      </list>
    <para>Différents types de fichiers peuvent être ajoutés via cette page. Certaines contraintes doivent être respectées suivant le type de fichier :
	<list>
	  <item>Les dictionnaires additionnels (ou locaux) doivent avoir une extension .eol pour être pris en compte. De plus, les fichiers templates référencés dans ces dictionnaires doivent être ajoutés également.</item>
	  <item>Les patchs sont des patchs eole standards</item>
	  <item>Les fichiers divers sont des fichiers quelconque, mais vous devez précisé leur destination sur le serveur dans le champ prévu à cet effet.</item>
      </list>
      Si vous êtes connecté avec l'utilisateur qui a créé la variante vous pouvez ajouter les fichiers sans vous soucier du mot de passe. Celui-ci doit être donné si vous ajoutez des fichiers avec un autre utilisateur .Le mot de passe est défini à la création de la variante (il peut éventuellement être vide si le créateur l'a décidé).
    </para>
	<para>Vous pouvez également supprimer des fichiers en cliquant sur le lien supprimer à côté de chaque fichier. Seule l'utilisateur qui a créé la variante peut supprimer des fichiers. Si vous supprimez un dictionnaire additionnel, vous devrez supprimer vous meme les fichiers templates qui deviennent inutiles (non référencés dans d'autres dictionnaires).</para>
    </section>
	<section>
	  <title>Ajouter des paquets (RPMS) à un serveur</title>
	  <para>Zephir vous permet de spécifier des noms de paquets supplémentaires à installer sur un serveur. Une fois la configuration envoyée au serveur, celui-ci tentera de récupérer les paquets à chaque fois qu'une mise à jour a lieu. Pour que cela fonctionne, il faut que le serveur de mise à jour utilisé possède un répertoire nommé <file>local</file>, et contenant un sous répertoire par module (ex : local/amon-1.5).</para>
	</section>
    <section>
      <title>Réutilisation d'une variante</title>
      <para>Une fois qu'une variante est créée, vous pouvez l'installer sur d'autre serveurs basés sur le module que vous avez modifié. 
	<list>
	  <item>Si vous voulez installer la variante sur un serveur déja inscrit, allez sur la page de ce serveur, cliquez sur modifier, et choisissez la variante dans la liste déroulante. Allez ensuite dans la page des actions du serveur et cliquez sur <file>Envoyer la configuration au serveur</file>. Vous devrez peut-être aller modifier les paramêtres du serveur si de nouvelles variables ont été ajoutées dans les dictionnaires locaux. Dans ce cas, il faudra vous connecter sur le serveur et relancer la procédure d'instance (sinon, vous pouvez simplement cocher la case <file>lancer reconfigure après l'envoi</file>).</item>
	  <item>La façon la plus simple est de choisir cette variante avant d'effectuer la procédure d'enregistrement (lors de la création du serveur dans la base de données).</item>
	</list>
      </para>
    </section>
	<section>
	  <title>Importer une variante depuis un autre zephir</title>
	  <para>Vous pouvez désormais échanger des variantes entre deux zephir. Pour cela, créez une variante dans un module depuis l'application web (modules -> variantes -> ajouter une variante). Dans le menu des variantes, cliquez sur importer à côté de votre nouvelle variante. Dans la page qui apparait, précisez l'adresse du zephir ou se trouve la variante que vous voulez récupérer, le numéro de cette variante sur le zephir indiqué, ainsi que le login et mot de passe d'un utilisateur pouvant exporter des variantes.</para>
	</section>
	<section>
	  <title>Modification uniques sur un serveur</title>
	  <para>Vous pouvez personnaliser un serveur sans passer par une variante si vous ne souhaitez pas reprendre les modifications sur d'autres serveurs. Les fichiers spécifiques au serveur peuvent également être modifiés depuis l'interface web. Pour cela, allez sur la page d'état du serveur en question et cliquez sur <file>voir les fichiers personnalisés</file>. La page qui apparait fonctionne de la meme façon que la page de modification de la variante (sauf qu'il n'y a pas de notion de propriétaire ici). Les fichiers de la variante sont aussi listés mais vous ne pouvez pas y accéder depuis cette page.</para>
	</section>
  </page>
