Readme added
Project: http://git-wip-us.apache.org/repos/asf/ode/repo Commit: http://git-wip-us.apache.org/repos/asf/ode/commit/60bd6eed Tree: http://git-wip-us.apache.org/repos/asf/ode/tree/60bd6eed Diff: http://git-wip-us.apache.org/repos/asf/ode/diff/60bd6eed Branch: refs/heads/master Commit: 60bd6eed95d0a7af21fc68266cb0f5568996bb4a Parents: 6ad2491 Author: sathwik <[email protected]> Authored: Wed Jun 28 19:23:25 2017 +0530 Committer: sathwik <[email protected]> Committed: Wed Jun 28 19:23:25 2017 +0530 ---------------------------------------------------------------------- tomee-server/src/main/server/README.md | 92 +++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/ode/blob/60bd6eed/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
