forked from ScoDoc/ScoDoc
doc pour install 9.0 sur Debian 11
This commit is contained in:
parent
47811943c1
commit
e8c20f7005
43
README.md
43
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 <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:
|
||||
|
Loading…
Reference in New Issue
Block a user