doc pour install 9.0 sur Debian 11

This commit is contained in:
Emmanuel Viennet 2021-08-17 11:13:05 +02:00
parent 47811943c1
commit e8c20f7005
3 changed files with 22 additions and 24 deletions

View File

@ -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 <https://scodoc.org>
Documentation utilisateur: <https://scodoc.org>
## 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:

View File

@ -1 +1,2 @@
8.1.0
9.0.0-alpha