DocumentationAEMGuide d’AEM Screens

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

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

Créé pour :

  • Utilisateur ou utilisatrice

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

Conditions préalables prerequisites

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 d’appareil
NOTE
Cette fonctionnalité AEM Screens n’est disponible que si vous avez installé le pack de fonctionnalités 2 pour AEM 6.4 Screens. Pour accéder à ce pack de fonctionnalités, contactez l’assistance d’Adobe et demandez à y accéder. Une fois que vous disposez des autorisations nécessaires, vous pouvez le télécharger à partir du partage de packages.
IMPORTANT
Si vous souhaitez utiliser plusieurs instances de publication avec Dispatcher, mettez-le à jour. 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 vue d’ensemble de l’architecture de création et de publication et sur la manière dont le contenu est créé sur une instance de création AEM avant d’être répliqué sur plusieurs instances de publication, reportez-vous à Vue d’ensemble 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, où vous hébergez une instance de création et deux instances de publication :

  • Création > localhost:4502.
  • Publication 1 (pub1) > localhost:4503.
  • Publication 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. Cliquez sur la Réplication dans l’arborescence de navigation de gauche.

    screen_shot_2019-02-25at24715pm

  3. Cliquez sur les Agents sur l’instance de création dans le dossier Réplication, puis sur Nouveau pour créer un agent de réplication standard.

    screen_shot_2019-02-25at25400pm

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

    screen_shot_2019-02-25at25737pm

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

    screen_shot_2019-02-25at30018pm

  6. Cliquez sur Modifier.

  7. Dans la boîte de dialogue Paramètres de l’agent, saisissez les détails.

    note note
    NOTE
    La personne 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.

    screen_shot_2019-02-25at30134pm

  8. Accédez à l’onglet Transport et saisissez l’URI, l’utilisateur ou l’utilisatrice et le mot de passe.

    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 l’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 l’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. Cliquez sur 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 Whitelist des connecteurs de topologie  : à adapter aux adresses IP ou aux sous-réseaux couvrant les instances de publication. Veillez à placer sur la liste whitelist 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 step-verify-publish-topology

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 step-setup-activemq-artemis-cluster

Cette étape vous permet de créer un mot de passe chiffré pour le cluster ActiveMQ Artemis.
Le nom d’utilisateur ou d’utilisatrice et le mot de passe du cluster 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 du chiffrement 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 à PRINCIPAL > Prise en charge du chiffrement (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 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, vous devez effectuer cette étape sur chaque instance de publication et enregistrer 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. Cliquez sur 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. 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.
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, accédez à /system/console/mq et cliquez sur 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. Cliquez sur le 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

Une fois que vous aurez configuré la topologie de publication, configurez les instances de création et de publication afin d’afficher les résultats concrets 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 l’appareil, vous remarquez que son état est non 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’instance de création step-registering-a-device-on-author

  1. Accédez à https://localhost:4502/screens.html/content/screens/we-retail ou cliquez sur votre projet et accédez à Appareils > Gestionnaire d’appareils.
  2. Cliquez sur Enregistrer l’appareil.
  3. Cliquez Enregistrement des appareils.
  4. Cliquez sur l’appareil que vous voulez enregistrer, puis sur Enregistrer l’appareil.
  5. Vérifiez le code d’enregistrement et cliquez sur Valider.
  6. Saisissez un titre pour votre appareil et cliquez sur Enregistrer.

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

  1. Cliquez sur Attribuer l’affichage dans la boîte de dialogue de l’étape précédente.
  2. Cliquez sur le chemin d’affichage de votre canal dans le dossier Emplacements.
  3. Cliquez sur Attribuer.
  4. Cliquez sur Terminer pour achever le workflow. L’appareil 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 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 ou l’utilisatrice de l’appareil, procédez comme suit :

  1. Accédez à la page d’administration des utilisateurs et utilisatrices. Par exemple, https://localhost:4502/useradmin.
  2. Recherchez le groupe screens-devices-master.
  3. Cliquez avec le bouton droit sur le groupe, puis cliquez sur Activer.
CAUTION
N’activez pas le service author-publish-screens-service, car il s’agit d’un profile utilisateur système utilisé par le traitement 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 > Appareils.
  2. Cliquez sur Gestionnaire de périphériques dans la barre d’actions.
  3. Cliquez sur l’appareil, puis sur Activer dans la barre d’actions, comme illustré ci-dessous.

screen_shot_2019-02-21at111036am

NOTE
Une fois l’appareil activé, vous pouvez également modifier ou mettre à jour l’URL du serveur. Dans la barre d’actions, cliquez sur Modifier l’URL du serveur, comme illustré 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écapitulent la Liste de contrôle de publication :

  • Utilisateur ou utilisatrice de l’appareil Screens  : cette information est stockée en tant qu’utilisateur ou utilisatrice AEM, et peut être activée à partir de Outils  > Sécurité > Utilisateurs et utilisatrices. L’utilisateur ou l’utilisatrice comporte le préfixe « screens » avec une longue chaîne sérialisée.

  • Projet  : projet AEM Screens.

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

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

  • Planning  : si vous utilisez un planning, veillez à ce qu’il soit publié.

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

Pour vérifier le comportement de création et de publication, procédez comme suit :

  1. Mettez à 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 d’appareils.
  4. Sélectionnez 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 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 d’utilisation de l’administration du lecteur Screens en appuyant longuement dans l’angle supérieur gauche afin d’ouvrir le menu d’administration sur votre lecteur AEM Screens tactile, ou en utilisant une souris.
  2. Cliquez sur l’option Configuration dans le panneau latéral.
  3. Changez l’instance de création 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 appareils en procédant comme suit :

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

screen_shot_2019-02-07at31028pm

La fonction Gérer les publications permet de diffuser des mises à jour de contenu de l’instance de création à celle de publication, puis à l’appareil. Vous pouvez publier/annuler la publication de contenu pour l’ensemble de votre projet AEM Screens ou uniquement pour l’un de vos canaux, emplacements, appareils, applications ou plannings. Pour en savoir plus sur cette fonction, voir la section Mise à jour du contenu à la demande.

Conseils de dépannage troubleshoot-tips

Consultez la section ci-dessous pour obtenir des réponses aux questions fréquemment posées concernant la configuration de l’instance de création et de celle de 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 droits de lecture au profil 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 faire preuve de davantage de restriction.

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’instance de création à celle de publication.

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