<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
  <page>
    <title>Procédure d'enregistrement</title>
    <para>Cette procédure est requise pour tout serveur que vous voulez administrer via zephir.
      Elle permet de créer les données nécessaires dans la base de données zephir et configure
      une transmission sécurisée entre zephir et le serveur. Cette tâche est obligatoire et doit
    être effectuée manuellement sur le module (amon, horus, scribe, ...).</para>
    <section>
      <title>Enregistrement d'un serveur existant</title>
      <para>Toute la procédure peut être effectuée sur le serveur amon (on considère dans cet exemple que
	le serveur n'a pas été créé auparavant via l'application web. Pour cela, voir l'exemple suivant).</para>
      <para>Sur le serveur Amon
	<list>
	  <item>Aller dans le répertoire /usr/share/eole/zephir</item><code>
	    cd /usr/share/eole/zephir</code>
	  <item>Lancer la procédure enregistrement_zephir<code>
	      ./enregistrement_zephir</code></item>
	    <list>
	      <item>Entrez l'adresse du serveur Zephir, ainsi qu'un nom d'utilisateur (et un mot de passe) autorisé en écriture dans l'application zephir</item>
	      <item>Repondez oui (ou o) à la question 'Créer le serveur dans la base zephir ?'</item>
	      <item>Saisissez ensuite les informations demandées (vous devez entrer un n° RNE existant dans l'application zephir)</item>
	      <item>Choisissez un n° parmi les modules proposés</item>
	      <item>Même chose pour les variantes (voir l'explication dans le paragraphe 'personnalisation des serveurs')<note>A la fin de cette étape, un numéro vous sera indiqué (id du serveur). Ce numéro vous permettra d'accéder directement aux informations de ce serveur dans l'application web zephir.</note></item>
		  <item>La procédure vous propose alors différents choix, choisissez <file>sauvegarder la configuration actuelle sur Zephir</file> si vous voulez conserver la configuration actuelle. Vous pouvez aussi seulement demander de <file>récupérer les fichiers de variante sur zephir</file> , comme par exemple les dictionnaires additionels d'une variante (cette étape est réalisée dans les 2 cas).</item>
		  <item>Un message vous indiquera que la configuration est bien sauvegardée et que les communications avec zephir sont configurées. Dans le cas où des paramètres du serveur ne seraient pas renseignés (paramètres provenant d'une variante), un message vous préviendra que ceux-ci doivent être saisis.</item>
	</list></list></para>
	<para><note>Vous pouvez vérifier que la procédure s'est bien passée depuis l'application web de zephir, allez dans la page <em>serveurs</em>, puis <em>recherche d'un serveur particulier</em> et entrez l'id du serveur (n° donné après la saisie du n° de variante). Les boutons <em>zephir.eol</em> et <em>enregistrement</em> zephir doit être vert, et vous pouvez vérifier la configuration du serveur en cliquant sur <em>modifier</em>.Vous pouvez également cliquer sur <em>description du serveur</em> et vérifier que les données correspondent à ce que vous avez saisi.</note>
    </para>
    </section>
    <section>
      <title>Enregistrement et configuration depuis zephir</title>
      <para>Sur le client web :
      <list>
	  <item>Créer un serveur dans l'établissement choisi</item>
	  <item>Noter le numéro du serveur créé</item>
	  <item>Aller sur la page 'etat du serveur'</item>
	  <item>Cliquer sur le lien 'génerer' à coté de zephir.eol</item>
	  <item>Saisir la configuration du serveur dans le formulaire suivant (équivalent de gen_config)</item>
      </list>
    </para>
    <para>Sur Amon (serveur non configuré):
      <list>
	<item>Aller dans le répertoire /usr/share/eole/zephir</item>
	<item>Exécuter la procédure enregistrement_zephir:</item>
	<list>
	  <item>Répondez oui (ou o) à la question 'établir une configuration réseau minimale ?' et entrez les informations demandées concernant la configuration réseau.</item>
	  <item>Donnez l'adresse du serveur Zephir, puis un nom d'utilisateur ayant les droits en écriture sur zephir</item>
	  <item>Répondez non à la question 'créer le serveur dans la base zephir ?'</item>
	  <item>Entrez le numéro du serveur (noté lors de la création dans l'interface web)</item>
	  <item>Si un enregistrement a déjà été effectué pour ce numéro de serveur, un avertissement apparaitra pour indiquer que la clé existe déjà (répondez oui pour écraser l'ancienne clé)</item>
	  <item>Choisissez l'option <file>Utiliser la configuration définie sur Zephir</file> et attendez que la procédure se termine.</item>
	  <item>Lancez la procédure d'instance  avec le nouveau fichier zephir.eol :<code>
	      cd /root
	      ./instance-amon zephir.eol
	    </code>
	  </item>
	</list>
    </list>
    <note>Dans les paramètres du serveur, la variable indiquant le délai maximum a maintenant un role différent (dans un but de clarté). Elle correspond au délai entre chaque connexion du serveur sur zephir. Les serveurs récupèrent la valeur de ce délai sur zephir, ce qui permet désormais de modifier ce délai depuis zephir (il n'est plus dans /etc/crontab).  </note>
  </para>
    </section>
    <section>
      <title>Enregistrement et configuration depuis amon</title>
      <para>La seule différence avec l'enregistrement d'un serveur existant est qu'au lieu de sauvegarder la configuration actuelle du serveur sur zephir, vous devrez la saisir depuis le serveur (via la procédure gen_config habituelle, modifiée pour zephir).</para>
      <para>
	<list>
	  <item>Allez dans le répertoire /usr/share/eole/zephir</item>
	  <item>Lancez la procédure enregistrement_zephir</item>
	  <list>
	    <item>Répondez oui (ou o) à la question 'établir une configuration réseau minimale ?' et entrez les informations demandées concernant la configuration réseau.</item>
	    <item>Entrez l'adresse du serveur zephir, ainsi qu'un nom d'utilisateur (et un mot de passe) autorisé en écriture dans l'application zephir</item>
	    <item>Repondez oui (ou o) à la question 'Créer le serveur dans la base zephir ?'</item>
	    <item>saisissez ensuite les informations demandées (vous devez entrer un n° RNE existant dans l'application zephir)</item>
	    <item>Choisissez un n° parmi les modules proposés</item>
	    <item>Même chose pour les variantes (voir l'explication dans le paragraphe 'personnalisation des serveurs')</item>
		<item>Un menu vous proposera soit de récupérer les donnnées de variante, soit de sortir sans rien faire. (cela peut raccourcir la procédure si vous relancez l'enregistrement et que le serveur a déjà récupéré toutes les données lors d'un enregistrement précédent).</item>
	  </list>
	  <item>Une fois la procédure terminée, allez dans le répertoire '/root' et lancez la procédure gen_config_zephir :<code>
	      cd /root/
	      ./gen_config</code>
	    <list>
	      <item>Donnez un nom d'utilisateur et un mot de passe autorisés à configurer un serveur.</item>
	      <item>Répondez aux questions posées comme d'habitude (cf. documentation du module en question)
		<note>vous pouvez revenir en arrière lors de la saisie en utilisant la combinaison de touches <em>ctrl-c</em> (<em>ctrl-d</em> pour sortir). Notez que le numéro de RNE donné n'est actuellement pas vérifié par rapport à celui spécifié à zephir pour ce serveur</note>
	      </item>
	      <item>A la fin de la saisie, la configuration sera sauvegardée simultanément en local et sur le serveur zephir.</item>
	      <item>Effectuez une instance du serveur : <code>
		      cd root
		      ./instance-amon zephir.eol</code></item>
	    </list>
	  </item>
      </list>
    </para>
    </section>
  </page>
