L’installazione del pacchetto non riesce negli ambienti AEM
L’installazione del pacchetto AEM non riesce se i pacchetti includono percorsi immutabili, struttura ZIP non valida, hook di installazione o versioni SDK interessate. Diagnosticare l’errore di installazione e seguire i passaggi di risoluzione appropriati per installare correttamente il pacchetto.
Descrizione description
Ambiente
- Adobe Experience Manager as a Cloud Service
- AEM Managed Services
- Adobe Developer App Builder
Problema/Sintomi
- Errore durante il caricamento che indica che l’archivio non è un pacchetto di contenuti valido perché manca jcr_root.
- Errori di convalida del pacchetto durante l’installazione.
- Installazione bloccata perché il pacchetto contiene percorsi di archivio non modificabili.
- I pacchetti incorporati all’interno di un pacchetto all non si installano automaticamente.
- Errori di download dei pacchetti causati da nomi di pacchetti non validi.
- Errori di installazione relativi a classi hook di installazione mancanti.
Causa
Gli errori di installazione si verificano quando la struttura del pacchetto non è valida, il pacchetto include percorsi di archivio immutabili, i nomi dei pacchetti contengono caratteri non supportati, gli hook di installazione vengono utilizzati laddove non sono supportati o la distribuzione si basa su una versione di SDK interessata da una regressione.
Risoluzione resolution
Per risolvere il problema, eseguire la procedura seguente:
- Identifica l’errore di installazione esaminando il messaggio o i registri di Gestione pacchetti.
- Se il pacchetto non viene riconosciuto come pacchetto di contenuto, verificare che
META-INFejcr_rootsiano presenti nel livello superiore del file ZIP. Se necessario, ricreare il pacchetto. - Se il pacchetto contiene percorsi di archivio immutabili, distribuisci il codice tramite la pipeline di distribuzione appropriata invece di installarlo direttamente tramite Gestione pacchetti.
- Se i pacchetti incorporati non vengono installati automaticamente, verifica la versione di SDK e esegui l’aggiornamento a una versione di SDK che includa la correzione di regressione.
- Rimuovere gli hook di installazione durante la distribuzione in ambienti che non li supportano. Per gli ambienti supportati, assicurati che siano installate tutte le dipendenze richieste.
- Aggiorna i nomi dei pacchetti per rimuovere i caratteri non supportati e ricompila il pacchetto prima di distribuirlo nuovamente.
- Convalidare l’installazione confermando che gli errori di installazione non vengono più visualizzati e che i pacchetti incorporati vengono installati correttamente quando applicabile.
Lettura correlata
recommendation-more-help
experience-cloud-kcs-help-kbarticles