Stopping the Oracle Virtual Directory Server Using OPMNCTL

11 Creating and Managing Oracle Virtual Directory Listeners 11-1 11 Creating and Managing Oracle Virtual Directory Listeners This chapter explains how to create Oracle Virtual Directory Listeners and includes the following topics: ■ What is a Listener? ■ Understanding the Default Oracle Virtual Directory Listeners ■ Configuring Oracle Virtual Directory to Listen on Privileged Ports ■ Creating and Managing Listeners Using Fusion Middleware Control ■ Managing Listeners Using WLST ■ Securing Listeners with SSL 11.1 What is a Listener? Oracle Virtual Directory provides services to clients through connections known as Listeners. Oracle Virtual Directory supports the following two types of Listeners: ■ LDAP: provides LDAPv2v3 based services ■ HTTP: provides one or more services such as DSMLv2, or basic white page functions provided by an XSLT enabled Web Gateway An Oracle Virtual Directory configuration can have any number of Listeners or it can even have zero Listeners, thus restricting access to only the administrative gateway. Most Oracle Virtual Directory deployments need no more than two HTTP Listeners and two LDAP Listeners, where one Listener is for SSL and one for non-SSL for each protocols.

11.2 Understanding the Default Oracle Virtual Directory Listeners

Oracle Virtual Directory includes two Listeners by default: an HTTP Listener named Admin Gateway and an LDAP Listener named LDAP SSL Endpoint. Note: You must explicitly stop and start Oracle Virtual Directory—not Restart—to load Listener configurations to the Oracle Virtual Directory server. This includes after creating, updating, or deleting a Listener. 11-2 Oracle Fusion Middleware Administrators Guide for Oracle Virtual Directory Admin Gateway The HTTP Listener named Admin Gateway is the interface the Oracle Virtual Directory server uses to communicate with the Oracle Directory Services Manager and Oracle Enterprise Manager Fusion Middleware Control user interfaces. You cannot communicate with the Oracle Virtual Directory using the Oracle Directory Services Manager and Oracle Enterprise Manager Fusion Middleware Control user interfaces if you disable the Admin Gateway Listener. Refer to Editing the Oracle Virtual Directory Administrative Listener Settings for more information about editing the Oracle Virtual Directory Administrative Listener settings. LDAP SSL Endpoint The LDAP Listener named LDAP SSL Endpoint is the interface Oracle Virtual Directory uses to provide performance metrics in Oracle Enterprise Manager Fusion Middleware Control. LDAP SSL Endpoint should always be enabled and secured using SSL Server Authentication. Do not delete or disable LDAP SSL Endpoint. If you need an LDAP Listener that is secured using a different SSL mode, create a new Listener using Oracle Enterprise Manager Fusion Middleware Control.

11.2.1 Managing Communication Between Oracle Virtual Directory and Fusion Middleware Control

The communication between Oracle Virtual Directory and Oracle Enterprise Manager Fusion Middleware Control will be disrupted if you edit any of the following settings for the default Listeners Admin Gateway and LDAP SSL Endpoint: ■ Listener Host ■ Listener Port ■ Enable Disable SSL If you edit any of these settings for the default Listeners, you must update the Oracle Enterprise Manager Fusion Middleware Control target discovery information so Oracle Virtual Directory and Oracle Enterprise Manager Fusion Middleware Control can communicate. To update the Oracle Enterprise Manager Fusion Middleware Control target discovery information, perform the following steps: 1. Log in to Oracle Enterprise Manager Fusion Middleware Control.

2. Right-click the Farm entry in the navigation tree and select Agent-Monitored

Targets . The Agent-Monitored Targets screen appears.

3. Click the Configure button for the appropriate Oracle Virtual Directory target in

the Targets table. The Configure Target page appears. 4. Update the following settings according to your current Oracle Virtual Directory environment and click OK at the top of the Configure Target page: ■ Machine name ■ Virtual Directory Admin Port ■ Virtual Directory LDAP Port See Also: The Troubleshooting appendix of the Oracle Fusion Middleware Administrators Guide.