Configurazione di Author e Publish in AEM Screens

Questa pagina evidenzia i seguenti argomenti:

• Configurazione delle istanze di authoring e pubblicazione
• Impostazione della topologia di pubblicazione
• Gestione della pubblicazione: Distribuzione di aggiornamenti di contenuto da Author a Publish to Device

Prerequisiti

Prima di iniziare a utilizzare i server di authoring e pubblicazione, è necessario disporre di conoscenze precedenti su:

• Topologia AEM
• Creazione e gestione di un progetto AEM Screens
• Processo di registrazione dei dispositivi

Configurazione delle istanze Author e Publish

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

Potete impostare un semplice esempio, in cui ospitate un autore e due istanze di pubblicazione:

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

Impostazione degli agenti di replica sull’autore

Per creare agenti di replica, devi imparare a creare un agente di replica standard.

Sono necessari 3 agenti di replica per Screens:

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

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

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

   

2. Seleziona Replica dalla struttura di navigazione a sinistra.

   

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

   

4. Immetti i valori Titolo e Nome per creare l'agente di replica e fai clic su Crea.

   

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

   

6. Fare clic su Modifica per aprire la finestra di dialogo Impostazioni agente per immettere i dettagli.

   NOTA

   L'utente deve controllare Enabled per abilitare l'agente di replica. È necessario selezionare questa opzione su Default, Screens e Reverse Replication Agent.

   

7. Passa alla scheda Trasporto e immetti l’ URI, Utente e Password.

   

   NOTA

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

Creazione di agenti di replica standard

1. Crea un agente di replica standard per pub1 (è già necessario configurare l'agente predefinito preconfigurato) (ad esempio, https://<hostname>:4503/bin/receive?sling:authRequestLogin=1)
2. Crea un agente di replica standard per pub2. È possibile copiare l'agente rep 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

1. Crea un agente di replica AEM Screens per pub1. Preconfigurato, un agente di replica Screens che punta alla porta 4503. È necessario attivarlo.
2. Crea un agente di replica AEM Screens per pub2. Copia l'agente di replica Screens per pub1 e cambia la porta in punto a 4504 per pub2.

Creazione di agenti di replica inversa Screens

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

Impostazione della topologia di pubblicazione

Passaggio 1: Configurare la scoperta basata su Oak Apache Sling

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 Configurazione Apache Sling Oak-Based Discovery Service .
3. Aggiorna gli URL del connettore topologia: aggiungi gli URL di tutte le istanze di pubblicazione partizionate che sono:
   • https://localhost:4503/libs/sling/topology/connector
   • https://localhost:4504/libs/sling/topology/connector
4. Elenco whitelist del connettore topologia: adattarsi agli IP o alle subnet che coprono le istanze di pubblicazione parziali
5. Abilita Arresto automatico loop locali

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

Passaggio 2: Verifica topologia di pubblicazione

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

Passaggio 3: Configurazione cluster di array ActiveMQ

Questo passaggio ti consente di creare una password crittografata per il cluster ActiveMQ Artemis.
L'utente del 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 ha la propria chiave di crittografia, è necessario utilizzare Crypto Support per creare una stringa di password crittografata. Quindi la password crittografata verrà utilizzata nella configurazione OSGi per ActiveMQ.

In ogni istanza di pubblicazione:

1. Nella console OSGi passa a MAIN —> Supporto di Crypto (https://<host>:<port>/system/console/crypto).
2. Digita la password di testo normale desiderata (stessa per tutte le istanze) in Testo normale
3. Fare clic su Protect.
4. Copia il valore Testo protetto nel blocco note o nell'editor di testo. Questo valore verrà utilizzato nella configurazione OSGi per ActiveMQ.

Poiché ogni istanza di pubblicazione per impostazione predefinita dispone di chiavi di crittografia univoche, devi eseguire questo passaggio su ogni istanza di pub e salvare la chiave univoca per la configurazione successiva.

Passaggio 4: Attiva cluster di array ActiveMQ

Su ogni istanza di pubblicazione:

1. Passa al gestore di configurazione OSGi https://<host>:<port>/system/console/configMgr

2. Seleziona Configurazione di Apache ActiveMQ Artemis JMS Provider

3. Aggiorna quanto segue:

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

Verifica cluster di array ActiveMQ

Segui i passaggi seguenti su ogni istanza di Publish:

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

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

3. Invia un messaggio di test (nella parte superiore dello schermo in Informazioni broker)

4. Immetti le seguenti modifiche nei campi:

   1. Destinazione: /com.adobe.cq.screens/devTestTopic
   2. Testo: Hello World
   3. Visualizza il file error.log di ogni istanza per vedere che il messaggio è stato inviato e ricevuto nel cluster

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

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

Rimuovi requisito intestazione referrer

Segui i passaggi per ogni istanza di Publish:

1. Passa alla console OSGi > Configuration Manager
2. Seleziona Filtro di riferimento Sling Apache
3. Aggiorna la configurazione e controlla Allow Empty

Configurazione dell’istanza di authoring e pubblicazione

Una volta impostata la topologia di pubblicazione, è necessario configurare le istanze di authoring e pubblicazione per visualizzare i risultati pratici dell’implementazione:

Passaggio 1: Avvio di un lettore AEM Screens (dispositivo)

1. Avvia una finestra separata del browser.
2. Passa a Screens Player utilizzando il browser Web, ovverohttps://localhost:4502/content/mobileapps/cq-screens-player/firmware.html o avvia l'app AEM Screens. Una volta aperto il dispositivo, vedrai che lo stato del dispositivo è non registrato.

Passaggio 2: Registrazione di un dispositivo sull'autore

1. Vai a https://localhost:4502/screens.html/content/screens/we-retail o seleziona il progetto e vai a Dispositivi > Gestione dispositivi.
2. Selezionare Registra dispositivo.
3. Fai clic su Registrazione dispositivo per visualizzare il dispositivo.
4. Seleziona il dispositivo da registrare e fai 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 Registra.

Passaggio 3: Assegnazione del dispositivo alla visualizzazione

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

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

Passaggio 4: Pubblicazione della configurazione del dispositivo per pubblicare le istanze

Verifica del dispositivo

Prima di eseguire i passaggi seguenti, assicurati di verificare l'ID dispositivo. Per verificare, cerca l'ID dispositivo in CRXDE Lite, con il percorso /home/users/screens/we-retail/devices.

Segui i passaggi riportati di seguito per replicare l’utente del dispositivo:

1. Passa alla pagina di amministrazione dell’utente (ad esempio: https://localhost:4502/useradmin
2. Cerca il gruppo screens-devices-master
3. Fai clic con il pulsante destro del mouse sul gruppo e fai clic su Attiva

Puoi anche attivare il dispositivo dalla console di gestione dei dispositivi. Effettua le seguenti operazioni:

1. Passa al progetto Screens —> Dispositivi.
2. Fai clic su Gestione dispositivi nella barra delle azioni.
3. Seleziona il dispositivo e fai clic su Attiva nella barra delle azioni, come mostrato nella figura seguente.

Elenco di controllo della pubblicazione

I punti seguenti riepilogano l’elenco Controllo pubblicazione:

• Utente dispositivo Screens : viene memorizzato come utente AEM e può essere attivato da Strumenti > Protezione > Utenti. L’utente avrà 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 nella posizione

• Pianificazione : se utilizzi una pianificazione, assicurati che venga pubblicata

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

Per verificare il comportamento di authoring/pubblicazione, effettua le seguenti operazioni:

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

Passaggio 5: Selezione del dispositivo per la pubblicazione dell’istanza nel pannello di amministrazione

1. Visualizza l'interfaccia utente amministratore da Screens Player, premi a lungo nell'angolo in alto a sinistra per aprire il menu Admin, sul tuo lettore AEM Screens abilitato al tocco o utilizzando un mouse.
2. Fai clic sull'opzione Configurazione nel pannello laterale.
3. Cambia l'istanza dell'autore per pubblicare l'istanza in Server.

Visualizza le modifiche nel lettore AEM Screens.

In alternativa, puoi anche aggiornare/modificare l’URL del server dalla console di gestione dispositivi seguendo i seguenti passaggi:

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

La funzione Gestisci pubblicazione consente di distribuire aggiornamenti dei contenuti dall'autore al dispositivo di pubblicazione. Puoi pubblicare/annullare la pubblicazione dei contenuti per l’intero progetto AEM Screens o solo per uno dei canali, la posizione, il dispositivo, l’applicazione o una pianificazione. Per ulteriori informazioni su questa funzione, consulta Aggiornamento dei contenuti on-demand.