You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by bu...@apache.org on 2015/01/02 14:41:03 UTC
svn commit: r934782 - in /websites/staging/directory/trunk/content: ./
apacheds/advanced-ug/2.2.1-debian-instance-layout.html
apacheds/advanced-ug/2.2.5-generic-instance-layout.html
Author: buildbot
Date: Fri Jan 2 13:41:03 2015
New Revision: 934782
Log:
Staging update by buildbot for directory
Modified:
websites/staging/directory/trunk/content/ (props changed)
websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.1-debian-instance-layout.html
websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.5-generic-instance-layout.html
Propchange: websites/staging/directory/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Jan 2 13:41:03 2015
@@ -1 +1 @@
-1648993
+1649026
Modified: websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.1-debian-instance-layout.html
==============================================================================
--- websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.1-debian-instance-layout.html (original)
+++ websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.1-debian-instance-layout.html Fri Jan 2 13:41:03 2015
@@ -165,120 +165,158 @@
<h1 id="221-debian-instance-layout">2.2.1 - <img alt="debian" src="images/debian.png" /> Debian Instance Layout</h1>
<p>When you run the installer ( <em>sudo dpkg -i apacheds-<version>-&lit;arch>.deb</em> ) on your debian system, it will install the server on your disk, using this layout :</p>
-<PRE>
- /
- |
- +-- etc/
- | |
- | +-- init.d/
- | |
- | +-- apacheds-<version>-<instance> The daemon used to start the server
- +-- opt/
- | |
- | +-- conf/
- | | |
- | | +-- wrapper.conf The wrapper default configuration
- | |
- | +-- bin/
- | | |
- | | +-- apacheds* The script that starts the server
- | | |
- | | +-- wrapper* The binary that starts the server
- | |
- | +-- lib
- | | |
- | | +-- wrapper-3.2.3.jar
- | | |
- | | +-- libwrapper.so
- | | |
- | | +-- apacheds-wrapper-2.0.0-M20-SNAPSHOT.jar
- | | |
- | | +-- apacheds-service-2.0.0-M20-SNAPSHOT.jar
- | |
- | +-- NOTICE
- | |
- | +-- LICENSE
- |
- +-- var/
- |
- +--lib/
- |
- +-- apacheds-<version>/
- |
- +-- <instance>/
- |
- +-- run/
- | |
- | +-- apacheds-default.pid The PID of the running process
- |
- +-- partitions/ This is were your data will be stored
- | |
- | +-- schema/
- | |
- | +-- system/
- | |
- | +-- example/
- |
- +-- log/ This is were the logs are stored
- | |
- | +-- apacheds.log
- | |
- | +-- wrapper.log
- |
- +-- cache/ This is where the various caches are stored
- | |
- | +-- changePwdReplayCache.data
- | |
- | +-- ou=system.data
- | |
- | +-- groupCache.data
- | |
- | +-- kdcReplayCache.data
- |
- +-- conf/
- |
- +-- wrapper-instance.conf The specific instance wrapper configuration
- |
- +-- log4j.properties The log configuration file
- |
- +-- config.ldif The server configuration. Don't manipulate this file with a text editr !
-</PRE>
+<div class="codehilite"><pre> <span class="o">/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">etc</span><span class="o">/</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">init</span><span class="p">.</span><span class="n">d</span><span class="o">/</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">apacheds</span><span class="o">-<</span><span class="n">version</span><span class="o">>-<</span><span class="n">instance</span><span class="o">></span> <span class="n">The</span> <span class="n">daemon</span> <span class="n">used</span> <span class="n">to</span> <span class="n">start</span> <span class="n">the</span> <span class="n">server</span>
+ <span class="o">+--</span> <span class="n">opt</span><span class="o">/</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">conf</span><span class="o">/</span>
+ <span class="o">|</span> <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">|</span> <span class="o">+--</span> <span class="n">wrapper</span><span class="p">.</span><span class="n">conf</span> <span class="n">The</span> <span class="n">wrapper</span> <span class="n">default</span> <span class="n">configuration</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">bin</span><span class="o">/</span>
+ <span class="o">|</span> <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">|</span> <span class="o">+--</span> <span class="n">apacheds</span><span class="o">*</span> <span class="n">The</span> <span class="n">script</span> <span class="n">that</span> <span class="n">starts</span> <span class="n">the</span> <span class="n">server</span>
+ <span class="o">|</span> <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">|</span> <span class="o">+--</span> <span class="n">wrapper</span><span class="o">*</span> <span class="n">The</span> <span class="n">binary</span> <span class="n">that</span> <span class="n">starts</span> <span class="n">the</span> <span class="n">server</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">lib</span>
+ <span class="o">|</span> <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">|</span> <span class="o">+--</span> <span class="n">wrapper</span><span class="o">-</span>3<span class="p">.</span>2<span class="p">.</span>3<span class="p">.</span><span class="n">jar</span>
+ <span class="o">|</span> <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">|</span> <span class="o">+--</span> <span class="n">libwrapper</span><span class="p">.</span><span class="n">so</span>
+ <span class="o">|</span> <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">|</span> <span class="o">+--</span> <span class="n">apacheds</span><span class="o">-</span><span class="n">wrapper</span><span class="o">-</span>2<span class="p">.</span>0<span class="p">.</span>0<span class="o">-</span><span class="n">M20</span><span class="o">-</span><span class="n">SNAPSHOT</span><span class="p">.</span><span class="n">jar</span>
+ <span class="o">|</span> <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">|</span> <span class="o">+--</span> <span class="n">apacheds</span><span class="o">-</span><span class="n">service</span><span class="o">-</span>2<span class="p">.</span>0<span class="p">.</span>0<span class="o">-</span><span class="n">M20</span><span class="o">-</span><span class="n">SNAPSHOT</span><span class="p">.</span><span class="n">jar</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">NOTICE</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">LICENSE</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">var</span><span class="o">/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span><span class="n">lib</span><span class="o">/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">apacheds</span><span class="o">-<</span><span class="n">version</span><span class="o">>/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="o"><</span><span class="n">instance</span><span class="o">>/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">run</span><span class="o">/</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">apacheds</span><span class="o">-</span><span class="n">default</span><span class="p">.</span><span class="n">pid</span> <span class="n">The</span> <span class="n">PID</span> <span class="n">of</span> <span class="n">the</span> <span class="n">running</span> <span class="n">process</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">partitions</span><span class="o">/</span> <span class="n">This</span> <span class="n">is</span> <span class="n">were</span> <span class="n">your</span> <span class="n">data</span> <span class="n">will</span> <span class="n">be</span> <span class="n">stored</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">schema</span><span class="o">/</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">system</span><span class="o">/</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">example</span><span class="o">/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="nb">log</span><span class="o">/</span> <span class="n">This</span> <span class="n">is</span> <span class="n">were</span> <span class="n">the</span> <span class="n">logs</span> <span class="n">are</span> <span class="n">stored</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">apacheds</span><span class="p">.</span><span class="nb">log</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">wrapper</span><span class="p">.</span><span class="nb">log</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">cache</span><span class="o">/</span> <span class="n">This</span> <span class="n">is</span> <span class="n">where</span> <span class="n">the</span> <span class="n">various</span> <span class="n">caches</span> <span class="n">are</span> <span class="n">stored</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">changePwdReplayCache</span><span class="p">.</span><span class="n">data</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">ou</span><span class="p">=</span><span class="n">system</span><span class="p">.</span><span class="n">data</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">groupCache</span><span class="p">.</span><span class="n">data</span>
+ <span class="o">|</span> <span class="o">|</span>
+ <span class="o">|</span> <span class="o">+--</span> <span class="n">kdcReplayCache</span><span class="p">.</span><span class="n">data</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">conf</span><span class="o">/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">wrapper</span><span class="o">-</span><span class="n">instance</span><span class="p">.</span><span class="n">conf</span> <span class="n">The</span> <span class="n">specific</span> <span class="n">instance</span> <span class="n">wrapper</span> <span class="n">configuration</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">log4j</span><span class="p">.</span><span class="k">properties</span> <span class="n">The</span> <span class="nb">log</span> <span class="n">configuration</span> <span class="n">file</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">config</span><span class="p">.</span><span class="n">ldif</span> <span class="n">The</span> <span class="n">server</span> <span class="n">configuration</span><span class="p">.</span> <span class="n">Don</span><span class="o">'</span><span class="n">t</span> <span class="n">manipulate</span> <span class="n">this</span> <span class="n">file</span> <span class="n">with</span> <span class="n">a</span> <span class="n">text</span> <span class="n">editor</span> !
+</pre></div>
+
-<p>As we can have more than one instance, we have more than one directory in <em>/var/lib/apacheds</em> that can be installed. Each one of these instance can be started using the <em>/etc/init.d/apacheds</em> daemon, passing the instancz as a parameter :</p>
-<div class="codehilite"><pre>$ <span class="n">sudo</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">init</span><span class="p">.</span><span class="n">d</span><span class="o">/</span><span class="n">apacheds</span><span class="o">-<</span><span class="n">version</span><span class="o">></span> <span class="n">start</span> <span class="o"><</span><span class="n">instance</span><span class="o">></span>
+<h2 id="defining-an-instance">Defining an instance</h2>
+<p>The default installation comes with a default instance (aka <em>default</em>). It's possible to define more instances, it's just enough to copy the directory <em>/var/lib/apacheds-<version>/<instances;gt;/default</em> and give it the name of the new instance. Then, be sure to remove everything under the <em>run/</em>, <em>partitions/</em>, <em>log/</em> and <em>cache/</em> directory to create a blank new instance. Here, we have created a blank <em>test</em> instance :</p>
+<div class="codehilite"><pre> <span class="o">/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">var</span><span class="o">/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span><span class="n">lib</span><span class="o">/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">apacheds</span><span class="o">-<</span><span class="n">version</span><span class="o">>/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">test</span><span class="o">/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">run</span><span class="o">/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">partitions</span><span class="o">/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="nb">log</span><span class="o">/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">cache</span><span class="o">/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">conf</span><span class="o">/</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">wrapper</span><span class="o">-</span><span class="n">instance</span><span class="p">.</span><span class="n">conf</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">log4j</span><span class="p">.</span><span class="k">properties</span>
+ <span class="o">|</span>
+ <span class="o">+--</span> <span class="n">config</span><span class="p">.</span><span class="n">ldif</span>
+</pre></div>
+
+
+<p>The next step is to be sure that the config.ldif file is modified to not conflict with any other instance of the server : it's just a mater to change the port used by the server.</p>
+<p>When the newly created instance will be created, the partitions will be created.</p>
+<h2 id="starting-the-server">Starting the server</h2>
+<p>As we can have more than one instance, we have more than one directory in <em>/var/lib/apacheds<version></em> that can be installed. Each one of these instance can be started using the <em>/etc/init.d/apacheds</em> daemon, passing the instance as a parameter :</p>
+<div class="codehilite"><pre>$ <span class="n">sudo</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">init</span><span class="p">.</span><span class="n">d</span><span class="o">/</span><span class="n">apacheds</span><span class="o">-<</span><span class="n">version</span><span class="o">></span> <span class="n">start</span> <span class="p">[</span><span class="o"><</span><span class="n">instance</span><span class="o">></span><span class="p">]</span>
</pre></div>
<p>The default instance name is 'default'.</p>
-<p>All the data for a given instance are stored into this <em>/var/lib/apacheds-<version><em> directory.</p>
-<h2 id="configuring-each-instance">Configuring each instance</h2>
-<p>You can configure a specific settings. This is done by modifying the configuration files in <em>/var/lib/apacheds-<version>/<instance></em>.</p>
-<h3 id="jvm-setting">JVM setting</h3>
-<p>Were you to change the memory you want to use for a given instance, you will have to modify the <em>/var/lib/apacheds-<version>/<instance>/<conf>/wrapper-instance.conf</em> file. Here are the parameter you can configure in this file :</p>
-<div class="codehilite"><pre><span class="c">##</span>
-<span class="c">## In this file you can override parameters specified in the default</span>
-<span class="c">## Apache Directory Server config file which is usually at</span>
-<span class="c">## /opt/apacheds-2.0.0-M20-SNAPSHOT/conf/wrapper.conf</span>
-<span class="c">##</span>
-<span class="c">## See also http://wrapper.tanukisoftware.org/doc/english/properties.html</span>
-<span class="c">## For a list of properties that can be set.</span>
-<span class="c">##</span>
+<p>All the data for a given instance are stored into this <em>/var/lib/apacheds-<version>/instances/<instance-name><em> directory.</p>
+<h2 id="stopping-the-server">Stopping the server</h2>
+<p>Stopping the server is done using the same command, with a different parameter :</p>
+<div class="codehilite"><pre>$ <span class="n">sudo</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">init</span><span class="p">.</span><span class="n">d</span><span class="o">/</span><span class="n">apacheds</span><span class="o">-<</span><span class="n">version</span><span class="o">></span> <span class="n">stop</span> <span class="p">[</span><span class="o"><</span><span class="n">instance</span><span class="o">></span><span class="p">]</span>
+</pre></div>
-<span class="c">## Override the JRE used</span>
-<span class="c"># wrapper.java.command=<path-to-java-executable></span>
-<span class="c">## Override the JVM memory settings</span>
-<span class="c">## Initial Java Heap Size (in MB)</span>
-<span class="c"># wrapper.java.initmemory=1024</span>
+<p>Again, you must provide the instance name if it's not the default one</p>
+<h2 id="logs">Logs</h2>
+<p>You can check what's going on in the <em>apacheds-<version>instances/<instance-name>/log/apacheds.log</em> file, which is created using the configuration set in <em>apacheds-<version>instances/<instance-name>/conf/log4j.properties</em>.</p>
+<p>Typically, when you start the server, you will get such log :</p>
+<div class="codehilite"><pre>$ <span class="n">more</span> <span class="n">apacheds</span><span class="p">.</span><span class="nb">log</span>
+<span class="p">[</span>10<span class="p">:</span>53<span class="p">:</span>05<span class="p">]</span> <span class="n">WARN</span> <span class="p">[</span><span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">directory</span><span class="p">.</span><span class="n">server</span><span class="p">.</span><span class="n">core</span><span class="p">.</span><span class="n">DefaultDirectoryService</span><span class="p">]</span> <span class="o">-</span> <span class="n">You</span> <span class="n">didn</span><span class="o">'</span><span class="n">t</span> <span class="n">change</span> <span class="n">the</span> <span class="n">admin</span> <span class="n">password</span> <span class="n">of</span>
+<span class="n">directory</span> <span class="n">service</span> <span class="n">instance</span> <span class="s">'default'</span><span class="p">.</span> <span class="n">Please</span> <span class="n">update</span> <span class="n">the</span> <span class="n">admin</span> <span class="n">password</span> <span class="n">as</span> <span class="n">soon</span> <span class="n">as</span> <span class="n">possible</span> <span class="n">to</span> <span class="n">prevent</span> <span class="n">a</span> <span class="n">possible</span>
+<span class="n">security</span> <span class="n">breach</span><span class="p">.</span>
+</pre></div>
-<span class="c">## Maximum Java Heap Size (in MB)</span>
-<span class="c"># wrapper.java.maxmemory=2048</span>
+
+<p>and from the <em>apacheds-<version>/instances/<instance-name>/log/apacheds.out</em> file, which contains everything the server writes on the console, you will read :</p>
+<div class="codehilite"><pre>$ <span class="n">more</span> <span class="n">apacheds</span><span class="p">.</span><span class="n">out</span>
+<span class="p">[</span>10<span class="p">:</span>53<span class="p">:</span>05<span class="p">]</span> <span class="n">WARN</span> <span class="p">[</span><span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">directory</span><span class="p">.</span><span class="n">server</span><span class="p">.</span><span class="n">core</span><span class="p">.</span><span class="n">DefaultDirectoryService</span><span class="p">]</span> <span class="o">-</span> <span class="n">You</span> <span class="n">didn</span><span class="o">'</span><span class="n">t</span> <span class="n">change</span> <span class="n">the</span> <span class="n">admin</span> <span class="n">password</span> <span class="n">of</span>
+<span class="n">directory</span> <span class="n">service</span> <span class="n">instance</span> <span class="s">'default'</span><span class="p">.</span> <span class="n">Please</span> <span class="n">update</span> <span class="n">the</span> <span class="n">admin</span> <span class="n">password</span> <span class="n">as</span> <span class="n">soon</span> <span class="n">as</span> <span class="n">possible</span> <span class="n">to</span> <span class="n">prevent</span> <span class="n">a</span> <span class="n">possible</span>
+<span class="n">security</span> <span class="n">breach</span><span class="p">.</span>
+ <span class="n">_</span> <span class="n">_</span> <span class="n">____</span> <span class="n">____</span>
+ <span class="o">/</span> <span class="o">\</span> <span class="n">_</span> <span class="n">__</span> <span class="n">___</span> <span class="n">___</span><span class="o">|</span> <span class="o">|</span><span class="n">__</span> <span class="n">___</span><span class="o">|</span> <span class="n">_</span> <span class="o">\/</span> <span class="n">___</span><span class="o">|</span>
+ <span class="o">/</span> <span class="n">_</span> <span class="o">\</span> <span class="o">|</span> <span class="s">'_ \ / _` |/ __| '</span><span class="n">_</span> <span class="o">\</span> <span class="o">/</span> <span class="n">_</span> <span class="o">\</span> <span class="o">|</span> <span class="o">|</span> <span class="o">\</span><span class="n">___</span> <span class="o">\</span>
+ <span class="o">/</span> <span class="n">___</span> <span class="o">\|</span> <span class="o">|</span><span class="n">_</span><span class="p">)</span> <span class="o">|</span> <span class="p">(</span><span class="n">_</span><span class="o">|</span> <span class="o">|</span> <span class="p">(</span><span class="n">__</span><span class="o">|</span> <span class="o">|</span> <span class="o">|</span> <span class="o">|</span> <span class="n">__</span><span class="o">/</span> <span class="o">|</span><span class="n">_</span><span class="o">|</span> <span class="o">|</span><span class="n">___</span><span class="p">)</span> <span class="o">|</span>
+ <span class="o">/</span><span class="n">_</span><span class="o">/</span> <span class="o">\</span><span class="n">_</span><span class="o">\</span> <span class="p">.</span><span class="n">__</span><span class="o">/</span> <span class="o">\</span><span class="n">__</span><span class="p">,</span><span class="n">_</span><span class="o">|\</span><span class="n">___</span><span class="o">|</span><span class="n">_</span><span class="o">|</span> <span class="o">|</span><span class="n">_</span><span class="o">|\</span><span class="n">___</span><span class="o">|</span><span class="n">____</span><span class="o">/|</span><span class="n">____</span><span class="o">/</span>
+ <span class="o">|</span><span class="n">_</span><span class="o">|</span>
</pre></div>
-<p>You mainly want to change the memory used by the JVM.</p>
<h3 id="log-configuration">Log configuration</h3>
-<p>You can configure the log level and content by changing the content of the <em>/var/lib/apacheds-<version>/<instance>/<conf>/log4j.properties</em> file.</p>
+<p>You can configure the log level and content by changing the content of the <em>/var/lib/apacheds-<version>/<instance>/<conf>/log4j.properties</em> file.</p>
<p>The default configuration is given below :</p>
<div class="codehilite"><pre>log4j.rootCategory=WARN, R, stdout
@@ -319,6 +357,32 @@ log4j.logger.org.apache.mina=FATAL
</pre></div>
+<h3 id="jvm-setting">JVM setting</h3>
+<p>Were you to change the memory you want to use for a given instance, you will have to modify the <em>/var/lib/apacheds-<version>/<instance>/<conf>/wrapper-instance.conf</em> file. Here are the parameter you can configure in this file :</p>
+<div class="codehilite"><pre><span class="c">##</span>
+<span class="c">## In this file you can override parameters specified in the default</span>
+<span class="c">## Apache Directory Server config file which is usually at</span>
+<span class="c">## /opt/apacheds-2.0.0-M20-SNAPSHOT/conf/wrapper.conf</span>
+<span class="c">##</span>
+<span class="c">## See also http://wrapper.tanukisoftware.org/doc/english/properties.html</span>
+<span class="c">## For a list of properties that can be set.</span>
+<span class="c">##</span>
+
+<span class="c">## Override the JRE used</span>
+<span class="c"># wrapper.java.command=<path-to-java-executable></span>
+
+<span class="c">## Override the JVM memory settings</span>
+<span class="c">## Initial Java Heap Size (in MB)</span>
+<span class="c"># wrapper.java.initmemory=1024</span>
+
+<span class="c">## Maximum Java Heap Size (in MB)</span>
+<span class="c"># wrapper.java.maxmemory=2048</span>
+</pre></div>
+
+
+<p>You mainly want to change the memory used by the JVM.</p>
+
+
<div class="nav">
<div class="nav_prev">
Modified: websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.5-generic-instance-layout.html
==============================================================================
--- websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.5-generic-instance-layout.html (original)
+++ websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.5-generic-instance-layout.html Fri Jan 2 13:41:03 2015
@@ -267,6 +267,48 @@ $
</pre></div>
+<h3 id="log-configuration">Log configuration</h3>
+<p>You can configure the log level and content by changing the content of the <em>/var/lib/apacheds-<version>/<instance>/<conf>/log4j.properties</em> file.</p>
+<p>The default configuration is given below :</p>
+<div class="codehilite"><pre>log4j.rootCategory=WARN, R, stdout
+
+log4j.appender.stdout=org.apache.log4j.ConsoleAppender
+log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
+
+log4j.appender.R=org.apache.log4j.RollingFileAppender
+log4j.appender.R.File=<span class="cp">${</span><span class="n">apacheds</span><span class="o">.</span><span class="n">log</span><span class="o">.</span><span class="n">dir</span><span class="cp">}</span>/apacheds.log
+
+log4j.appender.R.MaxFileSize=1024KB
+# Keep some backup files
+log4j.appender.R.MaxBackupIndex=5
+
+log4j.appender.R.layout=org.apache.log4j.PatternLayout
+log4j.appender.R.layout.ConversionPattern=[%d{HH:mm:ss}] %p [%c] - %m%n
+
+log4j.appender.stdout.layout.ConversionPattern=[%d{HH:mm:ss}] %p [%c] - %m%n
+
+# with these we'll not get innundated when switching to DEBUG
+log4j.logger.jdbm.recman.BaseRecordManager=FATAL
+log4j.logger.org.apache.directory.server.OPERATION_LOG=FATAL
+log4j.logger.org.apache.directory.server.OPERATION_TIME=FATAL
+log4j.logger.org.apache.directory.api.CODEC_LOG=FATAL
+log4j.logger.org.apache.directory.server.ACI_LOG=FATAL
+
+# Replication logs
+log4j.logger.org.apache.directory.server.PROVIDER_LOG=FATAL
+log4j.logger.org.apache.directory.server.CONSUMER_LOG=FATAL
+
+# Search log
+log4j.logger.org.apache.directory.CURSOR_LOG=FATAL
+
+# Other logs
+log4j.logger.org.apache.directory.api=FATAL
+log4j.logger.org.apache.directory.server=FATAL
+log4j.logger.net.sf.ehcache=FATAL
+log4j.logger.org.apache.mina=FATAL
+</pre></div>
+
+
<div class="nav">
<div class="nav_prev">