Running the Multi-Store Migration Batch Tool

The Multi-Store Migration (MMT) batch tool is a mono-store to multi-store ENOVIA V6 server migration tool. It can be used, for example, when migrating an 3DSpace V6R2013 server upgraded from a previous release.

The MMT batch tool, executed on a 3DSpace server with a multi-store configuration, moves each business object file to a store referenced by the store assignment rules defined in the <store> section of the PLMPolicyChooser.xml file.

This page discusses:

How the MMT Batch Works

Each PLMEntity with a non-null V_StreamDescriptor is checked for correct store assignment of it's files. If a PLMEntity’s file breaks one store assignment rule, it is moved to the proper store following store rules set up in the PLMPolicyChooser.xml file.

Rules depending on parameters such as $role and $user are not supported. Parameters supported for migration rules are:

  • $org
  • $project
  • $type.

These parameters will be checked against migrated PLMEntity attributes values:

  • V_project
  • V_organization
  • and its PLM type.

Multi-store migration can be performed in several steps since MMT progression is recorded in a log file. Starting the MMT tool with a log file containing previously run data will enable the migration to continue where it was stopped.

Multi-store migration must be executed on the central server site. The migration can be pushed onto other sites using the FCS synchronization server tool or manual MQL sync store commands.

Before pushing migration onto distant sites, make sure that each store that is replicated on a site has one (and only one) location on this site.

Running the MMT Batch Tool

The MMT batch tool is launched via the VPLMMultiStoreMigration.bat (Windows) and VPLMMultiStoreMigration.sh (UNIX) scripts.

On Windows

Go the installation folder:

INSTALL_PATH\server\win_b64\code\command

then run the following command with the appropriate command-line parameters:

VPLMMultiStoreMigration.bat

On UNIX

Go the installation folder:

INSTALL_PATH/server/scripts

then run the following command with the appropriate command-line parameters:

VPLMMultiStoreMigration.sh

Command-Line Parameters

This is the full list of command-line parameters:

Parameter Description
-ev6URL URL3DSpace Server URL
-user userid

3DSpace Admin user. Check that this user does not belong to a (distant) site. The MQL command:

print user XXX select site dump |

returns nothing.
-password password 3DSpace Admin password
-context credentials

User's credentials:

<role>.<organisation>.<collaborative space>

Recommended role is VPLMAdmin. For example:

VPLMAdmin.MyCompany.Default

-logfileFull path of the log file necessary for restart procedure
-lastLogFull path of a log file generated by previous MMT execution. This parameter is optional. This log file is parsed by the MMT tool to define the last processed PLM entity. Therefore, migration will continue starting from this last processed entity. This parameter is required if you perform multi-store migration in several passes.
[-h] [-help] Displays command line options help.