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/01 20:42:50 UTC
svn commit: r934721 - in /websites/staging/directory/trunk/content: ./
apacheds/advanced-ug/2.2.1-debian-instance-layout.html
Author: buildbot
Date: Thu Jan 1 19:42:50 2015
New Revision: 934721
Log:
Staging update by buildbot for directory
Added:
websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.1-debian-instance-layout.html
Modified:
websites/staging/directory/trunk/content/ (props changed)
Propchange: websites/staging/directory/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Jan 1 19:42:50 2015
@@ -1 +1 @@
-1648927
+1648928
Added: 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 (added)
+++ websites/staging/directory/trunk/content/apacheds/advanced-ug/2.2.1-debian-instance-layout.html Thu Jan 1 19:42:50 2015
@@ -0,0 +1,351 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+ <head>
+ <title>2.2.1 - Debian Instance Layout — Apache Directory</title>
+
+ <link href="./../../css/common.css" rel="stylesheet" type="text/css">
+ <link href="./../../css/green.css" rel="stylesheet" type="text/css">
+
+
+ <link rel="shortcut icon" href="./../../images/server-icon_16x16.png">
+
+ <!-- Google Analytics -->
+ <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+ <script type="text/javascript">
+ _uacct = "UA-1358462-1";
+ urchinTracker();
+ </script>
+ </head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../../">
+
+ Apache Directory Project
+
+ </a>
+ |
+ <a href="./../../apacheds">
+
+ <STRONG>ApacheDS</STRONG>
+
+ </a>
+ |
+ <a href="./../../studio">
+
+ Apache Directory Studio
+
+ </a>
+ |
+ <a href="./../../api">
+
+ Apache LDAP API
+
+ </a>
+ |
+ <a href="./../../mavibot">
+
+ Mavibot
+
+ </a>
+ |
+ <a href="./../../escimo">
+
+ eSCIMo
+
+ </a>
+ |
+ <a href="./../../fortress">
+
+ Fortress
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+<div id="navigation">
+
+ <!--ul>
+ <li>
+ <a href="http://bit.ly/1n9YlQT" target="_blank">
+ <img src="./../../images/ApacheConBudapest.png" width="125" height="125" alt="I'm Speaking at ApacheCon Europe 2014! Join me!" title="I'm Speaking at ApacheCon Europe 2014! Join me!" border="0" style="margin-bottom:-3px;"/>
+ </a>
+ </li>
+ </ul-->
+ <h5>ApacheDS 2.0</h5>
+ <ul>
+ <li><a href="./../../apacheds/">Home</a></li>
+ <li><a href="./../../apacheds/news.html">News</a></li>
+ <li><a href="./../../apacheds/features.html">Features</a></li>
+ </ul>
+ <h5>Downloads</h5>
+ <ul>
+ <li><a href="./../../apacheds/downloads.html">ApacheDS 2.0.0-M19</a> <img src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../apacheds/download-old-versions.html">Older versions</a></li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+ <li><a href="./../../apacheds/basic-user-guide.html">Basic User Guide </a></li>
+ <li><a href="./../../apacheds/advanced-user-guide.html">Advanced User Guide</a></li>
+ <li><a href="./../../apacheds/developer-guide.html">Developer Guide</a></li>
+ <li><a href="./../../apacheds/kerberos-user-guide.html">Kerberos User Guide</a></li>
+ <li><a href="./../../apacheds/configuration/ads-2.0-configuration.html">Configuration</a></li>
+ <li><a href="./../../apacheds/gen-docs/latest/apidocs">JavaDocs</a></li>
+ <li><a href="./../../apacheds/gen-docs/latest/xref">Cross-Reference</a></li>
+ </ul>
+
+
+ <h5>Support</h5>
+ <ul>
+ <li><a href="./../../mailing-lists-and-irc.html">Mailing Lists & IRC</a></li>
+ <li><a href="./../../sources.html">Sources</a></li>
+ <li><a href="./../../issue-tracking.html">Issue Tracking</a></li>
+ <li><a href="./../../commercial-support.html">Commercial Support</a></li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li><a href="./../../contribute.html">How to Contribute</a></li>
+ <li><a href="./../../team.html">Team</a></li>
+ <li><a href="./../../original-project-proposal.html">Original Project Proposal</a></li>
+ <li><a href="./../../special-thanks.html" class="external-link" rel="nofollow">Special Thanks</a></li>
+ </ul>
+ <h5>About Apache</h5>
+ <ul>
+ <li><a href="http://www.apache.org/">Apache</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+
+</div><!-- navigation -->
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+ <div class="nav">
+ <div class="nav_prev">
+
+ <a href="2.2-instance-layout.html">2.2 - Instance Layout</a>
+
+ </div>
+ <div class="nav_up">
+
+ <a href="2.2-instance-layout.html">2.2 Instance Layout</a>
+
+ </div>
+ <div class="nav_next">
+
+ <a href="2.2.2-rpm-instance-layout.html">2.2.2 - RPM Instance Layout</a>
+
+ </div>
+ <div class="clearfix"></div>
+ </div>
+
+
+<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>
+
+<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>
+</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>
+
+<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>
+<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">
+
+ <a href="2.2-instance-layout.html">2.2 - Instance Layout</a>
+
+ </div>
+ <div class="nav_up">
+
+ <a href="2.2-instance-layout.html">2.2 Instance Layout</a>
+
+ </div>
+ <div class="nav_next">
+
+ <a href="2.2.2-rpm-instance-layout.html">2.2.2 - RPM Instance Layout</a>
+
+ </div>
+ <div class="clearfix"></div>
+ </div>
+
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2014, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="./../../privacy-policy.html">Privacy Policy</a><br />
+ Apache Directory, ApacheDS, Apache Directory Server, Apache Directory Studio, Apache LDAP API, Apache Triplesec, Triplesec, Apache Mavibot, Mavibot, Apache eSCIMo, eSCIMo, Fortress, Apache Fortress, EnMasse,
+ Apache EnMasse, Apache, the Apache feather logo, and the Apache Directory project logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
\ No newline at end of file