Show TOC

Background documentationEditing UME Properties Locate this document in the navigation structure


Use properties of the user management engine (UME) to set any number of configuration options. UME properties define among other things, what data source the UME uses, the security policies, how users are displayed, and how search works. You can use user management configuration to edit properties in most cases.

For more information, see Configuring User Management.

Caution Caution

Do not edit undocumented properties without consulting SAP Support.

End of the caution.
Properties of the AS Java

You can set the properties of the SAP NetWeaver Application Server (AS) Java at different levels in the configuration structure. In an AS Java cluster, you can set properties at the following levels:

  • Global

    Values apply to all instances in the cluster

  • Template

    You can define configuration templates. Only a single template can be active in the cluster and all instances use the active template. You can define additional inactive templates. You can change the active template, causing all instances inherit any custom values defined in newly activated template.

  • Instance

The lower levels inherit the property values of the upper levels, unless you set a custom value for that level. Lower levels inherit the custom value of the property. The figure below illustrates how values are inherited.

This graphic is explained in the accompanying text.

Configuration Structure of the AS Java

Properties of the UME

UME properties fall into one of the following classes:

  • Persistence properties

    These properties control access to the data source among other functions. They are final (they can only be set at the global level) and require a restart of the AS Java. Changing these properties at lower levels or during runtime would cause inconsistent behavior and lead to users, groups, and roles appear and disappearing according to the instance you logged into or changes in the properties.

  • Everything else

    These properties control functions such as the security policy and e-mail notification. You can set these properties at lower levels or change their values online.

    Recommendation Recommendation

    We recommend that you set all UME properties at the global level, but you may have a configuration where setting these properties at another level makes sense.

    End of the recommendation.

There are exceptions to these generalizations. There are persistence properties that can be modified online. From the nonpersistence properties there are properties that are final and properties that require restart. You can view the meta attributes of a property in the Java system properties tool or the Config Tool to determine if it is final or online modifiable.

Tools for Setting UME Properties

User management configuration in the identity management user interface enables you to set most of the properties without having to know the technical name of these properties. User management configuration reads and changes properties at the global level. User management configuration has no influence on custom values set at lower levels in the configuration structure. Some more-advanced or less-used functions still require you to use a property editing tool. The following tools are available:

  • Expert mode in the user management configuration interface

    Use this tool to edit properties of the UME service at the global level.

    For more information, see Editing UME Properties Online.

  • Java system properties tool in SAP NetWeaver Administrator

    Use this tool to edit properties of the UME service at the template and instance level.

    For more information, see Java System Properties.

  • Config tool

    Only use the config tool if you cannot use an online tool.

    For more information, see Editing UME Properties Offline.