JOnAS Server

JOnAS Tutorial
<<< Previous	Getting and Installing The Software	Next >>>

Both sites the binary version and sources are available. You can get the current (or previous) version of JOnAS sources directly from the CVS repository.

Getting and Installing the Binary Distribution

The binary distribution is probably the distribution most users need. If you just want to develop EJB enabled applications with JOnAS, the only thing you need is the binary version. It comes with pre-compiled Java classes and is ready to run on Unix, Linux and Windows platforms. The distribution also includes the full documentation and examples used in this tutorial. You should download the combined JOnAS and Tomcat package.

Note that if you have already installed a previous version of JOnAS in this location the new installation will replace the previous files and you may lose configuration files that you may have customized. It is therefore prudent to save these files before starting the installation process.

The installation process simply consists in unzipping the downloaded files into a directory. The default location is under /usr/local/jonas[version], but you may choose any directory you wish.

Windows platform users must use a utility such as WinZip to extract the files from the archive.

Now, you have to set up your environment variables to be ready to run your first example with JOnAS. Environment setup is detailed in the section Configuring JOnAS.

Getting the Source Distribution

For those who want to have a look into the JOnAS internals, the source distribution is what you need. You will get the complete source code of the JOnAS server. We explain how to compile the JOnAS source distribution in the section Compiling the Source Distribution with Ant.

You first have to extract the source code for the archive in some directory of your choice.

Now, you have to set up your environment variables and compile the source code in order to run your first example with JOnAS. Environment setup and source code compilation are detailed in the section Configuring JOnAS.

Using the CVS Repository

You can also get the latest source distribution of JOnAS from ObjectWeb CVS (Concurrent Version System) repository.

A specific anonymous account gives you read-only access to the repository. It allows you to checkout any version of JOnAS or diff your version against the one in the repository.

If you don't want to use the -d option, you can set your CVSROOT environment variable to :pserver:anonymous@cvs.objectweb.org:/JOnAS.

Windows users can use a tool like WinCVS that provides a graphic interface to CVS.

The cvs checkout process will create an objectweb directory in the directory where the command was launched. This directory has the same contents as the source distribution and should contain JOnAS sources in the jonas subdirectory.

Now, you have to set up your environment variables and compile the source code as described in the section Configuring JOnAS. Then, you can run your first application with JOnAS !