Procedure for Parallelizing Migration Processes

This procedure lists the steps you have to perform to parallelize migration processes. It is highly recommended that you parallelize migration processes to reduce the time required to migrate data from former to Unified Typing.

Important: The parallel mode must be activated before starting the migration process:
  • Under Unix: export NTMigEnableMultiProcess=1
  • Under Windows: set NTMigEnableMultiProcess=1

The stages in this procedure are as follows:

See Also
Running the Migration
About the Unified Typing Migration Tool

Define the Number of Processes

The number of processes considerably depends on the number of machine cores. To determine the optimal number of processes, it is recommended that you perform tests.

Define the Number of Objects to Migrate in Each Process

You should migrate approximately the same number of objects in each process using the NTMigObjectsToMigrate.csv file generated by the -genFiles option.

The NTMigObjectsToMigrate.csv file contains:

  • The number of objects to migrate for each type
  • The cumulative number of objects to migrate

To define the number of objects to migrate in each process, do the following:

  • Look at the number of objects to migrate in the NTMigObjectsToMigrate.csv file.
  • Divide this number by the number of processes to use. This way, you obtain the approximate number of objects to migrate (optimal number) for each process.

Create ntmtypes Files for Each Process

Once the approximate number of objects to migrate in each process is computed, enter the types of objects in each file so that the number of objects to migrate bearing these types is approximately equal to the optimal number.

Example

TypesProcess_1.ntmtypes :
# Total = 64072
#
#PLMProductInstanceDS,Connection,64072
PLMProductInstanceDS

Run the Unified Typing Migration Tool (UTMT) on Every Process

  1. Open as many windows as there are processes.
  2. In each window, run the UTMT tool with one .ntmtypes file.

Launch the Unified Typing Migration Tool (UTMT) Using the updateImpacted or the ui Option

You must update all paths once the migration is complete using the updateImpacted also known as ui option.

To update all paths, enter the following command:
exec prog emxNewTypingMigrationProgram -dir dirLocation – updateImpacted <N> or exec prog emxNewTypingMigrationProgram -dir dirLocation – ui <N>.
Notes:
  • <N> stands for the number of threads.
  • Running emxNewTypingMigrationProgram using the -updateImpacted <N> option creates a file named NTMPathGlobalFile.ntmpathall. The generated file can be non-empty after launching the-updateImpacted <N> option. As long as this file is not empty, you can only run emxNewTypingMigrationProgram using the -updateImpacted <N> option.

Run the Cleaning

This step updates exchange status objects, updates and cleans migration information related to the migrated objects. It is triggered using the –Clean option and can be explicitly committed using the –commit option.