Executing Migration Projects

Procedure

In the migration projects maintenance screen (transaction RSMIGRATE), select the migration project and choose .
In the migration project, choose .
A dialog box appears. Select the steps to be run in the project.

If you select steps that have not been run, migration is performed. If the step has already been run in the previous execution of the project, the 3.x state is restored.
Specify a name for the InfoSource that is created when the 3.x InfoSource is migrated.
To execute the project, choose Migration/Restore (to execute in the dialog box) or Execute Migration/Restore in the Background.

Results

Migration

The system performs the following actions during migration:

Step: Copy InfoSource from 3.x InfoSources

In this step, the existing 3.x InfoSource is copied to a (new) InfoSource or an existing (new) InfoSource is used again. No objects are exported.
Step: Copy Transformations from Transformation/Update Rules

In this step, a transformation as a copy of the transfer rules and a transformation as a copy of the update rules are created. The routines (R3TR ROUT) and formulas (R3TR RSFO) are also duplicated for the transformations.

Note
Read the information on postediting transformations in Migrating Update Rules, InfoSource 3.x, and Transfer Rules.
Step: Create DTPs from InfoPackages

In this step, a data transfer process is created for every update target specified in the InfoPackage. The current definition of the InfoPackage is exported beforehand.
Step: Adjust Process Chains and Variants

In this step, InfoPackages in process chains are replaced by the created data transfer processes:

In the process variants, all references to InfoPackages are changed to references to data transfer processes.

If InfoProviders are also supplied by the InfoPackages in process chains, the relevant data transfer processes are inserted into the process chain. The data transfer processes replace the HIERSAVE, PSAPROCESS and ODSPROCESS processes. These processes are removed from the process chain.

The current definition of the process chains and process variants are exported before the adjustments are made.
Step: Adjust VirtualProvider

In this step, an additional transformation between new InfoSources and VirtualProviders is created and a data transfer process for this source-target combination is created. The source system assignment in the VirtualProvider is removed.
Step: Migrate DataSources from 3.x DataSources

In this step, a DataSource is created and the 3.x DataSource is replaced by this (new) DataSource. This step corresponds to the manual migration step for 3.x DataSources. The 3.x DataSources and the transfer rules (R3TR ISTS and R3TR ISMP) are exported with routines and formulas beforehand.
Step: Delete Obsolete 3.x InfoSources and Update Rules

Obsolete 3.x InfoSources and update rules are deleted. They are exported before deletion is performed.

Restoring

The system performs the following actions during the restore operation:

Step: Delete Obsolete 3.x InfoSources and Update Rules

The exported objects are restored to the state from before migration.
Step: Migrate DataSources from 3.x DataSources

The exported DataSource 3.x objects, mapping 3.x objects, transfer rules with routines and formulas are restored.
Step: Adjust VirtualProvider

In this step, the data transfer process and the transformation are deleted and the source system assignment is restored.
Step: Adjust Process Chains and Variants

The process chains and process chain variants are changed to the state from before migration.
Step: Create DTPs from InfoPackages

The data transfer processes are removed from the data flow and the exported InfoPackages are restored to the state from before migration.
Step: Copy Transformations from Transformation/Update Rules

The transformations are removed from the data flow.
Step: Copy InfoSource from 3.x InfoSources

The InfoSources are removed from the data flow.

More information:

Read Notes on Handling Special Objects During Migration.