Editing the UME Configuration Files

Use

Throughout the UME activation process, you will need to change the UME configuration files. To retain the default configuration, we recommend you create a new UME property file where you make the changes and then specify the new configuration file in the UME’s property sheet. See the procedures below.

When editing the files, you have the option to change the files online. However, certain special characters can cause problems when saving the files. Therefore, to change the configuration, we recommend you download the configuration files, edit them locally and upload the new files instead of changing them in online mode.

Procedure

Navigating to the configuration

First navigate to the configuration in the Visual Administrator.

...

       1.      Start the Visual Administrator. (Execute <SAPj2eeEngine_install_dir>\admin\go.bat.)

       2.      Log on to the server as the user Administrator.

       3.      Expand Cluster  ® Server  ® Services  ® Configuration Adapter.

       4.      In the right pane, choose the tab page Runtime  ® Display configuration.

Creating a New Property File

The next task is to create a new property file for the UME.

...

       1.      In the configuration tree, expand Configurations  ® cluster_data  ® server  ® persistent  ® com.sap.security.core.ume.service  ® sapum.properties.

       2.      Select sapum.properties.

       3.      Switch to edit mode (Choose .) Confirm with Yes.

       4.      Edit the property file by choosing the symbol for Show the details for the selected node ().

The file appears in the Change file dialog.

       5.      Download and save the property file to a local file. (Choose Download.)

       6.      Edit the file locally.

For the correct handling of carriage and line feeds, use an editor that saves the file in UNIX mode.

       7.      In the Configuration Adapter, create a new entry with a different name. Proceed as follows:

                            a.      Select the node com.sap.security.core.ume.service.

                            b.      Choose the symbol for Create a node below the selected node ().

                            c.      Select the type File-entry.

                            d.      Choose Upload and select the file from the file system.

                            e.      Enter the name for the entry, for example, sapum.properties_productive. Per default, the file name from the uploaded file is used.

                              f.      Choose Create.

                            g.      Choose Close window.

The new node appears in the configuration tree.

Continue with changing the UME property sheet.

Changing the UME property sheet

In the next step, you need to specify the new property file in the UME’s property sheet.

...

       1.      In the configuration tree, expand Configurations  ® cluster_data  ® server  ® cfg  ® services.

       2.      Select Propertysheet com.sap.security.core.ume.service.

       3.      If you are not in edit mode, then switch to edit mode (Choose .) Confirm with Yes.

       4.      Edit the property file by choosing the symbol for Show the details for the selected node ().

The name of the UME configuration file appears in the Change configuration dialog.

       5.      Select the UME configuration entry ( ume.cfg.file).

The Change property sheet entry dialog appears.

       6.      Enter the name of your new property file in the Custom: text box and choose Apply custom.

The new property file name replaces the old one in the entry.

       7.      Choose OK.

       8.      Restart the server.

Changing the configuration files with the offline configuration editor

If you have problems using the Visual Administrator, you can use the Config Tool to change the configuration.

...

       1.      Start the Config Tool. (Execute <SAPj2eeEngine_install_dir>\configtool\configtool.bat.)

       2.      Choose File ® Connect (or the symbol for Connect to DB).

The Connect dialog appears.

       3.      If the fields are not filled per default, then choose the Overwrite rdbms settings indicator.

       4.      Enter your database user’s password in the Rdbms password: field (default=sap).

       5.      Choose Load.

The Config Tool connects to the database. The configuration tree for the server appears. The tree is the same as the tree shown in the Visual Administrator.

       6.      Choose the symbol for Switch to configuration editor mode.

       7.      Navigate and edit the files in the same way as with the Visual Administrator. (Select the file to change, switch to edit mode, download the file, edit it locally, and upload the changed file.)

       8.      Restart the server.

Result

The UME uses the new configuration.

Change other UME configuration files in the same way. Select the file, make sure you are in edit mode and download the file to your local file system. Edit the file locally and upload the changed file.

You only need to change the property sheet if you create a new property file.

See also:

For the actual configuration steps and properties to set for your installation, see:

·        Configuring the UME Using an ABAP Engine for Persistence

·        Configuring the UME Using an LDAP Directory Server for Persistence

If you use the database for persistency, then continue with Activating the UME User Store.