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:

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

    immagine

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

    immagine

  3. 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 livello Author sulla destinazione. Analogamente, se l'origine è Publish, anche la destinazione dovrebbe essere Publish.
    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/page1 e la destinazione contiene già /content/page1/product1, l'acquisizione rimuove l'intero percorso page1 e le relative pagine secondarie, incluso product1, 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.
    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 Author da sola. In questo modo l'acquisizione di Publish risulta 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.
  4. 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.

immagine

  1. Fai clic su Ingest (Acquisisci).

    immagine

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

    immagine

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

    immagine

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.

NOTE
Dopo il trasferimento iniziale dei contenuti, si consiglia di eseguire frequenti integrazioni dei contenuti differenziali in modo da ridurre il periodo di blocco dei contenuti per il trasferimento finale dei contenuti differenziali, prima della pubblicazione in Cloud Service. Se hai utilizzato il passaggio di pre-copia per la prima acquisizione, puoi saltare la pre-copia per le successive acquisizioni integrative (se la dimensione del set di migrazione integrativa è inferiore a 200 GB). Il motivo è che potrebbe aggiungere tempo all'intero processo.

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:

immagine

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:

immagine

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.

NOTE
Il token è disponibile per gli utenti che appartengono al gruppo Amministratori AEM locale nel servizio Author del Cloud Service di destinazione.

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.

immagine

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 il supporto Adobe."

immagine

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.

NOTE
Viene visualizzato il campo "Token di migrazione" perché in alcuni casi è ciò che non è consentito recuperare il token. Consentendo la trasmissione manuale, può consentire all’utente di avviare l’acquisizione rapidamente, senza alcun aiuto aggiuntivo. Se il token è fornito e il messaggio viene ancora visualizzato, il problema non era il recupero del token.
  • 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.

NOTE
Non è più necessario registrare un ticket di supporto per disabilitare "Aggiornamenti della versione AEM".

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.

NOTE
"Aggiornamenti della versione dell’AEM" viene eseguito nella pipeline dell’ambiente e attende che la pipeline sia pulita. Se gli aggiornamenti vengono messi in coda per un periodo più lungo del previsto, accertati che in un flusso di lavoro personalizzato la pipeline non sia bloccata involontariamente.

immagine

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 BSONObjectTooLarge e specificherà quale nodo ha superato il massimo consentito. 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).

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.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab