Versions Compared

Old Version 53

changes.mady.by.user Former user

Saved on

compared with

New Version 54

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page takes you through the steps for upgrading from DSS 3.1.1 to DSS 3.2.0. For more information on release versions, see the  Release Matrix .

Table of Contents
maxLevel3
minLevel3

...

The following are the specific prerequisites you must complete before you upgrade WSO2 DSSfrom DSS 3.1.1 to DSS 3.2.0:

  • Before you upgrade to the latest version of WSO2 DSS, you create a staging database, which is essentially an empty database. Note that you should NOT connect a new version of WSO2 DSS to an older database that has not been upgraded. 

  • Make a backup of the database and the <DSS_HOME> directory prior to upgrading. The <DSS_HOME> directory can simply be copied to the new database.

  • Stop all the Carbon servers connected to the database before running the migration scripts.

    Note

    Note that the upgrade should be done during a period when there is low traffic on the system.

Limitations

...

  • .

  • You cannot roll back an upgrade. It is impossible to restore a backup of the previous server and retry the upgrade process.

    • Downtime

    The downtime is limited to the time taken for switching databases when the staging database is promoted to the actual production status.

    Upgrading the

    ...

    configurations

    To  migrate the configurations to the staging database:

    1. Stop the current server.

    2. 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.sql command 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.sql and migration.sql. However, for all Carbon products except WSO2 IS, only the migration.sql script is required to be executed.

    3. Once you run the migration script on the production database, copy the data Copy the data from the old database to the staging database you created. This becomes the new database for your new version of WSO2 DSS.

    4. Download DSS 3.2.0 and connect it to your staging database.

    Upgrading the configurations

    ...

    2. Configure the following files for the new production server. 
    3. Copy the following directories from the old database to the staging database.
      • To migrate the super tenant settings, copy the <DSS_HOME>/repository/deployment/server directory.
      • If multitenancy is used, copy the <DSS_HOME>/repository/tenants directory.
    4. Start the server.

    Recommended Checkpoints

    The databases should contain the newly added tables, which are namely as follows:

    ...

    UM_DOMAIN

    ...

    UM_SYSTEM_USER

    ...

    UM_SYSTEM_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.