CentraSite & WSO2 Governance Tutorial

In this project, we will explore several products which are focused on SOA Governance.

In this tutorial, we will elaborate the following scenarios:

1. Installing WSO2 Governance Registry

2. Configuring and running several examples, such as:

   • Adding a new resource (1.3.1)
   • Using governance client for adding new batch services (1.3.1)
   • Using governance registry for endpoint look-up (1.3.2)

##1. WSO2 Governance

###1.1 Installation

You can download WSO2 Governance Registry from this page.

It should be noted that this product requires ant for its Java Build.

This project is experimented in Windows x64 as below:

1. At HOME/bin directory, use ant to build the project.

2. At HOME/bin directory, use wso2server.bat --run to start the WSO2 Governance.

##1.2 Getting Started

You can access the management console at port 9443 (for example: https://localhost:9443/carbon).

Default Username & Password: admin & admin

For other ports reference, you can access it from this page.

##1.3 Examples

In this section, we will elaborate several examples. Please follow the instruction in WSO2 Governance Registry/README.md.

###1.3.1 WS Client Example

First, we will add new resource to WSO2 Governance. You can use ant run in WSO2 Governance Registry/ws example/ to execute the sample code. This sample code will add a new resource called if4050_soa.

Result:

Also, you can try the governance client by changing classname="sample.SampleWSRegistryClient" from WSO2 Governance Registry/ws example/build.xml to classname="sample.SampleWSRegGovernanceClient".

Result:

###1.3.2 Endpoint Look-up Example

This sample explains how to use the Governance API to create a simple webservice which is capable of looking up service endpoints.

1. You can use mvn clean install -c (-c = bypass checksum) in WSO2 Governance Registry/endpoint search example/ to compile the source code with its dependencies.

2. You need to copy WSO2 Governance Registry/endpoint search example/target/org.wso2.carbon.registry.samples.handler-4.6.0.jar to HOME/repository/components/dropins.

3. Finally, you can start the server and access http://localhost:9763/services/EndpointLookupService?wsdl to ensure that this service has been installed successfully.

Result:

REST Invocation:

Let's say, you have a service with serviceName=SimpleStockQuoteService. You can retrieve the endpoint information using REST Invocation with the following URL: http://localhost:9763/services/EndpointLookupService/getEndpoints?serviceName=SimpleStockQuoteService&environment=Dev.

##1.4 WSO2 Governance Feature

As seen below, WSO2 can be used to manage service, schema, wsdl, endpoint, and policy.

##1.5 Reference

All of these examples are adapted from https://docs.wso2.com/display/Governance460/Samples (with several modifications).

##2. CentraSite

###2.1 Installation

You can download CentraSite Community Edition from this page.

##2.2 Getting Started

You can start the management console at Start > All Programs > Software AG > Tools > CentraSite Control

Then it will open up a page in your browser on port 53307 at login page of CentraSite

Default Username & Password: Administrator & manage

##3 Additional Information

For better understanding, please read the introduction slide at https://github.com/if-itb/IF4050-Pentaho-Tugas2-CentraSite-WSO2-Governance/blob/master/Service%20-%20CentraSite-WSO2-Governance.pdf