The steps below explain how to migrate from API Manager 1.3.0/1.3.1 to API Manager 1.4.0.
- Shut down APIM 1.3.1 server if it is running.
<APIM 1.3.1_HOME>/repository/conf/carbon.xmlfile, uncomment the
<H2DatabaseConfiguration>element and edit it as follows:
Start APIM 1.3.1 server. Also Download and start APIM 1.4.0.
- Go to
<APIM 1.4.0_HOME>/dbscripts/migration-1.3.0_to_1.4.0folder, select the preferred database script from the scripts available there and run it against the APIM 1.3.1 server. For example, if your database is H2, you must run h2.sql.
- Go to APIM 1.3.1 management console (http://localhost:8082), open the H2 Web client and provide the H2 database URL of APIM 1.3.1 server as the JDBC URL (i.e., jdbc:h2:/home/data/wso2/wso2am-1.3.1/repository/database/WSO2AM_DB). Then, connect using wso2carbon/wso2carbon credentials.
- Copy the contents of the database script you got in step 4 (e.g., h2.sql) in the provided text box and click run.
<APIM 1.4.0_HOME>/dbscripts/migration-1.3.0_to_1.4.0/api_comments_ratings_migration_clientfolder and run the migration client you find there by following the exact steps in the README file, also saved in the same folder.
NOTE: When you configure the build.xml file, be sure to end the path of property
registry.homewith a "/". For example, /home/data/wso2/wso2am-1.3.1/.
- If you are migrating the H2 database, you must manually copy the migrated database file. To do that, replace
<APIM 1.3.1_HOME>/database/WSO2CARBON_DB.h2.dbfiles with
<APIM 1.3.1_HOME>/repository/deployment/server/synapse-configsfolder with
<APIM 1.4.0_HOME>/repository/deployment/server/synapse-configs. This replaces old synapse configs with new ones.
You have now migrated the database.