- Take a backup of the existing database used by the
<OLD_IS>.This backup is necessary in case the migration causes issues in the existing database.
Make the following database updates as indicated below.
Download the migration resources and unzip
wso2is-migration-x.x.x.zipfile from the latest release tag of the migration resources. Unzip it to a local directory.
This folder is referred to as
snakeyaml-1.16.0.wso2v1.jarfound in the <IS5.7.0 file in the
<IS_MIGRATION_TOOL_HOME>/dropinsdirectory, and paste it in the folder into the
Copy migration-resources folder to the
Set the following property values accordingly in the
migration-config.yamlfile found in the
<NEW_IS_HOME>/migration-resourcesfolder. Specify the current WSO2 Identity Server version as the
currentVersionvalue and specify the new version of WSO2 Identity Server that you want to migrate to, as the
If your current version of WSO2 Identity Server is 5.4.1, set the value of the
currentVersionparameter to 5.4.0 in the
migration-config.yamlinstead. This is because data migration is not required when migrating from 5.4.0 to 5.4.1.
migrationEnable: "true" currentVersion: "5.x.x" migrateVersion: "5.x.x"
- Copy any custom OSGI bundles that were added manually from the
<OLD_IS_HOME>/repository/components/dropinsfolder and paste it in the
Copy any added JAR files from the
<OLD_IS_HOME>/repository/components/libfolder and paste it in the
.jksfiles from the
<OLD_IS_HOME>/repository/resources/securityfolder and paste them in
- If you have created tenants in the previous WSO2 Identity Server version and if there are any resources in the
<OLD_IS_HOME>/repository/tenantsdirectory, copy the content to the
If you have created secondary user stores in the previous WSO2 IS version, copy the content in the
<OLD_IS_HOME>/repository/deployment/server/userstoresdirectory to the
Note: If your current version is 5.0.0, run the following queries on the database that is referenced in the
identity.xmlfile in order to identify if there is any corrupted data.
SELECT * FROM IDN_OAUTH2_ACCESS_TOKEN WHERE AUTHZ_USER LIKE '% @%' AND TOKEN_STATE='ACTIVE'; SELECT * FROM IDN_OAUTH2_ACCESS_TOKEN WHERE AUTHZ_USER NOT LIKE '%@%' AND TOKEN_STATE='ACTIVE';
Start WSO2 Identity Server with the following command to perform the data migration for all components.
Code Block language bash
sh wso2server.sh -Dmigrate -Dcomponent=identity
Code Block language bash
wso2server.bat -Dmigrate -Dcomponent=identity
Once the migration is successful, stop the server and remove the following files and folders from the