.\"
.\" Page de manuel de la commande instance. 
.\"
.TH instance 8 "03 novembre 2009" "Version 1.0" "Commande Creole - EOLE"

.SH NOM
instance \- Outil d'instanciation d'un module EOLE

.SH SYNOPSIS
.B instance
[\fInomDeFichier.eol\fP]

.SH DESCRIPTION
Les modules EOLE sont livrés avec un ensemble de templates.
.br
L'instanciation consiste à remplacer les variables par les valeurs renseignées dans le fichier \fI/root/zephir.eol\fR et
à copier les fichiers vers leur emplacement cible.
.br Vous devez donc d'abord renseigner le fichier zephir.eol à l'aide de la commande \fBgen_config\fP. 

.B Attention !
.br
Cette opération n'est à réaliser qu'une seule fois sur un module après son installation.
.br
Pourquoi n'utiliser instance qu'une seule fois:

    * instance permet de le re-générer ce qui efface tous les comptes utilisateurs et les stations intégrés au domaine.
    * les scripts pre/post instance/reconf sont différents
    * risque de désynchronisation du SID
    * valeurs par défaut non mises à jour
    * reconfigure est automatique, il ne pose pas de question 

.br
Si des modifications sont apportées par la suite par \fBgen_config\fP dans le fichier de configuration il faut utiliser la commande \fBreconfigure\fP et non la commande \fBinstance\fP.

.br
Voici les étapes gérées par la commande \fBinstance\fP:

    * initialise les mots de passe root, scribe et admin
    * génère un nouveau SID
    * génère l'annuaire et les bases MySql si inexistants
    * lance les scripts pre/postinstance
    * programme une mise à jour automatique hebdomadaire
    * copie, patch et renseigne les templates
    * (re)lance les services 

.br
Le compte rendu d'exécution est dans le fichier \fI/var/log/creole.log\fR

.br
Une fois l'instanciation faite le fichier \fInomDeFichier.eol\fP peut être supprimé car c'est le fichier /etc/eole/config.eol qui servira lors des \fBreconfigure\fP.

.SH OPTION
L'argument suivant est supporté:
.TP
\fBnomDeFichier.eol\fP
spécifier le chemin du \fIfichier.eol\fR nécessaire à l'instanciation. Par defaut le fichier utilisé est \fI/root/zephir.eol\fR

.SH "BOGUES"
.PP
Pour signaler un bogue, consultez l'adresse suivante \fIhttp://eole.orion.education.fr/signalement/\fR

.SH "AUTEURS"
.PP
.B Equipe EOLE
.br
\fIhttp://eole.orion.education.fr\fP

.SH "VOIR AUSSI"
.B diagnose
(8),
.B gen_config
(8),
.B reconfigure
(8),
.B creole
(8).
.\" instance.8 1.0