diff --git a/README.md b/README.md index ebc1443b..cf3b50ee 100644 --- a/README.md +++ b/README.md @@ -35,6 +35,10 @@ d'autres pas: merci de signaler les erreurs. ## Installation (sur Debian 11 / python 3.9.2) + +Voir https://scodoc.org/GuideInstallDebian11 + +## Notes à reporter dans la doc: On peut installer à partir de zéro, ou sur une machine ayant déjà un ScoDoc 7 et migrer les données. @@ -60,70 +64,7 @@ et migrer les données. Les données pourront être migrées après installation la nouvelle version, voir plus loin. **XXX TODO: script de migration "en place"** (actuellement, seule la migration depuis une _autre_ machine scodoc7 est prévue.) -### Installer ScoDoc -Sur un système Linux Debian 11, en tant que `root`: -Si vous êtes développeur/testeur, partir du code _git_, avec `git clone https://scodoc.org/git/viennet/ScoDoc.git, le -renommer en `/opt/scodoc`et aller directement à l'étape 3. - - 1. Charger la dernière release depuis https://scodoc.org/git/viennet/ScoDoc/releases - - 2. Déplacer ou copier le fichier `scodoc-x.y.z.tgz` dans `/opt` et le décomprimer: - - sudo su - cd /opt; tar xf - ScoDoc-x.y.z.tgz # remplacer x.y.z par votre version - mv nom_du_rep_créé /opt/scodoc - - - 3. Lancer le script d'installation: - - cd /opt/scodoc/ - ./tools/install_debian11.sh - -ce script crée un compte utilisateur "scodoc" s'il n'existe pas déjà. - -Note: si vous installez sur une machine déjà configurée pour ScoDoc 7, il -est inutile de reconfigurer la messagerie et le firewall. - -### Bases de données -ScoDoc 9 utilise une nouvelle base de données unique, regroupant tous les -départements et les utilisateurs. Elle est nommée `SCODOC` (et `SCODOC_DEV` -en mode développement, ou `SCODOC_TEST`pour les tests unitaires). -Cette base est créée via `sqlalchemy` (l'ORM habituel de Flask). - -Pour créer la base de données, lancer le script: - - su scodoc # au besoin (pas root !) - cd /opt/scodoc - ./tools/create_database.sh SCODOC - ./tools/create_database.sh SCODOC_DEV # pour la base "developement" - ./tools/create_database.sh SCODOC_TEST # pour les tests unitaires - -Les bases créées appartiennent à l'utilisateur (rôle) postgres `scodoc` -(qui a été créé par le script d'installation précédent). - -### Variables d'environnement -Le serveur utilise des variables d'environnement donnant la configuration de base. -Le plus simple est de les grouper dans un fichier `.env` (dans `/opt/scodoc/.env`) -qui est lu automatiquement au démarrage: - - # .env for ScoDoc _development_ - - FLASK_APP=scodoc.py - FLASK_ENV=development # ou production - - MAIL_SERVER=votre.serveur.de.mail.net # ou vide si pas de mail - MAIL_PORT=25 - - SCODOC_ADMIN_MAIL="adresse.admin@toto.fr" # important: le mail de admin - SECRET_KEY="CGGAJAKlh6789JJK?KNAb=" # une chaine aléatoire - -Le fichier `/opt/scodoc/.env-exemple`est donné à titre... d'exemple. Vous pouvez faire: - - # en tant qu'utilisateur scodoc - cd /opt/scodoc/ - cp .env-exemple .env - nano .env # édition ### Initialisation de la base utilisateur par Flask @@ -150,25 +91,34 @@ Pour créer un utilisateur "super admin", c'est à dire admin dans tous les dép flask user-create admin1 SuperAdmin @all -## Migration d'une installation ScoDoc 7 +## Migration d'une installation ScoDoc 7 sur un nouveau serveur -La migration va se faire en suivant les étapes: +C'est le cas recommandé car il minimise la coupure +Dans ce cas, la migration va se faire en suivant les étapes: - 1. sauvegarder les données de ScoDoc7 (depuis le serveur de production); + 1. installer le nouveau serveur Linux et ScoDoc 9; - 2. installer le nouveau serveur Linux et ScoDoc 9; + 2. sauvegarder les données de ScoDoc7 depuis le serveur de production et l'arrêter; 3. y charger les données ScoDoc 7; 4. importer ces données dans ScoDoc 9. -### Étape 1: sauvegarde des données du serveur ScoDoc 7 +### Étape 1 + +Installer le nouveau serveur avec Debian 11 et ScoDoc 9. + +Voir https://scodoc.org/GuideInstallDebian11 + +### Étape 2: sauvegarde des données du serveur ScoDoc 7 Se connecter en tant que `root`sur le serveur ScoDoc 7. cd /opt/scodoc/Products/ScoDoc/config # Mise à jour indispensable pour avoir le script de migration ./upgrade.sh + # Arrêt du service en production + systemctl stop scodoc # Export des données ./save_scodoc7_data.sh /tmp/sauvegarde-scodoc7 @@ -179,9 +129,7 @@ exemple `/tmp/sauvegarde-scodoc7.tgz` Copier ce fichier sur le nouveau serveur. -### Étape 2 -Installer le nouveau serveur avec Debian 11 et ScoDoc 9. ### Étape 3 diff --git a/app/scodoc/sco_abs_views.py b/app/scodoc/sco_abs_views.py index 66bdcbac..c83e654e 100644 --- a/app/scodoc/sco_abs_views.py +++ b/app/scodoc/sco_abs_views.py @@ -660,7 +660,7 @@ def EtatAbsences(): # crude portage from 1999 DTML H = [ html_sco_header.sco_header(page_title="Etat des absences"), - """