Sun Java System Directory Editor 1 2004Q4 Release Notes

Sun Java™ System Directory Editor
Release Notes

Version 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.


Note

Sun is not responsible for the availability of third-party Web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.



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 2004Q4

Directory Editor is J2EE-based web application that enables you to quickly and easily manage your directory data.

Directory Editor:

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 Information

This 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:

  1. Open the server.policy file.
  2. Add the following lines to the end of the block granting access to “all remaining code”:
  3. 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";

  4. Save the file.
  5. 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 Limitations

The 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 from

http://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 Files

Sun Java™ System Directory Editor does not contain any files that you can redistribute.


How to Report Problems and Provide Feedback

If you have problems with Sun Java™ System Directory Editor, contact Sun customer support using one of the following mechanisms:

So 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:


Additional Sun Resources

Useful Sun Java™ System information can be found at the following Internet locations:

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.