Structure de répertoires du serveur LIPE

------------------------- début LIPE-RFC-0-3-c-----------------------
LIPE-RFC-N°   : 0-3
Status        : Provisoire rev. c
Date          : 18-10-99
Auteurs       : Bernard Frit  
                Alain Couchot
                Michel Verdier  
                Pierre-Louis Malatray 	
Reference     :
Sujet         : Configuration de la structure de répertoires du serveur LIPE
Mots Clés     : RFC, LIPE, LIPE-RFC, spécifications, architecture,
                implémentation, répertoires, système de fichier
Destinataires : Tous
Contenu       :

	Configuration d'un Système de Fichiers pour LIPE
        ------------------------------------------------

Cette configuration est détaillée dans un fichier de configuration
lipe.conf recherché par défaut dans /etc. Ce fichier de configuration
contient les indications permettant au serveur lipe de se
configurer lors de son démarrage. Il pourra être prévu un paramètre
de démarrage du serveur permettant de spécifier un fichier de
configuration autre que /etc/lipe.conf.

Syntaxe de lipe.conf
--------------------
La syntaxe retenue est une syntaxe unix classique pour les fichiers
de configuration. Elle est de la forme :
=
Le fichier de configuration est subdivisé en sections identifiées
par un mot clé de la forme :
[nom_section]
Les lignes commençant par # ; ainsi que les lignes vides sont ignorées. 
Tout ce qui à droite d'un # ou d'un ; est ignoré et considéré comme un
commentaire.
exemple :
#-------------------------------------
# 		fichier lipe.conf
#-------------------------------------
#	dernière maj le 10 oct 1999
#	par root
#-------------------------------------
[directories]
BINDIR=/usr/bin	           ; emplacement des binaires
..
.
#-------- fin  config

Les différentes options
-----------------------
Bien que des options très différentes puissent être choisies en fonc-
tion de la distribution de Linux utilisée ainsi que selon les goûts
de l'administrateur réseau, nous présentons ici deux options très
distinctes.

* option 1 : utilisation d'un système de fichier indépendant
La structure du systeme de fichiers du serveur LIPE sera montée sur
/usr/local/lipe ce qui permet de réserver une partition complète
si nécessaire au système de fichier LIPE. Cette option est recommandée
dans la phase de développement.

* option 2 : utilisation du système de fichier linux standard
Les fichiers de lipe seront inclus dans les différents répertoires
Linux standards tels que /bin /etc /lib...

Les variables de répertoires 
-----------------------------
BINDIR : contient le nom du répertoire accueillant 
         les binaires du serveur lipe.
* option 1 :
BINDIR=/usr/local/lipe/bin
* option 2 :
BINDIR=/usr/bin

CLIDIR : contient le nom du répertoire accueillant 
         les binaires distribuables des clients lipe.
* option 1 :
CLIDIR=/usr/local/lipe/var/distrib
* option 2 :
CLIDIR=/var/lipe/distrib


DOCDIR : contient le nom du répertoire accueillant 
         la documentation serveur et client.
* option 1 :
DOCDIR=/usr/local/lipe/doc
* option 2 :
DOCDIR=/usr/doc/lipe

CFGDIR : contient le nom du répertoire accueillant 
         les fichiers de configuration serveur.
* option 1 :
CFGDIR=/usr/local/lipe/etc
* option 2 :
CFGDIR=/etc/lipe

LIBDIR : contient le nom du répertoire accueillant 
         les modules serveurs.
* option 1 :
LIBDIR=/usr/local/lipe/lib
* option 2 :
LIBDIR=/usr/lib/lipe

MSGDIR : contient le nom du répertoire accueillant 
         les messages du serveur.
* option 1 :
MSGDIR=/usr/local/lipe/msg
* option 2 :
MSGDIR=/etc/lipe


TMPDIR : contient le nom du répertoire accueillant 
         les fichiers temporaires (ex: impressions).
* option 1 :
TMPDIR=/usr/local/lipe/tmp
* option 2 :
TMPDIR=/var/tmp

VARDIR : contient le nom du répertoire accueillant 
         les fichiers du journal.
* option 1 :
VARDIR=/usr/local/lipe/var
* option 2 :
VARDIR=/var/lipe

Détail de chaque répertoire :
-----------------------------
* BINDIR
	
Il contient les fichiers suivants :
- noyau exécutable du serveur lipe
- exécutable effectuant l'écriture du journal
- autres exécutables tels que copie du journal pour
  sauvegarde ou moteurs de recherche ou etc..

* CLIDIR

Il contient tous les exécutables clients dans leur dernière 
version compatible avec la version de serveur afin
de pouvoir effectuer une mise à jour dynamique des postes clients et
de pouvoir autodéployer les postes clients.

* DOCDIR

Il contient les sous-répertoires suivants :

./fr/html : contient les fichiers d'aide et la documentation
            en html
./fr/ps   : contient les fichiers d'aide et la documentation
            en postcript
./fr/pdf  : contient les fichiers d'aide et la documentation
            en "portable document format" consultable par 
            Adobe Acrobat Reader.
Note :  ./fr représente ici le français. Il est bien entendu
------  que dans le cas d'une traduction en anglais de la doc
        il y aura un répertoire ./en, etc...

Dans le cas de l'introduction d'autres formats pour la documentation
chaque format devra disposer de son propre répertoire ex :
./fr/dvi, ./en/txt, etc...

* CFGDIR

Il peut contenir les fichiers de configuration suivants :
- la liste et les numéro de version des modules
   client et serveur
- la liste des utilisateurs de lipe.
- la liste des machines autorisées à accéder au serveur lipe.
- la liste des services (compta, gestion etc..) pour
   chaque entreprise (ou dossier)

* LIBDIR

Il pourra contenir les répertoires suivants :
./srv  : qui contient les modules serveurs
./cpt  : qui contient les modules compta
./ges  : qui contient les modules gestion 
./rh   : qui contient les modules rh
./off  : qui contient les modules office
./doc  : qui contient les modules d'aide

Ces sous-répertoires devront impérativement être décrits
dans la base registre des modules présents.

* MSGDIR

Il contient autant de sous-répertoire que de langues
disponibles sur le serveur.

* TMPDIR

Il contient tous les fichiers temporaires nécessaires au bon
fonctionnement de LIPE.

* VARDIR

Il contient autant de répertoires qu'il y a d'entreprise utilisatrice
et chaque nom de répertoire correspondant au nom de l'entreprise.

Chaque répertoir entreprise est subdivisé en sous-répertoires de la
manière suivante :

./mycompany/lock  : contient les fichiers de réservation
                    de ressources dont le nom est préfixé
		    par .
		    ex : pour la société worldcompany nous
                    aurons : 

$VARDIR/worldco/lock/worldco-xxx-666-666.lock

La fonctionalité d'avoir un lock par entreprise étant optionelle
elle sera décrite dans le fichier de configuration de l'entreprise.
		    	 	
./mycompany/log   : contient les fichiers logs des actions
                    accomplies sur chaque entreprise et dont 
		    le nom est préfixé par .
		    ex : pour la société worldcompany nous
                    aurons : 

$VARDIR/worldco/log/worldco-2000-01-01.log

La fonctionalité d'avoir un log par entreprise étant optionelle
elle sera décrite dans le fichier de configuration de l'entreprise.

./mycompany/event : contient les fichiers constituant le
                    journal des évènements de l'entreprise. 
./mycompany/index : contient les fichiers index des moteurs 
                    de recherche utilisés pour accéder au journal.


Exemples de fichier lipe.conf
----------------------------

* Option 1:

#-------------------------------------
# 		fichier lipe.conf
#-------------------------------------
#	Configuration de tests et développement
#	dernière maj le 25 oct 1999
#	par root
#-------------------------------------

[directories]
BINDIR=/usr/local/lipe/bin
CLIDIR=/usr/local/lipe/var/distrib
DOCDIR=/usr/local/lipe/doc
CFGDIR=/usr/local/lipe/etc
LIBDIR=/usr/local/lipe/lib
MSGDIR=/usr/local/lipe/msg
TMPDIR=/usr/local/lipe/tmp
VARDIR=/usr/local/lipe/var

#------------------ fin provisoire fichier lipe.conf

* option 2 :

#-------------------------------------
# 		fichier lipe.conf
#-------------------------------------
#	Configuration d'exploitation
#	dernière maj le 25 oct 1999
#	par root
#-------------------------------------

[directories]
BINDIR=/usr/bin	           ; emplacement des binaires
CLIDIR=/var/lipe/distrib
DOCDIR=/usr/doc/lipe
CFGDIR=/etc/lipe
LIBDIR=/usr/lib/lipe
MSGDIR=/etc/lipe
TMPDIR=/var/tmp
VARDIR=/var/lipe

#------------------ fin provisoire fichier lipe.conf
                                     
------------------------- fin LIPE-RFC-0-3-c----------------