svn commit: r1420130 [2/2] - in /ode/site/trunk/content: ./ developerguide/ userguide/

[va...@apache.org]

Added: ode/site/trunk/content/userguide/war-deployment.mdtext
URL: http://svn.apache.org/viewvc/ode/site/trunk/content/userguide/war-deployment.mdtext?rev=1420130&view=auto
==============================================================================
--- ode/site/trunk/content/userguide/war-deployment.mdtext (added)
+++ ode/site/trunk/content/userguide/war-deployment.mdtext Tue Dec 11 12:47:58 2012
@@ -0,0 +1,65 @@
+Title: WAR Deployment
+<a name="WARDeployment-DeployingtheWAR"></a>
+## Deploying the WAR
+
+Unzip the [distribution](getting-ode.html) somewhere on your disk, everything needed is inside.
+
+Get the WAR file in the distribution root directory, rename it to *ode.war* and copy this file to [Tomcat](http://tomcat.apache.org)'s webapp directory. Start Tomcat and ODE should be up and running. You should get the [Axis2](http://ws.apache.org/axis2) welcome page under [http://localhost:8080/ode](http://localhost:8080/ode). The ODE WAR includes its own embedded database ([Derby](http://db.apache.org/derby)) so you don't have to worry about configuring any external database for now.
+
+<a name="WARDeployment-Examples"></a>
+### Examples
+
+Copy the content of the _examples_ directory in the distribution (the 3 sub-directories) to _tomcat/webapps/ode/WEB-INF/processes_, this will automatically deploy the 3 example processes. Use the sendsoap command located in the distribution _bin_ directory to send test messages. The messages to run each of the 3 examples are provided in their respective directory (testRequest.soap). For each example type something like:
+
+    :::text
+    bin/sendsoap http://localhost:8080/ode/processes/helloWorld examples/HelloWorld2/testRequest.soap
+
+
+The *sendsoap* executable can be found in the distribution _bin_ directory. The urls should be updated according to the address defined in the WSDL file for the process service.
+
+<a name="WARDeployment-ConfiguringODEinTomcatwithaMySQLdatabase"></a>
+### Configuring ODE in Tomcat with a MySQL database
+
+The ODE war should have been copied to the _webapps_ directory of Tomcat and the server should have been started at least once before following these instructions. This ensures that the webapp is properly exploded.
+
+1. Drop the MySQL JDBC driver ([MySQL Connector/J](http://dev.mysql.com/downloads/#connector-j)) in the _common/lib_ directory of Tomcat.
+1. Add the following stanza to _conf/server.xml_ inside the <Host> element:
+
+        :::xml
+        <Context path="/ode" docBase="ode" debug="5" reloadable="true" crossContext="true">
+            <Resource name="jdbc/ODEDB" auth="Container" type="javax.sql.DataSource"
+                maxActive="100" maxIdle="30" maxWait="10000"
+                username="root" password="" driverClassName="com.mysql.jdbc.Driver"
+                url="jdbc:mysql://localhost:3306/ode?autoReconnect=true"/>
+        </Context>
+
+1. Make sure that MySQL is started and the [ODE schema](^ode_openjpa_mysql-1.3.2.sql.html) has been loaded in a _ode_ database.
+
+        :::text
+        $ mysql -u root
+        mysql> create database ode;
+        mysql> exit
+        $ mysql -u root ode < ode_openjpa_mysql-1.3.2.sql
+
+2. Add a file named _ode-axis2.properties_ under _webapps/ode/WEB-INF/conf_ with the following content:
+
+        :::text
+        ode-axis2.db.mode=EXTERNAL
+        ode-axis2.db.ext.dataSource=java:comp/env/jdbc/ODEDB
+
+
+You're done!
+
+<a name="WARDeployment-ConfiguringODEinJBosswithJNDIEXTERNALdatasource"></a>
+## Configuring ODE in JBoss with JNDI EXTERNAL datasource
+
+Create ode/WEB-INF/conf/ode-axis2.properties with following content:
+
+    :::text
+    #Uncomment for using dao hibernate
+    #ode-axis2.dao.factory=org.apache.ode.daohib.bpel.BpelDAOConnectionFactoryImpl
+    ode-axis2.db.mode=EXTERNAL
+    ode-axis2.db.ext.dataSource=java:comp/env/jdbc/ode
+    ode-axis2.event.listeners=org.apache.ode.bpel.common.evt.DebugBpelEventListener
+    ode-axis2.tx.factory.class=org.apache.ode.axis2.util.JBossFactory
+