Sauvegarde hors connexion CRX et processus de restauration

Question / Problème

Comment puis-je réaliser une sauvegarde hors connexion pour CRX 1.4.1 ou 1.4.2 ? Comment restaurer la sauvegarde ?

Réponse / Résolution

Sauvegarde hors ligne

La sauvegarde hors ligne permet de créer une sauvegarde cohérente d'un référentiel en cluster. La sauvegarde provient d'un noeud de cluster arrêté.

Avertissement : la copie des fichiers du référentiel pendant l'exécution du référentiel n'est pas prise en charge. Si les fichiers de référentiel sont copiés pendant l’exécution du référentiel, la sauvegarde risque d’être incohérente. Les nœuds et l’index de recherche dans le référentiel copié peuvent être corrompus et le référentiel copié peut ne pas démarrer. Lors du démarrage, l’exception "Esclave a la même identité que" peut être renvoyée (si une connexion réseau au serveur référentiel d’origine existe). La raison en est que le référentiel copié pense qu'il fonctionne en mode cluster.

Configuration requise

Cette information s'applique à CRX 1.4.1 et 1.4.2.

La sauvegarde hors ligne nécessite que l’utilisation du Tar persistence manager. Le TarPM est le gestionnaire de persistance par défaut pour CRX. Cette documentation utilise les répertoires suivants :

• shared/namespaces
• shared/nodetypes
• shared/journal
• shared/repository/datastore
• shared/version
• shared/workspaces/x

Les répertoires suivants existent sur les deux nœuds de cluster (maître et esclave) :

• clusterNode
• clusterNode/repository/index
• clusterNode/repository/meta
• clusterNode/version/copy
• clusterNode/workspaces/* (* signifie tous les espaces de travail utilisés)
• clusterNode/workspaces/*/copy
• clusterNode/workspaces/*/index

Pour améliorer les performances, nous supposons qu'un nœud de cluster est configuré en tant que maître préféré. La sauvegarde est effectuée sur un nœud esclave. Ceci n’est pas obligatoire, c’est simplement utile pour améliorer les performances. Pour savoir comment configurer un nœud de cluster en tant que maître préféré, consultez la configuration Tar PM et Cluster.

Procédure de sauvegarde

• Pour chaque nœud de cluster, sauvegardez le fichier contenant l'identifiant du nœud de cluster. Lors de l'utilisation du démarrage rapide CRX, cet identifiant est stocké dans le clusterNode/cluster_node.id. Lorsque vous n’utilisez pas CRX Quickstart, l’identifiant du nœud de cluster est stocké dans le fichier repository.xml.
• Arrêtez un nœud de cluster (de préférence l'esclave).
• Sauvegardez tous les fichiers de ce nœud de clusters, y compris les sous-répertoires.
• Ensuite, sauvegardez les fichiers sur les répertoires partagés suivants :
  • shared/namespaces
  • shared/nodetypes
  • shared/repository/datastore
• Redémarrez le nœud de cluster.

Restauration d’une sauvegarde (restauration d’urgence)

• Arrêtez les deux nœuds de clusters.
• Supprimez les répertoires suivants dans le répertoire clusterNode sur tous les nœuds de cluster :
  • référentiel, partagé, version, espaces de travail.
• Supprimez tous les fichiers et répertoires du répertoire partagé.
• Restaurez la sauvegarde du nœud de cluster (y compris les sous-répertoires) sur un nœud de cluster.
• Copiez tous les fichiers du nœud de cluster restauré sur tous les autres nœuds de cluster. Après ça, chaque nœud de cluster contient les mêmes données.
• Supprimez le fichier clusterNode/revision.log sur tous les nœuds de clusters.
• Supprimez les fichiers **/listener.properties sur tous les nœuds de cluster s’ils existent.
• Pour chaque nœud de cluster, restaurez le fichier contenant l’ID de nœud de cluster (clusterNode/cluster_node.id ou repository.xml). Cela garantit que chaque nœud de cluster possède un identifiant de nœud de cluster différent.
• Restaurez la sauvegarde du répertoire partagé :
  • shared/namespaces
  • shared/nodetypes
  • shared/repository/datastore
• Copiez le contenu des répertoires suivants d’un nœud de cluster vers le répertoire partagé :
  • clusterNode/version/copy/data*.tar vers shared/version
  • clusterNode/workspaces/*/copy/data*.tar to shared/workspaces/* (pour chaque espace de travail)

Exemples de fichiers de script

La sauvegarde et la restauration hors ligne peuvent être automatisées à l’aide de fichiers de script. Vous pouvez utiliser les deux fichiers de script suivants comme modèles. AVERTISSEMENT : ces scripts sont à titre démonstratif. Vous devez supprimer la sortie débutante, corriger les chemins de variable et tester les scripts dans votre environnement pour les utiliser.

• offline-backup.sh
• offline-restore.sh

Versions concernées

CRX 1.4.1 et 1.4.2.