Sauvegarde / Restauration [DB]

Sommaire
  1. Sauvegarde à chaud (système en fonctionnement)
  2. OU Sauvegarde système arrété
  3. Restauration

Attention

La mise en place d'un système de sauvegarde des données est fortement recommandée sur SCENARIserverLite (fileSystem), mais devient indispensable dans l'environnement base de données de SCENARIserver4.

Effectivement, ce type d'architecture logicielle est sensible aux instabilités système qui peuvent compromettre l'intégrité des données (arrêt non programmé de la machine, ...).

Sauvegarde à chaud (système en fonctionnement)⚓

ProcédureSauvegarde : configuration⚓

  1. Ouvrir le fichier [pathScBatch]/apps/backup/backup.property;

  2. Spécifier les propriétés du programme dans ce fichier, et l'enregistrer ;

    [requis] program.webapp.url : URL d'accès à la webApp⚓

    Exemple :

    program.webapp.url=http://127.0.0.1:8080/scserver41

    [requis] program.user : login d'administration⚓

    Exemple :

    program.user=admin

    [requis] program.password : password d'administration⚓

    Exemple :

    program.password=admin

    [requis] program.logs.dir : Chemin absolu vers le répertoire de log⚓

    Exemple :

    program.logs.dir=[pathLog]/scBatch

ProcédureProcessus de sauvegarde⚓

SCENARIserverDb intègre un système de base de données orienté graphe de documents. Ainsi, il est important de lancer les processus de backup sur un état stable de la base, afin d'en maintenir l'intégrité référentielle lors des restaurations.

Pour ce faire, deux commandes sont à exécuter :

  • avant la sauvegarde des fichiers : permet de passer la base de donnée dans un statut "backup en cours" mémorisant ainsi les suppressions de fichier (blobs), et mettant à disposition des fichiers d'index complets et corrects ;
  • après la sauvegarde : permet de remettre le système dans un état de fonctionnement normal (suppression du statut "backup en cours""
Remarque

La précédente procédure s’exécute avec le SCENARIserver lancé, et ne gène en rien la production.

  1. Exécuter le script [pathScBatch]/apps/backup/backup.bat pre, ou [pathScBatch]/apps/backup/backup.sh pre ;

    Compléments
    Complément⚓

    Cette exécution doit se faire dans le répertoire [pathScBatch]/apps/backup.

  2. Sauvegarder les fichiers de donnée via l'outil de backup au choix

    Compléments
    Répertoires à sauvegarder⚓

    • Base de données :

      • [pathData]/javaserver/blobs ;

      • [pathData]/javaserver/backup ;

    • [optionnel] Environnement de travail : [pathData]/javaserver/privData;
    • [optionnel] Modèles documentaires installés : [pathData]/javaserver/updt et [pathData]/javaserver/pack; ;
    • [optionnel] Générations précédentes : [pathData]/javaserver/gen ;
    Remarque

    Les différents types de backup de fichiers usuels sont utilisables : totale, incrémentale, différentielle.

  3. Exécuter le script [pathScBatch]/apps/backup/backup.bat post, ou [pathScBatch]/apps/backup/backup.sh post;

OU Sauvegarde système arrété⚓

Seule l'étape "Sauvegarder les fichiers de donnée via l'outil de backup au choix" de la procédure ci-dessus est à mettre en oeuvre.

Restauration⚓

ProcédureProcessus de restauration⚓

Un incident système grave compromettant l'intégrité référentielle de la base de donnée peut conduire à la nécessité de restauration d'une sauvegarde.

Dans cette procédure, on considérera le répertoire [backupDir] comme répertoire contenant une sauvegarde complète des données utilisateur.

  1. Arrêter le serveur d'application

  2. Restaurer les répertoires sauvegardés

    AttentionRestauration de la base de donnée⚓
    • Supprimer le répertoire [pathData]/javaserver/db  ;
    • Copier le contenu du répertoire [backupDir]/javaserver/backup dans le répertoire [pathData]/javaserver/db ;
    Restauration des autres répertoires⚓

    Copier/coller le contenu des autres répertoires sauvegardés (privData, updt, pack, gen, blobs, ...) de [backupDir] dans les répertoire du même nom de [pathData].

  3. Relancer le serveur d'application