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 2013/08/01 15:05:07 UTC
svn commit: r872289 - in /websites/staging/directory/trunk/content: ./
apacheds/advanced-ug/5.1-layout.html
Author: buildbot
Date: Thu Aug 1 13:05:07 2013
New Revision: 872289
Log:
Staging update by buildbot for directory
Modified:
websites/staging/directory/trunk/content/ (props changed)
websites/staging/directory/trunk/content/apacheds/advanced-ug/5.1-layout.html
Propchange: websites/staging/directory/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Aug 1 13:05:07 2013
@@ -1 +1 @@
-1508960
+1509215
Modified: websites/staging/directory/trunk/content/apacheds/advanced-ug/5.1-layout.html
==============================================================================
--- websites/staging/directory/trunk/content/apacheds/advanced-ug/5.1-layout.html (original)
+++ websites/staging/directory/trunk/content/apacheds/advanced-ug/5.1-layout.html Thu Aug 1 13:05:07 2013
@@ -138,7 +138,161 @@
<h1 id="51-layout">5.1 - Layout</h1>
-<p>// To be completed</p>
+<div class="toc">
+<ul>
+<li><a href="#51-layout">5.1 - Layout</a><ul>
+<li><a href="#511-general-layout">5.1.1 General Layout</a><ul>
+<li><a href="#5111-installation-layout">5.1.1.1 Installation Layout</a></li>
+<li><a href="#5112-instance-layout">5.1.1.2 Instance Layout</a></li>
+</ul>
+</li>
+<li><a href="#512-specific-layouts">5.1.2 Specific Layouts</a><ul>
+<li><a href="#5121-archive-distribution-ziptargz">5.1.2.1 Archive Distribution (zip/tar.gz)</a></li>
+<li><a href="#5122-windows-installer-exe">5.1.2.2 Windows Installer (.exe)</a></li>
+<li><a href="#5123-linux-binary-bin-debian-deb-fedora-rpm-installers">5.1.2.3 Linux Binary (.bin), Debian (.deb) & Fedora (.rpm) Installers</a></li>
+<li><a href="#5124-mac-os-x-installer-pkg">5.1.2.4 Mac OS X Installer (.pkg)</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<h2 id="511-general-layout">5.1.1 General Layout</h2>
+<p>The general layout for ApacheDS is fairly simple and consists in two major concepts:</p>
+<ul>
+<li>an installation layout</li>
+<li>an instance layout</li>
+</ul>
+<h3 id="5111-installation-layout">5.1.1.1 Installation Layout</h3>
+<p>The installation is where are store all files essential to ApacheDS like the launch script, libraries, eventually a service wrapper (depending on the kind of installer used).</p>
+<p>The most common installation, shared by all ApacheDS installers, can be described as follows:</p>
+<div class="codehilite"><pre><span class="k">[Installation-Layout]</span>
+ <span class="err">|-</span> <span class="err">bin/</span>
+ <span class="err">|-</span> <span class="err">apacheds</span> <span class="err">(or</span> <span class="err">'apacheds.exe'</span> <span class="err">on</span> <span class="err">Windows)</span>
+ <span class="err">|-</span> <span class="err">wrapper</span> <span class="err">(or</span> <span class="err">'wrapper.exe'</span> <span class="err">on</span> <span class="err">Windows)</span>
+ <span class="err">|-</span> <span class="err">conf/</span>
+ <span class="err">|-</span> <span class="err">wrapper.conf</span>
+ <span class="err">|-</span> <span class="err">lib/</span>
+ <span class="err">|-</span> <span class="err">apacheds-service-${version}.jar</span>
+ <span class="err">|-</span> <span class="err">apacheds-wrapper-${version}.jar</span>
+ <span class="err">|-</span> <span class="err">libwrapper.jnilib</span> <span class="err">(or</span> <span class="err">'libwrapper.so',</span> <span class="err">or</span> <span class="err">'libwrapper.dll'</span> <span class="err">depending</span> <span class="err">on</span> <span class="err">the</span> <span class="err">platform)</span>
+ <span class="err">|-</span> <span class="err">wrapper-3.2.3.jar</span>
+ <span class="err">|-</span> <span class="err">LICENSE</span>
+ <span class="err">|-</span> <span class="err">NOTICE</span>
+</pre></div>
+
+
+<ul>
+<li>The <em><strong>bin/</strong></em> directory contains the <em><strong>apacheds</strong></em> launch script and <em><strong>wrapper</strong></em> binary used to configure ApacheDS as a <em>service</em>.</li>
+<li>The <em><strong>conf/</strong></em> directory holds the general configuration for the service in <em><strong>wrapper.conf</strong></em>.</li>
+<li>The <em><strong>lib/</strong></em> directory contains all ApacheDS and wrapper libraries necessary to run the server.</li>
+<li><em><strong>LICENCE</strong></em> and <em><strong>NOTICE</strong></em> files contains the required legal information about ApacheDS.</li>
+</ul>
+<h3 id="5112-instance-layout">5.1.1.2 Instance Layout</h3>
+<p>ApacheDS is built to be able to run multiple instances of the server at the same time, which means that optionally an <em><strong>instances</strong></em> folder can be found in the installation layout (or elswhere on disk depending on the platform).
+In that folder, can be found a single or multiple directories, all sharing the same layout, corresponding to all ApacheDS instance (one directory per instance, named by the id of the instance).</p>
+<p>Here's how this instance layout can be described:</p>
+<div class="codehilite"><pre><span class="k">[Instance-Layout]</span>
+ <span class="err">|-</span> <span class="err">cache/</span>
+ <span class="err">|-</span> <span class="k">[...]</span>
+ <span class="err">|-</span> <span class="err">conf/</span>
+ <span class="err">|-</span> <span class="err">config.ldif</span>
+ <span class="err">|-</span> <span class="err">log4j.properties</span>
+ <span class="err">|-</span> <span class="err">wrapper.conf</span>
+ <span class="err">|-</span> <span class="err">log/</span>
+ <span class="err">|-</span> <span class="err">apacheds.log</span>
+ <span class="err">|-</span> <span class="err">wrapper.log</span>
+ <span class="err">|-</span> <span class="err">partitions/</span>
+ <span class="err">|-</span> <span class="err">example/</span>
+ <span class="err">|-</span> <span class="k">[...]</span>
+ <span class="err">|-</span> <span class="err">schema/</span>
+ <span class="err">|-</span> <span class="k">[...]</span>
+ <span class="err">|-</span> <span class="err">system/</span>
+ <span class="err">|-</span> <span class="k">[...]</span>
+</pre></div>
+
+
+<ul>
+<li>The <em><strong>cache/</strong></em> directory is empty upon installation and contains all the data required for the cache system after the first start of the server.</li>
+<li>The <em><strong>conf/</strong></em> directory contains:<ul>
+<li>an additional <em><strong>wrapper.conf</strong></em> where general configuration defined in the installation layout can be overwritten for the given instance.</li>
+<li>a <em><strong>log4j.properties</strong></em> file which is reponsible for logging configuration.</li>
+<li>a <em><strong>config.ldif</strong></em> file corresponding to the inner configuration of ApacheDS.</li>
+</ul>
+</li>
+<li>The <em><strong>log/</strong></em> directory is empty upon installation and contains two files after the first start of the server:<ul>
+<li>a <em><strong>apacheds.log</strong></em> which is where all logs defined in the <em><strong>log4j.properties</strong></em> go.</li>
+<li>a <em><strong>wrapper.log</strong></em> which only contains the wrapper logs (related to the service's start/stop).</li>
+</ul>
+</li>
+<li>The <em><strong>partitions/</strong></em> directory is empty upon installation and contains after the first start of the server a directory for each partition defined in the configuration:<ul>
+<li>the <em><strong>example/</strong></em> directory holds the data for the "<em>example</em>" partition defined in ApacheDS' default configuration.</li>
+<li>the <em><strong>schema/</strong></em> and <em><strong>system/</strong></em> directories contain the data for both internal "<em>schema</em>" and "<em>system</em>" partitions.</li>
+</ul>
+</li>
+</ul>
+<h2 id="512-specific-layouts">5.1.2 Specific Layouts</h2>
+<p>Depending on the type of distribution used to install ApacheDS, the ApacheDS layout with varify to adapt as best as possible to the specificities of each platform.</p>
+<h3 id="5121-archive-distribution-ziptargz">5.1.2.1 Archive Distribution (zip/tar.gz)</h3>
+<p>The Archive distribution consist of a compressed directory containing everything needed to run ApacheDS. It doesn't install on the machine and does not require any extra permission (root user, installer password, etc.). The directory is simply unarchived and ApacheDS is ready to be launched.</p>
+<p>The installation layout is bit simpler for kind of distribution as no wrapper is distributed, the application being run in a terminal or via the launch of the bat script.</p>
+<div class="codehilite"><pre><span class="k">[Installation-Layout]</span>
+ <span class="err">|-</span> <span class="err">bin/</span>
+ <span class="err">|-</span> <span class="err">apacheds.bat</span>
+ <span class="err">|-</span> <span class="err">apacheds.sh</span>
+ <span class="err">|-</span> <span class="err">cpappend.bat</span>
+ <span class="err">|-</span> <span class="err">instances/</span>
+ <span class="err">|-</span> <span class="err">lib/</span>
+ <span class="err">|-</span> <span class="err">apacheds-service-${version}.jar</span>
+ <span class="err">|-</span> <span class="err">LICENSE</span>
+ <span class="err">|-</span> <span class="err">NOTICE</span>
+</pre></div>
+
+
+<ul>
+<li>The <em><strong>bin/</strong></em> directory contains the <em><strong>apacheds.bat</strong></em> (Windows) and <em><strong>apacheds.sh</strong></em> (Linux/Unix) launch scripts and a <em><strong>cpappend.bat</strong></em> utility (only used on Windows).</li>
+<li>The <em><strong>instances/</strong></em> directory hold all ApacheDS instances (an instance named <em><strong>default</strong></em> is provided by default).</li>
+<li>The <em><strong>lib/</strong></em> directory only contains the ApacheDS library.</li>
+<li><em><strong>LICENCE</strong></em> and <em><strong>NOTICE</strong></em> files contains the required legal information about ApacheDS.</li>
+</ul>
+<h3 id="5122-windows-installer-exe">5.1.2.2 Windows Installer (.exe)</h3>
+<p>The Windows installer uses the general installation and instances layout.</p>
+<p>By default, the installation directory is:</p>
+<div class="codehilite"><pre><span class="n">C</span><span class="p">:</span><span class="o">\</span><span class="n">Program</span> <span class="n">Files</span><span class="o">\</span><span class="n">ApacheDS</span>
+</pre></div>
+
+
+<p>An <em><strong>instances/</strong></em> directory in the installation layout holds all ApacheDS instances (an instance named <em><strong>default</strong></em> is provided by default).</p>
+<p>ApacheDS is registered as a service on Windows. Operations on the service can be achieved in the <em><strong>Services</strong></em> utility which is accessible via <em><strong>Start</strong></em> > <em><strong>Contol Panel</strong></em> > <em><strong>Administration Tools</strong></em> > <em><strong>Services</strong></em>.</p>
+<h3 id="5123-linux-binary-bin-debian-deb-fedora-rpm-installers">5.1.2.3 Linux Binary (.bin), Debian (.deb) & Fedora (.rpm) Installers</h3>
+<p>The Mac OS X installer uses the general installation and instances layout.</p>
+<p>By default, the installation directory is:</p>
+<div class="codehilite"><pre>/opt/apacheds-<span class="cp">${</span><span class="n">version</span><span class="cp">}</span>
+</pre></div>
+
+
+<p>All ApacheDS instances are located in a directory at the following location (an instance named <em><strong>default</strong></em> is provided by default):</p>
+<div class="codehilite"><pre>/var/lib/apacheds-<span class="cp">${</span><span class="n">version</span><span class="cp">}</span>
+</pre></div>
+
+
+<p>The installer also adds a <em>shortcut</em> launch script for the default instance at:</p>
+<div class="codehilite"><pre>/etc/init.d/apacheds-<span class="cp">${</span><span class="n">version</span><span class="cp">}</span>-default
+</pre></div>
+
+
+<p><strong>NOTE:</strong> The ApacheDS Linux Binary installer lets the user decide the locations of the installation directory, the instances directory and the default instance launch script. The locations above refer to the default location and need to be adapted to whatever path was chosen during the installation.</p>
+<h3 id="5124-mac-os-x-installer-pkg">5.1.2.4 Mac OS X Installer (.pkg)</h3>
+<p>The Mac OS X installer uses the general installation and instances layout.</p>
+<p>By default, the installation directory is:</p>
+<div class="codehilite"><pre>/usr/local/apacheds-<span class="cp">${</span><span class="n">version</span><span class="cp">}</span>
+</pre></div>
+
+
+<p>An <em><strong>instances/</strong></em> directory in the installation layout holds all ApacheDS instances (an instance named <em><strong>default</strong></em> is provided by default).</p>
+<p>The installer also adds a <em>shortcut</em> to the command in the <em><strong>bin</strong></em> directory called "<em><strong>apacheds</strong></em>", accessible directly in a terminal and located at:</p>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">bin</span><span class="o">/</span><span class="n">apacheds</span>
+</pre></div>
<div class="nav">