Sauvegarde des données AEM forms

Cette section décrit les étapes nécessaires à la réalisation d’une sauvegarde complète, à chaud ou en ligne, de la base de données AEM forms, de même que du répertoire de stockage global de documents et du répertoire racine de stockage de contenu.

Une fois AEM forms installé et déployé dans les zones de production, l’administrateur de la base de données doit procéder à une première sauvegarde complète (ou à froid) de la base de données. Pour cela, la base de données doit être fermée. Par la suite, il devra effectuer régulièrement des sauvegardes incrémentielles (ou à chaud) de la base de données.

Pour une sauvegarde et une restauration réussies, une sauvegarde de l’image système doit être disponible à tout moment. Ainsi, si une perte de données se produit, vous pouvez récupérer la totalité de votre environnement dans un état cohérent.

Le fait d’effectuer la sauvegarde de la base de données en même temps que les sauvegardes du répertoire global de documents, du référentiel AEM et du répertoire racine de contenu de stockage aide à maintenir ces systèmes synchronisés si une récupération devait intervenir.

La procédure de sauvegarde décrite dans cette section nécessite d’être en mode de sauvegarde sécurisé avant de sauvegarder la base de données AEM forms, le référentiel AEM, le répertoire de stockage global de documents et le répertoire racine de stockage de contenu. Une fois la sauvegarde terminée, vous devez quitter le mode de sauvegarde sécurisé. Le mode de sauvegarde sécurisé est utilisé pour marquer les documents de longue durée et persistants qui résident dans le répertoire de stockage global de documents. Ce mode garantit que le mécanisme de nettoyage de fichiers automatique (le collecteur de fichiers) ne supprime pas les fichiers expirés jusqu’à l’activation du mode de sauvegarde sécurisé. La sauvegarde d’un répertoire de stockage global de documents doit rester synchronisée avec la sauvegarde d’une base de données.

La fréquence de sauvegarde de l’emplacement du répertoire de stockage global de documents dépend du mode d’utilisation d'AEM forms et des fenêtres de sauvegarde disponibles. La fenêtre de sauvegarde peut être affectée par les processus de longue durée, qui peuvent parfois s’exécuter pendant plusieurs jours. Si vous modifiez, ajoutez et supprimez en permanence des fichiers dans le répertoire de stockage global de documents, sauvegardez plus souvent cet emplacement.

Si la base de données s’exécute dans un mode de consignation tel que décrit précédemment, les journaux de la base de données doivent également être sauvegardés régulièrement, afin d’en permettre l’utilisation pour restaurer la base de données en cas d’échec du support.

Remarque : les fichiers qui ne sont pas référencés peuvent persister dans le répertoire de stockage global de documents après la récupération. Il s’agit d’une limitation connue actuelle.

Sauvegarde de la base de données, du répertoire de stockage global de documents, du référentiel AEM et du répertoire racine de stockage de contenu

AEM forms peut être soit en mode de sauvegarde sécurisé (instantané) soit en mode de sauvegarde restauration (couverture continue). Avant de définir AEM forms sur l’un de ces modes de sauvegarde, assurez-vous que les conditions suivantes sont remplies :

  • Vérifiez la version du système et notez les correctifs et mises à jour appliqués depuis la dernière sauvegarde d’image système complète.

  • Si vous utilisez des sauvegardes en mode instantané ou de type restauration, vérifiez que votre base de données est configurée avec des paramètres de consignation corrects pour autoriser les sauvegardes à chaud de la base de données (voir Base de données des formulaires AEM ).

Outre ces vérifications, observez les recommandations ci-dessous relatives au processus de sauvegarde/restauration.

  • Sauvegardez le répertoire de stockage global de documents en utilisant un système d’exploitation disponible ou un utilitaire de sauvegarde tiers (voir Emplacement du répertoire de stockage global de documents ).

  • (facultatif) Sauvegardez le répertoire racine de stockage de contenu en utilisant un système d’exploitation disponible ou un utilitaire de sauvegarde tiers (voir Emplacement racine de stockage de contenu (environnement autonome) ou Emplacement racine de stockage de contenu (environnement organisé en grappes) ).

  • Sauvegardez les instances d’auteur et de publication (sauvegarde de crx-repository).

    Pour sauvegarder l’environnement de la solution Correspondence Management, effectuez la procédure relative aux instances d’auteur et de publication décrite dans le document Sauvegarde et restauration .

    Considérez les points suivants lors de la sauvegarde des instances d’auteur et de publication :

    • Assurez-vous que les sauvegardes des instances d’auteur et de publication sont synchronisées afin de commencer au même moment. Bien que vous puissiez continuer à utiliser les instances d’auteur et de publication lorsque la sauvegarde est en cours, il est recommandé de ne pas publier d’actif pendant la sauvegarde afin d’éviter des modifications non enregistrées. Patientez jusqu’à ce que la sauvegarde des instances d’auteur et de publication soit terminée avant de publier de nouveaux actifs.

    • La sauvegarde complète de nœud d’auteur inclut la sauvegarde des données de Forms Manager et HTML Workspace.

    • Les développeurs de Workbench peuvent continuer à travailler sur leurs processus localement. Ils ne doivent pas déployer de nouveaux processus au cours de la phase de sauvegarde.

    • La décision concernant la durée de chaque session de sauvegarde (en mode de sauvegarde restauration) doit être basée sur la durée totale nécessaire pour sauvegarder toutes les données dans AEM forms (base de données, stockage global de données, référentiel AEM et toutes les autres données personnalisées supplémentaires).

Vous devez sauvegarder la base de données AEM forms, y compris tous les journaux de transactions (voir Base de données des formulaires AEM ). Pour plus d’informations, voir l’article correspondant à votre base de données dans la base de connaissances :

Ces articles vous aident à utiliser les fonctions de sauvegarde et de récupération de base de la base de données. Ils ne constituent en aucun cas des guides techniques expliquant de manière exhaustive les fonctions de sauvegarde et de récupération de bases de données spécifiques à certains fournisseurs. Ils présentent simplement les commandes nécessaires à la création d’une stratégie de sauvegarde fiable des bases de données pour les données de l’application AEM forms.

Remarque : la sauvegarde de la base de données doit être terminée avant que vous commenciez à sauvegarder le répertoire de stockage global de documents. Si ce n’est pas le cas, vos données seront désynchronisées.

Passage en mode de sauvegarde

Vous pouvez utiliser Administration Console, la commande LCBackupMode ou l’API accompagnant l’installation AEM forms pour passer à un mode de sauvegarde et le quitter. L’option d’Administration Console n’est pas disponible pour le mode de sauvegarde restauration (couverture en continu) ; utilisez l’option de ligne de commande ou l’API. Pour plus d’informations sur l’utilisation de l’API pour passer en mode de sauvegarde et le quitter, consultez le Guide de référence de l'API d'AEM forms .

Remarque : Si vous avez configuré SSL sur le serveur Forms, vous ne pouvez pas passer le serveur Forms en mode de sauvegarde à l’aide du script LCBackupMode.CMD.

Utilisation d’Administration Console pour passer en mode de sauvegarde sécurisé

  1. Connectez-vous à Administration Console.

  2. Cliquez sur Paramètres > Paramètres de Core System > Utilitaires de sauvegarde.

  3. Sélectionnez Fonctionner en mode de sauvegarde sécurisé et cliquez sur OK.

    Cette méthode passe AEM forms en mode indéfini de sauvegarde (aucun délai d’expiration), en mode d'instantané et non en mode de sauvegarde de restauration.

Utilisation de l’option de ligne de commande pour passer en mode de sauvegarde sécurisé

Vous pouvez utiliser les scripts LCBackupMode de l’interface de ligne de commande pour passer AEM forms en mode de sauvegarde sécurisé.

  1. Définissez ADOBE_LIVECYCLE et lancez le serveur d’applications.

  2. Accédez au dossier [racine aem-forms] /sdk/misc/Foundation/BackupRestoreCommandline .

  3. Modifiez le script LCBackupMode.cmd ou LCBackupMode.sh de façon à indiquer les valeurs par défaut correspondant à votre système d’exploitation.

  4. Dans l’invite de commande, exécutez la commande suivante sur une seule ligne :

    • (Windows) LCBackupMode.cmd enter [-Host= nom_hôte ] [-port= numéro_port ] [-user= nom_utilisateur ] [-password= mot_de_passe ] [-label= nom_libellé ] [-timeout= secondes ]

    • (Linux, UNIX) LCBackupMode.sh enter [-host= nom_hôte ] [-port= numéro_port ] [-user= nom_utilisateur ] [-password= mot_de_passe ] [-label= nom_libellé ]

    Dans les commandes précédentes, les emplacements réservés peuvent être définis comme suit :

    Host est le nom d’hôte sur lequel AEM forms est exécuté.

    port correspond au port WebServices du serveur d’applications sur lequel AEM forms s’exécute.

    user est le nom d’utilisateur de l’administrateur AEM forms.

    password correspond au mot de passe de l’administrateur d'AEM forms.

    label est le libellé de texte de cette sauvegarde (il peut s’agir de n’importe quelle chaîne).

    timeout est le nombre de secondes après lequel le mode de sauvegarde est quitté automatiquement. Cette valeur peut être comprise en 0 et 10 080. Si elle correspond à 0 (valeur par défaut), le mode de sauvegarde n’expire jamais.

    Pour plus d’informations sur l’interface de ligne de commande pour le mode de sauvegarde, voir le fichier Lisez-moi (Readme) dans le répertoire BackupRestoreCommandline.

Quitter les modes de sauvegarde

Vous pouvez utiliser Administration Console ou l’option de ligne de commande pour quitter les modes de sauvegarde.

Quitter le mode de sauvegarde sécurisé (mode instantané)

Pour passer AEM forms en mode de sauvegarde sécurisée (mode d'instantané) à l’aide d’Administration Console, suivez la procédure suivante.

  1. Connectez-vous à Administration Console.

  2. Cliquez sur Paramètres > Paramètres de Core System > Utilitaires de sauvegarde.

  3. Désélectionnez Fonctionner en mode de sauvegarde sécurisé et cliquez sur OK.

Quitter tous les modes de sauvegarde

Vous pouvez utiliser l’interface de ligne de commande et sortir AEM forms du mode de sauvegarde sécurisé (mode d'instantané) ou pour mettre un terme à la session du mode de sauvegarde en cours (mode de sauvegarde de restauration). Vous ne pouvez pas utiliser Administration Console pour quitter le mode de sauvegarde restauration. Lorsque le mode de sauvegarde restauration est activé, les commandes Utilitaires de sauvegarde d’Administration Console sont désactivées. Vous devez utiliser l’appel d’API ou la commande LCBackupMode.

  1. Accédez au dossier [racine aem-forms] /sdk/misc/Foundation/BackupRestoreCommandline .

  2. Modifiez le script LCBackupMode.cmd ou LCBackupMode.sh de façon à indiquer les valeurs par défaut correspondant à votre système d’exploitation.

    Remarque : Vous devez définir le répertoire JAVA_HOME tel qu’indiqué dans le chapitre correspondant relatif au serveur d’applications, dans le document Préparation à l'installation d'AEM forms .
  3. Exécutez la commande suivante sur une même ligne :

    • (Windows) LCBackupMode.cmd leaveContinuousCoverage [-Host= nom_hôte ] [-port= numéro_port ] [-user= nom_utilisateur ] [-password= mot_de_passe ]

    • (Linux, UNIX) LCBackupMode.sh leaveContinuousCoverage [-Host= nom_hôte ] [-port= numéro_port ] [-user= nom_utilisateur ] [-password= mot_de_passe ]

      Dans les commandes précédentes, les emplacements réservés peuvent être définis comme suit :

      Host est le nom d’hôte sur lequel AEM forms est exécuté.

      port est le port sur lequel AEM forms est exécuté sur le serveur d’applications.

      user est le nom d’utilisateur de l’administrateur AEM forms.

      password correspond au mot de passe de l’administrateur AEM forms.

      leaveContinuousCoverage : cette option permet de désactiver totalement le mode de sauvegarde restauration.

    Important : le paramètre continuous coverage ne peut être rétabli tant que ce mode de sauvegarde est inactif. Toute modification apportée durant cette période n’est pas protégée.
    Remarque : si le stockage de documents dans la base de données est activé, le mode de sauvegarde instantané et le mode de sauvegarde restauration ne sont pas applicables.

    Pour plus d’informations sur l’interface de ligne de commande pour le mode de sauvegarde, voir le fichier Lisez-moi (Readme) dans le répertoire BackupRestoreCommandline.