Configuring Single Components

Hints for Installing the DirX Directory Server

  • Install the directory using default settings.

  • If working with an empty database, create an LDAP configuration and an administrator object before running DirX Identity installations (see the DirX Directory administration documentation for details).

  • If using the example database, enter:

    • cn=admin,o=my-company

    • Password: dirx when prompted for the directory administrator during installation.

f you installed DirX Directory after uninstalling the software without a new DirX Identity setup, restore the database and copy: dirxabbr-ext.DirXmetahub… and dirxabbr-ext.DirXmetaRole… files from <install_path>/client/conf to <dirx_install_path>/client/conf.
DirX Identity with shadow agreements

  • Check the indexing requirements (see Indexed Attributes).Insufficient indexes will cause configuration failure!

  • If shadow agreements exist, exclude DirX Identity configuration from these agreements.

  • If shadowing starts at the root context prefix, DirX Identity configuration data will also be shadowed. Ensure schema parts are present on all shadows.

  • Alternatively, separate Connectivity Configuration from the Provisioning database on another DirX Directory server.

Hints for Configuring the Tomcat Server

Ensure Tomcat has sufficient maximum memory:

  • Windows: Open Configure Tomcat → Java tab → set Maximum memory pool.

  • Linux: add at the beginning of Tomcat’s startup script startup.sh: JAVA_OPTS=-Xmx512m; export JAVA_OPTS (Example sets 512 MB)

Restart Tomcat for changes to apply.

Configuring Connectivity Schema and Data

Steps for separate installation:

  1. Ensure a directory server exists (use native tools).

  2. Run installation (see Installing DirX Identity):

    • In Choose Licensed Features Set, select licensed features.

  3. Run configuration (see Configuring DirX Identity):

    • Select Connectivity Schema and Data Configuration.

  4. Extend directory schema as required (see Indexed Attributes).

Configuring Provisioning Schema and Data

Follow similar steps as Connectivity:

  1. Ensure a directory server exists.

  2. Install DirX Identity (select licensed features).

  3. Configure:

    • Select Provisioning Schema and Data Configuration.

  4. Extend schema as needed.

Message Broker

  1. Prerequisites: Prerequisite: Connectivity Configuration must exist.

  2. Install DirX Identity (select licensed features).

  3. Configure:

    • Select ActiveMQ Message Broker Configuration.

C++-based Identity Server

  1. Prerequisites: Connectivity Configuration and Message Broker.

  2. Install DirX Identity (select licensed features).

  3. Configure:

    • Select C++-based Server Configuration.

    • First server type = primary (runs Status Tracker); others = secondary.

    • Meta Controller (metacp) installs automatically.

      Only one C++-based Identity Server per computer.

Java-based Identity Server

  1. Prerequisites: Connectivity Configuration and Message Broker.

  2. Install DirX Identity (select licensed features).

  3. Configure:

    • Select Java-based Server Configuration.

      All servers are primary (contain repository). Secondary servers not supported.

DirX Identity Manager

  1. Prerequisite: Connectivity Configuration.

  2. Install DirX Identity (select licensed features).

  3. Configure:

    • Select Manager Configuration.

DirX Identity Web Center

  1. Prerequisites:

  2. Install DirX Identity (select licensed features).

  3. Configure:

    • Select Web Center Configuration.

Business User Interface

  1. Prerequisites:

  2. Install DirX Identity (select licensed features).

  3. Configure:

    • Select Business User Interface Configuration.

DirX Identity Connectivity Packages - Agents

  1. Prerequisite: Connectivity Configuration.

  2. Install DirX Identity (select licensed features).

  3. Configure:

    • Select C++-based Server Configuration.

      Installed C++-based Server type = secondary.

DirX Identity Connectivity Packages - Connectors

  1. Prerequisite: Connectivity Configuration.

  2. Install DirX Identity (select licensed features).

  3. Configure:

    • Select Java-based Server Configuration.