DocScoDoc/docs/MigrationScoDoc7a9.md

188 lines
6.2 KiB
Markdown
Raw Normal View History

2021-08-26 14:23:51 +02:00
# Migration des données ScoDoc 7 vers ScoDoc 9
*XXX tests en cours XX*
On peut installer à partir de zéro, ou sur une machine ayant déjà un ScoDoc 7
et migrer les données.
## Cas 1: Migration d'une installation ScoDoc 7 sur un nouveau serveur
C'est le cas recommandé car il minimise la coupure et permet de tester avant de
basculer d'une version à l'autre.
Dans ce cas, la migration va se faire en suivant les étapes:
1. installer le nouveau serveur Linux Debian 11 et ScoDoc 9;
2. sauvegarder les données de ScoDoc7 depuis le serveur de production **et l'arrêter**;
3. charger les données ScoDoc 7 sur le nouveau serveur;
4. importer ces données dans ScoDoc 9.
### Étape 1: Installer le nouveau serveur
Installer le nouveau serveur avec Debian 11 et ScoDoc 9.
Voir https://scodoc.org/GuideInstallDebian11
Vérifier que tout fonctionne avant d'aller plus loin.
### Étape 2: Sauvegarder les données du serveur ScoDoc 7
Se connecter en tant que `root`sur l'ancien serveur ScoDoc 7.
cd /opt/scodoc/Products/ScoDoc/config
# Mise à jour indispensable pour avoir le script de migration
./upgrade.sh
# Arrêt du service en production
systemctl stop scodoc
# Export des données
./save_scodoc7_data.sh /tmp/sauvegarde-scodoc7
Attention à l'espace disque: au besoin, faire le ménage ou montez un disque supplémentaire.
Notez que cette migration ne fonctionne qu'à partir de la dernière version de
ScoDoc 7. Si vous avez une version plus ancienne, mettez-la d'abord à jour.
Le script indique le nom du fichier à transférer, qui sera dans
l'exemple ci-dessus `/tmp/sauvegarde-scodoc7.tgz`
Copier ce fichier sur le nouveau serveur (scp, ...).
### Étape 3: Charger les données ScoDoc 7
Récupérez l'archive transférée sur le nouveau serveur ou ouvrez-la:
cd /tmp
tar xfz sauvegarde-scodoc7.tgz
2021-09-06 12:35:49 +02:00
chown -R scodoc /tmp/sauvegarde-scodoc7
2021-08-26 14:23:51 +02:00
commande qui va créer `/tmp/sauvegarde-scodoc7`.
En tant qu'utilisateur "`scodoc`":
/opt/scodoc/tools/restore_scodoc7_data.sh /tmp/sauvegarde-scodoc7
(adaptez l'argument si les données ont été copiées ailleurs)
Note: les messages d'erreur comme
pg_restore: warning: restoring tables WITH OIDS is not supported anymore
pg_restore: error: could not execute query: ERROR: schema "public" already exists
pg_restore: error: could not execute query: ERROR: must be owner of extension plpgsql
sont normaux et a priori anodins.
A ce stade, vous avez rechargé les bases ScoDoc 7 mais il faut encore
les convertir vers la nouvelle structure ScoDoc 9, et importer les photos,
archives et autres fichiers: c'est l'objet de l'étape suivante.
### Étape 4: Importer les données dans ScoDoc 9
Les formats des bases ayant changé l'opération est complexe et peut durer
2021-09-06 12:35:49 +02:00
plusieurs minutes (ou dizaines de minutes). Attention: **Il faut lancer le script en tant
que `root` **.
2021-08-26 14:23:51 +02:00
su # passer root d'une façon ou d'une autre
# lancer le script, avec le nom du répertoire:
/opt/scodoc/tools/migrate_from_scodoc7.sh /tmp/sauvegarde-scodoc7
## Cas 2: Migration "en place" sur la même machine
*XXX tests en cours XXX*
Si vous n'avez pas la possibilité de changer de serveur (par exemple, vous ne
travaillez pas dans des machines virtuelles, ou qu'il est compliqué de créer une
nouvelle VM). Vous pouvez partir de ScoDoc 7 / Debian 10, faire l'upgrade Debian
en place, puis migrer ScoDoc 9.
2021-09-06 12:35:49 +02:00
Avant tout, sauvegardez évidemment votre serveur complet, vérifiez que la
2021-08-26 14:23:51 +02:00
sauvegarde est bonne et que plusieurs exemplaires sont stockés en lieux sûrs,
comme d'habitude.
Toutes les étapes sont importantes, prenez votre temps, lisez bien cette page.
### 1. Préparation et arrêt de ScoDoc 7
1. S'assurer que l'installation ScoDoc 7 est à jour
sudo su
cd /opt/scodoc/Products/ScoDoc/config
./upgrade.sh
Notez que cette migration ne fonctionne qu'à partir de la dernière version
de ScoDoc 7. Si vous avez une version plus ancienne, mettez-la d'abord à
jour.
2. Arrêter le service ScoDoc 7
systemctl stop scodoc
S'assurer qu'il est bien stoppé (`ps auxw`, ...), sans quoi la migration va échouer.
3. Renommer le répertoire de ScoDoc 7:
sudo su
mv /opt/scodoc /opt/scodoc7
Les données seront migrées après installation la nouvelle version, voir
plus loin. ScoDoc 9 sera installé dans `/opt/scodoc`, il est donc très important
de renommer le répertoire en `scodoc7`.
### 2. Upgrade Debian
Suivre la procédure standard. La [doc
officielle](https://www.debian.org/releases/bullseye/mips64el/release-notes/ch-upgrading.fr.html)
est longue, mais en réalité c'est très simple sauf si vous avez configuré votre
système de façon exotique, ce qui est peu probable pour un serveur ScoDoc.
Nombreux tutos disponibles, voir [par exemple
celui-ci](https://doc.akito.ooo/books/essentials/page/manually-upgrade-debian-from-buster-to-bullseye)
(non testé).
2021-09-06 12:35:49 +02:00
Attention, il faut désinstaller Apache (avant ou après upgrade Linux), car
ScoDoc 9 utilise un autre serveur web (nginx) qui serait en conflit:
# peut être utile pour récuperer vos certificats SSL ?
mv /etc/apache2 /etc/apache2.old
apt-get remove --purge apache2
2021-08-26 14:23:51 +02:00
### 3. Installer ScoDoc 9
2021-09-06 12:35:49 +02:00
Voir [le guide d'installation](GuideInstallDebian11.md), section 2.
2021-08-26 14:23:51 +02:00
Vérifier que tout fonctionne avant d'aller plus loin.
### 4. Migrer vos données ScoDoc 7
Les données sont restées dans /opt/scodoc7.
Lancer le script suivant en tant que `root`:
2021-09-06 12:35:49 +02:00
/opt/scodoc/tools/migrate_from_scodoc7.sh -m
2021-08-26 14:23:51 +02:00
(l'option `-m` indique qu'il s'agit d'une migration "en place").
La migration prends du temps, et il n'est pas inutile de consulter les messages
affichés, dont la plupart se retrouvent aussi dans le fichier
/opt/scodoc/data/log/migration79.log
Prêtez attention aux éventuels changements de login des utilisateurs et
informez-les. ScoDoc 9 n'autorise pas de caractères spéciaux (apostrophes, ...)
ou accentués dans les logins.
### 5. Vérifier que tout fonctionne
Vos départements et utiisateurs devraient être accessibles.
L'utilisateur àdmin`créé à l'installation de ScoDoc 9 doit avoir accès à tout.
Vérifiez que les semestres, étudiants, photos, archives et comptes utilisateurs
sont bien là.
Célébrez !