DocumentaciónAEM 6.5Guía del usuario

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

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Administrador

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

Problema problem

La replicación (replicación no inversa) da error por algún motivo.

Resolución resolution

Existen varias razones para que la replicación falle. Este artículo explica el enfoque que se puede seguir al analizar estos problemas.

¿Se están activando las replicaciones al hacer clic en el botón Activar? Si NO, haga lo siguiente:

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

¿Se están poniendo en cola las replicaciones 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.

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

  1. ¿Muestra la cola el estado bloqueado? Si es así, ¿la instancia de publicación no se está ejecutando o no responde? 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. Si solo es lento, tome volcados de hilos y analícelos.

  2. ¿Muestra el estado de la cola La cola está activa - N.º pendiente? Básicamente, el trabajo de replicación se podía quedar atascado en una lectura de socket esperando a que la instancia de publicación o Dispatcher respondieran. Esto puede significar que la instancia de publicación o Dispatcher está bajo carga alta o atascada en un bloqueo. Tome los volcados de hilos del autor y publíquelos en este caso.

    • Abra los volcados de hilos del autor en un analizador de volcado de hilos y compruebe si muestra que el trabajo de evento de sling del agente de replicación está atascado en un socketRead.
    • Abra los volcados de hilos de la publicación en un analizador de volcado de hilos y 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 bloqueadas

  1. Es posible que un fragmento de contenido determinado no se pueda serializar en /var/replication/data debido a que el repositorio está dañado o a algún otro problema. Compruebe si hay algún error relacionado en logs/error.log. Para borrar el elemento de replicación incorrecto, haga lo siguiente:

    1. Vaya a https://<host>:<port>/crx/de e inicie sesión como usuario administrador.
    2. Haga clic en "Herramientas" en el menú superior.
    3. Haga clic en el botón de lupa.
    4. Seleccione "XPath" como Tipo.
    5. En el cuadro "Consulta", escriba esta consulta /jcr:root/var/eventing/jobs/element(*,slingevent:Job) ordenar 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 coincidan 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 del trabajo esté desactivado. Puede comprobarlo en la Consola Felix, en la pestaña Evento de Sling. Compruebe si se muestra: Evento de Apache Sling (EL PROCESAMIENTO DEL TRABAJO ESTÁ DESHABILITADO)

    • Si es así, compruebe el controlador de eventos del trabajo Apache Sling en la pestaña Configuración en la consola Felix. Es posible que la casilla "Procesamiento de trabajos activado" esté desmarcada. Si está marcado y sigue mostrando que "el procesamiento del trabajo está deshabilitado", compruebe si hay alguna superposición en /apps/system/config que esté deshabilitando el procesamiento del trabajo. Intente crear un nodo osgi:config para jobmanager.enabled con un valor booleano en true y vuelva a comprobar si la activación se ha iniciado y no hay más trabajos en cola.

  4. También puede ocurrir que la configuración de DefaultJobManager pase a un estado incoherente. Esto puede suceder cuando alguien modifica manualmente la configuración del "Controlador de eventos de trabajos de Apache Sling" a través de la consola OSG (por ejemplo, deshabilita y vuelve a habilitar la propiedad "Procesamiento de trabajos habilitado" y guarda la configuración).

    • En este punto, la configuración de DefaultJobManager almacenada en crx-quickstart/launchpad/config/org/apache/sling/event/impl/jobs/DefaultJobManager.config entra en un estado incoherente. Y aunque la propiedad "Apache Sling Job Event Handler" muestra que "Procesamiento de trabajos activado" está en estado activado, cuando se navega a la pestaña Eventos de Sling, muestra el mensaje: EL PROCESAMIENTO DE TRABAJOS ESTÁ DESHABILITADO y la replicación no funciona.
    • Para resolver este problema, vaya a la página Configuración de la consola OSGi y elimine la configuración "Controlador de eventos del trabajo Apache Sling". A continuación, reinicie el nodo principal del clúster para volver a poner la configuración en un estado coherente. Esto debería solucionar el problema y la replicación volverá a funcionar.

Crear un archivo replication.log

A veces resulta útil configurar todos los registros de replicación para que se agreguen en un archivo de registro independiente en el nivel DEBUG. 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 del registrador de Apache Sling y cree una instancia haciendo clic en el botón + a la derecha de la configuración de fábrica. Esto crea un nuevo registrador.

  3. Establezca la configuración de esta manera:

    • Nivel de registro: DEPURAR
    • Ruta del archivo de registro: 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

Pausa de cola del agente de replicación pausing-replication-agent-queue

A veces puede ser adecuado pausar la cola de replicación para reducir la carga en el sistema de creación, sin deshabilitarla. Actualmente, esto solo es posible por un hackeo de la configuración temporal de 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 si tiene alguna limitación

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

Los permisos de la página no se replican en la activación del usuario page-permissions-are-not-replicated-on-user-activation

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

En general, los permisos de página no deben replicarse desde el autor a la publicación y no están disponibles de forma predeterminada. Esto se debe a que los derechos de acceso deben ser diferentes en esos dos entornos. Por lo tanto, Adobe recomienda configurar las ACL en la publicación, independientemente del autor.

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

A veces, la cola de replicación se bloquea al intentar replicar la información del área de nombres de la instancia de autor a la instancia de publicación. Esto sucede porque el usuario de replicación no tiene el privilegio jcr:namespaceManagement. Para evitar este problema, asegúrese de que:

  • El usuario de replicación (tal como se configuró en la ficha Transporte>Usuario) también existe en la instancia de Publish.
  • El usuario tiene privilegios de lectura y escritura en la ruta donde está instalado el contenido.
  • El usuario tiene el privilegio jcr:namespaceManagement en el nivel de repositorio. Puede otorgar el privilegio de la siguiente manera:
  1. Inicie sesión en CRX/DE (https://localhost:4502/crx/de/index.jsp) como administrador.
  2. Haga clic en la ficha Control de acceso.
  3. Seleccione Repositorio.
  4. Haga clic en Agregar entrada (el icono de signo más).
  5. Introduzca el nombre del usuario.
  6. Seleccione jcr:namespaceManagement de la lista de privilegios.
  7. Haga clic en OK.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2