This documentation is for WSO2 Governance Registry 5.0.1. View documentation for the latest release.

Versions Compared


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

To upgrade the version of WSO2 Governance Registry, the user store database should be upgraded. Note that there are no registry schema changes between versions. This topic provides instructions on how you can upgrade (the data and configurations) from WSO2 GREG 5.0.0 to WSO2 GREG 5.0.1. 

Table of Contents

If you want to migrate your Governance Registry configurations from one instance to another (such as when promoting your instance from test to production) using the same Governance Registry release, see Migrating the Governance Registry.


To upgrade from a version older than WSO2 G-Reg 5.0.0, start from the doc that was released immediately after your current release and upgrade incrementally.

Preparing to upgrade

The following are the specific prerequisites you must complete before you upgrade WSO2 GREG:


  1. Download WSO2 Governance Registry 5.0.1 from

  2. Stop all running server instances of WSO2 Governance Registry 5.0.0.

  3. Make sure that you have taken a backup of all the databases and existing configurations.
  4. To connect the new product version to the upgraded database, configure the following files:  
    1. Change the configurations accordingly in all datasources of the <PRODUCT_HOME>/repository/conf/datasources/master-datasources.xmlfile, to point them to the upgraded database. For more information on how to do this for your database type, see Working with Databases.
    2. Go to the <PRODUCT _HOME>/repository/conf directory and update the datasource references in user-mgt.xmlregistry.xml and api-manager.xml to match the updated configurations in the master-datasources.xml file which you made in the above step. The following are sample configurations if the datasource is jdbc/WSO2CarbonDB.

      Code Block
      <dbConfig name="wso2registry">
      Code Block
        <Property name="dataSource">jdbc/WSO2CarbonDB</Property>
      Code Block
  5. If there are several 1000s of artifacts in the system, increase the value of the <indexingFrequencyInSeconds> property (e.g. to 10), or reduce the value of the <batchSize> property (e.g. to 10) in the <GREG_HOME>/repository/conf/registry.xml file as shown below.

    Code Block
    <!--number of resources submit for given indexing thread -->
    <!--number of worker threads for indexing -->
    <!-- location storing the time the indexing took place-->
  6. Download the org.wso2.carbon.greg.migrate.client-5.0.0.jar file and copy it to the <GREG_HOME>/repository/components/dropins directory. If you use a clustered/distributed setup, copy the JAR file to the master nodes. 
  7. Start the WSO2 Governance Registry 5.0.1 with the following command options to migrate the registry configurations. If you have a clustered/distributed setup, run the following command options in master node only.

    Code Block
    -Dmigrate=5.0.0 -DmigrateReg=true
    For example,
    Linux: sh -Dmigrate=5.0.1 -DmigrateReg=trueWindows: wso2server.bat -Dmigrate=5.0.1 -DmigrateReg=true
  8. It is recommended to restart all the WSO2 Governance Registry 5.0.1 instances. Check for any other configurations that were done for WSO2 Governance Registry 5.0.0 (based on your solutions), and update the configuration files in WSO2 Governance Registry 5.0.1 accordingly. For example, external user stores, caching, mounting.


Follow the steps below to re-index the resources after completing the migration.

  1. Delete the 'solr' directory of the file system <G-REG_HOME>/solr/ directory.
  2. Change the name (e.g. lastaccesstime to lastaccesstime_1of the file in the registry which tracks the last access time of indexing the resources, by changing the value of the <lastAccessTimeLocation> property  property in the the <G-REG_HOME>/repositiry/conf/registry.xml file to enter an integer at the end of the value  file as follows.
  3. Restart the G-Reg server and wait for around 30 minutes. This time duration depends on number of resources that are there in the registry.