Migrating Objects from One Model to Another › Performing Migration or Trial Migration › Access the Migrate or Trial Migrate Function

Access the Migrate or Trial Migrate Function

Follow these steps:

1. Access Version Control. See the procedure Starting the Version Control Client in the chapter, "About Version Control."

   Select one of the following options, depending on whether you want to perform a migration or just report what would happen if a migration were performed.

   • Model, Migrate
   • Model, Reports, Trial Migrate
2. Select the source model and destination model. For considerations, see Determining Which Model is the Source Model.
   1. (Optional) Specify a filter for the Source Model names as described in Using a Filter.
   2. From the Source Model list, select the model that contains the objects you intend to migrate.
   3. (Optional) Specify a filter for the Destination Model names.
   4. From the Destination Model list, select the model that contains the objects you intend to replace with object definitions from the source model.
   5. Click OK.
3. Specify the Migration options. For Online Help on the field having focus, click F1. Specify the number of errors to be reported before terminating the migration, or accept the displayed default. Note that this value does not affect the success or failure of the migration. It only specifies the number of errors to report. Any error causes the migration to fail. Enter 0 (zero) to stop the migration process when the first error is encountered.
   1. Specify a report destination or accept the displayed default. For tips, see Specifying How to Save Reports.
   2. Specify a unique filename for the report or accept the displayed default.
   3. If migrating or trial migrating selected objects that belong to an aggregate set, check Aggregate Set, click OK and skip to Select Aggregate Set (Step 9).
   4. Click OK.
4. Select an aggregate object type for which you want to list occurrences. Note that the list of aggregate object types you can select for Migration is the same as the list for the Compare Report. A description of each aggregate object type is listed in a table under Become Familiar with Aggregate Object Types in this chapter.
   1. Highlight the aggregate object type of interest. Select the lowest-level aggregate object possible to migrate. This strategy reduces the number of objects that have to be migrated, as well as optimizing performance. Use the Compare Aggregate Objects Report to identify objects that have changed. Use the Trial Migration Report to determine the anticipated outcome of migrating the objects of interest. Use the expansion tables to identify component objects. If selecting a parent aggregate object, it is not necessary to select any of its component objects, since components are migrated automatically.
   2. Click List, or to limit the display to a specific range of occurrences of the selected aggregate object type, enter a filter value and click List.
5. Select one occurrence, select multiple occurrences, or click Select All. Selecting a single occurrence for expansion limits the Expanded Occurrence list to objects subordinate to the selected occurrence. This option is useful if you want to select objects of a low-level type having an extremely large number of occurrences within the model, but only a small number when accessed through the path of objects to which it is subordinate.
   • If you selected only one object and want to expand that object, click Expand. Proceed with the Aggregate Object Expanded Occurrences dialog (Step 7).
   • If you selected multiple individual occurrences, clicked Select All, or selected an object that cannot be expanded or that you do not want to expand, click Add, then click Exit. The Aggregate Object Types List appears. Either continue the selection process as described in Step 5 or click Cancel and proceed to migrate the objects you have selected, as described in Step 9 for Selected Object List.
6. Select one occurrence, select multiple occurrences individually, or click Select All. Continue in one of the following ways:
   • If you selected only one object and want to expand that object, click Expand again. Continue as described at the beginning of this step. (You can repeat this step of selecting and expanding until you reach the lowest-level object in the chain.)
   • If you selected multiple objects or selected a single object that either cannot be expanded or that you do not want to expand, click Add, then click Exit. If you performed only one expansion, the Aggregate Object Occurrences dialog with the parent object appears. If you performed multiple expansions, the Aggregate Object Expanded Occurrences dialog with the parent object appears. Click Exit repeatedly until you display the Aggregate Object Types dialog.
   • Try to migrate at the lowest level possible. Do not, for example, migrate an entity type when only an attribute has changed; migrate only the changed attribute.
7. To continue selecting objects to migrate, return to step 5. To stop the selection process, click Cancel.

   Select the aggregate set(s) to use and verify the retrieval status shows the expected number of objects retrieved.

8. Verify that the listed objects are the objects to be migrated. If so, select Proceed. (If not, see Online Help for other options.)
9. Select Yes to proceed with the trial migration or migration.
10. Review the following messages, then click Continue to generate the Migration or Trial Migration Report. The report appears in a Review panel. You can also access it from the directory you specified.
    • n objects processed during delete phase.
    • Where n is the number of objects that have been deleted from the destination model
    • n objects processed during copy phase.
    • Where n is the number of objects that have been copied from the source model to the destination model
    • Verifying protection for objects to be deleted.
    • Verifying required associations exist for object n.
    • Where n is the current count of associations that have been validated
    • Validating destination model.
    • Verifying property uniqueness.
    • Creating report.
    • Rolling back changes to the database (displays for a successful Trial Migration or an unsuccessful Migration)

Note: Additional messages are displayed for a failed migration or a trial migration.