This page takes you through the steps for upgrading to DSS 3.2.0. For more information on release versions, see the Release Matrix .Table of Contents maxLevel 3 minLevel 3
...
To upgrade the existing production database (if you are upgrading from a previous Carbon version such as Carbon 4.0.0):
- Stop the current server.
Select the relevant script for the upgrade from here on the production database. The script you use will depend on the type of database you are using, for instance, if your database is MySQL, you need to run the
execute mysql-migration.sqlcommand in MySQL. Running this script will ensure that the database is upgraded with the additional tables and schemas which are required for the new DSS version.Info 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.Once you run the migration script on the production database, copy the data to the staging database you created. This becomes the new database for your new version of WSO2 DSS.
Download DSS 3.2.0 and connect it to your staging database.
...
- Configure the following files for the new production server.
- Go to the
<DSS_HOME>/repository/conf/datasources directory and update themaster-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.
- Go to the
- Copy the following directories from the old database to the staging database.
- To migrate the super tenant settings, copy the
<DSS_HOME>/repository/deployment/serverdirectory. - If multitenancy is used, copy the
<DSS_HOME>/repository/tenantsdirectory.
- To migrate the super tenant settings, copy the
- 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.