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)
|
(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:
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue