Getting Ode has been edited by Maciej Szefler (Jan 26, 2007).

(View changes)

Content:

Ode is still under incubation and doesn't have any official release yet. So you will have to build from the source code but thanks to Maven2, this is fairly easy.

Getting the source code

First you will have to make sure that you have Subversion. If you don't know what Subversion is or don't have it installed, check here. Once installed run:

$> svn checkout http://svn.apache.org/repos/asf/incubator/ode/trunk ode

For more information or if you have any problem with Subversion (like being behind a proxy or a firewall) check the Source Code section.

Building

You'll need to install Maven2 to build Ode. Just follow the installation instructions. Then open a command in the source root (usually in ode/trunk) and type:

mvn install

This will compile and install all necessary artifacts in your local repository.

Isn't it pretty to think so?
You may find that the optimistic claim made above is---well, let's just say, not reflected by reality. In fact you are likely to experience the following problems:
  • Maven cannot find a required plugin: make sure you have HTTP access to http://pxe.intalio.org, if you are behind a proxy, you'll need to configure Maven to use it (see the Maven website for details)
  • tools.jar library cannot be found: make sure JAVA_HOME points to a Java JDK, /not/ a JRE.
  • OpenJPA enhancer cannot find necessary libraries: re-run the mvn install and all should be well.

Running in Tomcat

After everything has been compiled, you should find a full distribution in the distro-axis/target directory. Unzip it 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's webapp directory. Start Tomcat and Ode should be up and running. You should get the Axis2 welcome page under http://localhost:8080/ode.

The Ode WAR includes its own embedded database (Derby) so you don't have to worry about configuring any external database for now.

Testing

Copy the content of 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 (provided in an archive attached to this page until we produce a clean package for it) 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:

sendsoap http://localhost:8080/ode/processes/helloWorld axis2-examples/src/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.

If you want to use an IDE to explore the PXE sources or debug PXE executables, Eclipse .project and .classpath files are present in all the modules; simply choose File|Import from the Eclipse menu, and select the root pxe directory. You may also use Maven to generate project files for other IDEs. See the Maven documentation for details.

Reply via email to