DocumentazioneAEMGuida di AEM Screens

Configurare le istanze Author e Publish in AEM Screens configuring-author-and-publish-in-aem-screens

Last update: Tue Jun 17 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Utente

In questa pagina sono evidenziati i seguenti argomenti:

  • Configurazione delle istanze Author e Publish
  • Impostazione della topologia di pubblicazione
  • Gestione della pubblicazione: distribuzione degli aggiornamenti dei contenuti dall'autore alla 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 del progetto AEM Screens
  • Processo di registrazione 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. Dopo aver ricevuto l'autorizzazione, puoi scaricarla da Condivisione pacchetti.
IMPORTANT
Se desideri utilizzare più di un’istanza Publish con Dispatcher, aggiorna Dispatcher. Consulta Abilitazione di sessioni permanenti.

Configurare le istanze Author e Publish configuring-author-and-publish-instances

NOTE
Per ulteriori informazioni sulla panoramica dell'architettura di authoring e pubblicazione e su come il contenuto viene creato in un'istanza di AEM Author e poi replicato in avanti in più istanze di pubblicazione, consulta Panoramica dell'architettura di authoring e pubblicazione.

Nella sezione seguente viene illustrato come impostare agenti di replica sulla topologia Author e Publish.

Puoi impostare un semplice esempio, in cui ospiti un’istanza Author e due istanze Publish:

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

Configurare gli agenti di replica per l’autore setting-replication-agents

Per creare agenti di replica, scopri come creare un agente di replica standard.

Per Screens sono necessari tre agenti di replica:

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

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

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

  1. Passa alla tua istanza di AEM > icona a forma di martello > Operazioni > Configurazione.

    schermata_shot_2019-02-25at24621pm

  2. Fare clic su Replica nella struttura di spostamento a sinistra.

    schermata_shot_2019-02-25at24715pm

  3. Fare clic su Agenti sull'autore dalla cartella Replica e fare clic su Nuovo per creare un nuovo agente di replica standard.

    schermata_shot_2019-02-25at25400pm

  4. Immetti Titolo e Nome in modo da poter creare l'agente di replica, quindi fai clic su Crea.

    schermata_shot_2019-02-25at25737pm

  5. Fare clic con il pulsante destro del mouse sull'agente di replica e scegliere Apri per modificare le impostazioni.

    schermata_shot_2019-02-25at30018pm

  6. Fai clic su Modifica.

  7. Immettere i dettagli nella finestra di dialogo Impostazioni agente.

    note note
    NOTE
    L'utente deve selezionare Enabled per abilitare l'agente di replica. Selezionare questa opzione per Agenti di replica predefiniti, Screens e Inverti.

    schermata_shot_2019-02-25at30134pm

  8. Passare alla scheda Trasporto e immettere URI, Utente e Password.

    schermata_shot_2019-03-04at34955pm

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

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

  1. Crea un agente di replica standard per pub1 (è già necessario configurare un agente predefinito). 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. Esempio: https://<hostname>:4504/bin/receive?sling:authRequestLogin=1.

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

  1. Creazione di un agente di replica AEM Screens per pub1. Esiste già un agente di replica Screens che punta alla porta 4503. Abilitala.

  2. Creazione di un agente di replica AEM Screens per pub2. Copiare l'agente di replica Screens per pub1 e modificare la porta in modo che punti a 4504 per pub2.

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

Creare agenti di replica inversa di Screens 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.

Imposta 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 l’individuazione basata su Oak di Apache Sling per tutte le istanze Publish nella topologia

Per ogni istanza Publish:

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

  2. Fare clic su Configurazione servizio di individuazione basato su Oak Apache Sling.

  3. Aggiorna URL connettore topologia: aggiungi URL di tutte le istanze Publish che effettuano la raccolta e che sono:

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

  4. Connettore topologia Whitelist elenco: adattarsi a IP o subnet che coprono tutte le istanze di pubblicazione. Assicurarsi di whitelist il nome IP/host di tutte le istanze Publish senza il numero di porta.

  5. Abilita Interruzione automatica cicli locali

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

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

Per qualsiasi istanza di pubblicazione, passare a https://:/system/console/topology. Dovresti visualizzare ogni istanza Publish 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 Publish 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. Quindi, la password crittografata può essere utilizzata nella configurazione OSGi per ActiveMQ.

Per ogni istanza di pubblicazione:

  1. Nella console OSGi, passa a PRINCIPALE > Supporto crittografia (https://<host>:<port>/system/console/crypto).
  2. Digitare la password di testo normale desiderata (uguale per tutte le istanze) in Testo normale
  3. Fare clic su Proteggi.
  4. Copiare il valore Testo protetto in un blocco note o in un editor di testo. Questo valore può essere utilizzato nella configurazione OSGi per ActiveMQ.

Poiché ogni istanza Publish, per impostazione predefinita, dispone di chiavi crittografiche univoche, esegui questo passaggio su ogni istanza pub e salva 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

Su ogni istanza di pubblicazione:

  1. Passa a Gestione configurazione OSGi https://<host>:<port>/system/console/configMgr

  2. Fai clic sulla configurazione del provider JMS Apache ActiveMQ Artemis ​

  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 a 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. Visualizzare il error.log di ogni istanza in modo da poter vedere che il messaggio è stato inviato e ricevuto nel cluster.
NOTE
La navigazione alla console OSGi potrebbe richiedere 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 la seguente configurazione non viene visualizzata da /system/console/mq, passare a /system/console/mq e fare 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 descritti in ogni istanza Publish:

  1. Passa a Console OSGi > Gestione configurazione
  2. Fai clic su Filtro referrer Apache Sling
  3. Aggiorna configurazione e seleziona Consenti vuoto

Configurare l’istanza di authoring e pubblicazione configuring-author-and-publish-instance

Dopo aver impostato la topologia di pubblicazione, configura le istanze Author e Publish per visualizzare i risultati pratici dell’implementazione:

NOTE
Prerequisiti
Per iniziare a utilizzare questo esempio, crea un progetto AEM Screens, quindi crea 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)

  1. Avvia una finestra del browser separata.
  2. Vai al lettore Screens utilizzando il browser Web, ovverohttps://localhost:4502/content/mobileapps/cq-screens-player/firmware.html o avvia l'app AEM Screens. Quando apri il dispositivo, noterai che lo stato del dispositivo non è registrato.
NOTE
Puoi aprire un lettore AEM Screens utilizzando l’app AEM Screens che hai scaricato o il browser Web.

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

  1. Vai a https://localhost:4502/screens.html/content/screens/we-retail o fai clic sul progetto e passa a Dispositivi > Gestione dispositivi.
  2. Fare clic su Registra dispositivo.
  3. Fare clic su Registrazione dispositivo.
  4. Fare clic sul dispositivo da registrare, quindi fare clic su Registra dispositivo.
  5. Verificare il codice di registrazione, quindi fare clic su Convalida.
  6. Immetti un titolo per il dispositivo, quindi fai clic su Registra.

Passaggio 3: assegnare il dispositivo alla visualizzazione step-assigning-the-device-to-display

  1. Fare clic su Assegna visualizzazione nella finestra di dialogo del passaggio precedente.
  2. Fai clic sul percorso di visualizzazione del canale dalla cartella Percorsi.
  3. Fai clic su Assegna.
  4. Fare clic su Fine per completare il processo. Il dispositivo verrà assegnato.

Controlla il lettore e nota il contenuto aggiunto nel canale.

Passaggio 4: pubblicare la configurazione del dispositivo sulle istanze di pubblicazione step-publishing-device-configuration-to-publish-instances

Verifica il 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 il gruppo screens-devices-master.
  3. Fare clic con il pulsante destro del mouse sul gruppo e scegliere Attiva.
CAUTION
Non attivare il servizio 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 Screens > Dispositivi.
  2. Fare clic su Gestione periferiche nella barra delle azioni.
  3. Fare clic sul dispositivo e fare clic su Attiva nella barra delle azioni, come illustrato nella figura seguente.

schermata_shot_2019-02-21at111036am

NOTE
In alternativa, dopo aver attivato il dispositivo, puoi anche modificare o aggiornare l’URL del server. Dalla barra delle azioni, fare clic su Modifica URL server, come illustrato nella figura seguente. Le modifiche vengono propagate ad AEM Screens Player.

schermata_shot_2019-02-21at105527am

Elenco di controllo pubblicazione publishing-check-list

I punti seguenti riepilogano l'elenco di controllo per la pubblicazione:

  • Utente dispositivo Screens - Queste informazioni sono memorizzate come utente AEM e possono essere attivate da Strumenti > Sicurezza > Utenti. All’utente viene aggiunto il prefisso "screens" con una lunga stringa serializzata.

  • Progetto - Il progetto AEM Screens.

  • Posizione - Posizione a cui è connesso il dispositivo.

  • Canali - Uno o più canali visualizzati nel percorso.

  • Pianificazione - Se utilizzi una pianificazione, assicurati che questa pianificazione sia pubblicata.

  • Posizione, Pianificazioni e Cartella canali - Se le risorse corrispondenti si trovano in una cartella.

Per verificare il comportamento di authoring e pubblicazione, segui i passaggi seguenti:

  1. Aggiorna alcuni contenuti del canale nell’istanza di authoring.
  2. Esegui Gestisci pubblicazione per pubblicare le nuove modifiche in tutte le istanze di pubblicazione.
  3. Fare clic su Attiva per abilitare il dispositivo da Gestione dispositivi.
  4. Selezionare Modifica URL dall'URL dell'istanza di authoring a uno degli URL delle istanze di pubblicazione.
  5. Verifica che il contenuto del canale aggiornato venga visualizzato in AEM Screens Player.
  6. Ripeti questi passaggi utilizzando un’istanza Publish diversa.

Passaggio 5: indirizzare il 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 l’angolo in alto a sinistra in modo da poter aprire il menu Amministratore, sul lettore AEM Screens touch o utilizzando un mouse.
  2. Fare clic sull'opzione Configurazione nel pannello laterale.
  3. Cambia l'istanza Autore in istanza Pubblica 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 fai clic sulla cartella Dispositivi.
  2. Fare clic su Gestione periferiche nella barra delle azioni.
  3. Fare clic sul dispositivo, quindi sulla barra delle azioni fare clic su Modifica URL server, come illustrato nella figura seguente. Le modifiche vengono propagate ad AEM Screens Player.

schermata_shot_2019-02-07at31028pm

La funzionalità Manage Publication consente di fornire aggiornamenti del contenuto da Authoring a Pubblicazione sul dispositivo. Puoi pubblicare/annullare la pubblicazione dei contenuti per l’intero progetto AEM Screens o solo per uno dei tuoi canali, posizione, dispositivo, applicazione o pianificazione. Per ulteriori informazioni su questa funzione, vedere Aggiornamento dei contenuti on demand.

Risolvere i problemi relativi ai suggerimenti troubleshoot-tips

Leggi la sezione seguente per ottenere risposte alle domande frequenti relative alle impostazioni di authoring e pubblicazione.

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

Soluzione - Imposta Proxy/Load Balancer Connection in the Jetty configuration su true.

Come aggiornare il contenuto offline e scaricare il lettore con risorse esterne a /content/dam/projects/<project>? update-offline-content

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

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

Soluzione - Verificare 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’istanza di authoring a quella di pubblicazione.

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