This documentation is for WSO2 Identity Server 5.2.0. View documentation for the latest release.
Page Comparison - Upgrading From an Older Version of WSO2 IS (v.1 vs v.2) - Identity Server 5.2.0 - WSO2 Documentation

Versions Compared

Key

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

...

  • Migrating by updating the custom configurations

    Panel

    This approach is recommended if:

    • You have done very few configuration changes in your previous version of WSO2 IS. These configuration changes have been tracked and are easy to redo.  

    Steps:

    1. If you have made configuration changes to the config files in your previous version of WSO2 IS, update the files in the <NEW_IS_HOME>/repository/conf folder with your own configurations. 
    2. Proceed to the Migrating the data section to run the migration client.
  • Migrating by updating the new configurations in 5.2.0

    Panel

    This approach is recommended if:

    • You have done many configuration changes in your previous version of WSO2 IS.
    • These configurations have not been tracked completely and/or are difficult to redo.  

    Steps:

    1. Make a copy of the <OLD_IS_HOME>/repository/conf folder. (Do not change the original configurations. You may use it as a backup in case there are any issues)
    2. Copy the following configuration files from the <NEW_IS_HOME> and paste it in the copy of the <OLD_IS_HOME> in the relevant path.
      • <IS_HOME>/repository/conf/carbon.properties

      • <IS_HOME>/repository/conf/consent-mgt-config.xml

    3. The sections below list out all the configuration changes from IS 5.0.0 to IS 5.2.0. You can scroll through each table and change the relevant configurations according to the features you are using.

      Tip

      Note: The configuration changes listed below will not affect the existing system because these configurations are applied only at first start up and new tenant creation.

      If you want to change the configurations for the existing tenants, configure it through the management console user interface.

      Panel
      borderColorBlack
      bgColorWhite
      borderWidth2
      borderStylesolid

      Tip: Scroll left/right to view the entire table below.

      Localtab Group
      Localtab
      activetrue
      id510
      titleIS 5.0.0 to 5.1.0

      Multiexcerpt include
      MultiExcerptNameconfigs
      nopaneltrue
      PageWithExcerptIS510:Upgrading from the Previous Release

      Expand
      titleAPI changes: Click here to view the steps..

      Multiexcerpt include
      MultiExcerptNameapis
      nopaneltrue
      PageWithExcerptIS510:Upgrading from the Previous Release

      TipRecommended: See the WSO2 IS 5.1.0 migration guide for more information.

      Note that the following files located in the <IS_HOME>/repository/conf/ folder in 5.0.0 have been moved to the <IS_HOME>/repository/conf/identity/ folder in 5.1.0 onwards:

      • provisioning-config.xml

      • identity.xml
      • /security/identity-mgt.properties
      Localtab
      id520
      titleIS 5.1.0 to 5.2.0

      Excerpt Include
      Upgrading from the Previous Release
      Upgrading from the Previous Release
      nopaneltrue

      TipRecommended: See the WSO2 IS 5.2.0 migration guide for more information.

      Note that the following new configuration files have been added from 5.2.0 onwards.

      • repository/conf/event-processor.xml
      • repository/conf/security/Owasp.CsrfGuard.Carbon.properties
      • repository/conf/tomcat/carbon/WEB-INF/web.xml
      • repository/conf/identity/oidc-scope-config.xml
    4. Replace the <NEW_IS_HOME>/repository/conf folder with the modified copy of the <OLD_IS_HOME>/repository/conf folder.

    5. Proceed to the Migrating the data section to run the migration client.

...