Configurazione di Author e Publish in AEM Screens configuring-author-and-publish-in-aem-screens

In questa pagina sono evidenziati i seguenti argomenti:

  • Configurazione delle istanze di authoring e pubblicazione
  • Impostazione della topologia di pubblicazione
  • Gestione della pubblicazione: distribuzione degli aggiornamenti dei contenuti dall’ambiente di authoring a quello di pubblicazione sul dispositivo

Prerequisiti prerequisites

Prima di iniziare a utilizzare i server di authoring e pubblicazione, è necessario conoscere in precedenza:

  • Topologia AEM
  • Creazione e gestione di un progetto AEM Screens
  • Processo di registrazione del dispositivo
NOTE
Questa funzionalità di AEM Screens è disponibile solo se è stato installato AEM 6.4 Screens Feature Pack 2. Per accedere a questo Feature Pack, contatta il supporto Adobe e richiedi l’accesso. Una volta ricevute le autorizzazioni, puoi scaricarle da Condivisione pacchetti.
IMPORTANT
Se desideri utilizzare più istanze di pubblicazione con Dispatcher, devi aggiornare il file dispatcher.any nel dispatcher. Consulta Abilitazione di sessioni permanenti per ulteriori dettagli.

Configurazione delle istanze di authoring e pubblicazione configuring-author-and-publish-instances

NOTE
Per ulteriori informazioni sull’architettura di authoring e pubblicazione e su come i contenuti vengono creati su un’istanza di authoring AEM e poi replicati in avanti su più istanze di pubblicazione, consulta Panoramica dell’architettura di authoring e pubblicazione.

La sezione seguente spiega come impostare gli agenti di replica sulla topologia di authoring e pubblicazione.

Puoi impostare un semplice esempio in cui ospitare un autore e due istanze di pubblicazione:

  • Autore —> localhost:4502
  • Pubblicazione 1 (pub1) —> localhost:4503
  • Publish 2 (pub2) —> localhost:4504

Impostazione degli agenti di replica sull’autore setting-replication-agents

Per creare gli agenti di replica, è necessario imparare a creare un agente di replica standard.

Per Screens sono necessari 3 agenti di replica:

  1. Agente di replica predefinito ​(specificato come​** Agente di replica standard**)
  2. Agente di replica Screens
  3. Agente replica inversa

Passaggio 1: creazione di un agente di replica predefinito step-creating-a-default-replication-agent

Per creare un agente di replica predefinito, effettua le seguenti operazioni:

  1. Passa all’istanza AEM —> icona a forma di martello —> Operazioni —> Configurazione.

    screen_shot_2019-02-25at24621pm

  2. Seleziona la Replica dalla struttura di navigazione a sinistra.

    screen_shot_2019-02-25at24715pm

  3. Seleziona la Agenti per creazione dal Replica cartella e fai clic su Nuovo per creare un nuovo agente di replica standard.

    screen_shot_2019-02-25at25400pm

  4. Inserisci il Titolo e Nome per creare l’agente di replica e fare clic su Crea.

    screen_shot_2019-02-25at25737pm

  5. Fai clic con il pulsante destro del mouse sull’agente di replica e fai clic su Apri per modificare le impostazioni.

    screen_shot_2019-02-25at30018pm

  6. Clic Modifica per aprire Impostazioni agente per immettere i dettagli.

    note note
    NOTE
    L’utente deve controllare Abilitato per abilitare l’agente di replica. È necessario selezionare questa opzione su Predefinito, Schermi e Agenti di replica inversa.

    screen_shot_2019-02-25at30134pm

  7. Accedi a Trasporto e immetti il URI, Utente e Password.

    screen_shot_2019-03-04at34955pm

    note note
    NOTE
    È inoltre possibile copiare e rinominare un agente di replica predefinito esistente.

Creazione di agenti di replica standard creating-standard-replication-agents

  1. Crea un agente di replica standard per pub1 (l’agente predefinito deve già essere configurato) (ad esempio, https://<hostname>:4503/bin/receive?sling:authRequestLogin=1)
  2. Crea un agente di replica standard per pub2. È possibile copiare come agente di replica per pub1 e aggiornare il trasporto da utilizzare per pub2 modificando la porta nella configurazione di trasporto. (ad esempio, https://<hostname>:4504/bin/receive?sling:authRequestLogin=1)

Creazione di agenti di replica Screens creating-screens-replication-agents

  1. Crea un agente di replica Screens per pub1. Come funzione integrata, esiste un agente di replica Screens che punta alla porta 4503. È necessario abilitare questa funzione.

  2. Crea un agente di replica Screens per pub2. Copia l’agente di replica di Screens per pub1 e modifica la porta in modo che punti a 4504 per pub2.

    note note
    NOTE
    Per informazioni su come configurare gli agenti di replica Screens, consulta Configurazione dell’agente di replica di Screens.

Creazione di Screens per agenti di replica inversa creating-screens-reverse-replication-agents

  1. Crea un agente di replica inversa per pub1.
  2. Crea un agente di replica inversa per pub2. È possibile copiare l'agente di replica inversa per pub1 e aggiornare il trasporto da utilizzare per pub2 modificando la porta nella configurazione di trasporto.

Impostazione della topologia di pubblicazione setting-up-publish-topology

Passaggio 1: configurare l’individuazione basata su Oak di Apache Sling step-configure-apache-sling-oak-based-discovery

Configurare Apache Sling Oak-Based Discovery per tutte le istanze Publish nella topologia

Per ogni istanza di pubblicazione:

  1. Accedi a https://<host>:<port>/system/console/configMgr

  2. Seleziona Servizio di individuazione basato su Oak Apache Sling Configurazione.

  3. Aggiorna URL connettore topologia: aggiungi URL di tutte le istanze di pubblicazione partecipanti che sono:

    • https://publish:4503/libs/sling/topology/connector
    • https://publish:4504/libs/sling/topology/connector
  4. Elenco whitelist del connettore topologia: adattati a IP o subnet che coprono tutte le istanze di pubblicazione. Assicurati di inserire in una whitelist il nome IP/host di tutte le istanze di pubblicazione senza il numero di porta.

  5. Abilita Arresto automatico cicli locali

La configurazione deve essere identica per ogni istanza di pubblicazione e il loop locale con arresto automatico impedisce un ciclo infinito.

Passaggio 2: verificare la topologia di pubblicazione step-verify-publish-topology

Per una qualsiasi delle istanze di pubblicazione, passa a https://:/system/console/topology. Dovresti visualizzare ogni istanza di pubblicazione rappresentata nella topologia in Connettori di topologia in uscita.

Passaggio 3: configurare il cluster ActiveMQ Artemis step-setup-activemq-artemis-cluster

Questo passaggio consente di creare una password crittografata per il cluster ActiveMQ Artemis.
L'utente cluster e la password di tutte le istanze di pubblicazione nella topologia devono essere identici. La password della configurazione di ActiveMQ Artemis deve essere crittografata. Poiché ogni istanza dispone di una propria chiave di crittografia, è necessario utilizzare il Supporto crittografia per creare una stringa di password crittografata. La password crittografata verrà quindi utilizzata nella configurazione OSGi per ActiveMQ.

Per ogni istanza di pubblicazione:

  1. Nella console OSGi passa a PRINCIPALE —> Supporto crittografia (https://&lt;host&gt;:&lt;port&gt;/system/console/crypto).
  2. Digita la password di testo normale desiderata (stessa per tutte le istanze) in Testo normale
  3. Clic Protect.
  4. Copia il valore Testo protetto al blocco note o all’editor di testo. Questo valore verrà utilizzato nella configurazione OSGi per ActiveMQ.

Poiché ogni istanza Publish per impostazione predefinita ha chiavi crittografiche univoche, devi eseguire questo passaggio su ogni istanza pub e salvare la chiave univoca per la configurazione successiva.

NOTE
La password deve iniziare e terminare con parentesi graffe. Ad esempio:
{1ec346330f1c26b5c48255084c3b7272a5e85260322edd59119828d1fa0a610e}

Passaggio 4: attivare il cluster ActiveMQ Artemis step-activate-activemq-artemis-cluster

In ogni istanza di pubblicazione:

  1. Passa a Gestione configurazione OSGi https://&lt;host&gt;:&lt;port&gt;/system/console/configMgr

  2. Seleziona Provider Apache ActiveMQ Artemis JMS Configurazione

  3. Aggiorna quanto segue:

    • Password cluster: utilizza un valore crittografato del passaggio precedente per la rispettiva istanza
    • Argomenti: {name: 'commands', address: 'com.adobe.cq.screens.commands', maxConsumers: 50}

Verifica cluster ActiveMQ Artemis verify-activemq-artemis-cluster

Segui i passaggi seguenti per ogni istanza Publish:

  1. Passa alla console OSGi -> Principale > ActiveMQ Artemis https://localhost:4505/system/console/mq.

  2. Verificare e controllare per visualizzare le porte di altre istanze in Informazioni cluster > Topologia > nodi=2, membri=2.

  3. Invia un messaggio di prova (nella parte superiore della schermata in Informazioni broker)

  4. Immetti le seguenti modifiche nei campi:

    1. Destinazione: /com.adobe.cq.screens/devTestTopic
    2. Testo: Hello World
    3. Visualizza il registro errori di ogni istanza per verificare che il messaggio sia stato inviato e ricevuto nel cluster
NOTE
Per passare alla console OSGi, potrebbero essere necessari alcuni secondi dopo il salvataggio della configurazione di cui al passaggio precedente. Puoi anche controllare il registro degli errori per ulteriori dettagli.

Ad esempio, l'immagine seguente viene visualizzata in caso di configurazione corretta del server ActiveMQ Artemis.

Se non vedi la seguente configurazione da /system/console/mq, quindi passa a /system/console/mq e fai clic su Riavvia per riavviare il broker.

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

Rimuovi requisito intestazione referente remove-referrer-header-requirement

Segui i passaggi per ogni istanza Publish:

  1. Accedi a Console OSGi > Gestione configurazione
  2. Seleziona Filtro referrer Apache Sling
  3. Aggiorna configurazione e seleziona Consenti vuoto

Configurazione dell’istanza di authoring e pubblicazione configuring-author-and-publish-instance

Dopo aver configurato la topologia di pubblicazione, è necessario configurare le istanze di authoring e pubblicazione per visualizzare i risultati pratici dell’implementazione:

NOTE
Prerequisiti
Per iniziare a utilizzare questo esempio, crea un nuovo progetto AEM Screens, seguito dalla creazione di una posizione, una visualizzazione e un canale nel progetto. Aggiungi contenuto al tuo canale e assegna il canale a una visualizzazione.

Passaggio 1: avvio di un lettore AEM Screens (dispositivo) step-starting-an-aem-screens-player-device

  1. Avvia una finestra del browser separata.
  2. Passa a Screens player utilizzando browser web, ovverohttps://localhost:4502/content/mobileapps/cq-screens-player/firmware.html o avvia l'app AEM Screens. Quando si apre il dispositivo, lo stato del dispositivo viene visualizzato come non registrato.
NOTE
Puoi aprire un lettore AEM Screens utilizzando l’app AEM Screens che hai scaricato o il browser web.

Passaggio 2: registrazione di un dispositivo durante l’authoring step-registering-a-device-on-author

  1. Vai a https://localhost:4502/screens.html/content/screens/we-retail oppure seleziona il progetto e passa a Dispositivi > Gestione dispositivi.
  2. Seleziona Registra dispositivo.
  3. Clic Registrazione dispositivo per visualizzare il dispositivo.
  4. Selezionare il dispositivo da registrare e fare clic su Registra dispositivo.
  5. Verifica il codice di registrazione e fai clic su Convalida.
  6. Inserisci un titolo per il dispositivo e fai clic su Registrati.

Passaggio 3: assegnazione del dispositivo alla visualizzazione step-assigning-the-device-to-display

  1. Clic Assegna visualizzazione dalla finestra di dialogo del passaggio precedente.
  2. Seleziona il percorso di visualizzazione del canale dalla Posizioni cartella.
  3. Clic Assegna.
  4. Clic Fine per completare il processo, e ora il dispositivo viene assegnato.

Controlla il lettore e vedrai il contenuto aggiunto nel tuo canale.

Passaggio 4: pubblicazione della configurazione del dispositivo nelle istanze di pubblicazione step-publishing-device-configuration-to-publish-instances

Verifica del dispositivo

Per replicare l’utente del dispositivo, segui la procedura riportata di seguito:

  1. Passa alla pagina dell’amministratore utenti (esempio: https://localhost:4502/useradmin
  2. Cerca screens-devices-master gruppo
  3. Fare clic con il pulsante destro del mouse sul gruppo e quindi scegliere Attiva
CAUTION
Non attivare author-publish-screens-service in quanto è un utente di sistema, utilizzato dal processo di authoring.

È inoltre possibile attivare il dispositivo dalla console di gestione dei dispositivi. Effettua le seguenti operazioni:

  1. Passa al progetto Schermi —> Dispositivi.
  2. Clic Gestione dispositivi dalla barra delle azioni.
  3. Seleziona il dispositivo e fai clic su Attiva dalla barra delle azioni, come illustrato nella figura riportata di seguito.

screen_shot_2019-02-21at111036am

NOTE
In alternativa, dopo aver attivato il dispositivo, puoi anche modificare o aggiornare l’URL del server facendo clic su Modifica URL server dalla barra delle azioni, come illustrato nella figura riportata di seguito, e le modifiche verranno propagate al lettore AEM Screens.

screen_shot_2019-02-21at105527am

Pubblicazione elenco di controllo publishing-check-list

Nei punti seguenti viene riepilogato l'elenco di controllo per la pubblicazione:

  • Utente dispositivo Screens - Questo viene memorizzato come utente AEM e deve essere attivato da Strumenti > Sicurezza > Utenti. All’utente verrà aggiunto il prefisso "screens" con una lunga stringa serializzata.

  • Progetto - Il progetto AEM Screens.

  • Posizione : posizione a cui è connesso il dispositivo.

  • Canale/i - uno o più canali visualizzati nel percorso

  • Pianificazione - se utilizzi una pianificazione, assicurati che sia pubblicata

  • Cartella posizioni, pianificazioni e canali - se le risorse corrispondenti si trovano all’interno di una cartella.

Segui i passaggi seguenti per verificare il comportamento di authoring/pubblicazione:

  1. Aggiornare alcuni contenuti del canale sull’istanza di authoring
  2. Esegui Gestisci pubblicazione per pubblicare nuove modifiche in tutte le istanze di pubblicazione
  3. Premi Attiva per attivare il dispositivo da Gestione dispositivi
  4. Modifica URL dall’URL dell’istanza di authoring a uno dell’URL delle istanze di pubblicazione
  5. Verifica che il contenuto del canale aggiornato venga visualizzato sul lettore AEM Screens
  6. Ripeti questi passaggi utilizzando un’istanza di pubblicazione diversa

Passaggio 5: indirizzamento del dispositivo all’istanza Publish nel pannello di amministrazione step-pointing-the-device-to-publish-instance-in-the-admin-panel

  1. Visualizza l’interfaccia utente di amministrazione dal lettore Screens, premi a lungo nell’angolo in alto a sinistra per aprire il menu Amministratore, sul lettore AEM Screens touch o utilizzando un mouse.
  2. Fai clic su Configurazione dal pannello laterale.
  3. Cambia l’istanza di authoring in istanza di pubblicazione in Server.

Visualizza le modifiche nel lettore AEM Screens.

In alternativa, puoi anche aggiornare/modificare l’URL del server dalla console di gestione del dispositivo seguendo la procedura riportata di seguito:

  1. Passa al progetto AEM Screens e seleziona la Dispositivi cartella.
  2. Clic Gestione dispositivi dalla barra delle azioni.
  3. Seleziona il dispositivo e fai clic su Modifica URL server dalla barra delle azioni, come illustrato nella figura riportata di seguito, e le modifiche verranno propagate al lettore AEM Screens.

screen_shot_2019-02-07at31028pm

Il Gestisci pubblicazione consente di distribuire aggiornamenti dei contenuti dall’ambiente di authoring a quello di pubblicazione sul dispositivo. Puoi pubblicare/annullare la pubblicazione dei contenuti per l’intero progetto AEM Screens o solo per uno dei canali, una posizione, un dispositivo, un’applicazione o una pianificazione. Per ulteriori informazioni su questa funzione, consulta Aggiornamento dei contenuti on-demand.

Suggerimenti per la risoluzione dei problemi troubleshoot-tips

Leggi la sezione seguente per ottenere risposte alle domande frequenti relative alla configurazione di authoring/pubblicazione.

Come si aggiunge un reindirizzamento da https a http dopo la registrazione e l’assegnazione iniziali? add-redirect

Soluzione
Imposta attivazione Proxy/Load Balancer Connection in the Jetty configuration a true.

Come aggiornare i contenuti offline e scaricare i problemi del lettore con le risorse esterne /content/dam/projects/<project>? update-offline-content

Soluzione
Concedi autorizzazioni di lettura per utente bulk-offline-update-screens-service e gruppo screens-devices-master per tutti /content/dam o le risorse specifiche da utilizzare, se desideri essere più restrittivo.

Come si risolvono gli errori dell’agente di replica di Screens? replication-agent

Soluzione
Assicurati di non aver selezionato l’opzione Usa per replica inversa nella configurazione dell’agente. L’agente di replica di Screens non può essere utilizzato come agente di replica inversa e l’ambito di questa funzione è quello di inoltrare i comandi del dispositivo dall’autore alla pubblicazione.

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