DocumentazioneAEMGuida di AEM Screens

Configurazione delle istanze di authoring e pubblicazione in AEM Screens configuring-author-and-publish-in-aem-screens

Last update: Tue Apr 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • User

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

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

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

La sezione seguente spiega come impostare gli 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

Impostazione degli agenti di replica sull’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 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. Fai clic su Replica dalla struttura di navigazione a sinistra.

    screen_shot_2019-02-25at24715pm

  3. Fai clic su 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 in modo da poter creare l’agente di replica, quindi fai clic su Crea.

    screen_shot_2019-02-25at25737pm

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

    screen_shot_2019-02-25at30018pm

  6. Clic Modifica.

  7. In Impostazioni agente immetti i dettagli.

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

    screen_shot_2019-02-25at30134pm

  8. 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. Esempio: https://<hostname>:4504/bin/receive?sling:authRequestLogin=1.

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

  1. Creazione di un agente di replica AEM Screens per pub1. Come funzione integrata, esiste un agente di replica Screens che punta alla porta 4503. Abilitala.

  2. Creazione di un agente di replica AEM 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 Publish:

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

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

  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: adattati a IP o subnet che coprono tutte le istanze Publish. Assicurati di whitelist il nome IP/host di tutte le istanze Publish senza il numero di porta.

  5. Abilita Arresto automatico 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 una qualsiasi delle istanze Publish, passa 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. 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 può essere utilizzato nella configurazione OSGi per ActiveMQ.

Poiché ogni istanza Publish, per impostazione predefinita, dispone di chiavi di crittografia 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 Publish:

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

  2. Clic 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 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. Visualizza error.log di ogni istanza in modo da poter vedere che il messaggio è stato inviato e ricevuto nel cluster.
NOTE
L’accesso 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 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. Clic 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 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. Passa a Screens player utilizzando 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: 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 fai clic sul progetto e passa a Dispositivi > Gestione dispositivi.
  2. Clic Registra dispositivo.
  3. Clic Registrazione dispositivo.
  4. Fare clic sul dispositivo da registrare, quindi fare clic su Registra dispositivo.
  5. Verifica il codice di registrazione, quindi fai clic su Convalida.
  6. Inserisci un titolo per il dispositivo, quindi 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. Fai clic sul percorso di visualizzazione del canale dalla scheda Posizioni cartella.
  3. Clic Assegna.
  4. Clic Fine per completare il processo, e ora il dispositivo viene assegnato.

Controlla il lettore e nota il contenuto aggiunto nel 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 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. Fare clic sul dispositivo e fare 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. Clic Modifica URL server dalla barra delle azioni, come illustrato nella figura seguente, le modifiche vengono propagate al lettore AEM Screens.

screen_shot_2019-02-21at105527am

Pubblicazione elenco di controllo publishing-check-list

I punti seguenti riepilogano 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 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 sia pubblicata

  • Cartella posizioni, pianificazioni e canali - se le risorse corrispondenti si trovano all’interno di 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 su tutte le istanze Publish.
  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 Publish 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 l’angolo in alto a sinistra in modo da poter aprire il menu di amministrazione, 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 fai clic su Dispositivi cartella.
  2. Clic Gestione dispositivi dalla barra delle azioni.
  3. Fare clic sul dispositivo e fare clic su Modifica URL server dalla barra delle azioni, come illustrato nella figura seguente, e le modifiche vengono propagate al lettore AEM Screens.

screen_shot_2019-02-07at31028pm

Il Gestisci pubblicazione Questa funzione consente di fornire aggiornamenti di 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, 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 utenti di servizi bulk-offline-update-screens e screens-devices-master gruppo per tutti /content/dam o le risorse specifiche che desideri 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’istanza di authoring a quella di pubblicazione.

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