Skip to main content
Feedback

Building Migration Docker Image 4.x → 6.1.0 — Container Edition

This section includes information on building migration docker image from Boomi Cloud API Management – Local Edition 4.x to 6.1.0 for Container Edition.

Procedure

  1. Copy the migration package to docker host.

  2. Unzip the package. To extract the migration package, run the following command:

    tar xvf migrate_4x_to_6_APIM610_2.tar.gz

  3. Change to the folder dockerized. To build migration docker image, run the following command:

    ./docker_build_migration.sh

  4. Run the following command to verify whether the migration docker image is successfully built.

    docker image ls

    Sample Output

    REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
    migration           4x-6.1              58caf635a00c        About an hour ago   549MB

Customize Settings

Below is the default settings in migration.env.

note

Before you begin the migration, you must update the default settings of migrate.env.

  1. Edit the file.

    # ML 4.x settings
    MYSQL_HOST_APIM4=192.168.1.217
    MYSQL_PORT_APIM4=3306
    MYSQL_USERNAME_APIM4=mashclient
    MYSQL_PASSWORD_APIM4=XXXXXXXX

    # APIM 6.1 settings
    APIM6_RELEASE_VERSION=6.1.0
    APIM6_MODE=tethered
    MYSQL_HOST_APIM6=104.196.171.106
    MYSQL_PORT_APIM6=3306
    MYSQL_DATABASE_APIM6=masherysolar
    MYSQL_USERNAME_APIM6=masheryonprem
    MYSQL_PASSWORD_APIM6=XXXXXXXX
    # MYSQL_SERVICE_SSL_MODE values: disabled preferred required verify_ca verify_identity
    MYSQL_SERVICE_SSL_MODE=preferred
    # MYSQL_SERVICE_MUTUAL_TLS values: enable disable
    MYSQL_SERVICE_MUTUAL_TLS=disable
    MYSQL_TOKEN_BATCH_SIZE=1000

  2. Update migrate.env file with the parameters

    note

    You must provide the passwords for the different databases.

    info

    In the above migrate.env file:

    • To encrypt the connection with Boomi Cloud API Management – Local Edition 6.1.0 database, use MYSQL_SERVICE_SSL_MODE and MYSQL_SERVICE_MUTUAL_TLS in the settings.

    • When MYSQL_SERVICE_SSL_MODE is set to verify_ca or verify_identity, the file mysql-service-ca.pem needs to be updated with the CA certificate used to sign the MySQL certificate.

    • When MYSQL_SERVICE_MUTUAL_TLS is set to enable, the file mysql-service-client-key.pem and mysql-service-client-cert.pem need to be updated with the client key and certificate.

    • The default value of MYSQL_TOKEN_BATCH_SIZE is suitable for most MySQL servers.

Deploy Migration Docker Container

To deploy migration docker container, run the following command:

./deploy_migration.sh

To verify if the migration container is running, run the following command:

docker ps

Sample output

CONTAINER ID        IMAGE               COMMAND               CREATED             STATUS              PORTS               NAMES
5b7fe92d300e        migration:4x-6.1    "tail -f /dev/null"   About an hour ago   Up About an hour                        migration-container
On this Page