Versions Compared


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


  1. Download WSO2 G-Reg and WSO2 ESB/WSO2 EI products and unzip them.
  2. Apply a port offset in the <ESB<G-REG_HOME>/repository/conf/carbon.xml file (or the <EI_HOME>/conf/carbon.xml file).


    By default, both servers are running on the 9443 port. Therefore, you have to change either of the server ports.

  3. Copy the <ESB_HOME>/repository/components/plugins/org.wso2.carbon.service.mgt.stub_4.x.x.jar file (or the <EI_HOME>/WSO2/components/plugins/org.wso2.carbon.service.mgt.stub_4.x.x.jar file) to the <G-REG_HOME>/repository/components/dropins directory.

  4. Download or clone the service discovery client project and build it.
  5. Copy the built JAR file into the <G-REG_HOME>/repository/components/dropins directory. 
  6. Add the following task under the <tasks> element of the <G-REG_HOME>/repository/conf/registry.xml file, to register the service discovery client as a task.

    Code Block
    <task name="ServiceDiscovery" class="">
        <trigger cron="0/100 * * * * ?" />
        <property key="userName" value="admin" />
        <property key="password" value="admin" />
        <property key="serverUrl" value="https://localhost:9444/services/" />
        <property key="version" value="1.0.0" />
  7. Change the values of the userName, password, serverUrl and version properties in the above configurations according to your setup.

  8. Start WSO2 ESB/EI and then start WSO2 G-Reg.