Customizing a UME Data Source Configuration

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.

Context

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.

Caution

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.

SAP cannot 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 add these changes to your modified files manually.

Before you begin, you should review the concepts and structures behind the data source configuration.

For more information, see:

This section also provides examples of data source configuration scenarios.

For more information, see Examples of Data Source Configuration Files .

Procedure

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 .
Adapt the file as required.
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.
Upload the data source configuration file under a different name.

Results

You can now configure the UME to use the new data source configuration file.

For more information, see Configuring the UME to Use an LDAP Directory as Data Source .

Note

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.