Configuration de l’auteur et de la publication dans AEM Screens

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 le périphérique

Prérequis

Avant de vous familiariser avec 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 de périphérique

Configuration des instances 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, où vous hébergez une instance de création 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

Pour créer des agents de réplication, vous devez apprendre à 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

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.

   

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

   

3. Sélectionnez les Agents sur l’auteur dans le dossier Réplication et cliquez sur Nouveau pour créer un agent de réplication standard.

   

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

   

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

   

6. Cliquez sur Modifier pour ouvrir la boîte de dialogue Paramètres d’agent afin de saisir les détails.

   REMARQUE

   L’utilisateur doit cocher Activé pour activer l’agent de réplication. Vous devez cocher cette option sur les agents de réplication par défaut, Screens et inverse.

   

7. Accédez à l’onglet Transport et saisissez l’URI, l’Utilisateur et le Mot de passe.

   

   REMARQUE

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

Création d’agents de réplication standard

1. Créez un agent de réplication standard pour pub1 (l’agent par défaut prêt à l’emploi devrait déjà être configuré) (par exemple, https://<nom_hôte>: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

1. Créez l’agent de réplication Screens pour pub1. Par défaut, il existe un agent de réplication Screens qui pointe vers le port 4503. Celui-ci doit être activé.

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

   REMARQUE

   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

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

Étape 1 : configuration de la détection Apache Sling basée sur Oak

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 des connecteurs de topologie : ajoutez les URL de toutes les instances de publication participantes, à savoir :

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

4. Liste autorisée des connecteurs de topologie : à adapter aux adresses IP ou aux sous-réseaux couvrant les instances de publication. Veillez à placer sur la liste autorisée l’adresse IP/le 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 des boucles locales empêche la création d’une boucle infinie.

Étape 2 : vérification de la topologie de publication

Pour toutes les instances de publication, accédez à https://:/system/console/topology. Vous devriez voir chaque instance de publication représentée dans la topologie sous Connecteurs de topologie sortants.

Étape 3 : configuration d’un cluster ActiveMQ Artemis

Cette étape vous permet de créer un mot de passe chiffré pour le cluster ActiveMQ Artemis.
L’utilisateur de du cluster 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. Le mot de passe chiffré sera ensuite 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. Cliquez sur Protéger.
4. Copiez la valeur Texte protégé dans le bloc-notes ou l’éditeur de texte. Cette valeur sera utilisée dans la configuration OSGi pour ActiveMQ.

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

Étape 4 : activation du cluster Artemis ActiveMQ

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

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. Affichez le fichier error.log de chaque instance pour vérifier que le message a été envoyé et reçu par l’ensemble du cluster.

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, accédez à /system/console/mq et cliquez sur Redémarrer pour redémarrer le courtier.

Suppression des exigences d’en-tête de référent

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

Une fois que vous aurez configuré la stratégie de publication, vous devez configurer les instances de création et de publication afin d’afficher les résultats concrets de l’implémentation :

Étape 1 : démarrage d’un lecteur AEM Screens (périphérique)

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, vous remarquez que son état est non enregistré.

Étape 2 : enregistrement d’un périphérique sur l’auteur

1. Accédez à https://localhost:4502/screens.html/content/screens/we-retail ou sélectionnez votre projet et accédez à Périphériques > Gestionnaire de périphériques.
2. Sélectionnez Enregistrer le périphérique.
3. Cliquez sur Enregistrement du périphérique pour afficher le périphérique.
4. Sélectionnez le périphérique que vous voulez enregistrer et cliquez ensuite sur Enregistrer le périphérique.
5. Vérifiez le code d’enregistrement et cliquez sur Valider.
6. Saisissez un titre pour votre périphérique et cliquez sur Enregistrer.

Étape 3 : attribution du périphérique à un affichage

1. Cliquez sur Attribuer l’affichage dans 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. Cliquez sur Attribuer.
4. Cliquez sur Terminer pour achever le workflow. Le périphérique est désormais attribué.

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

Étape 4 : publication de la configuration du périphérique sur les instances de publication

Vérification du périphérique

Pour répliquer l’utilisateur du périphérique, procédez comme suit :

1. Accédez à la page d’administration des utilisateurs (par ex. : https://localhost:4502/useradmin)
2. Recherchez le groupe screens-devices-master
3. Cliquez avec le bouton droit sur le groupe, puis cliquez sur Activer

Vous pouvez également activer le périphérique à partir de la console de gestion des périphériques. Suivez les étapes ci-dessous :

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

Liste de contrôle de publication

Les points suivants récapitulent la Liste de contrôle de publication :

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

• Projet : le projet AEM Screens.

• Emplacement : emplacement auquel le périphérique 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/publication :

1. Mise à jour du contenu d’un canal sur l’instance de création
2. Exécutez Gérer la publication pour publier de nouvelles modifications sur toutes les instances de publication.
3. Appuyez sur Activer pour activer l’appareil à partir du Gestionnaire de périphériques.
4. Modifiez l’URL de l’instance de création en la remplaçant par l’URL de l’une des instances de publication.
5. Vérifiez que le contenu du canal mis à jour s’affiche dans le lecteur AEM Screens.
6. Répétez ces étapes en utilisant une autre instance de publication.

Étape 5 : pointage du périphérique vers l’instance de publication dans le panneau d’administration

1. Affichez l’interface utilisateur d’administration du lecteur Screens en appuyant longuement dans l’angle supérieur gauche afin d’ouvrir le menu Admin sur votre lecteur AEM Screens, avec fonction tactile activée, ou en utilisant la souris.
2. Cliquez sur l’option Configuration dans le panneau latéral.
3. Modifiez l’instance d’auteur en 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 périphériques en procédant comme suit :

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

La fonction Gérer les publications permet de diffuser des mises à jour de contenu de l’auteur à publier 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 des canaux, un des emplacements, un des appareils, une des applications ou une des planifications. Pour en savoir plus sur cette fonction, voir Mise à jour du contenu On-Demand.

Conseils de dépannage

Consultez la section ci-dessous pour obtenir des réponses aux questions fréquemment posées concernant la configuration de l’auteur/de la publication.

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

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> ?

Solution
Donnez des droits de lecture à l’utilisateur bulk-offline-update-screens-service et au groupe screens-devices-master pour tout le /content/dam ou les ressources spécifiques que vous voulez utiliser, si vous souhaitez être plus restrictif.

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

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.

Ressources Business.Adobe.com

Multichannel Communication Personalized Communications Embedded Charts Mobile Forms Version History Digital Rights Management