Migrate included projects

Each project may contain multiple included projects. Additionally, any included project may contain its own included project, creating a cascading project.

The Migration Tool needs to process the original project and included projects in a single step. The reason for this is that variables can be defined in one project that refer to I/O Devices defined in another included project.

The Migration Tool performs this procedure sequentially on the "primary" project then each included project.

In the case where two primary projects share the same project as an included project, you should not select Remove obsolete Memory and Alarm devices when you process a project that contains shared included projects. This is because the removal is performed after the migration process on each primary and included projects sequentially. This could cause the deletion of an I/O Device in the first primary project which is referenced by a tag in a shared included project which is processed in a later step.

If two separate "primary" projects contain the same included project, run the Migration Tool on each "primary" project without selecting to delete obsolete devices.

 

To remove obsolete devices, it is recommended that once the Migration Tool has completed successfully (without the check box being selected), run it a second time with the check box selected. This will safely remove the devices since every tag conversion was completed in the first pass of the Migration Tool.