Replica replication
Gli agenti di replica sono centrali per Adobe Experience Manager (AEM) in quanto il meccanismo utilizzato per:
- Pubblicare (attivare) contenuto da un ambiente Author a uno Publish.
- Svuota in modo esplicito il contenuto dalla cache di Dispatcher.
- Restituisce l’input dell’utente (ad esempio, l’input del modulo) dall’ambiente di pubblicazione all’ambiente di authoring (sotto il controllo dell’ambiente di authoring).
Le richieste sono in coda per l'agente appropriato per l'elaborazione.
Replica da authoring a pubblicazione replicating-from-author-to-publish
La replica in un’istanza Publish o Dispatcher viene eseguita in diversi passaggi:
-
l’Autore richiede che determinati contenuti siano pubblicati (attivati); questo può essere avviato da una richiesta manuale o da attivatori automatici preconfigurati.
-
la richiesta viene passata all’agente di replica predefinito appropriato; un ambiente può avere diversi agenti predefiniti sempre selezionati per tali azioni.
-
l’agente di replica "crea pacchetti" del contenuto e lo inserisce nella coda di replica.
-
nella scheda Siti Web l'indicatore di stato colorato è impostato per le singole pagine.
-
il contenuto viene rimosso dalla coda e trasportato nell’ambiente di pubblicazione utilizzando il protocollo configurato; in genere si tratta di HTTP.
-
un servlet nell'ambiente di pubblicazione riceve la richiesta e pubblica il contenuto ricevuto; il servlet predefinito è
https://localhost:4503/bin/receive
. -
è possibile configurare più ambienti Author e Publish.
Replica dalla pubblicazione all’authoring replicating-from-publish-to-author
Alcune funzioni consentono agli utenti di immettere dati in un’istanza Publish.
A volte, per restituire questi dati all’ambiente di authoring da dove vengono ridistribuiti ad altri ambienti di pubblicazione, è necessario un tipo di replica noto come replica inversa. Per motivi di sicurezza, il traffico dall’ambiente di pubblicazione a quello di authoring deve essere controllato rigorosamente.
La replica inversa utilizza un agente nell’ambiente di pubblicazione che fa riferimento all’ambiente di authoring. Questo agente inserisce i dati in una casella in uscita. Questa casella in uscita corrisponde ai listener di replica nell’ambiente di authoring. I listener eseguono il polling delle caselle in uscita per raccogliere i dati immessi e quindi distribuirli in base alle esigenze. In questo modo l’ambiente di authoring controlla tutto il traffico.
Replica: funzioni pronte all’uso replication-out-of-the-box
Crea una pagina seguendo Creazione e organizzazione delle pagine.
Per seguire questo esempio e utilizzare gli agenti di replica predefiniti, installa AEM con:
- ambiente di authoring sulla porta
4502
- ambiente di pubblicazione sulla porta
4503
Questa replica viene eseguita dall’ambiente di authoring in base a:
- Agente predefinito (pubblicazione)
Questo agente replica il contenuto nell’istanza Publish predefinita.
I dettagli di questo (configurazione e registri) sono accessibili dalla console Strumenti dell’ambiente di authoring; oppure:http://localhost:4502/etc/replication/agents.author/publish.html
.
- Agenti per creazione: agente predefinito (pubblicazione). In caso contrario, assicurati di abilitarlo prima di procedere.
- Agenti per creazione: agente di replica inversa (publish_reverse)
- Agenti per pubblicazione : Replica inversa (casella in uscita)
Consulta Monitoraggio degli agenti di replica.
Replica (da autore a pubblicazione) replication-author-to-publish
- Passa alla pagina di supporto nell’ambiente di authoring.
https://localhost:4502/content/site1/test.html<pi>
- Modifica la pagina in modo da poter aggiungere nuovo testo.
- Attiva pagina per pubblicare le modifiche.
- Apri la pagina di supporto nell’ambiente di pubblicazione:
https://localhost:4503/content/site1/test.html - Ora puoi vedere le modifiche inserite al momento dell’authoring.
Agenti di replica - Pronti all’uso replication-agents-out-of-the-box
I seguenti agenti sono disponibili in un’installazione standard di AEM:
-
Agente predefinito
Utilizzato per replicare da Author a Publish. -
Svuotamento Dispatcher
Viene utilizzato per la gestione della cache di Dispatcher. Per ulteriori informazioni, vedere Annullamento della validità della cache di Dispatcher dall'ambiente di authoring e Annullamento della validità della cache di Dispatcher da un'istanza di pubblicazione. -
Replica inversa
Utilizzato per replicare da Publish a Author. La replica inversa non viene utilizzata per le funzioni di Communities, ad esempio forum, blog e commenti. Viene effettivamente disattivata in quanto la casella in uscita non è abilitata. L’utilizzo della replica inversa richiederebbe una configurazione personalizzata. -
Agente statico
Si tratta di un "agente che memorizza una rappresentazione statica di un nodo nel file system".
Ad esempio, con le impostazioni predefinite, le pagine di contenuto e le risorse DAM vengono memorizzate in/tmp
, come HTML o nel formato di risorsa appropriato. Vedere le schedeSettings
eRules
per la configurazione.
Questa richiesta consentiva di visualizzare il contenuto quando la pagina veniva richiesta direttamente dal server dell’applicazione. Si tratta di un agente specializzato e (probabilmente) non è necessario per la maggior parte delle istanze.
Agenti di replica - Parametri di configurazione replication-agents-configuration-parameters
Durante la configurazione di un agente di replica dalla console Strumenti, nella finestra di dialogo sono disponibili quattro schede:
Impostazioni settings
-
Nome
Nome univoco dell’agente di replica.
-
Descrizione
Una descrizione dello scopo fornito da questo agente di replica.
-
Abilitato
Indica se l’agente di replica è abilitato.
Quando l'agente è abilitato, la coda viene visualizzata come:
- Attivo durante l'elaborazione degli elementi.
- Inattivo quando la coda è vuota.
- Bloccato quando gli elementi sono in coda, ma non possono essere elaborati; ad esempio, quando la coda di ricezione è disabilitata.
-
Tipo di serializzazione
Tipo di serializzazione:
- Predefinito: imposta se l'agente deve essere selezionato automaticamente.
- Svuotamento del Dispatcher: selezionare questa opzione se l'agente deve essere utilizzato per svuotare la cache di Dispatcher.
-
Ritardo per riprovare
Ritardo (tempo di attesa in millisecondi) tra due tentativi, in caso di problema.
Predefinito:
60000
-
ID utente agente
A seconda dell’ambiente, l’agente utilizza questo account utente per:
- raccogliere e creare pacchetti di contenuti dall’ambiente di authoring;
- creare e scrivere contenuti nell’ambiente di pubblicazione
Lascia questo campo vuoto per utilizzare l’account utente di sistema (l’account definito in sling come utente amministratore; per impostazione predefinita è
admin
).note caution CAUTION Per un agente nell'ambiente di authoring questo account deve disporre dell'accesso in lettura a tutti i percorsi che si desidera replicare. note caution CAUTION Per un agente nell'ambiente di pubblicazione questo account deve disporre dell'accesso di creazione/scrittura necessario per replicare il contenuto. note note NOTE Può essere utilizzato come meccanismo per selezionare contenuti specifici da replicare. -
Livello registro
Specifica il livello di dettaglio da utilizzare per i messaggi di registro.
Error
: vengono registrati solo gli erroriInfo
: errori, avvisi e altri messaggi informativi registratiDebug
: nei messaggi viene utilizzato un livello di dettaglio elevato, principalmente a scopo di debug
Predefinito:
Info
-
Usa per replica inversa
Indica se questo agente viene utilizzato per la replica inversa; restituisce l'input dell'utente dall'ambiente di pubblicazione all'ambiente di authoring.
-
Aggiornamento alias
Selezionando questa opzione si abilitano le richieste di annullamento della validità di un alias o di un percorso personalizzato a Dispatcher. Vedere anche Configurazione di un agente di svuotamento del Dispatcher.
Trasporto transport
-
URI
Specifica il servlet di ricezione nella posizione di destinazione. In particolare, puoi specificare il nome host (o alias) e il percorso contestuale dell’istanza target qui.
Ad esempio:
- Un agente predefinito può replicare in
https://localhost:4503/bin/receive
- Un agente di Dispatcher Flush può replicarsi in
https://localhost:8000/dispatcher/invalidate.cache
Il protocollo qui specificato (HTTP o HTTPS) determina il metodo di trasporto.
Per gli agenti di Dispatcher Flush, la proprietà URI viene utilizzata solo se utilizzi voci virtualhost basate sul percorso per differenziare le farm. Utilizza questo campo per individuare la farm da invalidare. Ad esempio, la farm n. 1 ha l’host virtuale
www.mysite.com/path1/*
e la farm n. 2 ha l’host virtualewww.mysite.com/path2/*
. È possibile utilizzare l'URL/path1/invalidate.cache
per individuare la prima farm e/path2/invalidate.cache
per individuare la seconda farm. - Un agente predefinito può replicare in
-
Utente
Il nome utente dell’account da utilizzare per accedere alla destinazione.
-
Password
Password per l’account da utilizzare per accedere alla destinazione.
-
Dominio NTLM
Dominio per autenticazione NTML.
-
Host NTLM
Host per autenticazione NTML.
-
Abilita SSL rilassato
Abilita questa opzione se desideri che i certificati SSL autocertificati vengano accettati.
-
Consenti certificati scaduti
Abilita questa opzione se desideri che vengano accettati i certificati SSL scaduti.
Proxy proxy
Le seguenti impostazioni sono necessarie solo se è necessario un proxy:
-
Host proxy
Nome host del proxy utilizzato per il trasporto.
-
Porta proxy
Porta del proxy.
-
Utente proxy
Il nome utente dell’account da utilizzare.
-
Password proxy
Password dell’account da utilizzare.
-
Dominio proxy NTLM
Dominio proxy NTLM.
-
Host proxy NTLM
Dominio proxy NTLM.
Esteso extended
-
Interfaccia
Qui puoi definire l’interfaccia socket a cui effettuare l’associazione.
Consente di impostare l'indirizzo locale da utilizzare per la creazione di connessioni. Se non è impostato, viene utilizzato l’indirizzo predefinito. Questo è utile per specificare l'interfaccia da utilizzare su sistemi multi-homed o cluster.
-
Metodo HTTP
Il metodo HTTP da utilizzare.
Per un agente di Dispatcher Flush, questo è quasi sempre GET e non deve essere modificato (POST sarebbe un altro valore possibile).
-
Intestazioni HTTP
Vengono utilizzati per gli agenti di Dispatcher Flush e specificano gli elementi che devono essere scaricati.
Per un agente di Dispatcher Flush, non è necessario modificare le tre voci standard:
CQ-Action:{action}
CQ-Handle:{path}
CQ-Path:{path}
Questi vengono utilizzati, a seconda dei casi, per indicare l'azione da eseguire durante lo scaricamento dell'handle o del percorso. I sottoparametri sono dinamici:
-
{action}
indica un'azione di replica -
{path}
indica un percorso
Sono sostituite dal percorso/azione pertinente alla richiesta e pertanto non devono essere "hardcoded":
note note NOTE Se hai installato AEM in un contesto diverso da quello predefinito consigliato, devi registrare il contesto nelle intestazioni HTTP. Ad esempio: CQ-Handle:/<*yourContext*>{path}
-
Chiudi connessione
Abilita questa opzione in modo da poter chiudere la connessione dopo ogni richiesta.
-
Timeout connessione
Timeout (in millisecondi) da applicare quando si tenta di stabilire una connessione.
-
Timeout socket
Timeout (in millisecondi) da applicare quando si attende il traffico dopo che è stata stabilita una connessione.
-
Versione protocollo
Versione del protocollo. Ad esempio,
1.0
per HTTP/1.0.
Trigger triggers
Queste impostazioni vengono utilizzate per definire i trigger per la replica automatizzata:
-
Ignora predefinito
Se selezionato, l'agente viene escluso dalla replica predefinita, ovvero non viene utilizzato se un autore di contenuto esegue un'azione di replica.
-
In caso di modifica
In questo caso, quando viene modificata una pagina, viene attivata automaticamente una replica da parte di questo agente. Utilizzato per gli agenti di Dispatcher Flush, ma anche per la replica inversa.
-
Alla distribuzione
Se selezionato, l'agente replica automaticamente qualsiasi contenuto contrassegnato per la distribuzione quando viene modificato.
-
Ora di attivazione/disattivazione raggiunta
Questa funzione attiva la replica automatica (per attivare o disattivare una pagina in base alle esigenze) quando si verificano i tempi di attivazione o disattivazione definiti per una pagina. Viene utilizzato principalmente per gli agenti di Dispatcher Flush.
-
Alla ricezione
Se questa opzione è selezionata, le catene di agenti vengono replicate ogni volta che ricevono eventi di replica.
-
Nessun aggiornamento di stato
Se questa opzione è selezionata, l’agente non forza un aggiornamento dello stato di replica.
-
Nessun controllo delle versioni
Se questa opzione è selezionata, l'agente non forza il controllo delle versioni delle pagine attivate.
Configurazione degli agenti di replica configuring-your-replication-agents
Configurazione degli agenti di replica dall’ambiente di authoring configuring-your-replication-agents-from-the-author-environment
Dalla scheda Strumenti nell'ambiente di authoring, è possibile configurare gli agenti di replica che risiedono nell'ambiente di authoring (Agenti nell'ambiente di authoring) o nell'ambiente di pubblicazione (Agenti nella pubblicazione). Le procedure seguenti illustrano la configurazione di un agente per l’ambiente di authoring, ma possono essere utilizzate per entrambi.
-
Accedi alla scheda Strumenti in AEM.
-
Fai clic su Replica (riquadro a sinistra per aprire la cartella).
-
Fare doppio clic su Agenti in Author (nel riquadro sinistro o destro).
-
Fai clic sul nome dell’agente appropriato (che è un collegamento) per visualizzare informazioni dettagliate su tale agente.
-
Fare clic su Modifica per aprire la finestra di dialogo di configurazione:
-
I valori forniti devono essere sufficienti per un'installazione predefinita. Se si apportano modifiche, fare clic su OK per salvarle (vedere Agenti di replica - Parametri di configurazione per informazioni sui singoli parametri).
admin
come utente per le credenziali di trasporto all'interno degli agenti di replica predefiniti.Configurazione della replica inversa configuring-reverse-replication
La replica inversa viene utilizzata per riportare il contenuto dell’utente generato in un’istanza Publish a un’istanza Author. Questa funzione è comunemente utilizzata per funzioni quali sondaggi e moduli di registrazione.
Per motivi di sicurezza, la maggior parte delle topologie di rete non consente connessioni da alla "zona demilitarizzata" (una sottorete che espone i servizi esterni a una rete non attendibile come Internet).
Poiché l’ambiente di pubblicazione si trova in genere nella zona demilitarizzata, per riportare il contenuto nell’ambiente di authoring la connessione deve essere avviata dall’istanza di authoring. Questa operazione viene eseguita con:
- una casella in uscita nell'ambiente di pubblicazione in cui viene inserito il contenuto.
- un agente (pubblicazione) nell’ambiente di authoring che esegue periodicamente il polling della casella in uscita per i nuovi contenuti.
A questo scopo, è necessario:
Agente di replica inversa nell'ambiente di authoring - Agisce come componente attivo per raccogliere informazioni dalla cartella Posta in uscita nell'ambiente di pubblicazione:
Se desideri utilizzare la replica inversa, assicurati che questo agente sia attivato.
Agente di replica inversa nell'ambiente di pubblicazione (casella in uscita) - L'elemento passivo funge da casella in uscita. L’input dell’utente viene inserito qui, da dove viene raccolto dall’agente nell’ambiente di authoring.
Configurazione della replica per più istanze di pubblicazione configuring-replication-for-multiple-publish-instances
Dopo l'installazione, un agente predefinito è già configurato per la replica del contenuto in un'istanza Publish in esecuzione sulla porta 4503 dell'host locale.
Per configurare la replica dei contenuti per un’ulteriore istanza Publish, crea e configura un nuovo agente di replica:
-
Apri la scheda Strumenti in AEM.
-
Seleziona Replica, quindi Agenti per creazione nel pannello a sinistra.
-
Seleziona Nuovo….
-
Imposta Title e Name, quindi seleziona Replication Agent.
-
Fai clic su Crea per creare l'agente.
-
Fai doppio clic sul nuovo elemento agente per aprire il pannello di configurazione.
-
Fare clic su Modifica. Verrà visualizzata la finestra di dialogo Impostazioni agente. Il tipo di serializzazione è già definito come predefinito, ma deve rimanere tale.
-
Nella scheda Impostazioni:
-
Attiva Abilitato.
-
Immetti una Descrizione.
-
Imposta Ritardo per riprovare su
60000
. -
Lascia Tipo di serializzazione come
Default
.
-
-
Nella scheda Trasporto:
-
Immetti l’URI richiesto per la nuova istanza Publish; ad esempio,
https://localhost:4504/bin/receive
. -
Immettere l'account utente specifico del sito utilizzato per la replica.
-
Se necessario, puoi configurare altri parametri.
-
-
-
Fai clic su OK.
Puoi quindi verificare l’operazione aggiornando e pubblicando una pagina nell’ambiente di authoring.
Gli aggiornamenti vengono visualizzati in tutte le istanze Publish configurate come sopra.
In caso di problemi, puoi controllare i registri nell’istanza Autore. A seconda del livello di dettaglio richiesto, è inoltre possibile impostare Log Level su Debug
utilizzando la finestra di dialogo Agent Settings come indicato sopra.
- Configura un agente di replica per la replica nell’ambiente di pubblicazione.
- Configurare un account utente con i diritti di accesso necessari per leggere il contenuto replicato in tale ambiente di pubblicazione specifico.
- Assegnare l'account utente come ID utente agente per l'agente di replica.
Configurazione di un agente di Dispatcher Flush configuring-a-dispatcher-flush-agent
Gli agenti predefiniti sono inclusi nell'installazione. Tuttavia, è ancora necessaria una determinata configurazione e lo stesso vale se si sta definendo un nuovo agente:
-
Apri la scheda Strumenti in AEM.
-
Fare clic su Distribuzione.
-
Selezionare Replica e quindi Agenti nella pubblicazione.
-
Fai doppio clic sull'elemento Svuotamento del Dispatcher per aprire la panoramica.
-
Fare clic su Modifica. Verrà visualizzata la finestra di dialogo Impostazioni agente:
-
Nella scheda Impostazioni:
-
Attiva Abilitato.
-
Immetti una Descrizione.
-
Lasciare Tipo di serializzazione come
Dispatcher Flush
o impostarlo come tale se si crea un agente. -
(facoltativo) Seleziona Aggiornamento alias per abilitare le richieste di annullamento della validità di un alias o di un percorso personalizzato in Dispatcher.
-
-
Nella scheda Trasporto:
-
Immetti l’URI richiesto per la nuova istanza Publish; ad esempio,
https://localhost:80/dispatcher/invalidate.cache
. -
Immettere l'account utente specifico del sito utilizzato per la replica.
-
Se necessario, puoi configurare altri parametri.
-
Per gli agenti di Dispatcher Flush, la proprietà URI viene utilizzata solo se utilizzi voci virtualhost basate sul percorso per differenziare le farm. Utilizza questo campo per individuare la farm da invalidare. Ad esempio, la farm n. 1 ha l’host virtuale
www.mysite.com/path1/*
e la farm n. 2 ha l’host virtualewww.mysite.com/path2/*
. È possibile utilizzare l'URL/path1/invalidate.cache
per individuare la prima farm e/path2/invalidate.cache
per individuare la seconda farm.note note NOTE Se hai installato AEM in un contesto diverso da quello predefinito consigliato, configura le intestazioni HTTP nella scheda Extended. -
-
Fai clic su OK.
-
Torna alla scheda Strumenti, da qui puoi Attivare l'agente Svuotamento del Dispatcher (Agenti alla pubblicazione).
L'agente di replica Dispatcher Flush non è attivo nell'istanza di authoring. È possibile accedere alla stessa pagina nell'ambiente di pubblicazione utilizzando l'URI equivalente, ad esempio https://localhost:4503/etc/replication/agents.publish/flush.html
.
Controllo dell’accesso agli agenti di replica controlling-access-to-replication-agents
L'accesso alle pagine utilizzate per configurare gli agenti di replica può essere controllato utilizzando le autorizzazioni per le pagine utente e/o di gruppo nel nodo etc/replication
.
Configurazione degli agenti di replica da CRXDE Lite configuring-your-replication-agents-from-crxde-lite
/etc/replication
. Questo è necessario per gestire correttamente gli ACL associati. La creazione di un agente di replica in un'altra posizione della struttura potrebbe comportare l'accesso non autorizzato.È possibile configurare vari parametri degli agenti di replica utilizzando CRXDE Lite.
Se si passa a /etc/replication
, è possibile visualizzare i tre nodi seguenti:
agents.author
agents.publish
treeactivation
I due agents
contengono informazioni di configurazione sull'ambiente appropriato e sono attivi solo quando tale ambiente è in esecuzione. Ad esempio, agents.publish
è utilizzato solo nell'ambiente di pubblicazione. La schermata seguente mostra l’agente di pubblicazione nell’ambiente di authoring, incluso in AEM WCM:
Monitoraggio degli agenti di replica monitoring-your-replication-agents
Per monitorare un agente di replica:
-
Accedi alla scheda Strumenti in AEM.
-
Fare clic su Replica.
-
Fare doppio clic sul collegamento agli agenti per l'ambiente appropriato (nel riquadro sinistro o destro). Ad esempio, Agenti su Author.
La finestra risultante mostra una panoramica di tutti gli agenti di replica per l’ambiente di authoring, inclusi la destinazione e lo stato.
-
Fai clic sul nome dell’agente appropriato (che è un collegamento) per visualizzare informazioni dettagliate su tale agente:
Qui puoi effettuare le seguenti operazioni:
-
Verifica se l’agente è abilitato.
-
Visualizza la destinazione di qualsiasi replica.
-
Verifica se la coda di replica è attiva (abilitata).
-
Verifica se sono presenti elementi nella coda.
-
Aggiorna o Cancella per aggiornare la visualizzazione delle voci della coda. Questo ti aiuta a vedere che gli elementi entrano ed escono dalla coda.
-
Visualizza registro per accedere al registro di tutte le azioni eseguite dall'agente di replica.
-
Verifica connessione all'istanza di destinazione.
-
Forza nuovo tentativo su qualsiasi elemento della coda, se necessario.
note caution CAUTION Non utilizzare il collegamento "Prova connessione" per la cartella Posta in uscita di replica inversa in un'istanza Publish. Se viene eseguito un test di replica per una coda Posta in uscita, tutti gli elementi precedenti alla replica del test vengono rielaborati con ogni replica inversa. Se tali elementi sono presenti in una coda, è possibile trovarli con la seguente query XPath JCR e devono essere rimossi. /jcr:root/var/replication/outbox//*[@cq:repActionType='TEST']
-
Replica in batch batch-replication
La replica batch non replica singole pagine o risorse, ma attende l’attivazione della prima soglia delle due, in base al tempo o alle dimensioni.
Tutti gli elementi di replica vengono quindi inseriti in un pacchetto, che viene quindi replicato come un singolo file nel server di pubblicazione.
Il server di pubblicazione decomprime tutti gli elementi, li salva e riporta all'autore.
Configurazione della replica in batch configuring-batch-replication
- Vai a
http://serveraddress:serverport/siteadmin
- Premi l'icona Strumenti nella parte superiore dello schermo
- Dalla barra di navigazione a sinistra, vai a Replica - Agenti in Author e fai doppio clic su Agente predefinito.
- È inoltre possibile raggiungere l'agente di replica di pubblicazione predefinito accedendo direttamente a
http://serveraddress:serverport/etc/replication/agents.author/publish.html
- È inoltre possibile raggiungere l'agente di replica di pubblicazione predefinito accedendo direttamente a
- Premere il pulsante Modifica sopra la coda di replica.
- Nella finestra seguente, passare alla scheda Batch:
- Configura l’agente.
Parametri parameters
Enable Batch Mode
- abilita o disabilita la modalità di replica batchMax Wait Time
- Tempo di attesa massimo per l'avvio di una richiesta batch, in secondi. Il valore predefinito è 2 secondi.Trigger Size
- Avvia la replica batch quando questo limite di dimensioni
Risorse aggiuntive additional-resources
Per informazioni dettagliate sulla risoluzione dei problemi, leggere la pagina Risoluzione dei problemi di replica.