Execute Project Migration Tool

This section describes the step-by-step migration of the project structure of your DaVinci Configurator Classic Version 5 projects into DaVinci Configurator Classic Version 6 projects, using the Project Migration Tool.

Project Migration Tool

The Project Migration Tool is a command-line tool that automatically converts your DaVinci Configurator Classic Version 5 projects into a format required by DaVinci Configurator Classic Version 6.

It automates migration steps for transforming the project structure, creating Structured Extracts and Update Workflow Scripts, and changing Active EcuC data (see Behind The Scenes).

The Project Migration Tool (project-migration.exe) is located in the migration directory inside your DaVinci Configurator Classic Version 6 installation.

Prerequisites

The migration of your DaVinci Project requires the setup of:

License

Installation

  • DaVinci Configurator Classic Version 6 (see Installation)

  • Terminal (e.g. CMD, PowerShell, Bash)

Input

  • DaVinci Configurator Classic Version 5 project to migrate, following these requirements:

  • BSW Package complying to your DaVinci Configurator Classic Version 5 project

Storage

  • Free disk space (size of your DaVinci Configurator Classic Version 5 project)

Steps

  1. Navigate to the Project Migration Tool in your terminal.

  2. Run the following command with the provided CLI Parameters, replacing the placeholders:

    project-migration --dpa-file <path to .dpa file> --dest-dir <path to destination project> --bsw-package <path to BSW Package>

    If a specified path contains spaces, please enclose it in double quotes for proper function.

    The Project Migration Tool runs and logs status information to the terminal (see Behind The Scenes).

    Once the migration completes, a new Project Structure is created together with new files for Project Settings, compatible with DaVinci Configurator Classic Version 6.

  3. If your input DaVinci Configurator Classic Version 5 project contains custom directories (not listed in Default Directory Changes), copy those into the newly created DaVinci Configurator Classic Version 6 project directory.

  4. If necessary, adjust references inside/to custom directories and references inside migrated files for Project Settings (.dvjson, .json) that could not be considered during migration (for example, references to files outside the project directory).

CLI Parameters

The following parameters can be specified for the Project Migration Tool:

Parameter Required Description

--dpa-file

Yes

This parameter specifies the path to the .dpa file of the DaVinci Configurator Classic Version 5 project to be migrated.

--dest-dir

No

This parameter specifies the destination path for the new DaVinci Configurator Classic Version 6 project to be created.

Please note the following:

  • If the specified directory does not exist, it will be created.

  • If the parameter is not specified, the default directory (your input DaVinci Configurator Classic Version 5 project) will be used. Be aware that using the default directory overwrites your input project during migration, deleting your input .dpa file.

  • If your input project files (.dpa, .dcf) contain references to files or directories outside the project directory, we recommend specifying the destination directory next to your input directory inside the parent directory of your input directory. This ensures that references are still valid after migration.

--bsw-package

Yes

This parameter specifies the path to the BSW Package to be used.