FAQs

Buttons are not working (Linux only).

In version 2.28, Gnome has been changed to use client-side windows. This could cause that some GUI widgets (buttons, trees) in Apache Directory Studio won't work as expected. If you encounter any problems set the environment variable GDK_NATIVE_WINDOWS to true before starting Studio:

GDK_NATIVE_WINDOWS=1 ./ApacheDirectoryStudio

More information could be found here

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:

  • The first option is to start Apache Directory Studio with the following command line parameters:

    • On Linux:

      ./ApacheDirectoryStudio -nl en
      
    • On Windows:

      "Apache Directory Studio.exe" -nl en
      
  • The second option is to create a file Apache Directory Studio.ini (for Windows) or ApacheDirectoryStudio.ini (for Mac OS X and Linux) in Studio's installation directory (for Mac OS X the correct location is Apache Directory Studio/Contents/MacOS) with the following content:

    -nl
    en
    

Please notice the line break between -nl and the language.

When creating a new connection I get the part of the wizard which allows me to "You can specify additional connection parameters". Buttons back, next and finish are disabled. Basically now way to add a new connection.

This is an issue of release 1.0.0 and 1.0.1. It will be fixed in the next release 1.1.0. There is a workaround: Uncheck the "Get base DNs from Root DSE" check box, the 'Next' button will be activated.

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. See Connection Properties how to change it.

How to set the Java VM to use?

  • The first option is to start Apache Directory Studio with the following command line parameters:

    • On Linux:

      ./ApacheDirectoryStudio -vm <path to java executable>
      
    • On Windows:

      "Apache Directory Studio.exe" -vm <path to java executable>
      
  • The second option is to create a file Apache Directory Studio.ini (for Windows) or ApacheDirectoryStudio.ini (for Mac OS X and Linux) in Studio's installation directory (for Mac OS X the correct location is Apache Directory Studio/Contents/MacOS) with the following content:

    -vm
    <path to java executable>
    

Please notice the line break between -vm and the path.

How to increase the heap memory?

  • The first option is to start Apache Directory Studio with the following command line parameters:

    • On Linux:

      ./ApacheDirectoryStudio -vmargs -Xms128m -Xmx512m -XX:PermSize=128m
      -XX:MaxPermSize=128m
      
    • On Windows:

      "Apache Directory Studio.exe" -vmargs -Xms128m -Xmx512m -XX:PermSize=128m
      -XX:MaxPermSize=128m
      
  • The second option is to create a file Apache Directory Studio.ini (for Windows) or ApacheDirectoryStudio.ini (for Mac OS X and Linux) in Studio's installation directory (for Mac OS X the correct location is Apache Directory Studio/Contents/MacOS) with the following content:

    -vmargs
    -Xms128m/
    -Xmx512m
    -XX:PermSize=128m
    -XX:MaxPermSize=128m
    

Please notice the line breaks.

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:

~/.ApacheDirectoryStudio/.metadata/.plugins/org.apache.directory.studio.connection.core/connections.xml

The file containing all searches and bookmarks is:

~/.ApacheDirectoryStudio/.metadata/.plugins/org.apache.directory.studio.ldapbrowser.core/browserconnections.xml

The file containing the history of the connection wizard (recently used hosts and bind users) is:

~/.ApacheDirectoryStudio/.metadata/.plugins/org.apache.directory.studio.connection.ui/dialog_settings.xml

The file containing the history of search settings (recently used DNs, filters, returning attributes) is:

~/.ApacheDirectoryStudio/.metadata/.plugins/org.apache.directory.studio.ldapbrowser.common/dialog_settings.xml

There are some more dialog_settings.xml files in the other plugins directories.

Note: the location of the settings directory could be configured by changing the parameter "osgi.instance.area.default" in configuration/config.ini.