Skip to content


Migrations are operations that are used to change NPL definitions and/or protocol instances.

Migration deployment is the standard tool for provisioning new NPL definitions.

Migration DSL is used to write protocol instances' transformations. Various examples are available.

Getting started

In order to run migrations, the following components are needed:

  1. Migration descriptor file specifies actions taken by the migration process
  2. Transformation files contain operations that should be applied to pre-existing protocols
  3. NPL source files containing both new and pre-existing NPL objects that will be migrated

You can then deploy your migrations.

Testing migrations

It is highly recommended to test your migrations prior to executing them against the production system. You can learn more about it on the testing migrations page.