You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by el...@apache.org on 2015/01/01 03:35:37 UTC
svn commit: r1648795 -
/directory/site/trunk/content/apacheds/advanced-ug/2.2.2-rpm-instance-layout.mdtext
Author: elecharny
Date: Thu Jan 1 02:35:36 2015
New Revision: 1648795
URL: http://svn.apache.org/r1648795
Log:
Updated the RPM instance doco
Modified:
directory/site/trunk/content/apacheds/advanced-ug/2.2.2-rpm-instance-layout.mdtext
Modified: directory/site/trunk/content/apacheds/advanced-ug/2.2.2-rpm-instance-layout.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/advanced-ug/2.2.2-rpm-instance-layout.mdtext?rev=1648795&r1=1648794&r2=1648795&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/advanced-ug/2.2.2-rpm-instance-layout.mdtext (original)
+++ directory/site/trunk/content/apacheds/advanced-ug/2.2.2-rpm-instance-layout.mdtext Thu Jan 1 02:35:36 2015
@@ -24,4 +24,164 @@ Notice: Licensed to the Apache Software
# 2.23.2 - ![RPM](images/rpm.png) RPM Instance Layout
-TODO...
\ No newline at end of file
+When you run the installer on your RPM based system, it will install the server on your disk, using this layout :
+
+<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>
+
+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 :
+
+ $ sudo /etc/init.d/apacheds-<version> start <instance>
+
+The default instance name is 'default'.
+
+All the data for a given instance are stored into this <em>/var/lib/apacheds-<version><em> directory.
+
+## Configuring each instance
+
+You can configure a specific settings. This is done by modifying the configuration files in <em>/var/lib/apacheds-<version>/<instance></em>.
+
+### JVM setting
+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 :
+
+ ##
+ ## In this file you can override parameters specified in the default
+ ## Apache Directory Server config file which is usually at
+ ## /opt/apacheds-2.0.0-M20-SNAPSHOT/conf/wrapper.conf
+ ##
+ ## See also http://wrapper.tanukisoftware.org/doc/english/properties.html
+ ## For a list of properties that can be set.
+ ##
+
+ ## Override the JRE used
+ # wrapper.java.command=<path-to-java-executable>
+
+ ## Override the JVM memory settings
+ ## Initial Java Heap Size (in MB)
+ # wrapper.java.initmemory=1024
+
+ ## Maximum Java Heap Size (in MB)
+ # wrapper.java.maxmemory=2048
+
+You mainly want to change the memory used by the JVM.
+
+### Log configuration
+
+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.
+
+The default configuration is given below :
+
+ 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=${apacheds.log.dir}/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
+
+