Replicación replication
Los agentes de replicación son fundamentales para Adobe Experience Manager AEM (), ya que el mecanismo utilizado para lo siguiente:
- Contenido de Publish (activar) de autor a entorno de Publish.
- Vaciar explícitamente el contenido de la caché de Dispatcher.
- Devolver los datos introducidos por el usuario (por ejemplo, los datos de entrada de formulario) desde el entorno de Publish al entorno de Author (bajo el control del entorno de Author).
Las solicitudes están en cola para que las procese el agente apropiado.
Duplicación de Author en Publish replicating-from-author-to-publish
La replicación, en una instancia de Publish o Dispatcher, se realiza en varios pasos:
-
el autor solicita que se publique determinado contenido (activado); esto se puede iniciar mediante una solicitud manual o mediante déclencheur automáticos que se han preconfigurado.
-
la solicitud se pasa al agente de replicación predeterminado adecuado; un entorno puede tener varios agentes predeterminados que siempre están seleccionados para este tipo de acciones.
-
el agente de replicación "empaqueta" el contenido y lo coloca en la cola de replicación.
-
en la ficha Sitios web, el indicador de estado de color está establecido para las páginas individuales.
-
el contenido se elimina de la cola y se transporta al entorno de Publish mediante el protocolo configurado; normalmente es HTTP.
-
un servlet del entorno de Publish recibe la solicitud y publica el contenido recibido; el servlet predeterminado es
https://localhost:4503/bin/receive
. -
se pueden configurar varios entornos Author y Publish.
Duplicación de Publish a Autor replicating-from-publish-to-author
Algunas funciones permiten a los usuarios introducir datos en una instancia de Publish.
A veces, se necesita un tipo de replicación conocido como replicación inversa para devolver estos datos al entorno de Author desde el que se redistribuyen a otros entornos de Publish. Por motivos de seguridad, cualquier tráfico del entorno de Publish al de creación debe controlarse estrictamente.
La replicación inversa utiliza un agente en el entorno de Publish que hace referencia al entorno de Author. Este agente coloca los datos en una bandeja de salida. Esta bandeja de salida coincide con los oyentes de replicación en el entorno de creación. Los oyentes sondean las bandejas de salida para recopilar los datos introducidos y luego distribuirlos según sea necesario. Esto garantiza que el entorno de creación controle todo el tráfico.
En otros casos, como en el caso de las funciones de las comunidades (por ejemplo, foros, blogs, comentarios y revisiones), la cantidad de contenido generado por el usuario (UGC) que se introduce en el entorno de Publish AEM es difícil de sincronizar eficazmente entre instancias de mediante la replicación.
AEM Communities nunca usa la replicación para UGC. En su lugar, la implementación para Communities requiere un almacén común para UGC (consulte Almacenamiento de contenido de la comunidad).
Replicación: de forma predeterminada replication-out-of-the-box
AEM El sitio web de venta minorista web que se incluye en una instalación estándar de la distribución de datos se puede utilizar para ilustrar la replicación.
AEM Para seguir este ejemplo y utilizar los agentes de replicación predeterminados, instale el elemento de replicación de la aplicación {100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
- el entorno de creación en el puerto
4502
- el entorno de Publish en el puerto
4503
- Agentes en Autor : Agente predeterminado (publicar)
- Agentes en Autor : Agente de replicación inversa (publish_reverse)
- Agentes en Publish: replicación inversa (bandeja de salida)
Consulte Supervisión de los agentes de replicación.
Replicación (de autor a Publish) replication-author-to-publish
- Vaya a la página de asistencia técnica en el entorno de creación.
https://localhost:4502/content/we-retail/us/en/experience.html<pi>
- Edite la página para poder agregar texto nuevo.
- Activar página para poder publicar los cambios.
- Abra la página de asistencia en el entorno de Publish:
https://localhost:4503/content/we-retail/us/en/experience.html - Ahora puede ver los cambios introducidos en Autor.
Esta replicación se lleva a cabo desde el entorno de creación mediante:
- Agente predeterminado (publicar)
Este agente replica el contenido en la instancia predeterminada de Publish.
Se puede acceder a los detalles de esto (configuración y registros) desde la consola Herramientas del entorno de creación; o bien:https://localhost:4502/etc/replication/agents.author/publish.html
.
Agentes de replicación: predefinidos replication-agents-out-of-the-box
AEM Los siguientes agentes están disponibles en una instalación estándar de la:
-
Agente predeterminado
Se utiliza para replicar de Autor a Publish. -
Vaciado de Dispatcher
Se utiliza para administrar la caché de Dispatcher. Consulte Invalidación de la caché de Dispatcher desde el entorno de creación e Invalidación de la caché de Dispatcher desde una instancia de publicación para obtener más información. -
Replicación inversa
Se utiliza para replicar de Publish a Author. La replicación inversa no se utiliza para funciones de Communities, como foros, blogs y comentarios. Se desactiva de forma efectiva, ya que la bandeja de salida no está activada. El uso de la replicación inversa requeriría una configuración personalizada. -
Agente estático
Se trata de un "agente que almacena una representación estática de un nodo en el sistema de archivos".
Por ejemplo, con la configuración predeterminada, las páginas de contenido y los recursos DAM se almacenan en/tmp
, ya sea como HTML o en el formato de recurso adecuado. Consulte las fichasSettings
yRules
para obtener la configuración.
Esto se solicitó para que cuando la página se solicite directamente desde el servidor de aplicaciones, se pueda ver el contenido. Es un agente especializado y (probablemente) no es necesario en la mayoría de los casos.
Agentes de replicación: parámetros de configuración replication-agents-configuration-parameters
Al configurar un agente de replicación desde la consola Herramientas, hay cuatro pestañas disponibles en el cuadro de diálogo:
Ajustes settings
-
Nombre
Un nombre único para el agente de replicación.
-
Descripción
Una descripción del propósito que cumple este agente de replicación.
-
Habilitado
Indica si el agente de replicación está habilitado.
Cuando el agente está habilitado, la cola se muestra de la siguiente manera:
- Activo cuando los elementos se están procesando.
- Inactivo cuando la cola está vacía.
- Bloqueado cuando los elementos están en cola, pero no se pueden procesar; por ejemplo, cuando la cola de recepción está deshabilitada.
-
Tipo de serialización
El tipo de serialización:
- Predeterminado: establezca si el agente se va a seleccionar automáticamente.
- Vaciado de Dispatcher: seleccione esta opción si el agente se va a utilizar para vaciar la caché de Dispatcher.
-
Retraso de reintento
El retraso (tiempo de espera en milisegundos) entre dos reintentos, si se produce un problema.
Predeterminado:
60000
-
Id. de usuario agente
Según el entorno, el agente utiliza esta cuenta de usuario para:
- recopilar y empaquetar el contenido del entorno de creación;
- crear y escribir el contenido en el entorno de Publish
Deje este campo vacío para utilizar la cuenta de usuario del sistema (la cuenta definida en sling como usuario administrador; de forma predeterminada es
admin
).note caution CAUTION Para un agente en el entorno de creación, esta cuenta debe tener acceso de lectura a todas las rutas que desea replicar. note caution CAUTION Para un agente en el entorno de Publish, esta cuenta debe tener el acceso de creación y escritura necesario para replicar el contenido. note note NOTE Esto se puede utilizar como mecanismo para seleccionar contenido específico para la replicación. -
Nivel de registro
Especifica el nivel de detalle que se utilizará para los mensajes de registro.
Error
: solo se registran erroresInfo
: se registran errores, advertencias y otros mensajes informativosDebug
: se utiliza un alto nivel de detalle en los mensajes, principalmente con fines de depuración
Predeterminado:
Info
-
Usar para replicación inversa
Indica si este agente se utiliza para la replicación inversa; devuelve los datos introducidos por el usuario desde Publish al entorno de creación.
-
Actualización de alias
Al seleccionar esta opción, se habilitan las solicitudes de invalidación de alias o de rutas de vanidad en Dispatcher. Consulte también Configuración de un agente de vaciado de Dispatcher.
Transporte transport
-
URI
Esto especifica el servlet de recepción en la ubicación de destino. En particular, puede especificar el nombre de host (o alias) y la ruta de contexto a la instancia de destino aquí.
Por ejemplo:
- Un agente predeterminado puede replicarse en
https://localhost:4503/bin/receive
- Un agente de vaciado de Dispatcher puede replicarse en
https://localhost:8000/dispatcher/invalidate.cache
El protocolo especificado aquí (HTTP o HTTPS) determina el método de transporte.
Para los agentes de vaciado de Dispatcher, la propiedad URI solo se utiliza si utiliza entradas de host virtual basadas en rutas para diferenciar entre granjas, utilice este campo para dirigirse a la granja para invalidarla. Por ejemplo, la granja n.º 1 tiene un host virtual de
www.mysite.com/path1/*
y la granja n.º 2 lo tiene dewww.mysite.com/path2/*
. Puede usar una dirección URL de/path1/invalidate.cache
para dirigirse a la primera granja de servidores y/path2/invalidate.cache
para dirigirse a la segunda. - Un agente predeterminado puede replicarse en
-
Usuario
El nombre de usuario de la cuenta que se utilizará para acceder al destino.
-
Contraseña
Contraseña de la cuenta que se utilizará para acceder al destino.
-
Dominio NTLM
Dominio para autenticación NTML.
-
Host NTLM
Host para autenticación NTML.
-
Habilitar SSL relajado
Habilite esta opción si desea que se acepten certificados SSL de certificación propia.
-
Permitir certificados caducados
Habilite esta opción si desea que se acepten certificados SSL caducados.
Proxy proxy
La siguiente configuración solo es necesaria si se necesita un proxy:
-
Host Proxy
Nombre de host del proxy utilizado para el transporte.
-
Puerto Proxy
Puerto del proxy.
-
Usuario Proxy
El nombre de usuario de la cuenta que se va a utilizar.
-
Contraseña de proxy
Contraseña de la cuenta que se va a utilizar.
-
Dominio NTLM de proxy
El dominio NTLM de proxy.
-
Host NTLM de proxy
El dominio NTLM de proxy.
Ampliado extended
-
Interfaz
Aquí puede definir la interfaz de socket a la que desea enlazarse.
Esto establece la dirección local que se utilizará al crear conexiones. Si no se establece, se utiliza la dirección predeterminada. Esto resulta útil para especificar la interfaz que se va a utilizar en sistemas de hosts múltiples o agrupados.
-
Método HTTP
El método HTTP que se va a utilizar.
Para un agente de vaciado de Dispatcher, esto es casi siempre GET y no debe cambiarse (el POST sería otro valor posible).
-
Encabezados HTTP
Se utilizan para los agentes de vaciado de Dispatcher y especifican los elementos que se deben vaciar.
Para un agente de vaciado de Dispatcher, no debería ser necesario cambiar las tres entradas estándar:
CQ-Action:{action}
CQ-Handle:{path}
CQ-Path:{path}
Se utilizan, según corresponda, para indicar la acción que se utilizará al vaciar el controlador o la ruta de acceso. Los subparámetros son dinámicos:
-
{action}
indica una acción de replicación -
{path}
indica una ruta
Se sustituyen por la ruta/acción relevante para la solicitud y, por lo tanto, no necesitan estar "codificadas":
note note NOTE AEM Si ha instalado el contexto en un contexto distinto del predeterminado recomendado, debe registrar el contexto en los encabezados HTTP. Por ejemplo: CQ-Handle:/<*yourContext*>{path}
-
Cerrar conexión
Habilite para poder cerrar la conexión después de cada solicitud.
-
Tiempo de espera de conexión
Tiempo de espera (en milisegundos) que se aplicará al intentar establecer una conexión.
-
Tiempo de espera de socket
Tiempo de espera (en milisegundos) que se aplicará mientras se espera el tráfico una vez establecida la conexión.
-
Versión de protocolo
Versión del protocolo. Por ejemplo,
1.0
para HTTP/1.0.
Desencadenadores triggers
Esta configuración se utiliza para definir déclencheur para la replicación automatizada:
-
Ignorar predeterminado
Si se selecciona, el agente se excluye de la replicación predeterminada; esto significa que no se utiliza si un autor de contenido emite una acción de replicación.
-
En la modificación
Aquí se activa automáticamente una replicación por parte de este agente cuando se modifica una página. Se utiliza para agentes de vaciado de Dispatcher, pero también para la replicación inversa.
-
En distribución
Si se selecciona, el agente replicará automáticamente cualquier contenido que esté marcado para su distribución cuando se modifique.
-
Tiempo de activación/desactivación alcanzado
Esto déclencheur la replicación automática (para activar o desactivar una página según corresponda) cuando se producen los tiempos de activación o desactivación definidos para una página. Se utiliza principalmente para agentes de vaciado de Dispatcher.
-
Al recibir
Si se selecciona, las cadenas de agentes se replican cada vez que reciben eventos de replicación.
-
Sin actualización de estado
Cuando se selecciona, el agente no fuerza una actualización del estado de replicación.
-
Sin versiones
Cuando se selecciona, el agente no fuerza la creación de versiones de páginas activadas.
Configuración de los agentes de replicación configuring-your-replication-agents
Para obtener información acerca de cómo conectar agentes de replicación a la instancia de Publish mediante MSSL, vea Replicar mediante SSL mutuo.
Configuración de los agentes de replicación desde el entorno de creación configuring-your-replication-agents-from-the-author-environment
Desde la pestaña Herramientas del entorno de creación, puede configurar los agentes de replicación que residen en el entorno de creación (Agentes de autor) o en el entorno de Publish (Agentes de Publish). Los siguientes procedimientos ilustran la configuración de un agente para el entorno de creación, pero se pueden utilizar para ambos.
-
AEM Obtenga acceso a la ficha Herramientas en la sección de la.
-
Haga clic en Replicación (panel izquierdo para abrir la carpeta).
-
Haga doble clic en Agentes de autor (en el panel izquierdo o derecho).
-
Haga clic en el nombre del agente apropiado (que es un vínculo) para mostrar información detallada sobre ese agente.
-
Haga clic en Editar para que se abra el cuadro de diálogo de configuración:
-
Los valores proporcionados deberían ser suficientes para realizar una instalación predeterminada. Si realiza cambios, haga clic en Aceptar para guardarlos (consulte Agentes de replicación - Parámetros de configuración para obtener información sobre parámetros individuales).
admin
como usuario para las credenciales de transporte de los agentes de replicación predeterminados.Configuración de replicación inversa configuring-reverse-replication
La replicación inversa se utiliza para devolver el contenido de usuario generado en una instancia de Publish a una instancia de autor. Esto se utiliza comúnmente para funciones como encuestas y formularios de registro.
Por razones de seguridad, la mayoría de las topologías de red no permiten conexiones desde la "zona desmilitarizada" (una subred que expone los servicios externos a una red que no es de confianza, como Internet).
Dado que el entorno de Publish suele estar en la DMZ, para devolver el contenido al entorno de creación, la conexión debe iniciarse desde la instancia de autor. Esto se realiza con:
- una bandeja de salida en el entorno de Publish donde se coloca el contenido.
- un agente (publicar) en el entorno de creación que sondea periódicamente la bandeja de salida en busca de contenido nuevo.
Para ello, necesita lo siguiente:
Un agente de replicación inversa en el entorno de creación. Actúa como componente activo para recopilar información de la bandeja de salida en el entorno de Publish:
Si desea utilizar la replicación inversa, asegúrese de que este agente está activado.
Un agente de replicación inversa en el entorno de Publish (una bandeja de salida): el elemento pasivo que actúa como una "bandeja de salida". La entrada del usuario se coloca aquí, desde donde la recopila el agente en el entorno de creación.
Configuración de la replicación para varias instancias de Publish configuring-replication-for-multiple-publish-instances
Después de la instalación, ya hay un agente predeterminado configurado para la replicación de contenido en una instancia de Publish que se ejecuta en el puerto 4503 del localhost.
Para configurar la replicación de contenido para una instancia de Publish adicional, cree y configure un nuevo agente de replicación:
-
AEM Abra la ficha Herramientas en la barra de herramientas de la.
-
Seleccione Replicación y, a continuación, Agentes de autor en el panel izquierdo.
-
Seleccione Nuevo….
-
Establezca Title y Name, y después seleccione Agente de replicación.
-
Haga clic en Crear para crear el agente.
-
Haga doble clic en el nuevo elemento del agente para que se abra el panel de configuración.
-
Haga clic en Editar - se abre el cuadro de diálogo Configuración del agente - el Tipo de serialización ya está definido como Predeterminado, debe permanecer así.
-
En la ficha Configuración:
-
Activar Habilitado.
-
Escriba una descripción.
-
Establezca Retraso de reintento en
60000
. -
Deje Tipo de serialización como
Default
.
-
-
En la ficha Transporte:
-
Introduzca el URI requerido para la nueva instancia de Publish; por ejemplo,
https://localhost:4504/bin/receive
. -
Introduzca la cuenta de usuario específica de la dirección que se utiliza para la replicación.
-
Puede configurar otros parámetros según sea necesario.
-
-
-
Haga clic en OK.
A continuación, puede probar la operación actualizando y publicando una página en el entorno de Author.
Las actualizaciones aparecen en todas las instancias de Publish que se han configurado como anteriormente.
Si tiene algún problema, puede comprobar los registros en la instancia de autor. Según el nivel de detalle requerido, también puede establecer el Nivel de registro en Debug
mediante el cuadro de diálogo Configuración del agente, como se ha indicado anteriormente.
- Configure un agente de replicación para replicar en ese entorno de Publish.
- Configure una cuenta de usuario con los derechos de acceso necesarios para leer el contenido replicado en ese entorno de Publish específico.
- Asigne la cuenta de usuario como Id. de usuario del agente para el agente de replicación.
Configuración de un agente de vaciado de Dispatcher configuring-a-dispatcher-flush-agent
Los agentes predeterminados se incluyen en la instalación. Sin embargo, todavía se necesita una determinada configuración y lo mismo se aplica si está definiendo un nuevo agente:
-
AEM Abra la ficha Herramientas en la barra de herramientas de la.
-
Haga clic en Implementación.
-
Seleccione Replicación y luego Agentes en Publish.
-
Haga doble clic en el elemento Vaciado de Dispatcher para abrir la descripción general.
-
Haga clic en Editar - se abre el cuadro de diálogo Configuración del agente:
-
En la ficha Configuración:
-
Activar Habilitado.
-
Escriba una descripción.
-
Deje Serialization Type como
Dispatcher Flush
o configúrelo como tal si crea un agente. -
(opcional) Seleccione Actualización de alias para habilitar las solicitudes de invalidación de alias o rutas de vanidad en Dispatcher.
-
-
En la ficha Transporte:
-
Introduzca el URI requerido para la nueva instancia de Publish; por ejemplo,
https://localhost:80/dispatcher/invalidate.cache
. -
Introduzca la cuenta de usuario específica de la dirección que se utiliza para la replicación.
-
Puede configurar otros parámetros según sea necesario.
-
Para los agentes de vaciado de Dispatcher, la propiedad URI solo se utiliza si utiliza entradas de host virtual basadas en rutas para diferenciar entre granjas, utilice este campo para dirigirse a la granja para invalidarla. Por ejemplo, la granja n.º 1 tiene un host virtual de
www.mysite.com/path1/*
y la granja n.º 2 lo tiene dewww.mysite.com/path2/*
. Puede usar una dirección URL de/path1/invalidate.cache
para dirigirse a la primera granja de servidores y/path2/invalidate.cache
para dirigirse a la segunda.note note NOTE AEM Si ha instalado la en un contexto distinto del contexto predeterminado recomendado, configure Encabezados HTTP en la ficha Extendido. -
-
Haga clic en OK.
-
Vuelva a la ficha Herramientas, desde donde puede Activar el agente Vaciado de Dispatcher (Agentes en Publish).
El agente de replicación Dispatcher Flush no está activo en Author. Puede acceder a la misma página en el entorno de Publish utilizando el URI equivalente; por ejemplo, https://localhost:4503/etc/replication/agents.publish/flush.html
.
Control del acceso a los agentes de replicación controlling-access-to-replication-agents
El acceso a las páginas utilizadas para configurar los agentes de replicación se puede controlar mediante permisos de página de usuario o grupo en el nodo etc/replication
.
Configuración de los agentes de replicación desde el CRXDE Lite configuring-your-replication-agents-from-crxde-lite
/etc/replication
. Esto es necesario para que las ACL asociadas se gestionen correctamente. La creación de un agente de replicación en otra ubicación del árbol puede dar lugar a un acceso no autorizado.Se pueden configurar varios parámetros de los agentes de replicación mediante el CRXDE Lite.
Si se desplaza a /etc/replication
, podrá ver los tres nodos siguientes:
agents.author
agents.publish
treeactivation
Los dos agents
contienen información de configuración sobre el entorno apropiado y solo están activos cuando ese entorno se está ejecutando. Por ejemplo, agents.publish
solo se usa en el entorno de Publish. La siguiente captura de pantalla muestra el agente de Publish AEM en el entorno de creación, tal como se incluye con WCM de la versión de:
Supervisión de los agentes de replicación monitoring-your-replication-agents
Para supervisar un agente de replicación:
-
AEM Obtenga acceso a la ficha Herramientas en la sección de la.
-
Haga clic en Replicación.
-
Haga doble clic en el vínculo a los agentes para el entorno adecuado (el panel izquierdo o el derecho). Por ejemplo, agentes en Autor.
La ventana resultante muestra una descripción general de todos los agentes de replicación para el entorno de creación, incluidos su destino y estado.
-
Haga clic en el nombre del agente apropiado (que es un vínculo) para mostrar información detallada sobre ese agente:
Aquí puede hacer lo siguiente:
-
Compruebe si el agente está activado.
-
Consulte el objetivo de cualquier replicación.
-
Ver si la cola de replicación está activa (habilitada).
-
Ver si hay algún elemento en la cola.
-
Actualizar o Borrar para actualizar la visualización de las entradas de la cola. Esto le ayuda a ver que los elementos entran y salen de la cola.
-
Ver registro para acceder al registro de cualquier acción por parte del agente de replicación.
-
Probar conexión a la instancia de destino.
-
Forzar reintento en cualquier elemento en cola, si es necesario.
note caution CAUTION No utilice el vínculo "Probar conexión" para la bandeja de salida de replicación inversa en una instancia de Publish. Si se realiza una prueba de replicación para una cola de Bandeja de salida, los elementos anteriores a la replicación de prueba se vuelven a procesar con cada replicación inversa. Si estos elementos existen en cola, se pueden encontrar con la siguiente consulta JCR XPath y deben eliminarse. /jcr:root/var/replication/outbox//*[@cq:repActionType='TEST']
-
Replicación por lotes batch-replication
La replicación por lotes no replica páginas o recursos individuales, pero espera a que se active el primer umbral de los dos, según el tiempo o el tamaño.
A continuación, empaqueta todos los elementos de replicación en un paquete, que después se replica como un solo archivo en el publicador.
El publicador desempaqueta todos los elementos, los guarda y vuelve a informar al creador.
Configuración de replicación por lotes configuring-batch-replication
- Vaya a
http://serveraddress:serverport/siteadmin
- Presione el icono Herramientas en la parte superior de la pantalla
- Desde el carril de navegación del lado izquierdo, vaya a Replicación: agentes en Autor y haga doble clic en Agente predeterminado.
- También puede acceder al agente de replicación de Publish predeterminado accediendo directamente a
http://serveraddress:serverport/etc/replication/agents.author/publish.html
- También puede acceder al agente de replicación de Publish predeterminado accediendo directamente a
- Presione el botón Editar situado sobre la cola de replicación.
- En la siguiente ventana, vaya a la ficha Lote:
- Configure el agente.
Parámetros parameters
Enable Batch Mode
: habilita o deshabilita el modo de replicación por lotesMax Wait Time
: tiempo de espera máximo hasta que se inicie una solicitud de lote, en segundos. El valor predeterminado es 2 segundos.Trigger Size
: inicia la replicación por lotes cuando se alcanza este límite de tamaño
Recursos adicionales additional-resources
Para obtener más información sobre la solución de problemas, lea la página Solución de problemas de replicación.