AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.
Gli agenti di replica sono fondamentali per Adobe Experience Manager (AEM) come meccanismo utilizzato per:
Le richieste sono in coda all'agente competente per il trattamento.
I dati utente (utenti, gruppi di utenti e profili utente) non vengono replicati tra le istanze di authoring e pubblicazione.
Per più istanze di pubblicazione, i dati utente sono distribuiti Sling quando Sincronizzazione utente è abilitato.
La replica, su un’istanza o un dispatcher di pubblicazione, avviene in diversi passaggi:
l'autore chiede che determinati contenuti siano pubblicati (attivati); questo può essere avviato da una richiesta manuale o da attivatori automatici preconfigurati.
la richiesta viene trasmessa all’agente di replica predefinito appropriato; un ambiente può avere diversi agenti predefiniti che saranno sempre selezionati per tali azioni.
l’agente di replica "crea un pacchetto" per il contenuto e lo inserisce nella coda di replica.
nella scheda Siti web indicatore di stato colorato è impostato per le singole pagine.
il contenuto viene rimosso dalla coda e trasportato all’ambiente di pubblicazione utilizzando il protocollo configurato; di solito questo è HTTP.
un servlet nell’ambiente di pubblicazione riceve la richiesta e pubblica il contenuto ricevuto; il servlet predefinito è http://localhost:4503/bin/receive
.
è possibile configurare più ambienti di authoring e pubblicazione.
Alcune funzioni consentono agli utenti di immettere dati in un’istanza di pubblicazione.
In alcuni casi, è necessario un tipo di replica noto come replica inversa per restituire questi dati all’ambiente di authoring da cui viene ridistribuito ad altri ambienti di pubblicazione. Per motivi di sicurezza, il traffico dall’ambiente di pubblicazione a quello di authoring deve essere rigorosamente controllato.
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. A questa casella in uscita corrispondono ascoltatori di replica nell’ambiente di authoring. Gli ascoltatori raccolgono le caselle in uscita per raccogliere tutti i dati immessi e quindi li distribuiscono secondo necessità. In questo modo l’ambiente di authoring controlla tutto il traffico.
In altri casi, ad esempio per le funzioni di Communities (ad esempio, forum, blog, commenti e revisioni), è difficile sincronizzare in modo efficiente tra le istanze AEM utilizzando la replica la quantità di contenuto generato dall’utente (UGC) inserito nell’ambiente di pubblicazione.
AEM Community non utilizza mai la replica per UGC. Al contrario, la distribuzione per Communities richiede un archivio comune per UGC (vedi Archiviazione dei contenuti della community).
Il sito web Geometrixx incluso in un'installazione standard di AEM può essere utilizzato per illustrare la replica.
Per seguire questo esempio e utilizzare gli agenti di replica predefiniti è necessario Installa AEM con:
4502
4503
Opzione attivata per impostazione predefinita :
Effettivamente disattivato per impostazione predefinita (a partire dal AEM 6.1) :
Per controllare lo stato dell'agente o della coda, utilizza il Strumenti console.
Vedi Monitoraggio degli agenti di replica.
Passa alla pagina di supporto nell’ambiente di authoring.
http://localhost:4502/content/geometrixx/en/support.html
Modificare la pagina per aggiungere del nuovo testo.
Attiva pagina per pubblicare le modifiche.
Apri la pagina di supporto nell’ambiente di pubblicazione:
http://localhost:4503/content/geometrixx/en/support.html
È ora possibile visualizzare le modifiche inserite durante l’authoring.
Questa replica viene eseguita dall’ambiente di authoring tramite:
Agente predefinito (pubblicazione)
Questo agente replica il contenuto nell’istanza di pubblicazione predefinita.
I dettagli (configurazione e registri) sono accessibili dalla console Strumenti dell’ambiente di authoring; o:
http://localhost:4502/etc/replication/agents.author/publish.html
.
I seguenti agenti sono disponibili in un'installazione standard AEM:
Agente predefinito - Utilizzato per la replica dall’autore alla pubblicazione.
Dispatcher Flush - Viene utilizzato per gestire la cache del Dispatcher. Vedi Annullamento della validità della cache del Dispatcher dall’ambiente di authoring e Annullamento della validità della cache del Dispatcher da un’istanza di pubblicazione per ulteriori informazioni.
Replica inversa - Utilizzato per la replica da pubblicazione a authoring. La replica inversa non viene utilizzata per le funzioni di Communities, ad esempio forum, blog e commenti. È disabilitata in modo efficace 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 il formato di risorsa appropriato. Consulta la sezione Settings
e Rules
schede per la configurazione. Questo è stato richiesto in modo che, quando la pagina viene richiesta direttamente dal server dell'applicazione, il contenuto possa essere visualizzato. Si tratta di un agente specializzato e (probabilmente) non sarà necessario per la maggior parte delle istanze.
Durante la configurazione di un agente di replica dalla console Strumenti, nella finestra di dialogo sono disponibili quattro schede:
Nome
Un nome univoco per l'agente di replica.
Descrizione
Descrizione dello scopo che verrà utilizzato da questo agente di replica.
abilitato
Indica se l'agente di replica è attualmente abilitato.
Quando l'agente è abilitato la coda verrà visualizzata come:
Tipo di serializzazione
Tipo di serializzazione:
Ritardo per riprovare
Il ritardo (in millisecondi) tra due tentativi, in caso di problemi.
Predefiniti: 60000
ID utente agente
A seconda dell’ambiente, l’agente utilizza questo account utente per:
Lascia vuoto questo campo per utilizzare l’account utente di sistema (l’account definito in sling come utente amministratore); per impostazione predefinita admin
).
Per un agente nell’ambiente di authoring, questo account deve accedere in lettura a tutti i percorsi che si desidera replicare.
Per un agente nell'ambiente di pubblicazione questo account deve dispongono dell’accesso di creazione/scrittura necessario per replicare il contenuto.
Può essere utilizzato come meccanismo per selezionare contenuti specifici per la replica.
Livello registro
Specifica il livello di dettaglio da utilizzare per i messaggi di log.
Error
: verranno registrati solo gli erroriInfo
: verranno registrati errori, avvisi e altri messaggi informativiDebug
: nei messaggi verrà utilizzato un alto livello di dettaglio, principalmente a scopo di debugPredefiniti: Info
Usa per replica inversa
Indica se questo agente verrà utilizzato per la replica inversa; restituisce l’input dell’utente dall’ambiente di pubblicazione a quello di authoring.
Aggiornamento alias
Selezionando questa opzione, le richieste di annullamento della validità di un alias o di un percorso personalizzato vengono abilitate in Dispatcher. Vedi anche Configurazione di un agente di svuotamento del dispatcher.
URI
Specifica il servlet di ricezione nella posizione di destinazione. In particolare, qui puoi specificare il nome host (o alias) e il percorso contestuale dell’istanza di destinazione.
Ad esempio:
http://localhost:4503/bin/receive
http://localhost:8000/dispatcher/invalidate.cache
Il metodo di trasporto sarà determinato dal protocollo qui specificato (HTTP o HTTPS).
Per gli agenti Dispatcher Flush, la proprietà URI viene utilizzata solo se si utilizzano voci virtualhost basate sul percorso per differenziare tra le farm, utilizzando questo campo per indirizzare la farm per annullare la validità. Ad esempio, la farm n. 1 ha l’host virtuale www.mysite.com/path1/*
e la farm n. 2 ha l’host virtuale www.mysite.com/path2/*
. Puoi utilizzare l’URL /path1/invalidate.cache
per individuare la prima farm e /path2/invalidate.cache
per individuare la seconda farm.
User
Nome utente dell’account da utilizzare per accedere alla destinazione.
Password
Password dell’account da utilizzare per accedere alla destinazione.
Dominio NTLM
Dominio per l’autenticazione NTML.
Host NTLM
Host per l’autenticazione NTML.
Abilita SSL relaxed
Abilita questa opzione se desideri che i certificati SSL autocertificati siano accettati.
Consenti certificati scaduti
Abilita questa opzione se desideri che i certificati SSL scaduti siano accettati.
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
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.
Interfaccia
Qui è possibile definire l'interfaccia socket a cui eseguire il binding.
Imposta l’indirizzo locale da utilizzare per la creazione di connessioni. Se non è impostato, verrà utilizzato l’indirizzo predefinito. Questa opzione è utile per specificare l’interfaccia da utilizzare su sistemi multihomed o cluster.
Metodo HTTP
Il metodo HTTP da utilizzare.
Per un agente Dispatcher Flush questo è quasi sempre GET e non deve essere modificato (POST sarebbe un altro valore possibile).
Intestazioni HTTP
Questi vengono utilizzati per gli agenti di svuotamento del dispatcher e specificano gli elementi che devono essere scaricati.
Per un agente Dispatcher Flush le tre voci standard non devono essere modificate:
CQ-Action:{action}
CQ-Handle:{path}
CQ-Path:{path}
Questi vengono utilizzati, a seconda dei casi, per indicare l'azione da utilizzare per lo scaricamento della maniglia o del percorso. I sottoparametri sono dinamici:
{action}
indica un'azione di replica{path}
indica un percorsoSono sostituiti dal percorso/azione pertinente alla richiesta e quindi non devono essere "hardcoded":
Se hai installato AEM in un contesto diverso da quello predefinito consigliato, dovrai registrare il contesto nelle intestazioni HTTP. Ad esempio:
CQ-Handle:/<*yourContext*>{path}
Chiudi connessione
Abilita la chiusura della connessione dopo ogni richiesta.
Timeout di connessione
Timeout (in millisecondi) da applicare durante il tentativo di stabilire una connessione.
Timeout socket
Timeout (in millisecondi) da applicare in attesa del traffico dopo l’impostazione di una connessione.
Versione protocollo
Versione del protocollo; per esempio 1.0
per HTTP/1.0.
Queste impostazioni vengono utilizzate per definire i trigger per la replica automatizzata:
Ignora predefinito
Se questa opzione è selezionata, l’agente viene escluso dalla replica predefinita; ciò significa che non verrà utilizzato se un autore di contenuti rilascia un’azione di replica.
In caso di modifica
In questo caso, una replica di questo agente verrà attivata automaticamente quando una pagina viene modificata. Viene utilizzato principalmente per gli agenti Dispatcher Flush, ma anche per la replica inversa.
Al momento della distribuzione
Se questa opzione è selezionata, l’agente replicherà automaticamente qualsiasi contenuto contrassegnato per la distribuzione al momento della modifica.
Raggiunto On/Offtime
Questo attiverà la replica automatica (per attivare o disattivare una pagina a seconda delle necessità) quando si verificano i tempi di attivazione o disattivazione definiti per una pagina. Viene utilizzato principalmente per gli agenti Dispatcher Flush.
Al ricevimento
Se questa opzione è selezionata, l’agente eseguirà la replica a catena ogni volta che riceve eventi di replica.
Nessun aggiornamento di stato
Quando 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.
Per informazioni sulla connessione degli agenti di replica all'istanza di pubblicazione utilizzando MSSL, vedi Replicazione con SSL reciproco.
Dalla scheda Strumenti nell’ambiente di authoring è possibile configurare gli agenti di replica che risiedono nell’ambiente di authoring (Agenti sull'autore) o l'ambiente di pubblicazione (Agenti in pubblicazione). Le procedure seguenti illustrano la configurazione di un agente per l’ambiente di authoring, ma possono essere utilizzate per entrambi.
Quando un dispatcher gestisce le richieste HTTP per le istanze di authoring o pubblicazione, la richiesta HTTP dell’agente di replica deve includere l’intestazione PATH. Oltre alla procedura seguente, devi aggiungere l’intestazione PATH all’elenco del dispatcher delle intestazioni client. (Vedi /clientheaders (intestazioni client). 🔗
Accedere al Strumenti in AEM.
Fai clic su Replica (riquadro a sinistra per aprire la cartella).
Fare doppio clic Agenti sull'autore (riquadro a sinistra o a destra).
Fai clic sul nome dell’agente appropriato (che è un collegamento) per visualizzare informazioni dettagliate su tale agente.
Fai clic su Modifica per aprire la finestra di dialogo di configurazione:
I valori forniti devono essere sufficienti per un'installazione predefinita. Se apporti modifiche fai clic su OK per salvarli (vedi Agenti di replica - Parametri di configurazione per ulteriori dettagli sui singoli parametri).
Un'installazione standard di AEM specifica admin
come utente per le credenziali di trasporto all'interno degli agenti di replica predefiniti.
Questo deve essere modificato in un account utente di replica specifico per il sito con i privilegi per replicare i percorsi richiesti.
La replica inversa viene utilizzata per riportare il contenuto dell’utente generato in un’istanza di pubblicazione a un’istanza di authoring. Questa funzione è comunemente utilizzata per funzioni quali sondaggi e moduli di registrazione.
Per motivi di sicurezza, la maggior parte delle topologie di rete non consentono connessioni da la "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 DMZ, per recuperare i contenuti nell’ambiente di authoring la connessione deve essere avviata dall’istanza di authoring. Questa operazione viene eseguita con:
Per AEM Community, la replica non viene utilizzata per i contenuti generati dall’utente in un’istanza di pubblicazione. Vedi Archiviazione dei contenuti della community.
A questo scopo è necessario:
Un agente di replica inversa nell’ambiente di authoring Questo agisce come componente attivo per raccogliere informazioni dalla casella in uscita nell’ambiente di pubblicazione:
Se desideri utilizzare la replica inversa, assicurati che questo agente sia attivato.
Un agente di replica inversa nell’ambiente di pubblicazione (una casella in uscita) Questo è l'elemento passivo in quanto agisce come una "casella in uscita". L’input dell’utente viene inserito qui, da dove viene raccolto dall’agente nell’ambiente di authoring.
Viene replicato solo il contenuto - i dati utente non lo sono (utenti, gruppi di utenti e profili utente).
Per sincronizzare i dati utente tra più istanze di pubblicazione, abilita Sincronizzazione utente.
Al momento dell’installazione, è già configurato un agente predefinito per la replica del contenuto in un’istanza di pubblicazione in esecuzione sulla porta 4503 del localhost.
Per configurare la replica dei contenuti per un’istanza di pubblicazione aggiuntiva è necessario creare e configurare un nuovo agente di replica:
Apri Strumenti in AEM.
Seleziona Replica, quindi Agenti sull'autore nel pannello a sinistra.
Seleziona Nuovo….
Imposta la Titolo e Nome, quindi seleziona Agente di replica.
Fai clic su Crea per creare il nuovo agente.
Fai doppio clic sul nuovo elemento dell'agente per aprire il pannello di configurazione.
Fai clic su Modifica - il Impostazioni agente viene aperta la finestra di dialogo - Tipo di serializzazione è già definito come predefinito, ma deve rimanere tale.
In Impostazioni scheda:
60000
.Default
.In Trasporti scheda:
Inserisci l’URI richiesto per la nuova istanza di pubblicazione; ad esempio,
http://localhost:4504/bin/receive
.
Immettere l'account utente specifico del sito utilizzato per la replica.
Puoi configurare altri parametri come necessario.
Fai clic su OK per salvare le impostazioni.
Puoi quindi testare l’operazione aggiornando e pubblicando una pagina nell’ambiente di authoring.
Gli aggiornamenti vengono visualizzati su tutte le istanze di pubblicazione configurate come sopra.
In caso di problemi, puoi controllare i registri nell’istanza di authoring. A seconda del livello di dettaglio richiesto, è anche possibile impostare Livello di log a Debug
utilizzando Impostazioni agente finestra di dialogo come sopra.
Questo può essere combinato con l'uso del ID utente agente per selezionare contenuti diversi da replicare nei singoli ambienti di pubblicazione. Per ogni ambiente di pubblicazione:
Gli agenti predefiniti sono inclusi nell’installazione. Tuttavia, è ancora necessaria una certa configurazione e lo stesso vale se definisci un nuovo agente:
Apri Strumenti in AEM.
Fai clic su Distribuzione.
Seleziona Replica e poi Agenti in pubblicazione.
Fai doppio clic sul pulsante Flush del Dispatcher per aprire la panoramica.
Fai clic su Modifica - il Impostazioni agente viene aperta la finestra di dialogo:
In Impostazioni scheda:
Dispatcher Flush
o impostalo come tale se crei un nuovo agente.In Trasporti scheda:
Inserisci l’URI richiesto per la nuova istanza di pubblicazione; ad esempio,
http://localhost:80/dispatcher/invalidate.cache
.
Immettere l'account utente specifico del sito utilizzato per la replica.
Puoi configurare altri parametri come necessario.
Per gli agenti Dispatcher Flush, la proprietà URI viene utilizzata solo se si utilizzano voci virtualhost basate sul percorso per differenziare tra le farm, utilizzando questo campo per indirizzare la farm per annullare la validità. Ad esempio, la farm n. 1 ha l’host virtuale www.mysite.com/path1/*
e la farm n. 2 ha l’host virtuale www.mysite.com/path2/*
. Puoi utilizzare l’URL /path1/invalidate.cache
per individuare la prima farm e /path2/invalidate.cache
per individuare la seconda farm.
Se hai installato AEM in un contesto diverso da quello predefinito consigliato, devi configurare la Intestazioni HTTP in Esteso scheda .
Fai clic su OK per salvare le modifiche.
Torna a Strumenti da qui puoi Attiva la Flush del Dispatcher agente (Agenti in pubblicazione).
La Flush del Dispatcher l'agente di replica non è attivo sull'autore. È possibile accedere alla stessa pagina nell’ambiente di pubblicazione utilizzando l’URI equivalente; ad esempio, http://localhost:4503/etc/replication/agents.publish/flush.html
.
L'accesso alle pagine utilizzate per configurare gli agenti di replica può essere controllato utilizzando le autorizzazioni di pagina utente e/o gruppo nella etc/replication
nodo.
L’impostazione di tali autorizzazioni non avrà alcun effetto sugli utenti che replicano il contenuto (ad esempio, dalla console Siti web o dall’opzione della barra laterale). Il framework di replica non utilizza la "sessione utente" dell'utente corrente per accedere agli agenti di replica durante la replica delle pagine.
[NOTA!]
La creazione di agenti di replica è supportata solo nel
/etc/replication
posizione del repository. Questo è necessario per gestire correttamente le ACL associate. La creazione di un agente di replica in un'altra posizione della struttura potrebbe causare l'accesso non autorizzato.
È possibile configurare diversi parametri degli agenti di replica utilizzando CRXDE Lite.
Se passi a /etc/replication
puoi vedere i tre nodi seguenti:
agents.author
agents.publish
treeactivation
I due agents
conservare le informazioni di configurazione relative all'ambiente appropriato e sono attive solo quando l'ambiente è in esecuzione. Ad esempio: agents.publish
verranno utilizzati solo nell’ambiente di pubblicazione. La schermata seguente mostra l’agente di pubblicazione nell’ambiente di authoring, come incluso in AEM WCM:
Per monitorare un agente di replica:
Accedere al Strumenti in AEM.
Fai clic su Replica.
Fare doppio clic sul collegamento agli agenti per l’ambiente appropriato (nel riquadro a sinistra o a destra); per esempio Agenti sull'autore.
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:
È possibile:
Non utilizzare il collegamento "Prova connessione" per la casella in uscita Replicazione inversa in un'istanza di pubblicazione.
Se viene eseguito un test di replica per una coda in uscita, tutti gli elementi più vecchi della replica di test verranno rielaborati con ogni replica inversa.
Se tali elementi esistono già in una coda, possono essere trovati con la seguente query XPath JCR e devono essere rimossi.
/jcr:root/var/replication/outbox//*[@cq:repActionType='TEST']
La replica batch non replica singole pagine o risorse, ma attende l’attivazione della prima soglia dei due, in base a tempo o dimensioni.
Poi comprime tutti gli elementi di replica in un pacchetto, che viene replicato come un singolo file all'editore.
L'editore decomprime tutti gli elementi, li salva e crea un rapporto all'autore.
http://serveraddress:serverport/siteadmin
http://serveraddress:serverport/etc/replication/agents.author/publish.html
Enable Batch Mode
- abilita o disabilita la modalità di replica batchMax Wait Time
- Tempo massimo di attesa per l'avvio di una richiesta batch, in secondi. Il valore predefinito è 2 secondi.Trigger Size
- Avvia la replica in batch quando questo limite di dimensione viene raggiunto, in MB. Il valore predefinito è 5 MB.Per informazioni dettagliate sulla risoluzione dei problemi, consulta la sezione Risoluzione dei problemi di replica pagina.
Per ulteriori informazioni, Adobe dispone di una serie di articoli della Knowledge Base relativi alla replica:
https://helpx.adobe.com/it/experience-manager/kb/ReplicationSiblingReordering.html
https://helpx.adobe.com/it/experience-manager/kb/ReplicationFailureAfterNewIP.html
https://helpx.adobe.com/it/experience-manager/kb/LimitAccessToReplicationAgents.html
https://helpx.adobe.com/experience-manager/kb/PagePermissionsNotReplicatedWithUser.html
https://helpx.adobe.com/it/experience-manager/kb/HowToUseReverseReplication.html
https://helpx.adobe.com/it/experience-manager/kb/CQ5ReplicateToSpecificAgents.html
https://helpx.adobe.com/it/experience-manager/kb/ReplicationListener.html
https://helpx.adobe.com/experience-manager/kb/replication-stuck.html
https://helpx.adobe.com/it/experience-manager/kb/replication-privileges-missing-after-upgrade-to-cq-5-5.html
https://helpx.adobe.com/it/experience-manager/kb/CQ53UnableToCreateJobQueueDueToMaxQueues.html
https://helpx.adobe.com/it/experience-manager/kb/ACLReplication.html
https://helpx.adobe.com/it/experience-manager/kb/content-grow-due-reverse-replication.html
https://helpx.adobe.com/it/experience-manager/kb/ReplicationAgentUsingAnonUser.html