Récupération des données AEM Forms

Dernière mise à jour : 2023-12-07

Cette section décrit les étapes nécessaires à la récupération des données AEM Forms. Voir également Remarques spécifiques à la sauvegarde et la récupération.

REMARQUE

La base de données, le répertoire de stockage global de documents, le référentiel AEM et le répertoire racine de stockage de contenu doivent être restaurés sur un ordinateur avec le même nom DNS que le nom d’origine.

AEM forms doit pouvoir récupérer de manière fiable après les échecs suivants :

Echec du disque : la dernière version du support de sauvegarde est nécessaire pour récupérer le contenu de la base de données.

Données corrompues : les systèmes de fichiers n’enregistrent pas les transactions passées et les systèmes peuvent remplacer accidentellement des données de processus requises.

Erreur Utilisateur : la récupération se limite aux données mises à disposition par la base de données. La récupération est d’autant plus simple que les données ont été enregistrées et sont disponibles.

Panne de courant, panne du système : souvent, les API d’un système de fichiers ne sont pas assez robustes ou mal utilisées contre les échecs imprévus du système. Ainsi, si une coupure d’électricité ou une panne système survient, il est nettement plus probable que les contenus des documents stockés dans la base de données soient plus à jour que les contenus stockés dans un système de fichiers.

Si vous utilisez le mode de sauvegarde avec remplacement de données, vous restez en mode de sauvegarde après la récupération. Si vous vous trouvez en mode de sauvegarde instantané, vous ne restez pas en mode de sauvegarde après la récupération.

Lorsque vous effectuez une restauration à partir d’une sauvegarde sur un nouveau système, les configurations suivantes peuvent être différentes. Les éléments suivants n’affectent pas les récupérations réussies de l’application AEM Forms :

  • Adresse IP
  • Configuration du système physique (UC, disque, mémoire)
  • Emplacement du répertoire de stockage global de documents
REMARQUE

La sauvegarde du répertoire racine de stockage de contenu doit être restaurée à l’emplacement de ce répertoire, tel qu’il a été défini durant la configuration de Content Services.

Si un nœud unique d’un cluster multinœud a échoué et si les nœuds restants du cluster fonctionnent correctement, effectuez une récupération du nœud unique du cluster.

Récuper les données AEM Forms

  1. Arrêtez les services AEM Forms et le serveur d’applications en cours d’exécution.

  2. Au besoin, recréez le système physique à partir d’une image système. Par exemple, cette étape peut ne pas être nécessaire si la raison de la récupération est un serveur de bases de données déficient.

  3. Appliquez les correctifs ou les mises à jour à AEM Forms qui ont été appliqués depuis que l’image a été créée. Cette information a été mentionnée dans la procédure de sauvegarde. AEM Forms doit se voir appliquer le même niveau de correctif auquel il se trouvait lors de la sauvegarde du système.

  4. (WebSphere® Application Server) Si vous récupérez une nouvelle instance de WebSphere® Application Server, exécutez la commande restoreConfig.bat/sh.

  5. Récupérez la base de données AEM forms en procédant tout d’abord à une opération de restauration de la base de données à l’aide des fichiers de sauvegarde, puis en appliquant les journaux de rétablissement des transactions à la base de données récupérée. (Voir Base de données AEM Forms.) Pour plus d’informations, voir l’un des articles suivants de la base de connaissances :

  6. Récupérez le répertoire de stockage global de documents en commençant par supprimer le contenu de ce répertoire sur l’installation existante d’AEM Forms, puis copiez le contenu de ce même répertoire depuis le stockage global de documents sauvegardé. Si vous avez changé l’emplacement du répertoire de stockage global de documents, voir Modification de l’emplacement du stockage global de documents durant la récupération.

  7. Renommez le répertoire de sauvegarde du répertoire de stockage global de documents à restaurer comme indiqué dans les exemples suivants :

    REMARQUE

    Si le répertoire / restore existe déjà, sauvegardez-le, puis supprimez-le avant de renommer le répertoire / backup qui contient les dernières données.

    • (JBoss®) Renommez [appserver root]/server/'server'/svcnative/DocumentStorage/backup en :

      [appserver root]/server/'server'/svcnative/DocumentStorage/restore.

    • (WebLogic) Renommer [appserverdomain]/'server'/adobe/AEMformsserver/DocumentStorage/backup en :

      [appserverdomain]/'server'/adobe/AEMformsserver/DocumentStorage/restore.

    • (WebSphere®) Renommez [appserver root]/installedApps/adobe/'server'/DocumentStorage/backup en :

      [appserver root]/installedApps/adobe/'server'/DocumentStorage/restore.

  8. Pour récupérer le répertoire racine de stockage de contenu, supprimez le contenu du répertoire racine de stockage de contenu sur l’installation existante d’AEM Forms, puis récupérez le contenu en suivant les tâches pour les environnements autonomes ou organisés en cluster :

    REMARQUE

    La sauvegarde du répertoire racine de stockage de contenu doit être restaurée à l’emplacement du répertoire racine de stockage de contenu tel qu’il a été défini lors de la configuration de Content Services (obsolète).

    Autonome : pendant le processus de récupération, restaurez tous les répertoires sauvegardés. Lorsque ces répertoires sont restaurés, si le répertoire /backup-lucene-indexes existe, renommez-le /lucene-indexes. Si le répertoire lucene-indexes existe déjà, aucune action n’est requise.

    En grappe : pendant le processus de récupération, restaurez tous les répertoires sauvegardés. Pour restaurer le répertoire racine d’index, procédez comme suit sur chaque nœud du cluster :

    • Supprimez tout le contenu du répertoire racine d’index.
    • Si le répertoire /backup-lucene-indexes existe, copiez le contenu du répertoire racine de stockage de contenu /backup-lucene-indexes dans le répertoire racine d’index et supprimez le répertoire racine de stockage de contenu /backup-lucene-indexes.
    • Si le répertoire /lucene-indexes existe, copiez le contenu du répertoire racine de stockage de contenu /lucene-indexes dans le répertoire racine d’index.
  9. Restaurez/récupérez le référentiel CRX.

    • Autonome

      Restaurez les instances d’auteur et de publication : si une catastrophe se produit, vous pouvez restaurer le référentiel à l’état de la dernière sauvegarde en effectuant les étapes décrites dans le document Sauvegarde et de restauration.

      La restauration complète du nœud de création vérifie également la restauration des données du gestionnaire Forms et de l’espace de travail AEM Forms.

    • En cluster

      Pour la restauration dans un environnement en cluster, voir Stratégie de sauvegarde et de restauration dans un environnement en cluster.

  10. Supprimez les fichiers temporaires d’AEM forms créés dans le répertoire java.io.temp ou dans le répertoire temporaire d’Adobe.

  11. Démarrez AEM Forms (voir Démarrer et arrêter des services).

Modification de l’emplacement du répertoire de stockage global de documents pendant la récupération

Si votre répertoire de stockage global de documents est restauré à un emplacement différent de celui d’origine, exécutez le script LCSetGDS pour définir le répertoire de stockage global de documents sur le nouvel emplacement. Le script se trouve dans le dossier [aem-forms root]\sdk\misc\Foundation\SetGDSCommandline. Le script utilise deux paramètres, defaultGDS et newGDS. Voir le fichier ReadMe.txt dans le même dossier pour obtenir des instructions sur la façon d’exécuter le script.

REMARQUE

Si vous avez activé le stockage de documents dans la base de données, il n’est pas nécessaire de modifier l’emplacement du répertoire de stockage global de documents.

REMARQUE

Il s’agit de la seule situation dans laquelle vous devez utiliser ce script pour modifier l’emplacement du répertoire de stockage global de documents. Pour modifier l’emplacement du répertoire de stockage global de documents pendant l’exécution d’AEM Forms, utilisez la console d’administration. (voir Configuration des paramètres généraux d’AEM forms).

REMARQUE

Le déploiement des composants échoue sous Windows si le répertoire de stockage global de documents se trouve à la racine du disque (par exemple, D:). Pour le répertoire de stockage global de documents, vous devez vous assurer que le répertoire ne se trouve pas à la racine du lecteur, mais dans un sous-répertoire. Par exemple, le répertoire doit être D:\GDS et pas uniquement D:.

Récupération du répertoire de stockage global de documents dans un environnement en cluster

Pour modifier l’emplacement du répertoire de stockage global de documents dans un environnement en cluster, arrêtez l’ensemble du cluster et exécutez le script LCSetGDS sur un seul nœud du cluster. (Voir Modification de l’emplacement du répertoire de stockage global de documents pendant la récupération.) Démarrez uniquement ce nœud. Une fois que ce nœud a complètement démarré, vous pouvez démarrer d’autres nœuds du cluster en toute sécurité. Ils pointeront correctement vers le nouveau répertoire de stockage global de documents.

REMARQUE

Si vous ne pouvez pas garantir le démarrage complet d’un nœud avant de démarrer d’autres nœuds, exécutez le script LCSetGDS sur chaque nœud du cluster avant de le démarrer.

Sur cette page