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 +
