Customizing migration configuration
Customize required configurations in migration-override.env
You must provide a few non-secret values in migration-override.env to point the migration tool at the external endpoints and the image to deploy.
Modify the following environment configuration values, according to your environment configuration:
APIM 5.x.x (source)
| Key | Action |
|---|---|
APIM5_RELEASE_VERSION | Provide the version of your APIM 5.x.x deployment. For example, 5.6.2. |
APIM5_MODE (Required) | Set your APIM 5.x.x instance deployment mode to untethered. |
APIM5_API_HOST (Required for untethered → tethered migration only) | Set the hostname of the APIM 5.x.x API service to cm-svc-0.default.svc.cluster.local. The migration tool uses this to read source entities. |
APIM5_API_PORT (Required for untethered → tethered migration only) | The port for APIM 5.x.x API service. Leave it blank to use the default port. |
APIM5_HOST_HEADER(Required for untethered → tethered migration only) | The host header for APIM 5.x.x API requests. Leave it blank if your environment does not require it. |
MYSQL_HOST_APIM5 | Set the hostname of the APIM 5.x.x MySQL database to: mysql-set-0-0.mysql-svc-0.default.svc.cluster.local |
CASSANDRA_HOST | This is required for token migration. Set the hostname address of the APIM 5.x.x Cassandra cluster to: cass-set-0-0.cass-svc-0.default.svc.cluster.local |
CAM 6.x.x (target)
| Key | Action |
|---|---|
CAM6_MODE (Required) | Set your CAM 6.x.x instance deployment mode to tethered. |
CAM6_AREA_ID (Required for trust_store and identity_store) | Provide the Area ID of your CAM 6.x.x deployment. It is required for --trust_store and --identity_store migration. |
MYSQL_HOST_CAM6 (Required) | Provide the hostname of the CAM 6.x.x MySQL database. |
MYSQL_DATABASE_CAM6 | Provide the database name of the CAM 6.x.x MySQL database. |
MYSQL_SERVICE_SSL_MODE | Set the TLS verification mode for the CAM 6.x.x MySQL connection to trust. |
MYSQL_SERVICE_MUTUAL_TLS | Set mTLS (mutual TLS) for CAM 6.x.x MySQL database to disable. |
CAM SaaS (target)
| Key | Action |
|---|---|
CAM_SAAS_API_HOST (Required for untethered → tethered migration only) | Set the hostname of the CAM Platform API to mashery.api.cron6.api.mashery.com. |
CAM_SAAS_SCOPE (Required for untethered → tethered migration only) | Provide the Area Scope UUID. |
Next steps
With your prerequisites configuration in place, return to your migration path's prerequisites page to continue to build, deploy, and connect the migration pod:
-
For untethered → tethered migration, refer to Building and deploying the migration pod for different deployment modes.
-
For untethered → untethered or tethered → tethered migration, refer to Building and deploying the migration pod for same deployment modes.
