How to Setup WSO2 Mashup on JBoss

The WSO2 Mashup Server is a powerful yet simple and quick way to tailor Web-based information to the personal needs of individuals and organizations.
WSO2 Mashup can be deployed on most of the application servers.This post describes the steps to deploy WSO2 Mashup on JBOSS.


Step1
Download WSO2 Mashup Server here and unzip the package.

Step2
Download jboss-5.0.0.GA.zip and unzip the package.

Step3
Copy conf, database, repository and resources directories in to a new folder.
Ex:/home/sarasi/ms/msRepo

Step4

• I refer to my jboss installation directory as JBOSS_HOME.
• Go to JBOSS_HOME/server/default/deploy directory.
• And create a new folder,ms.war inside that directory.
• copy wso2mashup-2.0.0/webapps/ROOT/WEB-INF to JBOSS_HOME/server/default/deploy/ms.war.

Steps5

• Now, you need to enable https in JBoss.
• Open server.xml in JBOSS_HOME/server/default/deploy/jbossweb.sar directory.
• Edit it by adding the following entry.

port="8443" address="${jboss.bind.address}"
scheme="https" secure="true" clientAuth="false"
keystoreFile="/home/sarasi/ms/msRepo/resources/security/wso2carbon.jks"
keystorePass="wso2carbon" sslProtocol = "TLS" />

• give the exact location of wso2carbon.jks

Step6
You will update carbon.xml, axis2.xml, registry.xml and user-mgt.xml which can be found at msRepo/conf directory.

• open carbon.xml and update the ServerURL element as follows.

https://localhost:8443/ms/services/

• Open registry.xml and user-mgt.xml and update DB URL as follows.

jdbc:derby:/home/sarasi/ms/msRepo/database/WSO2CARBON_DB;create=true

• We must change the http and https ports in In Transports section of axis2.xml as follows.

class="org.wso2.carbon.core.transports.http.HttpTransportListener">
8080
class="org.wso2.carbon.core.transports.http.HttpsTransportListener">
8443


Step7

• open a new command window/shell and change the directory to JBOSS_HOME/bin.
• Set the environment variable named “CARBON_HOME” to point to the folder named “msRepo”.

In windows; set CARBON_HOME=C:\ms\msRepo

In linux; export CARBON_HOME=/home/sarasi/ms/msRepo

• Start JBoss from the same command window/shell.
• Now, You can access the management console using https://localhost:8443/ms/carbon.