You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ode.apache.org by sa...@apache.org on 2016/11/03 07:42:11 UTC

[2/3] ode git commit: Readme added

Readme added


Project: http://git-wip-us.apache.org/repos/asf/ode/repo
Commit: http://git-wip-us.apache.org/repos/asf/ode/commit/eedb5689
Tree: http://git-wip-us.apache.org/repos/asf/ode/tree/eedb5689
Diff: http://git-wip-us.apache.org/repos/asf/ode/diff/eedb5689

Branch: refs/heads/ode-1.3.x
Commit: eedb56893cb7fb3efbff957d63893f3882f63c0a
Parents: 5a91d26
Author: sathwik <sa...@apache.org>
Authored: Thu Nov 3 13:10:35 2016 +0530
Committer: sathwik <sa...@apache.org>
Committed: Thu Nov 3 13:10:35 2016 +0530

----------------------------------------------------------------------
 tomee-server/src/main/server/README.md | 92 +++++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/ode/blob/eedb5689/tomee-server/src/main/server/README.md
----------------------------------------------------------------------
diff --git a/tomee-server/src/main/server/README.md b/tomee-server/src/main/server/README.md
new file mode 100644
index 0000000..03081b6
--- /dev/null
+++ b/tomee-server/src/main/server/README.md
@@ -0,0 +1,92 @@
+ODE Server based on Apache TOMEE
+--------------------------------
+
+NOTE: This server is not yet production ready. Use for demo purposes only.
+
+
+Folder structure
+----------------
+ - bin (contains startup scripts)
+ - lib (contains tomee libraries, thirdparty licenses and ode startup jar to startup tomee in embedded mode)
+ - conf (tomee configuration files)
+ - database (derby database for OpenJPA and Hibernate used by ODE)
+ - logs
+ - webapps (ODE web application)
+
+
+Server Startup
+--------------
+
+Linux: bin/start.sh
+
+Windows: bin/start.bat
+
+
+Server Shutdown
+---------------
+CTRL + C
+
+
+Datasource Configuration
+------------------------
+Embedded Derby database and OpenJPA persistence.
+```xml
+<Resource id="jdbc/ode" type="DataSource">
+    jdbcDriver=org.apache.derby.jdbc.EmbeddedDriver
+    jdbcUrl=jdbc:derby:database/derby-jpadb
+    userName=sa
+    password=
+    defaultAutoCommit=false
+    jtaManaged=true
+    initialSize=5
+    maxActive=20
+    defaultTransactionIsolation=2
+</Resource>
+```
+
+Embedded Derby database and Hibernate persistence.
+```xml
+<Resource id="jdbc/ode" type="DataSource">
+    jdbcDriver=org.apache.derby.jdbc.EmbeddedDriver
+    jdbcUrl=jdbc:derby:database/derby-hibdb
+    userName=sa
+    password=
+    defaultAutoCommit=false
+    jtaManaged=true
+    initialSize=5
+    maxActive=20
+    defaultTransactionIsolation=2
+</Resource>
+```
+Change the relevant section of the Resource element under conf/tomee.xml for different database and download and store the driver jar file under lib/ directory.
+
+
+OPENJPA Persistence
+-------------------
+By default server comes packaged with OpenJPA and Embedded Derby database. If a different database is needed then change the relevant section under conf/tomee.xml
+
+
+Hibernate Persistence
+---------------------
+Download these Hibernate dependencies and put them under lib/ of the server
+
+* antlr-2.7.6.jar
+* asm-3.3.1.jar
+* cglib-2.2.jar
+* dom4j-1.6.1.jar
+* ehcache-1.2.3.jar
+* hibernate-core-3.3.2.GA.jar
+* javassist-3.9.0.GA.jar
+
+Edit file ode-axis2.properties under webapps/ode/WEB-INF/conf/
+
+Replace this line
+
+ode-axis2.dao.factory=org.apache.ode.dao.jpa.BPELDAOConnectionFactoryImpl
+
+With
+
+ode-axis2.dao.factory=org.apache.ode.daohib.bpel.BpelDAOConnectionFactoryImpl
+
+By default server comes packaged with Embedded Derby database. If a different database is needed then change the relevant section under conf/tomee.xml
+and store the driver jar file under lib/ directory of the server.
\ No newline at end of file