DocumentationCampaignCampaign Classic v7 Documentation

Migration tests testing-the-migration

Last update: Thu Apr 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

General procedure general-procedure

Depending on your configuration, there are several ways of carrying out migration tests.

You should have a test/development environment to carry out migration tests. Adobe Campaign environments are subject to license: check your license contract or contact your Adobe representative.

  1. Stop all developments in progress and carry them over to the production environment.

  2. Make a backup of the development environment database.

  3. Stop all Adobe Campaign processes on the development instance.

  4. Make a backup of the production environment database and restore it as a development environment.

  5. Before starting the Adobe Campaign services, run the freezeInstance.js cauterization script which lets you clear the database of any objects that were running when the backup was started.

    code language-none 
    nlserver javascript nms:freezeInstance.js -instance:<instance> -arg:<run|dry>
    note note
    NOTE
    The command launches by default in dry mode, and lists all the requests that were executed by that command, without launching them. To execute cauterization requests, use run in the command.

  6. Make sure your backups are correct by trying to restore them. Make sure you can access your database, your tables, your data, etc.

  7. Test the migration procedure in the development environment.

  8. If the migration of the development environment is successful, you can migrate the production environment.

CAUTION
Due to changes made to the data structure, importing and exporting data packages is not possible between a v5 platform and a v7 platform.

Migration tools migration-tools

Various options let you measure the impact from a migration and identify the potential problems. These options are to be executed:

  • in the config command:

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

  • or at the postupgrade:

    code language-none 
    nlserver.exe config -postupgrade <option> -instance:<instance-name>
NOTE
  • You must use the -instance:<instanceame> option. We do not recommend using the -allinstances option.
  • The Adobe Campaign update command (postupgrade) lets you synchronize resources and update schemas and the database. This operation can only be carried out once and only on the application server. After synchronizing resources, the postupgrade command lets you detect whether the synchronization generates any errors or warnings.

Non-standard or missing objects

  • The -showCustomEntities option displays the list of all non-standard objects:

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

    Example of a sent message:

    code language-none 
    xtk_migration:opsecurity2 xtk:entity

  • The -showDeletedEntities option displays the list of all the standard objects that are missing in the database or the file system. For each missing object, the path is specified.

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

    Example of a sent message:

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

Verification process verification-process

Integrated as standard in the postupgrade command, this process lets you display warnings and errors that could make the migration fail. If errors are displayed, the migration has not been executed. If this happens, correct all the errors then re-start the postupgrade.

You can start the verification process on its own (without migration) using the command:

nlserver.exe config -postupgrade -check -instance:<instance-name>
NOTE
You can ignore all warnings and errors with the JST-310040 code.

The following expressions are searched for (case sensitive):

Expression
Error code
Log type
Comments
.@
PU-0001
Warning
This type of syntax is no longer supported in delivery personalization.
common.js
PU-0002
Warning
This library must not be used.
logon(
PU-0003
Warning
This connection method must be no longer be used.
new SoapMethodCall(
PU-0004
Warning
This function is only supported when it is used in JavaScript code executed from a security zone that is in sessionTokenOnly mode.
sql=
PU-0005
Error
This type of error leads to a migration failure.
crmDeploymentType="onpremise"
PU-0007
Error
This type of deployment is no longer supported. Office 365 and On-premise Microsoft CRM connector deployment type have now been deprecated.
If you are using one of these deprecated deployment types in an external account, this external account should be deleted and you should then run the postupgrade command.
To change to Web API deployment, refer to Web applications.
CRM v1(mscrmWorkflow/sfdcWorkflow)
PU-0008
Error
Microsoft CRM, Salesforce, Oracle CRM On Demand action activities are no longer available. To configure the data synchronization between Adobe Campaign and a CRM system, you need to use the CRM connector targeting activity.

A database and schema coherence check is also carried out.

Restoration option restoration-option

This option lets you restore out-of-the-box objects if they had been modified. For each restored object, a backup of your changes is stored in the selected folder:

nlserver.exe config -postupgrade -restoreFactory:<backupfolder> -instance:<instance-name>
NOTE
We strongly recommend using absolute folder paths and keeping the folder tree structure. For example: backupFolder\nms\srcSchema\billing.xml.

Resume the migration resuming-migration

If you restart the postupgrade after a migration failure, it resumes from the same place it was stopped.

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