diff --git a/docs/GuideInstallDebianDix.md b/docs/GuideInstallDebianDix.md index a24980c..21e3320 100644 --- a/docs/GuideInstallDebianDix.md +++ b/docs/GuideInstallDebianDix.md @@ -102,7 +102,7 @@ En cas d'échec, ce script peut être relancé (il écrasera l'ancienne configur Dans cette étape, sont installés et configurés automatiquement: * serveur web Apache (et https) - * parefeu réseau (optionnel, basé sur firehol) + * parefeu réseau (optionnel, basé sur `ufw`) * messagerie pour envois messages (postfix) (optionnel mais très vivement recommandé) * installation de divers logiciels utilisés par ScoDoc (par apt-get) * script de lancement automatique de ScoDoc (service systemd). diff --git a/docs/MigrationDonneesScoDoc.md b/docs/MigrationDonneesScoDoc.md index 4f066bb..da5a94f 100644 --- a/docs/MigrationDonneesScoDoc.md +++ b/docs/MigrationDonneesScoDoc.md @@ -32,7 +32,7 @@ Le principe est donc: ### Copie des données d'un serveur à l'autre Il est important de suivre rigoureusement et pas à pas cette procédure: - 1. S'assurer que le serveur de départ est à jour (pour avoir le bon script de sauvegarde!): [voir ici](https://trac.lipn.univ-paris13.fr/projects/scodoc/wiki/MisesAJour) + 1. S'assurer que le serveur de départ est à jour (pour avoir le bon script de sauvegarde!): voir [MisesAJour](MisesAJour.md) 1. Enregistrer les données sur le serveur d'origine: lancer le script `save_scodoc_data.sh` (en tant qu'utilisateur `root` dans `/opt/scodoc/instance/Products/ScoDoc/config`). Ce script crée une archive (tgz) qui contient toutes les informations: bases de données SQL, données utilisateurs, photos, archives des documents, fichier de configuration. 1. Copier le fichier (`.tgz`) obtenu sur la machine destination (par exemple en utilisant ssh ou une clé USB). 1. Mettre à jour votre installation de destination (`./upgrade.sh`) diff --git a/docs/MisesAJour.md b/docs/MisesAJour.md index 413f6d0..e392b09 100644 --- a/docs/MisesAJour.md +++ b/docs/MisesAJour.md @@ -22,10 +22,73 @@ La première fois, il faudra accepter un certificat cryptographique, répondre " /!\ La mise à jour entraine une déconnexion des utilisateurs (mais pas de pertes de données !). -Note: cette procédure ne change pas de version majeure de ScoDoc, ni du système Linux. Pour cela, voir [MigrationDonneesScoDoc](MigrationDonneesScoDoc.md)) +Note: cette procédure ne change pas de version majeure de ScoDoc, ni du système Linux. Pour cela, voir [MigrationDonneesScoDoc](MigrationDonneesScoDoc.md)) ou plus bas sur cette page. ## Note concernant les anciens systèmes (Debian 9) En Debian version 9 (et version antérieures), ScoDoc n'utilisait pas `systemd` et n'était pas automatiquement relancé lors de mises à jour de ceertains logiciels, comme la base de données `postgresql`. Sur ces systèmes, il est conseillé de mettre à jour Debian avec le script `/opt/scodoc/Products/ScoDoc/config/upgrade.sh` afin d'éviter d'interrompre le service ScoDoc. +## Mise à jour rapide de Debian 9 à Debian 10 + +Procédure raccourcie réservée aux personnes à l'aise avec linux. On met à jour Debian mais on réinstalle ScoDoc proprement. + +Vérifiez que vous avez assez d'espace disque disponible (`df -h`, au moins 3Go libres sur `/` ou `/opt`). + + 0. Sauvegardez complètement votre système en lieu sûr. Si la procédure ci-dessous échoue, reprenez la voie normale: [MigrationDonneesScoDoc](MigrationDonneesScoDoc.md). + + 1. Mettre à jour votre ScoDoc: + + cd /opt/scodoc/Products/ScoDoc/config + ./upgrade.sh + + 2. Arrêter le service (en Debian 9 on utilisait *SysV-style init*, à partir de Debian 10 ScoDoc utilise `systemd`): + + /etc/init.d/scodoc stop + + + 3. Sauvegarder les données et configurations ScoDoc: + + cd /opt/scodoc/Products/ScoDoc/config + ./save_scodoc_data.sh /opt/data-scodoc-deb9 # par exemple + + + 4. Mettre à jour Debian: pour les détails voir https://www.debian.org/releases/stable/amd64/release-notes/ch-upgrading.html + En résumé: + - éditer `/etc/apt/sources.list` et indiquer + + deb http://deb.debian.org/debian buster main contrib + + - Puis: +``` + apt-get remove firehol + apt update + apt-get upgrade + apt full-upgrade + apt autoremove +``` +et **rebooter**. + + + 5. Supprimer postgresql 9.6 + +On enlève carrément l'ancien, le script d'installation de ScoDoc installera la version 11: + + apt-get --purge remove postgresql + + + 6. Réinstaller ScoDoc + Voir [GuideInstallDebianDix](GuideInstallDebianDix.md) + + La plupart des composants de votre systèmes seront déjà présents, donc répondre en général "non" aux questionx du script d'installation. + + S'arrêter avant l'initialisation des bases de données. + + 7. Restaurer la sauvegarde: + + cd /opt/scodoc/Products/ScoDoc/config + ./restore_scodoc_data.sh /opt/data-scodoc-deb9 + + Vérifiez et voilà. Vérifier que le nouveau système (et ses bases de données) est bien sauvegardé. + +