directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r934978 - in /websites/staging/directory/trunk/content: ./ apacheds/advanced-ug/2.2.1-debian-instance-layout.html apacheds/advanced-ug/2.2.2-rpm-instance-layout.html apacheds/advanced-ug/2.2.3-macosx-instance-layout.html
Date Sun, 04 Jan 2015 06:54:41 GMT
Author: buildbot
Date: Sun Jan  4 06:54:41 2015
New Revision: 934978

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.2-rpm-instance-layout.html
    websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.3-macosx-instance-layout.html

Propchange: websites/staging/directory/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Sun Jan  4 06:54:41 2015
@@ -1 +1 @@
-1649030
+1649294

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 Sun Jan  4 06:54:41 2015
@@ -235,17 +235,19 @@
                  <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">&#39;</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> !
+                 <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">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="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="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">&#39;</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> !
+                 <span class="o">|</span>
+                 <span class="o">+--</span> <span class="n">syncrepl</span><span class="o">-</span><span class="n">data</span><span class="o">/</span>
 </pre></div>
 
 
 <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-&lt;version&gt;/&lt;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> directories to create a blank new instance. Here, we have created a blank <em>test</em> instance :</p>
+<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-&lt;version&gt;/&lt;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>, <em>syncrepl-data</em> and <em>cache/</em> directories 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>

Modified: websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.2-rpm-instance-layout.html
==============================================================================
--- websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.2-rpm-instance-layout.html (original)
+++ websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.2-rpm-instance-layout.html Sun Jan  4 06:54:41 2015
@@ -165,84 +165,84 @@
 
 <h1 id="222-rpm-instance-layout">2.2.2 - <img alt="RPM" src="images/rpm.png" /> RPM Instance Layout</h1>
 <p>When you run the installer on your RPM based 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">-&lt;</span><span class="n">version</span><span class="o">&gt;-&lt;</span><span class="n">instance</span><span class="o">&gt;</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">-&lt;</span><span class="n">version</span><span class="o">&gt;/</span>
+            <span class="o">|</span>
+            <span class="o">+--</span> <span class="o">&lt;</span><span class="n">instance</span><span class="o">&gt;/</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">&#39;</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">editr</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">-&lt;</span><span class="n">version</span><span class="o">&gt;</span> <span class="n">start</span> <span class="o">&lt;</span><span class="n">instance</span><span class="o">&gt;</span>

Modified: websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.3-macosx-instance-layout.html
==============================================================================
--- websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.3-macosx-instance-layout.html (original)
+++ websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.3-macosx-instance-layout.html Sun Jan  4 06:54:41 2015
@@ -164,7 +164,266 @@
 
 
 <h1 id="223-macosx-instance-layout">2.2.3 - <img alt="MacOSX" src="images/mac.png" /> MacOSX Instance Layout</h1>
-<p>TODO...</p>
+<p>The Mac OS X installer creates the following layout on yout disk :
+     /
+     |
+     +-- usr/
+     |    |
+     |    +-- bin/
+     |    |    |
+     |    |    +-- apacheds    The script that starts the server
+     |    |
+     |    +-- local/
+     |         |
+     |         +-- apacheds-&lt;version&gt;
+     |              |
+     |              +-- bin/
+     |              |    |
+     |              |    +-- wrapper<em>   The wrapper
+     |              |    |
+     |              |    +-- apacheds</em>   The ApacheDS server starter
+     |              |
+     |              +-- conf/
+     |              |    |
+     |              |    +-- wrapper.conf
+     |              |
+     |              +-- instances/
+     |              |    | 
+     |              |    +-- default/
+     |              |         | 
+     |              |         +-- run/
+     |              |         | 
+     |              |         +-- partitions/
+     |              |         | 
+     |              |         +-- log/
+     |              |         | 
+     |              |         +-- conf/
+     |              |         |    | 
+     |              |         |    +-- wrapper-instance.conf
+     |              |         |    | 
+     |              |         |    +-- log4j.properties
+     |              |         |    | 
+     |              |         |    +-- config.ldif
+     |              |         | 
+     |              |         +-- cache/
+     |              |         | 
+     |              |         +-- syncrepl-data/
+     |              |
+     |              +-- lib/
+     |              |    |
+     |              |    +-- wrapper-3.2.3.jar
+     |              |    |
+     |              |    +-- libwrapper.jnilib
+     |              |    |
+     |              |    +-- apacheds-wrapper-2.0.0-M20-SNAPSHOT.jar
+     |              |    |
+     |              |    +-- apacheds-service-2.0.0-M20-SNAPSHOT.jar
+     |              |
+     |              +-- LICENSE
+     |              |
+     |              +-- NOTICE
+     +-- Library/
+          |
+          +-- LaunchDaemons/
+               |
+               +-- org.apache.directory.server.plist  The daemon plist</p>
+<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, you will have to copy the directory <em>/usr/local/apacheds-&lt;version&gt;/&lt;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>, <em>syncrepl-data</em> and <em>cache/</em> directories 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">usr</span><span class="o">/</span>
+      <span class="o">|</span>
+      <span class="o">+--</span><span class="n">local</span><span class="o">/</span>
+          <span class="o">|</span>
+          <span class="o">+--</span> <span class="n">apacheds</span><span class="o">-&lt;</span><span class="n">version</span><span class="o">&gt;/</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>You will also have to define a new daemon starter. This is done by copying the <em>Library/LaunchDaemons/org.apache.directory.server.plist</em> file and modifying it :</p>
+<div class="codehilite"><pre>$ <span class="n">sudo</span> <span class="n">cp</span> <span class="o">/</span><span class="n">Library</span><span class="o">/</span><span class="n">LaunchDaemons</span><span class="o">/</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">plist</span> <span class="o">/</span><span class="n">Library</span><span class="o">/</span><span class="n">LaunchDaemons</span><span class="o">/</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">test</span><span class="p">.</span><span class="n">plist</span>
+</pre></div>
+
+
+<p>Now, update the folliwing lines in this file :</p>
+<div class="codehilite"><pre><span class="nt">&lt;plist</span> <span class="na">version=</span><span class="s">&quot;1.0&quot;</span><span class="nt">&gt;</span>
+    <span class="nt">&lt;dict&gt;</span>
+        <span class="nt">&lt;key&gt;</span>Disabled<span class="nt">&lt;/key&gt;</span>
+        <span class="nt">&lt;false/&gt;</span>
+
+        <span class="nt">&lt;key&gt;</span>Label<span class="nt">&lt;/key&gt;</span>
+        <span class="nt">&lt;string&gt;</span>org.apache.directory.server<span class="nt">&lt;/string&gt;</span>   /// Change the name
+
+        <span class="nt">&lt;key&gt;</span>ProgramArguments<span class="nt">&lt;/key&gt;</span>
+        <span class="nt">&lt;array&gt;</span>
+            <span class="nt">&lt;string&gt;</span>/usr/local/apacheds-2.0.0-M20-SNAPSHOT/bin/apacheds<span class="nt">&lt;/string&gt;</span>
+            <span class="nt">&lt;string&gt;</span>console<span class="nt">&lt;/string&gt;</span>
+            <span class="nt">&lt;string&gt;</span>default<span class="nt">&lt;/string&gt;</span>   /// change the name to &#39;test&#39;
+        <span class="nt">&lt;/array&gt;</span>
+
+        <span class="nt">&lt;key&gt;</span>RunAtLoad<span class="nt">&lt;/key&gt;</span>
+        <span class="nt">&lt;false/&gt;</span>
+    <span class="nt">&lt;/dict&gt;</span>
+<span class="nt">&lt;/plist&gt;</span>
+</pre></div>
+
+
+<p>to something like :</p>
+<div class="codehilite"><pre><span class="nt">&lt;plist</span> <span class="na">version=</span><span class="s">&quot;1.0&quot;</span><span class="nt">&gt;</span>
+    <span class="nt">&lt;dict&gt;</span>
+        <span class="nt">&lt;key&gt;</span>Disabled<span class="nt">&lt;/key&gt;</span>
+        <span class="nt">&lt;false/&gt;</span>
+
+        <span class="nt">&lt;key&gt;</span>Label<span class="nt">&lt;/key&gt;</span>
+        <span class="nt">&lt;string&gt;</span>org.apache.directory.server.test<span class="nt">&lt;/string&gt;</span>   /// test
+
+        <span class="nt">&lt;key&gt;</span>ProgramArguments<span class="nt">&lt;/key&gt;</span>
+        <span class="nt">&lt;array&gt;</span>
+            <span class="nt">&lt;string&gt;</span>/usr/local/apacheds-2.0.0-M20-SNAPSHOT/bin/apacheds<span class="nt">&lt;/string&gt;</span>
+            <span class="nt">&lt;string&gt;</span>console<span class="nt">&lt;/string&gt;</span>
+            <span class="nt">&lt;string&gt;</span>test<span class="nt">&lt;/string&gt;</span>   /// test
+        <span class="nt">&lt;/array&gt;</span>
+
+        <span class="nt">&lt;key&gt;</span>RunAtLoad<span class="nt">&lt;/key&gt;</span>
+        <span class="nt">&lt;false/&gt;</span>
+    <span class="nt">&lt;/dict&gt;</span>
+<span class="nt">&lt;/plist&gt;</span>
+</pre></div>
+
+
+<p>then load the daemon :</p>
+<div class="codehilite"><pre>$ <span class="n">sudo</span> <span class="n">launchctl</span> <span class="o">/</span><span class="n">Library</span><span class="o">/</span><span class="n">LaunchDaemons</span><span class="o">/</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">test</span><span class="p">.</span><span class="n">plist</span>
+</pre></div>
+
+
+<p>and start it :</p>
+<div class="codehilite"><pre>$ <span class="n">sudo</span> <span class="n">launchctl</span> <span class="n">start</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">test</span>
+</pre></div>
+
+
+<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 instance in <em>/usr/local/apacheds&lt;version&gt;/&lt;instances&gt;</em> that can be installed. Each one of these instance can be started using the <em>launchctl</em> command applied on each loaded instance (which has a different name). Here, we will start the server which instances is the one we just defined, ie 'test' :</p>
+<div class="codehilite"><pre>$ <span class="n">sudo</span> <span class="n">launchctl</span> <span class="n">start</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">test</span>
+</pre></div>
+
+
+<p>The default instance name is org.apache.directory.server, to start it just type :</p>
+<div class="codehilite"><pre>$ <span class="n">sudo</span> <span class="n">launchctl</span> <span class="n">start</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>
+</pre></div>
+
+
+<p>All the data for a given instance are stored into this <em>/usr/local/apacheds-&lt;version&gt;/instances/&lt;instance-name&gt;</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="n">launchctl</span> <span class="n">stop</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">test</span>
+</pre></div>
+
+
+<p>Again, you must provide the instance name</p>
+<h2 id="logs">Logs</h2>
+<p>You can check what's going on in the <em>apacheds-&lt;version&gt;instances/&lt;instance-name&gt;/log/wrapper.log</em> file, and <em>apacheds-&lt;version&gt;instances/&lt;instance-name&gt;/log/apacheds.log</em> file which is created using the configuration set in <em>apacheds-&lt;version&gt;instances/&lt;instance-name&gt;/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">wrapper</span><span class="p">.</span><span class="nb">log</span>
+<span class="n">STATUS</span> <span class="o">|</span> <span class="n">wrapper</span>  <span class="o">|</span> 2015<span class="o">/</span>01<span class="o">/</span>04 07<span class="p">:</span>26<span class="p">:</span>14 <span class="o">|</span> <span class="o">--&gt;</span> <span class="n">Wrapper</span> <span class="n">Started</span> <span class="n">as</span> <span class="n">Console</span>
+<span class="n">STATUS</span> <span class="o">|</span> <span class="n">wrapper</span>  <span class="o">|</span> 2015<span class="o">/</span>01<span class="o">/</span>04 07<span class="p">:</span>26<span class="p">:</span>15 <span class="o">|</span> <span class="n">Launching</span> <span class="n">a</span> <span class="n">JVM</span><span class="p">...</span>
+<span class="n">INFO</span>   <span class="o">|</span> <span class="n">jvm</span> 1    <span class="o">|</span> 2015<span class="o">/</span>01<span class="o">/</span>04 07<span class="p">:</span>26<span class="p">:</span>15 <span class="o">|</span> <span class="n">Wrapper</span> <span class="p">(</span><span class="n">Version</span> 3<span class="p">.</span>2<span class="p">.</span>3<span class="p">)</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">wrapper</span><span class="p">.</span><span class="n">tanukisoftware</span><span class="p">.</span><span class="n">org</span>
+<span class="n">INFO</span>   <span class="o">|</span> <span class="n">jvm</span> 1    <span class="o">|</span> 2015<span class="o">/</span>01<span class="o">/</span>04 07<span class="p">:</span>26<span class="p">:</span>15 <span class="o">|</span>   <span class="n">Copyright</span> 1999<span class="o">-</span>2006 <span class="n">Tanuki</span> <span class="n">Software</span><span class="p">,</span> <span class="n">Inc</span><span class="p">.</span>  <span class="n">All</span> <span class="n">Rights</span> <span class="n">Reserved</span><span class="p">.</span>
+<span class="n">INFO</span>   <span class="o">|</span> <span class="n">jvm</span> 1    <span class="o">|</span> 2015<span class="o">/</span>01<span class="o">/</span>04 07<span class="p">:</span>26<span class="p">:</span>15 <span class="o">|</span> 
+<span class="n">INFO</span>   <span class="o">|</span> <span class="n">jvm</span> 1    <span class="o">|</span> 2015<span class="o">/</span>01<span class="o">/</span>04 07<span class="p">:</span>26<span class="p">:</span>18 <span class="o">|</span>            <span class="n">_</span>                     <span class="n">_</span>          <span class="n">____</span>  <span class="n">____</span>   
+<span class="n">INFO</span>   <span class="o">|</span> <span class="n">jvm</span> 1    <span class="o">|</span> 2015<span class="o">/</span>01<span class="o">/</span>04 07<span class="p">:</span>26<span class="p">:</span>18 <span class="o">|</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="n">INFO</span>   <span class="o">|</span> <span class="n">jvm</span> 1    <span class="o">|</span> 2015<span class="o">/</span>01<span class="o">/</span>04 07<span class="p">:</span>26<span class="p">:</span>18 <span class="o">|</span>          <span class="o">/</span> <span class="n">_</span> <span class="o">\</span> <span class="o">|</span> <span class="s">&#39;_ \ / _` |/ __| &#39;</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="n">INFO</span>   <span class="o">|</span> <span class="n">jvm</span> 1    <span class="o">|</span> 2015<span class="o">/</span>01<span class="o">/</span>04 07<span class="p">:</span>26<span class="p">:</span>18 <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="n">INFO</span>   <span class="o">|</span> <span class="n">jvm</span> 1    <span class="o">|</span> 2015<span class="o">/</span>01<span class="o">/</span>04 07<span class="p">:</span>26<span class="p">:</span>18 <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="n">INFO</span>   <span class="o">|</span> <span class="n">jvm</span> 1    <span class="o">|</span> 2015<span class="o">/</span>01<span class="o">/</span>04 07<span class="p">:</span>26<span class="p">:</span>18 <span class="o">|</span>                <span class="o">|</span><span class="n">_</span><span class="o">|</span>                                       
+<span class="n">INFO</span>   <span class="o">|</span> <span class="n">jvm</span> 1    <span class="o">|</span> 2015<span class="o">/</span>01<span class="o">/</span>04 07<span class="p">:</span>26<span class="p">:</span>18 <span class="o">|</span>
+</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-&lt;version&gt;/&lt;instance&gt;/&lt;conf&gt;/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&#39;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>
+
+
+<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>/usr/local/apacheds-&lt;version&gt;/&lt;instances&gt;/&lt;conf&gt;/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=&lt;path-to-java-executable&gt;</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">



Mime
View raw message