IBM R1 manual Chapter Changing settings through the user interface or XML

Chapter 2

Changing settings through the user interface or XML

You can customize the application by changing various of the settings that are established when you first install and configure the system. There are three ways to do this:

•Edit one or more of the XML files in which initial system values are stored.

•Enter or change values in the Settings module of the Administrator interface.

•Edit the application database directly, changing the appropriate record in the application_setting table.

When you install and configure the application, a number of XML files receive values that determine such things as where the application looks for Help files, what the initial settings are for user preferences (such as time zone, language locale, and whether to display hover Help), the maximum number of entries to include in an LDAP search result set, and so on. You can change these initial settings by editing these files, which reside in the classes directory.

The three XML files of most interest are settings.xml, ds-settings.xml, and duc-settings.html. The first of these controls settings on the LMM server; the second controls settings on the Content Delivery server; and the last applies to the Offline Learning Client.

Here is what the preferences settings section of settings.xml looks like:

================================================================

PreferenceSettings

default user preference settings component

================================================================

-->

<preferences component="com.lotus.elearn.settings.PreferenceSettings" timezone="EST" language="en" locale="en_US" tooltips="yes" recordPerPage="10" calendarState="viewMonth" primaryCalendar="gregorian" secondaryCalendar="gregorian" datepickerCalendar="gregorian" firstDayOfWeek="1" />

-<!--

================================================================

ds-settings.xml looks much the same as settings.xml in this example. There is no comparable entry in duc-settings.html (because in this case the client gets its settings from settings.xml).

In any case, you can change the attribute values in these XML files by editing the files with a text editor and then stopping and restarting the server. If you change settings.xml, you should change ds-settings.xml and, where relevant, duc-settings.xml as well.

However, editing the XML files is not the preferred way to change system settings. Where possible, using the Administrator interface to make changes is both simpler and less apt to result in unwanted inconsistencies between server settings. (Not all settings that you might want to change are exposed through the Administrator interface, but most of them are.)

So, for example, to make global changes in preferences, you can click the Settings tab in the Administrator interface, click LMM Server, General Settings, and then User Defaults and enter the desired new values. These will override the settings in the XML files.

Chapter 2: Changing settings 5