Due to time constraints, we did not update the install process for WSO2
Web Services Application Server 2.0 (WSAS) to include support for Geronimo
2.0.1. In this article, we will show you how to get the two working
together.
|
Date: Thu, 30th Aug, 2007
Level:
Reads: 3319 Comments: 0 |
Login or register to post comments |
|
|
|
Davanum Srinivas
WSO2 Inc. |
| |
|
Introduction
WSO2 Web Services Application Server 2.0 (WSAS)'s Servlet Edition supports
many of the well known Application servers like IBM Websphere, BEA Weblogic
and Redhat's JBoss. The install process does support the older Apache
Geronimo 1.1.1 version. This article is an effort to enumerate the steps
required to install WSAS 2.0 on the latest Geronimo 2.0.1
Background
Please download the following zip's from the Apache web site and unzip
them:
Create a WSO2WSAS war for use with Geronimo
Run the install.bat file in wso2wsas directory and select the
Generic Server option, also specify a temporary directory in
which the installer can create the war. Here's a transcript (includes prompts
and responses). Please note that WSAS needs a directory to work off of (for
configuration, database etc) and we chose C:\GERONIMO-WSAS. We also choose
C:\GERONIMO-WSAS\TEMP as the directory to place the generated war
Depending on the operating system you are using, you should see a screen
similar to this:
Replace hibernate jar in wso2wsas.war
The version of hibernate in WSAS is not usable under Geronimo, So let's
upgrade to the newer one. Here's a few command snippets:
Edit the WSAS Configuration to set the HTTP and HTTPS ports for
Geronimo
Please edit C:\GERONIMO-WSAS\conf\server.xml and replace the following
snippet
<!--
Uncomment this section and provide the correct HTTP port
in the case of a generic server installation
-->
<!--
<Ports>
<HTTP>9762</HTTP>
<HTTPS>9443</HTTPS>
</Ports>
-->
with this one
<Ports>
<HTTP>8080</HTTP>
<HTTPS>8443</HTTPS>
</Ports>
That's it folks! You can then point your browser to http://localhost:8080/axis2/ to
verify if all's well.
Start the Geronimo Server
Here's how we start the geronimo server with a simple run command:
Create the Data Sources Needed by WSAS
Creating data sources involves deploying a plan in Geronimo parlance.
Here's the plan XML that needs to be deployed. Please make sure you set the
directory path correctly in the ConnectionURL parameter.
<?xml version="1.0" encoding="UTF-8"?>
<connector xmlns="http://geronimo.apache.org/xml/ns/j2ee/connector-1.2">
<dep:environment xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.2">
<dep:moduleId>
<dep:groupId>org.wso2.wsas</dep:groupId>
<dep:artifactId>wso2wsas_db</dep:artifactId>
<dep:version>1.0</dep:version>
<dep:type>rar</dep:type>
</dep:moduleId>
<dep:dependencies>
<dep:dependency>
<dep:groupId>org.apache.derby</dep:groupId>
<dep:artifactId>derby</dep:artifactId>
<dep:version>10.2.2.0</dep:version>
<dep:type>jar</dep:type>
</dep:dependency>
</dep:dependencies>
</dep:environment>
<resourceadapter>
<outbound-resourceadapter>
<connection-definition>
<connectionfactory-interface>javax.sql.DataSource</connectionfactory-interface>
<connectiondefinition-instance>
<name>wso2wsas_db</name>
<config-property-setting name="Password">wso2wsas</config-property-setting>
<config-property-setting name="Driver">org.apache.derby.jdbc.EmbeddedDriver</config-property-setting>
<config-property-setting name="UserName">wso2wsas</config-property-setting>
<config-property-setting name="ConnectionURL">jdbc:derby:C:/GERONIMO-WSAS/database/WSO2WSAS_DB</config-property-setting>
<connectionmanager>
<local-transaction/>
<single-pool>
<max-size>10</max-size>
<min-size>0</min-size>
<match-one/>
</single-pool>
</connectionmanager>
</connectiondefinition-instance>
</connection-definition>
</outbound-resourceadapter>
</resourceadapter>
</connector>
Once you have edited the plan, save it as
C:\GERONIMO-WSAS\wso2wsas-db-plan.xml and run the following command (The
Deployed line is the output from Geronimo):
Deploy the wso2wsas war
Now we are ready to deploy the WSO2WSAS war as shown below:
That's it!
Please point your browser to https://localhost:8443/wso2wsas/ and login as
admin/admin
Summary
The Apache Axis2 war distribution and Geronimo's stripped down little-G
distribution is a very handy combination for deploying Axis2 based Web
services.
Applies To
1. Axis2 1.3 / Geronimo 2.0.1
More Information
Slightly
old version of the little-G documentation
Post to twitter