How to run it

Run with binaries

Prerequisites

You need to have access to the Data Migrator S3 bucket. If you don’t have access yet, you can request it via Blu Insights Toolbox.
You need to have minimal IAM policies on your account to download the Data migrator from S3 bucket. In case you don't have policies, then create one with the below information.

{
  "Version": "2012-10-17",
  "Statement": [
      {
          "Effect": "Allow",
          "Action": [
              "s3:ListBucket"
          ],
          "Resource": [
              "arn:aws:s3:::toolbox-data-migrator"
          ]
      },
      {
          "Effect": "Allow",
          "Action": [
              "s3:GetObject"
          ],
          "Resource": [
              "arn:aws:s3:::toolbox-data-migrator/*"
          ]
      }
  ]
}

Each empty database must be first manually created.

Installation guide

Toolbox buckets are replicated on the us-east-1 and us-east-2 regions. To use these replicated buckets, append the region to the bucket name: e.g. s3://toolbox-data-migrator-us-east-1. Make sure to adapt your user or role policy accordingly.

Check that you configure the AWS credentials with the AWS account used in your request made in Blu Insights Toolbox.
Download Data migrator last version archive using the command aws s3 cp --recursive s3://toolbox-data-migrator/latest LOCAL_PATH
Unpack the archive present in LOCAL_PATH.

How to launch it

To launch the steps migration in command line, open your favorite shell and type:

BluageVelocityDataMigrator.exe -root [migrationProjectPath] -configurationIni [configurationFilePath];[stepsConfigurationFilePath]

Parameters

migrationProjectPath : Absolute path to your migration project.
configurationFilePath : Absolute or relative path to your migration configuration file.
stepsConfigurationFilePath : Absolute or relative path to your migration steps configuration file.

The relative paths in the command will be resolved to the specified reverse project.

Options

The following options can be used when launching the migration using the command line:

help : Display the help; it includes the options below.
root : Root directory for the relative paths in the command line. Usually the path of your migration/reverse project.
version : Display the tool version.
configurationIni : Load the configuration from ini files, separated by semicolon.

Run with docker

Prerequisites

You need to have access to the Data Migrator ECR repository. If you don’t have access yet, you can request it via Blu Insights Toolbox.
You need to have Docker installed in your environment.
You need to have the aws-cli installed in your environment.

How to launch it

To launch the steps migration in command line, open your favorite shell and type:

Run the command: aws ecr get-login-password --region eu-west-3 | docker login --username AWS --password-stdin 170644325583.dkr.ecr.eu-west-3.amazonaws.com to log in to docker.
Run the command: docker pull 170644325583.dkr.ecr.eu-west-3.amazonaws.com/data-migrator:latest to pull the latest Data Migrator image from ECR repository.
Run the command:
docker run --rm -v [migrationProjectPath]:/home 170644325583.dkr.ecr.eu-west-3.amazonaws.com/data-migrator:latest -root /home -configurationIni [configurationFilePath];[stepsConfigurationFilePath]
Parameters
- migrationProjectPath: absolute path to your migration project
- configurationFilePath: relative path to your migration configuration file
- stepsConfigurationFilePath: relative path to your migration steps configuration file