Migrating Data Repository Servers

As of SOAtest and Virtualize 2026.2, the Parasoft Embedded Data Repository server has been removed, and the standalone Parasoft Data Repository Server is no longer supported. Any embedded and standalone servers from previous versions of the application must be migrated to a MongoDB installation to continue using them. The migration process can be automated with a utility available on the Parasoft Marketplace.

If you are looking to move a data repository from one MongoDB server to another, see Copying and Pasting Repository Data.

Prerequisites

• MongoDB Server installed.

Migrating a Desktop Embedded Data Repository

When migrating from an old, embedded data repository server, you can use a utility to automatically copy data from an existing workspace into a MongoDB Server. The new MongoDB Server must be up and running and the old installation must have been removed or at least not running.

1. Download the Data Repository Pack from the Parasoft Marketplace, which contains a migration utility designed for this operation.
2. Extract the contents of the Parasoft_SOAVirt_Data_Repository_Migration_Pack.zip file in the Data Repository Pack you downloaded to the directory of your choice.
3. Open the command prompt or a terminal window.
4. Run the command below. It uses an existing workspace to run a data repository server (source) that can then be used to migrate data into the new (destination) MongoDB server. 
   

   ./run_embedded_migration.sh --data-dir <path to workspace> \
     --username admin \
     --destination-uri mongodb://{destination-host}:{destination-port}

Migrating a Remote Data Repository Server

When migrating from a remote Parasoft Data Repository Server, make sure both it and the new destination MongoDB Server are running.

1. Download the Data Repository Pack from the Parasoft Marketplace, which contains a migration utility designed for this operation.
2. Extract the contents of the Parasoft_SOAVirt_Data_Repository_Migration_Pack.zip file in the Data Repository Pack you downloaded to the directory of your choice.
3. Open the command prompt or a terminal window.
4. Run the command below, which provides the utility with the source host and port and the destination host and port.
   

   ./run_embedded_migration.sh \
     --username admin \
     --source-uri mongodb://{source-host}:{source-port} \
     --destination-uri mongodb://{destination-host}:{destination-port}