DIAPASON 05

Restauration des données à partir d'un backup


Prérequis

Avoir au préalable créé un environnement à partir d’une sauvegarde dans la même révision que l’environnement d'origine.

Comment créer ce nouvel environnement Création nouvel environnement depuis un backup

Génération de la photo du paramétrage

L’ objectif de cette photo est de conserver le paramétrage spécifique de l’environnement afin de pouvoir le réappliquer suite à la restauration de données issues d’un autre environnement.

Que contient cette photo ?

Tables présentes dans la photo du paramétrage.

Table

Description

Imprim
AdDocor
ImpUtil
isinssrvapp
isadbjob
ispasys
DTCoGDia
IsPaInfr
isergthe
adtrpaen
ispautil
ispaisia
isdiames

Imprimantes
Paramétrage Traitement Documents suivant Origine
Lien Imprimante / Utilisateurs
Serveur Application
Jobs
Paramètres Système de DIAPASON
Constantes Globales de Diapason
Table des Environnements par Infrastructures
Les thèmes
Paramétrage Traitement Répétitif
Paramètres utilisateurs
Paramètres ISIA
Messages du login DIAPASON

Tables de la photo d’intégrité :

La photo d’intégrité est automatique, elle permet de sauvegarder les utilisateurs et l’historique des connexions. Elle n’est pas facultative.

Mise à jour des variables d’environnement nécessaires à la photo

Il faut mettre ces variables d’environnement dans le diapason.ini de l’environnement où la photo doit être faite.

Variable

Description

DIAP_PHOTO_REP

Chemin du dossier de la photo, utilisé pour la génération et la restauration

KEEP_TABLES_BEFORE_IMPORT

Seule valeur pertinente “+”. Gestion du comportement des tables du paramétrage. Si activé, la restauration fusionne les données de la sauvegarde et les données de la photo. En cas de même clé unique, la donnée de la photo écrase celle de la sauvegarde. Si non activé, seules les données de la photo resteront.

DIAP_PHOTO_EXCLU

Liste des tables à ne pas restaurer depuis la photo

Si vous modifiez le diapason.ini, vous devez impérativement lancer la commande suivante pour que les variables se mettent à jour dans Diapason

/Diap/environments/[ENVNAME]/devt/Diap/Shell/diapason.sh variables

Lancement de la photo du paramétrage

Il est maintenant possible d’extraire les données pour la photo.

Les données de ces tables décrites dans le tableau “Tables présentes dans la photo du paramétrage” plus tôt dans cette page seront stockées dans le dossier spécifié dans la variable d’environnement DIAP_PHOTO_REP.

Pour ce faire, il faut aller dans Diapason sur la définition des utilisateurs, action Exploitation → Génération Photo

image-20260611-095315.png


Cette action “Génération Photo” génèrera les données (.d) issues de la photo dans le répertoire spécifié dans la variable d’environnement DIAP_PHOTO_REP du diapason.ini.

Restauration des données à partir d’une sauvegarde et d’une photo

Le prérequis à cette action est que l’environnement cible est créé dans la même version que l’environnement origine.

Vous pouvez maintenant utiliser la photo que vous avez faite.

Il suffit de lancer la commande :

Restauration des bases sur l’environnement :

./restoreFromBackup.sh -ENV_PATH <Chemin de l’environnement cible à restaurer>

-BACKUP_PATH <Chemin du dossier de sauvegarde des bases>

[-NoArchive] (optionnel : exclut les bases d’archivages contenues dans le backup lors de la restauration)

[-Photo] (optionnel : repose la photo du paramétrage après restauration. La restauration s’arrête si aucune photo existe)

[-TMP_PATH] (optionnel : chemin du dossier des logs de la restauration et des données (.d) liées aux tables d’intégrité.

si non renseigné, répertoire défaut pris en compte “/tmp/restoreFromBackup”)

Cette commande va utiliser le répertoire que vous avez spécifié dans le diapason.ini (DIAP_PHOTO_REP) pour récupérer les données (.d) de la photo et va faire la restauration suivi du remplacement des données (.d) de la photo.


Les tables suivantes seront dans leur état d’origine après la restauration des données afin de garantir l’intégrité des données relatives à l’historique de connexion des sessions et les utilisateurs associés.

sessionshistory - Historique de connexions des sessions
utils - Utilisateurs

Restauration des données à partir d’une sauvegarde

Il est possible de restaurer les données d’un environnement à partir d’une sauvegarde (aucune modification n’est faite dans l’environnement Diapason, seulement les données des bases de l’environnement sont remplacées par celles de la sauvegarde ) en lançant la commande suivante :


Restauration des bases sur l’environnement :

./restoreFromBackup.sh -ENV_PATH <Chemin de l’environnement cible à restaurer>

-BACKUP_PATH <Chemin du dossier de sauvegarde des bases>

Après la restauration des données

La table “IsAdbJex” des jobs en attentes/en exécution est purgée entièrement, afin de ne pas lancer des jobs utilisés uniquement sur l’environnement d’origine.

Il est nécessaire de relancer la recompilation des requêtes suite à la restauration des données

INS-REQ Re-Generation Globale Requetes + TV + EIA

Restauration lancée en automatique par planificateur


Commande pour lancer, par exemple, une recopie toutes les 30 min :

30 * * * * <EnvPath>/Diap/Shell/backup/restoreFromBackup.sh -ENV_PATH <EnvPath>/ -BackupPath> -NoArchive -Photo