Offload dei processi offloading-jobs

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

Introduzione introduction

Lo scaricamento distribuisce le attività di elaborazione che corrispondono alle istanze di Experience Manager in una topologia. Con lo scaricamento, è possibile utilizzare istanze di Experience Manager specifiche per eseguire tipi specifici di elaborazione. L'elaborazione specializzata consente di ottimizzare l'utilizzo delle risorse server disponibili.

Lo scaricamento è basato su Individuazione Apache Sling e funzioni di Sling JobManager. Per utilizzare lo scaricamento, è necessario aggiungere cluster di Experience Manager a una topologia e identificare gli argomenti del processo che il cluster elabora. I cluster sono costituiti da una o più istanze di Experience Manager, in modo che una singola istanza sia considerata un cluster.

Per informazioni sull'aggiunta di istanze a una topologia, consulta Amministrazione delle topologie.

Distribuzione dei processi job-distribution

Sling JobManager e JobConsumer consentono la creazione di processi elaborati in una topologia:

  • JobManager: Servizio che crea lavori per argomenti specifici.
  • JobConsumer: Servizio che esegue lavori di uno o più argomenti. È possibile registrare più servizi JobConsumer per lo stesso argomento.

Quando JobManager crea un processo, il framework Offloading seleziona un cluster di Experience Manager nella topologia per eseguire il processo:

  • Il cluster deve includere una o più istanze che eseguono un JobConsumer registrato per l'argomento del processo.
  • L'argomento deve essere abilitato per almeno un'istanza nel cluster.

Vedi Configurazione del consumo di argomenti per informazioni sul miglioramento della distribuzione dei processi.

chlimage_1-109

Quando il framework di offload seleziona un cluster per eseguire un processo e il cluster è composto da più istanze, Sling Distribution determina quale istanza nel cluster esegue il processo.

Payload processo job-payloads

Il framework di offload supporta i payload dei processi che associano i processi alle risorse nell’archivio. I payload dei processi sono utili quando vengono creati processi per l’elaborazione delle risorse e il processo viene scaricato in un altro computer.

Al momento della creazione di un processo, è garantito che il payload si trovi solo nell’istanza che crea il processo. Durante lo scaricamento del processo, gli agenti di replica assicurano che il payload venga creato nell’istanza che alla fine consuma il processo. Al termine dell'esecuzione del processo, la replica inversa fa sì che il payload venga copiato nuovamente nell'istanza che ha creato il processo.

Amministrazione delle topologie administering-topologies

Le topologie sono cluster di Experienci Manager ad accoppiamento approssimativo che partecipano allo scarico. Un cluster è costituito da una o più istanze del server Experience Manager (una singola istanza è considerata un cluster).

Ogni istanza di Experience Manager esegue i seguenti servizi relativi allo scaricamento:

  • Servizio di individuazione: Invia richieste a un connettore della topologia per unirsi alla topologia.
  • Connettore topologia: Riceve le richieste di join e accetta o rifiuta ogni richiesta.

Il servizio di individuazione di tutti i membri della topologia punta al connettore topologia su uno dei membri. Nelle sezioni che seguono, questo membro è denominato membro principale.

chlimage_1-110

Ogni cluster nella topologia contiene un'istanza riconosciuta come leader. Il cluster leader interagisce con la topologia per conto degli altri membri del cluster. Quando il riempimento iniziale lascia il cluster, viene automaticamente scelto un nuovo riempimento iniziale per il cluster.

Visualizzazione della topologia viewing-the-topology

Utilizza Browser topologia per esplorare lo stato della topologia a cui partecipa l’istanza di Experience Manager. Browser topologia mostra i cluster e le istanze della topologia.

Per ogni cluster viene visualizzato un elenco di membri del cluster che indica l'ordine in cui ogni membro è entrato nel cluster e quale membro è il membro Leader. La proprietà Current indica l'istanza attualmente amministrata.

Per ogni istanza del cluster, puoi vedere diverse proprietà relative alla topologia:

  • Un elenco consentiti di argomenti per il consumer di lavoro dell'istanza.
  • Endpoint esposti per la connessione con la topologia.
  • Gli argomenti del processo per i quali l'istanza è registrata per lo scaricamento.
  • Gli argomenti del processo elaborati dall'istanza.
  1. Utilizzando l’interfaccia utente touch, fai clic sulla scheda Strumenti . (http://localhost:4502/tools.html)

  2. Nell'area Operazioni Granite fare clic su Scaricare il browser.

  3. Nel pannello di navigazione fare clic su Browser topologia.

    Vengono visualizzati i cluster che partecipano alla topologia.

    chlimage_1-111

  4. Fai clic su un cluster per visualizzare un elenco delle istanze nel cluster e il relativo ID, stato corrente e stato iniziale.

  5. Fai clic su un ID istanza per visualizzare le proprietà più dettagliate.

È inoltre possibile utilizzare la console Web per visualizzare informazioni sulla topologia. La console fornisce ulteriori informazioni sui cluster di topologia:

  • Quale istanza è l'istanza locale.
  • I servizi Connettore topologia utilizzati da questa istanza per connettersi alla topologia (in uscita) e i servizi che si connettono a questa istanza (in entrata).
  • Modificare la cronologia per le proprietà della topologia e dell'istanza.

Utilizzare la procedura seguente per aprire la pagina Gestione topologia della console Web:

  1. Apri la Web Console nel browser. (http://localhost:4502/system/console)

  2. Fare clic su Principale > Gestione topologia.

    chlimage_1-112

Configurazione dell’appartenenza alla topologia configuring-topology-membership

Il servizio di individuazione basata sulle risorse Apache Sling viene eseguito su ogni istanza per controllare il modo in cui le istanze di Experience Manager interagiscono con una topologia.

Il servizio Discovery invia richieste periodiche di POST (heartbeat) ai servizi del connettore topologia per stabilire e mantenere connessioni con la topologia. Il servizio Connettore topologia gestisce un elenco consentiti di indirizzi IP o nomi host che possono essere aggiunti alla topologia:

  • Per unire un'istanza a una topologia, specifica l'URL del servizio Connettore topologia del membro principale.
  • Per consentire a un'istanza di unirsi a una topologia, aggiungi l'istanza all'elenco consentiti del servizio Connettore topologia del membro principale.

Utilizza la Console web o un nodo sling:OsgiConfig per configurare le seguenti proprietà del servizio org.apache.sling.discovery.impt.Config:

Nome proprietà
Nome OSGi
Descrizione
Valore predefinito
Timeout Heartbeat (secondi)
heartbeatTimeout
Tempo in secondi di attesa di una risposta heartbeat prima che l'istanza di destinazione venga considerata non disponibile.
20
Intervallo Heartbeat (secondi)
heartbeatInterval
La quantità di tempo in secondi tra gli heartbeat.
15
Ritardo minimo dell’evento (secondi)
minEventDelay

Quando si verifica una modifica alla topologia, il tempo necessario per ritardare la modifica dello stato da TOPOLOGY_CHANGING a TOPOLOGY_CHANGED. Ogni modifica che si verifica quando lo stato è TOPOLOGY_CHANGING aumenta il ritardo di questo periodo di tempo.

Questo ritardo impedisce agli ascoltatori di essere inondati da eventi.

Per non utilizzare ritardi, specificare 0 o un numero negativo.

3
URL del connettore topologico
topologyConnectorUrl
URL dei servizi Connettore topologia per l'invio di messaggi heartbeat.
http://localhost:4502/libs/sling/topology/connector
Elenco consentiti del connettore topologico
topologyConnectorWhitelist
Elenco di indirizzi IP o nomi host consentiti dal servizio locale Connettore topologia nella topologia.

localhost

127.0.0.1

Nome descrittore archivio
leaderElectionRepositoryDescriptor
<nessun valore>

Segui la procedura seguente per collegare un'istanza CQ al membro principale di una topologia. La procedura indirizza l'istanza all'URL del connettore topologia del membro della topologia principale. Eseguire questa procedura su tutti i membri della topologia.

  1. Apri la Web Console nel browser. (http://localhost:4502/system/console)
  2. Fare clic su Principale > Gestione topologia.
  3. Fare clic su Configura servizio di individuazione.
  4. Aggiungi un elemento alla proprietà URL del connettore topologia e specifica l'URL del servizio Connettore topologia del membro della topologia principale. L’URL si trova nel modulo https://rootservername:4502/libs/sling/topology/connector.

Eseguire la procedura seguente sul membro principale della topologia. La procedura aggiunge i nomi degli altri membri della topologia al relativo elenco consentiti di Discovery Service.

  1. Apri la Web Console nel browser. (http://localhost:4502/system/console)
  2. Fare clic su Principale > Gestione topologia.
  3. Fare clic su Configura servizio di individuazione.
  4. Per ciascun membro della topologia, aggiungere un elemento alla proprietà elenco consentiti Connettore topologia e specificare il nome host o l'indirizzo IP del membro della topologia.

Configurazione del consumo di argomenti configuring-topic-consumption

Utilizza il browser di offload per configurare il consumo di argomenti per le istanze di Experience Manager nella topologia. Per ogni istanza, puoi specificare gli argomenti che consuma. Ad esempio, per configurare la topologia in modo che una sola istanza utilizzi argomenti di un tipo specifico, disattiva l’argomento su tutte le istanze tranne una.

I processi sono istanze di quantità distribuite per cui l’argomento associato è abilitato utilizzando la logica di arrotondamento.

  1. Utilizzando l’interfaccia utente touch, fai clic sulla scheda Strumenti . (http://localhost:4502/tools.html)

  2. Nell'area Operazioni Granite fare clic su Scaricare il browser.

  3. Nel pannello di navigazione, fai clic su Scaricare il browser.

    Vengono visualizzati gli argomenti di scaricamento e le istanze del server che possono utilizzare gli argomenti.

    chlimage_1-113

  4. Per disabilitare il consumo di un argomento per un'istanza, sotto il nome del topc fai clic su Disattiva accanto all'istanza.

  5. Per configurare il consumo di tutti gli argomenti per un'istanza, fai clic sull'identificatore di istanza sotto qualsiasi argomento.

    chlimage_1-114

  6. Fai clic su uno dei pulsanti seguenti accanto a un argomento per configurare il comportamento di consumo per l’istanza, quindi fai clic su Salva:

    • Abilitato: Questa istanza consuma i lavori di questo argomento.
    • Disabilitata: Questa istanza non utilizza lavori di questo argomento.
    • Esclusivo: Questa istanza utilizza solo i lavori di questo argomento.

    Nota: Quando selezioni Esclusivo per un argomento, tutti gli altri argomenti vengono automaticamente impostati su Disabilitato.

Consumatori di lavoro installati installed-job-consumers

Diverse implementazioni JobConsumer sono installate con Experience Manager. Gli argomenti per i quali questi JobConsumers sono registrati vengono visualizzati in Offloading Browser. Gli argomenti aggiuntivi visualizzati sono quelli registrati da JobConsumers personalizzati. Nella tabella seguente viene descritto il valore predefinito JobConsumers.

Argomento del lavoro
Servizio PID
Descrizione
/
org.apache.sling.event.impl.jobs.deprecated.EventAdminBridge
Installato con Apache Sling. Elabora i processi generati dall’amministratore dell’evento OSGi per garantire la compatibilità con le versioni precedenti.
com/day/cq/replication/job/*
com.day.cq.replication.impl.AgentManagerImpl
Agente di replica che replica i payload del processo.
com/adobe/granite/workflow/offload
com.adobe.granite.workflow.core.offloading.WorkflowOffloadingJobConsumer
Elabora i processi generati dal flusso di lavoro DAM Update Asset Offloader.

Disabilitazione e abilitazione degli argomenti per un'istanza disabling-and-enabling-topics-for-an-instance

Il servizio Apache Sling Job Consumer Manager fornisce proprietà di elenco consentiti e elenco Bloccati degli argomenti. Configura queste proprietà per abilitare o disabilitare l'elaborazione di argomenti specifici in un'istanza di Experience Manager.

Nota: Se l'istanza appartiene a una topologia, puoi anche utilizzare Offloading Browser su qualsiasi computer della topologia per abilitare o disabilitare gli argomenti.

La logica che crea prima l'elenco degli argomenti abilitati consente tutti gli argomenti presenti nell'elenco consentiti e quindi rimuove gli argomenti presenti nell'elenco Bloccati.Per impostazione predefinita, tutti gli argomenti sono abilitati (il valore elenco consentiti è *) e nessun argomento è disabilitato (l'elenco Bloccati non ha alcun valore).

Utilizzare la console Web o sling:OsgiConfig per configurare le seguenti proprietà. Per sling:OsgiConfig Il PID del servizio Job Consumer Manager è org.apache.sling.event.impl.jobs.JobConsumerManager.

Nome proprietà nella console Web
OSGi ID
Descrizione
Whitelist dell'argomento
job.consumermanager.whitelist
Elenco di argomenti elaborati dal servizio JobManager locale. Valore predefinito di * causa l'invio di tutti gli argomenti al servizio TopicConsumer registrato.
Lista nera argomento
job.consumermanager.blacklist
Elenco di argomenti che il servizio JobManager locale non elabora.

Creazione Di Agenti Di Replica Per Lo Scaricamento creating-replication-agents-for-offloading

Il framework di offload utilizza la replica per trasportare le risorse tra autore e lavoratore. Il framework di offload crea automaticamente agenti di replica quando le istanze si uniscono alla topologia. Gli agenti vengono creati con valori predefiniti. È necessario modificare manualmente la password utilizzata dagli agenti per l’autenticazione.

CAUTION
Un problema noto con gli agenti di replica generati automaticamente richiede la creazione manuale di nuovi agenti di replica. Segui la procedura descritta in Problemi relativi all’utilizzo degli agenti di replica generati automaticamente prima di creare gli agenti per lo scaricamento.

Creare gli agenti di replica che trasportano i payload di lavoro tra le istanze per lo scaricamento. L’illustrazione seguente mostra gli agenti necessari per scaricare dall’autore a un’istanza di lavoro. L’autore ha un Sling ID di 1 e l’istanza di lavoro ha un Sling ID di 2:

chlimage_1-115

Questa configurazione richiede i tre agenti seguenti:

  1. Un agente in uscita sull'istanza dell'autore che si replica nell'istanza di lavoro.
  2. Un agente inverso sull'istanza di authoring che estrae dalla casella in uscita sull'istanza di processo di lavoro.
  3. Un agente in uscita sull'istanza di lavoro.

Questo schema di replica è simile a quello utilizzato tra le istanze di authoring e pubblicazione. Tuttavia, per la situazione di scarico, tutte le istanze coinvolte sono istanze di authoring.

NOTE
Il framework di offload utilizza la topologia per ottenere gli indirizzi IP delle istanze di offload. Il framework crea quindi automaticamente gli agenti di replica in base a questi indirizzi IP. Se in seguito gli indirizzi IP delle istanze di scaricamento cambiano, la modifica viene propagata automaticamente sulla topologia dopo il riavvio dell'istanza. Tuttavia, il framework di offload non aggiorna automaticamente gli agenti di replica per riflettere i nuovi indirizzi IP. Per evitare questa situazione, utilizza indirizzi IP fissi per tutte le istanze della topologia.

Denominazione degli agenti di replica per lo scaricamento naming-the-replication-agents-for-offloading

Utilizza un formato specifico per Nome proprietà degli agenti di replica in modo che il framework di offload utilizzi automaticamente l'agente corretto per istanze di lavoro specifiche.

Denominazione dell'agente in uscita sull'istanza dell'autore:

offloading_<slingid>, dove <slingid> è l'ID Sling dell'istanza di lavoro.

Esempio: offloading_f5c8494a-4220-49b8-b079-360a72f71559

Denominazione dell’agente inverso nell’istanza di authoring:

offloading_reverse_<slingid>, dove <slingid> è l'ID Sling dell'istanza di lavoro.

Esempio: offloading_reverse_f5c8494a-4220-49b8-b079-360a72f71559

Denominazione della casella in uscita nell'istanza di lavoro:

offloading_outbox

Creazione dell'agente in uscita creating-the-outgoing-agent

  1. Crea un Agente di replica sull'autore. (Vedi documentazione relativa agli agenti di replica). Specifica qualsiasi Titolo. La Nome devono seguire la convenzione di denominazione.

  2. Crea l'agente utilizzando le seguenti proprietà:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    Proprietà Valore
    Impostazioni > Tipo di serializzazione Predefiniti
    Transport >Transport URI https://<ip of target instance>:<port>/bin/receive?sling:authRequestLogin=1
    Trasporto >utente di trasporto Utente di replica sull'istanza di destinazione
    Trasporto >Trasporta password Password utente di replica nell'istanza di destinazione
    Extended > HTTP, metodo POST
    Triggers > Ignora impostazioni predefinite Vero

Creazione dell'agente inverso creating-the-reverse-agent

  1. Crea un Agente di replica inversa sull'autore. (Vedi documentazione relativa agli agenti di replica.) Specifica qualsiasi Titolo. La Nome devono seguire la convenzione di denominazione.

  2. Crea l'agente utilizzando le seguenti proprietà:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
    Proprietà Valore
    Impostazioni > Tipo di serializzazione Predefiniti
    Transport >Transport URI https://<ip of target instance>:<port>/bin/receive?sling:authRequestLogin=1
    Trasporto >utente di trasporto Utente di replica sull'istanza di destinazione
    Trasporto >Trasporta password Password utente di replica nell'istanza di destinazione
    Extended > HTTP, metodo GET

Creazione dell’agente della casella in uscita creating-the-outbox-agent

  1. Crea un Agente di replica nell'istanza di lavoro. (Vedi documentazione relativa agli agenti di replica.) Specifica qualsiasi Titolo. La Nome devono offloading_outbox.

  2. Crea l'agente utilizzando le seguenti proprietà.

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Proprietà Valore
    Impostazioni > Tipo di serializzazione Predefiniti
    Transport >Transport URI repo://var/replication/outbox
    Trigger > Ignora predefinito Vero

Ricerca dell’ID Sling finding-the-sling-id

Ottieni l’ID Sling di un’istanza di Experience Manager utilizzando uno dei seguenti metodi:

  • Apri la console Web e, in Impostazioni Sling, trova il valore della proprietà Sling ID (http://localhost:4502/system/console/status-slingsettings). Questo metodo è utile se l’istanza non fa ancora parte della topologia.
  • Utilizza il browser Topologia se l’istanza fa già parte della topologia.

Offload dell’elaborazione di risorse DAM offloading-the-processing-of-dam-assets

Configura le istanze di una topologia in modo che istanze specifiche eseguano l’elaborazione in background delle risorse che vengono aggiunte o aggiornate in DAM.

Per impostazione predefinita, in Experience Manager viene eseguito il flusso di lavoro Aggiorna risorsa DAM quando una risorsa DAM cambia o una viene aggiunta a DAM. Modifica il comportamento predefinito in modo che l’Experience Manager esegua invece il flusso di lavoro DAM Update Asset Offloader. Questo flusso di lavoro genera un processo JobManager con un argomento com/adobe/granite/workflow/offloading. Quindi, configura la topologia in modo che il processo venga scaricato in un processo di lavoro dedicato.

CAUTION
Nessun flusso di lavoro deve essere transitorio quando viene utilizzato con lo scaricamento del flusso di lavoro. Ad esempio, il flusso di lavoro Aggiorna risorsa DAM non deve essere transitorio quando viene utilizzato per lo scaricamento delle risorse. Per impostare/annullare l’impostazione del flag transitorio su un flusso di lavoro, vedi Flussi di lavoro transitori.

La procedura seguente assume le seguenti caratteristiche per la topologia di scarico:

  • Una o più istanze di Experience Manager sono istanze di authoring con cui gli utenti interagiscono per aggiungere o aggiornare risorse DAM.
  • Gli utenti non interagiscono direttamente con una o più istanze di Experience Manager che elaborano le risorse DAM. Queste istanze sono dedicate all’elaborazione in background delle risorse DAM.
  1. Su ogni istanza di Experience Manager, configura il servizio di individuazione in modo che punti al connettore principale Topography. (Vedi Configurazione dell’appartenenza alla topologia.)

  2. Configura il connettore topografico principale in modo che le istanze di connessione siano sull'elenco consentiti.

  3. Apri il browser di offload e disattiva la com/adobe/granite/workflow/offloading argomento sulle istanze con cui gli utenti interagiscono per caricare o modificare le risorse DAM.

    chlimage_1-116

  4. Per ogni istanza con cui gli utenti interagiscono per caricare o modificare le risorse DAM, configura i moduli di avvio del flusso di lavoro per utilizzare il flusso di lavoro DAM Update Asset Offloading :

    1. Apri la console Flusso di lavoro .
    2. Fai clic sulla scheda Avvio .
    3. Individua le due configurazioni di Launcher che eseguono il flusso di lavoro Risorsa di aggiornamento DAM . Un tipo di evento di configurazione del modulo di avvio è Node Created e l'altro è Node Modified.
    4. Modifica entrambi i tipi di evento in modo che eseguano il flusso di lavoro DAM Update Asset Offloading . (Per informazioni sulle configurazioni del modulo di avvio, vedi Avvio Dei Flussi Di Lavoro Quando I Nodi Cambiano.)
  5. Nelle istanze che eseguono l’elaborazione in background delle risorse DAM, disattiva i moduli di avvio del flusso di lavoro che eseguono il flusso di lavoro Risorsa di aggiornamento DAM .

Ulteriori informazioni further-reading

Oltre ai dettagli presentati in questa pagina, puoi anche leggere quanto segue:

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56