Migrating the API Manager

If you have multiple instances of the WSO2 API Manager and want to move your data and deployment artifacts from one instance to another (such as moving from development to test or production), follow the steps below.

1. Get a data dump from all the tables in the apimgt schema and dump them to the schema in the new environment.

2. Open <APIM_HOME>/repository/conf/datasources/master-datasources.xml file and provide the datasource configurations for the following databases in the new environment.

   • User Store
   • Registry database
   • API Manager Databases

3. Move all your synapse configurations by copying and replacing <APIM_HOME>/repository/deployment/server/synapse-config/default directory to the same directory in the new environment.

   If you changed the default URLs in AuthorizeAPI.xml and TokenAPI.xml files, do not replace them when copying. They are application-specific APIs.

   Migrate tenants

4. If you have multiple tenants added to your API Manager instance, follow the steps below to migrate tenant configurations:
   1. Copy the contents from <APIM_HOME>/repository/tenants directory to the same directory in the new environment.  
   2. Execute the following steps for all tenants in your system.

   Migrate external stores

5. If you have external stores configured under the <ExternalAPIStores> element in <APIM_HOME>/repository/conf/api-manager.xml file, follow the steps below:

   1. Log in to APIM management console and click the Resources -> Browse menu.

   2. Load /_system/governance/apimgt/externalstores/external-api-stores.xml resource in the registry browser UI, configure your external stores there and save.

   Migrate Google analytics

6. If you have Google Analytics configured under <GoogleAnalyticsTracking> element in <APIM_HOME>/repository/conf/api-manager.xml file, follow the steps below:

   1. Log in to APIM management console and go to Resources -> Browse menu.

   2. Load /_system/governance/apimgt/statistics/ga-config.xml resource in the registry browser UI, configure the Google analytics and save.

   Migrate workflows

7. If you have Workflows configured under <WorkFlowExtensions> element in <APIM_HOME>/repository/conf/api-manager.xml file, follow the steps below:

   1. Log in to APIM management console and go to Resources -> Browse menu.

   2. Load /_system/governance/apimgt/applicationdata/workflow-extensions.xml resource in the registry browser UI, configure your workflows and save.