<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!--
# Copyright (c) 2003, Eole 
# 
# Permission is granted to copy, distribute and/or modify this document
# under the terms of the GNU Free Documentation License, Version 1.1
# or any later version published by the Free Software Foundation;
# with no Invariant Sections, with no Front-Cover Texts, and with
# no Back-Cover Texts.
# A copy of the license is available at :
# http://www.gnu.org/copyleft/fdl.html 
-->
<!DOCTYPE module PUBLIC "-//Logidee//DTD logidee-tools V1.2//EN" "../dtd/module.dtd">
<module xmlns:xi="http://www.w3.org/2001/XInclude">
  <info>
    <title> Documentation Zephir</title>
    <ref></ref>
    <description>
    <para>
      Documentation utilisateur du zéphir      
    </para>
    </description>
    <version number="1.0">
      <author>Bruno Boiget (bruno.boiget@ac-dijon.fr)</author>
      <author>Fri May 21 2004</author>
      <comment></comment>
    </version>
    <state finished="false" proofread="false"/>
    <proofreaders>
      <item></item>
    </proofreaders>
  </info>
  <page>
    <title>Notes pour l'utilisation de Zephir Beta 1.0</title>
    <section>
      <title>Installation</title>
      <note>Important : cette version de zephir est une version beta (ainsi que l'image d'amon avec les fonctions Zephir) et vous risquez de rencontrez des problèmes divers (toutes les fonctionnalités prévues ne sont pas encore implémentées). Il est évidemment fortement déconseillé d'utiliser ces version beta en production. Nous attendons avec intérêt vos retour d'expérience et vos remarques concernant les différents aspects de zephir (ergonomie, fonctionnalités, et évidemment bugs :-). Notez qu'une liste zephir existe depuis quelques temps (accessible depuis le site de diffusion, rubrique <file>liste de diffusion).</file></note>
      <para>Le module Zephir s'installe de la même façon que tous les autres modules Eole</para>
      <list>
	<item>Telechargez l'iso du cd sur le site de test et gravez là</item>
	<item>Bootez le serveur depuis le lecteur cdrom et tapez Entree à l'invite</item>
      </list>
      <note>Attention, toutes les données du disque dur seront perdues</note>
    </section>
    <section>
      <title>Configuration</title>
      <para>Toujours selon la philosophie Eole, vous devez renseigner la configuration du serveur via la procédure gen_dico, puis effectuer une instanciation du serveur :<code>cd /root</code><code>./gen_dico</code><code>./instance_zephir zephir.eol</code></para>
      <para>Quelques points spécifiques sur les paramètres à renseigner :</para>
      <list>
	<item> Activer l'application web zephir sur cette machine : L'application web de gestion de l'annuaire zephir peut être installée sur une machine différente de la base zephir (en cas de charge trop importante). Pour l'instant l'installation à part de cette application n'est pas implémentée, et il faut donc répondre oui à cette question.</item>
	<item> Adresse ip du serveur LDAP pour authentification : correspond à l'annuaire qui permettra d'authentifier les utilisateur. Pour la version beta, il est recommandé de laisser l'annuaire en local (valeur par défaut).</item> 
      </list>
      <note>Il est possible d'utiliser un annuaire existant, la seule condition pour que tout fonctionne est qu'il doit exister un utilisateur admin_zephir dans l'annuaire et vous devez connaitre son mot de passe. Actuellement, les utilisateurs doivent être dans une branche dont la base est "o=gouv, c=fr". cela sera modifiable dans les versions futures.</note>
      <para>Lors de l'instance, repondez oui à la question "initialisation des données et utilisateurs de base ?" (sauf si vous avez déjà effectué une instance auparavant). Choisissez un mot de passe pour l'utilisateur admin_zephir, puis créez autant d'utilisateurs que vous le souhaitez (pour l'instant ils n'ont aucun droit dans l'application).</para>
    </section>
    <section>
      <title>Utilisation</title>
      <para>La première chose à faire est de donner des droits aux utilisateurs que vous souhaitez utiliser. Connectez vous à l'application web depuis un navigateur <url href="https://adresse_zephir:8070"/>.</para>
      <para>La première fois, connectez vous comme admin_zephir (avec le mot de passe donné lors de l'instance). Cliquez sur le lien <file>utilisateurs</file>, et entrez le login d'un des utilisateurs que vous avez créés. vous pouvez alors leur affecter des droits sur l'application zephir (consultation, modification, execution, gestion des permissions). Déconnectez vous ensuite (lien <file>déconnexion</file>), et reconnectez vous avec l'utilisateur désiré.</para>
      <para>L'étape suivante est de créer un ou plusieurs établissements dans la base de données de zephir. (<file>ajout d'un établissement</file> depuis le menu <file>établissement</file></para>
      <para>Vous pouvez maintenant créer des serveurs pour ces établissement, soit depuis l'application web (<file>ajouter un serveur</file> sur la page de l'établissement), soit depuis le serveur lui-même (pour l'instant, seule l'image d'Amon disponible sur le serveur de test intègre ces fonctionnalités) à travers la procédure d'enregistrement</para>.
      <note>Pour plus de détails sur l'utilisation de zephir pour gérer amon, se reporter à la documentation <file>Zephir Pas à Pas</file> disponible sur le site de diffusion</note>
    </section>
  </page>

</module>
