Skip to main content
Feedback

Customizing Migration Package 4.x → 6.1.0 — Embedded Edition

This section includes information on customizing migration package from Boomi Cloud API Management – Local Edition Local 4.x to 6.1.0 for Embedded Edition.

Procedure

  1. Copy the migration package to Boomi Cloud API Management – Local Edition 4.x VM or docker container.

    info

    We recommended to run the migration utility in ML 4.x MySQL slave.

  2. Unzip the package. To extract the migration package, run the following command and go to the embedded folder:

    tar xvf migrate_4x_to_6_APIM610_2.tar.gz

Customize Settings

Below is the default settings in migrate.json.

note

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

  1. Edit the <extract location>/migrate_4x_to_6/embedded/migrate.json file:

     "MYSQL_USERNAME_APIM4": "masheryonprem",
     "MYSQL_PASSWORD_APIM4": "",
     "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": "",
     "MYSQL_SERVICE_SSL_MODE": "preferred",
     "MYSQL_SERVICE_MUTUAL_TLS": "disable",
     "MYSQL_TOKEN_BATCH_SIZE": 1000

  2. Update migrate.json file with the parameters.

    note

    You must provide the passwords for the different databases in migrate.json file.

    info

    In the above migrate.json 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.

On this Page