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 2014/11/29 11:01:11 UTC
svn commit: r930972 - in /websites/staging/directory/trunk/content: ./
apacheds/advanced-ug/2.2-installation-layout.html
Author: buildbot
Date: Sat Nov 29 10:01:11 2014
New Revision: 930972
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-installation-layout.html
Propchange: websites/staging/directory/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Sat Nov 29 10:01:11 2014
@@ -1 +1 @@
-1642385
+1642408
Modified: websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2-installation-layout.html
==============================================================================
--- websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2-installation-layout.html (original)
+++ websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2-installation-layout.html Sat Nov 29 10:01:11 2014
@@ -182,14 +182,15 @@
<p>We also provide two packages, one which is a binary package that should run as is on any linux box, but will not be started as a daemon, and another which contains all the files.</p>
<p>In the next paragraph, we will describe the installation layout for each OS.</p>
<h2 id="debian-standard-layout"><img alt="debian" src="images/debian.png" /> Debian Standard layout</h2>
-<p>This is the directories the installer creates :</p>
-<p>installation directory/
+<p>On debian, the installation will be done in <em>/opt</em>, and the daemon script will be in <em>/etc/init.d</em>. Here are the created directories :</p>
+<PRE>
+ /opt
|
+-- bin/
| |
- | +-- apacheds
+ | +-- apacheds*
| |
- | +-- wrapper
+ | +-- wrapper*
|
+-- conf/
| |
@@ -201,28 +202,52 @@
| |
| +-- apacheds-wrapper-<version>.jar
| |
- | +-- libwrapper.jnilib
+ | +-- libwrapper.so
| |
| +-- wrapper-3.2.3.jar
|
- +-- instances/
- | |
- | +-- default
- | |
- | +--...
- |
+-- NOTICE
|
- +-- LICENSE</p>
-<p>/opt/apacheds-<version>/bin/apacheds $1 <instance></p>
-<p>/opt/apacheds-2.0.0-M19
-/var/lib/apacheds-2.0.0-M19</p>
+ +-- LICENSE
+</PRE>
+
+<h2 id="starting-ther-server">Starting ther server</h2>
+<p>THere are three ways to start the server :</p>
+<ul>
+<li>as a daemon : in this case, the server is automatically started when the machine is started.</li>
+<li>starting the daemon from /etc/init.d manually</li>
+<li>starting the server from /opt/apacheds-<version>/bin</li>
+</ul>
+<p>The most convenient is obviously to let the server starts <em>apacheDS</em> automatically when the server is started. It's enough to launch this command once the installation has been done :</p>
+<div class="codehilite"><pre>$ <span class="n">sudo</span> <span class="n">su</span>
+$ <span class="n">cd</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="n">update</span><span class="o">-</span><span class="n">rc</span><span class="p">.</span><span class="n">d</span> <span class="n">apacheds</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">default</span> <span class="n">defaults</span>
+<span class="n">Adding</span> <span class="n">system</span> <span class="n">startup</span> <span class="k">for</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>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">default</span> <span class="p">...</span>
+<span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">rc0</span><span class="p">.</span><span class="n">d</span><span class="o">/</span><span class="n">K20apacheds</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">default</span> <span class="o">-></span> <span class="p">.</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>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">default</span>
+<span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">rc1</span><span class="p">.</span><span class="n">d</span><span class="o">/</span><span class="n">K20apacheds</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">default</span> <span class="o">-></span> <span class="p">.</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>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">default</span>
+<span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">rc6</span><span class="p">.</span><span class="n">d</span><span class="o">/</span><span class="n">K20apacheds</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">default</span> <span class="o">-></span> <span class="p">.</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>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">default</span>
+<span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">rc2</span><span class="p">.</span><span class="n">d</span><span class="o">/</span><span class="n">S20apacheds</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">default</span> <span class="o">-></span> <span class="p">.</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>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">default</span>
+<span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">rc3</span><span class="p">.</span><span class="n">d</span><span class="o">/</span><span class="n">S20apacheds</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">default</span> <span class="o">-></span> <span class="p">.</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>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">default</span>
+<span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">rc4</span><span class="p">.</span><span class="n">d</span><span class="o">/</span><span class="n">S20apacheds</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">default</span> <span class="o">-></span> <span class="p">.</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>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">default</span>
+<span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">rc5</span><span class="p">.</span><span class="n">d</span><span class="o">/</span><span class="n">S20apacheds</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">default</span> <span class="o">-></span> <span class="p">.</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>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">default</span>
+</pre></div>
+
+
+<p>Otherwise, starting the server using option 2 is all about typing this command line :</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>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">default</span> <span class="n">start</span>
+</pre></div>
+
+
+<p>This will start the default instance. Would you like to have more than one instance of the server installed, then you'll have to modify this script.</p>
+<p>Starting the server using the <em>apacheds</em> script requires that you provide a third parameter : the instance to run.</p>
+<div class="codehilite"><pre>$ <span class="n">sudo</span> <span class="o">/</span><span class="n">opt</span><span class="o">/</span><span class="n">apacheds</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">bin</span><span class="o">/</span><span class="n">apacheds</span> <span class="n">start</span> <span class="n">default</span>
+</pre></div>
+
+
<h2 id="bin-directory">bin directory</h2>
-<p>The <em>bin</em> directory contains the binary used to launch the server. The wrapper starts the <em>apacheds</em> server, using the configuratio file <em>wrapper.conf</em>.</p>
+<p>The <em>bin</em> directory contains the binary used to launch the server. The <em>apacheds</em> script starts the <em>wrapper</em> executable, using the configuration file <em>wrapper.conf</em>.</p>
<h2 id="conf-directory">conf directory</h2>
-<p>This directory contain the wrapper configuration file.</p>
-<h3 id="wrapperconf-file">wrapper.conf file</h3>
-<p>This configuration file defines the default configuration for the <em>ApacheDS</em> server. Here are the parameters description</p>
+<p>This directory contain the wrapper configuration file. This is a description of its content.</p>
<table>
<thead>
<tr>
@@ -233,19 +258,19 @@
</thead>
<tbody>
<tr>
-<td></td>
-<td></td>
-<td></td>
+<td>wrapper.java.maxmemory</td>
+<td>The -Xmx JVM parameter</td>
+<td>2048m</td>
</tr>
<tr>
-<td></td>
-<td></td>
-<td></td>
+<td>wrapper.ping.timeout</td>
+<td>The delay after which we will consider the server as stalled</td>
+<td>240s (4 mins)</td>
</tr>
<tr>
-<td></td>
-<td></td>
-<td></td>
+<td>wrapper.startup.timeout</td>
+<td>The maximum delay allowed for the server to start</td>
+<td>120 secs</td>
</tr>
<tr>
<td></td>