# How to compile JOnAS

1. Target Audience and Rationale
2. Getting the JOnAS Source
3. Recompiling JOnAS from the Sources

## Target Audience and Rationale

This chapter is dedicated to JOnAS users that want to built a JOnAS version from the source code get from CVS

## Getting the JOnAS Source

CVS (Concurrent Version System) provides network-transparent source control for groups of developers. It runs on most UNIX systems and Windows NT. You can get more information on http://www.cyclic.com.

Working with CVS allows you to do things like `cvs status` or `cvs diff` and any other read-only cvs commands. However, you will not be allowed to commit changes yourself because it's read only. To start working with CVS on JOnAS, you must make a `checkout` of the `jonas` module with a command like this:

        cvs -d :pserver:anonymous@cvs.objectweb.org:/JOnAS login
        (hit enter key when prompted for password)
        cvs -d :pserver:anonymous@cvs.objectweb.org:/JOnAS co jonas

You can also set your `CVSROOT` variable instead of using the -d option.

## Recompiling JOnAS from the Sources

1. Download Ant from the Jakarta project site.

   You will find the `build.xml` file used for building JOnAS in `objectweb/jonas` directory.

2. Set the following environment variables with the correct value:
   - JONAS_ROOT : mandatory
3. All you have to do is:

   `cd $OBJECTWEB_HOME/jonas`
   `ant install`

The result of the build will be equivalent to a binary distribution and will be installed under `JONAS_ROOT`.