Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Introduction

This chapter will give you all the steps required to have an installation image building the server and the installation images of ApacheDS. If you only want to install ApacheDS by using pre-build installers (which can be downloaded from the mirrors) you may skip this chapter and go on with Installation 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.4.2+ 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:

No Format
svn co httpshttp://svn.apache.org/repos/asf/directory/trunks/apacheds/branches/1.0-with-dependencies/ apacheds-10-trunks

Now, change to apacheds-10-trunks:

...

After the command ends running successfully you'll have all the directory project projects installed in your local Maven repository.

Building the installers

Note
titleWindows & 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.

Note
titleWindows & 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:

No Format

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.

No Format

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:

No Format

mvn -Dintegration test