This page takes you through the steps for upgrading the product version from DSS 3.1.1 to DSS 3.2.0. For more information on release versions, see the Release Matrix .Table of Contents maxLevel 3 minLevel 3
...
- Stop the current server.
- Select the relevant migration script from here. Select the
migration.sqlscript corresponding to your database type. For example, if your database is MySQL, you need to executemysql-migration.sql.Note that there are three migration scripts available:migration-service-provider.sql,migration-identity.sqlandmigration.sql. However, for all Carbon products except WSO2 IS, only themigration.sqlscript is required to be executed. - Download and run the
migration.sqlscript on the old database.
Upgrading from DSS 3.1.1 to DSS 3.2.0
...
- Download DSS 3.2.0 and connect it to the staging database you created when upgrading the database.
- Connect the latest production server to the database as described below:
- Configure the
<DSS_HOME>/repository/conf/datasources/master-datasources.xml file. See configuring master-datasources.xml. - Go to the
<DSS_HOME>/repository/confdirectory and update datasource references in theuser-mgt.xmlandregistry.xml files.See configuring user-mgt.xml and configuring registry.xml.
- Configure the
- Since a separate database (staging database) is used for the upgrade, the data that is collected in the actual production system while the upgrade is in progress should be added to the upgraded database using a script.
- Start the server.
Recommended Checkpoints
The databases should contain the newly added tables, which are namely as follows:
UM_DOMAINUM_SYSTEM_USERUM_SYSTEM_ROLEUM_SYSTEM_USER_ROLE
Going into production
The following are recommended tests to run on the staging system.
Create multiple user stores and try adding users to different user stores.
Create multiple tenants and add different user stores to the different tenants. Thereafter, add users to the various user stores.
Once the above tests are run successfully, it is safe to consider that the upgrade is ready for production. However, it is advised to test any features that are being used in production.