Getting the Source

Getting involved in any Open Source project requires the source. The standard tool for managing source code in open source projects is CVS. If you are not familiar with CVS, take a moment to read our CVS FAQ.

If you have cvs already installed and are ready to go, the following two commands are all you need to get the source. The first command logs you into the system, when it prompts you for the CVS password, simply hit the Enter key.

cvs -d:pserver:anon@cvs.openejb.codehaus.org:/scm/openejb login

cvs -d:pserver:anon@cvs.openejb.codehaus.org:/scm/openejb co MODULE

where MODULE may become:

• openejb - OpenEJB 2.0 (Apache Geronimo-oriented version with EJB 2.x support)

• openejb1 - OpenEJB 1.0 (EJB 1.x support)

• website - OpenEJB web site

NOTE: The 'cvs ....' commands above should be on one line and executed as one command.

If you are a new user to cvs, the above steps may seem overly simplistic to you. For a more detailed explanation of the login/checkout process, click here.

Building the Source

Building OpenEJB from the sources requires Apache Maven to be installed. Download, install and run it to see if it works well. See Apache Maven web site for information on how to do it.

Do it to see if Maven is installed correctly

$ maven --version
 __  __
|  \/  |__ _Apache__ ___
| |\/| / _` \ V / -_) ' \  ~ intelligent projects ~
|_|  |_\__,_|\_/\___|_||_|  v. 1.0

Once you've got Maven working, change the current working directory to the one where OpenEJB sources have been downloaded to. Run maven command at the command line prompt.

OpenEJB 1.0 build process (openejb1 module)

$ maven
 __  __
|  \/  |__ _Apache__ ___
| |\/| / _` \ V / -_) ' \  ~ intelligent projects ~
|_|  |_\__,_|\_/\___|_||_|  v. 1.0

Starting the reactor...
Our processing order:
OpenEJB :: Core
OpenEJB :: Integration Tests
OpenEJB :: WebAdmin
...
BUILD SUCCESSFUL
Total time: 3 minutes 31 seconds
Finished at: Tue Aug 10 14:36:26 CEST 2004

Once the maven command finishes OpenEJB binaries are found in the target/openejb-1.0-SNAPSHOT/ directory. From now on, the directory is refered to as OpenEJB home directory (similarly to the directory where the binaries are when OpenEJB is downloaded from the web site).