Correzione degli errori di distribuzione della configurazione del dispatcher in AEM
La configurazione di Dispatcher non riesce durante la distribuzione o la migrazione a causa di una struttura di file errata, pacchetti non supportati o impostazioni di configurazione della pipeline e della cache non allineate. Questi problemi possono impedire una distribuzione corretta o causare comportamenti imprevisti negli ambienti AEM. Per risolvere il problema, correggi la struttura di configurazione, controlla il comportamento della pipeline e convalida l’installazione.
Descrizione description
Ambienti
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- AEM Managed Services (AMS)
- Scenari di implementazione e migrazione della configurazione di Dispatcher
Problema/Sintomi
- La distribuzione non riesce quando la configurazione del dispatcher viene caricata come archivio compresso anziché come cartelle non elaborate
- La migrazione mostra l’errore EPERM: operazione non consentita, collegamento simbolico nei sistemi Windows
- La pipeline solo Dispatcher non aggiorna le configurazioni come previsto
- La cache non viene cancellata dopo la distribuzione nonostante gli aggiornamenti della configurazione
Causa
Si verificano errori di distribuzione perché Cloud Manager richiede la struttura di cartelle del dispatcher non elaborate anziché archivi compressi. In AMS, le variabili specifiche dell’ambiente devono essere definite esternamente invece di essere codificate a livello di codice. Durante la migrazione, Dispatcher Converter si basa su collegamenti simbolici che possono essere bloccati dalle restrizioni del sistema operativo.
Risoluzione resolution
Per risolvere il problema, segui la procedura riportata di seguito
- Verificare che l’archivio contenga cartelle di Dispatcher non compresse, ad esempio
conf.deconf.dispatcher.d, nel percorso corretto e rimuovere eventuali file ZIP creati manualmente. - Crea una pipeline dedicata a livello web in Cloud Manager e seleziona il percorso dell’archivio corretto in modo che distribuisca la configurazione del dispatcher in modo indipendente senza attivare le distribuzioni complete.
- Rivedi il comportamento di distribuzione e verifica che la pipeline selezionata includa la struttura di origine del dispatcher ed venga eseguita correttamente con i registri aggiornati, notando che le pipeline solo del dispatcher vengono aggiornate in modo incrementale.
- Applica i metodi di cancellazione della cache supportati abilitando un endpoint di scaricamento per AEM as a Cloud Service o utilizzando script personalizzati in AMS e conferma gli aggiornamenti della cache controllando i timestamp della cache del dispatcher.
- Definisci le variabili specifiche dell’ambiente in Managed Services utilizzando i file di variabili, includile nelle configurazioni degli host virtuali e assicurati che la configurazione venga risolta correttamente durante le richieste.
- Quando necessario, recupera i pacchetti di configurazione del dispatcher dall’ambiente e verifica che i file estratti corrispondano alla struttura di directory prevista.
- Esegui la conversione del dispatcher con le autorizzazioni di sistema appropriate o utilizza un ambiente supportato per evitare errori di collegamento simbolico e assicurati che la struttura convertita venga generata correttamente.
- Convalida la distribuzione in tutti gli ambienti esaminando i registri di esecuzione della pipeline, controllando i registri di Dispatcher e confermando la corretta applicazione degli aggiornamenti della configurazione.
- Se hai bisogno di cancellare la cache a livello di programmazione, contatta il team del tuo account Adobe per richiedere le credenziali API di eliminazione CDN.