DocumentaciónAEMGuía de AEM Screens

Configuración de instancias de autor y Publish en AEM Screens configuring-author-and-publish-in-aem-screens

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Usuario

En esta página se destacan los siguientes temas:

  • Configuración de instancias de autor y Publish
  • Configurando la topología de Publish
  • Administración de publicaciones: entrega de actualizaciones de contenido de Autor a Publish en el dispositivo

Requisitos previos prerequisites

Antes de empezar a usar los servidores de Author y Publish, debe tener conocimientos previos de lo siguiente:

  • AEM Topología de la
  • Creación y administración de un proyecto de AEM Screens
  • Proceso de registro de dispositivo
NOTE
Esta funcionalidad de AEM Screens AEM solo está disponible si ha instalado el paquete de funciones 2 de Screens de la versión 6.4 de. Para obtener acceso a este paquete de funciones, póngase en contacto con el Soporte técnico de Adobe y solicite acceso. Una vez que tenga permiso, puede descargarlo desde Package Share.
IMPORTANT
Si desea utilizar más de una instancia de Publish con Dispatcher, actualice Dispatcher. Consulte Habilitación de sesiones duraderas.

Configuración de instancias de autor y Publish configuring-author-and-publish-instances

NOTE
Para obtener más información acerca de la descripción general de la arquitectura de Autor y Publish AEM y cómo se crea el contenido en una instancia de Autor de y, a continuación, se replica mediante reenvío en varias instancias de Publish, consulte Descripción general de la arquitectura de Autor y Publish.

En la siguiente sección se explica cómo configurar agentes de replicación en las topologías Autor y Publish.

Puede configurar un ejemplo sencillo, en el que aloje una instancia de autor y dos de Publish:

  • Autor > localhost:4502
  • Publish 1 (pub1) > localhost:4503
  • Publish 2 (pub2) > localhost:4504

Configuración de agentes de replicación en Autor setting-replication-agents

Para crear agentes de replicación, aprenda a crear un agente de replicación estándar.

Hay tres agentes de replicación necesarios para Screens:

  1. Agente de replicación predeterminado ​(especificado como​** agente de replicación estándar**)
  2. Agente de replicación de Screens
  3. Agente de replicación inversa

Paso 1: Creación de un Agente de Replicación por Defecto step-creating-a-default-replication-agent

Siga los pasos a continuación para crear un agente de replicación predeterminado:

  1. AEM Vaya a la instancia de la > icono de martillo > Operaciones > Configuración.

    screen_shot_2019-02-25at24621pm

  2. Haga clic en Replicación en el árbol de navegación izquierdo.

    screen_shot_2019-02-25at24715pm

  3. Haga clic en Agentes de autor de la carpeta Replicación y haga clic en Nuevo para crear un nuevo agente de replicación estándar.

    screen_shot_2019-02-25at25400pm

  4. Escriba Title y Name para poder crear el agente de replicación y, a continuación, haga clic en Crear.

    screen_shot_2019-02-25at25737pm

  5. Haga clic con el botón derecho en el agente de replicación y haga clic en Abrir para editar la configuración.

    screen_shot_2019-02-25at30018pm

  6. Haga clic en Editar.

  7. En el cuadro de diálogo Configuración del agente, escriba los detalles.

    note note
    NOTE
    El usuario debe marcar Enabled para habilitar el agente de replicación. Marque esta opción en Agentes predeterminados, de Screens y de replicación inversa.

    screen_shot_2019-02-25at30134pm

  8. Vaya a la pestaña Transporte e introduzca el URI, Usuario y Contraseña.

    screen_shot_2019-03-04at34955pm

    note note
    NOTE
    También puede copiar y cambiar el nombre de un agente de replicación predeterminado existente.

Creación de agentes de replicación estándar creating-standard-replication-agents

  1. Cree un agente de replicación estándar para pub1 (ya debe estar configurado un agente predeterminado). Por ejemplo, https://<hostname>:4503/bin/receive?sling:authRequestLogin=1
  2. Cree un agente de replicación estándar para pub2. Puede copiar como agente de replicación para pub1 y actualizar el transporte que se utilizará para pub2 cambiando el puerto en la configuración de transporte. Por ejemplo, https://<hostname>:4504/bin/receive?sling:authRequestLogin=1.

Creación de agentes de replicación de Screens creating-screens-replication-agents

  1. Cree un agente de replicación de AEM Screens para pub1. De forma predeterminada, hay un agente de replicación de Screens denominado que señala al puerto 4503. Actívelo.

  2. Cree un agente de replicación de AEM Screens para pub2. Copie el agente de replicación de Screens para pub1 y cambie el puerto a 4504 para pub2.

    note note
    NOTE
    Para obtener información sobre cómo configurar los agentes de replicación de Screens, consulte Configuración del agente de replicación de Screens.

Creación de agentes de replicación inversa de Screens creating-screens-reverse-replication-agents

  1. Cree un agente de replicación inversa para pub1.
  2. Cree un agente de replicación inversa para pub2. Puede copiar el agente de replicación inversa para pub1 y actualizar el transporte que se utilizará para pub2 cambiando el puerto en la configuración de transporte.

Configuración de la topología de Publish setting-up-publish-topology

Paso 1: Configuración de Apache Sling Oak-Based Discovery step-configure-apache-sling-oak-based-discovery

Configure el descubrimiento basado en Oak de Apache Sling para todas las instancias de Publish de la topología

Para cada instancia de Publish:

  1. Navegue hasta https://<host>:<port>/system/console/configMgr

  2. Haga clic en Configuración del servicio de detección basado en Apache Sling Oak.

  3. Actualizar URL del conector de topología: añada las URL de todas las instancias de Publish participantes que sean:

    • https://publish:4503/libs/sling/topology/connector
    • https://publish:4504/libs/sling/topology/connector

  4. Lista del conector de topología Whitelist: adapte a direcciones IP o subredes que cubran todas las instancias de Publish. Asegúrese de whitelist la IP/nombre de host de todas las instancias de Publish sin el número de puerto.

  5. Habilitar Bucles locales de detención automática

La configuración debe ser idéntica para cada instancia de Publish y el bucle local de parada automática evita un bucle infinito.

Paso 2: Verificar La Topología De Publish step-verify-publish-topology

Para cualquiera de las instancias de Publish, vaya a https://:/system/console/topology. Debería ver cada instancia de Publish representada en la topología en Conectores de topología de salida.

Paso 3: Configuración del clúster de ActiveMQ Artemis step-setup-activemq-artemis-cluster

Este paso le permite crear una contraseña cifrada para el clúster de ActiveMQ Artemis.
El usuario y la contraseña de clúster de todas las instancias de Publish de la topología deben ser idénticos. La contraseña de la configuración de ActiveMQ Artemis debe estar cifrada. Dado que cada instancia tiene su propia clave de cifrado, es necesario utilizar la compatibilidad con cifrado para crear una cadena de contraseña cifrada. A continuación, la contraseña cifrada se puede utilizar en la configuración OSGi para ActiveMQ.

En cada instancia de Publish:

  1. En la consola OSGi, vaya a MAIN > Crypto Support (https://<host>:<port>/system/console/crypto).
  2. Escriba la contraseña de texto sin formato que desee (la misma para todas las instancias) en Texto sin formato
  3. Haga clic en Protect.
  4. Copie el valor Texto protegido en un bloc de notas o editor de texto. Este valor se puede utilizar en la configuración OSGi para ActiveMQ.

Dado que cada instancia de Publish tiene, de forma predeterminada, claves criptográficas únicas, realice este paso en cada instancia de pub y guarde la clave única para la siguiente configuración.

NOTE
La contraseña debe comenzar y finalizar con llaves. Por ejemplo:
{1ec346330f1c26b5c48255084c3b7272a5e85260322edd59119828d1fa0a610e}

Paso 4: Activar el clúster de ActiveMQ Artemis step-activate-activemq-artemis-cluster

En cada instancia de publicación:

  1. Vaya al Administrador de configuración OSGi https://<host>:<port>/system/console/configMgr

  2. Haga clic en Apache ActiveMQ Artemis JMS Provider Configuración

  3. Actualice lo siguiente:

    • Contraseña de clúster: use el valor cifrado del paso anterior por cada instancia respectiva
    • Temas: {name: 'commands', address: 'com.adobe.cq.screens.commands', maxConsumers: 50}

Comprobar clúster de elementos ActiveMQ verify-activemq-artemis-cluster

Siga los pasos a continuación para cada instancia de Publish:

  1. Vaya a la consola OSGi > Principal > Elementos de ActiveMQ https://localhost:4505/system/console/mq.

  2. Compruebe y marque para ver los puertos de otras instancias en Información de clúster > Topología > nodes=2, members=2.

  3. Enviar un mensaje de prueba (parte superior de la pantalla en Información de Broker)

  4. Introduzca los siguientes cambios en los campos:

    1. Destino: /com.adobe.cq.screens/devTestTopic
    2. Texto: Hello World
    3. Vea el error.log de cada instancia para poder ver que el mensaje se envió y recibió en todo el clúster.
NOTE
La navegación a la consola OSGi puede tardar unos segundos después de guardar la configuración en el paso anterior. También puede comprobar el error.log para obtener más detalles.

Por ejemplo, la siguiente imagen se muestra si la configuración de ActiveMQ Artemis Server se ha realizado correctamente.

Si no ve la siguiente configuración de /system/console/mq, vaya a /system/console/mq y haga clic en Reiniciar para reiniciar el agente.

image-2018-06-18-18-14-55-449

Quitar requisito de encabezado de referente remove-referrer-header-requirement

Siga los pasos de cada instancia de Publish:

  1. Vaya a la consola OSGi > Administrador de configuración
  2. Haga clic en Filtro de referente de Apache Sling
  3. Actualizar configuración y comprobar Permitir vaciado

Configuración del autor y la instancia de Publish configuring-author-and-publish-instance

Una vez configurada la topología de publicación, configure las instancias de autor y Publish para ver los resultados prácticos de la implementación:

NOTE
Requisitos previos
Para empezar con este ejemplo, cree un proyecto de AEM Screens seguido de la creación de una ubicación, una visualización y un canal en el proyecto. Añada contenido al canal y asigne el canal a una pantalla.

Paso 1: Inicio de un reproductor de AEM Screens (dispositivo)

  1. Inicie una ventana independiente del explorador.
  2. Vaya al reproductor de Screens con el explorador web, es decirhttps://localhost:4502/content/mobileapps/cq-screens-player/firmware.html, o inicie la aplicación de AEM Screens. Cuando abra el dispositivo, observe que su estado no está registrado.
NOTE
Puede abrir un Reproductor de AEM Screens con la aplicación de AEM Screens que descargó o con el explorador web.

Paso 2: Registro de un dispositivo en Autor step-registering-a-device-on-author

  1. Vaya a https://localhost:4502/screens.html/content/screens/we-retail o haga clic en el proyecto y vaya a Dispositivos > Administrador de dispositivos.
  2. Haga clic en Registrar dispositivo.
  3. Haga clic en Registro de dispositivo.
  4. Haga clic en el dispositivo que desea registrar y, a continuación, haga clic en Registrar dispositivo.
  5. Compruebe el código de registro y, a continuación, haga clic en Validar.
  6. Escribe un título para el dispositivo y haz clic en Registrar.

Paso 3: Asignar el dispositivo a mostrar step-assigning-the-device-to-display

  1. Haga clic en Asignar pantalla en el cuadro de diálogo del paso anterior.
  2. Haga clic en la ruta de visualización del canal desde la carpeta Ubicaciones.
  3. Haga clic en Asignar.
  4. Haga clic en Finalizar para completar el proceso y ahora se asignará el dispositivo.

Compruebe el reproductor y observe el contenido que ha agregado en el canal.

Paso 4: Publicar la configuración del dispositivo en instancias de Publish step-publishing-device-configuration-to-publish-instances

Comprobando el dispositivo

Siga los pasos a continuación para replicar el usuario del dispositivo:

  1. Navegue hasta la página de administración de usuarios. Por ejemplo, https://localhost:4502/useradmin.
  2. Busque el grupo screens-devices-master.
  3. Haga clic con el botón derecho en el grupo y haga clic en Activar.
CAUTION
No active author-publish-screens-service porque es un usuario del sistema utilizado por el trabajo de autor.

También puede activar el dispositivo desde la Consola de administración de dispositivos. Complete los siguientes pasos:

  1. Vaya a su proyecto de Screens > Dispositivos.
  2. Haga clic en Administrador de dispositivos en la barra de acciones.
  3. Haga clic en el dispositivo y luego en Activar en la barra de acciones, como se muestra en la figura siguiente.

screen_shot_2019-02-21at111036am

NOTE
Como alternativa, una vez activado el dispositivo, también puede editar o actualizar la URL del servidor. En la barra de acciones, haga clic en Editar URL del servidor, como se muestra en la figura siguiente. Los cambios se propagarán al Reproductor de AEM Screens.

screen_shot_2019-02-21at105527am

Publicando lista de comprobación publishing-check-list

Los siguientes puntos resumen la lista de comprobación de publicación:

  • Usuario de dispositivo Screens AEM: esta información se almacena como usuario de la red y se puede activar desde Herramientas > Seguridad > Usuarios. Al usuario se le agrega el prefijo "screens" con una cadena serializada larga.

  • Proyecto - El proyecto de AEM Screens.

  • Ubicación - Ubicación a la que está conectado el dispositivo.

  • Canales: uno o más canales que se están mostrando en la ubicación.

  • Programación: si utiliza una programación, asegúrese de que se publique.

  • Ubicación, horarios y carpeta del canal: si los recursos correspondientes están dentro de una carpeta.

Siga los pasos a continuación para verificar el comportamiento de creación y publicación:

  1. Actualizar parte del contenido del canal en la instancia de autor.
  2. Realice Administrar publicación para publicar nuevos cambios en todas las instancias de Publish.
  3. Pulse Activar para activar el dispositivo desde el Administrador de dispositivos.
  4. Seleccione Editar URL de la URL de instancia de autor a una de las URL de instancias de publicación.
  5. Compruebe que el contenido actualizado del canal se muestra en el reproductor de AEM Screens.
  6. Repita estos pasos con una instancia de Publish diferente.

Paso 5: Apuntar el dispositivo a la instancia de Publish en el panel de administración step-pointing-the-device-to-publish-instance-in-the-admin-panel

  1. Vea la interfaz de usuario de administración desde el reproductor de Screens; mantenga pulsada la esquina superior izquierda para poder abrir el menú Administración, en el reproductor de AEM Screens táctil o con un ratón.
  2. Haga clic en la opción Configuración en el panel lateral.
  3. Cambie la instancia de autor a la instancia de Publish en Server.

Vea los cambios en el Reproductor de AEM Screens.

También puede actualizar o editar la URL del servidor desde la consola de administración de dispositivos, para hacerlo, siga estos pasos:

  1. Vaya al proyecto de AEM Screens y haga clic en la carpeta Dispositivos.
  2. Haga clic en Administrador de dispositivos en la barra de acciones.
  3. Haga clic en el dispositivo y, a continuación, en la barra de acciones, haga clic en Editar URL del servidor, como se muestra en la figura siguiente. Los cambios se propagarán al Reproductor de AEM Screens.

screen_shot_2019-02-07at31028pm

La función Administrar publicación le permite enviar actualizaciones de contenido de Autor a Publish en el dispositivo. Puede publicar/cancelar la publicación del contenido de todo el proyecto de AEM Screens o solo de uno de los canales, la ubicación, el dispositivo, la aplicación o una programación. Para obtener más información acerca de esta característica, consulte Actualización de contenido bajo demanda.

Sugerencias de resolución de problemas troubleshoot-tips

Siga la sección siguiente para obtener respuestas a las preguntas frecuentes relacionadas con la configuración de Autor/Publish.

Cómo añadir un Redireccionamiento de https a http después del registro inicial y la asignación? add-redirect

Solución
Establezca Habilitar Proxy/Load Balancer Connection in the Jetty configuration en true.

¿Cómo actualizar el contenido sin conexión y los problemas de descarga del reproductor con los recursos fuera de /content/dam/projects/<project>? update-offline-content

Solución
Asigne permisos de lectura para el usuario de servicio de actualización sin conexión masiva y el grupo screens-devices-master para todos los /content/dam o los recursos específicos que desee utilizar, si desea que sean más restrictivos.

¿Cómo se resuelven los errores del Agente de replicación de Screens? replication-agent

Solución
Asegúrese de que no ha marcado la opción Usar para replicación inversa en la configuración del agente. El agente de replicación de Screens no se puede usar como agente de replicación inversa y el ámbito de esta función es reenviar comandos de dispositivo de Autor a Publish.

recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053