Test di migrazione testing-the-migration

Procedura generale general-procedure

A seconda della configurazione, esistono diversi modi per eseguire i test di migrazione.

È necessario disporre di un ambiente di test/sviluppo per eseguire i test di migrazione. Gli ambienti Adobe Campaign sono soggetti a licenza: controlla il contratto di licenza o contatta il tuo rappresentante Adobe.

  1. Arrestare tutti gli sviluppi in corso e trasferirli nell'ambiente di produzione.

  2. Eseguire un backup del database dell’ambiente di sviluppo.

  3. Arresta tutti i processi Adobe Campaign nell’istanza di sviluppo.

  4. Eseguire un backup del database dell’ambiente di produzione e ripristinarlo come ambiente di sviluppo.

  5. Prima di avviare i servizi Adobe Campaign, eseguire lo script di cauterizzazione freezeInstance.js che consente di cancellare il database di tutti gli oggetti in esecuzione all'avvio del backup.

    code language-none
    nlserver javascript nms:freezeInstance.js -instance:<instance> -arg:<run|dry>
    
    note note
    NOTE
    Il comando viene avviato per impostazione predefinita in modalità dry e vengono elencate tutte le richieste eseguite dal comando senza avviarle. Per eseguire le richieste di cauterizzazione, utilizzare run nel comando.
  6. Per verificare che i backup siano corretti, provare a ripristinarli. Assicurati di poter accedere al database, alle tabelle, ai dati e così via.

  7. Verifica la procedura di migrazione nell’ambiente di sviluppo.

  8. Se la migrazione dell’ambiente di sviluppo ha esito positivo, puoi eseguire la migrazione dell’ambiente di produzione.

CAUTION
A causa delle modifiche apportate alla struttura dei dati, non è possibile importare ed esportare pacchetti di dati tra una piattaforma v5 e una piattaforma v7.

Strumenti di migrazione migration-tools

Varie opzioni consentono di misurare l’impatto di una migrazione e identificare i potenziali problemi. Devono essere eseguite le seguenti opzioni:

  • nel comando config:

    code language-none
    nlserver.exe config <option> -instance:<instance-name>
    
  • o al momento del post-aggiornamento:

    code language-none
    nlserver.exe config -postupgrade <option> -instance:<instance-name>
    
NOTE
  • Utilizzare l'opzione -instance:<instanceame>. Si sconsiglia di utilizzare l'opzione -allinstances.
  • Il comando di aggiornamento di Adobe Campaign (postupgrade) consente di sincronizzare le risorse e di aggiornare gli schemi e il database. Questa operazione può essere eseguita solo una volta e solo sul server applicazioni. Dopo aver sincronizzato le risorse, il comando postupgrade consente di rilevare se la sincronizzazione genera errori o avvisi.

Oggetti mancanti o non standard

  • L'opzione -showCustomEntities visualizza l'elenco di tutti gli oggetti non standard:

    code language-none
    nlserver.exe config -showCustomEntities -instance:<instance-name>
    

    Esempio di messaggio inviato:

    code language-none
    xtk_migration:opsecurity2 xtk:entity
    
  • L'opzione -showDeletedEntities visualizza l'elenco di tutti gli oggetti standard mancanti nel database o nel file system. Per ogni oggetto mancante, viene specificato il percorso.

    code language-none
    nlserver.exe config -showDeletedEntities -instance:<instance-name>
    

    Esempio di messaggio inviato:

    code language-none
    Out of the box object 'nms:deliveryCustomizationMdl' belonging to the 'xtk:srcSchema' schema has not been found in the file system.
    

Processo di verifica verification-process

Integrato come standard nel comando post-aggiornamento, questo processo consente di visualizzare avvisi ed errori che potrebbero impedire il corretto completamento della migrazione. Se vengono visualizzati errori, la migrazione non è stata eseguita. In questo caso, correggere tutti gli errori e riavviare il post-aggiornamento.

Puoi avviare il processo di verifica da solo (senza migrazione) utilizzando il comando:

nlserver.exe config -postupgrade -check -instance:<instance-name>
NOTE
Puoi ignorare tutti gli avvisi e gli errori con il codice JST-310040.

Vengono cercate le seguenti espressioni (distinzione maiuscole/minuscole):

Espressione
Codice errore
Tipo di registro
Commenti
.@
PU-0001
Avviso
Questo tipo di sintassi non è più supportato nella personalizzazione della consegna.
common.js
PU-0002
Avviso
Questa libreria non deve essere utilizzata.
accesso(
PU-0003
Avviso
Questo metodo di connessione non deve più essere utilizzato.
nuovo SoapMethodCall(
PU-0004
Avviso
Questa funzione è supportata solo quando viene utilizzata nel codice JavaScript eseguito da un'area di sicurezza in modalità sessionTokenOnly.
sql=
PU-0005
Errore
Questo tipo di errore causa un errore di migrazione.
crmDeploymentType="onpremise"
PU-0007
Errore
Questo tipo di distribuzione non è più supportato. Il tipo di distribuzione del connettore Microsoft CRM per Office 365 e on-premise è ora obsoleto.
Se si utilizza uno di questi tipi di distribuzione obsoleti in un account esterno, è necessario eliminare questo account esterno ed eseguire il comando postupgrade.
Per modificare la distribuzione API Web, consultare Applicazioni Web.
CRM v1(mscrmWorkflow/sfdcWorkflow)
PU-0008
Errore
Le attività di azione Microsoft CRM, Salesforce, Oracle CRM On Demand non sono più disponibili. Per configurare la sincronizzazione dei dati tra Adobe Campaign e un sistema CRM, è necessario utilizzare l'attività di targeting Connettore CRM.

Viene inoltre eseguita una verifica della coerenza di database e schemi.

Opzione di ripristino restoration-option

Questa opzione consente di ripristinare gli oggetti preconfigurati, se sono stati modificati. Per ogni oggetto ripristinato, nella cartella selezionata viene memorizzato un backup delle modifiche:

nlserver.exe config -postupgrade -restoreFactory:<backupfolder> -instance:<instance-name>
NOTE
Si consiglia vivamente di utilizzare percorsi di cartelle assoluti e di mantenere la struttura ad albero delle cartelle. Ad esempio: backupFolder\nms\srcSchema\billing.xml.

Riprendi la migrazione resuming-migration

Se si riavvia il post-aggiornamento dopo un errore di migrazione, il processo riprende dalla stessa posizione in cui era stato interrotto.

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1