Configuring the APIC Transition Helper for migration

Configure the Transition Helper deployment with the user registry information to enable the migration of users, groups, and teams from webMethods API Gateway.

Before you begin

Before you begin, ensure that you have the following:

  • Access to the API Connect Transition Helper deployment
  • Administrator privileges to modify the Transition Helper configuration
  • The name of the local user registry created in IBM® API Connect Cloud Manager. For more information, see Configuring the local user registry for migration.

About this task

After creating and enabling the local user registry in Cloud Manager, you must configure the Transition Helper to use this registry for migrating users, groups, and teams from webMethods API Gateway. This configuration ensures that migrated users are created in the correct user registry.

Procedure

  1. Access the API Connect Transition Helper deployment configuration. For more information, see Installing the transition helper tool.
  2. Locate the environment variables or configuration file for the Transition Helper.
  3. Add or update the following property: 
    APIM_USER_REGISTRY_NAME=<your-user-registry-name>

    Here, <your-user-registry-name> is the name of the user registry that you created in API Manager. For more information, see Step 5.

    For example, if you created a user registry named webmethods-migration-registry, the configuration is:

    APIM_USER_REGISTRY_NAME=webmethods-migration-registry
  4. Save the configuration changes.
  5. Restart the API Connect Transition Helper deployment to apply the configuration changes.
  6. Verify that the configuration is applied correctly by checking the Transition Helper logs or status.

Results

The Transition Helper is configured to use the specified user registry for migrating users, groups, and teams from webMethods API Gateway.

What to do next

After configuring the Transition Helper, you can proceed to migrate user management assets. Choose one of the following migration approaches: