The embedded data repository server was updated in SOAtest and Virtualize 2022.1.0. Any embedded repositories created in previous versions of the application must be migrated to the new server before they can be used in the current version. The migration process is automated with a utility available on the Parasoft Marketplace.

Requirements

• Java 8 installed and the JAVA_HOME environment variable set.
  • Note: Users with SOAtest/Virtualize 2021.2, 2021.1, or 2020.2 installed can ignore this requirement and take advantage of the Java that comes prepackaged with those versions. See Migrating Repositories below for more details.

Preparing for Migration

1. Download the Data Repository Pack from the Parasoft Marketplace.
2. Install the SOAtest/Virtualize desktop 2022.1 or newer.

Migrating Repositories

1. Open the existing SOAtest/Virtualize workspace using SOAtest/Virtualize desktop 2022.1 or newer.
2. Extract the contents of the Parasoft_SOAVirt_Data_Repository_Migration_Pack.zip file in the Data Repository Pack you downloaded previously.
   
   • If you have SOAtest/Virtualize 2021.2, 2021.1, or 2020.2 installed, extract the migration utility to its installation directory. Otherwise, so long as you have Java 8 installed and the JAVA_HOME environment variable set, you can extract the migration utility to any convenient location.
3. Open the command prompt or a terminal window.
4. Run the following command:
   • Windows: run_migration.bat <WorkspaceFolder>
     • Example: run_migration.bat "C:\Users\username\parasoft\soavirt_workspace"
   • Linux/MacOS: ./run_migration <WorkspaceFolder>
     • Example: ./run_migration "/home/username/parasoft/soavirt_workspace"
5. Open and refresh the Data Repositories view in the SOAtest/Virtualize desktop and confirm the repositories were migrated successfully.

Once the migration has run successfully, the new repository will be located in <WorkspaceFolder>\.metadata\EmbeddedDataRepository. You can delete the legacy data found in <WorkspaceFolder>\.metadata\DataRepository.