DocumentaciónAEM 6.4Guía de implementación

Solución de problemas de replicación troubleshooting-replication

Last update: Fri May 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Developer
CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

Esta página proporciona información sobre cómo solucionar problemas de replicación.

Problema problem

La replicación (replicación no inversa) está fallando por alguna razón.

Resolución resolution

Hay varias razones para que la replicación falle. Este artículo explica el enfoque que se podría tomar al analizar estos problemas.

¿Se activan las réplicas al hacer clic en el botón Activar? Si NO, haga lo siguiente:

  1. Vaya a /crx/explorer (CQ5.5) e inicie sesión como administrador.
  2. Abrir "Explorador de contenido"
  3. Compruebe si existe un nodo /bin/replicate o /bin/replicate.json. Si el nodo existe, elimínelo y guárdelo.

¿Las réplicas se ponen en cola en las colas del agente de replicación?

Para comprobar esto, vaya a /etc/replication/agents.author.html y haga clic en los agentes de replicación para comprobarlo.

Si hay una cola de agente o unas pocas colas de agente atascadas:

  1. ¿Se muestra la cola? bloqueado estado? Si es así, ¿la instancia de publicación no se está ejecutando o no responde completamente? Compruebe la instancia de publicación para ver qué le sucede (es decir, compruebe los registros y vea si hay un error OutOfMemory o algún otro problema). Entonces, si suele ser lento, tome volcados de subprocesos y analícelos.

  2. ¿Se muestra el estado de la cola? La cola está activa - # pendiente? Básicamente, el trabajo de replicación podría atascarse en una lectura de socket esperando a que responda la instancia pública o Dispatcher. Esto podría significar que la instancia de publicación o Dispatcher está bajo carga alta o atascada en un bloqueo. Tome volcados de subprocesos del autor y publíquelos en este caso.

    • Abra los volcados de subprocesos del autor en un analizador de volcado de subprocesos, compruebe si muestra que el trabajo de eventos de sling del agente de replicación está atascado en un socketRead.
    • Abra los volcados de subprocesos de publicación en un analizador de volcados de subprocesos, analice qué podría estar causando que la instancia de publicación no responda. Debería ver un subproceso con el POST /bin/receive en su nombre, que es el subproceso que recibe la replicación del autor.

Si todas las colas del agente están atascadas

  1. Es posible que cierto contenido no se pueda serializar en /var/replication/data debido a la corrupción del repositorio o a algún otro problema. Consulte logs/error.log para ver si hay algún error relacionado. Para borrar el elemento de replicación incorrecto, haga lo siguiente:

    1. Vaya a https://<host>:<port>/crx e inicie sesión como usuario administrador. En CQ5.5 vaya a https://<host>:<port>/crx/explorer en su lugar.
    2. Haga clic en "Explorador de contenido".
    3. En la ventana "Explorador de contenido" haga clic en el botón de lupa en la parte superior derecha de la ventana y aparecerá un cuadro de diálogo de búsqueda.
    4. Seleccione el botón de opción "XPath".
    5. En el cuadro "Consulta", introduzca esta consulta /jcr:root/var/eventing/jobs//element(*,slingevent:Job) ordenada por @slingevent:created
    6. Haga clic en Buscar
    7. En los resultados, los elementos principales son los últimos trabajos de eventos de sling. Haga clic en cada una de ellas y busque las réplicas atascadas que coinciden con lo que aparece en la parte superior de la cola.

  2. Puede haber algún problema con las colas de trabajos del marco de eventos de sling. Intente reiniciar el paquete org.apache.sling.event en /system/console.

  3. Puede ser que el procesamiento de trabajos esté completamente desactivado. Puede comprobarlo en la consola Felix en la ficha Evento de Sling. Compruebe si aparece: Evento Apache Sling (EL PROCESAMIENTO DE TRABAJO ESTÁ DESACTIVADO)

    • Si es así, en la pestaña Configuración de la Consola Felix, compruebe el gestor de eventos de trabajo Apache Sling. Puede ser que la casilla de verificación "Procesamiento de trabajos habilitado" esté desmarcada. Si está marcado y sigue mostrando que el procesamiento del trabajo está desactivado, compruebe si hay alguna superposición en /apps/system/config que esté desactivando el procesamiento del trabajo. Intente crear un nodo osgi:config para jobmanager.enabled con un valor booleano como true y vuelva a comprobar si la activación se inició y no hay más trabajos en cola.

  4. También puede ocurrir que la configuración de DefaultJobManager entre en un estado incoherente. Esto puede suceder cuando alguien modifica manualmente la configuración del controlador de eventos de trabajo Apache Sling a través de OSGiconsole (Por ejemplo, deshabilitar y volver a habilitar la propiedad "Procesamiento de trabajos habilitado" y Guardar la configuración).

    • En este punto, la configuración de DefaultJobManager que se almacena en crx-quickstart/launchpad/config/org/apache/sling/event/impl/jobs/DefaultJobManager.config obtiene un estado incoherente. Y aunque la propiedad 'Apache Sling Job Event Handler' muestra que 'Job Processing Enabled' está en estado comprobado, cuando uno navega a la pestaña Sling Event , muestra el mensaje - JOB PROCESSING IS DISABLED y la replicación no funciona.
    • Para resolver este problema, sería necesario navegar a la página Configuración de la consola OSGi y eliminar la configuración 'Controlador de eventos de trabajo Apache Sling'. A continuación, reinicie el nodo maestro del clúster para volver a obtener la configuración en un estado coherente. Esto debería solucionar el problema y la replicación empezará a funcionar de nuevo.

Crear un replication.log

A veces puede resultar muy útil configurar todos los registros de replicación para que se añadan en un archivo de registro independiente a nivel de depuración. Para ello, haga lo siguiente:

  1. Vaya a https://host:port/system/console/configMgr e inicie sesión como administrador.

  2. Busque la fábrica Apache Sling Logging Logger y cree una instancia haciendo clic en el botón + a la derecha de la configuración de fábrica. Esto creará un nuevo registrador de registros.

  3. Establezca la configuración de esta manera:

    • Nivel de registro: DEBUG
    • Ruta del archivo de registro: (CQ5.4 y 5.3) …/logs/replication.log (CQ5.5) logs/replication.log
    • Categorías: com.day.cq.replication

  4. Si sospecha que el problema está relacionado con eventos/trabajos de sling de alguna manera, también puede agregar este paquete java en categorías:org.apache.sling.event

Poner en pausa la cola del agente de replicación pausing-replication-agent-queue

En algún momento puede ser adecuado pausar la cola de replicación para reducir la carga en el sistema de creación, sin desactivarla. Actualmente, esto solo es posible si se configura temporalmente un puerto no válido. A partir de la versión 5.4, puede ver el botón de pausa en la cola del agente de replicación que tiene alguna limitación

  1. El estado no se mantiene, lo que significa que si reinicia un servidor o el paquete de replicación se recicla, vuelve al estado de ejecución.
  2. La pausa está inactiva durante un período más breve (OOB 1 hora después de que no haya actividades con replicación de otros subprocesos) y no durante más tiempo. Porque existe una función en sling que evita subprocesos inactivos. Básicamente, compruebe si un subproceso de cola de trabajos ha estado sin utilizar durante más tiempo, si es así que inicia ciclos de limpieza. Debido al ciclo de limpieza, detiene el subproceso y, por lo tanto, se pierde la configuración pausada. Dado que los trabajos se mantienen, inicia un nuevo subproceso para procesar la cola que no tiene detalles de la configuración pausada. Debido a esto, la cola se convierte en estado de ejecución.

Los permisos de página no se replican al activar el usuario page-permissions-are-not-replicated-on-user-activation

Los permisos de página no se replican porque se almacenan bajo los nodos a los que se concede acceso, no con el usuario.

En general, los permisos de página no se deben replicar del autor para su publicación y no se deben realizar de forma predeterminada. Esto se debe a que los derechos de acceso deben ser diferentes en esos dos entornos. Por lo tanto, se recomienda configurar las ACL en la publicación por separado del autor.

Cola de replicación bloqueada al replicar información de espacio de nombres de Autor a Publicación replication-queue-blocked-when-replicating-namespace-information-from-author-to-publish

En algunos casos, la cola de replicación está bloqueada al intentar replicar la información del área de nombres de la instancia de autor en la instancia de publicación. Esto sucede porque el usuario de replicación no tiene jcr:namespaceManagement . Para evitar este problema, asegúrese de que:

  • El usuario de replicación (según la configuración de la sección Transporte tab>Usuario) también existe en la instancia Publicar.
  • El usuario tiene privilegios de lectura y escritura en la ruta de acceso donde está instalado el contenido.
  • El usuario tiene jcr:namespaceManagement en el nivel del repositorio. Puede conceder el privilegio de la siguiente manera:
  1. Inicie sesión en CRX/DE ( http://localhost:4502/crx/de/index.jsp) como administrador.
  2. Haga clic en el Control de acceso pestaña .
  3. Select Repositorio.
  4. Haga clic en Agregar entrada (el icono de signo más).
  5. Introduzca el nombre del usuario.
  6. Select jcr:namespaceManagement de la lista de privilegios.
  7. Haga clic en Aceptar.
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56