You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by el...@apache.org on 2012/10/29 15:46:35 UTC

svn commit: r1403328 - in /directory/site/trunk/content/apacheds/basic-ug: 1.4.2-changing-admin-password.mdtext images/NewLDAPConnection1.png images/NewLDAPConnection2.png images/connectionProperties.png images/entryEditor.png images/passwordEditor.png

Author: elecharny
Date: Mon Oct 29 14:46:34 2012
New Revision: 1403328

URL: http://svn.apache.org/viewvc?rev=1403328&view=rev
Log:
added the 1.4.2 chapter

Added:
    directory/site/trunk/content/apacheds/basic-ug/images/NewLDAPConnection1.png   (with props)
    directory/site/trunk/content/apacheds/basic-ug/images/NewLDAPConnection2.png   (with props)
    directory/site/trunk/content/apacheds/basic-ug/images/connectionProperties.png   (with props)
    directory/site/trunk/content/apacheds/basic-ug/images/entryEditor.png   (with props)
    directory/site/trunk/content/apacheds/basic-ug/images/passwordEditor.png   (with props)
Modified:
    directory/site/trunk/content/apacheds/basic-ug/1.4.2-changing-admin-password.mdtext

Modified: 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=1403328&r1=1403327&r2=1403328&view=diff
==============================================================================
--- directory/site/trunk/content/apacheds/basic-ug/1.4.2-changing-admin-password.mdtext (original)
+++ directory/site/trunk/content/apacheds/basic-ug/1.4.2-changing-admin-password.mdtext Mon Oct 29 14:46:34 2012
@@ -24,4 +24,42 @@ Notice: Licensed to the Apache Software 
 
 # 1.4.2 - Changing the admin password
 
-TODO
\ No newline at end of file
+This section describes the steps necessary to change the administrator password. Follow the instructions provided here step by step.
+
+[TOC]
+
+## Step one: Changing the value in the system partition
+
+While the server is up and running, change the value of the _userPassword_ attribute of the admin (uid=admin,ou=system) via LDAP. There are several ways to accomplish this task. In the following, we use the Eclipse based Apache Directory Studio.
+
+A new LDAP connection with this tool is created via "New Connection ..." from the _Connections_ view. Enter your connection data in the first step ...
+
+![New LDAP connection](images/NewLDAPConnection1.png)
+
+... and in the next step, enter the admin DN _uid=admin,ou=system_ and the current password (default is "secret"). Saving the password is not necessary, we will change it anyway. 
+
+![New LDAP connection](images/NewLDAPConnection2.png)
+
+Click _Finish_ to establish the connection.
+
+Afterwards, modify the value of the _userPassword_ attribute of the entry _uid=admin,ou=system_. Navigate to the entry in the DIT (_LDAP Browser_ view), and double click the attribute in the _Entry Editor_ view:
+
+![Entry Editor](images/entryEditor.png)
+
+The Password Editor dialog shows up; enter the new password. You can optionally select a hash algorithm like _SHA_. In this case, the password will be stored one-way encrypted in the attribute value -- not a bad idea.
+
+![Password Editor](images/passwordEditor.png)
+
+Pressing _OK_ stores the new value. Close the connection and shutdown the server.
+
+## Step two: Verification
+
+Verify that you can login as admin with the new password. With Apache Directory Studio, you can change the properties of the existing connection profile via a right click in the _Connections_ view and a selection of the _Properties_ menu item. The following dialog appears:
+
+![Connection Properties](images/connectionProperties.png)
+
+Enter the new password and press _OK_. Establishing a connection should now work.  
+
+## Resources
+
+* [Apache Directory Studio](http://directory.apache.org/studio/): The tool used in steps 1 and 2

Added: directory/site/trunk/content/apacheds/basic-ug/images/NewLDAPConnection1.png
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/images/NewLDAPConnection1.png?rev=1403328&view=auto
==============================================================================
Binary file - no diff available.

Propchange: directory/site/trunk/content/apacheds/basic-ug/images/NewLDAPConnection1.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: directory/site/trunk/content/apacheds/basic-ug/images/NewLDAPConnection2.png
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/images/NewLDAPConnection2.png?rev=1403328&view=auto
==============================================================================
Binary file - no diff available.

Propchange: directory/site/trunk/content/apacheds/basic-ug/images/NewLDAPConnection2.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: directory/site/trunk/content/apacheds/basic-ug/images/connectionProperties.png
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/images/connectionProperties.png?rev=1403328&view=auto
==============================================================================
Binary file - no diff available.

Propchange: directory/site/trunk/content/apacheds/basic-ug/images/connectionProperties.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: directory/site/trunk/content/apacheds/basic-ug/images/entryEditor.png
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/images/entryEditor.png?rev=1403328&view=auto
==============================================================================
Binary file - no diff available.

Propchange: directory/site/trunk/content/apacheds/basic-ug/images/entryEditor.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: directory/site/trunk/content/apacheds/basic-ug/images/passwordEditor.png
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/apacheds/basic-ug/images/passwordEditor.png?rev=1403328&view=auto
==============================================================================
Binary file - no diff available.

Propchange: directory/site/trunk/content/apacheds/basic-ug/images/passwordEditor.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream