Getting Started > Upgrading to Citect SCADA 2018 > Migration Tool > Using the Migration Tool

Using the Migration Tool

Note: Before you use the 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 Migration Tool:

  1. Backup the projects that you need to migrate.
  2. Navigate to the Project activity in Citect Studio, select Home | Migration Tool to display the Migration Tool 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.

    5. 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 Citect SCADA's User directory). If this option is not selected, a new log file will be created when migration is complete.

    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).

    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

    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 Syle 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.

    6. 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.

Published June 2018