directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From elecha...@apache.org
Subject svn commit: r1648988 - /directory/site/trunk/content/apacheds/advanced-ug/2.2.5-generic-instance-layout.mdtext
Date Fri, 02 Jan 2015 10:00:03 GMT
Author: elecharny
Date: Fri Jan  2 10:00:03 2015
New Revision: 1648988

URL: http://svn.apache.org/r1648988
Log:
Added the Archive installation documentation

Modified:
    directory/site/trunk/content/apacheds/advanced-ug/2.2.5-generic-instance-layout.mdtext

Modified: directory/site/trunk/content/apacheds/advanced-ug/2.2.5-generic-instance-layout.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/advanced-ug/2.2.5-generic-instance-layout.mdtext?rev=1648988&r1=1648987&r2=1648988&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/advanced-ug/2.2.5-generic-instance-layout.mdtext
(original)
+++ directory/site/trunk/content/apacheds/advanced-ug/2.2.5-generic-instance-layout.mdtext
Fri Jan  2 10:00:03 2015
@@ -23,4 +23,106 @@ Notice: Licensed to the Apache Software
     under the License.
 
 # 2.2.5 - Generic Instance Layout
-TODO...
+This installer just contain everything needed to start *ApacheDS* but it will not create
a daemon not a Windows Service. Would one like to start *ApacheDS*, it will have to start
the <em>apacheds.sh</em> or <em>apacheds.bat</bat> script shell.
+
+The installer is just a raeball that needs to be oepend and deflated at the selected position
 :
+
+    tar xzpf apacheds-<version>.tar.gz
+
+or
+
+    gunzip apacheds-<version>.zip
+
+
+The layout is quite simple :
+
+<PRE>
+ apacheds-<version>
+      |
+      +-- lib/
+      |    |
+      |    +-- apacheds-service-<version>.jar
+      |
+      +-- instances/
+      |    |
+      |    +-- default/
+      |         |    
+      |         +-- run/
+      |         |    
+      |         +-- partitions/
+      |         |    
+      |         +-- log/
+      |         |    
+      |         +-- conf/
+      |         |    |
+      |         |    +-- log4j.properties
+      |         |    |
+      |         |    +-- config.ldif
+      |         |
+      |         +-- cache/
+      |
+      +-- bin/
+      |    |
+      |    +-- apacheds.bat
+      |    |
+      |    +-- apacheds.sh
+      |    |
+      |    +-- cpappend.bat
+      |    
+      +-- NOTICE
+      |
+      +-- LICENSE
+</PRE>
+
+In order to start the server, you will have to make the shell script executable (it is not
by default):
+
+    $ chmod u+x apacheds-<version>/bin/apacheds.sh
+
+## Starting the server
+
+Starting the server is as simple as starting the script :
+
+    $ ./apacheds-<version>/bin/apacheds.sh start
+    Using ADS_HOME:    .../apacheds-<version>
+    Using JAVA_HOME:   /Library/Java/JavaVirtualMachines/jdk1.7.0_55.jdk/Contents/Home/
+
+    Starting ApacheDS instance 'default'...
+    $
+
+## Stopping the server
+
+The server is now started. To stop it, you have to execute this command :
+
+    $ ./apacheds-<version>/bin/apacheds.sh stop
+    Using ADS_HOME:    .../apacheds-<version>
+    Using JAVA_HOME:   /Library/Java/JavaVirtualMachines/jdk1.7.0_55.jdk/Contents/Home/
+
+    Stoping ApacheDS instance 'default' running as 23080
+    ApacheDS instance 'default' stopped successfully
+
+## Selection a different instance
+
+You can start many instances of the server, assuming you have duplicated the content of teh
<em>instances/default</em> directory, and modified the <em>instances/default/conf/config.ldif</em>
file (cahnge the transports so that there is no collision between servers)
+
+## Logs
+
+You can check what's going on in the <em>apacheds-<version>/instances/<instance-name>/log/apacheds.log</em>
file, which is created using the configuration set in <em>apacheds-<version>/instances/<instance-name>/conf/log4j.properties</em>.
+
+Typically, when you start the server, you will get such log :
+
+    $ more apacheds.log
+    [10:53:05] WARN [org.apache.directory.server.core.DefaultDirectoryService] - You didn't
change the admin password of directory service instance 'default'.  Please update the admin
password as soon as possible to prevent a possible security breach.
+
+and from the <em>apacheds-<version>/instances/<instance-name>/log/apacheds.out</em>
file, which contains everything the server writes on the console, you will read :
+
+    $ more apacheds.out 
+    [10:53:05] WARN [org.apache.directory.server.core.DefaultDirectoryService] - You didn't
change the admin password of directory service instance 'default'.  Please update the admin
password as soon as possible to prevent a possible security breach.
+               _                     _          ____  ____   
+              / \   _ __    ___  ___| |__   ___|  _ \/ ___|  
+             / _ \ | '_ \ / _` |/ __| '_ \ / _ \ | | \___ \  
+            / ___ \| |_) | (_| | (__| | | |  __/ |_| |___) | 
+           /_/   \_\ .__/ \__,_|\___|_| |_|\___|____/|____/  
+                   |_|                                       
+
+
+



Mime
View raw message