Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Directory Editor 1 2004Q4 Installation and Configuration Guide 

Chapter 3
Getting Started

This chapter provides an overview of the Directory Editor’s graphical user interface and major features. The information in this chapter is organized as follows:

Product Features

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

Logging In

When the Directory Editor Log In page is displayed (see Figure 3-1), enter your credentials (user name and password) for full access.

Figure 3-1  Directory Editor Log In Page

Enter your user name and password on the Directory Editor log in page.

Note

  • If you enable the Log In Anonymously checkbox, you will have access to Directory Editor’s Home, Browse, and Search pages only. You cannot access the Create or Configure pages.
  • After your initial log in, the log in screen (Figure 3-1) will display every time you open Directory Editor.

When you log in successfully, the Directory Editor Home page is displayed.
(See Navigating Directory Editor for an overview of this, and other, Directory Editor pages.)

Changing Your LDAP Password

Note

If your password is about to expire, Directory Editor will display a warning message and allow you to change your password. However; if your password has already expired, you cannot log into Directory Editor until your system administrator resets your password.

To change your LDAP password, use the following steps:

  1. From the Home page, click the Change My Directory Password link.
  2. When the Edit Password page is displayed (Figure 3-2), type a password in the Password text box.

    3. Figure 3-2  Edit Password Page
    Use the Edit Password page to enter and confirm a new password.

  3. Retype the password in the Confirm Password text box.
  4. Click the Save button when you are finished to save the password (or click Cancel to return to the Home page without saving the password).

When you log in successfully, the Directory Editor Home page is displayed.

Navigating Directory Editor

After logging into Directory Editor as an administrator, the Home page displays as shown in the following figure:

Figure 3-3  Directory Editor Home Page

Use the Home page to navigate to all other Directory Editor pages.

Note

If your page looks different than the one shown in the preceding figure, you may have specified credentials for an account that is not a member of the Manager Group you specified in Step 5: Specify the Managed Directory Properties.

The Home page contains a list of tasks commonly performed with Directory Editor. Click any of the links on this page to perform the task described, as follows:

The following options (located in the upper-right corner of the application window) are also available from all Directory Editor web pages:

Browsing Directories

Select the Browse tab to browse the contents of the directory.

Initially, only the top-level directory objects (based on object class) are displayed in tree view, as follows,

Click the node key to view the contents of that folder. If there are more than 100 objects in that folder, then a link to the Search page will be displayed instead.

Note

  • If you click the folder icon or directory name, the Edit page is displayed so you can edit that object. For example, if you select cn=Directory Administrators you can edit the object name, the availability of people in the group, add or remove members, and view statistics. Instructions for editing objects are provided in Chapter 4, "Creating and Editing Objects."
  • You can change the default limit for the number of objects displayed in a folder, by selecting Configure > Search Options. When the Search Configuration page is displayed, change the Number of Results value.

Using the Browse Button

Many Directory Editor pages provide a Browse button to help you locate information you must provide to complete a task.

For example, when creating a new object, you must provide a parent entry (the name of the context) where you are going to add the object.

  1. Click the Browse button to open a Browse dialog box, as follows:

    2. Figure 3-5  Example Browse Dialog Box
    Use the Browse dialog box to locate and select parent entries (context names).

  2. In this dialog box, navigate within the tree to locate the appropriate parent entry (or context name).
  3. Click the entry to select it.

    4. For example, you might want to add a new user entry under the People node.

  4. When you have made your selection, click OK to save your selection and return to the Create page.

    5. Directory Editor then enters the context information into the Parent Entry text box.

    Figure 3-6  Completed Parent Entry Text Box
    Select a new object type and specify the parent entry.

Running in Non-Production Mode

You must give Directory Editor permission to write to the application server file system, or Directory Editor can only run in non-production mode, which means the product cannot save it’s startup properties to the file system.

If you are just evaluating Directory Editor, you may want to run the product in non-production mode.

To run Directory Editor in non-production mode (evaluation mode):

  1. Temporarily remove the Directory Editor permissions from your catalina.policy file.
  2. Start Tomcat (or your application server) with the -security flag.
  3. Re-deploy the Directory Editor application and go through the initial configuration steps described in Chapter 2, "Installing Directory Editor."

    4. A message prompt is displayed to warn you that Directory Editor cannot write its Startup properties, and asking if you want to continue in non-production mode. If you respond Yes, Mode: NON-PRODUCTION will display in the title bar.

  4. Click the Continue button to proceed with your evaluation.

Using Online Help

Directory Editor provides an online help tool that you can use to quickly and easily locate information about the product

To use the online help,

  1. Click the Help link located in the upper right corner of the Directory Editor browser window.

    2. Figure 3-7  Online Help Link
    Click the Help link to access the Directory Editor online help.

    A new, separate window is displayed as follows:

    Figure 3-8  Online Help Window
    Directory Editor online help window.

  2. Use the following features to navigate in the Help window and to locate information about Directory Editor:
    • Contents tab: Lists all available help topics. Click a topic name to display the help content in the information pane (located on the right side of the Help window).
    • Index tab: Contains an index of terms and topics. Click an index entry to display the help content in the information pane.
    • Search tab: Enter a text string into the text box and press the Return (Enter) key to search for help content associated with that string.
    • Back and Forward buttons: Click the Back button to display to the previous help topic in the information pane or click the Forward button to display to the next help topic.
    • Print button: Click this button to print the content displayed in the right pane. A standard Print dialog will display so you can specify print settings and select a printer.
  3. Click the Close button to close the Help window.


Previous      Contents      Index      Next     

Part No: 819-1078-10.   Copyright 2004 Sun Microsystems, Inc. All rights reserved.