1
0
forked from ScoDoc/ScoDoc

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) (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> Documentation utilisateur: <https://scodoc.org>
## Branche ScoDoc 8 expérimentale ## Branche ScoDoc 9 expérimentale
N'utiliser que pour les développements et tests. 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+**. La version ScoDoc 9 est basée sur Flask (au lieu de Zope) et sur **python 3.9+**.
Elle ne sera pas mise en production, c'est une version de développement pour le passage à Python 3.
De très nombreux changements sont susceptibles d'affecter l'API, mais La version 9.0 s'efforce de reproduire presque à l'identique le fonctionnement
on s'efforce à ce que rien ne soit visible des utilisateurs Web. 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: **Version 9.0.0-alpha**: développement en cours, certaines pages fonctionnent,
merci de signaler les erreurs. d'autres pas: merci de signaler les erreurs.
### État actuel (15 août 21) ### État actuel (15 août 21)
@ -33,13 +33,12 @@ merci de signaler les erreurs.
- nettoyage du code, finalisation tests et intégration. - 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: **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 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 sudo su
mv /opt/scodoc /opt/scodoc7 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 ### Installer ScoDoc
Sur un système Linux Debian 10, en tant que `root`: Sur un système Linux Debian 11, en tant que `root`:
- Charger la dernière release depuis https://scodoc.org/git/viennet/ScoDoc/releases - 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 sudo su
cd /opt; tar xf - ScoDoc-x.y.z.tgz # remplacer x.y.z par votre version 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: - Lancer le script d'installation:
cd /opt/scodoc/tools cd /opt/scodoc/tools
./install_debian10.sh ./install_debian11.sh
ce script crée un compte utilisateur "scodoc". 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. est inutile de reconfigurer la messagerie et le firewall.
### Bases de données ### 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` départements et les utilisateurs. Elle est nommée `SCODOC` (et `SCODOC_DEV`
en mode développement, ou `SCODOC_TEST`pour les tests unitaires). en mode développement, ou `SCODOC_TEST`pour les tests unitaires).
Cette base est créée via `sqlalchemy` (l'ORM habituel de Flask). Cette base est créée via `sqlalchemy` (l'ORM habituel de Flask).
### Création de la base de données Pour créer la base de données, lancer le script:
Lancer le script:
su scodoc # au besoin (pas root !) su scodoc # au besoin (pas root !)
cd /opt/scodoc cd /opt/scodoc
@ -99,7 +96,7 @@ Lancer le script:
Les bases créées appartiennent à l'utilisateur (role) postgres `scodoc` Les bases créées appartiennent à l'utilisateur (role) postgres `scodoc`
(qui a été créé par le script d'installation précédent). (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 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`) Le plus simple est de les grouper dans un fichier `.env` (dans `/opt/scodoc/.env`)
qui est lu automatiquement au démarrage: qui est lu automatiquement au démarrage:

View File

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