Migrating applications

You can migrate an application to another server, to the same server, between a server and a file, or between files using two methods:

• By migrating it as a selected object
• By deploying it (This method migrates the application and all of its supporting files.)

The following image shows the migrator homepage with the applications:

To migrate an application as a selected object

1. Open the server or file window that includes the application you want to migrate.
2. In the right pane, select the application.
3. Select Migrate > Selected Objects.

4. From the cascading menu, select Select Destination.

   You can also select any server or file listed in the cascading menu.

5. In the Destination Type dialog box, select Server or Migrator File.
   • If you select Server, select a destination server and, if necessary, enter your AR System user name and password.
   • If you select Migrator File, enter the name of the .migrator file to serve as the destination.
     If you are prompted to proceed with the migration, select Yes.
6. To view the progress and results of the migration, open the Migration Status pane by selecting View > Migration Status.

Deploying an application

When you deploy an application, Migrator migrates the application and all of its supporting objects to the destination.

To deploy an application

1. Open the server or file window that includes the application to deploy.
2. In the right pane of the window, select the application.
3. Select Migrate > Deploy Application.

4. From the cascading menu, select Select Destination.

   You can also select any server or file listed in the cascading menu.

5. In the Destination Type dialog box, select Server or Migrator File.
   If you select Server, select a destination server and, if necessary, enter your AR System user name and password.
   If you select Migrator File, enter the name of the .migrator file to serve as the destination.
   If you are prompted to proceed with the migration, select Yes.
6. To view the progress and results of your migration, choose View > Migration Status if the Migration Status pane is not already open.

Migrating application data to a file without a corresponding form

When creating an application using Developer Studio, you can specify the data to be exported when the application is deployed. This information is shown in the Data tab in the Modify Application dialog box. 

In Migrator, when you deploy an application that contains data for forms that the application does not own, those forms are not automatically migrated. However, Migrator provides an option to migrate forms required by applications at deployment. When this option is set to Yes, the forms required by the application are included with the data in the migration. 
Required Objects option: Migrate Fields Required by Applications 


If this option is set to No when you deploy an application that contains data for forms that the application does not own, Migrator creates a special data-only form to receive the data being migrated. In the Object List window, this form is listed as a data-only form with a different icon than that of a regular form or a display-only form. 
Data-only form 


During the migration, the data in this form is migrated, but not the form itself.  For more information about required objects options in Migrator, see Selecting-objects-to-be-automatically-migrated.