In this section:

Introduction

The Data Repository Migration tool provides an automated process to migrate repositories created in an older embedded repository server into the updated embedded repository server introduced in SOAtest and Virtualize 2022.1.0.

Migrating Embedded Data Repository Servers

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 later.

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.

Third-Party Content

This extension includes items that have been sourced from third parties as outlined below.

• Logback Classic Module (Eclipse Public License 1.0)
• Logback Core Module (Eclipse Public License 1.0)
• Jackson-core (Apache License 2.0)
• Guava: Google Core Libraries for Java (Apache License 2.0)
• Orient Commons (Apache License 2.0)
• OrientDB Client (Apache License 2.0)
• OrientDB Core (Apache License 2.0)
• OrientDB Enterprise (Apache License 2.0)
• Apache Commons CLI (Apache License 2.0)
• JMS API (CDDL + GPLv2 w/ classpath exception)
• Saxon-HE (Mozilla Public License 2.0)
• Apache Commons Exec (Apache License 2.0)
• Stax2 (BSD License)
• Woodstox (Apache License 2.0)
• MongoDB Java Driver (Apache License 2.0)
• SLF4J (MIT license)
• WSDL4J (Common Public License)
• xercesImpl (Apache License 2.0)