DocScoDoc/docs/MigrationDonneesScoDoc.md


#  Migration d'une installation existante de ScoDoc  
Marche à suivre pour transférer les données d'un serveur ScoDoc déjà existant vers un autre. Cas d'usage typiques:

 * changement de machine physique
 * création d'un serveur de développement
 * Mise à jour majeure du système d'exploitation (exemple: passage de Debian 9 à Debian 10).


Toutes les données seront copiées: bases SQL, configurations, photos, archives, logs.


##  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. J'insiste : **ne tentez pas de mettre à jour le système Debian de votre ancien serveur**, c'est une perte de temps.

Le principe est donc:

 1. Installer un nouveau serveur Linux Debian (à partir de zéro);
 2. Y installer ScoDoc ;
 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.


##  Marche à suivre détaillée 
###  Installation de Debian et ScoDoc 
 Voir les instructions ici: [GuideInstallDebian11](GuideInstallDebian11.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 <nom_fichier_archive>`
 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.
Initial 2020-09-21 16:30:27 +02:00
			`# Migration d'une installation existante de ScoDoc`
			`Marche à suivre pour transférer les données d'un serveur ScoDoc déjà existant vers un autre. Cas d'usage typiques:`

			`* changement de machine physique`
			`* création d'un serveur de développement`
			`* Mise à jour majeure du système d'exploitation (exemple: passage de Debian 9 à Debian 10).`


			`Toutes les données seront copiées: bases SQL, configurations, photos, archives, logs.`


			`## Principe`
Avertissement sur reinstallation Linux 2020-10-05 14:27:03 +02:00			`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.`
Clarifie migrations/mises a jour 2020-09-25 15:53:01 +02:00
Avertissement sur reinstallation Linux 2020-10-05 14:27:03 +02:00			`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. J'insiste : ne tentez pas de mettre à jour le système Debian de votre ancien serveur, c'est une perte de temps.`
Initial 2020-09-21 16:30:27 +02:00
			`Le principe est donc:`

Avertissement sur reinstallation Linux 2020-10-05 14:27:03 +02:00			`1. Installer un nouveau serveur Linux Debian (à partir de zéro);`
Initial 2020-09-21 16:30:27 +02:00			`2. Y installer ScoDoc ;`
Clarifie migrations/mises a jour 2020-09-25 15:53:01 +02:00			`3. Copier les données d'un serveur à l'autre (scripts fournis);`
Initial 2020-09-21 16:30:27 +02:00			`4. Tester, puis le cas échéant couper l'ancien serveur et le remplacer par le nouveau.`


			`## Marche à suivre détaillée`
			`### Installation de Debian et ScoDoc`
MAJ conseils dev. Suppression de qq docs obsolètes. 2022-04-02 08:23:13 +02:00			`Voir les instructions ici: [GuideInstallDebian11](GuideInstallDebian11.md).`
Initial 2020-09-21 16:30:27 +02:00


			`### Copie des données d'un serveur à l'autre`
			`Il est important de suivre rigoureusement et pas à pas cette procédure:`

Proécure rapide de maj debian 2021-05-15 23:30:40 +02:00			`1. S'assurer que le serveur de départ est à jour (pour avoir le bon script de sauvegarde!): voir [MisesAJour](MisesAJour.md)`
Initial 2020-09-21 16:30:27 +02:00			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 <nom_fichier_archive>`
			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.