Versions Compared

Old Version 1

changes.mady.by.user Former user

Saved on

compared with

New Version 2

changes.mady.by.user Former user

Saved on

Key

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

This guide takes you through the steps for migrating few of the most used products from their older version to newer versions. E.g., Product versions based on Carbon 4.0.0 to newer versions based on Carbon 4.1.0 or 4.2.0. For more information on release versions, see the Release Matrix.

...

Following are the limitations of data migration:

  • This migration can only be done for some database types. For example, if you are using MySQL currently and you need to migrate to Oracle in the new version, these scripts will not work.
  • You cannot rollback migration. It is impossible to restore a backup of the previous server and retry the migration progress.

Downtime

The downtime is limited to the time taken for switching databases when the migrating environment is connected to the production.

Upgrade Procedure

Follow the instructions below to upgrade the system:

  1.  Stop the current server.
  2. Select the relevant script for the upgrade from here. Select the migration.sql script corresponding to your database type. E.g., If your database is MySQL, you need to execute mysql-migration.sql.Note that 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. To connect the new product version to the migrated database, configure the following files: 
    -Configure <PRODUCT_HOME>/repository/conf/datasources/master-datasources.xml. 
    -Go to the <PRODUCT_HOME>/repository/conf directory and update datasource references in user-mgt.xml and registry.xml. 

    To migrate configurations:
  4. Copy the <ESB_HOME>/repository/deployment/server/synapse-configs/default folder from the older ESB version to the new version.If you have any cApps in the current ESB, you must manually deploy them using the management console. (This is due to some improvements in cApps of Carbon 4.2.0).

  5. Perform any configurations required for the server, e.g., external user stores, clustering, mounting.

    Note

    Note that configurations should not be copied directly between servers.

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

  • UM_SYSTEM_USER_ROLE

Going into production - Recommended tests

The following are the 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.
  • The staging database should be used as the new production database with the new Carbon server. The staging server should have the configurations equivalent to the production server. Map the production domain to the staging environment, once the staging environment is running smoothly. This upgrade should be done during a period when there is low traffic on the system.

Once the above tests are run successfully, it is safe to consider that the upgrade is ready for production. However, it is always advised to carryout testing on features that are being used in production.