From e8c20f70053808c8b2f032117a6c939ad2979bcc Mon Sep 17 00:00:00 2001 From: Emmanuel Viennet Date: Tue, 17 Aug 2021 11:13:05 +0200 Subject: [PATCH] doc pour install 9.0 sur Debian 11 --- README.md | 43 +++++++++---------- VERSION | 3 +- ...nstall_debian10.sh => install_debian11.sh} | 0 3 files changed, 22 insertions(+), 24 deletions(-) rename tools/{install_debian10.sh => install_debian11.sh} (100%) diff --git a/README.md b/README.md index e7b96818be..cdae6ea09b 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ -# ScoDoc - Gestion de la scolarité - Version ScoDoc 8 +# ScoDoc - Gestion de la scolarité - Version ScoDoc 9 (c) Emmanuel Viennet 1999 - 2021 (voir LICENCE.txt) @@ -8,18 +8,18 @@ Installation: voir instructions à jour sur Documentation utilisateur: -## Branche ScoDoc 8 expérimentale +## Branche ScoDoc 9 expérimentale N'utiliser que pour les développements et tests. -La version ScoDoc8 est basée sur Flask (au lieu de Zope) et sur **python 3.7+**. -Elle ne sera pas mise en production, c'est une version de développement pour le passage à Python 3. +La version ScoDoc 9 est basée sur Flask (au lieu de Zope) et sur **python 3.9+**. -De très nombreux changements sont susceptibles d'affecter l'API, mais -on s'efforce à ce que rien ne soit visible des utilisateurs Web. +La version 9.0 s'efforce de reproduire presque à l'identique le fonctionnement +de ScoDoc7, avec des composants logiciels différents (Debian 11, Python 3, +Flask, SQLAlchemy, au lien de Python2/Zope dans les versions précédentes). -**Work in Progress (WIP)**: développement en cours, certaines pages fonctionnent, d'autres pas: -merci de signaler les erreurs. +**Version 9.0.0-alpha**: développement en cours, certaines pages fonctionnent, +d'autres pas: merci de signaler les erreurs. ### État actuel (15 août 21) @@ -33,13 +33,12 @@ merci de signaler les erreurs. - nettoyage du code, finalisation tests et intégration. -## Installation (sur Debian 10 / python3.7) +## Installation (sur Debian 11 / python3.9.2) -On peut installer à partir de zéro, ou sur une machine ayant déjà un ScoDoc 7 et migrer les données. +On peut installer à partir de zéro, ou sur une machine ayant déjà un ScoDoc 7 +et migrer les données. -### Installation - -#### Arrêter et renommer ScoDoc7 +### Arrêter et renommer ScoDoc7 **Important**: si vous avez un ScoDoc7 installé sur ce serveur, le mettre à jour, l'arrêter et renommer son répertoire avant de commencer l'installation de ScoDoc 8: 1. S'assurer que l'installation ScoDoc 7 est à jour @@ -59,14 +58,14 @@ On peut installer à partir de zéro, ou sur une machine ayant déjà un ScoDoc sudo su mv /opt/scodoc /opt/scodoc7 -Les données pourront être migrées après installation la nouvelle evrsion, voir plus loin. +Les données pourront être migrées après installation la nouvelle version, voir plus loin. -#### Installer ScoDoc -Sur un système Linux Debian 10, en tant que `root`: +### Installer ScoDoc +Sur un système Linux Debian 11, en tant que `root`: - Charger la dernière release depuis https://scodoc.org/git/viennet/ScoDoc/releases - - Déplacer ou copier le fichier `ScoDoc-x.y.z.tgz` dans `/opt` et le décomprimer: + - 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 @@ -74,7 +73,7 @@ Sur un système Linux Debian 10, en tant que `root`: - Lancer le script d'installation: cd /opt/scodoc/tools - ./install_debian10.sh + ./install_debian11.sh ce script crée un compte utilisateur "scodoc". @@ -82,14 +81,12 @@ 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 8.1 utilise une nouvelle base de données unique, regroupant tous les +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). -### Création de la base de données - -Lancer le script: +Pour créer la base de données, lancer le script: su scodoc # au besoin (pas root !) cd /opt/scodoc @@ -99,7 +96,7 @@ Lancer le script: Les bases créées appartiennent à l'utilisateur (role) postgres `scodoc` (qui a été créé par le script d'installation précédent). -### variables d'environnement +### 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: diff --git a/VERSION b/VERSION index 8104cabd36..199afabdd1 100644 --- a/VERSION +++ b/VERSION @@ -1 +1,2 @@ -8.1.0 +9.0.0-alpha + diff --git a/tools/install_debian10.sh b/tools/install_debian11.sh similarity index 100% rename from tools/install_debian10.sh rename to tools/install_debian11.sh