From 925ff951acfcb735beec1c21be20f3563a0ec71a Mon Sep 17 00:00:00 2001 From: Emmanuel Viennet Date: Fri, 25 Sep 2020 15:53:01 +0200 Subject: [PATCH] Clarifie migrations/mises a jour --- docs/GuideAdminSys.md | 11 +++++++-- docs/MigrationDonneesScoDoc.md | 5 ++-- docs/MigrationVersScoDocSept.md | 43 --------------------------------- docs/MisesAJour.md | 2 +- 4 files changed, 13 insertions(+), 48 deletions(-) delete mode 100644 docs/MigrationVersScoDocSept.md diff --git a/docs/GuideAdminSys.md b/docs/GuideAdminSys.md index 3b133d3a..9939c0ae 100644 --- a/docs/GuideAdminSys.md +++ b/docs/GuideAdminSys.md @@ -7,8 +7,7 @@ Utilisez un **serveur virtuel** ou un container Docker si vous n'avez pas de mac ## Installation * Installation de ScoDoc: [GuideInstallDebianDix](GuideInstallDebianDix.md) (ou [GuideInstallDebianNeuf](GuideInstallDebianNeuf.md)) - * Migration installations Debian 7 ou 8 vers Debian 9: [MigrationDonneesScoDoc](MigrationDonneesScoDoc.md) - * Migration installations Debian 6 vers Debian 7: [MigrationVersScoDocSept](MigrationVersScoDocSept.md) + ## Mises à jour et sauvegardes @@ -16,6 +15,14 @@ Utilisez un **serveur virtuel** ou un container Docker si vous n'avez pas de mac * [Mettre à jour du logiciel (nouvelles versions)](MisesAJour.md) * [Mise en place de sauvegardes des bases de données](SauvegardesBases.md) +### Pour les anciennes installations +ScoDoc 7 est une version adaptée aux systèmes Debian 9 ou 10 (il est possible que les version plus anciennes de Linux Debian fonctionnent encore, mais une mise à jour est fortement recommandée). + +Linux Debian 10 est la version recommandée en production. + + * Migration installations Debian anciennes vers Debian 10: [MigrationDonneesScoDoc](MigrationDonneesScoDoc.md) + + ## Configuration et préférences * [ConfigPermissions](ConfigPermissions.md) : description des permissions et rôles utilisés par le système. diff --git a/docs/MigrationDonneesScoDoc.md b/docs/MigrationDonneesScoDoc.md index 13eb922d..b8309d25 100644 --- a/docs/MigrationDonneesScoDoc.md +++ b/docs/MigrationDonneesScoDoc.md @@ -12,16 +12,17 @@ Toutes les données seront copiées: bases SQL, configurations, photos, archives ## Principe Au lieu de mettre à jour le système Debian, il est préférable de réinstaller complètement un nouveau serveur. En effet, ScoDoc utilise certains composants qui ne sont pas fournis dans les versions adéquates par Debian. + L'expérience montre qu'il est plus rapide de tout réinstaller sans se poser de questions. D'ailleurs, la plupart des installations étant sur des serveurs virtualisés, cette méthode est souvent plus simple et évite de toucher au serveur en production. Le principe est donc: 1. Installer un nouveau serveur Linux; 2. Y installer ScoDoc ; - 3. Copier les données d'un serveur à l'autre. + 3. Copier les données d'un serveur à l'autre (scripts fournis); 4. Tester, puis le cas échéant couper l'ancien serveur et le remplacer par le nouveau. -Si vous maîtrisez les commandes Linux, connaissez Debian et souhaitez passer rapidement un serveur Debian 8 en Debian 9, vous pouvez essayer [UpgradeToDebNeuf](UpgradeToDebNeuf.md) +> Note: Si vous maîtrisez les commandes Linux, connaissez Debian et souhaitez passer rapidement un serveur Debian 8 en Debian 9, vous pouvez essayer [UpgradeToDebNeuf](UpgradeToDebNeuf.md) diff --git a/docs/MigrationVersScoDocSept.md b/docs/MigrationVersScoDocSept.md deleted file mode 100644 index ffb70bb7..00000000 --- a/docs/MigrationVersScoDocSept.md +++ /dev/null @@ -1,43 +0,0 @@ - -# Migration d'une installation existante de ScoDoc 6 vers ScoDoc 7 -La version ScoDoc 7 est une version adaptée au système Debian 7, 8, 9 ou 10, publiée en le 19 novembre 2013. Elle inclue aussi de nombreuses autres mises à jour, notamment le passage à Python 2.7. - -L'installeur pour Debian 10 est maintenant disponible. - -Pour moderniser un serveur ScoDoc très ancien, voici la marche à suivre. - - - -## Principe -Au lieu de mettre à jour le système Debian, il est préférable de réinstaller complètement un nouveau serveur. En effet, ScoDoc utilise certains composants qui ne sont pas fournis dans les versions adéquates par Debian. -L'expérience montre qu'il est plus rapide de tout réinstaller sans se poser de questions. D'ailleurs, la plupart des installations étant sur des serveurs virtualisés, cette méthode est souvent plus simple et évite de toucher au serveur en production. - -Le principe est donc: - - 1. Installer un serveur Debian (10); - 2. Y installer ScoDoc version 7; - 3. Copier les données d'un serveur à l'autre. - 4. Tester, puis couper l'ancien serveur et le remplacer par le nouveau. - - -## Marche à suivre détaillée -### Installation de Debian et ScoDoc - Voir les instructions ici: [GuideInstallDebianDix](GuideInstallDebianDix.md) - - - -### 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 [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`) - 1. Sur la machine destination, sur laquelle ScoDoc vient d'être installé, lancer (en tant qu'utilisateur `root` dans `/opt/scodoc/instance/Products/ScoDoc/config`) le script `restore_scodoc_data.sh ` - 1. Mettre à jour votre installation de destination (`./upgrade.sh`) (oui, à nouveau, important pour assurer que les anciennes bases de données sont aussi mises à jour). - 1. Relancer ScoDoc (`/etc/init.d/scodoc start`) et tester. - - - - - diff --git a/docs/MisesAJour.md b/docs/MisesAJour.md index c6cbd813..e02128d3 100644 --- a/docs/MisesAJour.md +++ b/docs/MisesAJour.md @@ -22,5 +22,5 @@ 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 (l'appliquer à ScoDoc 6 reste en ScoDoc 6, pour passer en ScoDoc 7, ce qui est recommandé, suivre [MigrationVersScoDocSept](MigrationVersScoDocSept.md)) +Note: cette procédure ne change pas de version majeure de ScoDoc, ni du système Linux. Pour cela, voir [MigrationDonneesScoDoc](MigrationDonneesScoDoc.md))