How to deploy WSAS-3.X on Oracle WebLogic 10.3


Once Azeez has written a 10 minute guide to installing WSO2 WSAS on Weblogic server. That guide explains the steps to deploy 2.X family of WSAS on weblogic. With the introduction of WSO2 Carbon platform in December 2008, WSO2 WSAS is no longer distributed as a separate war distribution. Hence, the instructions given in that document is not applicable when deploying WSO2 WSAS-3.X series on Oracle WebLogic server.
Since all WSO2 java products are built on Carbon platform, users can configure running WSO2 products on any application server using a set of components included in binary distributions. I have already explained the steps to deploy WSO2 BPS on tomcat and WSO2 WSAS-3.X on Jboss.

This post describes the steps to deploy WSO2 WSAS-3.X on WebLogic 10.3


Create a new weblogic domain by running {bat} located at WebLogic_HOME/wlserver_10.3/common/bin directory.
Lets assume the new domain is wsas.

Access your weblogic domain direcrtory and start weblogic (Go to WebLogic_HOME/user_projects/domains/wsas/bin and run startWebLogic.cmd)

Step 2
Download the latest version of WSO2 WSAS-3.X from here. Extract the downloaded zip into a directory. Copy conf, database, repository and resources directories in to a new folder. Here after, we will refer it is wsas-repo (i.e:- C:\wsas\wsas-repo)

Also, create a new directory, wso2wsas and copy the WEB-INF directory located at the webapps/ROOT directory of the downloaded WSO2 WSAS-3.X to wso2wsas directory. Now, your wsas-repo should have five sub directories - conf, database, repository, resources and wso2wsas.
wso2wsas will be used as the webapp root directory.

Step 3

We need to enable SSL in weblogic server. Log in to weblogic administration console (You should have configured username and password for admin console when creating your WebLogic domain) and go to Environment --> servers. Select AdminServer.
Click on KeyStores tab. Configure keystores as shown below.

Keystore = Custom Identity & Custom Trust

Custom Identity Keystore = C:\wsas\wsas-repo\resources\security\wso2carbon.jks

Custom Identity Keystore Type = JKS

Custom Identity Keystore Passphrase = wso2carbon

Confirm Custom Identity Keystore Passphrase = wso2carbon

Custom Trust Keystore = C:\wsas\wsas-repo\resources\security\wso2carbon.jks

Custom Trust Keystore Type = JKS

Custom Trust Keystore Passphrase = wso2carbon

Confirm Custom Trust Keystore Passphrase = wso2carbon

Now, select SSL tab and enter the following values.

Identity and trust locations = keystores

Private Key Alias = wso2carbon

Private Key Passphrase = wso2carbon

Confirm Private Key Passphrase = wso2carbon

Save the configuration and go to the General tab. Select the check box next to "SSL listen port enabled".

Now we have configured the necessary changes to enable SSL on weblogic. Lets continue with deploying WSO2 WSAS on weblogic.

Step 4

Now, we should update the set of config files shipped with WSO2 WSAS. We will update carbon.xml, axis2.xml, registry.xml and user-mgt.xml which can be found at the above wsas-repo\conf directory.
First, open carbon.xml and update the ServerURL element as follows.


Note that we have configured weblogic to run on 7002 port.

Update WebContextRoot element as follows.


Save and close carbon.xml.

Open registry.xml and update DB URL as follows.


Now, open user-mgt.xml and update database URL as follows.


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 In Transports section of axis2.xml as follows.

<transportReceiver name="http"
<parameter name="port">7001</parameter>


<transportReceiver name="https"

<parameter name="port">7002</parameter>

Step 5

We have completed the required configurations and we can deploy WSO2 WSAS on weblogic now.
First, shutdown the weblogic server instance if it is still running.
open a new command window and change the directory to WebLogic_HOME/user_projects/domains/wsas/bin.
Define an environment variable called CARBON_HOME and set the path to your wsas-repo directory.

In windows; set CARBON_HOME=C:\wsas\wsas-repo
In linux; export CARBON_HOME=\home\user\wsas\wsas-repo

Run startWebLogic.cmd

Once the server is started successfully, log in to weblogic administration console using https://localhost:7002/console
Then, go to the Summary of Deployments page and select Install.
Locate the deployment root by selecting C:\wsas\wsas-repo\wso2wsas directory. (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

Now, we are done with the deployment. You could access the management console using https:\\localhost:7002\wso2wsas\carbon

1. In order to set the log4j logs, you may copy file in the extracted WSO2WSAS-3.X directory to wsas-repo\wso2wsas\WEB-INF\classes

2. If you want to deploy JaxWS services in WSAS/WebLogic platform, you should do the following configuration to avoid a class casting issue (

- Remove weblogic.jar/META-INF/services/ & restart Carbon

3. Also, Make sure to copy xalan-*.jar, xercesImpl-*.jar and xml-apis-*.jar from the lib/endorsed directory of the extracted WSAS binary distribution to weblogic endorsed directory before you start WSAS.


Harshit Kapoor said…
It is a good walk through, however there is a typo error at Step 3.

Instead of
Custom Identity Keystore Passphrase = wsocarbon

it should be
Custom Identity Keystore Passphrase = wso2carbon
Charitha said…
Thank you very much Harshit, i have corrected it
Harshit Kapoor said…
Good to see you responsive!
I have followed the steps as mentioned in this post, however, when I access carbon management console I get the following:

"ProxyServlet: /wso2wsas/carbon"

I do not get anything else in the browser.

Could you help?
Charitha said…
Hi Harshit,
Did you follow the extra 3 steps specified under "notes" section at the bottom of this post? Please let me know

Charitha said…
Actually out of the 3 extra steps given under notes, you should do the step 3, "Make sure to copy xalan-*.jar, xercesImpl-*.jar and xml-apis-*.jar from the lib/endorsed directory of the extracted WSAS binary distribution to weblogic endorsed directory before you start WSAS."

Harshit Kapoor said…

I am new to Weblogic.
Could you point me top the specific location where I have to place the the jar files?
Charitha said…
place these jars at \bea\jdk160_05\jre\lib\ext if you are running weblogic with Sun jdk.

Harshit Kapoor said…

I have place these jars in lib/ext of JDK and Jrockit. I have placed them in domain_name/lib also, however it did not work. IE still give me 404 error.
Charitha said…
Could you please post me server log? You must copy file in the extracted WSO2WSAS-3.X directory to wsas-repo\wso2wsas\WEB-INF\classes to get the logs.
Also, make sure to restart the server after copying those 3 jars.

Harshit Kapoor said…
his can lead to a show code vulnerability.>
[2009-12-17 17:45:59,291] INFO - Registry Mode : READ-WRITE
[2009-12-17 17:45:59,291] INFO - Starting WSO2 Carbon...
[2009-12-17 17:45:59,291] INFO - Operating System : Windows XP 5.1, x86
[2009-12-17 17:45:59,291] INFO - Java Home : D:\INSTAL~1\bea\JDK160~1\j
[2009-12-17 17:45:59,291] INFO - Java Version : 1.6.0_05
[2009-12-17 17:45:59,307] INFO - Java VM : Java HotSpot(TM) Client VM
10.0-b19,Sun Microsystems Inc.
[2009-12-17 17:45:59,307] INFO - Carbon Home : D:\installation\wsas\wsas-
[2009-12-17 17:45:59,307] INFO - Java Temp Dir : C:\DOCUME~1\HKAPOO~1.CIB\L
[2009-12-17 17:45:59,307] INFO - User : hkapoor, en-US, Asia/Calcu
[2009-12-17 17:46:00,588] INFO - Starting Carbon initialization...
[2009-12-17 17:46:00,682] INFO - org.wso2.carbon.core.deployment.DeploymentInt
[2009-12-17 17:46:00,682] FATAL - WSO2 Carbon initialization Failed
org.apache.axis2.deployment.DeploymentException: org.wso2.carbon.core.transports
at org.apache.axis2.deployment.util.Utils.loadHandler(
at org.apache.axis2.deployment.AxisConfigBuilder.processPhaseList(AxisCo
at org.apache.axis2.deployment.AxisConfigBuilder.processPhaseOrders(Axis
at org.apache.axis2.deployment.AxisConfigBuilder.populateConfig(AxisConf
at org.wso2.carbon.core.CarbonAxisConfigurator.populateAxisConfiguration
at org.wso2.carbon.core.CarbonAxisConfigurator.getAxisConfiguration(Carb
at org.apache.axis2.context.ConfigurationContextFactory.createConfigurat
at org.wso2.carbon.core.CarbonConfigurationContextFactory.createNewConfi
at org.wso2.carbon.core.init.CarbonServerManager.initializeCarbon(Carbon
at org.wso2.carbon.core.init.CarbonServerManager.removePendingItem(Carbo
at org.wso2.carbon.core.init.OSGiAxis2ServicesListener.bundleChanged(OSG
at org.eclipse.osgi.framework.internal.core.BundleContextImpl.dispatchEv
at org.eclipse.osgi.framework.eventmgr.EventManager.dispatchEvent(EventM
at org.eclipse.osgi.framework.eventmgr.EventManager$
Caused by: java.lang.ClassNotFoundException: org.wso2.carbon.core.transports.smt
at org.eclipse.osgi.internal.loader.BundleLoader.findClassInternal(Bundl
at org.eclipse.osgi.internal.loader.BundleLoader.findClass(BundleLoader.
at org.eclipse.osgi.internal.loader.BundleLoader.findClass(BundleLoader.
at org.eclipse.osgi.internal.baseadaptor.DefaultClassLoader.loadClass(De
at java.lang.ClassLoader.loadClass(
at java.lang.ClassLoader.loadClassInternal(
at java.lang.Class.forName0(Native Method)
at java.lang.Class.forName(
at org.apache.axis2.util.Loader.loadClass(
at org.apache.axis2.util.Loader.loadClass(
at org.apache.axis2.deployment.util.Utils.loadHandler(
... 13 more
Charitha said…
Did you enable SMTP transport (mail transport) in wsas_repo\conf\axis2.xml by any chance?

Harshit Kapoor said…
Thankyou for being vey responsive.

I did not enable SMTP transport in Axis2.xml, by default it is commented out, Axis2.xml also has SMTPFaultHandler configuration. By default this configuration is enabled. Now I have commented it out and I am able to see console.
Thanks again.

I am facing problem with using oracle driver, log say ClassNotFound for OracleDriver. I have placed Classes12.jar in ext, lib of jdk and jrockit. I have placed the same in domain/wsas/lib folder as well. Can you help?
Charitha said…
Hi Harshit,
It is great to know that you were able to make it working. All third party jars such as oracle drivers should be placed at CARBON_HOME/repository/components/lib. Please remove them from lib/ext directories and copy to the above folder and restart.

Roger said…

very could help for setting up the wso2 for wls 10.3. I can log in into the Management Console of ws02 esb. I can add a new user. But when I like to add a new proxy service, I get the following error:

The following error details are available. Please refer logs for more details.
org.apache.axis2.AxisFault: Cannot get all services. Backend service may be unavailable
at org.wso2.carbon.service.mgt.ui.ServiceAdminClient.handleException(
at org.wso2.carbon.service.mgt.ui.ServiceAdminClient.getAllServices(
at org.apache.jsp.service_002dmgt.index_jsp._jspService(
at org.apache.jasper.runtime.HttpJspBase.service(


Caused by: org.apache.axis2.AxisFault: Exception occurred while trying to invoke service method listServiceGroups
at org.apache.axis2.util.Utils.getInboundFaultFromMessageContext(

I also have this message always on WLS console:
[2010-01-28 09:28:57,539] WARN - StartupFinalizerServiceComponent Waiting for required OSGi services:,

Any Idea?

best regards,

Charitha said…
Hi Igor,
This WARN can be ignored, it does not affect functionalities. However. do you always get "AxisFault: Cannot get all services. Backend service may be unavailable" error or does it occur randomly?

pauli said…
Hi Charitha,

I've tried to follow your instructions but I'm seeing a similar error to Harshit. When i navigate to the url:


I see the message 'https://localhost:7002/wso2wsas/carbon'.

I can also see the following error message in the logs:

[2010-02-22 13:30:21,481] ERROR - Database Error - Cannot create JDBC driver of class 'org.h2.Driver' for connect URL 'dbc:h2:C:\wsas\wsas-repo\database\WSO2CARBON_DB;create=true' {org.wso2.carbon.user.core.util.DatabaseUtil}
org.apache.commons.dbcp.SQLNestedException: Cannot create JDBC driver of class 'org.h2.Driver' for connect URL 'dbc:h2:C:\wsas\wsas-repo\database\WSO2CARBON_DB;create=true'
at org.apache.commons.dbcp.BasicDataSource.createDataSource(
at org.apache.commons.dbcp.BasicDataSource.getConnection(
at org.wso2.carbon.user.core.claim.ClaimDAO.getDialectCount(
at org.wso2.carbon.user.core.internal.Activator.exposeDefaultRealmAsService(
at org.wso2.carbon.user.core.internal.Activator.start(
at org.eclipse.osgi.framework.internal.core.BundleContextImpl$
at Method)
at org.eclipse.osgi.framework.internal.core.BundleContextImpl.startActivator(
at org.eclipse.osgi.framework.internal.core.BundleContextImpl.start(
at org.eclipse.osgi.framework.internal.core.BundleHost.startWorker(
at org.eclipse.osgi.framework.internal.core.AbstractBundle.resume(
at org.eclipse.osgi.framework.internal.core.Framework.resumeBundle(
at org.eclipse.osgi.framework.internal.core.StartLevelManager.resumeBundles(
at org.eclipse.osgi.framework.internal.core.StartLevelManager.incFWSL(
at org.eclipse.osgi.framework.internal.core.StartLevelManager.doSetStartLevel(
at org.eclipse.osgi.framework.internal.core.StartLevelManager.dispatchEvent(
at org.eclipse.osgi.framework.eventmgr.EventManager.dispatchEvent(
at org.eclipse.osgi.framework.eventmgr.EventManager$
Caused by: java.sql.SQLException: No suitable driver
at java.sql.DriverManager.getDriver(
at org.apache.commons.dbcp.BasicDataSource.createDataSource(
... 17 more

Can you can help?
Charitha said…
Hi Pauli,
Your jdbc url is wrong. According to the exception, your jdbc url started with "dbc:h2" but it should be "jdbc:h2".
Please correct it and try again.

pauli said…
Doh! Thanks Charitha. That got me further but i'm now seeing this error?

[2010-02-22 16:34:29,872] ERROR - Error rendering tile Error including path '/admin/layout/template.jsp'. javax.xm
l.parsers.FactoryConfigurationError: Provider weblogic.xml.jaxp.RegistryDocument
BuilderFactory not found
at org.apache.tiles.servlet.context.ServletTilesRequestContext.forward(S
at org.apache.tiles.servlet.context.ServletTilesRequestContext.dispatch(
at org.apache.tiles.impl.BasicTilesContainer.render(BasicTilesContainer.
at org.apache.tiles.impl.BasicTilesContainer.render(BasicTilesContainer.
at org.wso2.carbon.ui.action.ActionHelper.render(
at org.wso2.carbon.ui.TilesJspServlet.service(

bty, thank you for the quick response.

Charitha said…
What is the WSO2 WSAS version you are trying to deploy?


Popular posts from this blog

Common mistakes to avoid in WSO2 ESB - 1 - "org.apache.axis2.AxisFault: The system cannot infer the transport information from the URL"

Working with HTTP multipart requests in soapUI

How to configure soapUI to send HTTP chunked encoded requests