Application Migration

The Migration Wizard automatically converts applications created in earlier versions of Iron Speed Designer to applications compatible with the most recent version. However, new versions of Iron Speed Designer may change the structure and layout of your application’s web pages and generated code. To accommodate these changes, and to take advantage of new functionality in these Iron Speed Designer releases, you may need to migrate portions of your application to the new version by hand.

Please review the changes made in the versions of Iron Speed Designer relevant to your application. We strongly recommend you review all changes made in all versions subsequent to the one used to create your application.

Note: The application code generated by Iron Speed Designer Version 4.0 and later has changed significantly from earler versions, and as a result, you will be required to manually migrate most of your code customizations in pre-V4.0 applications before they can be used.

Migrating applications created with earlier versions of Iron Speed Designer

Follow this process to migrate an application from earlier versions of Iron Speed Designer.

Step 1: Open your application with Iron Speed Designer. The Migration Wizard is displayed. Follow the steps outlined in the Migration Wizard to convert your application to the new formats.

Step 2: We strongly recommend you let the Migration Wizard back up your application.

Step 3: Manually migrate any existing code customizations you may have created in your application’s “safe” files in versions earlier than V4.0.

Step 4: Carefully review the topics in the sections below to migrate your existing customizations successfully. You must manually migrate certain types of web page customizations, code customizations, Javascript file customizations, and RESX file customizations as indicated for each version of Iron Speed Designer subsequent to the version used to create your application.

Step 5: Generate the application (Build, Rebuild All) in Iron Speed Designer. This regenerates your application’s source code in the latest formats.

Restoring source code control files

If your original application contains any files or folders created by source code control software then during migration they will be deleted so that migration may proceed smoothly. If you need these files and folders, check the migrated application files back into the source code control system and it will recreate the folders for you. If not, then you can add these folders manually from the application back-up created by Iron Speed Designer as part of the application migration process.

Subversion source code control system

The Subversion source code control system adds a .svn folder within each folder of the application. Subversion then stores identical copies of the files in these subfolders. So if you have a ShowCustomerTable.aspx, .vb and .controls.vb in the primary folder, files with the same names are stored in the .svn folder.

The Migration Wizard is designed to look at every file in the application folder and each sub folder recursively. Since the .svn folder contains a duplicate set of files, the migration step would attempt to migrate these as well. Since these files should not be migrated, the Migration Wizard deletes them prior to migration.