Linee guida e best practice per l’utilizzo dello strumento Content Transfer (Trasferimento contenuti)

Ultimo aggiornamento: 19 novembre 2024
  • Argomenti:

Creato per:

  • Amministratore

Linee guida e best practice

Lo strumento Content Transfer (Trasferimento contenuti) integra il processo di trasferimento dei contenuti con Cloud Acceleration Manager. È necessario utilizzare questa versione (2.0 o successiva, ma la versione 3.0 è ora consigliata) per ottenere tutti i vantaggi che offre:

  • Modalità self-service per estrarre un set di migrazione in una sola volta e trasferirlo in più ambienti in parallelo
  • È stata migliorata l’esperienza dell’utente grazie a migliori stati di caricamento, guardrail e gestione degli errori
  • I registri di acquisizione vengono mantenuti e sono sempre disponibili per la risoluzione dei problemi

Per iniziare a utilizzare la versione più recente, disinstalla le versioni precedenti dello strumento Content Transfer (Trasferimento contenuti). Con la versione 2.0 o successiva, puoi creare i set di migrazione ed eseguire nuovamente l’estrazione e l’acquisizione sui set.
Le versioni precedenti alla 2.0.0 non sono supportate e si consiglia di utilizzare la versione più recente.

Le seguenti linee guida e best practice sono applicabili alla nuova versione dello strumento Content Transfer (Trasferimento contenuti):

  • Esegui Pulizia revisioni e controlli di coerenza dell'archivio dati nell'archivio source per identificare potenziali problemi e ridurre le dimensioni dell'archivio.

  • Nella fase di acquisizione, Adobe consiglia di eseguire l'acquisizione utilizzando la modalità Cancella abilitata, in cui l'archivio esistente (Author o Publish) nell'ambiente di Cloud Service Adobe Experience Manager (AEM) di destinazione viene eliminato. Quindi, esegui l’aggiornamento con i dati del set di migrazione. Questa modalità è più veloce della modalità in cui la cancellazione è disattivata e il set di migrazione viene applicato al contenuto corrente.

  • Al termine dell’attività di trasferimento dei contenuti, nell’ambiente Cloud Service è necessaria la giusta struttura di progetto per garantire il corretto rendering dei contenuti.

  • Prima di eseguire lo strumento Content Transfer (Trasferimento contenuti), è necessario assicurarsi che nella sottodirectory crx-quickstart dell’istanza AEM sorgente vi sia spazio sufficiente. Questo perché lo strumento Content Transfer (Trasferimento contenuti) crea una copia locale dell’archivio che viene successivamente caricata nel set di migrazione.
    La formula generale per calcolare lo spazio libero su disco richiesto è la seguente:
    data store size + node store size * 1.5

  • data store size: dimensione archivio dati; lo strumento Content Transfer (Trasferimento contenuti) utilizza 64 GB, anche se l’archivio dati effettivo è più grande.

  • node store size: dimensione archivio nodi; dimensione della directory dell’archivio segmenti o dimensione del database MongoDB.
    Pertanto, per un archivio segmenti di 20 GB, lo spazio libero su disco richiesto è di 94 GB.

  • È necessario mantenere un set di migrazione per l’intera durata dell’attività di trasferimento dei contenuti per supportare l’integrazione dei contenuti. È possibile creare e mantenere un massimo di 10 set di migrazione per progetto in Cloud Acceleration Manager alla volta durante l’attività di trasferimento dei contenuti. Se sono necessari più di 10 set di migrazione, crea un secondo progetto in Cloud Acceleration Manager. Tuttavia, questo richiede una gestione del progetto aggiuntiva e una governance out-of-product per evitare la sovrascrittura dei contenuti sul target da parte di più utenti.

  • Evitare di modificare la directory di installazione dello strumento CTT. Per impostazione predefinita, l’installazione si svolge nel percorso crx-quickstart/cloud-migration. Questa posizione specifica viene utilizzata internamente da altre librerie. La modifica di questo percorso può causare problemi di estrazione.

Considerazioni importanti prima di utilizzare lo strumento Content Transfer (Trasferimento contenuti)

Segui le indicazioni riportate in questa sezione per comprendere le valutazioni importanti durante l’esecuzione dello strumento Content Transfer (Trasferimento contenuti):

  • Il requisito minimo di sistema per lo strumento Content Transfer (Trasferimento contenuti) è AEM 6.3 o versione successiva e Java™ 8. Se utilizzi una versione AEM inferiore, aggiorna l’archivio dei contenuti a AEM 6.5 per utilizzare lo strumento Content Transfer (Trasferimento contenuti).

  • Java™ deve essere configurato nell'ambiente AEM, in modo che il comando java possa essere eseguito dall'utente che avvia AEM.

  • Lo strumento Content Transfer (Trasferimento contenuti) può essere utilizzato con i seguenti tipi di archivio dati: archivio dati file, archivio dati S3, archivio dati S3 condiviso e archivio dati archivio BLOB di Azure.

  • Se utilizzi un ambiente sandbox, assicurati che sia aggiornato alla versione più recente. Se utilizzi un ambiente di produzione, viene aggiornato automaticamente.

  • Per avviare un'acquisizione, devi appartenere al gruppo locale amministratori dell'AEM nell'istanza di Cloud Service a cui stai trasferendo il contenuto. Gli utenti non autorizzati non possono avviare le acquisizioni senza fornire manualmente il token di migrazione.

  • Se l'impostazione Cancella contenuto esistente nell'istanza Cloud prima dell'acquisizione è abilitata, elimina l'intero archivio esistente e crea un nuovo archivio in cui acquisire il contenuto. Ciò significa che vengono ripristinate tutte le impostazioni, comprese le autorizzazioni sull’istanza del Cloud Service di destinazione. È anche vero per un utente amministratore aggiunto al gruppo amministratori. L'utente deve essere letto al gruppo amministratori per recuperare il token di accesso per lo strumento Content Transfer (Trasferimento contenuti).

  • La chiave di estrazione è valida per 14 giorni dal momento in cui è stata creata o rinnovata. Può essere rinnovato in qualsiasi momento. Se la chiave di estrazione è scaduta, non puoi eseguire un’estrazione.

  • Lo strumento Content Transfer (CTT) non esegue alcun tipo di analisi del contenuto prima di trasferirlo dall’istanza sorgente all’istanza di destinazione. Ad esempio, CTT non distingue tra contenuto pubblicato e non pubblicato durante l’acquisizione del contenuto in un ambiente Publish. Qualsiasi contenuto specificato nel set di migrazione viene acquisito nell’istanza di destinazione selezionata. Un utente può acquisire un set di migrazione in un’istanza Author, Publish o in entrambe. Adobe consiglia di installare CTT nell’istanza di authoring di origine per spostare il contenuto nell’istanza di authoring di destinazione durante lo spostamento del contenuto in un’istanza di produzione. Allo stesso modo, installa CTT sull’istanza Publish di origine per spostare il contenuto nell’istanza Publish di destinazione. Per ulteriori dettagli, vedere Esecuzione dello strumento Content Transfer in un'istanza di Publish.

  • I gruppi trasferiti dallo strumento Content Transfer (Trasferimento contenuti) sono solo quelli necessari in base al contenuto per soddisfare le autorizzazioni. Il processo Estrazione copia l'intero /home/groups nel set di migrazione. Per ulteriori informazioni, vedere Migrazione gruppo. Il processo Acquisizione copia tutti i gruppi a cui si fa riferimento negli ACL del contenuto migrato. Vedere Migrazione di gruppi utenti chiusi per ulteriori considerazioni sui gruppi utilizzati in un criterio Gruppo utenti chiuso (CUG).

  • Durante la fase di estrazione, lo strumento Content Transfer (Trasferimento contenuti) viene eseguito su un’istanza sorgente di AEM attiva.

  • La fase di acquisizione per l'istanza di authoring riduce l'intera distribuzione di authoring. Significa che l’AEM dell’Autore non è disponibile durante l’intero processo di acquisizione. Inoltre, accertati che non vengano eseguite pipeline Cloud Manager durante l'esecuzione della fase Acquisizione.

  • Quando si utilizza Amazon S3 o Azure come archivio dati nel sistema AEM di origine, è necessario configurare l'archivio dati in modo che i BLOB archiviati non possano essere eliminati (Garbage Collection). In questo modo viene garantita l’integrità dei dati di indice e, se non si configura questa modalità, le estrazioni potrebbero non riuscire a causa della mancanza di integrità dei dati di indice.

  • Se si utilizzano indici personalizzati, è necessario assicurarsi di configurare gli indici personalizzati con il nodo tika prima di eseguire lo strumento Content Transfer (Trasferimento contenuti). Per ulteriori dettagli, vedere Preparazione della nuova definizione dell'indice.

  • Se desideri eseguire integrazioni, la struttura del contenuto esistente non deve cambiare dal momento in cui viene effettuata l’estrazione iniziale a quando viene eseguita l’estrazione integrativa. I top-up non possono essere eseguiti su contenuti la cui struttura è stata modificata dopo l’estrazione iniziale. Assicurati di limitare questo passaggio durante il processo di migrazione.

  • Se si desidera includere le versioni come parte di un set di migrazione e si stanno eseguendo integrazioni con wipe=false, è necessario disabilitare la rimozione delle versioni a causa di una limitazione corrente nello strumento Content Transfer (Trasferimento contenuti). Se preferisci mantenere abilitata l’eliminazione delle versioni e stai eseguendo integrazioni in un set di migrazione, devi eseguire l’acquisizione come wipe=true.

  • Lo strumento Content Transfer (CTT) non supporta le acquisizioni di unione. Per consolidare i contenuti di più sistemi in un'unica istanza di Cloud Service, è possibile eseguire la migrazione solo delle versioni di un sistema di origine. Questo processo richiede l’utilizzo di migrazioni con il parametro wipe=false, che può causare tempi di acquisizione estesi a causa della natura incrementale dell’operazione. Se possibile, consolidare i contenuti in un unico sistema di origine prima di iniziare la migrazione per eliminare la necessità di unire i contenuti.

  • Un set di migrazione scade dopo un periodo prolungato di inattività, trascorso il quale i relativi dati non sono più disponibili. Rivedi Scadenza set di migrazione per ulteriori dettagli.