- 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 it to a local directory. This folder is referred to as
snakeyaml-1.16.0.wso2v1.jarfound in the
<IS5.x.x_MIGRATION_TOOL_HOME>folder, and paste it in 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 version is 5.4.1, set the current version value of the
currentVersionparameter to 5.4.0 in the
migration-config.yamlfile to 5.4.0 as data migrations are instead. 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