Important

En cas de livraison d'une nouvelle version de l'application Prenez le temps de lire ces instructions AVANT de commencer à faire quoi que ce soit.

DREmgr

DREmgr est un environnement pour la gestion d'une ou plusieurs instances de base de données DRE

DRE est un acronyme de Données Répliquées en Etablissement, et permet d'avoir accès à un export journalier des bases de données d'une instance PEGASE

Par défaut, la base de données DRE est recréée à zéro tous les jours, à chaque import. Une base de données persistante est aussi disponible, dans laquelle peuvent être conservées des données annexes. A chaque fois qu'elle est recréée, un mécanisme importe toutes les tables de la base de données persistante dans la base de données DRE, afin d'offrir une vue consolidée aux données.

Tip

Obtenir de l'aide Envoyez un message sur le forum PC-SCOL en mentionnant @jclain

Vous avez fait l'installation, mais vous avez une interrogation? Un doute? Consultez la foire aux questions

Faire l'installation initiale

DREmgr est développé et testé sur Debian 12. Il devrait fonctionner sur n'importe quel système Linux, pourvu que les pré-requis soient respectés.

La configuration par défaut est optimisée pour une machine avec 4Go de RAM, 2 coeurs et un disque SSD. Il ne faut cependant pas prendre ces chiffres commes des directives absolues. Prévoyez suffisamment de disque pour la base de données et les fichiers de dumps (par défaut, les fichiers des 15 derniers jours sont conservés) --> en fonction de la taille de vos données, de 50 à 100 Go devraient suffire pour une machine de production.

Les commandes listées ci-dessous sont pour un démarrage rapide si vous savez ce que vous faites. Si c'est la première fois, il est conseillée de cliquer sur les liens pour avoir des détails sur la procédure.

• Installez d'abord les pré-requis

  • Installation des pré-requis pour linux (Debian ou autres distributions Linux). Ce mode d'installation est celui à sélectionner pour la production, mais peut aussi être utilisé pour les tests ou le développement, notamment si le poste de l'utilisateur est sous Linux.

    sudo apt update && sudo apt install git curl rsync tar unzip python3 gawk

    curl -fsSL https://get.docker.com | sudo sh

    [ -n "$(getent group docker)" ] || sudo groupadd docker
    sudo usermod -aG docker $USER

    [!IMPORTANT] Configuration du proxy Si vous utilisez un proxy, veuillez consulter la page pré-requis pour linux pour des instructions sur la façon de le configurer

  • Installation des pré-requis pour WSL, le sous-système Linux pour Windows. Ce mode d'installation est approprié pour les tests ou le développement.

• Puis ouvrez un terminal et clonez le dépôt

  git clone https://github.com/PC-Scol/dremgr.git

  cd dremgr

• Ensuite, Il faut construire les images docker nécessaires. Construire les images

  ./build

  nano build.env

  ./build

• Enfin, vous devez choisir le mode de fonctionnement: le mode simple n'installe qu'une seule instance de la base de données ainsi que du mécanisme pour la mettre à jour quotidiennement. Ce mode n'offre aucune interface utilisateur. Installer DREmgr dans le mode simple

  ./dremgr

  nano dremgr.env

  ./dremgr

• Le mode avancé permet d'installer autant d'instances que nécessaire sur une même machine. Elle offre aussi une interface utilisateur, mais elle demande (un peu) plus de travail. Installer DREmgr dans le mode avancé

Tip

Vous avez fait l'installation, mais vous avez une interrogation? Un doute? Consultez la foire aux questions

Installer une mise à jour

Veuillez suivre ces instructions AVANT de commencer à faire quoi que ce soit.

Exploitation

• Chaque script build, dremgr, dbinst, dbfront et webfront possède une aide intégrée affichée avec l'option --help Afficher l'aide complète des scripts
• Liste des paramètres des fichiers d'environnement
• Pour tester des fonctionnalités qui ne sont pas encore stabilisées, il est possible de basculer une installation en mode "développement". ATTENTION! Cette opération ne devrait pas être effectuée en production. Installer une version de développement
• Les addons permettent de rajouter des fonctionnalités à DRE.
  • Installation d'addons
  • Développement d'addons

-- coding: utf-8 mode: markdown -- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8:noeol:binary