> > Configuring Directory Services

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Configuring Directory Services

This chapter provides information on working with AquaLogic BPM directory services.

The AquaLogic BPM directory is hosted by a database or LDAP directory and contians user, group, and project information. With AquaLogic BPM Workspace Extensions, the AquaLogic Interaction database is used for user and group information.

Prior to starting any of the AquaLogic BPM Web Applications, a valid directory must be configured.

In order to configure an AquaLogic BPM directory:

  1. Install JDBC drivers, if necessary. For details, see Installing JDBC Drivers
    2. Note: For an LDAP directory or when AquaLogic BPM Workspace Extensions, it is not necessary to install a JDBC driver.
  2. If no directory currently exists, create a new directory and directory service. For details, see Creating a New Directory.

    3. or

    If an AquaLogic BPM directory already exists, create a new directory service to use the existing directory. For details, see Connecting to an Existing Directory.

 

Installing JDBC Drivers

When creating a directory on a database system, the appropriate JDBC driver must be installed using the AquaLogic BPM Admin Center. It is not necessary to install a JDBC driver when configuring an LDAP directory, or when configuring AquaLogic BPM Workspace Extensions to use the AquaLogic Interaction database.

For information on supported JDBC drivers, see

To install a JDBC driver:

  1. Open the AquaLogic BPM Admin Center.
  2. Open the Configuration Utility by clicking Configuration.
  3. Click the Install Drivers... button.
  4. Browse to the JAR files for the JDBC driver. Selec all JAR files relevant to the specific JDBC driver and click open.

The following table lists the default names of the JAR files associated with supported JDBC drivers. The JAR files on your system may be named differently.

JDBC Driver
JAR Files
Oracle
  • ojdbc14.jar
i-NET JDBC Driver (SQL Server)
  • Merlia.jar
Microsoft JDBC (SQL Server 2005)
  • sqljdbc.jar
DB2
  • db2java.jar
  • db2jcc.jar

Next steps:

 

Creating a New Directory

Creating a new directory involves creating a new directory service with connection information to the database or LDAP backend system.

Note: Creating a new directory for AquaLogic BPM Workspace Extensions is a special case involving the AquaLogic Interaction database. Follow the process in the AquaLogic BPM Workspace Extensions Installation and Upgrade Guide.

To create a new AquaLogic BPM directory:

  1. From the AquaLogic BPM Admin Center, click Configuration.
  2. Click Add....
  3. Select the Create New Directory radio button. Click OK.
  4. Type a new name into the Directory ID field.
  5. From the provider drop-down, choose a database or LDAP server.
    6. Note: If connecting to a database backend, ensure that the JDBC driver type is the supported JDBC driver for your installation. Not all drivers in the provider drop-down are applicable to every product in the AquaLogic BPM family.
  6. Complete the server and credential informatio nfor the backend system selected.

    7. For details on settings specific to each supported backend system, see Directory Service Backend Configuration.

  7. The directory can be created automatically by the Configuration Utility, or SQL scripts can be generated for review and offline installation by a DBA. To create SQL scripts, select the Create SQL Scripts checkbox.
  8. Click Start.

The Configuration Utility will confirm the directory has been successfully created.

 

Connecting to an Existing Directory

Connecting to an existing AquaLogic BPM directory involves creating a new directory service with connection information to the database or LDAP backend system of a directory that was previously created.

To create a directory service to connect to an existing directory:

  1. From the AquaLogic BPM Admin Center, click Configuration.
  2. Click Add....
  3. Select the Use Existing Directory radio button. Click OK.
  4. Type a new name into the Directory ID field.
  5. From the provider drop-down, choose a database or LDAP server.
    6. Note: If connecting to a database backend, ensure that the JDBC driver type is the supported JDBC driver for your installation. Not all drivers in the provider drop-down are applicable to every product in the AquaLogic BPM family.
  6. Complete the server and credential informatio nfor the backend system selected. Enter the same properties that were used to create the directory during the original AquaLogic BPM installation.

    7. For details on settings specific to each supported backend system, see Directory Service Backend Configuration.

  7. Click Start.
  8. Confirm the directory service was successfully added. From the Configuration Utility, highlight the directory service and click Check....

  Back to Top       Previous  Next