Customizing a UME Data Source Configuration 

Purpose

The User Management Engine (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. You should only need to change the data source configuration files if you are using a directory service as data source and need to adapt the attribute mappings.

Before changing a configuration file, 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.

Customizing data source configuration files is not a trivial undertaking. You should start a project with an experienced consultant or contract SAP consulting services. Although SAP Support supports systems which use customized data source configuration files, SAP cannot support the customization process for the data source configuration file.

Nor can SAP guarantee the compatibility of customized data source configuration files with future releases or service pack stacks. Upgrades may include changes to the shipped data source configuration files. When you perform an upgrade to your SAP NetWeaver Application Server (AS) Java installation, these changes are not reflected in your modified configuration files. You must to add these changes to your modified files manually.

The following section outlines how to define your own data source configuration.

The topics Data Source Types, Home Data Source, Data Partitioning Scenarios, and Namespaces, explain concepts that 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 source configuration scenarios.

Prerequisites

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

●      You have installed the AS Java with the option to use the database of the AS Java for user management.

Procedure

...

       1.      Download the data source configuration file that most closely meets your requirements.

○       For more information about accessing the file when the AS Java is running, see Accessing Data Source Configuration Files Online.

○       For more information about accessing the file when the AS Java is not running, see .Accessing Data Source Configuration Files Offline

       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..

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

During an upgrade refer to SAP Note 938277 to determine what changes have been made to the default data source configuration files. Use this information to adjust your customized data source configuration file to the changes in the upgrade.