directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From fel...@apache.org
Subject svn commit: r1212125 - in /directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence: ./ images/ managing-data-within-your-directory/ managing-data-within-your-directory/connecting_to_a_server_with_apache_directory_client_tools/ ma...
Date Thu, 08 Dec 2011 21:10:31 GMT
Author: felixk
Date: Thu Dec  8 21:10:30 2011
New Revision: 1212125

URL: http://svn.apache.org/viewvc?rev=1212125&view=rev
Log:
Moving basic user guide from confluence, 2. Chapter (DIRSERVER-1678)

Added:
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_browser_after_import.png
  (with props)
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_connection.png
  (with props)
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_import_menu.png
  (with props)
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_import_wizard.png
  (with props)
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_modification_logs.png
  (with props)
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_new_ldap_connection.png
  (with props)
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_new_ldap_connection_auth.png
  (with props)
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_new_ldap_connection_options.png
  (with props)
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/which_ldapmodify.png
  (with props)
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory.confluence
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_to_a_server_with_apache_directory_client_tools/
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_to_a_server_with_apache_directory_client_tools.confluence
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_to_a_server_with_apache_directory_client_tools/apache_directory_studio.confluence
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools/
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools.confluence
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools/command_line_tools.confluence
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools/graphical_tools_3rd_party.confluence
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/custom_application_development.confluence
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/ldap_operations/
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/ldap_operations.confluence
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/ldap_operations/ldap_operations_overview.confluence
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/replication.confluence
Modified:
    directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/book.txt

Modified: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/book.txt
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/book.txt?rev=1212125&r1=1212124&r2=1212125&view=diff
==============================================================================
--- directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/book.txt
(original)
+++ directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/book.txt
Thu Dec  8 21:10:30 2011
@@ -11,6 +11,18 @@ how-to-begin/basic_configuration_tasks/a
 how-to-begin/basic_configuration_tasks/changing_the_admin_password.confluence
 how-to-begin/basic_configuration_tasks/adding_your_own_partition_resp_suffix.confluence
 how-to-begin/basic_configuration_tasks/configure_logging.confluence
+managing-data-within-your-directory.confluence
+managing-data-within-your-directory/connecting_to_a_server_with_apache_directory_client_tools.confluence
+managing-data-within-your-directory/connecting_to_a_server_with_apache_directory_client_tools/apache_directory_studio.confluence
+managing-data-within-your-directory/connecting_with_other_client_tools.confluence
+managing-data-within-your-directory/connecting_with_other_client_tools/graphical_tools_3rd_party.confluence
+managing-data-within-your-directory/connecting_with_other_client_tools/command_line_tools.confluence
+managing-data-within-your-directory/custom_application_development.confluence
+managing-data-within-your-directory/ldap_operations.confluence
+managing-data-within-your-directory/ldap_operations/ldap_operations_overview.confluence
+managing-data-within-your-directory/replication.confluence
+
+
 #managing-data-within-your-directory
 #basic-security
 #taking-advantage-of-apacheds

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_browser_after_import.png
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_browser_after_import.png?rev=1212125&view=auto
==============================================================================
Binary file - no diff available.

Propchange: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_browser_after_import.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_connection.png
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_connection.png?rev=1212125&view=auto
==============================================================================
Binary file - no diff available.

Propchange: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_connection.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_import_menu.png
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_import_menu.png?rev=1212125&view=auto
==============================================================================
Binary file - no diff available.

Propchange: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_import_menu.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_import_wizard.png
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_import_wizard.png?rev=1212125&view=auto
==============================================================================
Binary file - no diff available.

Propchange: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_import_wizard.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_modification_logs.png
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_modification_logs.png?rev=1212125&view=auto
==============================================================================
Binary file - no diff available.

Propchange: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_modification_logs.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_new_ldap_connection.png
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_new_ldap_connection.png?rev=1212125&view=auto
==============================================================================
Binary file - no diff available.

Propchange: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_new_ldap_connection.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_new_ldap_connection_auth.png
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_new_ldap_connection_auth.png?rev=1212125&view=auto
==============================================================================
Binary file - no diff available.

Propchange: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_new_ldap_connection_auth.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_new_ldap_connection_options.png
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_new_ldap_connection_options.png?rev=1212125&view=auto
==============================================================================
Binary file - no diff available.

Propchange: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/studio_new_ldap_connection_options.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/which_ldapmodify.png
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/which_ldapmodify.png?rev=1212125&view=auto
==============================================================================
Binary file - no diff available.

Propchange: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/images/which_ldapmodify.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory.confluence
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory.confluence?rev=1212125&view=auto
==============================================================================
--- directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory.confluence
(added)
+++ directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory.confluence
Thu Dec  8 21:10:30 2011
@@ -0,0 +1 @@
+h1. Managing data within your directory
\ No newline at end of file

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_to_a_server_with_apache_directory_client_tools.confluence
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_to_a_server_with_apache_directory_client_tools.confluence?rev=1212125&view=auto
==============================================================================
--- directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_to_a_server_with_apache_directory_client_tools.confluence
(added)
+++ directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_to_a_server_with_apache_directory_client_tools.confluence
Thu Dec  8 21:10:30 2011
@@ -0,0 +1 @@
+h2. Connecting to a server with Apache Directory client tools
\ No newline at end of file

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_to_a_server_with_apache_directory_client_tools/apache_directory_studio.confluence
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_to_a_server_with_apache_directory_client_tools/apache_directory_studio.confluence?rev=1212125&view=auto
==============================================================================
--- directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_to_a_server_with_apache_directory_client_tools/apache_directory_studio.confluence
(added)
+++ directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_to_a_server_with_apache_directory_client_tools/apache_directory_studio.confluence
Thu Dec  8 21:10:30 2011
@@ -0,0 +1,49 @@
+h3. Connecting to ApacheDS with Apache Directory Studio
+
+This section describes how to connect to ApacheDS with [Apache Directory Studio|http://directory.apache.org/ldapstudio/|directory.apache.org].
Apache Directory Studio is a complete directory tooling platform based om Eclipse RCP. It
is intended to be used with any LDAP server however it is particularly designed for use with
the ApacheDS.
+
+{toc:type=list|minLevel=2|maxLevel=2}
+
+h4. Connect to Apache DS
+
+After starting up Apache Directory Studio open the LDAP Browser perspective.
+
+!images/studio_connection.png!
+
+In order to connect to our sample directory server, open the New Connection wizard. This
can be accomplished by invoking the corresponding action in the _Connections_ view (see screen
above).
+
+!images/studio_new_ldap_connection.png!
+
+The wizard appears (screen shot above). It provides input fields for a connection name, hostname
and port. Enter your network parameters (the image shows our sample configuration values).
You can test the connection with the button _Check network parameters_.  Click _Next_ to continue.
+
+!images/studio_new_ldap_connection_auth.png!
+
+On the authentication page (screen shot above) you provide credentials for the user to connect.
Because currently no user is imported to your directory, you have to use the administrator
to authenticate. Enter the DN of this user "uid=admin,ou=system" and the corresponding password.
Click _Next_ to continue.
+
+{warning:title=Warning}
+Using this configuration with a so called "simple bind" causes Apache Directory Studio to
send the credentials (User DN, password) unencrypted to the server. 
+{warning}
+
+!images/studio_new_ldap_connection_options.png!
+
+On the options page (screen shot above) please enter the base DN for the "o=sevenSeas" partition.
Pressing the _Finish_ button causes to connect to the server.
+
+
+h4. Import sample data
+
+In order to load the sample data to ApacheDS with Apache Directory Studio, you have to connect
to the server first (as described above). Use "uid=admin,ou=system" to connect (you need write
access). After you successfully connected to your server, use the context menu in the LDAP
Browser view and select _Import_ \| _LDIF Import..._ to start the import wizard.
+
+!images/studio_import_menu.png!
+
+The corresponding wizard appears (see below).
+
+!images/studio_import_wizard.png!
+
+Use the _Browse..._ button to open a file dialog and select the file with the [sample data|1.4.
About the sample configurations and sample directory data]. Press the _Finish_ button. Apache
Directory Studio reads the LDIF file and performs some LDAP add operations against your server
in order to create the entries within the sample partition. After a successful import, you
can immediately browse the directory and see the imported entries:
+
+!images/studio_browser_after_import.png!
+
+
+h4. Resources
+
+[Apache Directory Studio Documentation|http://directory.apache.org/ldapstudio/users-guide.html]
\ No newline at end of file

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools.confluence
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools.confluence?rev=1212125&view=auto
==============================================================================
--- directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools.confluence
(added)
+++ directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools.confluence
Thu Dec  8 21:10:30 2011
@@ -0,0 +1 @@
+h2. Connecting with other client tools
\ No newline at end of file

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools/command_line_tools.confluence
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools/command_line_tools.confluence?rev=1212125&view=auto
==============================================================================
--- directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools/command_line_tools.confluence
(added)
+++ directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools/command_line_tools.confluence
Thu Dec  8 21:10:30 2011
@@ -0,0 +1,88 @@
+h3. Command line tools
+
+This sections describes how to connect to ApacheDS with command line tools, which are not
part of the distribution, but present on many operating systems.
+
+{toc:type=list|minLevel=2|maxLevel=2}
+
+h4. A powerful alternative to UI tools 
+
+An alternative to UI tools for connecting to your directory and perform operations are command
line tools. The traditional commands are part of many applications (for instance Lotus notes,
many LDAP servers) and even operating systems (e.g. Sun Solaris 8 ff.). The following table
lists the names and functions of common commands. All of them open a connection to an LDAP
server, bind, and perform one or more LDAP operations.
+
+|| Command || short description from man page ||
+| ldapsearch | Performs a search using specified parameters. |
+| ldapmodify and ldapadd | Modifies or adds entries. When invoked as ldapadd the \-a (add
new entry) flag is turned on automatically. |
+| ldapmodrdn | Modifies the RDN of entries. |
+| ldapdelete | Deletes one or more entries. |
+
+Open a shell and type "ldapsearch" to see whether these tools are already available on your
system. This may be true on UNIX systems (here a "which ldapsearch" would be helpful), or
LINUX systems (with OpenLDAP client tools installed). If not (especially if you are using
Windows, this is probably the case), you have different options to get such tools. One is
to download the [Sun ONE Directory SDK for C|http://www.sun.com/software/download/app_dev.html#sdk|www.sun.com],
which is available for many platforms (among them Windows). It also contains executables of
the command line tools (ldapsearch etc.).
+
+!images/which_ldapmodify.png!
+
+h4. A simple search example
+
+Here is an example for a search command, which displays the o=sevenSeas entry of our tutorial
partition. You will learn more about LDAP searches later on.
+
+{noformat}
+$ ldapsearch -h zanzibar -p 10389 -b "o=sevenSeas" -D "uid=admin,ou=system" -w ****** "(objectClass=*)"
+o=sevenSeas
+description=Contains Apache Directory Tutorial example data
+objectClass=organization
+objectClass=top
+o=sevenSeas
+$
+{noformat}
+
+One major advantage of command line tools is that you can use them within scripts. It is
also much easier if you have to document changes to the directory (configuration, for instance).
Therefore administrators like them a lot. We will use them within this tutorial as well, but
always as an alternative to UI tools (which LDAP newbies normally prefer).
+
+{info:title=Not all command line tools are equal}
+Although the command line tools of different operating systems and LDAP clients (shipped
with LDAP servers) normally have the same name, there are often differences in the command
line options. If any problems arise if you try out examples from this tutorial (e.g. "illegal
option"), consult the man pages or documentation of your tools.
+{info}{anchor:Custom application development}
+
+[Apache Directory Studio|http://directory.apache.org/studio/|directory.apache.org] provides
a view called _Modification Logs_ in which all changes to the directory (adding, manipulating,
deleting entries ...) are recorded in LDIF. Command line tools like the ones mentioned here
are able to replay theses logs.
+
+!images/studio_modification_logs.png!
+
+h4. Import sample data using a command line tool
+
+Here is an example usage of ldapmodify.
+
+{noformat}
+$ ldapmodify -h zanzibar -p 10389 -D "uid=admin,ou=system" -w ****** -a -f sample_data_bug.ldif
+adding new entry ou=people,o=sevenSeas
+adding new entry ou=groups,o=sevenSeas
+adding new entry ou=crews,ou=groups,o=sevenSeas
+adding new entry ou=ranks,ou=groups,o=sevenSeas
+adding new entry cn=Horatio Hornblower,ou=people,o=sevenSeas
+...
+adding new entry cn=John Fryer,ou=people,o=sevenSeas
+adding new entry cn=John Hallett,ou=people,o=sevenSeas
+adding new entry cn=HMS Bounty,ou=crews,ou=groups,o=sevenSeas
+$
+{noformat}
+
+The following table contains descriptions for the options used. See the [manpage of ldapmodify|http://www.die.net/doc/linux/man/man1/ldapmodify.1.html]
for details.
+
+|| Option || Meaning ||
+| \-h zanzibar | Hostname |
+| \-p 10389 | Port |
+| \-D "uid=admin,ou=system" | Distinguished name to bind (user with appropriate privileges
needed) |
+| \-w \*****\* | Password of bind user |
+| \-a | add new entries |
+| \-f sample_data_bug.ldif | Name of LDIF file to load |
+
+The following operation demonstrates that your directory now contains the sample data. It
searches for all entries below o=sevenSeas (-b = search base, \-s = search scope), which have
an attribute occurrence of givenName with value "William". The output contains the distinguished
names (dn) of the result entries and their common name (cn) values.
+{noformat}
+$ ldapsearch -h zanzibar -p 10389 -D "uid=admin,ou=system" -w ****** -b "o=sevenSeas" -s
sub "(givenName=William)" cn
+version: 1
+dn: cn=William Bligh,ou=people,o=sevenSeas
+cn: William Bligh
+
+dn: cn=William Bush,ou=people,o=sevenSeas
+cn: William Bush
+$
+{noformat}
+
+h4. Resources
+
+* The [OpenLDAP project|http://www.openldap.org|www.openldap.org] offers command lines tools
suitable for Apache Directory Server as well
+* [Sun ONE Directory SDK for C|http://www.sun.com/software/download/app_dev.html#sdk|www.sun.com]
also provides generic LDAP command line tools for several operating systems, which work fine
with ApacheDS
\ No newline at end of file

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools/graphical_tools_3rd_party.confluence
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools/graphical_tools_3rd_party.confluence?rev=1212125&view=auto
==============================================================================
--- directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools/graphical_tools_3rd_party.confluence
(added)
+++ directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/connecting_with_other_client_tools/graphical_tools_3rd_party.confluence
Thu Dec  8 21:10:30 2011
@@ -0,0 +1 @@
+h3. Graphical tools (3rd party)
\ No newline at end of file

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/custom_application_development.confluence
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/custom_application_development.confluence?rev=1212125&view=auto
==============================================================================
--- directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/custom_application_development.confluence
(added)
+++ directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/custom_application_development.confluence
Thu Dec  8 21:10:30 2011
@@ -0,0 +1 @@
+h2. Custom application development
\ No newline at end of file

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/ldap_operations.confluence
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/ldap_operations.confluence?rev=1212125&view=auto
==============================================================================
--- directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/ldap_operations.confluence
(added)
+++ directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/ldap_operations.confluence
Thu Dec  8 21:10:30 2011
@@ -0,0 +1 @@
+h2. LDAP Operations
\ No newline at end of file

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/ldap_operations/ldap_operations_overview.confluence
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/ldap_operations/ldap_operations_overview.confluence?rev=1212125&view=auto
==============================================================================
--- directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/ldap_operations/ldap_operations_overview.confluence
(added)
+++ directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/ldap_operations/ldap_operations_overview.confluence
Thu Dec  8 21:10:30 2011
@@ -0,0 +1,29 @@
+h3. LDAP Operations overview
+
+This section gives an overview of the LDAP operational model
+
+{toc:type=list|minLevel=2|maxLevel=2}
+
+h4. How LDAP works
+
+In principle the LDAP protocol follows a request/reply scenario between client and server.
Unlike HTTP this not necessarily takes place synchronously in a ping-pong exchange. A client
may also execute several requests by a server within a session simultaneously. The client
supplies a MessageID with each request. The server uses this ID within the corresponding reply.
This allows the client to match requests and replies.
+
+h4. All LDAP operations
+
+The operational model of LDAP v3 is comprised of the the following 10 operations.
+
+|| LDAP Operation     || Short description ||
+| Bind Operation      | exchange authentication information between client and server |
+| Unbind Operation    | terminate a protocol session |
+| Search Operation    | perform a search by the server |
+| Modify Operation    | modify attributes of an entry |
+| Add Operation       | add an entry into the directory |
+| Delete Operation    | remove an entry from the directory |
+| Modify DN Operation | change the leftmost component of the name of an entry, or move a
subtree of entries to a new location |
+| Compare Operation   | compare an assertion provided with an entry in the directory |
+| Abandon Operation   | abandon an outstanding operation |
+| Extended Operation  | perform an additional operation, defined in RFCs or be private to
particular implementations |
+
+h4. Resources 
+
+* [RFC 4511|http://tools.ietf.org/html/rfc4511] Lightweight Directory Access Protocol (LDAP):
The Protocol
\ No newline at end of file

Added: directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/replication.confluence
URL: http://svn.apache.org/viewvc/directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/replication.confluence?rev=1212125&view=auto
==============================================================================
--- directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/replication.confluence
(added)
+++ directory/documentation/apacheds-manuals/trunk/src/basic-user-guide-confluence/managing-data-within-your-directory/replication.confluence
Thu Dec  8 21:10:30 2011
@@ -0,0 +1,49 @@
+h2. Replication
+
+Apache Directory Server v2.0 supports master-slave replication. It can also act as a slave
to any LDAP V3 server which implements
+
+RFC 4533(a.k.a syncrepl), OpenLDAP is one such server.
+{info:icon=false}We use the word *{_}consumer/client/slave{_}* interchangeably for any server
that is acting as a replica by receiving data from another server. Similarly we use the word
*{_}provider/master{_}* for any server that is serving its data to one or more servers
+{info}
+
+h3. Configuring a Provider\\
+
+h3. Configuring a Consumer
+
+All the configuration data is stored in DIT (Directory Information Tree) itself, so the configuraion
can be changed with any LDAP client (like Apache Directory Studio) or by using any text editor.
+
+All the configuration about a provider on a consumer server will be placed under the DN *ou=replProviders,ou=config*.
The objectclass used
+
+for all such entries is *ads-replProvider*.
+
+Example configuration entry on a consumer/slave server to replicate with a replica peer/provider
looks like
+
+{info:icon=false}
+Note: the below text is taken directly from a LDIF file so the 'ads-repluserpassword' attribute's
value is Base64 encoded
+
+dn: ads-dsReplicaId=1,ou=replProviders,ou=config
+objectclass: ads-replProvider
+ads-dsreplicaid: 1
+ads-replrefreshinterval: 60000
+ads-repluserpassword:: c2VjcmV0
+ads-repluserdn: cn=Manager,dc=example,dc=com
+ads-replprovhostname: 192.168.22.106
+ads-replbase: dc=example,dc=com{info}
+
+The following are the options available for configuring
+|| Name \\ || Description \\ || Mandatory \\ || Type \\ || Default Value ||
+| ads-dsReplicaId | The unique id given to a provider configuration entry \\ |  
YES \\ | Integer \\ |   N/A \\ |
+| ads-replBase | The DN of the replication area e.x dc=example,dc=com \\ |   YES
| String \\ |   N/A \\ |
+| ads-replProvHostName | The host name of the syncrepl provider server \\ |   YES
| String \\ |   N/A \\ |
+| ads-replAliasDerefMode | AliasDerefMode to be used in the sync search request. \\ Valid
values are 0 (NEVER_DEREF_ALIASES) or 2 (DEREF_FINDING_BASE_OBJ) | \\   NO \\ | Integer
|    0  \\ (NEVER_DEREF_ALIASES) \\ |
+| ads-replAttribute | The attribute values that need to be replicated \\ |   NO
| String |   * \\ (ALL_USER_ATTRIBUTES) \\ |
+| ads-replProvPort | The port number of the provider host \\ |   NO | Integer |
389 \\ |
+| ads-replRefreshInterval | The time interval between successive refreshOnly synchronization
sessions \\ |   NO | Long | 60000 ms (1 min) \\ |
+| ads-replRefreshNPersist | A flag indicating the refreshAndPersist mode of replication.
If set to 'false'  \\  uses refreshOnly mode of replication \\ |  
NO | boolean \\ | true \\ |
+| ads-replSearchScope | The scope of the replication search. Available scopes are \\    
0 ( OBJECT ), \\     1 ( ONELEVEL ), \\    
2 ( SUBTREE ) \\ |   NO | Integer | 2 ( SUBTREE ) |
+| ads-replSearchFilter | The search filter used while retrieving results \\ |  
NO | String | (objectClass=*) |
+| ads-replSearchSizeLimit | The size limit imposed on the number of search results to be
returned during \\  initial content refresh |   \\   NO | Integer
| 0 (NO LIMIT) \\ |
+| ads-replSearchTimeOut | The time limit imposed on the replication search operation during
initial \\  content refresh \\ |   NO | Integer | 0 (NO LIMIT) |
+| ads-replUserDn | The user DN used to bind to the replica peer \\ |   NO | String
| N/A |
+| ads-replUserPassword | Password used to bind to the replica peer \\ |   NO | OctetString
| N/A |
+| ads-enabled | A flag to enable/disable a replication configuration entry \\ |  
NO | boolean \\ | true |



Mime
View raw message