Using the Project Migration Tool

Note: Before you use the Project Migration Tool, is recommended that you familiarize yourself with the process that it performs, and the preparatory steps that you need to carry out with your existing projects.

To run the Project Migration Tool:

1. Backup the projects that you need to migrate.

2. Navigate to the Project activity in Plant SCADA Studio, select Home, Migration Tool to display the Project Migration dialog.

3. Either accept the project displayed in the edit box, or browse for the project that you wish to upgrade.

4. Specify the changes you would like to implement during the migration process by selecting from the options described in the following table.

   Option	Description
   Remove obsolete Memory and Alarm devices	Select this check box if you wish to delete these types of devices after successful migration (see Remove Obsolete Memory and Alarm Devices). Note: Do not select this check box when you run the tool for the first time on a project that contains any included projects which are shared with more than one master project. If you want to delete obsolete devices under these circumstances, you can run the tool a second time using this option if the migration is successful after it is run the first time.
   Append to existing log file	Use this option to append information about the migration process to the existing Migration Tool log file (located in Plant SCADA's User directory). If this option is not selected, a new log file will be created when migration is complete.
   Create unique IDs for Variables and Equipment	Select this option to add a unique ID to the variable tags, equipment and equipment types in your project. Unique IDs were added to variable tags in Plant SCADA 2023 and equipment in 2023 R2. This setting should be applied to any projects that you migrate. You can also use it to repair a project if you are seeing compiler warning W1050 (Unique ID expected).
   Create roles from User security information	Select this option if you wish to migrate the users database from an existing project (see Creation of Roles for Existing Users).
   Copy XP_Style menu into Tab_Style menu	Select this option to convert legacy menu entries to the format necessary for the new menu configuration system. By default, this option is unchecked to avoid potential compile errors that may occur if the legacy menu.dbf contains functions which have been removed.
   Migrate included projects	Select this option to migrate the included projects associated with the selected project (see Migrate Included Projects).
   Migrate Equipment database, Types and Parameters	You should check this option to migrate your equipment to use configuration parameters, introduced in Plant SCADA 2023 to replace custom parameters. Configuration parameters support the same functionality as the legacy custom parameters, but they are stored in a dedicated configuration parameter database that removes the 256 character limitation. See Migrate Custom Parameters to the Configuration Parameters Database. You should also select this option if you have an existing database that you want to migrate into this version. When upgrading from an earlier version, and the "PARENT" field of the equipment table was used, you should select this check box. Otherwise existing data from the PARENT field will be ignored. If runtime browsing is used, the PARENT field will return the equipment parent (the substring of the equipment name without the last '.' and anything after that). To retrieve information that was stored in the previous "PARENT" field the "COMPOSITE" field should be used.
   Migrate ABCLX to OPCLX	Select this option if you want to migrate devices that currently use the ABCLX driver to the OPCLX driver. Select the Configure button to indicate which I/O devices you would like to migrate. Note: You should confirm that the OPCLX driver is installed before you use this option.
   Migrate Trend/SPC storage method	If you select this option, the storage method will be set to scaled (2-byte samples) for all trends that have no storage method defined. Use this option to stop the compiler error message "The Storage Method is not defined". In previous versions, a blank storage method would default to scaled. However, this is no longer supported, resulting in the compile error message.
   Create computers from Network Addresses	If you select this option, computers will be created from the servers and network addresses that you have configured for a project and its include projects. This option distinguishes whether a computer has multiple IP addresses.

   Note: If 'Copy XP Style menu into Tab_Style Menu' and 'Migrate Included Projects' are both selected when the migration tool runs, the following message will be displayed: "Copying menus of included projects may lead to conflicts. Any conflicts will need to be manually corrected". To avoid this from occurring, it is recommended you run the migration tool twice. In the first instance just select the option 'Copy XP_Style menu into Tab_Style Menu', and in the second instance just select the option 'Migrate Included Projects'.

5. Click Migrate to begin the migration process.

   A progress dialog will display indicating the stage of the conversion and the name of the project being migrated. If you wish to cancel the migration at this point click the Abort button.

   Note: Aborting a migration will stop the migration process, and any changes already completed will not be rolled back. You will have to restore your project from the backup created in the first step.

   When the migration process is concluded, a confirmation dialog box will display indicating the number of variables converted and the number of I/O devices deleted (if device deletion was selected at the start of migration).

6. Click the Close button to close the dialog.