Examples Copying Configuration Files Between Oracle Virtual Directory Servers Using syncovdconfig

10 Managing Oracle Virtual Directory Server Processes 10-1 10 Managing Oracle Virtual Directory Server Processes This chapter explains Oracle Virtual Directory process management using Oracle Process Manager and Notification Server and includes the following topics: ■ What is Oracle Process Manager and Notification Server? ■ Understanding the Default Oracle Virtual Directory Image ■ Creating an Oracle Virtual Directory Component Using OPMNCTL ■ Registering an Oracle Instance Using OPMNCTL ■ Unregistering an Oracle Instance Using OPMNCTL ■ Updating the Component Registration of an Oracle Instance Using OPMNCTL ■ Deleting an Oracle Virtual Directory Component Using OPMNCTL ■ Viewing Active Server Instance Information Using OPMNCTL ■ Starting the Oracle Virtual Directory Server Using OPMNCTL ■ Stopping the Oracle Virtual Directory Server Using OPMNCTL ■ Restarting the Oracle Virtual Directory Server Using OPMNCTL 10.1 What is Oracle Process Manager and Notification Server? The Oracle Process Manager and Notification Server OPMN is a daemon process that monitors Oracle Fusion Middleware components, including Oracle Virtual Directory. Oracle Enterprise Manager Fusion Middleware Control uses OPMN to stop or start Oracle Virtual Directory. From the command-line, you can use opmnctl, the command-line interface to OPMN, to perform the process management tasks for Oracle Virtual Directory that are documented in this chapter.

10.2 Understanding the Default Oracle Virtual Directory Image

When you install Oracle Virtual Directory on a host computer, the Oracle Identity Management 11g Installer creates: See Also: The Oracle Process Manager and Notification Server Administrators Guide for complete information about OPMN and the opmnctl command. 10-2 Oracle Fusion Middleware Administrators Guide for Oracle Virtual Directory ■ An Oracle Fusion Middleware component of Type=OVD in a new or existing Oracle instance. The Oracle Virtual Directory component name is usually ovd1 and the Oracle instance name is usually asinst_1. ■ File system directories under the Oracle instance directory. Some directory path names the installer creates are specific to the component name. For example, the path names under the Oracle instance on UNIX or Linux include: – ORACLE_INSTANCEconfigOVDovd1 – ORACLE_INSTANCEdiagnosticslogsOVDovd1 If you selected either the Create New Domain or Extend Existing Domain options during installation, the Oracle Virtual Directory component is registered with a WebLogic domain. If you selected the None option during installation, the Oracle Virtual Directory component is not registered with a domain. Oracle recommends registering the Oracle Virtual Directory component with a domain. You can register it from the command-line using opmnctl as described in this chapter. If you install multiple Oracle Virtual Directory components on multiple nodes using the Extend Existing Domain option during installation, the second and subsequent nodes will have component names of ovd2, ovd3 and so on.

10.3 Creating an Oracle Virtual Directory Component Using OPMNCTL

You create an Oracle Virtual Directory component in an Oracle instance by using opmnctl createcomponent. The following is the syntax for creating an Oracle Virtual Directory component using opmnctl createcomponent: ORACLE_INSTANCEbinopmnctl createcomponent [-adminHost hostname] [-adminPort weblogic_port] [-adminUsername weblogic_admin] [-adminPasswordFile ‘FILE_WITH_WEBLOGIC_ADMIN_PASSWORD’] -componentType OVD -componentName componentName [-passwordFile FILE_WITH_OVD_ADMIN_PASSWORD] [-admin cn=orcladmin] [-isAdminSSL true | false ] [-ovdAdminPort OVD_ADMIN_GATEWAY_PORT] [-namespace dc=us,dc=oracle,dc=com] [-ldapPort LDAP_PORT] [-ldapSport SSL_ENABLED_LDAP_PORT] [-httpPort HTTP_PORT] [-isHttpSSL true | false] You can use several parameters with the opmnctl createcomponent command. The following is a list of parameters that are specific to Oracle Virtual Directory. Refer to the Oracle Process Manager and Notification Server Administrators Guide to see all the parameters for the opmnctl createcomponent command. -admin Oracle Virtual Directory admin username, for example: cn=orcladmin. The default value is cn=orcladmin. -passwordFile Oracle Virtual Directory admin password file. You are prompted for a password if you do not specify a file location. Managing Oracle Virtual Directory Server Processes 10-3 -isAdminSSL Enables and disables SSL on the Oracle Virtual Directory Admin Listener. Supported values are true and false. The default value is true. -ovdAdminPort Identifies the port for the Oracle Virtual Directory Admin Listener. The default values is 8899. -namespace Namespace value, for example: dc=us,dc=oracle,dc=com -ldapPort Identifies the port for Oracle Virtual Directory LDAP Listener. The default value is 6501. -ldapSport Identifies the SSL port for Oracle Virtual Directory LDAP Listener. The default value is 6502. -httpPort Identifies the port for Oracle Virtual Directory HTTP Listener. The default value is 8080. -isHttpSSL Enables and disables SSL on the Oracle Virtual Directory HTTP Listener. The default value is true. Example 10–1 opmnctl createcomponent Command The following example command creates an Oracle Virtual Directory component named ovd3: ORACLE_INSTANCEbinopmnctl createcomponent -adminHost sales.west.com \ -adminPort 7001 -adminUsername weblogic -componentName ovd3 -componentType OVD \ -admin cn=admin -isAdminSSL true -ovdAdminPort 8890 \ -namespace dc=us,dc=oracle,dc=com -ldapPort 5566 -ldapSport 4455 -httpPort 9090 \ -isHttpSSL true

10.4 Registering an Oracle Instance Using OPMNCTL

To register an Oracle instance and all the components in that Oracle instance, you use opmnctl registerinstance. The syntax is: ORACLE_INSTANCEbinopmnctl registerinstance [-adminHost hostname] [-adminPort weblogic_port] [-adminUsername weblogic_admin] [-adminPasswordFile ‘FILE_WITH_WEBLOGIC_ADMIN_PASSWORD’] For example: ORACLE_INSTANCEbinopmnctl registerinstance \ -adminHost myhost \ -adminPort 7001 \ -adminUsername weblogic \ The default administrative port on the WebLogic Administration Server is 7001.