DocumentazioneAEM as a Cloud ServiceGuida utente

Convalida dei trasferimenti di contenuto validating-content-transfers

Last update: Wed Aug 28 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Amministratore

Guida introduttiva getting-started

Gli utenti possono determinare in modo affidabile se tutti i contenuti estratti dallo strumento Content Transfer (Trasferimento contenuti) sono stati correttamente acquisiti nell’istanza di destinazione. Questa funzione di convalida funziona confrontando un riepilogo dei percorsi di tutti i nodi coinvolti durante l’estrazione con un riepilogo dei percorsi di tutti i nodi coinvolti durante l’acquisizione. Se nel digest di estrazione sono presenti percorsi di nodo mancanti nel digest di acquisizione, la convalida viene considerata non riuscita e potrebbe essere necessaria un’ulteriore convalida manuale.

INFO
Questa funzione sarà disponibile a partire dalla versione 1.8.x dello strumento Content Transfer (CTT). L’ambiente di destinazione AEM Cloud Service deve eseguire almeno la versione 6158 o successiva. È inoltre necessario configurare l'ambiente di origine per eseguire pre-copia. La funzionalità di convalida cerca il file azcopy.config nell'origine. Se il file non viene trovato, la convalida non verrà eseguita. Per ulteriori informazioni su come configurare un file azcopy.config, vedere Gestione di archivi di contenuti di grandi dimensioni - Configurazione di un file azcopy.config.

La convalida di un trasferimento di contenuto è una funzione facoltativa. L’attivazione di questa funzione aumenta sia il tempo necessario per eseguire un’estrazione che quello necessario per l’acquisizione. Per utilizzare la funzione, abilitala nella Console di sistema dell’ambiente AEM sorgente seguendo questi passaggi:

  1. Passa alla console Web Adobe Experience Manager nell'istanza di origine, da Strumenti - Operazioni - Console Web o direttamente all'URL in https://serveraddress:serverport/system/console/configMgr

  2. Cerca la configurazione del servizio di estrazione dello strumento Content Transfer

  3. Utilizza il pulsante di icona della matita per modificarne i valori di configurazione

  4. Abilita l'impostazione Abilita convalida migrazione durante l'estrazione, quindi premi Salva:

    immagine

Se questa impostazione è abilitata e l’ambiente AEM Cloud Service di destinazione esegue una versione compatibile, la convalida della migrazione verrà eseguita durante tutte le estrazioni e acquisizioni successive.

Per ulteriori informazioni sull'installazione dello strumento Content Transfer, vedere Guida introduttiva allo strumento Content Transfer.

Convalidare un trasferimento di contenuti how-to-validate-a-content-transfer

Con la convalida della migrazione abilitata nell’ambiente AEM di origine, inizia un’estrazione.

Se Overwrite staging container during extraction è abilitato, tutti i nodi coinvolti nell'estrazione vengono registrati nel digest del percorso di estrazione. Quando si utilizza questa impostazione, è importante abilitare l'impostazione Cancella contenuto esistente nell'istanza Cloud prima dell'acquisizione durante l'acquisizione, altrimenti potrebbero mancare dei nodi nel digest di acquisizione. Si tratta dei nodi già presenti sul target dalle acquisizioni precedenti.

Per un’illustrazione grafica di questo, vedi gli esempi seguenti:

Esempio 1 example-1

  • Estrazione (sovrascrittura)

    immagine

  • Acquisizione (Cancellazione)

    immagine

  • Note

    Questa combinazione di "Sovrascrivi" e "Cancella" darà risultati di convalida coerenti, anche per acquisizioni ripetute.

Esempio 2 example-2

  • Estrazione

    immagine

  • Acquisizione

    immagine

  • Note

    Questa combinazione di "Sovrascrivi" e "Cancella" genera risultati di convalida coerenti per l’acquisizione iniziale.

    Se l’acquisizione viene ripetuta, il digest di acquisizione è vuoto e la convalida non è riuscita. Il digest di acquisizione è vuoto perché tutti i nodi di questa estrazione saranno già presenti nella destinazione.

Una volta completata l’estrazione, inizia l’acquisizione.

La parte superiore del registro di acquisizione conterrà una voce simile a aem-ethos/tools:1.2.438. Verificare che il numero di versione sia 1.2.438 o superiore, altrimenti la convalida non è supportata dalla versione di AEM as a Cloud Service in uso.

Una volta completata l’acquisizione e avviata la convalida, nel registro di acquisizione viene annotata la seguente voce di registro:

Gathering artifacts for migration validation...

I dettagli della convalida seguiranno questa voce. Di seguito è riportato un esempio tratto da una migrazione di grandi dimensioni:

Beginning publish migration validation. Migration job id=[3aba1f96-84b6-4bd0-8642-c61c0d528387]
Extraction path digest is being processed...
Extraction path digest processing took 982 seconds
Ingestion path digest is being processed...
Ingestion path digest processing took 999 seconds
Comparing the Extraction and Ingestion path digests...
----------------------------------------------------------
EXTRACTION: Number of nodes extracted: 51674784
INGESTION: Number of nodes ingested: 51674784
----------------------------------------------------------
Validation succeeded! No entries were detected to be missing from the ingestion digest.
----------------------------------------------------------
Comparing the path digests took 29 seconds
Migration validation took 33 minutes

Questo è un esempio di convalida riuscita, poiché nel digest di estrazione non erano presenti voci mancanti nel digest di acquisizione.

Per confrontare, ecco come apparirebbe un rapporto di convalida se la convalida non fosse riuscita (o se fosse stata eseguita una migrazione di integrazione):

Beginning publish migration validation. Migration job id=[ac217e5a-a08d-4e81-cbd6-f39f88b174ce]
Extraction path digest is being processed...
Extraction path digest processing took 0 seconds
Ingestion path digest is being processed...
Ingestion path digest processing took 0 seconds
Comparing the Extraction and Ingestion path digests...
----------------------------------------------------------
EXTRACTION: Number of nodes extracted: 4635
INGESTION: Number of nodes ingested: 0
----------------------------------------------------------
Validation failed. However, the following nodes may already be present in the target environment.
See our Migration Validation FAQ (https://www.adobe.com/go/aem_cloud_ctt_validation_en) or open a ticket with Customer Care.
There are 4635 entries present in the extraction digest that are missing from the ingestion digest.
/content/dam/bruce
/content/dam/bruce-assets
... more paths listed (up to 10k) ...
----------------------------------------------------------
Comparing the path digests took 0 seconds
Migration validation took 0 minutes

L’esempio di errore precedente è stato ottenuto eseguendo un’acquisizione e quindi eseguendo nuovamente la stessa acquisizione con Wipe disabilitato, in modo che non vi fossero nodi coinvolti durante l’acquisizione — tutto era già presente nel target.

Oltre a essere incluso nel registro di acquisizione, è possibile accedere al rapporto di convalida anche dall'interfaccia utente Processi di acquisizione in Cloud Acceleration Manager. A tale scopo, fare clic sui tre punti (…), quindi fare clic su Report di convalida nel menu a discesa per visualizzare il report di convalida.

immagine

Convalidare la migrazione dell’entità how-to-validate-group-migration

Consulta Migrazione gruppo per leggere i dettagli della migrazione principale e i motivi per cui è necessaria.

Una volta completata correttamente l’estrazione e l’acquisizione, sono disponibili un riepilogo e un rapporto della migrazione principale. Queste informazioni possono essere utilizzate per verificare quali gruppi sono stati migrati correttamente e, forse, per determinare perché alcuni non lo sono stati.

Per visualizzare queste informazioni, 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 individua l'acquisizione da verificare. Fai clic sui tre punti (…) per l'acquisizione, quindi fai clic su Visualizza riepilogo entità nel menu a discesa.

immagine

Viene visualizzata una finestra di dialogo con le informazioni di riepilogo. Utilizzare le icone della guida per una descrizione più completa. Fai clic sul pulsante Scarica rapporto per scaricare il rapporto CSV completo. Inoltre, alla fine di questo rapporto c’è il Rapporto utenti, che può essere utilizzato per la gestione degli utenti dopo la migrazione.

immagine

Il rapporto principale sulla migrazione conterrà:

  • È stata eseguita la migrazione di ogni gruppo e del primo percorso di contenuto che ha attivato la migrazione del gruppo. Il gruppo potrebbe trovarsi anche in altri percorsi, ma viene segnalato solo il primo trovato per un determinato gruppo. Indica anche se è stato trovato in un ACL o in un criterio CUG.

  • Ogni gruppo non è stato migrato e il motivo per cui non è stato migrato. In genere si tratta di uno dei seguenti motivi:

    • È un gruppo incorporato
    • È già presente nel sistema di destinazione
    • Non è incluso in un criterio ACL o CUG per il contenuto di cui si esegue la migrazione
    • Ha un campo univoco duplicato (uno tra rep:principalName, rep:authorizableId, jcr:uuid o rep:externalId è già presente nella destinazione, ma tutti devono essere univoci)

Risoluzione dei problemi troubleshooting

Convalida non riuscita. E adesso? validation-fail

Il primo passaggio consiste nel determinare se l’acquisizione non ha avuto esito positivo o se il contenuto estratto è già presente nell’ambiente di destinazione. Ciò può verificarsi se un'acquisizione viene ripetuta con l'opzione Cancella contenuto esistente nell'istanza cloud prima dell'acquisizione disabilitata.

Per verificare il funzionamento, scegliere un percorso dal rapporto di convalida e verificare se è presente nell'ambiente di destinazione. Se si tratta di un ambiente di pubblicazione, potresti essere limitato al controllo diretto di pagine e risorse. Apri un ticket presso l’Assistenza clienti se hai bisogno di assistenza per questo passaggio.

Il conteggio dei nodi è inferiore al previsto. Perché? node-count-lower-than-expected

Alcuni percorsi dai digest di estrazione e acquisizione sono esclusi appositamente per mantenere gestibili le dimensioni di questi file, con l’obiettivo di poter calcolare il risultato della convalida della migrazione entro due ore dal completamento dell’acquisizione.

I percorsi attualmente esclusi dai digest includono: cqdam.text.txt rappresentazioni, nodi all'interno di /home e nodi all'interno di /jcr:system.

Gruppi utenti chiusi validating-cugs

Vedere Migrazione di gruppi utenti chiusi per ulteriori considerazioni sull'utilizzo di un criterio Gruppo utenti chiuso.

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