Quick Start

Getting Started Fast

First, be sure to log into Windows as Administrator, or a user belonging to the Administrator group with privileges. Next, download both the AE SLAPD and the LDAP Administrator.

The fastest scenario to get up and running is:

1. Install aeSLAPD with the default setup. Don't change anything, not even the default organization entry.

Note: The "Keytest.exe" command (in \Program Files\AEDir) should be executed to verify that the key is valid. Click on it from the Windows File Manager, or execute it from the command prompt. If a permanent key was not given, it will look it up over the Internet to validate.

2. Start the AE Directory Manager (sdmgr.exe)
a) select "Actions" and Run Process->SLAPD
b) select "Actions" and Status->SLAPD to verify that the server is running

3. Install the Softerra LDAP Administrator (ldapadmin.exe) on the local host  or a machine on your network:

a) select "New Profile"
b) call it AESLAPDv4.1
c) set the host to "localhost" or the name/IP of the AE SLAPD host; press "Next"
d) set Credentials for the Principle "cn=Directory Manager, o=ACME"
e) enter the password (default is "secret") and check "Save password"
f) check "Try matching the credentials required for referral rebind"
g) press "Finish" ; it will then show the server and o=ACME as the first node.

4. Add a new organization and/or entries, or if you have existing LDIF files, Import them to aeSLAPD from Softerra by selecting the "File->Import Data" menu option using the credentials for cn=Directory Manager, o=ACME.

That's it!

--

Details on Directory Manager SDMGR.EXE Startup

The Directory Manager (sdmgr.exe) provides a convenient launching mechanism for Windows 95/98 users (where Services aren’t supported) or NT/XP users who do not wish to run the SLAPD server as a service. For the Command menu, select Server Setup. Enter the server configuration entries, as shown below. Note that Manager assumes Common Name object ‘cn’.

The SDMGR.EXE allows you to:

  • configure and reconfigure the server and authentication
  • search, add, modify or delete entries to a running server
  • import and export LDAP Interchange Format (LDIF) database entries
  • start, stop, suspend and resume server execution
  • check status and get statistics for a running server
  • rebuild the database indices
  • validate license key. As shipped, the evaluation key limits the number of connections and search results returned.

Contact APS Engineering Inc. via email support@aeinc.com to inquire about permanent keys.

Starting SLAPD

This section describes about the starting of SLAPD server. Basically the SLAPD can be started and can run in three different modes.

  1. Debug mode – In this mode, the detailed status and diagnostics will be displayed in a separate window. Starting SLAPD in Debug mode is described in ‘Starting the SLAPD Debugger section’.
  2. SLAPD Process – This mode is generally used on Windows  systems. This option will now show the status and diagnostics.
  3. SSL/TLS – This mode runs SLAPD on both the default port 389 and secure port 636. NOTE: you must first have the slapd.conf setup to support privacy files.

Starting the SLAPD Debugger

It is recommended that the SLAPD process first be run in debug mode as a foreground process to demonstrate configuration files the network settings and the database is correct. This is launched from the Directory Manager as depicted below:

The program should pop-up a verbose output of the server loading schemas and port setup. Eventually, it will settle to a listening state, and wait for a remote client connection. If it does not, or goes away quickly, there is a problem with the configuration or the database, which may have to be rebuilt. Reference the Administration Guide or online support for troubleshooting. 

If it finishes with the message "VALID LICENSE ..." and "slapd starting" this means it is running and waiting to accept client requests. DO NOT close the the debug window unless you want to shut down the slapd server. You should leave it running until you are confident in your setup and communication. Then, you can close it and run the regular SLAPD in the background.

Checking Server Status

If the server is listening. You may now check the server status using Directory Manager. Select File menu, status option and then monitor.

You will see the server status on a pop-up window. SLAPD is running!

This confirms the server is running. You may do further tests, or, if in debug mode, you may close the debug window and run SLAPD from the actions menu and repeat the status check to ensure the server is still running. In regular mode, server output is sent to the system Event Log.

Using the LDAP Administrator LDAPADMIN.EXE

The Softerra LDAP Administrator can be used quickly add organization nodes, new entries, or edit entries. It is recommended that it also be used to import LDIF files or export the running database to LDIF for backups. Screenshots of some basic features are given below (click to enlarge):

 

Group MembersEdit EntriesBrowse EntriesRootDSE displayMonitor