Chapter 4. Using Penrose Studio

Chapter 4. Using Penrose Studio

4.1. Installing Penrose Studio
4.1.1. Supported Platforms
4.1.2. Installing Penrose Studio on Red Hat Enterprise Linux
4.1.3. Installing Penrose Studio on Windows
4.2. Starting Penrose Studio
4.2.1. Starting Penrose Studio on Red Hat Enterprise Linux
4.2.2. Starting Penrose Studio on Windows
4.3. Looking at Penrose Studio
4.4. Editing, Copying, and Deleting Entries
4.4.1. Viewing and Editing Entries
4.4.2. Deleting Entries
4.4.3. Copying Entries to Another Penrose Server Instance
4.5. Browsing the LDAP Directory

Penrose Studio is the graphical interface to access, modify, and manage Penrose Server and its entries. This is a simple, elegant interface, making it much easier to configure complex mappings, virtual directory hierarchies, and identity federation, synchronize NIS and LDAP environments, resolve UID conflicts, and migrate data between servers.

This chapter describes how to install and start Penrose Studio and gives an overview of its menus and different areas.

4.1. Installing Penrose Studio


If you have problems connecting to Penrose Server from Penrose Studio, check the Penrose Server configuration and make sure that the java.rmi.server.hostname in the /opt/vd-server-2.0/conf/server.xml files has been changed to the specific hostname or IP address of the Penrose Server host machine, rather than using the default value of localhost.

Penrose Studio is very simple to navigate. There are two main sections. The navigation tree on the left organizes all of the partitions, directories, mappings, and other configurations for a Penrose Studio instanc. The main window displays and edits entries and contains the integrated LDAP directory browser.

Figure 4.1, “Penrose Studio Window” shows the major sections of the Penrose Studio interface.

Penrose Studio Window
Figure 4.1. Penrose Studio Window

The File manages servers. All if the actions in the file menu are mirrored in the icons below it, managing the Penrose Server instance by stopping and starting it, synchronizing the Penrose Studio changes, and adding and deleting server entries.

Top Menu
Figure 4.2. Top Menu

Three other menus in the top menu, the Partition, Schema, and Service menus, have the same operations that are available by right-clicking on the corresponding folders in the server navigation areas, such as exprting a partition, importing a schema, or configuring a new service.

Both the Tools menu and the last icon below the top menu open Penrose Virtual Directory's LDAP browser.

The last menu, Window, controls which of the three sections in the lower window are visible, meaning the server navigation area, main entry window, and validation window.

The server window, shown in Figure 4.3, “Server and Entry Navigation”, is a hierarchical organization of the server, its partitions, mappings, sources, connections, and repositories along with its backend configuration settings, schema, logging, plug-ins, and services.

Server and Entry Navigation
Figure 4.3. Server and Entry Navigation

Double-clicking or opening any entry in the server window opens the editor for that entry in the main window, as in Figure 4.4, “Main Window for Editing Entries”.

Main Window for Editing Entries
Figure 4.4. Main Window for Editing Entries

The configuration of the entry can be changed in several areas:

  • Changing the descriptions in fields and adding or removing Java classes which define functionality

  • Adding or removing attributes

  • Changing the parameters set for attributes; entries in table rows can be double-clicked to allow additional configuration options

Depending on the complexity or type of entry, there may be tabs at the bottom of the main window which open additional editing windows for the entry or browsers to display the virtual directory or entry hierarchy.

All of the windows and the entries within the windows are tabbed, to keep the overall navigation clean and easy to view.

Every window, meaning the server, entry editor, and validation windows, is controlled independently. To minimize or maximize the window in the Penrose Studio space, click the small line and box icons in the right corner of the entry. To close the window, click the X icon by the window name.

Window Controls
Figure 4.5. Window Controls


Changes to an entry are saved when the window is closed.

Almost every entry for the virtual directory configuration — such as mappings, subtrees, repoositories, sources, and connections — has several options available to open, edit, delete, copy, or paste the entry. This is illustrated for a mapping in Figure 4.6, “Entry Menu Options”. Some kinds of entries, including partitions and schema, can be imported and exported.

Entry Menu Options
Figure 4.6. Entry Menu Options

Penrose Studio also provides a built-in LDAP directory browser, which can be used to view the virtual directory or any of the sources or connections for the virtual directory.

Almost every virtual directory configuration entry has a browser tab at the bottom of its entry window, to view the entries within the source or connection.

The browser can also be opened in the top menu or by clicking the browser icon in the top menu.

When the ldap browser is opened through the menu options, the connection information has to be entered in a dialog box, then the browser opens. When choosing a virtual directory entry to browse, the connection information is already given.