Skip to main content

Defining System Default Settings

This section discusses system default settings. It includes the following sections:

Purpose of System Default Settings

The purpose of system default settings is to simplify the process of copying a production definition from one environment to another. In any production, the values of some settings are determined as part of the production design; these settings should usually be the same in all environments. Other settings, however, must be adjusted to the environment; these settings include file paths, port numbers, and so on.

System default settings should specify only the values that are specific to the environment where InterSystems IRIS is installed. In contrast, the production definition should specify the values for settings that should be the same in all environments.

System default settings only apply within a single namespace. They can be applied to all productions, business hosts, and business host classes or a subsect of these. For example, you could create a system default setting for all business hosts within a single production or for a single business host in all productions.

To find the value for a setting for a production, business host, or adapter, InterSystems IRIS searches the following locations, in order:

  1. The production definition. If InterSystems IRIS finds a value for a setting here (even if the value is an empty string), it uses that value unless the value is overridden by the system default setting.

  2. The system default settings, which are stored outside the production definition.

    If InterSystems IRIS finds a value here (even if the value is an empty string), it uses that value.

  3. The value of the setting as specified in the definition of the class on which the production, business host, or adapter is based.

    InterSystems IRIS uses this value only if there is no system default for the setting.

    Some settings do not have any default value.

When you configure a production, the labels are color-coded to indicate whether the value was set in the production, the system default settings, or the class definition. See Understanding the Color Coding for Settings for more information.

Accessing the System Default Settings

To access the System Default Settings page, select Interoperability > Configure > System Default Settings. The System Default Settings page displays the settings defined in the namespace:

System Default Settings Management Portal page

To create a new system default setting, click New. To edit an existing setting, select the setting and click Edit. To delete a setting, select the setting and click Delete.

Note:

Security privileges may restrict you from creating, editing, or deleting some of the system default settings. For information about these security privileges, see Security for System Default Settings.

The following elements define a system default setting:

  • Production Name—Optionally, specifies the production to which this default applies. If set to *, this default applies to all productions in the namespace.

    Note:

    You cannot change the value of this field once you save the default. You must delete the default and create a new one.

  • Item Name—Optional, specifies the business host to which this default applies. If set to *, this default applies to all hosts in the production or in all productions.

  • Host Class Name—Optional, specifies the class of the business host to which this default applies. If set to *, this default applies to all hosts in the production or in all productions.

  • Setting Name—Specifies the name of the property to set. Note that property names do not include spaces. In most cases, the property name is similar to the setting name, with the spaces removed. For example, the setting Log Trace Events is based on a property called LogTraceEvents.

    Tip:

    You can see the property name within the popup window that displays descriptive text for the setting.

  • Setting Value—Specifies the value to assign to the property. If this field is blank; it sets the default to an empty string.

  • Description—Optional, specifies a description of the default.

  • Deployable—If set, the system default setting can be deployed to another production. For more information about deployment, see Deploying a Production.

Creating or Editing a System Default Setting

If you are creating a new system default setting or editing an existing one, InterSystems IRIS displays the following form:

System Default Setting page with the ShutdownTimeout setting set to 180

The System Default Setting page allows you to create a new system default setting or edit an existing one. For convenience it displays a tree of productions and other classes. This allows you to find existing settings and drag the names and values to the form. The Expand Tree and Contract Tree buttons and the plus and minus icons allow you to explore the tree to locate the property you are seeking.

While you can use an asterisk (*) in theProduction, Item Name, and Host Class Name fields to apply a setting to all the productions in a namespace, you cannot use other wildcard input such as EnsLib*. Additionally, you can specify only one value in each of these fields.

Note:

Your security privileges determine which system default settings appear in the tree. For information about these security privileges, see Security for System Default Settings.

When you have completed defining or updating the system default setting, click Save. The Cancel button discards any changes and returns to the list of system default settings without creating or updating a setting. The Restore button returns to fields to their initial values and allows you to edit the values.

Using System Default Settings

When using a wizard to create the business service or operation, use the Default applies if no value check box to specify that you want to use system default settings when available. This option is selected by default.

Without the Default applies if no value option, the business host is created with blank values, not the system defaults. In this case, you must manually change the value of the setting to the default on the Settings tab of the Production Configuration window. For instructions, see Restoring a Setting to Its Default Value.

Using System Default Setting to Override Production Values

Some system default settings can override the corresponding production and business host class values. If a value is specified for these system default settings, that value will be used for all productions in the specified environment. User will not be able to change the value for individual production or business hosts. The system default setting will have to be deleted or changed in order to change the value in an individual production. Users will be unable to change these values in a production and will instead be prompted that the system default setting will need to be updated. Additionally, any productions in the given environment with different values for these setting will be updates so that the settings match the system default setting.

Any settings whose values are determined in this way will be colored blue (to demonstrate that the value is determined by a system default setting). See Understanding the Color Coding for Settings for details.

For productions, the settings that will override the production class values include:

  • ActorPoolSize

  • TestingEnabled

For business hosts, the settings that will override the production class values include:

  • Enabled

  • PoolSize

FeedbackOpens in a new tab