Property Sets

This page is accessed via Configuration and Administration > Property Management > Property Sets.

Note: Only the DBA.ADMIN user can access and use the Property Sets page.

Much of the optional or configurable behavior in OTM is controlled by properties. These methods are available to set properties:

• Property files: OTM ships with a set of hierarchical property files where properties in a parent file override properties in a child. Of these files, you can modify the top-level glog.properties file to configure their installation to your liking. This requires direct access to the file on the disk.
• The Properties Servlet: This servlet allows you to view and modify properties but does not persist them to the file. Changes made in the property servlet are lost when a server is restarted.
• Property sets: A property set is a collection of ordered property instructions stored in the database. To be active, a property set must be included by another active property set or by a property file using the !propertySet instruction.

Note: Some properties are reserved and are not displayed in the UI.

1. Enter a Property Set ID. The property set ID must match the argument to a !propertySet directive in a property file or the key of an Include property instruction in another property set.
2. Select a Domain.
3. Enter a Description.
4. Enter a Reason for Change. The reasons are stored in the log for the property set, so you can always see why a property was added, changed, or removed from the property set.

Properties

1. Enter a Sequence. Sequences are used to resolve conflicts between properties that appear twice within the same property set. The last instance of a property appearing in a property set, i.e. the highest sequence number, is used. Sequences are critical when including sibling property sets. If a Set property instruction follows an Include instruction for a sibling set, it will override any declarations made in the sibling set. Otherwise, the sibling set will take precedence.
2. Select an Instruction. There are a few options:
   • Set: Choose this option to set the value of a single or multi-valued property. For a single-valued property, this could be as simple as setting the property to "true". For multi-valued properties you can include multiple rows in the table for the same property, setting the value to be different for each instance of the property.
   • Remove: Remove a property. This can include removing one or all values for a multi-valued property. You would choose the remove option if you know the property is set in another file or property set and you want to effectively remove that setting and replace by setting a new value in this property set. For example, assume you want to modify the multi-value property glog.workflow.queueThreads.batch=2 to increase the batch thread-count to 4. As a multi-valued property, you first need to remove the old value and then add the new one. You would Remove the property with value "batch,2" and then Set the property with value "batch,4".
   • Include: Including the property in another property set. When you include another property set, that property set can either be a "child" of the current property set, or a "sibling" of the property set. The values in a "child" property set cannot override the values in the parent property set. The properties in a "sibling" property set can override the parent property set values.
3. Enter a Key. If you are setting or removing a property, the key is the property you are adjusting. If you are using the Include instruction, enter the property set ID that you want to include in this property set.
4. Enter a Value. If you are setting or removing a property, enter the value you want the property to take, such as "true". If you are using the Include instruction, enter either "child" or "sibling" to indicate the type of relationship the included set has with this one.
5. Enter a Description to explain the use of the property.
6. Click Save for every property you define.

Property Log

This section displays a log of changes to the property set. Use the log to quickly see property changes in case you need to restore a property to a previous setting. Even if you delete a property from a set, it will be tracked in the property log. Property changes are also written to a log file on each server. The Clear Log action will delete records from property logs.