Guided Migration

To make the migration process easier, we recommend using DaVinci Assistant.

DaVinci Assistant

DaVinci Assistant is a CLI Tool that provides a guided migration process that walks you through the following migration steps (see Migration Process Overview):

  • Update Project Structure

  • Update BSW Package

  • Update Data Files

  • Update User Code Blocks

  • Update Tool Links

Limitations

DaVinci Assistant does not support the automated Migration of Automation Projects and Scripts.

Execute DaVinci Assistant

DaVinci Assistant guides you through the migration process step by step.

Prerequisites

DaVinci Assistant requires the following system environment:

License

  • DaVinci Configurator Classic Version 6 (see License Activation)

  • DaVinci Developer Classic

  • vVIRTUALtarget

Installation

Input

  • DaVinci Configurator Classic Version 5 project to migrate

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

Access

  • Access to the file system where your input DaVinci Configurator Classic Version 5 project is located

Steps

  1. Navigate to the DaVinci Assistant directory in a terminal of your choice.

  2. Run DaVinci Assistant to directly start the migration process:

    dv-assistant.exe

  3. Follow the prompts provided by DaVinci Assistant to complete each step of the migration process.

For advanced usage, you can view the DaVinci Assistant CLI help by running the following command:

dv-assistant.exe -h

Results

After completing the migration process with DaVinci Assistant, the following outputs are generated:

  • Backup directory of your input DaVinci Configurator Classic Version 5 project, located besides your input project

  • Migrated DaVinci Configurator Classic Version 6 project, overwriting your input DaVinci Configurator Classic Version 5 project

  • A migrationstate file, located in the .dv/assistant directory of your project

  • Log files, located inside the .dv/assistant/logs directory of your project