DocumentationAEMGuide d’AEM Screens

Configuration des instances de création et de publication dans AEM Screens configuring-author-and-publish-in-aem-screens

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

Créé pour :

  • User

Cette page met l’accent sur les sujets suivants :

  • Configuration des instances de création et de publication
  • Configuration de la topologie de publication
  • Gestion de la publication : diffusion des mises à jour de contenu de l’auteur à la publication sur l’appareil

Prérequis prerequisites

Avant de commencer à utiliser les serveurs de création et de publication, vous devez connaître au préalable :

  • Topologie AEM
  • Création et gestion de projet AEM Screens
  • Processus d’enregistrement d’appareil
NOTE
Cette fonctionnalité d’AEM Screens n’est disponible que si vous avez installé AEM 6.4 Screens Feature Pack 2. Pour accéder à ce Feature Pack, contactez l’assistance Adobe et demandez l’accès. Une fois que vous disposez de l’autorisation, vous pouvez la télécharger à partir du partage de modules.
IMPORTANT
Si vous souhaitez utiliser plusieurs instances de publication avec Dispatcher, mettez à jour Dispatcher. Voir Activation des sessions persistantes.

Configuration des instances de création et de publication configuring-author-and-publish-instances

NOTE
Pour en savoir plus sur la présentation de l’architecture de création et de publication et sur la manière dont le contenu est créé sur une instance d’auteur AEM, puis répliqué par la suite sur plusieurs instances de publication, voir Présentation de l’architecture de création et de publication.

La section suivante explique comment configurer les agents de réplication sur la topologie de création et de publication.

Vous pouvez configurer un exemple simple dans lequel vous hébergez une instance d’auteur et deux instances de publication :

  • Auteur > localhost:4502
  • Publier 1 (pub1) > localhost:4503
  • Publier 2 (pub2) > localhost:4504

Configuration des agents de réplication en mode de création setting-replication-agents

Pour créer des agents de réplication, apprenez à créer un agent de réplication standard.

Trois agents de réplication sont nécessaires pour Screens :

  1. Agent de réplication par défaut ​(spécifié comme​** Agent de réplication standard**)
  2. Agent de réplication Screens
  3. Agent de réplication inverse

Étape 1 : création d’un agent de réplication par défaut step-creating-a-default-replication-agent

Pour créer un agent de réplication par défaut, procédez comme suit :

  1. Accédez à votre instance AEM > icône marteau > Opérations > Configuration.

    screen_shot_2019-02-25at24621pm

  2. Sélectionnez la Réplication dans l’arborescence de navigation de gauche.

    screen_shot_2019-02-25at24715pm

  3. Sélectionnez la variable Agents sur l’auteur de la Réplication et sélectionnez Nouveau pour créer un agent de réplication standard.

    screen_shot_2019-02-25at25400pm

  4. Saisissez le Titre et Nom pour créer l’agent de réplication, puis sélectionnez Créer.

    screen_shot_2019-02-25at25737pm

  5. Cliquez avec le bouton droit sur l’agent de réplication et sélectionnez Ouvrir pour modifier les paramètres.

    screen_shot_2019-02-25at30018pm

  6. Sélectionnez Modifier.

  7. Dans le Paramètres de l’agent , saisissez les détails.

    note note
    NOTE
    L’utilisateur doit vérifier Activé pour activer l’agent de réplication. Cochez cette option sur les agents de réplication par défaut, Screens et inverse.

    screen_shot_2019-02-25at30134pm

  8. Accédez au Transport et saisissez la variable URI, Utilisateur, et Password.

    screen_shot_2019-03-04at34955pm

    note note
    NOTE
    Vous pouvez également copier et renommer un agent de réplication par défaut existant.

Création d’agents de réplication standard creating-standard-replication-agents

  1. Créez un agent de réplication standard pour pub1 (l’agent par défaut prêt à l’emploi doit déjà être configuré). Par exemple, https://<hostname>:4503/bin/receive?sling:authRequestLogin=1.
  2. Créez un agent de réplication standard pour pub2. Vous pouvez copier l’agent de réplication pour pub1 et mettre à jour le transport à utiliser pour pub2 en modifiant le port dans la configuration du transport. Par exemple, https://<hostname>:4504/bin/receive?sling:authRequestLogin=1.

Création d’agents de réplication Screens creating-screens-replication-agents

  1. Créez un agent de réplication AEM Screens pour pub1. Par défaut, il existe un agent de réplication Screens qui pointe vers le port 4503. Activez-le.

  2. Créez un agent de réplication AEM Screens pour pub2. Copiez l’agent de réplication Screens pour pub1 et modifiez le port afin qu’il pointe sur 4504 pour pub2.

    note note
    NOTE
    Pour savoir comment configurer les agents de réplication Screens, voir Configuration des agents de réplication Screens.

Création d’agents de réplication inverse Screens creating-screens-reverse-replication-agents

  1. Créez un agent de réplication inverse pour pub1.
  2. Créez un agent de réplication inverse pour pub2. Vous pouvez copier l’agent de réplication inverse pour pub1 et mettre à jour le transport à utiliser pour pub2 en modifiant le port dans la configuration du transport.

Configuration de la topologie de publication setting-up-publish-topology

Étape 1 : configuration de la détection Apache Sling basée sur Oak step-configure-apache-sling-oak-based-discovery

Configurez la détection Apache Sling basée sur Oak pour toutes les instances de publication dans la topologie

Pour chaque instance de publication :

  1. Accédez à https://<host>:<port>/system/console/configMgr.

  2. Sélectionnez la Configuration du Service de détection Apache Sling basé sur Oak.

  3. Mettez à jour les URL du connecteur de topologie : ajoutez les URL de toutes les instances de publication participantes qui sont :

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

  4. Connecteur de topologie Whitelist Liste: s’adapter aux adresses IP ou aux sous-réseaux couvrant toutes les instances de publication. Vérifiez que whitelist l’adresse IP/nom d’hôte de toutes les instances de publication sans le numéro de port.

  5. Activez Arrêt automatique des boucles locales

La configuration doit être identique pour chaque instance de publication et l’arrêt automatique de la boucle locale empêche une boucle infinie.

Étape 2 : vérification de la topologie de publication step-verify-publish-topology

Pour toutes les instances de publication, accédez à https://:/system/console/topology. Chaque instance de publication doit être représentée dans la topologie sous Connecteurs de topologie sortants.

Étape 3 : configuration d’un cluster ActiveMQ Artemis step-setup-activemq-artemis-cluster

Cette étape vous permet de créer un mot de passe chiffré pour la grappe ActiveMQ Artemis.
L’utilisateur de grappe et le mot de passe de toutes les instances de publication de la topologie doivent être identiques. Le mot de passe de la configuration ActiveMQ Artemis doit être chiffré. Chaque instance ayant sa propre clé de chiffrement, il est nécessaire d’utiliser la prise en charge de Crypto pour créer une chaîne de mot de passe chiffrée. Ensuite, le mot de passe chiffré peut être utilisé dans la configuration OSGi pour ActiveMQ.

Sur chaque instance de publication :

  1. Dans la console OSGi, accédez à MAIN > Prise en charge de Crypto (https://<host>:<port>/system/console/crypto).
  2. Saisissez le mot de passe en texte brut (identique pour toutes les instances) dans Texte brut
  3. Sélectionner Protect.
  4. Copiez la valeur Texte protégé dans le bloc-notes ou l’éditeur de texte. Cette valeur peut être utilisée dans la configuration OSGi pour ActiveMQ.

Comme chaque instance de publication possède par défaut des clés de chiffrement uniques, effectuez cette étape sur chaque instance pub et enregistrez la clé unique pour la configuration suivante.

NOTE
Le mot de passe doit commencer et se terminer par des accolades. Par exemple :
{1ec346330f1c26b5c48255084c3b7272a5e85260322edd59119828d1fa0a610e}

Étape 4 : activation du cluster Artemis ActiveMQ step-activate-activemq-artemis-cluster

Sur chaque instance de publication :

  1. Accédez au gestionnaire de configuration OSGi https://<host>:<port>/system/console/configMgr

  2. Sélectionnez la Configuration du Fournisseur JMS Apache ActiveMQ Artemis

  3. Mettez à jour les éléments suivants :

    • Mot de passe du cluster  : utilisez la valeur chiffrée de l’étape précédente pour chaque instance
    • Sujets  : {name: 'commands', address: 'com.adobe.cq.screens.commands', maxConsumers: 50}

Vérifiez le cluster d’artéfacts ActiveMQ Artemis verify-activemq-artemis-cluster

Suivez les étapes ci-dessous sur chaque instance de publication :

  1. Accédez à la console OSGi > Principal > ActiveMQ Artemis https://localhost:4505/system/console/mq.

  2. Vérifiez et contrôlez afin d’afficher les ports des autres instances sous Informations sur le cluster > Topologie > nœuds=2, membres=2.

  3. Envoyez un message de test (en haut de l’écran sous Informations sur le courtier)

  4. Entrez les modifications suivantes dans les champs :

    1. Destination  : /com.adobe.cq.screens/devTestTopic
    2. Texte  : Hello World
    3. Afficher la variable error.log de chaque instance afin que vous puissiez voir que le message a été envoyé et reçu dans la grappe.
NOTE
La navigation vers la console OSGi peut prendre quelques secondes après l’enregistrement de la configuration à l’étape précédente. Vous pouvez également consulter le fichier error.log pour plus de détails.

Par exemple, l’image suivante s’affiche lors d’une configuration réussie d’ActiveMQ Artemis Server.

Si vous ne voyez pas la configuration suivante de /system/console/mq, puis accédez à /system/console/mq et sélectionnez Redémarrer pour redémarrer le courtier.

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

Suppression des exigences d’en-tête de référent remove-referrer-header-requirement

Suivez les étapes de chaque instance de publication :

  1. Accédez à Console OSGi > Configuration Manager
  2. Sélectionnez Filtre de référent Apache Sling
  3. Mettez à jour la configuration et cochez Autoriser valeur vide

Configuration des instances de création et de publication configuring-author-and-publish-instance

Après avoir configuré la topologie de publication, configurez les instances d’auteur et de publication pour afficher les résultats pratiques de l’implémentation :

NOTE
Conditions préalables
Pour commencer avec cet exemple, créez un projet AEM Screens, puis créez un emplacement, un affichage et un canal dans votre projet. Ajoutez du contenu à votre canal et affectez-le à un affichage.

Étape 1 : démarrage d’un lecteur AEM Screens (appareil)

  1. Lancez une fenêtre du navigateur distincte.
  2. Accédez au lecteur Screens à l’aide du navigateur web, à savoir https://localhost:4502/content/mobileapps/cq-screens-player/firmware.html, ou lancez l’application AEM Screens. Lorsque vous ouvrez le périphérique, notez que son état n’est pas enregistré.
NOTE
Vous pouvez ouvrir un lecteur AEM Screens en utilisant l’application que vous avez téléchargée ou le navigateur web.

Étape 2 : enregistrement d’un appareil sur l’auteur step-registering-a-device-on-author

  1. Accédez à https://localhost:4502/screens.html/content/screens/we-retail ou sélectionnez votre projet et accédez à Appareils > Gestionnaire d’appareils.
  2. Sélectionnez Enregistrer l’appareil.
  3. Sélectionner Enregistrement de périphérique.
  4. Sélectionnez le périphérique que vous souhaitez enregistrer, puis sélectionnez Enregistrer le périphérique.
  5. Vérifiez le code d’enregistrement, puis sélectionnez Valider.
  6. Saisissez un titre pour votre périphérique, puis sélectionnez Enregistrer.

Étape 3 : attribution de l’appareil à un affichage step-assigning-the-device-to-display

  1. Sélectionner Attribuer l’affichage à partir de la boîte de dialogue de l’étape précédente.
  2. Sélectionnez le chemin d’affichage de votre canal dans le dossier Emplacements.
  3. Sélectionner Attribuer.
  4. Sélectionner Terminer pour terminer le processus, et le périphérique est désormais attribué.

Vérifiez votre lecteur et notez le contenu que vous avez ajouté à votre canal.

Étape 4 : publication de la configuration de l’appareil sur les instances de publication step-publishing-device-configuration-to-publish-instances

Vérification de l’appareil

Pour répliquer l’utilisateur de l’appareil, procédez comme suit :

  1. Accédez à la page d’administration des utilisateurs. Par exemple, https://localhost:4502/useradmin.
  2. Recherchez le screens-devices-master groupe.
  3. Cliquez avec le bouton droit sur le groupe et sélectionnez Activer.
CAUTION
N’activez pas le service author-publish-screens-service, car il s’agit d’un utilisateur système utilisé par la tâche de création.

Vous pouvez également activer l’appareil à partir de la console de gestion des appareils. Suivez les étapes ci-dessous :

  1. Accédez à votre projet Screens > Périphériques.
  2. Sélectionner Gestionnaire de périphériques dans la barre d’actions.
  3. Sélectionnez le périphérique et sélectionnez Activer dans la barre d’actions, comme illustré dans la figure ci-dessous.

screen_shot_2019-02-21at111036am

NOTE
Une fois le périphérique activé, vous pouvez également modifier ou mettre à jour l’URL du serveur. Sélectionner Modifier l’URL du serveur dans la barre d’actions, comme illustré dans la figure ci-dessous, vos modifications sont propagées au lecteur AEM Screens.

screen_shot_2019-02-21at105527am

Liste de contrôle de publication publishing-check-list

Les points suivants résument la liste de contrôle de publication :

  • Utilisateur de l’appareil Screens  : stocké en tant qu’utilisateur AEM, il est activé à partir de Outils > Sécurité > Utilisateurs. L’utilisateur est précédé du préfixe "screens" avec une longue chaîne sérialisée.

  • Projet  : le projet AEM Screens.

  • Emplacement  : emplacement auquel l’appareil est connecté.

  • Canaux : un ou plusieurs canaux affichés à l’emplacement

  • Planification  : si vous utilisez une planification, veillez à ce qu’elle soit publiée.

  • Dossier Emplacement, Planifications et Canal  : si les ressources correspondantes se trouvent dans un dossier.

Suivez les étapes ci-dessous pour vérifier le comportement de création et de publication :

  1. Mettez à jour le contenu d’un canal sur l’instance d’auteur.
  2. Effectuer Gérer la publication pour publier de nouvelles modifications sur toutes les instances de publication.
  3. Presse Activer pour activer l’appareil à partir de Gestionnaire de périphériques.
  4. Modifier l’URL de l’URL de l’instance d’auteur à l’une des URL des instances de publication.
  5. Vérifiez que le contenu du canal mis à jour s’affiche sur le lecteur AEM Screens.
  6. Répétez ces étapes en utilisant une autre instance de publication.

Étape 5 : pointage de l’appareil vers l’instance de publication dans le panneau d’administration step-pointing-the-device-to-publish-instance-in-the-admin-panel

  1. Affichez l’interface utilisateur d’administration du lecteur Screens en appuyant longuement dans le coin supérieur gauche afin d’ouvrir le menu Admin, sur votre lecteur AEM Screens tactile ou à l’aide de la souris.
  2. Sélectionnez la variable Configuration dans le panneau latéral.
  3. Remplacez l’instance d’auteur par instance de publication dans Serveur.

Affichez les modifications dans votre lecteur AEM Screens.

Vous pouvez également mettre à jour/modifier l’URL du serveur à partir de la console de gestion des appareils en procédant comme suit :

  1. Accédez à votre projet AEM Screens et sélectionnez le dossier Appareils.
  2. Sélectionner Gestionnaire de périphériques dans la barre d’actions.
  3. Sélectionnez le périphérique et sélectionnez Modifier l’URL du serveur dans la barre d’actions, comme illustré dans la figure ci-dessous, et vos modifications sont propagées au lecteur AEM Screens.

screen_shot_2019-02-07at31028pm

La variable Gérer la publication permet de diffuser des mises à jour de contenu de l’auteur à la publication sur le périphérique. Vous pouvez publier/annuler la publication de contenu pour l’ensemble du projet AEM Screens ou uniquement pour l’un de vos canaux, emplacement, périphérique, application ou planification. Pour en savoir plus sur cette fonctionnalité, voir Mise à jour du contenu On-Demand.

Conseils de dépannage troubleshoot-tips

Consultez la section ci-dessous pour obtenir des réponses aux questions fréquentes sur la configuration de l’auteur/de la publication.

Comment ajouter une redirection de https vers http après l’enregistrement et l’affectation initiaux ? add-redirect

Solution
Définissez l’option Proxy/Load Balancer Connection in the Jetty configuration sur true.

Comment mettre à jour le contenu hors ligne et les problèmes de téléchargement du lecteur avec des ressources en dehors de /content/dam/projects/<project> ? update-offline-content

Solution
Donnez des autorisations de lecture à l’utilisateur du service de mise à jour hors ligne en bloc et screens-devices-master groupe pour tous /content/dam ou les ressources spécifiques que vous souhaitez utiliser, si vous souhaitez être plus restrictif.

Comment résoudre les erreurs « Agent de réplication Screens » ? replication-agent

Solution
Assurez-vous que vous n’avez pas coché l’option Utiliser pour la réplication inverse dans la configuration de l’agent. L’agent de réplication Screens ne peut pas être utilisé comme agent de réplication inverse et l’objectif de cette fonctionnalité est de transférer les commandes de l’appareil de l’auteur à la publication.

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