This documentation is for WSO2 API Manager 1.8.0 View documentation for the latest release.
Migrating the API Manager - API Manager 1.8.0 - WSO2 Documentation
||
Skip to end of metadata
Go to start of metadata

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. Edit the registry configurations in the <APIM_HOME>/repository/config/registry.xml and the user database in the<APIM_HOME>/repository/conf/user-mgt.xml file.

  4. 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

  5. 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

  6. 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

  7. 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

  8. 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.

Upgrading from a Previous Release

See Upgrading from the Previous Release in the following situations:

  • The new environment you are migrating to has a different database version. In this case, you must upgrade the older database.
  • You want to upgrade from a previous API Manager release to a new one.
  • No labels