This chapter explains how to manage Oracle Virtual Directory plug-ins and includes the following topics:
This topic explains various tasks for managing Adapter plug-ins and contains the following sections:
After you create an adapter you can create Plug-ins for the adapter.
Note:
The Performance Monitor plug-in is added to all adapters by default after the adapter is created. This enables Oracle Enterprise Manager Fusion Middleware Control to display performance metrics for each adapter.Perform the following steps to create a plug-in for an adapter using Oracle Directory Services Manager:
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 Adapter tree that you want to create a plug-in for. The adapter's configuration appears.
Click the Plug-Ins tab
Click the Create Plug-In button. The Plug-In dialog box appears.
Enter a name for the Plug-in in the Name field.
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.
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.
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.
Click OK to deploy the plug-in to the adapter. The plug-in is added to the table of existing plug-ins for the adapter on the adapter screen.
Click the Apply button on the adapter screen to associate the plug-in with the adapter.
Perform the following steps to edit an existing plug-in for an adapter using Oracle Directory Services Manager:
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 that contains the plug-in you want to edit in the Adapter tree. The adapter's configuration appears.
Click the Plug-Ins tab
Select the plug-in you want to edit from the table of existing plug-ins and click the Edit Plugin/Mapping button. The Plug-In dialog box appears displaying the plug-in's settings.
Edit the plug-in as desired and click OK on the Plug-In dialog box.
Click the Apply button at the top of the adapter screen to save the changes.
Perform the following steps to delete an existing plug-in for an adapter using Oracle Directory Services Manager:
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 that contains the plug-in you want to delete in the Adapter tree. The adapter's configuration appears.
Click the Plug-Ins tab
Select the plug-in you want to delete from the table of existing plug-ins and click the Delete Plugin/Mapping button. A confirmation dialog box appears asking you to confirm that you want to delete the plug-in from the adapter configuration.
Click the Confirm button on the confirmation dialog box to delete the plug-in. The plug-in is removed from the table of existing plug-ins.
Click the Apply button at the top of the adapter screen to save the changes.
This topic explains various tasks for managing server-level (Global) plug-ins and contains the following sections:
Perform the following steps to create a server-level plug-in using Oracle Directory Services Manager:
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 navigation tree.
Click the Create Plug-In button. The Plug-In dialog box appears.
Enter a name for the Plug-in in the Name field.
Enter the Plug-in class name in the Class field, or click Select, then select the plug-in from the Plug-In Selection box, and then click OK.
Add parameters and their 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.
Determine where you want the plug-in to execute. The plug-in can execute at specific location in the virtual directory or at a global server level spanning the entire virtual tree.
To execute the plug-in at a global server level, leave the Namespaces table empty and click OK to activate the plug-in for the entire virtual tree.
To execute the plug-in at a specific location in the virtual tree, perform the following steps:
Click the Create Namespace button in the Namespaces table.
Enter the location of the virtual tree where you want the plug-in to execute in the Namespace field.
Create multiple Namespaces to have the plug-in execute at multiple specific locations in the virtual tree.
Click OK to activate the plug-in at the specific locations in the virtual tree.
Refer to "Viewing Deployed Global Server Plug-ins" to verify the plug-in was activated.
You can view a list of the plug-ins that have been deployed 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 navigation tree. A list of the activated Mappings and plug-ins appears in the navigation tree.
Perform the following steps to edit an existing server-level plug-in using Oracle Directory Services Manager:
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 navigation tree. A list of the activated Mappings and plug-ins appears in the navigation tree.
Click the name of the plug-in you want to edit from the navigation tree. The plug-in's configuration appears.
Edit the plug-in as desired and click the Apply button at the top of the plug-in screen to save the changes.
Perform the following steps to delete an existing server-level plug-in using Oracle Directory Services Manager:
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 navigation tree. A list of the activated Mappings and plug-ins appears in the navigation tree.
Click the name of the plug-in you want to delete from the navigation tree. The plug-in's configuration appears.
Click the Delete button in the navigation tree. A confirmation dialog box appears asking you to confirm that you want to delete the plug-in.
Click the Delete button on the confirmation dialog box to delete the plug-in. The plug-in is removed from the list of existing plug-ins in the navigation tree.