Académique Documents
Professionnel Documents
Culture Documents
org)
Home > Stories > How to Deploy WSO2 G-reg 3.6.0 on WebLogic 10.3
WSO2 Governance Registry [1] can be deployed on most of the popular application servers with a simple
set of configuration steps. In this post, we will look into the steps of deploying WSO2 Governance Registry
3.6.0 (WSO2 G-reg 3.6.0) on Oracle WebLogic application server.
Applies To
WSO2 Governance Registry 3.6.0
Oracle WebLogic Server 10.3.3
Table of Contents
We will look into the following topics within this tutorial.
1. Preparing WebLogic server
2. Building a deployable artifact
3. Configuring SSL on WebLogic
4. Updating WSO2 Governance Registry configuration files
5. Installing WSO2 Governance Registry on WebLogic
First, we should create a new domain in WebLogic server so that we can isolate WSO2 Governance
Registry deployment from the others. Create a new weblogic domain by running config.sh {bat} located at
WebLogic_HOME/wlserver_10.3/common/bin directory. Let's assume the new domain is greg_domain.
Now, we need to build an artifact from WSO2 Governance Registry binary distribution so that it can be
deployed on WebLogic server. Download WSO2 Governance Registry-3.6.0 from
wso2.org/downloads/governance-registry [2]. Extract the downloaded .zip into a directory. Copy repository
and resources directories in to a new folder. Hereafter, we will refer to this new directory as greg-repo, i.e.
/home/charitha/governance/greg-repo.
Also, create a new directory, greg, and copy the WEB-INF directory located at the lib/core directory of the
downloaded WSO2 Governance Registry-3.6.0 to the greg directory. Now, your greg-repo should have the
following sub directories.
- repository
- resources
- greg
The greg directory will be used as the webapp root and we will point to that during the installation process.
In order to enable WSO2 Carbon logging inside WebLogic, you should copy log4j.properties file in the
extracted WSO2 Governance Registry-3.6.0 directory to greg-repo\greg\WEB-INF\classes. Also, make
sure to copy xalan-*.jar, xercesImpl-*.jar and xml-apis-*.jar from the lib/endorsed directory of the extracted
WSO2 Governance Registry binary distribution to weblogic endorsed directory before you start WebLogic
Server.
We must enable SSL in weblogic server since the interactions with WSO2 Governance Registry will have
happened through HTTPS. Login to weblogic administration console (you should have configured
username and password for admin console when creating your WebLogic domain) and go to Environment
--> Servers. Then, select AdminServer.
Click on the Keystores tab. Configure Keystores as shown below.
Keystore = Custom Identity & Custom Trust
Custom Identity Keystore = /home/charitha/governance/greg-repo/resources/security
Custom Identity Keystore Type = JKS
Custom Identity Keystore Passphrase = wso2carbon
Confirm Custom Identity Keystore Passphrase = wso2carbon
Custom Trust Keystore = /home/charitha/governance/greg-repo/resources/security/ws
Custom Trust Keystore Type = JKS
Custom Trust Keystore Passphrase = wso2carbon
Confirm Custom Trust Keystore Passphrase = wso2carbon
Save the configuration and go to the General tab. Select the checkbox next to "SSL listen port enabled."
Now, we have configured the necessary changes to enable SSL on weblogic. Let's continue with deploying
WSO2 Governance Registry on weblogic.
<ServerURL>https://localhost:7002/greg/services/</ServerURL>
<url>jdbc:h2:/home/charitha/governance/greg-repo/repository/database/WSO2CARBON_DB
<url>jdbc:h2:/home/charitha/governance/greg-repo/repository/database/WSO2CARBON_DB
Make sure to specify the absolute path of the WSO2CARBON_DB in both of the above elements.
We must change the http and https ports in Transports section of axis2.xml as follows.
<transportReceiver name="http"
class="org.wso2.carbon.core.transports.http.HttpTransportListener">
<parameter name="port">7001</parameter>
</transportReceiver>
<transportReceiver name="https"
class="org.wso2.carbon.core.transports.http.HttpsTransportListener">
<parameter name="port">7002</parameter>
</transportReceiver>
We have completed the required configurations and, now, are ready to deploy WSO2 Governance Registry
on weblogic.
Define an environment variable called CARBON_HOME and set the path to your greg-repo directory.
Run startWebLogic.cmd.
Once the server is started successfully, log in to weblogic administration console using
https://localhost:7002/console.
The web app root directory will be shown with a radio button option as follows.
Click on next to proceed through the wizard and continue with the default settings. Once the deployment is
successful, save the configuration and select start --> servicing all requests.
Author:
Charitha Kankanamge
Senior Technical Lead and Manager - Quality Assurance; WSO2, Inc.
charitha@wso2.com
Links:
[1] http://wso2.org/library/governance-registry
[2] http://wso2.org/downloads/governance-registry