...
- First make sure both the source and destination stacks are setup and running.
- Download the migration tool UI from Artifactory: http://sagebionetworks.artifactoryonline.com/sagebionetworks/libs-snapshots-local/org/sagebionetworks/tool-migration-utility/0.10-SNAPSHOT/tool-migration-utility-0.10-SNAPSHOT-jar-with-dependencies.jar. Note: This URL will need to be updated when the version changes.
- The migration tool is configured using a property file passed as a command line argument. In this property file you will need to provide the required information to connect to both the source and destination stack. Create new property file using the following as a template:
Code Block # The source authentication service org.sagebionetworks.source.authentication.endpoint=https://<source_authentication_host>/auth/v1 # The source repository. org.sagebionetworks.source.repository.endpoint=https://<source_repository_host>/repo/v1 org.sagebionetworks.source.admin.username=<source_admin_username> org.sagebionetworks.source.admin.password=<source_admin_password> # The destination data. # The destination authentication service org.sagebionetworks.destination.authentication.endpoint=https://<destination_authentication_host>/auth/v1 # The source repository. org.sagebionetworks.destination.repository.endpoint=https://<destination_repository_host>/repo/v1 org.sagebionetworks.destination.admin.username=<destination_admin_username> org.sagebionetworks.destination.admin.password=<destination_admin_password> # The max number of entities submitted per job. org.sagebionetworks.batch.size=25 # The max number of thread used by this tool. org.sagebionetworks.max.threads=4 # Worker timeout in MS org.sagebionetworks.worker.thread.timout.ms=240000
- Save the property file to your local machine. This file will be used in the next step.
- Start the migration tool from the command line using the following:
Note: Replace <path_property_file> with the path to your property file from the previous step.Code Block java -cp tool-migration-utility-0.10-SNAPSHOT-jar-with-dependencies.jar org.sagebionetworks.tool.migration.gui.MigrationConsoleUI "<path_property_file>.properties"
- Warning: Validate the migration tool is pointing to the correct source and destination stacks. Check the entity counts of the source (left side of the screen) and the destination (right side of the screen). Also check the path information for both the source and destination. All data from the destination repository will be lost once migration starts!!!!!!
- Once you are absolutely certain that it is configured correct press the "Start" button. This will start the migration process. If the migration tool crashes while running simply restart it as it will pickup where it left off.