directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r836762 - in /websites/staging/directory/trunk/content: ./ studio/faqs.html
Date Wed, 31 Oct 2012 17:50:45 GMT
Author: buildbot
Date: Wed Oct 31 17:50:45 2012
New Revision: 836762

Log:
Staging update by buildbot for directory

Modified:
    websites/staging/directory/trunk/content/   (props changed)
    websites/staging/directory/trunk/content/studio/faqs.html

Propchange: websites/staging/directory/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Oct 31 17:50:45 2012
@@ -1 +1 @@
-1404263
+1404272

Modified: websites/staging/directory/trunk/content/studio/faqs.html
==============================================================================
--- websites/staging/directory/trunk/content/studio/faqs.html (original)
+++ websites/staging/directory/trunk/content/studio/faqs.html Wed Oct 31 17:50:45 2012
@@ -116,8 +116,155 @@
 
 
 
+<p><h1>FAQs</h1></p>
+<div class="toc">
+<ul>
+<li><a href="#buttons-are-not-working-linux-only">Buttons are not working (Linux
only).</a></li>
+<li><a href="#how-to-set-the-language-of-studio">How to set the language of Studio?</a></li>
+<li><a href="#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">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.</a></li>
+<li><a href="#when-browsing-and-expanding-an-entry-studio-only-shows-1000-child-entries">When
browsing and expanding an entry, Studio only shows 1000 child entries.</a></li>
+<li><a href="#how-to-set-the-java-vm-to-use">How to set the Java VM to use?</a></li>
+<li><a href="#how-to-increase-the-heap-memory">How to increase the heap memory?</a></li>
+<li><a href="#location-of-apache-directory-studio-settings">Location of Apache
Directory Studio settings</a></li>
+</ul>
+</div>
+<h3 id="buttons-are-not-working-linux-only">Buttons are not working (Linux only).</h3>
+<p>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:</p>
+<div class="codehilite"><pre><span class="n">GDK_NATIVE_WINDOWS</span><span
class="o">=</span><span class="mi">1</span> <span class="o">./</span><span
class="n">ApacheDirectoryStudio</span>
+</pre></div>
+
+
+<p>More information could be found <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=291257">here</a></p>
+<h3 id="how-to-set-the-language-of-studio">How to set the language of Studio?</h3>
+<p>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). </p>
+<p>However it is possible to force another language:</p>
+<ul>
+<li>
+<p>The first option is to start Apache Directory Studio with the following command
line parameters:</p>
+<ul>
+<li>
+<p>On Linux:</p>
+<div class="codehilite"><pre><span class="o">./</span><span class="n">ApacheDirectoryStudio</span>
<span class="o">-</span><span class="n">nl</span> <span class="n">en</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>On Windows:</p>
+<div class="codehilite"><pre><span class="s">&quot;Apache Directory
Studio.exe&quot;</span> <span class="o">-</span><span class="n">nl</span>
<span class="n">en</span>
+</pre></div>
+
+
+</li>
+</ul>
+</li>
+<li>
+<p>The second option is to create a file <em>Apache Directory Studio.ini</em>
(for Windows) or <em>ApacheDirectoryStudio.ini</em> (for Mac OS X and Linux) in
Studio's installation directory (for Mac OS X the correct location is <em>Apache Directory
Studio/Contents/MacOS</em>) with the following content:</p>
+<div class="codehilite"><pre><span class="o">-</span><span class="n">nl</span>
+<span class="n">en</span>
+</pre></div>
+
+
+</li>
+</ul>
+<p>Please notice the line break between -nl and the language.</p>
+<h3 id="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">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.</h3>
+<p>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.</p>
+<h3 id="when-browsing-and-expanding-an-entry-studio-only-shows-1000-child-entries">When
browsing and expanding an entry, Studio only shows 1000 child entries.</h3>
+<p>Studio uses a client-side count limit when browsing the DIT. This limit is defined
in the connection properties. See
+<a href="http://directory.apache.org/studio/static/users_guide/ldap_browser/tools_connection_properties.html#tools_connection_properties_options">Connection
Properties</a> how to change it. </p>
+<h3 id="how-to-set-the-java-vm-to-use">How to set the Java VM to use?</h3>
+<ul>
+<li>
+<p>The first option is to start Apache Directory Studio with the following command
line parameters:</p>
+<ul>
+<li>
+<p>On Linux:</p>
+<div class="codehilite"><pre><span class="o">./</span><span class="n">ApacheDirectoryStudio</span>
<span class="o">-</span><span class="n">vm</span> <span class="o">&lt;</span><span
class="n">path</span> <span class="n">to</span> <span class="n">java</span>
<span class="n">executable</span><span class="o">&gt;</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>On Windows:</p>
+<div class="codehilite"><pre><span class="s">&quot;Apache Directory
Studio.exe&quot;</span> <span class="o">-</span><span class="n">vm</span>
<span class="o">&lt;</span><span class="n">path</span> <span
class="n">to</span> <span class="n">java</span> <span class="n">executable</span><span
class="o">&gt;</span>
+</pre></div>
+
+
+</li>
+</ul>
+</li>
+<li>
+<p>The second option is to create a file <em>Apache Directory Studio.ini</em>
(for Windows) or <em>ApacheDirectoryStudio.ini</em> (for Mac OS X and Linux) in
Studio's installation directory (for Mac OS X the correct location is <em>Apache Directory
Studio/Contents/MacOS</em>) with the following content:</p>
+<div class="codehilite"><pre><span class="o">-</span><span class="n">vm</span>
+<span class="o">&lt;</span><span class="n">path</span> <span
class="n">to</span> <span class="n">java</span> <span class="n">executable</span><span
class="o">&gt;</span>
+</pre></div>
+
+
+</li>
+</ul>
+<p>Please notice the line break between -vm and the path.</p>
+<h3 id="how-to-increase-the-heap-memory">How to increase the heap memory?</h3>
+<ul>
+<li>
+<p>The first option is to start Apache Directory Studio with the following command
line parameters:</p>
+<ul>
+<li>
+<p>On Linux:</p>
+<div class="codehilite"><pre><span class="o">./</span><span class="n">ApacheDirectoryStudio</span>
<span class="o">-</span><span class="n">vmargs</span> <span class="o">-</span><span
class="n">Xms128m</span> <span class="o">-</span><span class="n">Xmx512m</span>
<span class="o">-</span><span class="n">XX:PermSize</span><span
class="o">=</span><span class="mi">128</span><span class="n">m</span>
+<span class="o">-</span><span class="n">XX:MaxPermSize</span><span
class="o">=</span><span class="mi">128</span><span class="n">m</span>
+</pre></div>
+
+
+</li>
+<li>
+<p>On Windows:</p>
+<div class="codehilite"><pre><span class="s">&quot;Apache Directory
Studio.exe&quot;</span> <span class="o">-</span><span class="n">vmargs</span>
<span class="o">-</span><span class="n">Xms128m</span> <span class="o">-</span><span
class="n">Xmx512m</span> <span class="o">-</span><span class="n">XX:PermSize</span><span
class="o">=</span><span class="mi">128</span><span class="n">m</span>
+<span class="o">-</span><span class="n">XX:MaxPermSize</span><span
class="o">=</span><span class="mi">128</span><span class="n">m</span>
+</pre></div>
+
+
+</li>
+</ul>
+</li>
+<li>
+<p>The second option is to create a file <em>Apache Directory Studio.ini</em>
(for Windows) or <em>ApacheDirectoryStudio.ini</em> (for Mac OS X and Linux) in
Studio's installation directory (for Mac OS X the correct location is <em>Apache Directory
Studio/Contents/MacOS</em>) with the following content:</p>
+<div class="codehilite"><pre><span class="o">-</span><span class="n">vmargs</span>
+<span class="o">-</span><span class="n">Xms128m</span><span class="o">/</span>
+<span class="o">-</span><span class="n">Xmx512m</span>
+<span class="o">-</span><span class="n">XX:PermSize</span><span
class="o">=</span><span class="mi">128</span><span class="n">m</span>
+<span class="o">-</span><span class="n">XX:MaxPermSize</span><span
class="o">=</span><span class="mi">128</span><span class="n">m</span>
+</pre></div>
+
+
+</li>
+</ul>
+<p>Please notice the line breaks.</p>
+<h3 id="location-of-apache-directory-studio-settings">Location of Apache Directory
Studio settings</h3>
+<p>The settings are located per default in your home directory under the directory
<em>.ApacheDirectoryStudio</em>.</p>
+<p>The file containing all connections is:</p>
+<div class="codehilite"><pre><span class="o">~</span><span class="sr">/.ApacheDirectoryStudio/</span><span
class="o">.</span><span class="n">metadata</span><span class="sr">/.plugins/o</span><span
class="n">rg</span><span class="o">.</span><span class="n">apache</span><span
class="o">.</span><span class="n">directory</span><span class="o">.</span><span
class="n">studio</span><span class="o">.</span><span class="n">connection</span><span
class="o">.</span><span class="n">core</span><span class="o">/</span><span
class="n">connections</span><span class="o">.</span><span class="n">xml</span>
+</pre></div>
+
+
+<p>The file containing all searches and bookmarks is:</p>
+<div class="codehilite"><pre><span class="o">~</span><span class="sr">/.ApacheDirectoryStudio/</span><span
class="o">.</span><span class="n">metadata</span><span class="sr">/.plugins/o</span><span
class="n">rg</span><span class="o">.</span><span class="n">apache</span><span
class="o">.</span><span class="n">directory</span><span class="o">.</span><span
class="n">studio</span><span class="o">.</span><span class="n">ldapbrowser</span><span
class="o">.</span><span class="n">core</span><span class="o">/</span><span
class="n">browserconnections</span><span class="o">.</span><span class="n">xml</span>
+</pre></div>
+
+
+<p>The file containing the history of the connection wizard (recently used hosts and
bind users) is:</p>
+<div class="codehilite"><pre><span class="o">~</span><span class="sr">/.ApacheDirectoryStudio/</span><span
class="o">.</span><span class="n">metadata</span><span class="sr">/.plugins/o</span><span
class="n">rg</span><span class="o">.</span><span class="n">apache</span><span
class="o">.</span><span class="n">directory</span><span class="o">.</span><span
class="n">studio</span><span class="o">.</span><span class="n">connection</span><span
class="o">.</span><span class="n">ui</span><span class="o">/</span><span
class="n">dialog_settings</span><span class="o">.</span><span class="n">xml</span>
+</pre></div>
+
+
+<p>The file containing the history of search settings (recently used DNs, filters,
returning attributes) is:</p>
+<div class="codehilite"><pre><span class="o">~</span><span class="sr">/.ApacheDirectoryStudio/</span><span
class="o">.</span><span class="n">metadata</span><span class="sr">/.plugins/o</span><span
class="n">rg</span><span class="o">.</span><span class="n">apache</span><span
class="o">.</span><span class="n">directory</span><span class="o">.</span><span
class="n">studio</span><span class="o">.</span><span class="n">ldapbrowser</span><span
class="o">.</span><span class="n">common</span><span class="o">/</span><span
class="n">dialog_settings</span><span class="o">.</span><span class="n">xml</span>
+</pre></div>
 
 
+<p>There are some more <em>dialog_settings.xml</em> files in the other
plugins directories.</p>
+<p>Note: the location of the settings directory could be configured by changing the
parameter "osgi.instance.area.default" in configuration/config.ini.</p>
+
 
 
                 </div><!-- rightColumn -->



Mime
View raw message