14 Managing Oracle Virtual Directory Mappings

This chapter explains how to manage Oracle Virtual Directory mappings and includes the following topics:

Constructing Mappings Using Mapping Templates
Creating and Activating Server Mappings
Applying Mappings to Adapters

14.1 Constructing Mappings Using Mapping Templates

Oracle Virtual Directory includes mapping templates that act as a macro and enable you to quickly construct Mappings. The following steps explain how to construct, compile, and deploy Mappings to the Oracle Virtual Directory server so they are available to be activated at both the adapter and server levels.

Perform the following steps to construct, compile, and deploy Mappings to the Oracle Virtual Directory server using Oracle Directory Services Manager's Mapping Templates feature:

Note:

If you are managing multiple Oracle Virtual Directory servers from multiple Oracle Directory Services Manager sessions that run from the same Oracle Directory Services Manager component and you construct and then save different mapping templates to each Oracle Virtual Directory server continuously (meaning back-to-back, within 10 seconds of each other), the most recent mapping template will be saved to all servers.

This issue occurs because the same Oracle Directory Services Manager work directory is shared between all of the Oracle Virtual Directory servers managed by a single Oracle Directory Services Manager component.

To avoid this issue, be sure you wait more than 10 seconds before attempting to save the mapping templates to the different Oracle Virtual Directory servers.

Log in to Oracle Directory Services Manager.
Select Advanced from the task selection bar. The Advanced navigation tree appears.
Expand the Mapping Templates entry in the Advanced tree. The list of Mapping templates appear.
Determine which Mapping template you want to use to construct your Mapping by referring to "Understanding Mapping Templates".

After you determine which Mapping template you want to use, click the name of the template. The Mapping Parameters for the Mapping template you selected appear in the main screen.
Enter values for the attributes in the Mapping template by performing the following steps:
1. Click the attribute in the Mapping Parameters table to edit. The current value for the attribute appears.
2. Enter a new value for the attribute in the Value field and click OK. The new value for the attribute appears in the Mapping Parameters table.
Repeat this step until you have set values for all the desired attributes in the Mapping.
Click Apply at the top of the Mapping Templates screen.

After you click Apply, Oracle Directory Services Manager complies the Mapping template into a Mapping script and sends it to the Oracle Virtual Directory server so that it is available to be activated at the adapter or global server level.
Refer to "Viewing Deployed Mappings" to verify the Mapping was deployed to the Oracle Virtual Directory server.

14.1.1 Viewing Deployed Mappings

You can view a list of the Mappings that have been deployed to the Oracle Virtual Directory server and that can be activated for use by performing the following steps:

Log in to Oracle Directory Services Manager.
Select Advanced from the task selection bar. The Advanced navigation tree appears.
Expand the Deployed Mappings entry in the Advanced tree. A list of the Mappings that have been deployed to the Oracle Virtual Directory server and that can be activated for use appears in the Advanced tree.

14.2 Creating and Activating Server Mappings

This section describes how to create and activate Mappings at a global server level. Refer to "Applying Mappings to Adapters" for information on activating Mappings at an adapter level.

Perform the following steps to create and activate a Mapping at a global server level using Oracle Directory Services Manager:

Note:

Before you can create and activate a Mapping, the Mapping file must reside on the Oracle Virtual Directory server. Refer to "Constructing Mappings Using Mapping Templates" for information on constructing and deploying Mappings.

Log in to Oracle Directory Services Manager.
Select Advanced from the task selection bar. The Advanced navigation tree appears.
Expand the Global Plugins entry in the Advanced tree.
Click the Create Mapping button at the top of the Global Plugins entry in the Advanced tree. The Mapping dialog box appears.
Enter a name in the Name field to describe the Mapping. This name is used to identify and describe the Mapping, not to name the actual Mapping script file.
Enter the path to the Mapping script file in the Mapping File field, or click Select, navigate to the Mapping script file, select it, and then click OK.
Determine where you want the Mapping to execute. The Mapping can execute at specific location in the virtual directory or at a global server level spanning the entire virtual tree.

To execute the Mapping at a global server level, leave the Namespaces table empty and click OK to activate the Mapping for the entire virtual tree.

To execute the Mapping at a specific location in the virtual tree, perform the following steps:
1. Click the Create Namespace button in the Namespaces table.
2. Enter the location of the virtual tree where you want the Mapping to execute in the Namespace field.
  
  Create multiple Namespaces to have the Mapping execute at multiple specific locations in the virtual tree.
3. Click OK to activate the Mapping at the specific locations in the virtual tree.
Refer to "Viewing Activated Server Mappings" to verify the Mapping was activated.

14.2.1 Viewing Activated Server Mappings

You can view a list of the Mappings that have been activated at the server level—not adapter level—by performing the following steps:

Log in to Oracle Directory Services Manager.
Select Advanced from the task selection bar. The Advanced navigation tree appears.
Expand the Global Plugins entry in the Advanced tree. A list of the activated Mappings and plug-ins appears in the Advanced tree.

14.3 Applying Mappings to Adapters

Perform the following steps to apply a mapping to an adapter using Oracle Directory Services Manager:

Note:

Before you can apply a Mapping to an adapter, the Mapping file must reside on the Oracle Virtual Directory server. Refer to "Constructing Mappings Using Mapping Templates" for information on constructing and deploying Mappings to the Oracle Virtual Directory server.

Log in to Oracle Directory Services Manager.
Select Adapter from the task selection bar. The Adapter navigation tree appears.
Click the name of the adapter in the tree to apply the mapping to. The adapter's settings screen appears.
Click the Plug-ins tab. The adapter's plug-ins screen appears.
Click the Create Mapping button. The Mapping dialog box appears.
Enter a name in the Name field to describe the Mapping. This name is used to identify and describe the Mapping, not to name the actual Mapping script file.
Enter the path to the Mapping script file in the Mapping File field, or click Select, navigate to the Mapping script file, select it, and then click OK.
Determine where you want the Mapping to execute. The mapping can execute at a specific location under the adapter namespace or at the adapter namespace itself, thus spanning the entire adapter.

To execute the Mapping at the adapter level, leave the Namespaces table empty and click OK to activate the Mapping for the entire adapter.

To execute the Mapping at a specific location under the adapter, perform the following steps:
1. Click the Create Namespace button in the Namespaces table.
2. Enter the location of the virtual tree where you want the Mapping to execute in the Namespace field.
  
  Create multiple Namespaces to have the Mapping execute at multiple specific locations in the virtual tree.
3. Click OK to activate the Mapping at the specific locations in the virtual tree.
Click Apply on the adapter's plug-ins screen to apply the mapping to the adapter.