From commits-return-27334-apmail-directory-commits-archive=directory.apache.org@directory.apache.org Mon Sep 06 19:59:39 2010 Return-Path: Delivered-To: apmail-directory-commits-archive@www.apache.org Received: (qmail 195 invoked from network); 6 Sep 2010 19:59:38 -0000 Received: from unknown (HELO mail.apache.org) (140.211.11.3) by 140.211.11.9 with SMTP; 6 Sep 2010 19:59:38 -0000 Received: (qmail 11450 invoked by uid 500); 6 Sep 2010 19:59:38 -0000 Delivered-To: apmail-directory-commits-archive@directory.apache.org Received: (qmail 11407 invoked by uid 500); 6 Sep 2010 19:59:38 -0000 Mailing-List: contact commits-help@directory.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@directory.apache.org Delivered-To: mailing list commits@directory.apache.org Received: (qmail 11400 invoked by uid 99); 6 Sep 2010 19:59:38 -0000 Received: from Unknown (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 06 Sep 2010 19:59:38 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 06 Sep 2010 19:59:20 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 60E9B23889E9; Mon, 6 Sep 2010 19:58:59 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r993140 - in /directory/apacheds-manuals/trunk/src/basic-user-guide: handling-of-data-3-operations.xml images/studio_mod_add_1.png Date: Mon, 06 Sep 2010 19:58:59 -0000 To: commits@directory.apache.org From: szoerner@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20100906195859.60E9B23889E9@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: szoerner Date: Mon Sep 6 19:58:59 2010 New Revision: 993140 URL: http://svn.apache.org/viewvc?rev=993140&view=rev Log: Added some content for data manipulation (adding an entry) Added: directory/apacheds-manuals/trunk/src/basic-user-guide/images/studio_mod_add_1.png (with props) Modified: directory/apacheds-manuals/trunk/src/basic-user-guide/handling-of-data-3-operations.xml Modified: directory/apacheds-manuals/trunk/src/basic-user-guide/handling-of-data-3-operations.xml URL: http://svn.apache.org/viewvc/directory/apacheds-manuals/trunk/src/basic-user-guide/handling-of-data-3-operations.xml?rev=993140&r1=993139&r2=993140&view=diff ============================================================================== --- directory/apacheds-manuals/trunk/src/basic-user-guide/handling-of-data-3-operations.xml (original) +++ directory/apacheds-manuals/trunk/src/basic-user-guide/handling-of-data-3-operations.xml Mon Sep 6 19:58:59 2010 @@ -612,11 +612,158 @@ uid: wbligh
Modification + This section gives an overview on how to manipulate entries within your directory. Manipulating data with the help of Apache Directory Studio and graphical tools in general is straight forward. - This section therefore concentrates on using LDIF and command line tools. + This section therefore concentrates on using LDIF and command line tools. + The steps are basically the same with a UI tool, in many cases easier to accomplish, but harder to document. + +
+ Adding an entry + + + Let's start with adding a new entry to the "Seven Seas" partition + (it is therefore assumed that you have already imported the sample data). + + + + A person to add -- + + The data of the person to add is inspired by "Peter Pan" and provided by this LDIF file (captain_hook.ldif): + + + + + + The entry with distinguished name "cn=James Hook,ou=people,o=sevenSeas" describes a person. + In the default schema of ApacheDS (as defined in RFC 2256), object class person requires attribute values for cn (common name) and sn (surname). + The other attributes are optional. The following screenshot of the schema browser of Apache Directory Studio illustrates this: + +
+ Object class person in Schema Browser + + + + + +
+ + + + Using a command line tool to add the entry -- + It depends on your authorization configuration, which directory users are allowed to add entries (or generally to manipulate data). + The administrator uid=admin,ou=system is always allowed to do anything; thus we use him here for authentication. + With ldapmodify, the data above can be added to the sample partition like this: + + + + + + The following table contains descriptions for the options used. See the manpage of ldapmodify for details. + + + + Command line options used in the modify example + + + + + + Option + Meaning + + + + + -h zanzibar + Hostname of LDAP server to connect to (default is localhost) + + + -p 10389 + Port on which the server listens (default is 389) + + + -D "uid=admin,ou=system" + Distinguished name to bind (user with appropriate privileges needed) + + + -w ****** + Password of bind user (Replace with appropriate value) + + + -a + add new entries + + + -f captain_hook.ldif + Name of LDIF file to load + + + +
+ + + Note that the file contains only one entry, but it is possible to add several entries at once with a single ldapmodify call. + An LDIF file can contain an arbitrary number of entries, seperated by an empty line. + An ldapmodify call as above would try to add them one by one. + + + + Verification -- + With the help of the ldapsearch command, you can verify that the entry is indeed present in the directory. + + + + + + Another option for verification is to use a graphical tool like Apache Directory Studio. + + + + + + +
+ +
+ Modifying an entry + + + LDIF can either be used to describe complete entries, like Caption Hook in the example before, + or to describe a set of changes made (or to be mode) to directory entries. + In the following we use the latter variant. + We present simple LDIF files with changes to an entry (Hook again, the samples assume his existence within the tree) + and apply them to the directory. + + +
+ Added: directory/apacheds-manuals/trunk/src/basic-user-guide/images/studio_mod_add_1.png URL: http://svn.apache.org/viewvc/directory/apacheds-manuals/trunk/src/basic-user-guide/images/studio_mod_add_1.png?rev=993140&view=auto ============================================================================== Binary file - no diff available. Propchange: directory/apacheds-manuals/trunk/src/basic-user-guide/images/studio_mod_add_1.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream