Creating a New Directory Service

If you are planning to use a database-only directory service, you need to install and configure only a relational database. If you are planning to use a hybrid directory service, you need to install and configure both a relational database and an LDAP server.

If you are integrating Oracle BPM with AquaLogic Interaction, refer to Configuring BPM for ALI for details on how to configure the BPM directory service.

To create a Directory Service, you use the Oracle BPM Configuration Wizard within the Oracle BPM Admin Center.
Note: The exact path you follow in the Configuration Wizard depends on whether you are configuring a database-only or hybrid directory service.
Note: If you are creating this directory service as part of a new installation, you can also use the Oracle BPM Configuration Wizard to configure the Process Execution Engine database.
  1. Launch the Oracle BPM Admin Center
  2. Click Configuration The Configuration window appears.
  3. Select the Directory tab.
  4. Click Add. The Configuration Wizard Tasks window appears.
  5. Select Create Directory Service, and then click Next. The Directory Provider Type window appears.
    The Directory Provider Type window enables you to choose the type of directory service:
    • A database managed by Oracle BPM. Selecting this option configures a directory service consisting of a relational database only.
    • An external directory service provider plus a relational database. This configuration is also called a hybrid directory service. Selecting this option indicates that configuration information for the project is to be stored in the relational database, and participant identity information--including security credentials, roles and permissions, groups, and organizational units--is to be stored in one of the supported LDAP directories. You must specify this option if integrating with AquaLogic Interaction (see Configuring BPM for ALI for details).
  6. Select the type of directory provider type, and then click Next. The Directory Provider Selection window appears.
    If you chose to configure a database managed by Oracle BPM, the Directory Provider Selection window prompts you to specify:
    • The Directory Provider, that is, the relational database for the directory service. For information about supported directory providers and the parameters you must configure for each one, see Engine and Directory Database Connectivity.
    • The user identifier and password for the BPM Administrator User. These are the credentials the Process Administrator retrieves when authenticating the Oracle BPM administrator.
      Note: Once a directory is created with the respective directory.xml file, the BPM Administrator cannot be changed.

    If you choose to create a hybrid directory service, the Directory Provider Selection window also prompts you to specify the organization provider, that is, an one of the supported LDAP directories.

  7. Select the organization provider and click Next. The Configure Directory Provider window prompts you for the connectivity information for the directory provider database. The information required depends on the database--for example, DB2, MS SQL, or Oracle. To learn more about the connectivity information you need to enter, see Engine and Directory Database Connectivity
  8. Enter the connectivity information and click Next. The Enter Directory Creation window prompts you for:
    • The username and password of the database administrator
    • The logical name of the organization for this environment. This symbolic name is used in contexts where processes in different environments communicate with each other.

After the Configuration Wizard runs successfully, your newly created directory service appears on the Directory tab page of the Configuration Wizard.

See Configuring Organization using a DB-Only Directory Service for information on creating an organization if you are using a database-only directory service.

See Configuring a Hybrid Directory Service for information on configuring a hybrid directory service.