Skip to end of metadataGo to start of metadata
Fortunately, the Apache Directory Project has released the Apache Directory Studio (this isn’t new software, I’ve just never written about it) to help deal with LDAP. Go to Apache Directory Studio Install Location/ApacheDirectoryStudio-xxxx-xxx-xxx/features/ directory and copy the org.apache.directory.studio.ldifeditor.feature1.5.0.v20091102 directory (the versions might vary) to /features/ location. Apache uses.htaccess` files in order to allow certain configuration items to be set within a file in a content directory. The disadvantage is that Apache has to re-read these files on every request that involves the directory, which can impact performance. Choose the option that best suits your needs below. Using Apache Directory Studio you can interactively add a user to e.g. A groupOfNames entry by adding a value (Ctrl) to the multivalued attribute member. Studio comes with a DN value editor which allows you to browse the Directory Information Tree for the user to add.
Get and Prepare the Sources
First, check out the active development branch of Apache Directory Studio and all co-projects run the following command:
Now, change to studio:
Run the following command to create eclipse descriptors (.project, .classpath files and .settings folder), and create the 'lib' folder as well as the META-INF/MANIFEST.MF files (needed to launch Apache Directory Studio inside Eclipse):
To make sure MANIFEST.MF files are correctly built the goal install is not optional.
Prepare Eclipse
Declare a classpath variable named M2_REPO, pointing to ~/.m2/repository. You can declare new variables in Eclipse in Window -> Preferences... and selecting Java -> Build Path -> Classpath Variables.
Install SWTBot from the SWTBot update site http://download.eclipse.org/technology/swtbot/galileo/dev-build/update-site. Select both, SWTBot SWT Feature and SWTBot Eclipse Feature.
To fulfill the coding standards it is recommended to import formatting profiles and code templates as described here: http://cwiki.apache.org/DIRxDEV/coding-standards.html
Import Projects into Eclipse
Open the Import Wizard, select General -> Existing Projects into Workspace, on the next wizard page choos Select root directory and browse for the checked-out studio folder, select all projects and press Finish.
Note that all the feature projects have errors because the feature.xml files contain maven variables that are replaced by the release build. So either ignore the errors in Eclipse or close the feature projects or don't import them.
Start Studio Plugins in a Runtime Environment
To start the studio plugins in a runtime environment select Run -> Open Run Dialog..., select Studio Runtime and press the Run button.
To start the core integration tests select Run -> Open Run Dialog..., select Studio-Integration-Test-Core and press the Run button.
To start the UI integration tests select Run -> Open Run Dialog..., select Studio-Integration-Test-UI and press the Run button. Please make sure to use English locale for UI integration tests. Select Window -> Preferences -> Plug-in Development -> Target Platform -> Tab Environment and set Locale to en.
Apache Directory Studio
Downloads
Documentation
Resources
Support
Community
About Apache
How to set the language of Studio?
Studio currentlly is translated in three languages: English (en), French (fr) and German (de). When starting Studio, the language setting of your operation system is used to determine the language of Studio (On linux, the LC_CTYPE environment variable is used to determinate the default language).
However it is possible to force another language. Add the following content to the ApacheDirectoryStudio.ini file (before the “-vmargs” line):
Please notice the line break between -nl and the language.
When browsing and expanding an entry, Studio only shows 1000 child entries.
Studio uses a client-side count limit when browsing the DIT. This limit is defined in the connection properties. SeeConnection Properties how to change it.
How to set the Java VM to use?
Add the following content to ApacheDirectoryStudio.ini file (before the “-vmargs” line):
Please notice the line break between -vm and the path.
Studio requires Java 11 or newer.
MacOS note: You can find out the Java home directories with /usr/libexec/java_home -V, append /bin/java to the path
How to increase the heap memory?
Add the following content to ApacheDirectoryStudio.ini file:
Please notice the line breaks.
Location of ApacheDirectoryStudio.ini file
Apache Directory Studio Ubuntu
- On Linux: in the installation folder
- On macOS:
/Applications/ApacheDirectoryStudio.app/Contents/Eclipse/ApacheDirectoryStudio.ini - On Windows: in the installation folder
Location of Apache Directory Studio settings
The settings are located per default in your home directory under the directory .ApacheDirectoryStudio.
The file containing all connections is:
The file containing all searches and bookmarks is:
The file containing the history of the connection wizard (recently used hosts and bind users) is:
The file containing the history of search settings (recently used DNs, filters, returning attributes) is:
There are some more dialog_settings.xml files in the other plugins directories.
Apache Directory Studio Search Filter Example
Note: the location of the settings directory could be configured by changing the parameter “osgi.instance.area.default” in configuration/config.ini.