Introduction
This chapter will give you all the steps required to building the server and the installation images of ApacheDS. If you only want to install ApacheDS using pre-build installers (which can be downloaded from the mirrors) you may skip this chapter and go on with 1.3. Installing and starting the server.
Needed tools
All directory projects use Maven as the default build tool. We try to remain current with the production version of Maven. To be specific, we use Maven 2.0.4 on JDK 1.5 for building and running the server. Subversion (SVN) is used for version control. There are some Eclipse plugins you can use for managing your svn repositories, we like Subversive most.
Building all projects
To check out the 1.0 maintenance branch of ApacheDS and all co-projects run the following command:
svn co http://svn.apache.org/repos/asf/directory/apacheds/branches/1.0-with-dependencies/ apacheds-10-trunks
Now, change to apacheds-10-trunks:
cd apacheds-10-trunks
Run the following command to build all of the directory projects:
mvn install
After the command ends running successfully you'll have all the directory projects installed in your local Maven repository.
Building the installers
Windows & TortoiseSVN
If you are usually using TortoiseSVN on Windows for managing your source repositories make sure that you have also installed subversion itself and have added the *svn* command to your system path.
Windows & Inno Setup
Make sure that you have installed Inno Setup at C:\Program Files\Inno Setup 5 when building the installers on windows. Inno Setup can be downloaded at: http://www.jrsoftware.org/isinfo.php . Furthermore you need the Inno Setup Preprocessor (ISPP) which can be downloaded as part of the Quick Start package: http://www.jrsoftware.org/isdl.php#qsp .
For getting started with ApacheDS, the most convenient way is to also build standalone installers. To do this run the following commands:
cd apacheds/server-installers mvn install
When this command ends successfully you'll have your platform specific installer under target/images directory.
Eclipse project
You can use maven also for generating the .project and .classpath files for eclipse.
cd apacheds-10-trunks mvn eclipse:eclipse
Afterwards you just have to import the existing project into eclipse. Start Eclipse, go to File -> Import -> General -> Existing Projects into Workspace, choose the directory which contains the code and click on finish.
If you don't have set the M2_REPO variable so far, which tells Eclipse the path to the local maven repository (which contains the libraries for the project), have a look at the Maven Doku.
Integration tests
To run the integration tests just issue the following command at the top level or within a module:
mvn -Dintegration test