Configuration des instances de création et de publication dans AEM Screens configuring-author-and-publish-in-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 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
Configuration des instances de création et de publication configuring-author-and-publish-instances
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 :
- Agent de réplication par défaut (spécifié comme** Agent de réplication standard**)
- Agent de réplication Screens
- 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 :
-
Accédez à votre instance AEM > icône marteau > Opérations > Configuration.
-
Sélectionnez la Réplication dans l’arborescence de navigation de gauche.
-
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.
-
Saisissez le Titre et Nom pour créer l’agent de réplication, puis sélectionnez Créer.
-
Cliquez avec le bouton droit sur l’agent de réplication et sélectionnez Ouvrir pour modifier les paramètres.
-
Sélectionnez Modifier.
-
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. -
Accédez au Transport et saisissez la variable URI, Utilisateur, et Password.
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
- 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
. - 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
-
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.
-
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
- Créez un agent de réplication inverse pour pub1.
- 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 :
-
Accédez à
https://<host>:<port>/system/console/configMgr
. -
Sélectionnez la Configuration du Service de détection Apache Sling basé sur Oak.
-
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
-
Connecteur de topologie
Whitelist
Liste: s’adapter aux adresses IP ou aux sous-réseaux couvrant toutes les instances de publication. Vérifiez quewhitelist
l’adresse IP/nom d’hôte de toutes les instances de publication sans le numéro de port. -
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 :
- Dans la console OSGi, accédez à MAIN > Prise en charge de Crypto (
https://<host>:<port>/system/console/crypto
). - Saisissez le mot de passe en texte brut (identique pour toutes les instances) dans Texte brut
- Sélectionner Protect.
- 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.
{1ec346330f1c26b5c48255084c3b7272a5e85260322edd59119828d1fa0a610e}
Étape 4 : activation du cluster Artemis ActiveMQ step-activate-activemq-artemis-cluster
Sur chaque instance de publication :
-
Accédez au gestionnaire de configuration OSGi
https://<host>:<port>/system/console/configMgr
-
Sélectionnez la Configuration du Fournisseur JMS Apache ActiveMQ Artemis
-
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 :
-
Accédez à la console OSGi > Principal > ActiveMQ Artemis
https://localhost:4505/system/console/mq
. -
Vérifiez et contrôlez afin d’afficher les ports des autres instances sous Informations sur le cluster > Topologie > nœuds=2, membres=2.
-
Envoyez un message de test (en haut de l’écran sous Informations sur le courtier)
-
Entrez les modifications suivantes dans les champs :
- Destination : /com.adobe.cq.screens/devTestTopic
- Texte : Hello World
- 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.
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.
Suppression des exigences d’en-tête de référent remove-referrer-header-requirement
Suivez les étapes de chaque instance de publication :
- Accédez à Console OSGi > Configuration Manager
- Sélectionnez Filtre de référent Apache Sling
- 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 :
Étape 1 : démarrage d’un lecteur AEM Screens (appareil)
- Lancez une fenêtre du navigateur distincte.
- 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é.
Étape 2 : enregistrement d’un appareil sur l’auteur step-registering-a-device-on-author
- Accédez à
https://localhost:4502/screens.html/content/screens/we-retail
ou sélectionnez votre projet et accédez à Appareils > Gestionnaire d’appareils. - Sélectionnez Enregistrer l’appareil.
- Sélectionner Enregistrement de périphérique.
- Sélectionnez le périphérique que vous souhaitez enregistrer, puis sélectionnez Enregistrer le périphérique.
- Vérifiez le code d’enregistrement, puis sélectionnez Valider.
- 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
- Sélectionner Attribuer l’affichage à partir de la boîte de dialogue de l’étape précédente.
- Sélectionnez le chemin d’affichage de votre canal dans le dossier Emplacements.
- Sélectionner Attribuer.
- 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 :
- Accédez à la page d’administration des utilisateurs. Par exemple,
https://localhost:4502/useradmin
. - Recherchez le
screens-devices-master
groupe. - Cliquez avec le bouton droit sur le groupe et sélectionnez Activer.
Vous pouvez également activer l’appareil à partir de la console de gestion des appareils. Suivez les étapes ci-dessous :
- Accédez à votre projet Screens > Périphériques.
- Sélectionner Gestionnaire de périphériques dans la barre d’actions.
- Sélectionnez le périphérique et sélectionnez Activer dans la barre d’actions, comme illustré dans la figure ci-dessous.
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 :
- Mettez à jour le contenu d’un canal sur l’instance d’auteur.
- Effectuer Gérer la publication pour publier de nouvelles modifications sur toutes les instances de publication.
- Presse Activer pour activer l’appareil à partir de Gestionnaire de périphériques.
- Modifier l’URL de l’URL de l’instance d’auteur à l’une des URL des instances de publication.
- Vérifiez que le contenu du canal mis à jour s’affiche sur le lecteur AEM Screens.
- 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
- 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.
- Sélectionnez la variable Configuration dans le panneau latéral.
- 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 :
- Accédez à votre projet AEM Screens et sélectionnez le dossier Appareils.
- Sélectionner Gestionnaire de périphériques dans la barre d’actions.
- 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.
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.