Settings

Most of the configuration of the Agent software is available through the Settings section of a policy. The available settings are read from the Policy Definitions which are updated when new versions of the Agent are released with additional features and configurable options.

To include a setting in a policy, its value must be defined. If the setting is set to "Default", it is not included in the policy.

All settings defined in a policy, regardless of the endpoint's platform or setting's platform, are included in the policy for the specified endpoints. If you defined a value for a Mac-only setting and associated that policy to a Windows endpoint, the Windows endpoint receives the Mac setting. This behavior is benign because the Windows endpoint does not operate on a setting it does not use, however, it may cause confusion when troubleshooting or analyzing policies. In those cases, be sure to check the setting information to be sure it's available on the system being analyzed.

When Settings is selected, the Policy View displays a hierarchical or flat view of the available settings with the following columns:

Field Description
Name

The name of the category or the setting and a representative icon.

  • For categories (folders that contain settings), a folder icon is displayed. The category icon illuminates and the name of the folder is displayed in green text when any child setting has a value defined. This enables you to quickly see which settings have values defined.

  • For settings, an image of a piece of paper displays. If the icon includes a platform specific image (such as a Windows or Mac icon), then that setting is only available for that specific platform. If no platform icon displays, the setting is available on all platforms though there may be individual options within that setting that only apply to one or more platforms.
    All Platforms
    Windows Only
    Linux Only
    Mac Only
Value The currently established value for the setting. When the value has been set to something other than the default, it displays with green text. When in Edit Mode, uncommitted changes display with yellow text. When the changes are committed they change to green text. This field is blank for folders.
Status Indicates whether the setting is the application default (Default) or was set by the user (User Set). This field is blank for folders.
Description A short description of the setting. This field is blank for folders.
Platform This is the platform(s) to which the setting is applicable. The valid values are any combination of "Win", "Mac", and "Linux." This field is blank for folders.

Double click the setting to open the Edit dialog for that setting and view the default value. If a value is already set, click Reset Setting to restore the setting to its default.

Double click the setting to open the Edit dialog. The Edit dialog for all settings contains Setting and Explain tabs. If the setting can be configured through the user interface on an Agent, there is a Win UI or Mac UI tab, as applicable.

Field Description
Setting

The setting tab first displays a short description of the setting. This is the same wording as shown in the Description column of the Settings in the Policy View. The setting then displays the list of valid values or a place to enter the desired value (depending on the setting type).

If a specific value for the setting is only available on a certain platform(s), an icon for those platform(s) will display next to the value name. For example, if a setting is supported on multiple platforms (i.e., Windows and Mac), but a specific value within that setting is available only for the Mac, then you'll see a Mac icon next to that value.

At the bottom of the Settings tab it shows the supported platform(s) and minimum and maximum Agent versions to which the setting is applicable.

  • Platform: Possible values are Win, Mac, and Linux. Absence of a specific platform indicates that the setting is not valid for that platform.
  • Min: The minimum Agent version to which the setting applies. None indicates there is no minimum version. A specific version (i.e. 6.3) indicates the setting does not apply to an Agent version prior to the version specified.
  • Max: The maximum Agent version to which the setting applies. None indicates there is no maximum. A specific version (i.e. 7.0) indicates the setting is no longer supported on Agent versions greater than the version specified.
Explain A detailed explanation of the setting, its uses, and all available options.
Win UI

This tab displays when the setting can be configured through the user interface of the Windows Agent software.

  • Location: The tabs, dialogs, or pages necessary to find that setting in the Agent UI.
  • Description: The detail showing exactly where on the indicated screen the setting exists. When shown in the context of other settings, this setting displays in bold. Words that appear in square brackets [like this] represent buttons.
Mac UI

This tab displays when the setting can be configured through the user interface of the Mac Agent software.

  • Location: The tabs, dialogs, or pages necessary to find that setting in the Agent UI.
  • Description: The detail showing exactly where on the indicated screen the setting exists. When shown in the context of other settings, this setting will be displayed in bold. Words that appear in square brackets [like this] represent buttons.