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:

• MacOS (jar)
• Solaris SPARC (jar)
• Solaris i386 (jar)
• Windows (exe)
• Debian package
• RPM package
• Linux (jar)

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

If you want to install ApacheDS as daemon in /etc/init.d, you need root privileges.
There are two posibilities installing ApacheDS on Linux:

• using the Debian package
• using the RPM package
• using the jar file

Using the jar file

// Get the apacheds Linux jar, and copy it where you want the server be installed.
java -jar apacheds-1.0.0-linux-i386-setup.jar

Now, you'll see a graphical installer displayed. Interface and functionality of this installer is similar to other wizard based installers. First, you get some information how to run the server as daemon, tools included in ApacheDS and so on. Next you can Select a directory where the server will be installed. As you are user *root*, you will be able to install the server almost anywhere. One solution could be to install it in your home directory, if you want to test the server. Another solution could be to install the server in /opt or in /usr/local if you are using Ubuntu or Debian. It's up to you. Be aware that the database backend will also reside within the same directory, so make sure you will have enough place. On the next screen you can choose the packages to install. The init script can only be installed if you are root. The Documentation packages also contains the whole Java API for Apache DS. Last you can add some shortcuts in your environment.

Starting and stopping the server

After installing the application there is one step left to start the server:

[root]# /etc/init.d/apacheds start

or

[user]# /usr/local/apacheds-1.0.0/bin/server.init  start

Stopping the server works equivalent

[root]# /etc/init.d/apacheds stop

or

[user]# /usr/local/apacheds-1.0.0/bin/server.init  stop