Sun Java System Directory Editor 1 2004Q4 Release Notes |
Sun Java System Directory Editor
Release NotesVersion 1 2004Q4
Part Number 819-1080-10
These Release Notes contain important information available at the time of release of Sun Java System Directory Editor 1 2004Q4. New features and enhancements, known issues and limitations, and other information are addressed here. Read this document before you begin using Directory Editor 1 2004Q4.
The most up-to-date version of these release notes can be found at the Sun Java System documentation web site: http://docs.sun.com/db/prod/sjs.diredit. Check the web site prior to installing and setting up your software and then periodically thereafter to view the most up-to-date release notes and product documentation.
These release notes contain the following sections:
Third-party URLs are referenced in this document and provide additional, related information.
Release Notes Revision History
Table 1 Revision History
Date
Description of Changes
October 26, 2004
Initial Beta release.
November 22, 2004
Initial release of these release notes
About Directory Editor 1 2004Q4Directory Editor is J2EE-based web application that enables you to quickly and easily manage your directory data.
Directory Editor:
- Provides an easy-to-use, directory editing tool that is appropriate for administrators and end-users
- Provides ability to create/edit users, groups, containers, and more
- Supports many concurrent users
- Supports large directory installations
- Supports extensive customizations, branding, and embedding
- Supports private data transmissions with the client browser and the directory
- Provides built-in authorization to limit visible menus to users’ roles
This section includes:
Supported Software Environments
This section lists the software and environments that are compatible with Directory Editor:
Operating Systems
Directory Editor is compatible with the following operating systems:
Application Servers
Directory Editor supports any application server that supports Servlet 2.2 or later and JRE 1.4 or later, but Directory Editor operates most efficiently with the following application servers:
Browsers
Directory Editor is compatible with the following browsers:
Directory Servers
You must use Directory Editor with Sun Java System Directory Server version 5.0 or later, which provides enhanced functionality and optimal performance.
Important InformationThis section contains the important information that is not contained in the Directory Editor product documentation. This section includes the following topics:
Compatibility Issues
You must install Java Runtime Environment (JRE) version 1.4 or later, or problems may occur with your Directory Editor installation.
Directory Editor requires access to some privileged operations that the application server may not allow by default. Edit the security policy file for your application server and grant access to certain actions, as follows:
- Open the server.policy file.
- Add the following lines to the end of the block granting access to “all remaining code”:
permission javax.security.auth.AuthPermission "getLoginConfiguration";
permission javax.security.auth.AuthPermission "setLoginConfiguration";
permission javax.security.auth.AuthPermission "createLoginContext.SunDirectoryLogin";
permission javax.security.auth.AuthPermission "modifyPrincipals";
- Save the file.
- Restart the application server
Running the Software in Your Environment
It is strongly recommended that you to back-up existing directory data before installing Directory Editor. Follow your normal backup procedures or the procedures listed in the documentation here:
http://developers.sun.com/prodtech/dirserver/reference/techart/bestpractices.html#12
Documentation
The Sun Java System Directory Editor product documentation is provided in the downloaded archive and on the web at http://docs.sun.com/db/prod/sjs.diredit. These publications provide information about common installation, configuration, and customization scenarios.
Installation Notes
Note
Before installing Directory Editor, be sure to read the “<TB Book_topic>Before You Install” chapter provided in the Sun Java System Directory Editor Installation and Configuration Guide.
Directory Editor has two logical connections, one to a place in which to store configuration information, the other to a directory to manage. Configuration information is stored under ou=Services, ou=DML, ou= 1.0 in applicationProcess objects. No configuration or management objects are placed in the managed directory.
After installing the dml.war file and browsing to the application context (http://<appserver>/dml), a form with information to connect to the configuration directory is shown. Directory Editor writes the contents of this form to the WEB-INF/classes/startup.properties file and encrypts the password for privacy.
Be sure to use credentials with sufficient rights to create the ou=Services, ou=DML, ou= 1.0 path and to add applicationProcess objects. Directory Editor uses these credentials to manage its configuration directory only.
After Directory Editor successfully connects to the configuration directory, creates the ou=Services, ou=DML, ou= 1.0 path, and stores the configuration information a second form for the managed directory is displayed. Then, after successfully connecting to the managed directory, a login screen is shown. To change the startup or managed directory settings, go to the Configure menu and click Startup or Managed Directory.
See the Sun Java System Directory Editor Release Notes for more details about this process.
Known Issues and LimitationsThe following table lists known issues with Directory Editor:
Table 2 Known Issues and Limitations
Defect ID
Summary
7493
Clicking very quickly between tabs on the Search page can cause a message:
The form already has been submitted.7544
If you use SSL to connect to a server on a port that is not using SSL, then the connection will hang. Similarly, if you use a plain socket to connect to a server's SSL socket, then the connection will hang.
This is a characteristic of the SSL protocol taken fromhttp://java.sun.com/products/jndi/tutorial/ldap/security/ssl.html
7580
If a Directory Editor user is logged in, and then another Directory Editor administrator or another LDAP client changes their password, then the user's actions in Directory Editor will fail with authentication errors. The user must log out and log in again to update their credentials.
7769
From the Group Edit/Create page, the "Remove Members" and "Show Members" searches may not show results that the user expects.
Directory Editor filters these searches using filters supplied by the user, along with checking for group membership. If a user adds members to the group with the Add Member feature, the members will not be included in the "Remove Members" and "Show Members" search results until the group has been saved.
7916
If you change the identity of the configuration directory access user on the Startup Properties page, Directory Editor will not initialize and will display the following error
Failed to initialize configuration at '<naming context>'"
To work-around this issue, modify the ACI on the ou=Services, ou=DML entry to allow access for the new access user.
8073
When an object's DN has multiple naming attributes, Directory Editor sometime displays an incorrect DN on the Edit page. For example, display an entry with the DN uid=john+employeeNumber=1234,ou=People,dc=sun,dc=com might display on the Edit page as employeeNumber=1234+uid=john,ou=People,dc=sun,dc=com. This issue is just a display problem.
8156
When you edit an object, the attributes that display are restricted to the attributes that have fields defined in the form. To display all attributes for an object, use the default form.
8185
On the Create Object page, Directory Editor does not calculate the cn until the page is refreshed.
8205
If you change the Manager Group to an empty group, Directory Editor cannot be managed. Adding a member back to the Manager Group will restore the functionality.
8214
The Enable and Disable buttons are active for all object types, but they should be disabled for non-user types.
8216
If you edit a form, use the Back button, and then edit a different form the wrong form might display.
Click Cancel instead of using the Back button.8255
Objects with characters that require escaping will be displayed with backslashes+
in the Edit Object page title. Special characters are single and double quotes, and backslashes.
Redistributable FilesSun Java System Directory Editor does not contain any files that you can redistribute.
How to Report Problems and Provide FeedbackIf you have problems with Sun Java System Directory Editor, contact Sun customer support using one of the following mechanisms:
- Sun Software Support services online at
http://www.sun.com/service/sunone/softwareSo that we can best assist you in resolving problems, please have the following information available when you submit a problem report using the preceding website:
- Description of the problem, including the situation where the problem occurs and its impact on your operation
- Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem
- Detailed steps on the methods you used to reproduce the problem
- Any error logs or Java stack traces produced from the error
Additional Sun ResourcesUseful Sun Java System information can be found at the following Internet locations:
- Documentation for Sun Java System Directory Editor 1
http://docs.sun.com/db/prod/sjs.diredit- Sun Java System Documentation
http://docs.sun.com/prod/sunone- Sun Java System Professional Services
http://www.sun.com/service/sunps/sunone- Sun Java System Software Products and Service
http://www.sun.com/software- Sun Java System Software Support Services
http://www.sun.com/service/sunone/software- Sun Java System Support and Knowledge Base
http://www.sun.com/service/support/software- Sun Support and Training Services
http://training.sun.com- Sun Java System Consulting and Professional Services
http://www.sun.com/service/sunps/sunone- Sun Java System Developer Information
http://sunonedev.sun.com- Sun Developer Support Services
http://www.sun.com/developers/support- Sun Java System Software Training
http://www.sun.com/software/training- Sun Software Data Sheets
http://wwws.sun.com/software
Copyright © 2004 Sun Microsystems, Inc. All rights reserved.
Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S. and in other countries.
SUN PROPRIETARY/CONFIDENTIAL.
U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements.
Use is subject to license terms.
This distribution may include materials developed by third parties.
Portions may be derived from Berkeley BSD systems, licensed from U. of CA.
Sun, Sun Microsystems, the Sun logo, Java and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries.
Copyright © 2004 Sun Microsystems, Inc. Tous droits réservés.
Sun Microsystems, Inc. détient les droits de propriété intellectuels relatifs à la technologie incorporée dans le produit qui est décrit dans ce document. En particulier, et ce sans limitation, ces droits de propriété intellectuelle peuvent inclure un ou plus des brevets américains listés à l'adresse http://www.sun.com/patents et un ou les brevets supplémentaires ou les applications de brevet en attente aux Etats - Unis et dans les autres pays.
Propriété de SUN/CONFIDENTIEL.
L'utilisation est soumise aux termes du contrat de licence.
Cette distribution peut comprendre des composants développés par des tierces parties.
Des parties de ce produit pourront être dérivées des systèmes Berkeley BSD licenciés par l'Université de Californie.
Sun, Sun Microsystems, le logo Sun, Java et Solaris sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.
Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc. aux Etats-Unis et dans d'autres pays.