DocumentationAEM 6.5Guide de l’utilisateur

Réplication replication

Last update: Fri Apr 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Les agents de réplication sont essentiels pour Adobe Experience Manager (AEM) en tant que mécanisme pour :

  • publier (activer) du contenu d’un environnement de création vers un environnement de publication ;
  • purger explicitement du contenu du cache de Dispatcher ;
  • renvoyer les données utilisateur (par exemple, de données de formulaire) de l’environnement de publication à l’environnement de création (sous le contrôle de l’environnement de création).

Les requêtes sont mises en file d’attente de l’agent approprié pour traitement.

NOTE
Les données utilisateur (utilisateurs, utilisatrices groupes d’utilisateurs et d’utilisatrices et profils utilisateur) ne sont pas répliquées entre les instances de création et de publication.
Pour plusieurs instances de publication, les données utilisateur sont distribuées par Sling si l’option Synchronisation des utilisateurs et utilisatrices est activée.

Réplication de la création à la publication replicating-from-author-to-publish

La réplication vers une instance de publication ou de Dispatcher se fait en plusieurs étapes :

  • Le créateur ou la créatrice demande que certains contenus soient publiés (activés). Cela peut être effectué par une requête manuelle ou par des déclencheurs automatiques préconfigurés.

  • La requête est transmise à l’agent de réplication par défaut approprié. Un environnement peut avoir plusieurs agents par défaut qui sont toujours sélectionnés pour ce type d’actions.

  • L’agent de réplication « regroupe » le contenu et le place dans la file d’attente de réplication.

  • Dans l’onglet Sites web, l’indicateur de statut coloré est défini pour les pages individuelles.

  • Le contenu est extrait de la file d’attente et transporté vers l’environnement de publication à l’aide du protocole configuré (généralement le protocole HTTP).

  • Un servlet dans l’environnement de publication reçoit la requête et publie le contenu reçu ; le servlet par défaut est https://localhost:4503/bin/receive.

  • Plusieurs environnement de création et de publication peuvent être configurés.

chlimage_1-21

Réplication de la publication vers la création replicating-from-publish-to-author

Certaines fonctionnalités permettent aux utilisateurs et utilisatrices de saisir des données sur une instance de publication.

Parfois, un type de réplication appelé réplication inverse est nécessaire pour renvoyer ces données à l’environnement de création, à partir duquel elles sont redistribuées vers d’autres environnements de publication. Pour des raisons de sécurité, tout trafic de l’environnement de publication vers l’environnement de création doit être strictement contrôlé.

La réplication inverse utilise un agent dans l’environnement de publication qui fait référence à l’environnement de création. Cet agent place les données dans une boîte d’envoi. Cette boîte d’envoi est mise en correspondance avec les écouteurs de réplication dans l’environnement de création. Les écouteurs interrogent les boîtes d’envoi pour collecter toutes les données saisies et les distribuer ensuite selon les besoins. Cela garantit que l’environnement de création contrôle l’ensemble du trafic.

Dans d’autres cas, comme pour les fonctionnalités de communauté (par exemple, les forums, les blogs, les commentaires et les avis), la quantité de contenu créé par l’utilisateur ou l’utilisatrice (UGC) saisi dans l’environnement de publication est difficile à synchroniser efficacement entre les instances AEM à l’aide de la réplication.

AEM Communities n’utilise jamais la réplication pour le contenu créé par l’utilisateur. Au lieu de cela, le déploiement de Communities nécessite un stock commun pour le contenu créé par l’utilisateur (voir Stockage de contenu des communautés).

Réplication prête à l’emploi replication-out-of-the-box

Le site web we-retail, inclus dans une installation AEM standard, peut être utilisé pour illustrer la réplication.

Pour suivre cet exemple et utiliser les agents de réplication par défaut, vous devez installer AEM avec :

  • l’environnement de création sur le port 4502 ;
  • l’environnement de publication sur le port 4503.
NOTE
Activés par défaut :
  • Agents sur l’instance de création : agent par défaut (publication)
Désactivés par défaut (à partir de AEM 6.1) :
  • Agents sur l’instance de création : agent de réplication inverse (publish_reverse)
  • Agents sur l’instance de publication : réplication inverse (boîte d’envoi)
Pour vérifier le statut de l’agent ou de la file d’attente, utilisez la console Outils.
Consultez la section Surveillance de vos agents de réplication.

Réplication (création vers publication) replication-author-to-publish

  1. Ouvrez la page d’assistance dans l’environnement de création.
    https://localhost:4502/content/we-retail/us/en/experience.html <pi>
  2. Modifiez la page afin de pouvoir ajouter du nouveau texte.
  3. Activez la page pour pouvoir publier les modifications.
  4. Ouvrez la page d’assistance dans l’environnement de publication :
    https://localhost:4503/content/we-retail/us/en/experience.html
  5. Vous pouvez désormais voir les modifications que vous avez apportées sur l’instance de création.

Cette réplication est effectuée à partir de l’environnement de création par :

  • Agent par défaut (publication)
    Cet agent reproduit le contenu vers l’instance de publication par défaut.
    Les détails (configuration et journaux) sont accessibles à partir de la console Outils de l’environnement de création ; ou :
    https://localhost:4502/etc/replication/agents.author/publish.html.

Agents de réplication – Prêts à l’emploi replication-agents-out-of-the-box

Les agents suivants sont disponibles dans une installation AEM standard :

  • Agent par défaut
    Utilisé pour effectuer une réplication de l’instance de création vers l’instance de publication.

  • Le Dispatcher Flush
    Utilisé pour gérer le cache du Dispatcher. Consultez la section Invalidation du cache du Dispatcher depuis l’environnement de création et Invalidation du cache du Dispatcher depuis l’instance de publication pour plus d’informations.

  • Réplication inverse
    Utilisée pour effectuer une réplication de l’instance de publication vers l’instance de création. La réplication inverse n’est pas utilisée pour les fonctionnalités de communautés, telles que les forums, les blogs et les commentaires. Elle est désactivée, puisque la boîte d’envoi n’est pas activée. L’utilisation de la réplication inverse nécessite une configuration personnalisée.

  • L’agent statique
    Il s’agit d’un agent qui stocke une représentation statique d’un nœud dans le système de fichiers.
    Par exemple, avec les paramètres par défaut, les pages de contenu et les ressources DAM sont stockées sous /tmp, au format HTML ou au format de ressource approprié. Consultez les onglets Settings et Rules pour la configuration.
    Cette demande a été faite pour que lorsque la page est demandée directement depuis le serveur d’application, le contenu devienne visible. Il s’agit d’un agent spécialisé qui n’est (probablement) pas nécessaire pour la plupart des instances.

Agents de réplication – Paramètres de configuration replication-agents-configuration-parameters

Lors de la configuration d’un agent de réplication à partir de la console Outils, quatre onglets sont disponibles dans la boîte de dialogue :

Paramètres settings

  • Nom

    Nom unique de l’agent de réplication.

  • Description

    Description de l’objectif de cet agent de réplication.

  • Activé

    Indique que l’agent de réplication est activé.

    Lorsque l’agent est activé, la file d’attente s’affiche comme suit :

    • Actif lorsque des éléments sont en cours de traitement.
    • Inactif lorsque la file d’attente est vide.
    • Bloqué lorsque les éléments sont dans la file d’attente, mais ne peuvent pas être traités ; par exemple, lorsque la file d’attente de réception est désactivée.

  • Type de sérialisation

    Type de sérialisation

    • Par défaut  : définit si l’agent doit être automatiquement sélectionné.
    • Vidage du Dispatcher  : sélectionnez cette option si l’agent doit être utilisé pour vider le cache de Dispatcher.

  • Intervalle entre deux tentatives

    Délai (délai d’attente en millisecondes) entre deux tentatives en cas de problème.

    Valeur par défaut : 60000

  • ID utilisateur de l’agent

    Selon l’environnement, l’agent utilise ce compte d’utilisateur pour :

    • collecter et regrouper le contenu à partir de l’environnement de création ;
    • créer et écrire le contenu dans l’environnement de publication.

    Laissez ce champ vide pour utiliser le compte d’utilisateur du système (compte défini dans le sling en tant qu’utilisateur administrateur, admin par défaut).

    note caution
    CAUTION
    Pour un agent dans l’environnement de création, ce compte doit avoir un accès en lecture à tous les chemins que vous souhaitez répliquer.
    note caution
    CAUTION
    Pour un agent dans l’environnement de publication, ce compte doit avoir l’accès en création et en écriture requis pour répliquer le contenu.
    note note
    NOTE
    Cela peut être utilisé comme mécanisme pour sélectionner du contenu spécifique à des fins de réplication.

  • Niveau de journal

    Indique le niveau de détail à utiliser pour les messages du journal.

    • Error : seules les erreurs sont consignées.
    • Info : les erreurs, les avertissements et autres messages informatifs y figureront.
    • Debug : un haut niveau de détail est utilisé dans les messages, principalement à des fins de débogage.

    Valeur par défaut : Info

  • Utiliser pour une réplication inverse

    Indique si cet agent est utilisé pour la réplication inverse ; renvoie l’entrée utilisateur de l’environnement de publication à celui de création.

  • Mise à jour de l’alias

    La sélection de cette option active les demandes d’invalidation de chemin d’alias ou de redirection auprès de Dispatcher. En outre, consultez la section Configuration d’un agent Dispatcher Flush.

Transfert transport

  • URI

    Cela permet de spécifier le servlet de réception à l’emplacement cible. En particulier, vous pouvez spécifier ici le nom d’hôte (ou alias) et le chemin d’accès au contexte de l’instance cible.

    Par exemple :

    • Un agent par défaut peut effectuer une réplication sur https://localhost:4503/bin/receive.
    • Un agent Dispatcher Flush peut effectuer une réplication sur https://localhost:8000/dispatcher/invalidate.cache.

    Le protocole spécifié ici (HTTP ou HTTPS) détermine la méthode de transfert.

    Pour les agents Dispatcher Flush, la propriété URI est utilisée uniquement si vous utilisez les entrées de l’hôte virtuel en fonction du chemin pour différencier les fermes. Vous utilisez ce champ pour cibler la ferme à invalider. Par exemple, la ferme de serveurs n°1 dispose d’un hôte virtuel de www.mysite.com/path1/* et la ferme de serveurs n°2 d’un hôte virtuel de www.mysite.com/path2/*. Vous pouvez utiliser l’URL /path1/invalidate.cache pour cibler la première ferme de serveurs et /path2/invalidate.cache pour cibler la seconde ferme de serveurs.

  • Utilisateur

    Nom d’utilisateur du compte à utiliser pour accéder à la cible.

  • Mot de passe

    Mot de passe du compte à utiliser pour accéder à la cible.

  • Domaine NTLM

    Domain pour l’authentification NTLM.

  • Hôte NTLM

    Hôte pour l’authentification NTLM.

  • Activer Relaxed SSL

    Activez cette option si vous souhaitez que les certificats SSL auto-certifiés soient acceptés.

  • Autoriser les certificats ayant expiré

    Activez cette option si vous souhaitez que les certificats SSL expirés soient acceptés.

Proxy proxy

Les paramètres suivants ne sont nécessaires que si un proxy est nécessaire :

  • Hôte du proxy

    Nom d’hôte du proxy utilisé pour le transport.

  • Port du proxy

    Port du proxy.

  • Utilisateur du proxy

    Nom d’utilisateur du compte à utiliser.

  • Mot de passe du proxy

    Mot de passe du compte à utiliser.

  • Domaine NTLM du proxy

    Domaine NTLM du proxy.

  • Hôte NTLM du proxy

    Domaine NTLM du proxy.

Étendu extended

  • Interface

    Vous pouvez définir ici l’interface de socket à laquelle se lier.

    Cela définit l’adresse locale à utiliser lors de la création de connexions. Si cette valeur n’est pas définie, l’adresse par défaut est utilisée. Cela s’avère utile pour spécifier l’interface à utiliser sur les systèmes à plusieurs hôtes ou en cluster.

  • Méthode HTTP

    Méthode HTTP à utiliser.

    Pour un agent de vidange de Dispatcher, cette valeur est presque toujours GET et ne doit pas être modifiée (POST serait une autre valeur possible).

  • En-têtes HTTP

    Ils sont utilisés pour les agents de vidange de Dispatcher et spécifient les éléments qui doivent être vidés.

    Pour un agent de vidange de Dispatcher, les trois entrées standard ne doivent pas avoir à être modifiées :

    • CQ-Action:{action}
    • CQ-Handle:{path}
    • CQ-Path:{path}

    Ils sont utilisés, le cas échéant, pour indiquer l’action à utiliser lors du vidage du descripteur ou du chemin. Les sous-paramètres sont dynamiques :

    • {action} indique une action de réplication.

    • {path} indique un chemin.

    Ils sont remplacés par le chemin/l’action correspondant à la requête et n’ont donc pas besoin d’être « codés en dur » :

    note note
    NOTE
    Si vous avez installé AEM dans un contexte autre que le contexte recommandé par défaut, vous devez enregistrer le contexte dans les en-têtes HTTP. Par exemple :
    CQ-Handle:/<*yourContext*>{path}

  • Fermer la connexion

    Activez cette option afin que vous puissiez fermer la connexion après chaque requête.

  • Délai d’expiration de connexion

    Délai d’expiration (en millisecondes) à appliquer lors de la tentative d’établissement d’une connexion.

  • Dépassement de délai du socket

    Délai d’expiration (en millisecondes) à appliquer lors de l’attente du trafic après l’établissement d’une connexion.

  • Version du protocole

    Version du protocole. Par exemple : 1.0 pour HTTP/1.0.

Déclencheurs triggers

Ces paramètres permettent de définir des déclencheurs pour la réplication automatisée :

  • Ignorer la valeur par défaut

    Si cette option est cochée, l’agent est exclu de la réplication par défaut ; en d’autres termes, il n’est pas utilisé si une personne chargée de la création de contenu émet une action de réplication.

  • En cas de modification

    Ici, une réplication par cet agent est automatiquement déclenchée lorsqu’une page est modifiée. Utilisé pour les agents de purge de Dispatcher, mais également pour la réplication inverse.

  • En cas de distribution

    Si cette case est cochée, l’agent réplique automatiquement tout contenu marqué pour distribution lors de sa modification.

  • Heure d’activation/de désactivation atteinte

    Cette option déclenche la réplication automatique (pour activer ou désactiver une page selon le cas) lorsque les heures d’activation ou de désactivation définies pour une page sont venues. Elle est principalement utilisée pour les agents de purge de Dispatcher.

  • À réception

    Si cette option est cochée, l’agent crée des réplications en chaîne à chaque réception d’événements de réplication.

  • Aucune mise à jour du statut

    Si cette option est cochée, l'agent ne force pas la mise à jour du statut de la réplication.

  • Aucune création de versions différentes

    Si cette option est cochée, l’agent ne force pas la création de versions différentes des pages activées.

Configuration des agents de réplication configuring-your-replication-agents

Pour plus d’informations sur la connexion des agents de réplication à l’instance de publication à l’aide de MSSL, voir Réplication à l’aide de SSL mutuel.

Configuration des agents de réplication depuis l’environnement de création configuring-your-replication-agents-from-the-author-environment

Dans l’onglet Outils de l’environnement de création, vous pouvez configurer les agents de réplication qui résident dans l’environnement de création (Agents sur la création) ou l’environnement de publication (Agents sur la publication). Les procédures suivantes illustrent la configuration d’un agent pour l’environnement de création, mais elles peuvent être utilisées pour les deux environnements.

NOTE
Lorsque Dispatcher gère les requêtes HTTP pour les instances de création ou de publication, la requête HTTP de l’agent de réplication doit inclure l’en-tête PATH. Outre la procédure suivante, vous devez ajouter l’en-tête PATH à la liste des en-têtes clients de Dispatcher. Consultez /clientheaders (en-têtes clients).

  1. Accédez à l’onglet Outils dans AEM.

  2. Cliquez sur Réplication (volet de gauche pour ouvrir le dossier).

  3. Double-cliquez sur Agents sur la création (le volet gauche ou droit).

  4. Cliquez sur le nom de l’agent approprié (qui est un lien) pour afficher des informations détaillées sur cet agent.

  5. Cliquez sur Modifier. La boîte de dialogue de configuration s’ouvre alors :

    chlimage_1-22

  6. Les valeurs fournies doivent être suffisantes pour une installation par défaut. Si vous apportez des modifications, cliquez sur OK pour les enregistrer (consultez la section Agents de réplication - Paramètres de configuration pour obtenir des informations sur chaque paramètre).

NOTE
L’installation AEM standard spécifie admin comme utilisateur des informations d’identification de transfert dans les agents de réplication par défaut.
Cela doit être modifié en compte d’utilisateur de réplication spécifique au site avec les privilèges pour répliquer les chemins requis.

Configuration de la réplication inverse configuring-reverse-replication

La réplication inverse est utilisée pour renvoyer vers une instance de création le contenu utilisateur généré sur une instance de publication. Elle est généralement utilisée pour des fonctionnalités telles que les enquêtes et les formulaires d’enregistrement.

Pour des raisons de sécurité, la plupart des topologies de réseau n’autorisent pas les connexions de la « zone démilitarisée » (un sous-réseau qui expose les services externes à un réseau non fiable comme Internet).

Comme l’environnement de publication se trouve généralement dans la zone démilitarisée, la connexion doit être lancée à partir de l’instance de création pour que le contenu soit récupéré dans l’environnement de création. Pour cela, il faut :

  • une boîte d’envoi dans l’environnement de publication où le contenu est placé ;
  • un agent (publication) dans l’environnement de création qui interroge régulièrement la boîte d’envoi pour trouver du nouveau contenu.
NOTE
Pour AEM Communities, la réplication n’est pas utilisée pour le contenu créé par l’utilisateur ou l’utilisatrice sur l’instance de publication. Consultez la section Stockage de contenu de la communauté.

Pour ce faire, il vous faut :

Un agent de réplication inverse dans l’environnement de création. Il agit comme le composant principal pour collecter des informations à partir de la boîte d’envoi dans l’environnement de publication :

Si vous souhaitez utiliser la réplication inverse, vérifiez que cet agent est activé.

chlimage_1-23

Un agent de réplication inverse dans l’environnement de publication (boîte d’envoi). Il s’agit de l’élément passif, car il agit comme une « boîte d’envoi ». L’entrée de l’utilisateur ou de l’utilisatrice est placée ici, d’où elle est collectée par l’agent dans l’environnement de création.

chlimage_1-1

Configuration de la réplication pour plusieurs instances de publication configuring-replication-for-multiple-publish-instances

NOTE
Seul le contenu est répliqué. Les données utilisateur ne le sont pas (utilisateurs, utilisatrices, groupes d’utilisateurs et utilisatrices et profils utilisateur).
Pour synchroniser les données utilisateur sur plusieurs instances de publication, activez la synchronisation des utilisateurs et des utilisatrices.

Après l’installation, un agent par défaut est déjà configuré pour la réplication du contenu vers une instance de publication s’exécutant sur le port 4503 de l’hôte local.

Pour configurer la réplication du contenu pour une instance de publication supplémentaire, créez et configurez un nouvel agent de réplication :

  1. Ouvrez l’onglet Outils dans AEM.

  2. Sélectionnez Réplication, puis Agents sur la création dans le panneau de gauche.

  3. Sélectionnez Nouveau….

  4. Définissez le Titre et le Nom, puis sélectionnez Agent de réplication.

  5. Cliquez sur Créer pour créer l’agent.

  6. Double-cliquez sur le nouvel élément de l’agent pour ouvrir le panneau de configuration.

  7. Cliquez sur Modifier. La boîte de dialogue Paramètres de l’agent s’ouvre. Le Type de sérialisation est déjà défini comme valeur par défaut. Il doit le rester.

    • Dans l’onglet Paramètres  :

      • Activez Activé.

      • Saisissez une Description.

      • Définissez l’intervalle entre deux tentatives sur 60000.

      • Gardez le type de sérialisation par Default.

    • Dans l’onglet Transfert  :

      • Entrez l’URI requis pour la nouvelle instance de publication ; par exemple,

        https://localhost:4504/bin/receive.

      • Saisissez le compte d’utilisateur ou d’utilisatrice spécifique au site utilisé pour la réplication.

      • Vous pouvez configurer d’autres paramètres selon vos besoins.

  8. Cliquez sur OK.

Vous pouvez ensuite tester l’opération en mettant à jour, puis en publiant une page dans l’environnement de création.

Les mises à jour s’affichent sur toutes les instances de publication qui ont été configurées comme ci-dessus.

Si vous rencontrez des problèmes, vous pouvez vérifier les journaux sur l’instance de création. Selon le niveau de détail nécessaire, vous pouvez également définir le niveau de journal sur Debug à l’aide de la boîte de dialogue Paramètres de l’agent, tel que décrit ci-dessus.

NOTE
Cette méthode peut être utilisée en association avec l’ID d’utilisateur de l’agent pour sélectionner un contenu différent pour la réplication vers les environnements de publication individuels. Pour chaque environnement de publication :
  1. Configurez un agent de réplication pour répliquer dans cet environnement de publication.
  2. Configurez un compte d’utilisateur ou d’utilisatrice avec les droits d’accès nécessaires pour lire le contenu répliqué dans cet environnement de publication spécifique.
  3. Attribuez le compte d’utilisateur ou d’utilisatrice comme ID d’utilisateur de l’agent pour l’agent de réplication.

Configuration d’un agent de purge de Dispatcher configuring-a-dispatcher-flush-agent

Les agents par défaut sont inclus dans l’installation. Toutefois, une configuration spécifique est toujours nécessaire et la même s’applique si vous définissez un nouvel agent :

  1. Ouvrez l’onglet Outils dans AEM.

  2. Cliquez sur Déploiement.

  3. Sélectionnez Réplication, puis Agents sur la publication.

  4. Double-cliquez sur l’élément Purge du Dispatcher pour ouvrir la vue d’ensemble.

  5. Cliquez sur Modifier. La boîte de dialogue Paramètres de l’agent s’ouvre alors :

    • Dans l’onglet Paramètres  :

      • Activez Activé.

      • Saisissez une Description.

      • Gardez le type de sérialisation sur Dispatcher Flush ou définissez-le comme pour la création d’un agent.

      • (Facultatif) Sélectionnez Mise à jour des alias pour activer les demandes d’invalidation de chemin alias ou de redirection vers le Dispatcher.

    • Dans l’onglet Transfert  :

      • Entrez l’URI requis pour la nouvelle instance de publication ; par exemple,

        https://localhost:80/dispatcher/invalidate.cache.

      • Saisissez le compte d’utilisateur ou d’utilisatrice spécifique au site utilisé pour la réplication.

      • Vous pouvez configurer d’autres paramètres selon vos besoins.

    Pour les agents Dispatcher Flush, la propriété URI est utilisée uniquement si vous utilisez les entrées de l’hôte virtuel en fonction du chemin pour différencier les fermes. Vous utilisez ce champ pour cibler la ferme à invalider. Par exemple, la ferme de serveurs n°1 dispose d’un hôte virtuel de www.mysite.com/path1/* et la ferme de serveurs n°2 d’un hôte virtuel de www.mysite.com/path2/*. Vous pouvez utiliser l’URL /path1/invalidate.cache pour cibler la première ferme de serveurs et /path2/invalidate.cache pour cibler la seconde ferme de serveurs.

    note note
    NOTE
    Si vous avez installé AEM dans un contexte autre que le contexte par défaut recommandé, configurez les En-têtes HTTP dans l’onglet Étendu.

  6. Cliquez sur OK.

  7. Revenez à l’onglet Outils, d’où vous pouvez Activer l’agent de Purge du Dispatcher (Agents sur la publication).

L’agent de réplication de la purge du Dispatcher n’est pas actif sur l’instance de création. Vous pouvez accéder à la même page dans l’environnement de publication en utilisant l’URI équivalent ; par exemple, https://localhost:4503/etc/replication/agents.publish/flush.html.

Contrôle de l’accès aux agents de réplication controlling-access-to-replication-agents

L’accès aux pages utilisées pour configurer les agents de réplication peut être contrôlé à l’aide des droits d’utilisateur et de page de groupe sur le nœud etc/replication.

NOTE
La configuration de ces autorisations n’affecte pas les utilisateurs et utilisatrices qui répliquent du contenu (par exemple depuis la console sites web ou l’option du sidekick). La structure de réplication n’utilise pas la « session utilisateur » ou l’utilisateur actuel pour accéder aux agents de réplication lors de la réplication des pages.

Configuration de vos agents de réplication depuis CRXDE Lite configuring-your-replication-agents-from-crxde-lite

NOTE
La création d’agents de réplication n’est prise en charge que dans l’emplacement /etc/replication du référentiel. Cette restriction est nécessaire pour que les listes de contrôle d’accès associées soient correctement gérées. La création d’un agent de réplication à un autre emplacement de l’arborescence peut entraîner un accès non autorisé.

Divers paramètres de vos agents de réplication peuvent être configurés à l’aide de CRXDE Lite.

Si vous accédez à /etc/replication, vous pouvez voir les trois nœuds suivants :

  • agents.author
  • agents.publish
  • treeactivation

Les deux agents contiennent des informations de configuration concernant l’environnement approprié et ne sont actifs que lorsque cet environnement est en cours d’exécution. Par exemple, agents.publish sera uniquement utilisé dans l’environnement de publication. La copie d’écran suivante montre l’agent de publication dans l’environnement de création, compris avec la gestion du contenu web d’AEM :

chlimage_1-24

Surveillance de vos agents de réplication monitoring-your-replication-agents

Pour surveiller un agent de réplication :

  1. Accédez à l’onglet Outils dans AEM.

  2. Cliquez sur Réplication.

  3. Double-cliquez sur le lien vers les agents pour l’environnement approprié (dans le volet de gauche ou de droite). Par exemple : Agents sur la création.

    La fenêtre qui s’affiche donne un aperçu de tous vos agents de réplication pour l’environnement de création, y compris leur cible et leur statut.

  4. Cliquez sur le nom de l’agent approprié (qui est un lien) pour afficher des informations détaillées sur cet agent :

    chlimage_1-2

    Vous pouvez y effectuer les opérations suivantes :

    • Vérifiez si l’agent est activé.

    • Regardez la cible de toutes les réplications.

    • Vérifiez si la file d’attente de réplication est active (activée).

    • Vérifiez s’il existe des éléments dans la file d’attente.

    • Actualisez ou effacez pour mettre à jour l’affichage des entrées de file d’attente. Cela vous permet de voir que les éléments entrent et sortent de la file d’attente.

    • Affichez le journal pour accéder au journal de toutes les actions de l’agent de réplication.

    • Testez la connexion à l’instance cible.

    • Forcez une nouvelle tentative sur les éléments de la file d’attente, le cas échéant.

    note caution
    CAUTION
    N’utilisez pas le lien « Tester la connexion » pour la boîte d’envoi de réplication inverse sur une instance de publication.
    Si un test de réplication est effectué pour une file d’attente de la boîte d’envoi, les éléments qui sont plus anciens que la réplication de test sont retraités avec chaque réplication inverse.
    Si de tels éléments existent déjà dans la file d’attente, ils peuvent être recherchés avec la requête XPath JCR suivante et doivent être supprimés.
    /jcr:root/var/replication/outbox//*[@cq:repActionType='TEST']

Réplication par lots batch-replication

La réplication par lots ne reproduit pas individuellement les pages ou les ressources, mais attend que le premier seuil des deux, qu’il s’agisse d’un seuil temporel ou de taille, soit déclenché.

Elle regroupe ensuite tous les éléments de réplication dans un package, qui est ensuite répliqué en tant que fichier unique vers l’éditeur.

L’éditeur décompresse tous les éléments, les enregistre et les renvoie à l’instance de création.

Configuration de la réplication par lots configuring-batch-replication

  1. Accédez à http://serveraddress:serverport/siteadmin.
  2. Appuyez sur l’icône Outils dans la partie supérieure de l’écran.
  3. Dans le rail de navigation de gauche, accédez à Réplication – Agents sur la création et double-cliquez sur Agent par défaut.
    • Vous pouvez également accéder à l’agent de réplication de publication par défaut en accédant directement à http://serveraddress:serverport/etc/replication/agents.author/publish.html.
  4. Appuyez sur le bouton Modifier au-dessus de la file d’attente de réplication.
  5. Dans la fenêtre suivante, accédez à l’onglet Avancé  :
    batchreplication
  6. Configurez l’agent.

Paramètres parameters

  • Enable Batch Mode : active ou désactive le mode de réplication par lots.
  • Max Wait Time - Durée d’attente maximale avant le démarrage d’une requête par lots, en secondes. La valeur par défaut est de 2 secondes.
  • Trigger Size - Commence la réplication par lots lorsque cette taille limite est atteinte.

Ressources supplémentaires additional-resources

Pour plus d’informations sur la résolution des problèmes, vous pouvez lire la page Dépannage de la réplication.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2