directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From elecha...@apache.org
Subject svn commit: r1648795 - /directory/site/trunk/content/apacheds/advanced-ug/2.2.2-rpm-instance-layout.mdtext
Date Thu, 01 Jan 2015 02:35:37 GMT
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
+
+



Mime
View raw message