directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r836505 [2/2] - in /websites/staging/directory/trunk/content: ./ apacheds/basic-ug/ apacheds/basic-ug/images/
Date Mon, 29 Oct 2012 17:34:43 GMT
Modified: websites/staging/directory/trunk/content/apacheds/basic-ug/4-integrating-apacheds.html
==============================================================================
--- websites/staging/directory/trunk/content/apacheds/basic-ug/4-integrating-apacheds.html
(original)
+++ websites/staging/directory/trunk/content/apacheds/basic-ug/4-integrating-apacheds.html
Mon Oct 29 17:34:42 2012
@@ -17,7 +17,7 @@
 -->
 <html>
 	<head>
-		<title>1.4.1 - Changing the server port for LDAP &mdash; Apache Directory</title>
+		<title>4 - Integrating ApacheDS with other programs &mdash; Apache Directory</title>
 		
         <link href="./../../css/common.css" rel="stylesheet" type="text/css">
     	<link href="./../../css/green.css" rel="stylesheet" type="text/css">
@@ -108,137 +108,41 @@
     <div class="nav">
         <div class="nav_prev">
         
-			&nbsp;
-        
+            <a href="3-basic-security.html">3 - Basic Security</a>
+		
         </div>
         <div class="nav_up">
         
-            <a href="1.4-basic-configuration-tasks.html">1.4 - Basic configuration
tasks</a>
+            <a href="../basic-users-guide.html">Basic User Guide</a>
 		
         </div>
         <div class="nav_next">
         
-            <a href="1.4.2-changing-admin-password.html">1.4.2 - Changing the admin
password</a>
-		
+			&nbsp;
+        
         </div>
         <div class="clearfix"></div>
     </div>
 
 
-<h1 id="141-changing-the-server-port-for-ldap">1.4.1 - Changing the server port for
LDAP</h1>
-<p>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 <strong>Apache
Directory Studio</strong>, or you update the LDIF partition that contains the configuration.</p>
-<div class="toc">
-<ul>
-<li><a href="#141-changing-the-server-port-for-ldap">1.4.1 - Changing the server
port for LDAP</a><ul>
-<li><a href="#the-task-and-how-to-accomplish-it">The task and how to accomplish
it</a><ul>
-<li><a href="#using-apache-directory-studio">Using Apache Directory Studio</a><ul>
-<li><a href="#the-server-is-started">The server is started</a></li>
-<li><a href="#the-server-is-not-started">The server is not started</a></li>
-</ul>
-</li>
-<li><a href="#modifying-the-configuration-ldif-partition">Modifying the configuration
LDIF partition</a></li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-</div>
-<h2 id="the-task-and-how-to-accomplish-it">The task and how to accomplish it</h2>
-<p>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.</p>
-<p><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></p>
-<p>Basically, there are two cases :
-<em> The server is not started
-</em> The server is started</p>
-<p>We will see how to change the port in those two cases.</p>
-<h3 id="using-apache-directory-studio">Using Apache Directory Studio</h3>
-<h4 id="the-server-is-started">The server is started</h4>
-<p>The best solution is to connect on the server using Studio, and to open it's configuration
:</p>
-<p><CENTER>
-<img alt="Studio port configuration" src="images/studio-port-config1.png" />
-</CENTER></p>
-<p>When you select this menu, you will get the main configuration screen, containing
the port for LDAP and LDAPS :</p>
-<p><CENTER>
-<img alt="Studio port configuration" src="images/studio-port-config2.png" />
-</CENTER></p>
-<p>Now, change the values of <em>port</em> to your needs, then save the
configuration. You have to restart the server afterwards in order to take this change into
effect.</p>
-<h4 id="the-server-is-not-started">The server is not started</h4>
-<p>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 <em>.../instances/default/conf/config.ldif</em>,
when the server has been installed using the default setting.</p>
-<p>Opening this file will open the exact same window :</p>
-<p><CENTER>
-<img alt="Studio port configuration" src="images/studio-port-config2.png" />
-</CENTER></p>
-<p>You can update the <em>ports</em> and save the file.</p>
-<p><DIV class="warning" markdown="1">
-    Note that you will requite write access on this file !
-</DIV></p>
-<h3 id="modifying-the-configuration-ldif-partition">Modifying the configuration LDIF
partition</h3>
-<p>All the <strong>ApacheDS</strong> 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. </p>
-<p><DIV class="info" markdown="1">
-    Modifying the configuration on a running server will <strong>not</strong>
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></p>
-<p>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.</p>
-<p>All the <strong>ApacheDS</strong> configuration is stored under the
<em>ou=config</em> partition. The ports are stored in some entries under <em>DN:
ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ads-directoryServiceId=default,ou=config</em>
(obviously, dependning on your installation, this DN might change : the <em>ads-directoryServiceId</em>
may have a different name, so is the <em>ads-serverId</em>). In any case, the
<em>ou=transports</em> branch contains two entries :</p>
-<p>for LDAP :</p>
-<div class="codehilite"><pre><span class="err">dn:</span> <span
class="err">ads-transportid=ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ad</span>
- <span class="err">s-directoryServiceId=default,ou=config</span>
-<span class="err">ads-systemport:</span> <span class="err">10389</span>
-<span class="err">ads-enabled:</span> <span class="err">TRUE</span>
-<span class="err">ads-transportnbthreads:</span> <span class="err">8</span>
-<span class="err">ads-transportaddress:</span> <span class="err">0.0.0.0</span>
-<span class="err">ads-transportid:</span> <span class="err">ldap</span>
-<span class="err">object</span><span class="kd">class</span><span
class="err">:</span> <span class="err">ads-transport</span>
-<span class="err">objectclass:</span> <span class="err">ads-tcpTransport</span>
-<span class="err">objectclass:</span> <span class="err">ads-base</span>
-<span class="err">objectclass:</span> <span class="err">top</span>
-</pre></div>
-
-
-<p>and for LDAPS :</p>
-<div class="codehilite"><pre><span class="err">dn:</span> <span
class="err">ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,a</span>
- <span class="err">ds-directoryServiceId=default,ou=config</span>
-<span class="err">ads-systemport:</span> <span class="err">10636</span>
-<span class="err">ads-transportenablessl:</span> <span class="err">TRUE</span>
-<span class="err">ads-enabled:</span> <span class="err">TRUE</span>
-<span class="err">ads-transportaddress:</span> <span class="err">0.0.0.0</span>
-<span class="err">ads-transportid:</span> <span class="err">ldaps</span>
-<span class="err">object</span><span class="kd">class</span><span
class="err">:</span> <span class="err">ads-transport</span>
-<span class="err">objectclass:</span> <span class="err">ads-tcpTransport</span>
-<span class="err">objectclass:</span> <span class="err">ads-base</span>
-<span class="err">objectclass:</span> <span class="err">top</span>
-</pre></div>
-
-
-<p>You just have to send a ModifyRequest using such a LDIF :</p>
-<div class="codehilite"><pre><span class="err">dn:</span> <span
class="err">ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,ads</span>
- <span class="err">-directoryServiceId=default,ou=config</span>
-<span class="err">changetype:</span> <span class="err">modify</span>
-<span class="err">replace:</span> <span class="err">ads-systemport</span>
-<span class="err">ads-systemport:</span> <span class="err">10637</span>
-<span class="err">-</span>
-</pre></div>
-
-
-<p>(here, we have modified the LDAPS Port from 10636 to 10637)</p>
-<p>Those modification can be done directly on the <em>config.ldif</em>
file, but you won't have any syntax check if you do so.</p>
+<h1 id="4-integrating-apacheds-with-other-programs">4 - Integrating ApacheDS with other
programs</h1>
 
 
     <div class="nav">
         <div class="nav_prev">
         
-			&nbsp;
-        
+            <a href="3-basic-security.html">3 - Basic Security</a>
+		
         </div>
         <div class="nav_up">
         
-            <a href="1.4-basic-configuration-tasks.html">1.4 - Basic configuration
tasks</a>
+            <a href="../basic-users-guide.html">Basic User Guide</a>
 		
         </div>
         <div class="nav_next">
         
-            <a href="1.4.2-changing-admin-password.html">1.4.2 - Changing the admin
password</a>
-		
+			&nbsp;
+        
         </div>
         <div class="clearfix"></div>
     </div>

Modified: websites/staging/directory/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.html
==============================================================================
--- websites/staging/directory/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.html
(original)
+++ websites/staging/directory/trunk/content/apacheds/basic-ug/4.1-mozilla-thunderbird.html
Mon Oct 29 17:34:42 2012
@@ -17,7 +17,7 @@
 -->
 <html>
 	<head>
-		<title>1.4.1 - Changing the server port for LDAP &mdash; Apache Directory</title>
+		<title>4.1 - Mozilla Thunderbird &mdash; Apache Directory</title>
 		
         <link href="./../../css/common.css" rel="stylesheet" type="text/css">
     	<link href="./../../css/green.css" rel="stylesheet" type="text/css">
@@ -108,137 +108,41 @@
     <div class="nav">
         <div class="nav_prev">
         
-			&nbsp;
-        
+            <a href="4-integrating-apacheds.html">4 - Integrating ApacheDS with other
programs</a>
+		
         </div>
         <div class="nav_up">
         
-            <a href="1.4-basic-configuration-tasks.html">1.4 - Basic configuration
tasks</a>
+            <a href="4-integrating-apacheds.html">4 - Integrating ApacheDS with other
programs</a>
 		
         </div>
         <div class="nav_next">
         
-            <a href="1.4.2-changing-admin-password.html">1.4.2 - Changing the admin
password</a>
-		
+			&nbsp;
+        
         </div>
         <div class="clearfix"></div>
     </div>
 
 
-<h1 id="141-changing-the-server-port-for-ldap">1.4.1 - Changing the server port for
LDAP</h1>
-<p>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 <strong>Apache
Directory Studio</strong>, or you update the LDIF partition that contains the configuration.</p>
-<div class="toc">
-<ul>
-<li><a href="#141-changing-the-server-port-for-ldap">1.4.1 - Changing the server
port for LDAP</a><ul>
-<li><a href="#the-task-and-how-to-accomplish-it">The task and how to accomplish
it</a><ul>
-<li><a href="#using-apache-directory-studio">Using Apache Directory Studio</a><ul>
-<li><a href="#the-server-is-started">The server is started</a></li>
-<li><a href="#the-server-is-not-started">The server is not started</a></li>
-</ul>
-</li>
-<li><a href="#modifying-the-configuration-ldif-partition">Modifying the configuration
LDIF partition</a></li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
-</div>
-<h2 id="the-task-and-how-to-accomplish-it">The task and how to accomplish it</h2>
-<p>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.</p>
-<p><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></p>
-<p>Basically, there are two cases :
-<em> The server is not started
-</em> The server is started</p>
-<p>We will see how to change the port in those two cases.</p>
-<h3 id="using-apache-directory-studio">Using Apache Directory Studio</h3>
-<h4 id="the-server-is-started">The server is started</h4>
-<p>The best solution is to connect on the server using Studio, and to open it's configuration
:</p>
-<p><CENTER>
-<img alt="Studio port configuration" src="images/studio-port-config1.png" />
-</CENTER></p>
-<p>When you select this menu, you will get the main configuration screen, containing
the port for LDAP and LDAPS :</p>
-<p><CENTER>
-<img alt="Studio port configuration" src="images/studio-port-config2.png" />
-</CENTER></p>
-<p>Now, change the values of <em>port</em> to your needs, then save the
configuration. You have to restart the server afterwards in order to take this change into
effect.</p>
-<h4 id="the-server-is-not-started">The server is not started</h4>
-<p>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 <em>.../instances/default/conf/config.ldif</em>,
when the server has been installed using the default setting.</p>
-<p>Opening this file will open the exact same window :</p>
-<p><CENTER>
-<img alt="Studio port configuration" src="images/studio-port-config2.png" />
-</CENTER></p>
-<p>You can update the <em>ports</em> and save the file.</p>
-<p><DIV class="warning" markdown="1">
-    Note that you will requite write access on this file !
-</DIV></p>
-<h3 id="modifying-the-configuration-ldif-partition">Modifying the configuration LDIF
partition</h3>
-<p>All the <strong>ApacheDS</strong> 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. </p>
-<p><DIV class="info" markdown="1">
-    Modifying the configuration on a running server will <strong>not</strong>
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></p>
-<p>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.</p>
-<p>All the <strong>ApacheDS</strong> configuration is stored under the
<em>ou=config</em> partition. The ports are stored in some entries under <em>DN:
ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ads-directoryServiceId=default,ou=config</em>
(obviously, dependning on your installation, this DN might change : the <em>ads-directoryServiceId</em>
may have a different name, so is the <em>ads-serverId</em>). In any case, the
<em>ou=transports</em> branch contains two entries :</p>
-<p>for LDAP :</p>
-<div class="codehilite"><pre><span class="err">dn:</span> <span
class="err">ads-transportid=ldap,ou=transports,ads-serverId=ldapServer,ou=servers,ad</span>
- <span class="err">s-directoryServiceId=default,ou=config</span>
-<span class="err">ads-systemport:</span> <span class="err">10389</span>
-<span class="err">ads-enabled:</span> <span class="err">TRUE</span>
-<span class="err">ads-transportnbthreads:</span> <span class="err">8</span>
-<span class="err">ads-transportaddress:</span> <span class="err">0.0.0.0</span>
-<span class="err">ads-transportid:</span> <span class="err">ldap</span>
-<span class="err">object</span><span class="kd">class</span><span
class="err">:</span> <span class="err">ads-transport</span>
-<span class="err">objectclass:</span> <span class="err">ads-tcpTransport</span>
-<span class="err">objectclass:</span> <span class="err">ads-base</span>
-<span class="err">objectclass:</span> <span class="err">top</span>
-</pre></div>
-
-
-<p>and for LDAPS :</p>
-<div class="codehilite"><pre><span class="err">dn:</span> <span
class="err">ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,a</span>
- <span class="err">ds-directoryServiceId=default,ou=config</span>
-<span class="err">ads-systemport:</span> <span class="err">10636</span>
-<span class="err">ads-transportenablessl:</span> <span class="err">TRUE</span>
-<span class="err">ads-enabled:</span> <span class="err">TRUE</span>
-<span class="err">ads-transportaddress:</span> <span class="err">0.0.0.0</span>
-<span class="err">ads-transportid:</span> <span class="err">ldaps</span>
-<span class="err">object</span><span class="kd">class</span><span
class="err">:</span> <span class="err">ads-transport</span>
-<span class="err">objectclass:</span> <span class="err">ads-tcpTransport</span>
-<span class="err">objectclass:</span> <span class="err">ads-base</span>
-<span class="err">objectclass:</span> <span class="err">top</span>
-</pre></div>
-
-
-<p>You just have to send a ModifyRequest using such a LDIF :</p>
-<div class="codehilite"><pre><span class="err">dn:</span> <span
class="err">ads-transportid=ldaps,ou=transports,ads-serverId=ldapServer,ou=servers,ads</span>
- <span class="err">-directoryServiceId=default,ou=config</span>
-<span class="err">changetype:</span> <span class="err">modify</span>
-<span class="err">replace:</span> <span class="err">ads-systemport</span>
-<span class="err">ads-systemport:</span> <span class="err">10637</span>
-<span class="err">-</span>
-</pre></div>
-
-
-<p>(here, we have modified the LDAPS Port from 10636 to 10637)</p>
-<p>Those modification can be done directly on the <em>config.ldif</em>
file, but you won't have any syntax check if you do so.</p>
+<h1 id="41-mozilla-thunderbird">4.1 - Mozilla Thunderbird</h1>
 
 
     <div class="nav">
         <div class="nav_prev">
         
-			&nbsp;
-        
+            <a href="4-integrating-apacheds.html">4 - Integrating ApacheDS with other
programs</a>
+		
         </div>
         <div class="nav_up">
         
-            <a href="1.4-basic-configuration-tasks.html">1.4 - Basic configuration
tasks</a>
+            <a href="4-integrating-apacheds.html">4 - Integrating ApacheDS with other
programs</a>
 		
         </div>
         <div class="nav_next">
         
-            <a href="1.4.2-changing-admin-password.html">1.4.2 - Changing the admin
password</a>
-		
+			&nbsp;
+        
         </div>
         <div class="clearfix"></div>
     </div>

Added: websites/staging/directory/trunk/content/apacheds/basic-ug/images/w32_service_properties.png
==============================================================================
Binary file - no diff available.

Propchange: websites/staging/directory/trunk/content/apacheds/basic-ug/images/w32_service_properties.png
------------------------------------------------------------------------------
    svn:mime-type = image/png



Mime
View raw message