EasiMigrate Command Line |
DEVELOPER |
 |
|
EasiMigrate Command Line |
DEVELOPER |
|
Introduction
EasiMigrate is a utility that streamlines and accelerates the migration of customer bootstraps between product versions. The functionality was previously available only through the MFC based Developer IDE, which limited how easily it could be integrated into modern development workflows.
The latest development introduces full command line support for EasiMigrate, allowing the tool to run independently of the IDE. It can now be used directly within automated processes, including Azure DevOps pipelines and other CI or CD systems. With headless execution in place, migrations can be performed without manual steps, providing consistent results across environments and making the process a straightforward part of continuous integration and deployment strategies.
|
Position |
Parameter Example |
Meaning |
Notes/Requirements |
|
1. |
<proivhome>/virtual_machine/config/decvt100.properties Path to the |
Path to the terminal properties file |
Must use a character based terminal type like DECVT100. Ensure GUI mode is disabled. |
|
2. |
%%% |
Reserved operator parameter |
Required placeholder. Not user configurable. |
|
3. |
%%% |
Reserved codiv parameter |
Required placeholder. Not user configurable. |
|
4. |
p4migrate |
Operation mode |
Must be exactly p4migrate for the migration to run. |
|
5. |
mymigration.log |
Log filename |
Stores logs, exceptions and success information. Provide any filename you want. |
|
6. |
files |
Migrate mode |
Required constant for migration execution. Must be "files" or "objects" , files takes your bootstraps in their entirety , "objects" is a condensed migration of only the core developer files required to complete a build. |
|
7. |
<proivhome>/virtual_machine/sourceboots |
Source folder |
Contains the source bootstrap files to migrate. |
|
8. |
<proivhome>/virtual_machine/targetboots |
Target folder |
Destination for migrated bootstrap files. Must be different from the proiv home used to run the command. Prevents locks and ensures a clean migration. |
Example
./runproiv.sh <proivhome>/virtual_machine/config/decvt100.properties %%% %%% p4migrate mymigration.log files <proivhome>/virtual_machine/sourceboots <proivhome>/virtual_machine/targetboots
Topic ID: 501132