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.

  1. Check that you configure the AWS credentials with the AWS account used in your request made in Blu Insights Toolbox.
  2. Download Data migrator last version archive using the command aws s3 cp --recursive s3://toolbox-data-migrator/latest LOCAL_PATH
  3. 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.