Due to the Data Repository Server upgrade in SOAtest/Virtualize 9.9, any Data Repository Servers created in previous versions of SOAtest/Virtualize must be migrated before they can be used in the current version. The migration process is automated with the Data Repository Server Migration utility.
Servers that require migration will be marked with a special icon the Data Repositories view.
Preparing for Migration
- Install and start the latest data repository server as described in Installing a Remote Data Repository Server before running the migration utility.
- Ensure that the legacy data repository server is running.
- Create a plain text properties file that specifies the existing connection properties for the source (legacy) repository and the desired connection properties for the destination (new) repository. For example:
source.repository.host=mymachine source.repository.port=2424 source.repository.username=admin source.repository.password=admin destination.repository.host=localhost destination.repository.port=27077 destination.repository.username=admin destination.repository.password=admin
Note that you need to change the port, which is 2424 by default. The above file changes the port from 2424 to 27077.
Performing the Migration
The MigrateDRServer.jar
migration utility is available in <SOAtest/Virtualize_install_dir>/migration
. It migrates a specified data repository server and saves it at the specified destination location. The only required argument is -props <arg>
, which specifies which properties file contains the server source and destination information.
To perform the migration, run MigrateDRServer.jar
with -props <arg>
and any other arguments you want to use. For example:java -jar MigrateDRServer.jar --props myprops
Any repositories from SOAtest/Virtualize 9.5 or 9.6 will be skipped; these need to be migrated with the --update
option (described below).
If any existing data repository and/or record type names exceed 50 characters, they will be automatically truncated during the migration process.
MigrateDRServer.jar Options
Available options are:
Option | Description |
---|---|
--repo <arg> | Migrates an individual repository. If this option is not specified, all repositories on the source server will be migrated to the destination server. |
--importFile <arg> | Imports an individual repository from a Data Repository export file to the repository name specified with - This does not include migration. Use |
--importName <arg> | Specifies the name of the destination repository for a Data Repository export file imported with --importFile . |
--update | Updates the schema of repositories from SOAtest/Virtualize 9.5 or 9.6 (these repositories use deprecated schemas and must be updated for use in the current version). This does not include migration. Use - |
--props <arg> | Specifies a plain text properties file that provides the existing connection properties for the source (legacy) repository server and the desired connection properties for the destination (new) repository server. |
--silent | Suppresses prompts asking for confirmation of server settings. |
--verbose | Enables verbose logging for debugging. |
Examples
To migrate all repositories (except those with deprecated schemas) on the server specified in the properties file myprops
:
java -jar MigrateDRServer.jar -props myprops
To migrate all repositories (including those with deprecated schemas) on the server specified in the properties file myprops
:
java -jar MigrateDRServer.jar -props myprops -update
To migrate the "MyDR" repository on the server specified in the properties file myprops
:
java -jar MigrateDRServer.jar -props myprops -repo MyDR
To migrate the "MyOldRepos"repository, which was created in version 9.5 and uses a deprecated schema:
java -jar MigrateDRServer.jar -props myprops -repo MyOldRepos -update
To migrate the "MyDRFile" file, which was exported from version 9.8, to a repository named MyNewRepos:
java -jar MigrateDRServer.jar -props myprops -importFile MyDRFile -import-Name MyNewRepos -update