directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r872289 - in /websites/staging/directory/trunk/content: ./ apacheds/advanced-ug/5.1-layout.html
Date Thu, 01 Aug 2013 13:05:07 GMT
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) &amp; 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">&#39;apacheds.exe&#39;</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">&#39;wrapper.exe&#39;</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">&#39;libwrapper.so&#39;,</span>
<span class="err">or</span> <span class="err">&#39;libwrapper.dll&#39;</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> &gt; <em><strong>Contol
Panel</strong></em> &gt; <em><strong>Administration Tools</strong></em>
&gt; <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) &amp; 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">



Mime
View raw message