Customizing a UME Data Source Configuration

Purpose

UME provides data source configuration files that define a configuration for standard scenarios. If none of these files cover the scenario that you require, you can modify the existing configuration files according to your requirements.

This option is not recommended. Before attempting to modify a configuration file to suit your requirements, you should go through the following checklist.

·         Make absolutely sure that none of the preconfigured files meet your requirements. If at all possible, use one of the preconfigured files rather than creating your own.

·         Ensure that a very experienced developer is responsible for creating the customized data source configuration file.

The following section outlines how to define your own data source configuration. In Data Source Types, Home Data Source, Data Partitioning Scenarios, and Namespaces, concepts are explained that will help you when you define your configuration. The section on Structure of a Data Source Configuration File explains the logic behind the different sections of the configuration file. The examples show you how to implement different types of data partitioning scenarios. The remaining topics outline additional special scenarios that you can optionally configure.

Prerequisites

·        You have clearly defined where you want user management data to be read, searched, and written to.

·        You have installed SAP Web AS Java with the option to use a database for user management.

Procedure

...

       1.      Download the data source configuration file that most closely meets your requirements. See Editing UME Configuration Files.

       2.      Adapt the file as required.

       3.      Verify the correctness of your data source configuration file using the document type definition (DTD) file, which you can find at the same location as the data source configuration files.

       4.      Upload the data source configuration file under a different name. See Editing UME Configuration Files.

Result

You have created a new data source configuration file.

To configure UME to use it, set the UME property ume.persistence.data_source_configuration to the name of the new configuration file.

ume.persistence.data_source_configuration=dataSourceConfiguration_new.xml

For an example of how to activate a new data source configuration after installation, see Configuring UME to Use an LDAP Server as Data Source.