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

Linee guida e best practice

È disponibile una nuova versione dello strumento Content Transfer (Trasferimento contenuti) che integra il processo di trasferimento dei contenuti con Cloud Acceleration Manager. Si consiglia vivamente di passare a questa nuova versione per sfruttare 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
• Miglioramento dell’esperienza utente grazie a stati di caricamento, guardrail e gestione degli errori più efficienti
• I registri di acquisizione vengono mantenuti e sono sempre disponibili per la risoluzione dei problemi

Per iniziare a utilizzare la nuova versione, è necessario disinstallare le versioni precedenti dello strumento Content Transfer (Trasferimento contenuti). Questo è necessario perché la nuova versione viene fornita con un importante cambiamento architettonico. Con la versione 2.x, è necessario creare nuovi set di migrazione ed eseguire nuovamente l’estrazione e l’acquisizione sui nuovi set di migrazione.
Le versioni precedenti alla 2.0.0 non saranno più supportate ed è consigliabile utilizzare la versione più recente.

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

• È consigliabile eseguire la pulizia delle revisioni e i controlli di coerenza dell’archivio dati nell’archivio sorgente per identificare potenziali problemi e ridurre le dimensioni dell’archivio.

• Nella fase di acquisizione, si consiglia di eseguire l’acquisizione con la modalità Cancella abilitata, affinché l’archivio esistente (di authoring o pubblicazione) nell’ambiente di destinazione AEM Cloud Service venga completamente eliminato e quindi aggiornato con i dati del set di migrazione. Questa modalità è molto più veloce della modalità in cui la cancellazione è disattivata e il set di migrazione viene applicato sul 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 stessi. È possibile creare e mantenere un massimo di cinque set di migrazione per progetto in Cloud Acceleration Manager alla volta durante l’attività di trasferimento dei contenuti. Se sono necessari più di cinque set di migrazione, è necessario creare un secondo progetto in Cloud Acceleration Manager. Tuttavia, questo richiederà una gestione del progetto aggiuntiva e una governance fuori prodotto per evitare che più utenti sovrascrivano i contenuti sul target.

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):

• l requisiti di sistema minimi per lo strumento Content Transfer (Trasferimento contenuti) sono AEM 6.3 o versione successiva e JAVA 8. Se utilizzi una versione AEM inferiore, devi aggiornare 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 java può 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 si utilizza un Ambiente sandbox, assicurati che l’ambiente sia aggiornato alla versione più recente. Se utilizzi un ambiente di produzione, viene aggiornato automaticamente.

• Per iniziare un’acquisizione, devi appartenere all’AEM locale amministratori nell’istanza del Cloud Service a cui stai trasferendo il contenuto. Gli utenti non autorizzati non potranno avviare le acquisizioni senza fornire manualmente il token di migrazione.

• Se l'impostazione Cancella i contenuti esistenti nell’istanza Cloud prima dell’acquisizione se questa opzione è 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. Questo vale anche per un utente amministratore aggiunto al amministratori gruppo. L'utente deve essere aggiunto di nuovo al amministratori per recuperare il token di accesso per lo strumento Content Transfer (Trasferimento contenuti).

• Le acquisizioni non supportano l’unione di contenuti da più origini nell’istanza del Cloud Service target se il contenuto dalle due origini viene spostato negli stessi percorsi sulla destinazione. Per spostare il contenuto da più origini in un’unica istanza del Cloud Service target, è necessario assicurarsi che non vi sia alcuna sovrapposizione dei percorsi del contenuto dalle origini.

• La chiave di estrazione è valida per 14 giorni dal momento in cui è stata creata/rinnovata. Può essere rinnovato in qualsiasi momento. Se la chiave di estrazione è scaduta, non potrai 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 di pubblicazione. Qualsiasi contenuto specificato nel set di migrazione verrà acquisito nell’istanza di destinazione selezionata. L’utente può acquisire un set di migrazione in un’istanza Author, Publish o entrambe. Durante lo spostamento del contenuto in un’istanza di produzione, si consiglia di installare CTT nell’istanza di authoring di origine per spostare il contenuto nell’istanza di authoring di destinazione e, analogamente, di installare CTT nell’istanza di pubblicazione di origine per spostare il contenuto nell’istanza di pubblicazione di destinazione. Consulta Esecuzione dello strumento Content Transfer (Trasferimento contenuti) su un’istanza Publish per ulteriori dettagli.

• Gli utenti e i gruppi trasferiti dallo strumento Content Transfer (Trasferimento contenuti) sono solo quelli necessari per il contenuto per soddisfare le autorizzazioni. Il Estrazione processo copia l'intero /home nel set di migrazione e esegue la mappatura degli utenti aggiungendo un campo creato dall’indirizzo e-mail di ciascun utente. Per ulteriori informazioni, consulta Mappatura utenti e migrazione entità. Il Acquisizione process copia tutti gli utenti e i gruppi a cui si fa riferimento negli ACL dei contenuti migrati.

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

• Dopo aver completato Estrazione fase del processo di trasferimento dei contenuti e prima di avviare Fase di acquisizione per inserire contenuti nell’AEM as a Cloud Service Fase o Produzione istanze, dovrai registrare un ticket di supporto per notificare all’Adobe la tua intenzione di eseguire Acquisizione in modo che Adobe possa garantire che non si verifichino interruzioni durante Acquisizione processo. Dovrai registrare il ticket di supporto 1 settimana prima della pianificazione Acquisizione data. Dopo aver inviato il ticket di supporto, il team di supporto fornirà indicazioni sui passaggi successivi. Puoi registrare un ticket di supporto con i seguenti dettagli:

  • Data esatta e ora stimata (con il fuso orario) in cui intendi avviare il Acquisizione fase.
  • Tipo di ambiente (stage o produzione) in cui intendi acquisire i dati.
  • ID programma.

• Il Fase di acquisizione per l’authoring riduce l’intera implementazione di authoring. Questo significa che l’istanza di authoring di AEM non sarà disponibile durante l’intero processo di acquisizione. Inoltre, assicurati che non vengano eseguite pipeline di Cloud Manager mentre esegui il Acquisizione fase.

• Quando si utilizza Amazon S3 o Azure come archivio dati sul sistema AEM di origine, l’archivio dati deve essere configurato in modo che i BLOB memorizzati 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 utilizzi gli indici personalizzati, assicurati di configurarli con tika prima di eseguire lo strumento Content Transfer (Trasferimento contenuti). Fai riferimento a Preparazione della nuova definizione dell’indice per ulteriori dettagli.

• Se intendi eseguire integrazioni, è essenziale che la struttura del contenuto esistente non venga modificata 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 valore durante il processo di migrazione.

• Se desideri includere le versioni come parte di un set di migrazione ed esegui integrazioni con wipe=false, devi quindi disabilitare l’eliminazione della versione 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.

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

Passaggio successivo

Dopo aver appreso le linee guida, le best practice e le considerazioni importanti sull’utilizzo dello strumento Content Transfer (Trasferimento contenuti), puoi procedere all’installazione e all’utilizzo dello strumento, a partire dalla creazione di un set di migrazione. Consulta Guida introduttiva allo strumento Content Transfer (Trasferimento contenuti) per ulteriori informazioni.

Risorse Business.Adobe.com