Set the primary adapters visibility to internal as the Shadow Join will be the

13 Managing Oracle Virtual Directory Plug-ins 13-1 13 Managing Oracle Virtual Directory Plug-ins This chapter explains how to manage Oracle Virtual Directory plug-ins and includes the following topics: ■ Managing Adapter Plug-ins ■ Managing Global Server Plug-ins

13.1 Managing Adapter Plug-ins

This topic explains various tasks for managing Adapter plug-ins and contains the following sections: ■ Creating Adapter Plug-Ins ■ Configuring Adapter Plug-Ins to Execute Only on Specific Operations ■ Editing Adapter Plug-Ins ■ Deleting Adapter Plug-Ins

13.1.1 Creating Adapter Plug-Ins

After you create an adapter you can create Plug-ins for the adapter. Perform the following steps to create a plug-in for an adapter using Oracle Directory Services Manager: 1. Log in to Oracle Directory Services Manager.

2. Select Adapter from the task selection bar. The Adapter navigation tree appears.

3. In the adapter tree, click the name of the adapter for which to create a plug-in. The adapter’s configuration appears.

4. Click the Plug-Ins tab.

Note: The Performance Monitor plug-in is added to all adapters by default after the adapter is created, which enables Oracle Enterprise Manager Fusion Middleware Control to display performance metrics for each adapter. See Also: Understanding Oracle Virtual Directory Plug-Ins on page 4-1 13-2 Oracle Fusion Middleware Administrators Guide for Oracle Virtual Directory

5. Click the Create Plug-In button. The Plug-In dialog box appears.

6. Enter a name for the Plug-in in the Name field.

7. Enter the Plug-in class name in the Class field, or click Browse, then select the

plug-in from the Plug-In Selection box, and then click OK. 8. Add parameters and values to the Plug-in by clicking the Create Parameter button in the Parameters table, selecting a parameter from the Name list, and entering a value for the parameter in the Value field.

9. Add namespaces to the Plug-in by clicking the Create Namespace button in the

Namespace table and entering a value for the namespace in the Namespace field.

10. Click OK to save the plug-in settings. The plug-in is added to the table of

deployed plug-ins for the adapter on the adapter screen. 11. Optionally, you can configure the plug-in to execute on specific operations, such as Bind, Add, Get, and so on. Refer to Configuring Adapter Plug-Ins to Execute Only on Specific Operations for more information.

12. Click the Apply button on the adapter screen to associate the plug-in with the

adapter.

13.1.2 Configuring Adapter Plug-Ins to Execute Only on Specific Operations

You can configure adapter plug-ins to execute only on specific operations, such as Bind, Add, Get, and so on. You can also configure the order sequence in which adapter plug-ins execute on specific operations. Perform the following steps to configure adapter plug-ins to execute only on specific operations and in a specific order:

1. Log in to Oracle Directory Services Manager.

2. Select Adapter from the task selection bar. The Adapter navigation tree appears.

3. Click the name of the adapter that contains the plug-in you want to configure. The

adapter’s configuration appears in the main screen.

4. Click the Plug-Ins tab.

5. Select the operation you want a plug-in to specifically operate on from the Select

Operation list. For example, select Get to configure a plug-in to operate only on the get operation.

6. Click the Edit Plug-Ins pencil button in the Plug-ins for Specific Operation table.

For example, if you selected the Get operation in the Select Operation list, the table is labeled Plug-ins for Get Operation. Note: The following steps assume the plug-in has already been created and deployed to the adapter. If this is not the case, refer to Creating Adapter Plug-Ins to create the plug-in before performing the following steps. Note: The label for this table changes according to the operation selected in the Select Operation list. Managing Oracle Virtual Directory Plug-ins 13-3 After you click the Edit Plug-Ins pencil button, the Select and Order the Plug-ins dialog box appears. The All Plug-ins field on the left of the dialog box lists all plug-ins deployed on the adapter. The Selected Plug-Ins field on the right lists plug-ins that execute only on the specific operation selected in the Select Operation list.

7. Select the plug-ins you want to execute on the operation and use the Move and

Remove buttons to move the plug-ins to and from the Selected Plug-Ins field on the right. If multiple plug-ins are listed in the Selected Plug-Ins field, you can configure the order in which they will execute. 8. To change the order in which the adapter plug-ins execute on the operation, select one plug-in at a time in the Selected Plug-ins field and use the up and down arrow buttons on the right side of the Selected Plug-ins field to change the order.

9. Click Apply on the Select and Order the Plug-ins dialog box to save the changes.

The plug-ins appear in the Plug-ins for Specific Operation table in the order they will execute. 10. Optionally, you can set namespaces for operation-specific plug-ins to control the location in the virtual tree where they execute, by performing the following steps: a. Click the expandcollapse icon to left of the plug-in name in the Plug-ins for Specific Operation table. b. Enter the namespace in the Namespace field. c. Add or delete namespaces using the Add + and Delete X buttons near the namespace field.

11. Click the Apply button at the top of the adapter screen to save the changes.

13.1.3 Editing Adapter Plug-Ins

Perform the following steps to edit an existing plug-in for an adapter using Oracle Directory Services Manager:

1. Log in to Oracle Directory Services Manager.

2. Select Adapter from the task selection bar. The Adapter navigation tree appears.

3. Click the name of the adapter that contains the plug-in you want to edit in the

Adapter tree. The adapter’s configuration appears.

4. Click the Plug-Ins tab

5. Select the plug-in you want to edit from the table of existing plug-ins and click the

Edit PluginMapping button. The Plug-In dialog box appears displaying the plug-in’s settings.

6. Edit the plug-in as desired and click OK on the Plug-In dialog box.

7. Click the Apply button at the top of the adapter screen to save the changes.

Note: The plug-in at the top of the Selected Plug-ins field executes on the operation first, and then the remaining plug-ins in the field execute in a descending order.