Work in progress

This site is in the process of being reviewed and updated.

1.2. Some Background. Directories, directory services and LDAP 1. How to begin 1.4. Basic configuration tasks

Installing and starting the server

This section describes how ApacheDS can be installed and started at different platforms.

Prerequisites

  • Java 5.0. We recommend using Sun's JDK , but the server has also been successfully tested with JRockit 5.0 and with IBM Java 5.0.
    You can check your java installation with: 
    java -version

    this should response something like:

    java version "1.5.0_06"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_06-b05)
Java HotSpot(TM) Client VM (build 1.5.0_06-b05, mixed mode)
  • using Linux: you must have a X11 graphical interface
  • 384 MB RAM for the JVM. That's the default setting, how to change that is described here

Downloading the server

We provide native installers for several platforms:

  • Mac OS X (dmg)
  • Solaris SPARC (pkg)
  • Solaris x86 (pkg)
  • Windows (exe)
  • Debian package (deb)
  • RPM package (rpm)
  • Linux (bin)

Additional we provide an zip or tar.gz archive.

You can download them from here.

An option for people familiar with tools like Subversion and Maven is to built the server from the sources on their own. This is described here.

Installing as Windows service

Installing can be easily done using the Windows installer. Its interface and functionality is similar to other wizard based installers.

To install the ApacheDS as Windows service you need Administrator privileges.

Starting and Stopping the server

The server can be started and stopped with the Service Configuration Manager (Programs -> apacheds -> Service Settings). You must be admin to do this.

The Service Configuration Manager also allows the configuration of several windows service settings such as:

  • Changing the display name & description of the service
  • Configuring the service startup type of Manual, Automatic, or Disabled
  • Changing the user the service runs as
  • Changing logging settings for the service
  • Changing the version of the Java Runtime used by the service
  • Changing the properties for the JVM

For details look at the next page 1.4. Basic configuration tasks

Installing on Linux, Max OS X and Solaris

The installation for different installers is described on the Apache Directory Server 1.5 Downloads page.