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 customer portal.

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 migrationParasoft_SOAVirt_Data_Repository_Migration_Pack.zip file from the Marketplace customer portal.
2. Install the SOAVirt SOAtest/Virtualize desktop 2022.1 or newer.

Anchor
Migrating Migrating

Migrating Repositories

1. Open the existing SOAVirt SOAtest/Virtualize workspace using SOAVirt SOAtest/Virtualize desktop 2022.1 or newer.

Migrating Repositories

1. Move the migrationExtract the contents of the Parasoft_SOAVirt_Data_Repository_Migration_Pack.zip file to the SOAVirt installation directory and extract the contents.
   
   • 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.
2. Open the command prompt or a terminal window.
3. 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"
4. Open and refresh the Data Repositories view in the SOAVirt 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.