Deploying WSO2 ESB-3.0.0 on JBoss-5.1.0.GA

Archived Content
This article is provided for historical perspective only, and may not reflect current conditions. Please refer to relevant product page for more up-to-date product information and resources.
  • By Ruwani Thakshila
  • 31 Mar, 2010

WSO2 ESB is a lightweight middleware which produces high performance, easy to acquire, deploy, manage and govern facilities. It has the capability to run on many web servers including JBoss-5.1.0.GA

Step 1:

    * Extract the downloaded zip into a directory.
    * Copy repository and resources directories in to a folder namely 'wso2esb' (Eg: /home/ruwani/Documents/esb/esb_on_jboss/wso2esb)

Step 2:

    * Create a new folder namely wso2esb.war in location JBOSS_HOME/server/default/deploy directory.
    * Copy the WEB-INF folder located in wso2esb-3.0.0/webapps/ROOT/WEB-INF to JBOSS_HOME/server/default/deploy/wso2esb.war

Step 3:

    * Open file JBOSS_HOME/server/default/deploy/jbossweb.sar/server.xml and paste the follwing entry inside <service> tags.(remember to edit the keystoreFile & keystorePass in this entry)

    <Connector address='${jboss.bind.address}' SSLEnabled='true'
    keystoreFile='/home/ruwani/Documents/esb/esb_on_jboss/wso2esb/resources/security/wso2carbon.jks'
    keystorePass='wso2carbon'
    maxSpareThreads='76' port='8443' protocol='HTTP/1.1' maxThreads='150' secure='true' scheme='https' sslProtocol='TLS' clientAuth='false'/>

Step 4:

    * Open file carbon.xml which can be found at location wso2esb/repository/conf directory.
    * Edit the ServerURL element as <ServerURL>https://localhost:8443/wso2esb/services/</ServerURL>
    * Edit the context as <WebContextRoot>/wso2esb</WebContextRoot>
    * Save and close the carbon.xml file
    * Open registry.xml which can be found at location wso2esb/repository/conf directory
    * Edit the DB URL as <url>jdbc:h2:/home/ruwani/Documents/esb/esb_on_jbos_3/wso2esb/repository/database/WSO2CARBON_DB</url> (with your CARBON_HOME)
    * Save and close the registry.xml file
    * Now, open user-mgt.xml which can be found at location wso2esb/conf directory
    * Edit the DB URL as <url>jdbc:h2:/home/ruwani/Documents/esb/esb_on_jbos_3/wso2esb/repository/database/WSO2CARBON_DB</url> (with your CARBON_HOME)
    * Save and close the user-mgt.xml file
    * Open file axis2.xml which can be found at location wso2esb/repository/conf directory
    * Edit the Synapse Home and keystore locations by adding your CARBON_HOME  (Eg: /home/ruwani/Documents/esb/esb_on_jboss/wso2esb)
    * Save and close the axis2.xml file
   
Step 5:

    * Set the CARBON_HOME environmental variable

    Linux: export CARBON_HOME=/home/ruwani/Documents/esb/esb_on_jboss/wso2esb    
    Windows: set CARBON_HOME=/home/ruwani/Documents/esb/esb_on_jboss/wso2esb

    * Start the JBoss server
    * Access the management console using https://localhost:8443/wso2esb/carbon

 

Auther: Ruwani Munasingha, Software Engineer-Quality Assurance, WSO2 Inc.