Configuring Single Components

This chapter provides information on how to configure components separately, including:

Installing the directory server
Configuring the Tomcat server
Configuring Connectivity
Configuring Provisioning
Configuring a separate C++-based Identity Server
Configuring a separate Java-based Identity Server
Configuring a separate Identity Manager
Configuring a separate Web Center
Configuring a separate Business User Interface
Configuring a separate supervisor
Configuring agents
Configuring connectors

Hints for Installing the DirX Directory Server

Install the directory with the default settings.If you are working with an empty database, you must create an LDAP configuration and an administrator object in the directory before running the DirX Identity installations (see the DirX Directory administration documentation for details).
If you have loaded the example database (see the DirX administration documentation for details), enter the name cn=admin,o=my-company with the password dirx, when the DirX Identity installation prompts you for the directory administrator.

If you have installed DirX directory after a de-installation of the software and without a new setup of DirX Identity, you must restore the database and copy the 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 of your installation environment (see the section "Indexed Attributes" in the chapter "Additional Topics" for more information).If you do not define enough indexes, the configuration will fail!
If you install DirX Identity on a DirX Directory server where shadow agreements are set up, be sure to exclude the DirX Identity configuration part from these agreements.
If you use a shadow agreement that shadows the data beginning at the root context prefix, then DirX Identity configuration data will be shadowed, too.In this case the DirX Identity configuration part of the schema must be present on all shadows.
Another alternative is to separate the Connectivity Configuration from the Provisioning database into another DirX Directory server.

Hints for Configuring the Tomcat Server

Running an application in the Tomcat server requires an appropriate setup of enough maximum memory.

On Windows, select Configure Tomcat from Tomcat’s program folder, open the Java tab and set the required value of Maximum memory pool appropriately.

On Linux, add the following line at the beginning of Tomcat’s startup script startup.sh:

JAVA_OPTS=-Xmx512m; export JAVA_OPTS

In this example, a value of 512 Megabytes is set.

Restart the Tomcat server for the change to become effective.

Configuring Connectivity Schema and Data

A separate installation of the Connectivity LDAP configuration schema and data part of DirX Identity requires performing these steps:

Prerequisite: Existence of a directory server on this machine (use the native tools to perform this step).
Run the installation procedure on this machine (see the chapter "Installing DirX Identity"):
- In the Choose Licensed Features Set dialog, select the set of features you have licensed according to the description of that dialog in the chapter "Installing DirX Identity".
Run the configuration procedure on this machine (see the chapter "Configuring DirX Identity"):
- Select Connectivity Schema and Data Configuration in the Configuration Options dialog.
Extend the directory schema as required.

(See also "Schema and Content Handling" in chapter "Additional Topics" for details.)

Configuring Provisioning Schema and Data

A separate installation of the Provisioning LDAP configuration schema and data part of DirX Identity requires performing these steps:

Prerequisite: Existence of a directory server on this machine (use the native tools to perform this step).
Run the installation procedure on this machine (see the chapter "Installing DirX Identity"):
- In the Choose Licensed Features Set dialog, select the set of features you have licensed according to the description of that dialog in the chapter "Installing DirX Identity".
Run the configuration procedure on this machine (see the chapter "Configuring DirX Identity"):
- Select Provisioning Schema and Data Configuration in the Configuration Options dialog.
Extend the directory schema as required.

Message Broker

A separate installation of a Message Broker requires performing these steps:

Prerequisites: Existence of a setup Connectivity Configuration.
Run the installation procedure on this machine (see the chapter "Installing DirX Identity"):
- In the Choose Licensed Features Set dialog, select the set of features you have licensed according to the description of that dialog in the chapter "Installing DirX Identity".
Run the configuration procedure on this machine (see the chapter "Configuring DirX Identity")
- Select ActiveMQ Message Broker Configuration in the Configuration Options dialog.

C++-based Identity Server

A separate installation of a C++-based Server requires performing these steps:

Prerequisites: Existence of a setup Connectivity Configuration and Message Broker.
Run the installation procedure on this machine (see the chapter "Installing DirX Identity"):
- In the Choose Licensed Features Set dialog, select the set of features you have licensed, according to the description of that dialog in the chapter "Installing DirX Identity".
Run the configuration procedure on this machine (see the chapter "Configuring DirX Identity")
- Select C++-based Server Configuration in the Configuration Options dialog.

The server type field of the first server that is installed is set to primary (it runs the Status Tracker); all other servers are set to secondary.

The DirX Identity Meta Controller (metacp) will be installed without explicit selection.

Please note that it is not possible to install more than one C++-based Identity Server on the same computer.

Java-based Identity Server

A separate installation of a Java-based Server requires performing these steps:

Prerequisite: Existence of a setup Connectivity Configuration and Message Broker.
Run the installation procedure on this machine (see the chapter "Installing DirX Identity"):
- In the Choose Licensed Features Set dialog select the set of features you have licensed, according to the description of that dialog in the chapter "Installing DirX Identity".
Run the configuration procedure on this machine (see the chapter "Configuring DirX Identity")
- Select Java-based Server Configuration in the Configuration Options dialog.

Note that the server type field of all installed servers is set to primary (it contains the repository).Secondary servers are not supported in this release.

DirX Identity Manager

A separate installation of a DirX Identity Manager requires performing these steps:

Prerequisite: Existence of a setup Connectivity Configuration.
Run the installation procedure on this machine (see the chapter "Installing DirX Identity"):
- In the Choose Licensed Features Set dialog, select the set of features you have licensed, according to the description of that dialog in the chapter "Installing DirX Identity".
Run the configuration procedure on this machine (see the chapter "Configuring DirX Identity")
- Select Manager Configuration in the Configuration Options dialog.

DirX Identity Web Center

A separate installation of a DirX Identity Web Center requires performing these steps:

Prerequisite: Existence of a setup Connectivity Configuration, a setup Provisioning Configuration (including a configuration of a sample or customer domain) and a supported Tomcat installation (see the release notes) on this machine.
Run the installation procedure on this machine (see the chapter "Installing DirX Identity"):
- In the Choose Licensed Features Set dialog, select the set of features you have licensed according to the description of that dialog in the chapter "Installing DirX Identity".
Run the configuration procedure on this machine (see the chapter "Configuring DirX Identity")
- Select Web Center Configuration in the Configuration Options dialog.

Business User Interface

A separate installation of a Business User Interface requires performing these steps:

Prerequisite: A Connectivity Configuration setup, a Provisioning Configuration (including a configuration of a sample or customer domain) setup and a supported Tomcat installation (see the release notes) must all exist on this machine.
Run the installation procedure on this machine (see the chapter "Installing DirX Identity"):
- In the Choose Licensed Features Set dialog, select the set of features you have licensed according to the description of this dialog in the chapter "Installing DirX Identity".
Run the configuration procedure on this machine (see the chapter "Configuring DirX Identity")
- Select Business User Interface Configuration in the Configuration Options dialog.

DirX Identity Connectivity Packages - Agents

A separate installation of a DirX Identity agent requires performing these steps:

Prerequisite: A Connectivity Configuration setup must exist.
Run the installation procedure on this machine (see the chapter "Installing DirX Identity"):
- In the Choose Licensed Features Set dialog, select the set of features you have licensed according to the description of that dialog in the chapter "Installing DirX Identity".
Run the configuration procedure on this machine (see the chapter "Configuring DirX Identity")
- Select C++-based Server Configuration in the Configuration Options dialog.

Note that the server type field of the installed C++-based Server is set to secondary.

DirX Identity Connectivity Packages - Connectors

A separate installation of a DirX Identity connector requires performing these steps:

Prerequisite: A Connectivity Configuration setup must exist.
Run the installation procedure on this machine (see the chapter "Installing DirX Identity"):
- In the Choose Licensed Features Set dialog select the set of features you have licensed, according to the description of that dialog in the chapter "Installing DirX Identity".
Run the configuration procedure on this machine (see chapter "Configuring DirX Identity")
- Select Java-based Server Configuration in the Configuration Options dialog.