Installation et mise en œuvre du module AmonEcole

EoleDB est pré-installé sur les modules où des applications web le requièrent.

Sur les autres modules l'installation d'EoleDB se fait manuellement sur le serveur qui héberge l'application web avec la commande apt-eole :

# apt-eole install eole-db

Par défaut le serveur de base de données est paramétré comme étant local. Dans le cas où le serveur est distant quelques variables sont à renseigner.

• Adresse du serveur de base de données : adresse IP, nom de machine ou nom de domaine du serveur de base de données distant. Cette valeur est utilisée pour toutes les applications web qui ne définiront pas elles-mêmes un serveur de base de données.

• Port du serveur de base de données : port du serveur de base de données utilisé, par exemple 3306 pour le serveur MySQL fourni par EOLE.

• Nom d'utilisateur d'administration : identifiant du gestionnaire de la base de données distante.

• Fichier de mot de passe : chemin d'accès vers le fichier qui contient le mot de passe du gestionnaire, par exemple /root/bdpass.txt. Ce fichier doit être accessible par EoleDB, idéalement le fichier doit avoir les droits 600.

• Machines qui peuvent utiliser le serveur de BDD : permet d'autoriser des machines à accéder à l'administration des bases distantes #fixme, si rien n'est renseigné l'adresse IP du serveur utilisant EoleDB est ajoutée automatiquement dans le fichier de configuration.

EoleDB dispose d'un fichier de configuration principale, /etc/eole/eole-db.conf, géré par Creole.

Ce fichier est au format YAML^[3], il défini le comportement par défaut d'EoleDB si aucune configuration spécifique n'est définie par l'application web.

Les application web disponible sur EOLE fournissent un fichier de configuration au format YAML^[3] qui surcharge le fichier de configuration principal d'EoleDB.

Ces fichiers de configuration spécifiques aux applications redéfinissent le comportement par défaut d'EoleDB, ils sont stockés dans /etc/eole/eole-db.d/.

Pour des raisons pratiques, EoleDB réalise également le changement de mots de passe dans les fichiers de configuration des applications, les mots de passes sont changées à chaque lancement de la commande eole_db_gen.

Dans le cas de EOLE cette commande est lancée au minimum à chaque reconfigure.

Pour utiliser EoleDB il faut donc mettre en place les fichiers de configuration et utiliser la commande eole_db_gen.

Sans paramètre, la commande eole_db_gen utilise les paramètres par défaut.

Pour utiliser une autre configuration des options sont disponibles :

• -h, --help: Affiche le message d'aide à l'utilisation de la commande ;

• -c, --config : Définir un fichier de configuration a utiliser à la place de /etc/eole/eole-db.conf ;

• -d, --dbdir : Définir un répertoire qui contiens les fichiers de configuration des applications qui n'est pas /etc/eole/eole-db.d/ ;

• -b, --backup-dir : Définir un répertoire pour copier les sauvegardes des fichiers modifiés par EoleDB.