This documentation is for WSO2 Identity Server 5.2.0 . View documentation for the latest release.
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

The following instructions guide you through upgrading from WSO2 Identity Server 5.1.0 to WSO2 Identity Server 5.2.0.

Migrating the embedded LDAP user store

It is not generally recommended to use the embedded LDAP user store that is shipped with WSO2 Identity Server in production setups. However, if migration of the embedded LDAP is required, follow the instructions below to migrate the existing IS 5.1.0 LDAP user store to IS 5.2.0.

  1. Copy the <IS-5.1-Home>/repository/data folder to <IS-5.2-Home/repository/data folder.
  2. Restart the server to save the changes. 

To upgrade the version of WSO2 Identity Server, the user store database should be upgraded. Note that there are no registry schema changes between versions. 

In this topic, <OLD_IS_HOME> is the directory that Identity Server 5.1.0 resides in and <NEW_IS_HOME> is the directory that Identity Server 5.2.0 resides in.

  1. Download Identity Server 5.2.0 and unzip it in the <NEW_IS_HOME> directory.
  2. Take a backup of the existing database used by Identity Server 5.1.0. This backup is necessary in case the migration causes issues in the existing database.
  3. Configure the <NEW_IS_HOME>/repository/conf/datasources/master-­datasources.xml file in Identity Server 5.2.0 by pointing to the same databases used by Identity Server 5.1.0.
  4. Configure the <NEW_IS_HOME>/repository/conf/identity/identity.xml file with the same configurations made in the <OLD_IS_HOME>/repository/conf/identity.xml file.
  5. Configure the <NEW_IS_HOME>/repository/conf/identity/identity-­mgt.properties file with the same configurations made in the <OLD_IS_HOME>/repository/conf/security/identity-mgt.properties file. 

  6. Open the <NEW_IS_HOME>/repository/conf/identity/identity.xml file and add the <PoolSize> tag under the <SessionDataPersist> tag with the default value as 200, if you have not already done so. 

    <SessionDataPersist>
                .....
                <PoolSize>200</PoolSize>
    			.....
            </SessionDataPersist>
  7. If you have created tenants in the previous Identity Server copy content in the <OLD_IS_HOME>/repository/tenants directory to <NEW_IS_HOME>/repository/tenants/ directory.
  8. If you have created secondary user stores in the previous Identity Server copy content in the <OLD_IS_HOME>/repository/deployment/server/userstores directory to <NEW_IS_HOME>/repository/deployment/server/userstores/ director
  9. You can do database migration by using the db scripts and running the respective migration script on your database. 

    Database migration is only required if you are planning to use any of the following use cases:

    • To use the PKCE feature
    • To use the workflow feature with DB2 database
    • To use manager/worker service URLs which are more than 45 characters long for BPS profiles used in workflows.
  10. Start the Identity Server 5.2.0 using the appropriate command.
    1. Linux/Unix:

      sh wso2server.sh -Dmigrate -Dcomponent=identity
    2. Windows:

      wso2server.bat -Dmigrate -Dcomponent=identity
  • No labels