About Configuring Properties for Apps

Each app has a separate file that defines all of the properties it uses. You can configure many of these properties as described in this administration guide. The default properties are stored in a file in the server's classpath. The file includes a complete list of all configurable properties for reference. If you want to override the default value of a property, you create a page object in the database and add the new or changed properties there.

Storing the configured options in the database provides the following benefits:

  • It ensures that your configurations are not overwritten when you install a new version of software.
  • It allows you to make configuration changes without restarting the server.

To configure an app for your needs, you must create a page object and include only the properties you want to change or add. Your page object must have the exact same name as the properties file that includes the default value, as listed in this guide. If you previously created a page object, open it for editing instead of creating a new one.

Important: For the best performance, do not copy the entire properties file into your configured page object.

Some apps change the default values of a prerequisite app's properties. These properties are also stored in page objects, named with "_CODE" where CODE is an alphabetic code for the app that made the changes. 

<base_name>_<CODE>.properties

For example there may be a page object named emxSystem_AWL.properties.

Do not edit these page objects; instead copy only those properties you want to change into your own page object and change them there. Your settings will prevail.

The system first loads the default files from disk, then any page objects defined by other apps, then any page object that has the same name as a properties file. This last page object is the one you create and configure. If your system includes customized code and applications, the configured properties page object can contain additional key-value pairs that are not included in the primary file.

You can create page objects using MQL. You can use any text editor to create a file and then use it to create the page object. You can also save that text file as a backup.