DocScoDoc/docs/MigrationVersScoDocSept.md

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

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
2. 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.
3. Copier le fichier (.tgz) obtenu sur la machine destination (par exemple en utilisant ssh ou une clé USB).
4. Mettre à jour votre installation de destination (./upgrade.sh)
5. 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 <nom_fichier_archive>
6. Mettre à jour votre installation de destination (./upgrade.sh) (oui, à nouveau, important pour assurer que les anciennes bases de données sont aussi mises à jour).
7. Relancer ScoDoc (/etc/init.d/scodoc start) et tester.