directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From elecha...@apache.org
Subject svn commit: r1403310 - in /directory/site/trunk/content/apacheds: ./ basic-ug/
Date Mon, 29 Oct 2012 14:25:43 GMT
Author: elecharny
Date: Mon Oct 29 14:25:42 2012
New Revision: 1403310

URL: http://svn.apache.org/viewvc?rev=1403310&view=rev
Log:
Fixed links, added empty pages

Added:
    directory/site/trunk/content/apacheds/basic-ug/1.4.2-changing-admin-password.mdtext
    directory/site/trunk/content/apacheds/basic-ug/1.4.3-adding-partition.mdtext
    directory/site/trunk/content/apacheds/basic-ug/1.4.4-configure-logging.mdtext
    directory/site/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.mdtext
    directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext
    directory/site/trunk/content/apacheds/basic-ug/2-sample-configuration.mdtext
    directory/site/trunk/content/apacheds/basic-ug/3-basic-security.mdtext
    directory/site/trunk/content/apacheds/basic-ug/3.1-authentication-options.mdtext
    directory/site/trunk/content/apacheds/basic-ug/3.2-basic-authorization.mdtext
    directory/site/trunk/content/apacheds/basic-ug/3.3-enabling-ssl.mdtext
    directory/site/trunk/content/apacheds/basic-ug/4-integrating-apacheds.mdtext
    directory/site/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.mdtext
Modified:
    directory/site/trunk/content/apacheds/basic-ug/1.4-basic-configuration-tasks.mdtext
    directory/site/trunk/content/apacheds/basic-users-guide.mdtext

Modified: directory/site/trunk/content/apacheds/basic-ug/1.4-basic-configuration-tasks.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1.4-basic-configuration-tasks.mdtext?rev=1403310&r1=1403309&r2=1403310&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1.4-basic-configuration-tasks.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/1.4-basic-configuration-tasks.mdtext Mon Oct 29 14:25:42 2012
@@ -23,9 +23,9 @@ Notice: Licensed to the Apache Software 
     under the License.
 
 # 1.4 - Basic configuration tasks
-* [1.4.1 - Changing the server port for LDAP](basic-ug/1.4.1-changing-server-port.html)
-* [1.4.2 - Changing the admin password](basic-ug/1.4.2-changing-admin-password.html)
-* [1.4.3 - Adding your own partition resp. suffix](basic-ug/1.4.3-adding-partition.html)
-* [1.4.4 - Configure logging](basic-ug/1.4.4-configure-logging.html)
-* [1.4.5 - Enable and disable anonymous access](basic-ug/1.4.5-anonymous-access.html)
+* [1.4.1 - Changing the server port for LDAP](1.4.1-changing-server-port.html)
+* [1.4.2 - Changing the admin password](1.4.2-changing-admin-password.html)
+* [1.4.3 - Adding your own partition resp. suffix](1.4.3-adding-partition.html)
+* [1.4.4 - Configure logging](1.4.4-configure-logging.html)
+* [1.4.5 - Enable and disable anonymous access](1.4.5-anonymous-access.html)
 

Added: directory/site/trunk/content/apacheds/basic-ug/1.4.2-changing-admin-password.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1.4.2-changing-admin-password.mdtext?rev=1403310&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1.4.2-changing-admin-password.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/1.4.2-changing-admin-password.mdtext Mon Oct 29 14:25:42 2012
@@ -0,0 +1,27 @@
+Title: 1.4.2 - Changing the admin password
+NavPrev: 1.4.1-changing-server-port.html
+NavPrevText: 1.4.1 - Changing the server port for LDAP
+NavUp: 1.4-basic-configuration-tasks.html
+NavUpText: 1.4 - Basic configuration tasks
+NavNext: 1.4.3-adding-partition.html
+NavNextText: 1.4.3 - Adding your own partition resp. suffix
+Notice: 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.
+
+# 1.4.2 - Changing the admin password
+
+TODO
\ No newline at end of file

Added: directory/site/trunk/content/apacheds/basic-ug/1.4.3-adding-partition.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1.4.3-adding-partition.mdtext?rev=1403310&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1.4.3-adding-partition.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/1.4.3-adding-partition.mdtext Mon Oct 29 14:25:42 2012
@@ -0,0 +1,27 @@
+Title: 1.4.3 - Adding your own partition resp. suffix
+NavPrev: 1.4.2-changing-admin-password.html
+NavprevText: 1.4.2 - Changing the admin password
+NavUp: 1.4-basic-configuration-tasks.html
+NavUpText: 1.4 - Basic configuration tasks
+NavNext: 1.4.4-configure-logging.html
+NavNextText: 1.4.4 - Configure logging
+Notice: 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.
+
+# 1.4.3 - Adding your own partition resp. suffix
+
+TODO
\ No newline at end of file

Added: directory/site/trunk/content/apacheds/basic-ug/1.4.4-configure-logging.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1.4.4-configure-logging.mdtext?rev=1403310&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1.4.4-configure-logging.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/1.4.4-configure-logging.mdtext Mon Oct 29 14:25:42 2012
@@ -0,0 +1,27 @@
+Title: 1.4.4 - Configure logging
+NavPrev: 1.4.3-adding-partition.html
+NavprevText: 1.4.3 - Adding your own partition resp. suffix
+NavUp: 1.4-basic-configuration-tasks.html
+NavUpText: 1.4 - Basic configuration tasks
+NavNext: 1.4.5-anonymous-access.html
+NavNextText: 1.4.5 - Enable and disable anonymous access
+Notice: 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.
+
+# 1.4.4 - Configure logging
+
+TODO
\ No newline at end of file

Added: directory/site/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.mdtext?rev=1403310&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/1.4.5-anonymous-access.mdtext Mon Oct 29 14:25:42 2012
@@ -0,0 +1,25 @@
+Title: 1.4.5 - Enable and disable anonymous access
+NavPrev: 1.4.4-configure-logging.html
+NavprevText: 1.4.4 - Configure logging
+NavUp: 1.4-basic-configuration-tasks.html
+NavUpText: 1.4 - Basic configuration tasks
+Notice: 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.
+
+# 1.4.5 - Enable and disable anonymous access
+
+TODO
\ No newline at end of file

Added: directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext?rev=1403310&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/1.5-sample-configuration.mdtext Mon Oct 29 14:25:42 2012
@@ -0,0 +1,131 @@
+Title: 1.4.1 - Changing the server port for LDAP
+NavUp: 1.4-basic-configuration-tasks.html
+NavUpText: 1.4 - Basic configuration tasks
+NavNext: 1.4.2-changing-admin-password.html
+NavNextText: 1.4.2 - Changing the admin password
+Notice: 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.
+
+# 1.4.1 - Changing the server port for LDAP
+
+This section describes how to change to port for the LDAP protocol. There are two ways to do that : either you use the configuration plugin available in **Apache Directory Studio**, or you update the LDIF partition that contains the configuration.
+
+[TOC]
+
+## The task and how to accomplish it
+
+By default the LDAP server listens on port 10389 (unencrypted or StartTLS) and 10636 (SSL). It is quite common to run LDAP on 389, which is the well-known port for this protocol, but that requires the server to be started with a root user (or with sudo). Of course other options are imaginable as well. Changing the LDAP port is a good example for adjusting the existing Spring configuration as introduced in the last section.
+
+<DIV class="note" markdown="1">
+Due to traditional Unix security restrictions, ports less than 1024 were "trusted". Thus on a Unix-System, a non-root process must listen on a port greater than 1023.
+</DIV>
+
+
+Basically, there are two cases :
+* The server is not started
+* The server is started
+
+We will see how to change the port in those two cases.
+
+### Using Apache Directory Studio
+
+#### The server is started
+
+The best solution is to connect on the server using Studio, and to open it's configuration :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config1.png)
+</CENTER>
+
+When you select this menu, you will get the main configuration screen, containing the port for LDAP and LDAPS :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+
+Now, change the values of _port_ to your needs, then save the configuration. You have to restart the server afterwards in order to take this change into effect.
+
+#### The server is not started
+
+You can start it and update the configuration, of course. But if you want to configure the server when it's stopped, you will have to load the configuration file, which is on _.../instances/default/conf/config.ldif_, when the server has been installed using the default setting.
+
+Opening this file will open the exact same window :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+You can update the _ports_ and save the file.
+
+<DIV class="warning" markdown="1">
+	Note that you will requite write access on this file !
+</DIV>
+
+### Modifying the configuration LDIF partition
+
+All the **ApacheDS** configuration is stored as a LDIF file, and can be modified either using a text editor (although we don't consider this as a safe practice) or using a Modify request on a running server. 
+
+<DIV class="info" markdown="1">
+	Modifying the configuration on a running server will **not** change the listening port of the running server. You will have to relaunch the server in order to get this new configuration to be available.
+</DIV>
+
+
+The configuration is stored as a set of LDAP entries, so you can update one of them. In order to modify the entry containing the ports, you have first to find it, and second to send a valid modify request.
+
+All the **ApacheDS** configuration is stored under the _ou=config_ partition. The ports are stored in some entries under _DN: ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ads-directoryServiceId=default,ou=config_ (obviously, dependning on your installation, this DN might change : the _ads-directoryServiceId_ may have a different name, so is the _ads-serverId_). In any case, the _ou=transports_ branch contains two entries :
+
+for LDAP :
+
+	dn: ads-transportid=ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ad
+	 s-directoryServiceId=default,ou=config
+	ads-systemport: 10389
+	ads-enabled: TRUE
+	ads-transportnbthreads: 8
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldap
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	 
+and for LDAPS :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,a
+	 ds-directoryServiceId=default,ou=config
+	ads-systemport: 10636
+	ads-transportenablessl: TRUE
+	ads-enabled: TRUE
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldaps
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	
+You just have to send a ModifyRequest using such a LDIF :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,ads
+	 -directoryServiceId=default,ou=config
+	changetype: modify
+	replace: ads-systemport
+	ads-systemport: 10637
+	-
+
+(here, we have modified the LDAPS Port from 10636 to 10637)
+
+Those modification can be done directly on the _config.ldif_ file, but you won't have any syntax check if you do so.
\ No newline at end of file

Added: directory/site/trunk/content/apacheds/basic-ug/2-sample-configuration.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/2-sample-configuration.mdtext?rev=1403310&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/2-sample-configuration.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/2-sample-configuration.mdtext Mon Oct 29 14:25:42 2012
@@ -0,0 +1,131 @@
+Title: 1.4.1 - Changing the server port for LDAP
+NavUp: 1.4-basic-configuration-tasks.html
+NavUpText: 1.4 - Basic configuration tasks
+NavNext: 1.4.2-changing-admin-password.html
+NavNextText: 1.4.2 - Changing the admin password
+Notice: 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.
+
+# 1.4.1 - Changing the server port for LDAP
+
+This section describes how to change to port for the LDAP protocol. There are two ways to do that : either you use the configuration plugin available in **Apache Directory Studio**, or you update the LDIF partition that contains the configuration.
+
+[TOC]
+
+## The task and how to accomplish it
+
+By default the LDAP server listens on port 10389 (unencrypted or StartTLS) and 10636 (SSL). It is quite common to run LDAP on 389, which is the well-known port for this protocol, but that requires the server to be started with a root user (or with sudo). Of course other options are imaginable as well. Changing the LDAP port is a good example for adjusting the existing Spring configuration as introduced in the last section.
+
+<DIV class="note" markdown="1">
+Due to traditional Unix security restrictions, ports less than 1024 were "trusted". Thus on a Unix-System, a non-root process must listen on a port greater than 1023.
+</DIV>
+
+
+Basically, there are two cases :
+* The server is not started
+* The server is started
+
+We will see how to change the port in those two cases.
+
+### Using Apache Directory Studio
+
+#### The server is started
+
+The best solution is to connect on the server using Studio, and to open it's configuration :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config1.png)
+</CENTER>
+
+When you select this menu, you will get the main configuration screen, containing the port for LDAP and LDAPS :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+
+Now, change the values of _port_ to your needs, then save the configuration. You have to restart the server afterwards in order to take this change into effect.
+
+#### The server is not started
+
+You can start it and update the configuration, of course. But if you want to configure the server when it's stopped, you will have to load the configuration file, which is on _.../instances/default/conf/config.ldif_, when the server has been installed using the default setting.
+
+Opening this file will open the exact same window :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+You can update the _ports_ and save the file.
+
+<DIV class="warning" markdown="1">
+	Note that you will requite write access on this file !
+</DIV>
+
+### Modifying the configuration LDIF partition
+
+All the **ApacheDS** configuration is stored as a LDIF file, and can be modified either using a text editor (although we don't consider this as a safe practice) or using a Modify request on a running server. 
+
+<DIV class="info" markdown="1">
+	Modifying the configuration on a running server will **not** change the listening port of the running server. You will have to relaunch the server in order to get this new configuration to be available.
+</DIV>
+
+
+The configuration is stored as a set of LDAP entries, so you can update one of them. In order to modify the entry containing the ports, you have first to find it, and second to send a valid modify request.
+
+All the **ApacheDS** configuration is stored under the _ou=config_ partition. The ports are stored in some entries under _DN: ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ads-directoryServiceId=default,ou=config_ (obviously, dependning on your installation, this DN might change : the _ads-directoryServiceId_ may have a different name, so is the _ads-serverId_). In any case, the _ou=transports_ branch contains two entries :
+
+for LDAP :
+
+	dn: ads-transportid=ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ad
+	 s-directoryServiceId=default,ou=config
+	ads-systemport: 10389
+	ads-enabled: TRUE
+	ads-transportnbthreads: 8
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldap
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	 
+and for LDAPS :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,a
+	 ds-directoryServiceId=default,ou=config
+	ads-systemport: 10636
+	ads-transportenablessl: TRUE
+	ads-enabled: TRUE
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldaps
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	
+You just have to send a ModifyRequest using such a LDIF :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,ads
+	 -directoryServiceId=default,ou=config
+	changetype: modify
+	replace: ads-systemport
+	ads-systemport: 10637
+	-
+
+(here, we have modified the LDAPS Port from 10636 to 10637)
+
+Those modification can be done directly on the _config.ldif_ file, but you won't have any syntax check if you do so.
\ No newline at end of file

Added: directory/site/trunk/content/apacheds/basic-ug/3-basic-security.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/3-basic-security.mdtext?rev=1403310&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/3-basic-security.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/3-basic-security.mdtext Mon Oct 29 14:25:42 2012
@@ -0,0 +1,131 @@
+Title: 1.4.1 - Changing the server port for LDAP
+NavUp: 1.4-basic-configuration-tasks.html
+NavUpText: 1.4 - Basic configuration tasks
+NavNext: 1.4.2-changing-admin-password.html
+NavNextText: 1.4.2 - Changing the admin password
+Notice: 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.
+
+# 1.4.1 - Changing the server port for LDAP
+
+This section describes how to change to port for the LDAP protocol. There are two ways to do that : either you use the configuration plugin available in **Apache Directory Studio**, or you update the LDIF partition that contains the configuration.
+
+[TOC]
+
+## The task and how to accomplish it
+
+By default the LDAP server listens on port 10389 (unencrypted or StartTLS) and 10636 (SSL). It is quite common to run LDAP on 389, which is the well-known port for this protocol, but that requires the server to be started with a root user (or with sudo). Of course other options are imaginable as well. Changing the LDAP port is a good example for adjusting the existing Spring configuration as introduced in the last section.
+
+<DIV class="note" markdown="1">
+Due to traditional Unix security restrictions, ports less than 1024 were "trusted". Thus on a Unix-System, a non-root process must listen on a port greater than 1023.
+</DIV>
+
+
+Basically, there are two cases :
+* The server is not started
+* The server is started
+
+We will see how to change the port in those two cases.
+
+### Using Apache Directory Studio
+
+#### The server is started
+
+The best solution is to connect on the server using Studio, and to open it's configuration :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config1.png)
+</CENTER>
+
+When you select this menu, you will get the main configuration screen, containing the port for LDAP and LDAPS :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+
+Now, change the values of _port_ to your needs, then save the configuration. You have to restart the server afterwards in order to take this change into effect.
+
+#### The server is not started
+
+You can start it and update the configuration, of course. But if you want to configure the server when it's stopped, you will have to load the configuration file, which is on _.../instances/default/conf/config.ldif_, when the server has been installed using the default setting.
+
+Opening this file will open the exact same window :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+You can update the _ports_ and save the file.
+
+<DIV class="warning" markdown="1">
+	Note that you will requite write access on this file !
+</DIV>
+
+### Modifying the configuration LDIF partition
+
+All the **ApacheDS** configuration is stored as a LDIF file, and can be modified either using a text editor (although we don't consider this as a safe practice) or using a Modify request on a running server. 
+
+<DIV class="info" markdown="1">
+	Modifying the configuration on a running server will **not** change the listening port of the running server. You will have to relaunch the server in order to get this new configuration to be available.
+</DIV>
+
+
+The configuration is stored as a set of LDAP entries, so you can update one of them. In order to modify the entry containing the ports, you have first to find it, and second to send a valid modify request.
+
+All the **ApacheDS** configuration is stored under the _ou=config_ partition. The ports are stored in some entries under _DN: ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ads-directoryServiceId=default,ou=config_ (obviously, dependning on your installation, this DN might change : the _ads-directoryServiceId_ may have a different name, so is the _ads-serverId_). In any case, the _ou=transports_ branch contains two entries :
+
+for LDAP :
+
+	dn: ads-transportid=ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ad
+	 s-directoryServiceId=default,ou=config
+	ads-systemport: 10389
+	ads-enabled: TRUE
+	ads-transportnbthreads: 8
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldap
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	 
+and for LDAPS :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,a
+	 ds-directoryServiceId=default,ou=config
+	ads-systemport: 10636
+	ads-transportenablessl: TRUE
+	ads-enabled: TRUE
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldaps
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	
+You just have to send a ModifyRequest using such a LDIF :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,ads
+	 -directoryServiceId=default,ou=config
+	changetype: modify
+	replace: ads-systemport
+	ads-systemport: 10637
+	-
+
+(here, we have modified the LDAPS Port from 10636 to 10637)
+
+Those modification can be done directly on the _config.ldif_ file, but you won't have any syntax check if you do so.
\ No newline at end of file

Added: directory/site/trunk/content/apacheds/basic-ug/3.1-authentication-options.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/3.1-authentication-options.mdtext?rev=1403310&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/3.1-authentication-options.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/3.1-authentication-options.mdtext Mon Oct 29 14:25:42 2012
@@ -0,0 +1,131 @@
+Title: 1.4.1 - Changing the server port for LDAP
+NavUp: 1.4-basic-configuration-tasks.html
+NavUpText: 1.4 - Basic configuration tasks
+NavNext: 1.4.2-changing-admin-password.html
+NavNextText: 1.4.2 - Changing the admin password
+Notice: 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.
+
+# 1.4.1 - Changing the server port for LDAP
+
+This section describes how to change to port for the LDAP protocol. There are two ways to do that : either you use the configuration plugin available in **Apache Directory Studio**, or you update the LDIF partition that contains the configuration.
+
+[TOC]
+
+## The task and how to accomplish it
+
+By default the LDAP server listens on port 10389 (unencrypted or StartTLS) and 10636 (SSL). It is quite common to run LDAP on 389, which is the well-known port for this protocol, but that requires the server to be started with a root user (or with sudo). Of course other options are imaginable as well. Changing the LDAP port is a good example for adjusting the existing Spring configuration as introduced in the last section.
+
+<DIV class="note" markdown="1">
+Due to traditional Unix security restrictions, ports less than 1024 were "trusted". Thus on a Unix-System, a non-root process must listen on a port greater than 1023.
+</DIV>
+
+
+Basically, there are two cases :
+* The server is not started
+* The server is started
+
+We will see how to change the port in those two cases.
+
+### Using Apache Directory Studio
+
+#### The server is started
+
+The best solution is to connect on the server using Studio, and to open it's configuration :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config1.png)
+</CENTER>
+
+When you select this menu, you will get the main configuration screen, containing the port for LDAP and LDAPS :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+
+Now, change the values of _port_ to your needs, then save the configuration. You have to restart the server afterwards in order to take this change into effect.
+
+#### The server is not started
+
+You can start it and update the configuration, of course. But if you want to configure the server when it's stopped, you will have to load the configuration file, which is on _.../instances/default/conf/config.ldif_, when the server has been installed using the default setting.
+
+Opening this file will open the exact same window :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+You can update the _ports_ and save the file.
+
+<DIV class="warning" markdown="1">
+	Note that you will requite write access on this file !
+</DIV>
+
+### Modifying the configuration LDIF partition
+
+All the **ApacheDS** configuration is stored as a LDIF file, and can be modified either using a text editor (although we don't consider this as a safe practice) or using a Modify request on a running server. 
+
+<DIV class="info" markdown="1">
+	Modifying the configuration on a running server will **not** change the listening port of the running server. You will have to relaunch the server in order to get this new configuration to be available.
+</DIV>
+
+
+The configuration is stored as a set of LDAP entries, so you can update one of them. In order to modify the entry containing the ports, you have first to find it, and second to send a valid modify request.
+
+All the **ApacheDS** configuration is stored under the _ou=config_ partition. The ports are stored in some entries under _DN: ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ads-directoryServiceId=default,ou=config_ (obviously, dependning on your installation, this DN might change : the _ads-directoryServiceId_ may have a different name, so is the _ads-serverId_). In any case, the _ou=transports_ branch contains two entries :
+
+for LDAP :
+
+	dn: ads-transportid=ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ad
+	 s-directoryServiceId=default,ou=config
+	ads-systemport: 10389
+	ads-enabled: TRUE
+	ads-transportnbthreads: 8
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldap
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	 
+and for LDAPS :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,a
+	 ds-directoryServiceId=default,ou=config
+	ads-systemport: 10636
+	ads-transportenablessl: TRUE
+	ads-enabled: TRUE
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldaps
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	
+You just have to send a ModifyRequest using such a LDIF :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,ads
+	 -directoryServiceId=default,ou=config
+	changetype: modify
+	replace: ads-systemport
+	ads-systemport: 10637
+	-
+
+(here, we have modified the LDAPS Port from 10636 to 10637)
+
+Those modification can be done directly on the _config.ldif_ file, but you won't have any syntax check if you do so.
\ No newline at end of file

Added: directory/site/trunk/content/apacheds/basic-ug/3.2-basic-authorization.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/3.2-basic-authorization.mdtext?rev=1403310&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/3.2-basic-authorization.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/3.2-basic-authorization.mdtext Mon Oct 29 14:25:42 2012
@@ -0,0 +1,131 @@
+Title: 1.4.1 - Changing the server port for LDAP
+NavUp: 1.4-basic-configuration-tasks.html
+NavUpText: 1.4 - Basic configuration tasks
+NavNext: 1.4.2-changing-admin-password.html
+NavNextText: 1.4.2 - Changing the admin password
+Notice: 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.
+
+# 1.4.1 - Changing the server port for LDAP
+
+This section describes how to change to port for the LDAP protocol. There are two ways to do that : either you use the configuration plugin available in **Apache Directory Studio**, or you update the LDIF partition that contains the configuration.
+
+[TOC]
+
+## The task and how to accomplish it
+
+By default the LDAP server listens on port 10389 (unencrypted or StartTLS) and 10636 (SSL). It is quite common to run LDAP on 389, which is the well-known port for this protocol, but that requires the server to be started with a root user (or with sudo). Of course other options are imaginable as well. Changing the LDAP port is a good example for adjusting the existing Spring configuration as introduced in the last section.
+
+<DIV class="note" markdown="1">
+Due to traditional Unix security restrictions, ports less than 1024 were "trusted". Thus on a Unix-System, a non-root process must listen on a port greater than 1023.
+</DIV>
+
+
+Basically, there are two cases :
+* The server is not started
+* The server is started
+
+We will see how to change the port in those two cases.
+
+### Using Apache Directory Studio
+
+#### The server is started
+
+The best solution is to connect on the server using Studio, and to open it's configuration :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config1.png)
+</CENTER>
+
+When you select this menu, you will get the main configuration screen, containing the port for LDAP and LDAPS :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+
+Now, change the values of _port_ to your needs, then save the configuration. You have to restart the server afterwards in order to take this change into effect.
+
+#### The server is not started
+
+You can start it and update the configuration, of course. But if you want to configure the server when it's stopped, you will have to load the configuration file, which is on _.../instances/default/conf/config.ldif_, when the server has been installed using the default setting.
+
+Opening this file will open the exact same window :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+You can update the _ports_ and save the file.
+
+<DIV class="warning" markdown="1">
+	Note that you will requite write access on this file !
+</DIV>
+
+### Modifying the configuration LDIF partition
+
+All the **ApacheDS** configuration is stored as a LDIF file, and can be modified either using a text editor (although we don't consider this as a safe practice) or using a Modify request on a running server. 
+
+<DIV class="info" markdown="1">
+	Modifying the configuration on a running server will **not** change the listening port of the running server. You will have to relaunch the server in order to get this new configuration to be available.
+</DIV>
+
+
+The configuration is stored as a set of LDAP entries, so you can update one of them. In order to modify the entry containing the ports, you have first to find it, and second to send a valid modify request.
+
+All the **ApacheDS** configuration is stored under the _ou=config_ partition. The ports are stored in some entries under _DN: ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ads-directoryServiceId=default,ou=config_ (obviously, dependning on your installation, this DN might change : the _ads-directoryServiceId_ may have a different name, so is the _ads-serverId_). In any case, the _ou=transports_ branch contains two entries :
+
+for LDAP :
+
+	dn: ads-transportid=ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ad
+	 s-directoryServiceId=default,ou=config
+	ads-systemport: 10389
+	ads-enabled: TRUE
+	ads-transportnbthreads: 8
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldap
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	 
+and for LDAPS :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,a
+	 ds-directoryServiceId=default,ou=config
+	ads-systemport: 10636
+	ads-transportenablessl: TRUE
+	ads-enabled: TRUE
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldaps
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	
+You just have to send a ModifyRequest using such a LDIF :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,ads
+	 -directoryServiceId=default,ou=config
+	changetype: modify
+	replace: ads-systemport
+	ads-systemport: 10637
+	-
+
+(here, we have modified the LDAPS Port from 10636 to 10637)
+
+Those modification can be done directly on the _config.ldif_ file, but you won't have any syntax check if you do so.
\ No newline at end of file

Added: directory/site/trunk/content/apacheds/basic-ug/3.3-enabling-ssl.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/3.3-enabling-ssl.mdtext?rev=1403310&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/3.3-enabling-ssl.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/3.3-enabling-ssl.mdtext Mon Oct 29 14:25:42 2012
@@ -0,0 +1,131 @@
+Title: 1.4.1 - Changing the server port for LDAP
+NavUp: 1.4-basic-configuration-tasks.html
+NavUpText: 1.4 - Basic configuration tasks
+NavNext: 1.4.2-changing-admin-password.html
+NavNextText: 1.4.2 - Changing the admin password
+Notice: 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.
+
+# 1.4.1 - Changing the server port for LDAP
+
+This section describes how to change to port for the LDAP protocol. There are two ways to do that : either you use the configuration plugin available in **Apache Directory Studio**, or you update the LDIF partition that contains the configuration.
+
+[TOC]
+
+## The task and how to accomplish it
+
+By default the LDAP server listens on port 10389 (unencrypted or StartTLS) and 10636 (SSL). It is quite common to run LDAP on 389, which is the well-known port for this protocol, but that requires the server to be started with a root user (or with sudo). Of course other options are imaginable as well. Changing the LDAP port is a good example for adjusting the existing Spring configuration as introduced in the last section.
+
+<DIV class="note" markdown="1">
+Due to traditional Unix security restrictions, ports less than 1024 were "trusted". Thus on a Unix-System, a non-root process must listen on a port greater than 1023.
+</DIV>
+
+
+Basically, there are two cases :
+* The server is not started
+* The server is started
+
+We will see how to change the port in those two cases.
+
+### Using Apache Directory Studio
+
+#### The server is started
+
+The best solution is to connect on the server using Studio, and to open it's configuration :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config1.png)
+</CENTER>
+
+When you select this menu, you will get the main configuration screen, containing the port for LDAP and LDAPS :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+
+Now, change the values of _port_ to your needs, then save the configuration. You have to restart the server afterwards in order to take this change into effect.
+
+#### The server is not started
+
+You can start it and update the configuration, of course. But if you want to configure the server when it's stopped, you will have to load the configuration file, which is on _.../instances/default/conf/config.ldif_, when the server has been installed using the default setting.
+
+Opening this file will open the exact same window :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+You can update the _ports_ and save the file.
+
+<DIV class="warning" markdown="1">
+	Note that you will requite write access on this file !
+</DIV>
+
+### Modifying the configuration LDIF partition
+
+All the **ApacheDS** configuration is stored as a LDIF file, and can be modified either using a text editor (although we don't consider this as a safe practice) or using a Modify request on a running server. 
+
+<DIV class="info" markdown="1">
+	Modifying the configuration on a running server will **not** change the listening port of the running server. You will have to relaunch the server in order to get this new configuration to be available.
+</DIV>
+
+
+The configuration is stored as a set of LDAP entries, so you can update one of them. In order to modify the entry containing the ports, you have first to find it, and second to send a valid modify request.
+
+All the **ApacheDS** configuration is stored under the _ou=config_ partition. The ports are stored in some entries under _DN: ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ads-directoryServiceId=default,ou=config_ (obviously, dependning on your installation, this DN might change : the _ads-directoryServiceId_ may have a different name, so is the _ads-serverId_). In any case, the _ou=transports_ branch contains two entries :
+
+for LDAP :
+
+	dn: ads-transportid=ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ad
+	 s-directoryServiceId=default,ou=config
+	ads-systemport: 10389
+	ads-enabled: TRUE
+	ads-transportnbthreads: 8
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldap
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	 
+and for LDAPS :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,a
+	 ds-directoryServiceId=default,ou=config
+	ads-systemport: 10636
+	ads-transportenablessl: TRUE
+	ads-enabled: TRUE
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldaps
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	
+You just have to send a ModifyRequest using such a LDIF :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,ads
+	 -directoryServiceId=default,ou=config
+	changetype: modify
+	replace: ads-systemport
+	ads-systemport: 10637
+	-
+
+(here, we have modified the LDAPS Port from 10636 to 10637)
+
+Those modification can be done directly on the _config.ldif_ file, but you won't have any syntax check if you do so.
\ No newline at end of file

Added: directory/site/trunk/content/apacheds/basic-ug/4-integrating-apacheds.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/4-integrating-apacheds.mdtext?rev=1403310&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/4-integrating-apacheds.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/4-integrating-apacheds.mdtext Mon Oct 29 14:25:42 2012
@@ -0,0 +1,131 @@
+Title: 1.4.1 - Changing the server port for LDAP
+NavUp: 1.4-basic-configuration-tasks.html
+NavUpText: 1.4 - Basic configuration tasks
+NavNext: 1.4.2-changing-admin-password.html
+NavNextText: 1.4.2 - Changing the admin password
+Notice: 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.
+
+# 1.4.1 - Changing the server port for LDAP
+
+This section describes how to change to port for the LDAP protocol. There are two ways to do that : either you use the configuration plugin available in **Apache Directory Studio**, or you update the LDIF partition that contains the configuration.
+
+[TOC]
+
+## The task and how to accomplish it
+
+By default the LDAP server listens on port 10389 (unencrypted or StartTLS) and 10636 (SSL). It is quite common to run LDAP on 389, which is the well-known port for this protocol, but that requires the server to be started with a root user (or with sudo). Of course other options are imaginable as well. Changing the LDAP port is a good example for adjusting the existing Spring configuration as introduced in the last section.
+
+<DIV class="note" markdown="1">
+Due to traditional Unix security restrictions, ports less than 1024 were "trusted". Thus on a Unix-System, a non-root process must listen on a port greater than 1023.
+</DIV>
+
+
+Basically, there are two cases :
+* The server is not started
+* The server is started
+
+We will see how to change the port in those two cases.
+
+### Using Apache Directory Studio
+
+#### The server is started
+
+The best solution is to connect on the server using Studio, and to open it's configuration :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config1.png)
+</CENTER>
+
+When you select this menu, you will get the main configuration screen, containing the port for LDAP and LDAPS :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+
+Now, change the values of _port_ to your needs, then save the configuration. You have to restart the server afterwards in order to take this change into effect.
+
+#### The server is not started
+
+You can start it and update the configuration, of course. But if you want to configure the server when it's stopped, you will have to load the configuration file, which is on _.../instances/default/conf/config.ldif_, when the server has been installed using the default setting.
+
+Opening this file will open the exact same window :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+You can update the _ports_ and save the file.
+
+<DIV class="warning" markdown="1">
+	Note that you will requite write access on this file !
+</DIV>
+
+### Modifying the configuration LDIF partition
+
+All the **ApacheDS** configuration is stored as a LDIF file, and can be modified either using a text editor (although we don't consider this as a safe practice) or using a Modify request on a running server. 
+
+<DIV class="info" markdown="1">
+	Modifying the configuration on a running server will **not** change the listening port of the running server. You will have to relaunch the server in order to get this new configuration to be available.
+</DIV>
+
+
+The configuration is stored as a set of LDAP entries, so you can update one of them. In order to modify the entry containing the ports, you have first to find it, and second to send a valid modify request.
+
+All the **ApacheDS** configuration is stored under the _ou=config_ partition. The ports are stored in some entries under _DN: ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ads-directoryServiceId=default,ou=config_ (obviously, dependning on your installation, this DN might change : the _ads-directoryServiceId_ may have a different name, so is the _ads-serverId_). In any case, the _ou=transports_ branch contains two entries :
+
+for LDAP :
+
+	dn: ads-transportid=ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ad
+	 s-directoryServiceId=default,ou=config
+	ads-systemport: 10389
+	ads-enabled: TRUE
+	ads-transportnbthreads: 8
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldap
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	 
+and for LDAPS :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,a
+	 ds-directoryServiceId=default,ou=config
+	ads-systemport: 10636
+	ads-transportenablessl: TRUE
+	ads-enabled: TRUE
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldaps
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	
+You just have to send a ModifyRequest using such a LDIF :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,ads
+	 -directoryServiceId=default,ou=config
+	changetype: modify
+	replace: ads-systemport
+	ads-systemport: 10637
+	-
+
+(here, we have modified the LDAPS Port from 10636 to 10637)
+
+Those modification can be done directly on the _config.ldif_ file, but you won't have any syntax check if you do so.
\ No newline at end of file

Added: directory/site/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.mdtext?rev=1403310&view=auto
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.mdtext (added)
+++ directory/site/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.mdtext Mon Oct 29 14:25:42 2012
@@ -0,0 +1,131 @@
+Title: 1.4.1 - Changing the server port for LDAP
+NavUp: 1.4-basic-configuration-tasks.html
+NavUpText: 1.4 - Basic configuration tasks
+NavNext: 1.4.2-changing-admin-password.html
+NavNextText: 1.4.2 - Changing the admin password
+Notice: 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.
+
+# 1.4.1 - Changing the server port for LDAP
+
+This section describes how to change to port for the LDAP protocol. There are two ways to do that : either you use the configuration plugin available in **Apache Directory Studio**, or you update the LDIF partition that contains the configuration.
+
+[TOC]
+
+## The task and how to accomplish it
+
+By default the LDAP server listens on port 10389 (unencrypted or StartTLS) and 10636 (SSL). It is quite common to run LDAP on 389, which is the well-known port for this protocol, but that requires the server to be started with a root user (or with sudo). Of course other options are imaginable as well. Changing the LDAP port is a good example for adjusting the existing Spring configuration as introduced in the last section.
+
+<DIV class="note" markdown="1">
+Due to traditional Unix security restrictions, ports less than 1024 were "trusted". Thus on a Unix-System, a non-root process must listen on a port greater than 1023.
+</DIV>
+
+
+Basically, there are two cases :
+* The server is not started
+* The server is started
+
+We will see how to change the port in those two cases.
+
+### Using Apache Directory Studio
+
+#### The server is started
+
+The best solution is to connect on the server using Studio, and to open it's configuration :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config1.png)
+</CENTER>
+
+When you select this menu, you will get the main configuration screen, containing the port for LDAP and LDAPS :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+
+Now, change the values of _port_ to your needs, then save the configuration. You have to restart the server afterwards in order to take this change into effect.
+
+#### The server is not started
+
+You can start it and update the configuration, of course. But if you want to configure the server when it's stopped, you will have to load the configuration file, which is on _.../instances/default/conf/config.ldif_, when the server has been installed using the default setting.
+
+Opening this file will open the exact same window :
+
+<CENTER>
+![Studio port configuration](images/studio-port-config2.png)
+</CENTER>
+
+You can update the _ports_ and save the file.
+
+<DIV class="warning" markdown="1">
+	Note that you will requite write access on this file !
+</DIV>
+
+### Modifying the configuration LDIF partition
+
+All the **ApacheDS** configuration is stored as a LDIF file, and can be modified either using a text editor (although we don't consider this as a safe practice) or using a Modify request on a running server. 
+
+<DIV class="info" markdown="1">
+	Modifying the configuration on a running server will **not** change the listening port of the running server. You will have to relaunch the server in order to get this new configuration to be available.
+</DIV>
+
+
+The configuration is stored as a set of LDAP entries, so you can update one of them. In order to modify the entry containing the ports, you have first to find it, and second to send a valid modify request.
+
+All the **ApacheDS** configuration is stored under the _ou=config_ partition. The ports are stored in some entries under _DN: ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ads-directoryServiceId=default,ou=config_ (obviously, dependning on your installation, this DN might change : the _ads-directoryServiceId_ may have a different name, so is the _ads-serverId_). In any case, the _ou=transports_ branch contains two entries :
+
+for LDAP :
+
+	dn: ads-transportid=ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ad
+	 s-directoryServiceId=default,ou=config
+	ads-systemport: 10389
+	ads-enabled: TRUE
+	ads-transportnbthreads: 8
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldap
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	 
+and for LDAPS :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,a
+	 ds-directoryServiceId=default,ou=config
+	ads-systemport: 10636
+	ads-transportenablessl: TRUE
+	ads-enabled: TRUE
+	ads-transportaddress: 0.0.0.0
+	ads-transportid: ldaps
+	objectclass: ads-transport
+	objectclass: ads-tcpTransport
+	objectclass: ads-base
+	objectclass: top
+	
+You just have to send a ModifyRequest using such a LDIF :
+
+	dn: ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,ads
+	 -directoryServiceId=default,ou=config
+	changetype: modify
+	replace: ads-systemport
+	ads-systemport: 10637
+	-
+
+(here, we have modified the LDAPS Port from 10636 to 10637)
+
+Those modification can be done directly on the _config.ldif_ file, but you won't have any syntax check if you do so.
\ No newline at end of file

Modified: directory/site/trunk/content/apacheds/basic-users-guide.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-users-guide.mdtext?rev=1403310&r1=1403309&r2=1403310&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-users-guide.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-users-guide.mdtext Mon Oct 29 14:25:42 2012
@@ -51,7 +51,7 @@ We are quite interested to improve the c
 		* [1.4.4 - Configure logging](basic-ug/1.4.4-configure-logging.html)
 		* [1.4.5 - Enable and disable anonymous access](basic-ug/1.4.5-anonymous-access.html)
 	* [1.5 - About the sample configurations and sample directory data](basic-ug/1.5-sample-configuration.html)
-* [2 - Handling of data within your directory](basic-ug/2-handling-data.html)
+* [2 - Handling of data within your directory](basic-ug/2-sample-configuration.html)
 * [3 - Basic Security](basic-ug/3-basic-security.html)
 	* [3.1 - Authentication options](basic-ug/3.1-authentication-options.html)
 	* [3.2 - Basic authorization](basic-ug/3.2-basic-authorization.html)



Mime
View raw message