Acquisizione di contenuti in Cloud Service ingesting-content
Processo di acquisizione in Cloud Acceleration Manager ingestion-process
Per acquisire il set di migrazione utilizzando Cloud Acceleration Manager, effettua le seguenti operazioni:
-
Passa a Cloud Acceleration Manager. Fai clic sulla scheda del progetto e poi sulla scheda Content Transfer (Trasferimento contenuti). Passa a Processi di acquisizione e fai clic su Nuova acquisizione
-
Controlla l’elenco di controllo per l’acquisizione e assicurati che tutti i passaggi siano stati completati. Questi passaggi sono necessari per garantire un’acquisizione corretta. Procedi al passaggio Successivo solo se l'elenco di controllo è stato completato.
-
Fornisci le informazioni necessarie per creare un’acquisizione.
- Set di migrazione: Selezionare il set di migrazione che contiene i dati estratti come Source.
- I set di migrazione scadranno dopo un periodo prolungato di inattività, pertanto si prevede che l’acquisizione avvenga relativamente presto dopo l’esecuzione dell’estrazione. Rivedi Scadenza set di migrazione per i dettagli.
note tip TIP Se l’estrazione è in esecuzione, la finestra di dialogo lo indica. Una volta completata correttamente l’estrazione, l’acquisizione viene avviata automaticamente. Se l’estrazione non riesce o viene interrotta, il processo di acquisizione verrà annullato. -
Destinazione: Selezionare l'ambiente di destinazione. In questo ambiente viene acquisito il contenuto del set di migrazione.
- Le acquisizioni non supportano destinazioni di tipo RDE (Rapid Development Environment) o Anteprima e non vengono visualizzate come possibile scelta di destinazione, anche se l’utente ha accesso a esse.
- Anche se un set di migrazione può essere acquisito in più destinazioni contemporaneamente, una destinazione può essere la destinazione di una sola acquisizione in esecuzione o in attesa alla volta.
-
Livello: Selezionare il livello. (Autore/Publish).
- Se l'origine era
Author, si consiglia di acquisirla nel livelloAuthorsulla destinazione. Analogamente, se l'origine èPublish, anche la destinazione dovrebbe esserePublish.
- Se l'origine era
note note NOTE Se il livello di destinazione è Author, l'istanza di authoring viene chiusa per tutta la durata dell'acquisizione e diventa non disponibile per gli utenti (ad esempio, autori o utenti che eseguono attività di manutenzione). Il motivo è proteggere il sistema e impedire eventuali modifiche che potrebbero andare perse o causare un conflitto di acquisizione. Assicurati che il tuo team sia a conoscenza di questo fatto. Inoltre, l’ambiente risulta ibernato durante l’acquisizione dell’autore.-
Cancellazione: Scegliere il valore
Wipe- L'opzione Cancella imposta il punto iniziale della destinazione per l'acquisizione. Se Cancella è abilitato, la destinazione, incluso tutto il suo contenuto, verrà reimpostata sulla versione dell'AEM specificata in Cloud Manager. Se non è abilitata, la destinazione mantiene il contenuto corrente come punto di partenza.
- Questa opzione NON influisce sul modo in cui verrà eseguita l'acquisizione del contenuto. L'acquisizione utilizza sempre una strategia di sostituzione dei contenuti e non una strategia di unione dei contenuti. Pertanto, nei casi Cancella e Non Cancella, l'acquisizione di un set di migrazione sovrascriverà i contenuti nello stesso percorso sulla destinazione. Ad esempio, se il set di migrazione contiene
/content/page1e la destinazione contiene già/content/page1/product1, l'acquisizione rimuove l'intero percorsopage1e le relative pagine secondarie, inclusoproduct1, e lo sostituisce con il contenuto nel set di migrazione. Ciò significa che è necessario eseguire un'attenta pianificazione durante l'esecuzione di un'acquisizione Non-Wipe in una destinazione che contiene qualsiasi contenuto che deve essere mantenuto. - Le acquisizioni non wipe sono progettate appositamente per il caso d’uso di acquisizione integrativa. Queste acquisizioni mirano ad avere una quantità incrementale di nuovi contenuti che sono cambiati rispetto all’ultima acquisizione in un set di migrazione esistente. Al di fuori di questo caso d’uso, l’esecuzione di acquisizioni senza cancellazione potrebbe richiedere tempi di acquisizione molto lunghi.
note important IMPORTANT Se l'impostazione Cancella è abilitata per l'acquisizione, verrà ripristinato l'intero archivio esistente, incluse le autorizzazioni utente sull'istanza del Cloud Service di destinazione. La reimpostazione è vera anche per un utente amministratore aggiunto al gruppo amministratori e tale utente deve essere aggiunto nuovamente al gruppo amministratori per avviare un'acquisizione. -
Pre-copia: Scegli il valore
Pre-copy- Puoi eseguire il passaggio di pre-copia opzionale per velocizzare notevolmente l’acquisizione. Per ulteriori dettagli, vedi Acquisizione con AzCopy.
- Se si utilizza l’acquisizione con pre-copia (per S3 o Azure Data Store), si consiglia di eseguire prima l’acquisizione
Authorda sola. In questo modo l'acquisizione diPublishrisulta più rapida quando viene eseguita in un secondo momento.
note important IMPORTANT Puoi avviare un'acquisizione nell'ambiente di destinazione solo se appartieni al gruppo locale amministratori AEM nel servizio di authoring del Cloud Service di destinazione. Se non riesci ad avviare un'acquisizione, vedi Impossibile avviare l'acquisizione per ulteriori dettagli. - Set di migrazione: Selezionare il set di migrazione che contiene i dati estratti come Source.
-
Dopo aver selezionato le opzioni di acquisizione, viene visualizzata una stima della sua durata. Si tratta di una stima ottimale basata su dati storici di acquisizioni simili.
- Questa stima viene calcolata e visualizzata solo se sono stati raccolti e sono disponibili i valori "Verifica dimensione" dell’estrazione.
- Questo valore è una stima e, anche se viene calcolato in modo intelligente, non deve essere considerato esatto. Vari fattori possono modificare la durata effettiva.
- Durante l'acquisizione, questo valore sarà disponibile anche nella finestra di dialogo delle durate, a cui è possibile accedere tramite l'azione "Visualizza durate" dell'acquisizione.
-
Fai clic su Ingest (Acquisisci).
-
Puoi quindi monitorare l’acquisizione dalla vista a elenco Processi di acquisizione e utilizzare il menu Azioni dell’acquisizione per visualizzare le durate e registrare nel momento in cui l’acquisizione procede.
-
Per ulteriori informazioni sul processo di acquisizione, fai clic sul pulsante (i) nella riga. È possibile visualizzare la durata di ogni passaggio dell'acquisizione quando è in esecuzione o completato facendo clic su … e quindi su Visualizza durate. Le informazioni provenienti dall’estrazione vengono anche mostrate per realizzare ciò che viene acquisito.
Acquisizione integrativa top-up-ingestion-process
Lo strumento Content Transfer (Trasferimento contenuti) dispone di una funzione che consente l'estrazione di contenuti differenziali eseguendo una integrazione del set di migrazione. Questo consente di modificare il set di migrazione in modo da includere solo il contenuto modificato rispetto all’estrazione precedente, senza dover estrarre nuovamente tutto il contenuto.
Per acquisire il contenuto differenziale dopo il completamento di alcune acquisizioni, è necessario eseguire una Estrazione integrativa, quindi utilizzare il metodo di acquisizione con l'opzione Cancella disabilitata. Assicurati di leggere la spiegazione Cancella qui sopra per evitare di perdere il contenuto già nella destinazione.
Inizia creando un processo di acquisizione e assicurati che Cancella sia disabilitato durante l'acquisizione, come illustrato di seguito:
Risoluzione dei problemi troubleshooting
CAM: impossibile recuperare il token di migrazione cam-unable-to-retrieve-the-migration-token
Il recupero automatico del token di migrazione potrebbe non riuscire per diversi motivi, inclusa la configurazione di un elenco consentiti IP tramite Cloud Manager nell'ambiente del Cloud Service di destinazione. In questi scenari, quando tenti di avviare un’acquisizione viene visualizzata la seguente finestra di dialogo:
Recupera manualmente il token di migrazione facendo clic sul collegamento "Ottieni token" nella finestra di dialogo. Viene aperta un’altra scheda che mostra il token. È quindi possibile copiare il token e incollarlo nel campo Input token di migrazione. Ora, dovresti essere in grado di iniziare l’acquisizione.
Impossibile avviare l’acquisizione unable-to-start-ingestion
Puoi avviare un'acquisizione nell'ambiente di destinazione solo se appartieni al gruppo locale amministratori AEM nel servizio di authoring del Cloud Service di destinazione. Se non appartieni al gruppo di amministratori AEM, quando tenti di avviare un’acquisizione viene visualizzato un errore come mostrato di seguito. Puoi chiedere all'amministratore di aggiungerti ai amministratori AEM locali oppure di richiedere il token stesso, che potrai quindi incollare nel campo Input token di migrazione.
Impossibile raggiungere il servizio di migrazione unable-to-reach-migration-service
Dopo aver richiesto un’acquisizione, è possibile che venga visualizzato all’utente un messaggio simile al seguente: "Il servizio di migrazione nell’ambiente di destinazione non è raggiungibile. In tal caso, riprova più tardi o contatta l’assistenza Adobe."
Questo messaggio indica che Cloud Acceleration Manager non è riuscito a raggiungere il servizio di migrazione dell’ambiente di destinazione per avviare l’acquisizione. Questa situazione può verificarsi per vari motivi.
- AEM as a Cloud Service mantiene lo stato dell’ambiente e, occasionalmente, deve riavviare il servizio di migrazione per vari motivi normali. Se il servizio viene riavviato, non potrà essere raggiunto, ma sarà disponibile alla fine.
- È possibile che nell’istanza sia in esecuzione un altro processo. Ad esempio, se Aggiornamenti versione AEM applica un aggiornamento, è possibile che il sistema sia occupato e che il servizio di migrazione non sia regolarmente disponibile. Al termine di questo processo, è possibile tentare di nuovo l’inizio dell’acquisizione.
- Se è stato applicato un Inserisco nell'elenco Consentiti di IP tramite Cloud Manager, Cloud Acceleration Manager non potrà raggiungere il servizio di migrazione. Non è possibile aggiungere un indirizzo IP per le acquisizioni perché il relativo indirizzo è dinamico. Attualmente, l’unica soluzione consiste nel disabilitare il inserisco nell'elenco Consentiti di indicizzazione e acquisizione dell’IP durante il processo di acquisizione.
- Ci possono essere altri motivi che richiedono un'indagine. Se l’acquisizione o l’indicizzazione continua a non riuscire, contatta l’Assistenza clienti di Adobe.
Aggiornamenti e acquisizioni delle versioni di AEM aem-version-updates-and-ingestions
Gli aggiornamenti della versione dell'AEM vengono applicati automaticamente agli ambienti per mantenerli aggiornati con la versione di AEM as a Cloud Service più recente. Se l’aggiornamento viene attivato quando viene eseguita un’acquisizione, possono verificarsi risultati imprevedibili, incluso il danneggiamento dell’ambiente.
Se nel programma di destinazione è stato effettuato l’onboarding di "Aggiornamenti della versione dell’AEM", il processo di acquisizione tenta di disabilitare la coda prima dell’avvio. Al termine dell’acquisizione, lo stato del programma di aggiornamento della versione viene ripristinato come era prima dell’inizio delle acquisizioni.
Se "Aggiornamenti della versione dell’AEM" è attivo (ovvero, gli aggiornamenti sono in esecuzione o sono in coda per l’esecuzione), l’acquisizione non inizierà e l’interfaccia utente visualizza il seguente messaggio. Una volta completati gli aggiornamenti, è possibile avviare l’acquisizione. Cloud Manager può essere utilizzato per visualizzare lo stato corrente delle pipeline del programma.
Errore di acquisizione integrativa a causa della violazione del vincolo di unicità top-up-ingestion-failure-due-to-uniqueness-constraint-violation
Una causa comune di un errore di acquisizione integrativa è un conflitto negli ID dei nodi. Per identificare questo errore, scarica il registro di acquisizione utilizzando l’interfaccia utente di Cloud Acceleration Manager e cerca una voce come quella seguente:
java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakConstraint0030: il vincolo di unicità ha violato la proprietà [jcr:uuid] con valore a1a1a1a1-b2b2-c3c3-d4d4-e5e5e5e5e5: /some/path/jcr:content, /some/other/path/jcr:content
Ogni nodo in AEM deve avere un UUID univoco. Questo errore indica che un nodo che viene acquisito ha lo stesso UUID di quello esistente in un percorso diverso nell’istanza di destinazione. Questa situazione può verificarsi per due motivi:
- Un nodo viene spostato sull'origine tra un'estrazione e una successiva estrazione integrativa
- RICORDA: per le estrazioni integrative, il nodo esisterà ancora nel set di migrazione, anche se non esiste più nell'origine.
- Un nodo sulla destinazione viene spostato tra un’acquisizione e una successiva acquisizione integrativa.
Questo conflitto deve essere risolto manualmente. Chi ha familiarità con il contenuto deve decidere quale dei due nodi deve essere eliminato, tenendo presente gli altri contenuti che vi fanno riferimento. La soluzione può richiedere che l’estrazione integrativa venga eseguita nuovamente senza il nodo problematico.
Acquisizione integrativa non riuscita a causa dell’impossibilità di eliminare il nodo di riferimento top-up-ingestion-failure-due-to-unable-to-delete-referenced-node
Un'altra causa comune di un errore di acquisizione integrativa è un conflitto di versione per un particolare nodo nell'istanza di destinazione. Per identificare questo errore, scarica il registro di acquisizione utilizzando l’interfaccia utente di Cloud Acceleration Manager e cerca una voce come quella seguente:
java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakIntegrity001: impossibile eliminare il nodo a cui si fa riferimento: 8a2289f4-b904-4bd0-8410-15e41e0976a8
Ciò può verificarsi se un nodo sulla destinazione viene modificato tra un'acquisizione e una successiva acquisizione Non-Wipe in modo che sia stata creata una nuova versione. Se il set di migrazione è stato estratto con "includi versioni" abilitato, si potrebbe verificare un conflitto in quanto la destinazione dispone ora di una versione più recente a cui fa riferimento la cronologia delle versioni e altro contenuto. Il processo di acquisizione non è in grado di eliminare il nodo della versione che causa l’errore perché vi si fa riferimento.
La soluzione può richiedere che l’estrazione integrativa venga eseguita nuovamente senza il nodo problematico. Oppure, creando un piccolo set di migrazione del nodo problematico, ma con "include versions" disabilitato.
Le best practice indicano che, se è necessario eseguire un'acquisizione Non-Wipe utilizzando un set di migrazione che include versioni, è fondamentale che il contenuto della destinazione venga modificato il meno possibile, fino al completamento del percorso di migrazione. In caso contrario, possono verificarsi tali conflitti.
Errore di acquisizione a causa dei valori delle proprietà del nodo di grandi dimensioni ingestion-failure-due-to-large-node-property-values
I valori delle proprietà del nodo memorizzati in MongoDB non possono superare i 16 MB. Se un valore di nodo supera le dimensioni supportate, l’acquisizione non riesce e il registro conterrà:
- un errore
BSONObjectTooLargee specificare quale nodo ha superato il massimo consentito oppure - un errore
BsonMaximumSizeExceededException, che indica che è probabile che un nodo contenente caratteri unicode superi la dimensione massima **
Questa è una restrizione di MongoDB.
Per ulteriori informazioni e un collegamento a uno strumento Oak che consenta di trovare tutti i nodi di grandi dimensioni, vedere la nota Node property value in MongoDB in Prerequisiti per lo strumento Content Transfer. Dopo aver risolto tutti i nodi con dimensioni elevate, esegui di nuovo l’estrazione e l’acquisizione.
Per evitare questa restrizione, eseguire Best Practices Analyzer sull'istanza AEM di origine e rivedere i risultati che presenta, in particolare il pattern "Unsupported Repository Structure" (URS).
Errore di acquisizione a causa di errori intermittenti imprevisti ingestion-failure-due-to-unexpected-intermittent-errors
Talvolta, problemi intermittenti inattesi potrebbero prestarsi a acquisizioni non riuscite, dove purtroppo l’unico ricorso è quello di ritentare l’acquisizione. Esamina il registro di acquisizione per individuare la causa dell’errore e verificare se è in linea con uno degli errori elencati di seguito, dove deve essere effettuato un nuovo tentativo.
Problemi MongoDB mongo-db-issues
Atlas prescale timeout error- La fase di acquisizione tenterà di prescrivere il database cloud di destinazione a una dimensione appropriata che sia allineata alle dimensioni del contenuto del set di migrazione da acquisire. Di rado, questa operazione non viene completata entro il periodo di tempo previsto.Exhausted mongo restore retries- I tentativi di ripristinare un dump locale del contenuto del set di migrazione acquisito nel database cloud sono stati esauriti. Questo indica un problema generale di salute/rete con MongoDB, che spesso guarisce se stesso dopo pochi minuti.
Acquisizione annullata ingestion-rescinded
Un’acquisizione creata con un’estrazione in esecuzione come set di migrazione di origine attende pazientemente che l’estrazione abbia esito positivo e a quel punto inizia normalmente. Se l’estrazione non riesce o viene interrotta, l’acquisizione e il relativo processo di indicizzazione non iniziano ma vengono annullati. In questo caso, controlla l’estrazione per determinare il motivo dell’errore, risolvi il problema e avvia di nuovo l’estrazione. Una volta eseguita l’estrazione fissa, è possibile pianificare una nuova acquisizione.
La risorsa eliminata non è presente dopo la nuova acquisizione
In generale, non è consigliabile modificare i dati dell’ambiente cloud tra una acquisizione e l’altra.
Quando una risorsa viene eliminata dalla destinazione del Cloud Service utilizzando l’interfaccia utente Assets Touch, i dati del nodo vengono eliminati, ma il BLOB della risorsa con l’immagine non viene eliminato immediatamente. Viene contrassegnato per l’eliminazione in modo che non venga più visualizzato nell’interfaccia utente; tuttavia, rimane nell’archivio dati fino a quando non si verifica la raccolta di oggetti inattivi e il BLOB viene rimosso.
Se una risorsa migrata in precedenza viene eliminata e l’acquisizione successiva viene eseguita prima che il Garbage Collector abbia completato l’eliminazione della risorsa, l’acquisizione dello stesso set di migrazione non ripristinerà la risorsa eliminata. Quando l’acquisizione controlla l’ambiente cloud della risorsa, non sono presenti dati del nodo; pertanto, l’acquisizione copia i dati del nodo nell’ambiente cloud. Tuttavia, quando controlla l’archivio BLOB, vede che il BLOB è presente e salta la copia del BLOB. Per questo motivo i metadati sono presenti dopo l’acquisizione quando la risorsa viene esaminata dall’interfaccia utente touch, ma l’immagine no. I set di migrazione e l’acquisizione dei contenuti non sono stati progettati per gestire questo caso. Hanno lo scopo di aggiungere nuovi contenuti all’ambiente cloud e non ripristinare i contenuti migrati in precedenza.
Passaggio successivo whats-next
Quando l’acquisizione viene completata correttamente, l’indicizzazione AEM viene avviata automaticamente. Per ulteriori informazioni, vedere Indicizzazione dopo la migrazione del contenuto.
Una volta completato l’inserimento del contenuto nel Cloud Service, puoi visualizzare i registri di ciascun passaggio (estrazione e acquisizione) e cercare gli errori. Per ulteriori informazioni, consulta Visualizzazione dei registri per un set di migrazione.