Error: Invalid spaceKey on retrieving a related space config.

Settings in the config.properties file

This topic describes the settings in the config.properties file.

The config.properties file is located at <MidtierInstallDirectory>\WEB-INF\classes.   

Notes

  • When you modify any property directly through config.properties file, you must restart BMC Remedy Mid Tier for the changes to take effect. If the changes to a property are done through AR System Configuration Generic UI form, restart is not required for some properties.
  • BMC recommends that you use the AR System Configuration Generic UI form to modify the centralized configuration settings. Do not use the config.properties file to modify the configuration settings on the AR System Configuration Generic UI form. For more information on the centralized configuration settings, see Configuration settings A-B.
  • For the settings which are not centralized, you should use the config.properties file to modify these settings. 
Settings
Centralized configuration setting 
Description
arsystem.activelinks.allow_permission_checkYes

Determines if you can access a form via an active link.

Displays an error message if the active link does not have permission to access a particular form. The next active link is not processed if the error message is displayed.

Default value — true

Needs restart? — Yes

Note:

You must clear form cache every time you change the property value.

arsystem.disable_popup_blockerNo

Disables popup blocker messages when this property is set to true.

Default value — false

arsystem.disable_webservice_cachingYes

Use this property so that the Mid Tier caches the WSDL content on the first request and uses the cached object for future requests. If set to true, the Mid Tier will request the WSDL content each time the web service is called.

Default value — false

Needs restart? — No

arsystem.exclude_table_autorefresh_for_sessiontimeoutYes

Excludes table auto refresh calls while calculating session timeout. If this is set to true then session times out despite the table auto refresh in ON. If this is false then table auto refresh calls will take part and reset the session timeout.

Default value — true

arsystem.search_chunk_size

Yes (Only if explicitly configured for Mid-Tier)

This property controls the result list default chunk size and helps to improve the performance. 

Default value — 1000

Needs restart? — Needs restart if parameter value is changed in the config.properties file. Restart is not required if you change the parameter value from Centralize Configuration.

arsystem.table_autoRefreshMinIntervalNo

Use this property to set the minimum value allowed for the table auto refresh interval rate. This is applicable for the entire table.
The system administrator sets the minimum value for the table auto refresh interval rate by using this property in config.properties file. When the system administrator sets the value of this property, the BMC Remedy AR System considers only those values that are equal to or greater than the value set by the system administrator. BMC Remedy AR System ignores the user values that are less than the values set by the system administrator.

If the system administrator sets the arsystem.table_autoRefreshMinInterval property to true in the config.properties file, then the global refresh rate set by the system administrator is applicable.

Default value — 0

Needs restart? — No

arsystem.view_server_stats_base_pathYes

This property indicates the path of the view server stats base directory where view server statistics are generated.

When Mid Tier starts, the server statistics are collected from the path mentioned in this property. Mid Tier uses the same path to build the cache.

Needs restart? — Yes

arsystem.compression_index

Property to handle Backchannel and Metadata (content) compression.

Values are:

  • 0—The HTTP response will be forced as uncompressed.
  • (default)—The HTTP response will be forced to be compressed, except for small response sizes.
  • 2—The HTTP response will be compressed only if the HTTP request has the header 'Accept-Encoding' as gzip.


arsystem.host.header_listNo

Note: The following procedure is applicable only for BMC Remedy AR System 9.1.00.001 and later.

Perform the following steps before applying BMC Remedy AR System 9.1 Patch 001.

  1. Stop the server where Mid Tier is running.
  2. Navigate to \ARSystem\midtier\WEB-INF\classes\config.properties location.
  3. Edit config.properties to add the following parameter.
    For example: arsystem.host.header_list = <Trusted Host name(s) with comma separation>,
    Where,
    localhost is the computer on which the Mid Tier is installed.

  4. Save the settings.
  5. Start the server where Mid Tier is running.

Proceed with the patch installation.

arsystem.session_timeoutYes 

Number of minutes for which the current logon session remains inactive. When the time exceeds the arsystem.session_timeout value, you must log on again. For security guidelines see, General security guidelines.



Default value — 90 minutes

Needs restart? — No

arsystem.licenserelease_timeoutYes 

Number of seconds before BMC Remedy Mid Tier releases an AR System license for a user, if the user does not log out of mid tier correctly.

Note: When logging out, the user must close the last browser window associated with the current HTTP session or navigate away from the mid tier.

Default value — 60 seconds

 Needs restart? — No

arsystem.passwordNo 

Password to log on to the mid tier configuration tool.

Needs restart? — No

arsystem.arservers.<serverName>.admin_passwordNo 

Password for an AR System account with administrative privileges. This password must match the Mid Tier Administration Password on the Connection Settings tab in the AR System Administration: Server Information form.

Needs restart? — No

arsystem.arservers.<serverName>.domainNo 

Domain name for the AR System server.

Needs restart? — No

arsystem.arservers.<serverName>.portNo 

Port number that the user previously configured to access the AR System server. If you have not configured a port number, leave this field blank.

Needs restart? — No

arsystem.arservers.<serverName>.rpcNo 

Remote Procedure Call (RPC) protocol number that the AR System server uses. The RPC protocol number is used for connection to a private server. If you have not configured an RPC number, leave this field blank.

Needs restart? — No

arsystem.arservers.<serverName>.useshortNo 

Indication that the BMC Remedy Mid Tier always uses the short name of an AR System server.

Needs restart? — No

arsystem.arservers.<serverName>.preloadNo 

Indication that preloading of the forms has been enabled for this AR System server.

Values are:

  • true (default)
  • false

Needs restart? — No

arsystem.preference_servers_list Yes

Name of the AR System server designated as a preference server.

If you need multiple preference servers to support different departments or business units, you can specify multiple server names. When you enter more than one preference server, the system searches the list until it finds the first server that matches the user name and uses that server as the preference server.

To add or update preference servers, enter the name of each server that you want to designate as a preference server. To add multiple servers, separate each server name with a comma.

Note: A fully qualified server name is not valid in this field.

Needs restart? — No

arsystem.authentication_serverYes Server that the mid tier uses to authenticate a user. If an authentication server is specified, the mid tier authenticates with the specified server. The authentication server must already be in the list of mid tier servers on the AR Server Settings page.

If an authentication server is not specified, you can perform the following actions:
  1. Log on with the preference server, if one is specified.
  2. If there is no preference server, log in to the first server listed in the AR Server list.
  3. If that login is not successful, log in to the next server on the list. (A guest login is considered a successful login.)

Needs restart? — No

arsystem.arservers_listYes 

List of AR System servers that are added to the selected mid tier on the AR Server Settings page.

Needs restart? — No

arsystem.homepage_serverYes AR System server that contains the home page that you want to open when the user logs on

The home page URL: http://midTierServer/contextPath/home

The home page server must be added to the list of mid tier servers in the AR Server Settings page.

The mid tier searches the designated server for the home page. If you have not selected a home page server in the AR System User Preference form, the home page server specified in the AR Server Settings page is used globally . A home page server specified in the AR System User Preferences form takes precedence over the server set in the AR Server Settings page.

The form used for the home page has the following precedence on a specific server:
  1. A form designated in the AR System User Preference form.
  2. The default home form designated in the AR System Administration: Server Information form.
  3. The default home page installed with BMC Remedy AR System.

Needs restart? — No

arsystem.plugin_servers_listYes 

Name of the AR System server designated as a data visualization module server. You can specify additional servers as backup servers in case the first module server goes down.

To add or update module servers, enter the name of each server you want to designate as a module server. If you are adding more than one server, separate each name with a comma.

Note: A fully qualified server name is not valid in this field.

Needs restart? — No

arsystem.show_waiting_cursorNo 

Indication that the wait cursor should be shown.

Values are:

  • #mode 0 — wait cursor off, content-based caching on
  • #mode 1 — wait cursor on, content-based caching off
  • #mode 2 — (default) semi-wait cursor, content-based caching on.
  • #mode 3 — wait cursor off, content-based caching off
  • #mode 4 — wait cursor on, content-based caching on
arsystem.log_level Yes

Level of detail for logging information.

Values are:

  • Fine — The highest level of detail, including the client's IP address
  • Info — Less detail than Fine, but includes the client's IP address
  • Warning — A moderate level of detail. Warnings plus those errors included in the Severe level are logged.
  • Severe — (default) The lowest level of detail; only server start time and error messages are logged

Note: You can see the pre-load start and end timestamp when you set the log level to Info or Warning. Irrespective of the logging level, mid tier logs the pre-load start and end time.

Needs restart? — No

arsystem.log_viewer Yes

Method by which you want to view the log files.

Values are:

  • Console — The log entries are directed to the stderr (System.err) of your servlet engine.
  • File — (default) Data is saved to a file in the specified log directory.

Needs restart? — No

arsystem.log_categoryYes 

Type of information that should be stored in the log file.

Values are:

  • Reporting — Messages related to reporting
  • Cache — Messages related to definitions, such as forms and active links in the cache
  • Session Management — Messages related to user session construction and expiration, such as logon, logout, or timeout
  • Configuration — Messages related to the config.properties file, such as when it is loaded and changed
  • Flashboards — Messages related to Flashboards
  • Web Services — Messages related to web services
  • Field — Messages related to fields
  • Workflow — Messages related to compilation of workflow (primarily active link actions), such as invalid active links
  • Performance — Messages related to performance, including duration of operations
  • Qualifications and Expressions — Messages related to parsing and compilation of expressions, for example, in active links
  • Servlet — Messages related to servlet handling of http requests, primarily for reporting results of back-channel requests
  • Internal — Internal logging messages
  • ARServer (API/Filter/Database) — Messages related to APIs, filters, and databases. Selecting the ARServer (API/Filter/Database) option, overrides the API logging option and all API logging is redirected to the mid tier log file.
  • Data Visualization Module — Messages related to the data visualization module

Default value — All categories except Flashboards are selected by default.

Needs restart? — No

arsystem.log_format YesLog output, which is generated using the standard Java 1.5 logging API, including Simple and XML formatting. Values are:
  • FastText — (default) A basic text file for faster performance, it does not include stack trace information except in the case of Severe log messages.
  • Text — A text file containing details such as JAVA class names and methods.
  • XML— A file in XML format.

Needs restart? — No

arsystem.log_filenameNo 

Name of the file with which the log file will be generated.

Default value armidtier%g.log

Needs restart? — No

arsystem.log_filepathYes 

Directory in which the log files are stored.
To change the log directory, enter the absolute (complete) path for the new directory.

Note: You cannot change the log file name.

Default valueC:\Program Files\BMC Software\ARSystem\midtier\logs

Needs restart? — No

arsystem.log_filesizeYes

Maximum size (in kilobytes) a file can reach before a backup copy is automatically made. When the log file reaches this limit, a backup copy is made with the same file name and an incremental number (for example, armidtierN.log).

Default value 10240 KB

Needs restart? — No

arsystem.log_backupsYes 

Maximum number of backup files that the system will generate when the log file size exceeds the limit specified in the Maximum Log File Size (arsystem.log_filesize).

Default value — 100 backups

Needs restart? — No

arsystem.log_userYes 

User name for which statements are logged.

After you enter the user name and save changes, a new log file is started. For log messages displayed on the screen, the filter applies only to new entries. Older entries that existed before the user name was changed will still be displayed on the screen, up to the limit set in the View Logs setting.

If the field is left blank, all logs related to the current session are stored, regardless of who is logged in. You can enter only enter one name in this field.

Needs restart? — No

arsystem.pooling_max_
connections_per_server
 Yes

Maximum number of connections in the AR System server Java API connection pooling.

Default value — 80

Needs restart? — Yes

arsystem.use_connectionpoolingNo 

Indication whether the AR Server connection pooling should be used.

Values are:

  • true (default)
  • false

Needs restart? — Yes

arsystem.cache_update_intervalNo 

Interval (in seconds) at which the cache information will be automatically updated.

Note: For Development cache mode, the value must be 0. For Production cache mode, the value must be greater than 0.

Default value — 86400 seconds

Needs restart? — No

arsystem.cache_update_neededNo Indication that the cache is updated automatically. You can still update the cache manually by clicking the Sync / Flush Cache button.

Values are:
  • On - (default) The cache is updated automatically at the interval that you specify in the Definition Change Check Interval field.
  • Off - The cache is not updated automatically.
arsystem.crt_working_dirNo 

Working directory where the BMC Remedy Mid Tier saves the report definitions. These report definitions are collected by the relevant report engine (Web, AR System, or BOXI/Crystal).

Enter the complete (absolute) path for this directory, for example: ARSystemInstallDir\midtier\reports.

If this directory is not under the web server’s root document directory, you must configure your web server with a virtual directory to point to this directory.

Default value — C:\Program Files\BMC Software\ARSystem1\midtier\reports

Needs restart? — No

arsystem.crtXI_locationNo 

URL prefix, including the host name and port number, if any, that is used to access the mid tier or AR Web ReportViewer on the BOXI or Crystal Reports server.

For example, if the URL for the BMC Remedy Mid Tier on the BOXI or Crystal Reports server machine is http://hostName:8080/arsys/, enter http://hostName:8080.

If the context path is not arsys, then include the context path: http://hostName/contextPath or http://hostName:portNumber/contextPath

Needs restart? — No

arsystem.ws_anonymous_userNo 

User name for an anonymous web service user.

Needs restart? — No

arsystem.ws_anonymous_pwdNo 

Password for an anonymous web service user.

Needs restart? — No

arsystem.browser_version_errorNo 

Flag that indicates whether browser version error message is on or off.

If you use an unsupported browser, you can use this setting to turn the error message on or off.

Values are:

  • On (default)
  • Off

Needs restart? — No

arsystem.authenticatorNo 

Fully qualified class name of the login authentication module to be used, such as DefaultAuthentication or AtriumSSOAuthenticator.

Default value com.remedy.arsys.session.DefaultAuthenticator

Needs restart? —  Yes

arsystem.authenticator.sso.enckeyNo 

Encryption key, if SSO Authentication is used

Needs restart? —  Yes

ardev.webwriter.commentsNo 

Comments that are added to the generated HTML that is cached by the mid tier to make the workflow debugger output more readable.

Values are:

  • true
  • false (default)

Needs restart? —  No

ardev.webwriter.whitespaceNo 

White space that is added to comments in the generated HTML that is cached by mid tier to make the workflow debugger output more readable.

Values are:

  • true  (default)
  • false

Needs restart? —  No

ardev.webwriter.indent No 

Indentation that is added to comments in the generated HTML that is cached by mid tier to make workflow debugger output more readable.

Values are:

  •  0
  •  2 (default)

Needs restart? —  No

ardev.jswriter.commentsNo 

Comments that are added in the generated JS that is cached by mid tier to make workflow debugger output more readable.

Values are:

  • true (default)
  • false

Needs restart? —  No

ardev.jswriter.whitespaceNo 

White space that is added in the generated JS that is cached by mid tier to make workflow debugger output more readable.

Values are:

  • true (default)
  • false

Needs restart? —  No

ardev.jswriter.indentNo 

Indentation that is added in the generated JS that is cached by mid tier to make workflow debugger output more readable.

Values are:

  • 0
  • 2 (default)

Needs restart? —  No

ardev.allow_unconfigured_serversNo 

Indication that server information for an AR System server that is not configured in mid tier can be retrieved.

Values are:

  • true (default)
  • false

Needs restart? —  Yes

arsystem.js_profileNo 

Indication that the javascript generated from active links should be profiled and shown in the workflow logs.

Values are:

  • true
  • false (default)

Needs restart? —  Yes

arsystem.image.spinnerupNo 

Name of the image from resources folder to use as the UP spinner for an integer field.

Default value mt_sprites.gif

Needs restart? —  Yes

arsystem.image.spinnerdown No 

Name of the image from resources folder to use as the DOWN spinner for an integer field.

Default value mt_sprites.gif

Needs restart? —  Yes

arsystem.image.diaryNo

Name of the image from resources folder to use as an icon for a diary field.

Default value — field_diary_empty.gif

Needs restart? —  Yes

arsystem.image.calendarNo

Name of the image from resources folder to use as an icon for a calendar.

Default value mt_sprites.gif

Needs restart? —  Yes

arsystem.image.currencyNo

Name of the image from resources folder to use as an icon for a currency field.

Default value mt_sprites.gif

Needs restart? —  Yes

arsystem.image.menuNo 

Name of the image from resources folder to use as an icon for a menu.

Default value mt_sprites.gif

Needs restart? —  Yes

arsystem.image.textNo 

Name of the image from resources folder to use as an icon for a character field.

Default value — mt_sprites.gif

Needs restart? —  Yes

arsystem.image.timeNo 

Name of the image from resources folder to use as an icon for a time field.

Default value — mt_sprites.gif

Needs restart? —  Yes

arsystem.image.tablechunkleftNo 

Name of the image from resources folder to use as an icon for a left chunk image in a table field.

Default value — chunking_sprite.png

Needs restart? —  Yes

arsystem.image.tablechunkdownNo

Name of the image from resources folder to use as an icon for a down chunk image in a table field.

Default value — menu_down.gif

Needs restart? —  Yes

arsystem.image.tablechunkrightNo

Name of the image from resources folder to use as an icon for a right chunk image in a table field.

Default value — chunking_sprite.png

Needs restart? —  Yes

arsystem.image.openNo

Name of the image from resources folder to use as an icon for a file upload button.

Default value — mt_sprites.gif

Needs restart? —  Yes

arsystem.image.editNo

Name of the image from resources folder to use as an icon for an edit button.

Default value — field_edit.gif

Needs restart? —  Yes

arsystem.image.rtfNo

Name of the image from resources folder to use as an icon for an RTF button.

Default value — field_rtf.gif

Needs restart? —  Yes

arsystem.flash.image.spinnerupNo

Name of the image from resources folder to show UP spinner for an integer field in flashboards.

Default value — spinner_up.gif

Needs restart? —  Yes

arsystem.flash.image.spinnerdownNo

Name of the image from resources folder to show DOWN spinner for an integer field in flashboards.

Default value — spinner_down.gif

Needs restart? —  Yes

arsystem.flash.image.diaryNo 

Name of the image from resources folder to be shown as an icon for a diary field in flashboards.

Default value — field_diary_empty.gif

Needs restart? —  Yes

arsystem.flash.image.calendarNo 

Name of the image from resources folder to be shown as an icon for a calendar in flashboards.

Default value — field_calender.gif

Needs restart? —  Yes

arsystem.flash.image.currencyNo 

Name of the image from resources folder to be shown as an icon for a currency field in flashboards.

Default value — field_currency.gif

Needs restart? —  Yes

arsystem.flash.image.menuNo 

Name of the image from resources folder to be shown as an icon for a menu in flashboards.

Default value field_menu.gif

Needs restart? —  Yes

arsystem.flash.image.textNo 

Name of the image from resources folder to be shown as an icon for a character field in flashboards.

Default value — field_text.gif

Needs restart? —  Yes

arsystem.flash.image.timeNo 

Name of the image from resources folder to be shown as an icon for a time field in flashboards.

Default value — field_time.gif

Needs restart? —  Yes

arsystem.flash.image.tablechunkleftNo 

Name of the image from resources folder to be shown as an icon for left chunk image in a table field in flashboards.

Default value — chunking_sprite.png

Needs restart? —  Yes

arsystem.flash.image.tablechunkdownNo 

Name of the image from resources folder to be shown as an icon for down chunk image in a table field in flashboards.

Default value — menu_down.gif

Needs restart? —  Yes

arsystem.flash.image.tablechunkrightNo 

Name of the image from resources folder to be shown as an icon for right chunk image in a table field in flashboards.

Default value — chunking_sprite.png

Needs restart? —  Yes

arsystem.flash.image.openNo 

Name of the image from resources folder to be shown as an icon for file upload button in flashboards.

Default value — field_open.gif

Needs restart? —  Yes

arsystem.scale_factor_X No 

Amount of space to be left for setting margins in table cells.

Default value 1

Needs restart? —  Yes

arsystem.scale_factor_Y No 

Amount of space to be left for setting margins in table cells.

Default value 1

Needs restart? —  Yes

arsystem.enableHttpTraceNo 

Flag that enables recording of an http trace by a web server for every request in mid tier.

Values are:

  • true (default)
  • false

Needs restart? —  Yes

arsystem.resource_expiry_intervalNo

Time limit (in seconds) for which resources (such as images, .css files, and JavaScript files) can be used

If you close a form and open it again within the specified expiry time, the image is cached and is not downloaded again. This helps increase the performance of mid tier.

Default value 86400 seconds

Needs restart? —  No
For security guidelines see, General security guidelines.

arsystem.formhtmljs_expiry_interval No

Time limit (in seconds) for which a form's generated html and JS data can be used

If you close a form and open it again within the specified expiry time, the html and JS data is cached and is not downloaded again. This helps increase the performance of mid tier.

Default value 86400 seconds

Needs restart? —  No

arsystem.prefer_native_views No

Default view, standard or web view, for the view type selection

Note: This setting is evaluated when the system progresses through the view selection algorithm.

If no view is specified and the  Prefer Standard/Windows Views check box is:

  • true — The browser displays the standard view of the form.
  • false — (default) The browser displays the web view of the form, if one is available. If no web view is available, the standard view is displayed.

Needs restart? —  No

arsystem.ehcache.overflowToDisk NoFlag that indicates whether the mid tier cache persists items to disk so that they survive between JVM restarts

Note: If you enable this setting, BMC recommends that you disable the arsystem.ehcache.overflowToDiskTemp setting to avoid possible duplication of cache items on disk when mid tier is running.

Values are:
  • true (default)
  • false

Needs restart? —  Yes

arsystem.ehcache.overflowToDiskTemp No

Flag that indicates whether the mid tier cache can overflow cache items temporarily to disk

These cache items do not survive between JVM restarts. To maintain cache items between JVM restarts, set the value of the arsystem.ehcache.overflowToDisk property to true and set the value of this property  to false.

Note: Setting this property to True might create duplicate cache items.

Values are:

  • true
  • false (default)

Needs restart? —  Yes

arsystem.ehcache.maxElementsOnDisk No

Maximum number of objects to be kept in the mid tier cache's disk storage

Default value —  2147483647

Needs restart? —  Yes

arsystem.ehcache.diskcache.maxElementsInMemory

No

Maximum number of objects to be kept in memory for the disk cache component of the mid tier cache. When the number of total objects in the disk cache goes beyond this limit,cache disk flush invokes, keeping the cache files in sync.

Default value — 250

Needs restart? —  Yes

arsystem.ehcache.memoryStoreEvictionPolicyNo 

Policy with which objects are swapped between memory and disk

Default value —  LRU

Needs restart? —  Yes

arsystem.ehcache.midTierCacheDirNo

Indication that when the arsystem.ehcache.midTierCacheDir setting is blank, the default cache for BMC Remedy Mid Tier is the mid tier installation directory or cache.

Needs restart? —  Yes

arsystem.ehcache.midTierCacheTempDirNo

Indication that when the arsystem.ehcache.midTierCacheTempDir setting is blank, the default temporary cache for BMC Remedy Mid Tier is the mid tier installation directory or cache.

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemory
No 

Default maximum elements in the memory

You can use this property to override the arsystem.ehcache.maxElementsInMemory setting.

Default value —  1250

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElementsIn
MemoryWeight.formImages
No 

Default maximum element weight for form images cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  0.104

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElementsIn
MemoryWeight.activeLinks
 No

Default maximum  element weight for activelinks cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  4.904

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.groups
No 

Default maximum element weight for groups cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  0.025

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.roles
No 

Default maximum element weight for roles cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  0.036

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.js
No 

Default maximum element weight for JS cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  0.195

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.displayedFields
No 

Default maximum element weight for displayed fields cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  0.157

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.fieldMaps
No 

Default maximum element weight for fieldmaps cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  0.323

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.sysdata
No 

Default maximum element weight for sysdata cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  1.202

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.compiledForms
No 

Default maximum element weight for compiled forms cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  1.14

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.forms
No 

Default maximum element weight for forms cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  0.4

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.html
No 

Default maximum element weight for html cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  0.195

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.formFields
No 

Default maximum element weight for form fields images cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  8.577

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.sharedResources
No 

Default maximum element weight for shared resources cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  0.1

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.syncRelationships
No 

Default maximum element weight for sync relationships cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  0.4

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.actorViews
No 

Default maximum element weight for actor view cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  0.32

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.actorViewsMapping
No 

Default maximum element weight for actor views mapping cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  0.32

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.hashCache
No

Default maximum element weight for hash cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  200

Needs restart? —  Yes

arsystem.ehcache.referenceMaxElements
InMemoryWeight.refCount
No 

Default maximum element weight for ref count cache

To get the exact number of objects in the memory, you must multiply the value of this setting with the value of the arsystem.ehcache.referenceMaxElementsInMemory setting.

Default value —  0.4

Needs restart? —  Yes

arsystem.ehcache.peerListener.schemeNo 

Replication scheme with which the selected listeners interact. Each peer provider has a scheme name that  can be used by caches to specify a replication type.

Values are:

  • RMI (default)
  • JMS
  • Jgroups

Note: This setting is used by ehCache internally.

Needs restart? —  Yes

arsystem.ehcache.timeToLiveSecondsNo

Time limit (in seconds) for which an object can exist in the cache irrespective of its use.

Default value – 0

Needs restart? - Yes

arsystem.ehcache.timeToIdleSecondsNo

Time limit (in seconds) for which an object can exist in the cache without being used.

Default value - 0

Needs restart? - Yes

arsystem.ehcache.eternal

No

This attribute overrides the timeToLive and timeToIdle parameters. When this parameter is set to true, the object is not expired from the cache.

Values are:

True – The object is not expired from the cache.

False – The object does not remain in the cache forever.

Needs restart? – Yes

arsystem.ehcache.diskExpiryThreadIntervalSeconds

No

Time interval (in seconds) between runs of the disk expiry thread.

Default value – 600 seconds

Needs restart? - Yes

arsystem.ehcache.enableStatsNo Flag that indicates whether the cache statistics records cache hits and misses

Values are:
  • true
  • false (default)

Needs restart? —  Yes

arsystem.enable_AnimationNo Flag that indicates whether animation in Javascript should be enabled. This applies to animations, such as open dialog and flashboard.

Values are:
  • true (default)
  • false

Needs restart? —  No

arsystem.xmlhttp.getNo Flag that indicates whether the AJAX calls made within the Backchannel requests use the http GET or POST method while sending requests to BMC Remedy Mid Tier

Values are:
  • true — (default) Requests are sent by using the GET method
  • false — Requests are sent by using the POST method
    Note: If arsystem.xmlhttp.get = false, enable the XSS Filter statements in the web.xml file to prevent the ARERR [1586] error on BMC Remedy Flashboards. For more information, see Knowledge Article KA383946. 

Needs restart? —  No
For security guidelines see, General security guidelines. 

arsystem.windowiis.installedNo Flag that indicates whether mid tier is running on the IIS server. This setting is used to display the information on the configuration overview page.

Values are:
  • true
  • false (default) 

Needs restart? —  No

flashboards.showgraphinflashNo 

Indication that charts are drawn by.using either Flash (interactive) or JFreeChart (image) in Flashboards

Default value — 1

Needs restart? —  Yes

flashboards.min_flex_widthNo 

Minimum width of a chart in Flashboards

Default value — 260

Needs restart? —  No

flashboards.min_flex_heightNo 

Minimum height of a chart in Flashboards

Default value —  200

Needs restart? —  No

arsystem.searches.maxAllowedNo 

Maximum number of search qualifications that can be stored for a user

Default value — 90

Needs restart? —  Yes

arsystem.enableMidTierPerfMBeanNo Flag that indicates whether the mid tier performance Mbean is deployed on startup and whether mid tier can provide additional monitoring parameters through JMX

Values are:

  • true
  • false (default)

Needs restart? —  Yes

arsystem.max_number_of_prefetch_threadNo 

Maximum number of threads spawned during the preload operation. This parameter is per AR System server.

Default value — 4

Needs restart? —  Yes

arsystem.response.hostipNo Flag that indicates whether the ARRESPONSEHOSTIP header is added to every response that goes out from the mid tier.

Values are:
  • true — Adds the header to every response, with the value as client IP address. This header can be used in load balancer or other proxies to create rules.
  • false —  (default) Does not add the header.

Needs restart? —  No

arsystem.allow.returnback.urlNo Flag that indicates whether direct access URL through LoginServlet is allowed

Values are:

  • true (default)
  • false

Needs restart? —  Yes

For security guidelines see, General security guidelines. 

arsystem.daemonthread_priorityNo 

Priority for the daemon threads spawned from BMC Remedy Mid Tier for background threads, such as preload and synch

Default value — 4

Needs restart? —  Yes

arsystem.serverinfo.alertschema.update.intervalNo 

Time interval to verify whether the server information cached in mid tier is considered old. If this value is reached or exceeded, the server information is recached.

Default value — 604800

Needs restart? —  No

arsystem.plugin_securitycheckNo Flag that indicates whether the cross-site script attack detection should be checked for plugins

Values are:

  • true (default)
  • false

Needs restart? —  No

arsystem.use_connectionpoolingNo Flag that indicates whether to use connection pooling for the AR System server

Values are:

  • true (default)
  • false

Needs restart? —  Yes

arsystem.flash.detect_flashplayerNo 

Flag that indicates whether the validation for the flash plugin in the browser should be performed on the login page

Values are:

  • true (default)
  • false

Needs restart? —  No

arsystem.loginpage.enable_accessible_modeYes

Flag that indicates whether the Accessible mode field is enabled in the login page.

Values are:

  • true
  • false (default)

Needs restart? —  

arsystem.maxRetrieveForAutoCompleteMenuNo Maximum number of items returned from a menu expand query

Default value — 300

Needs restart? —  No

arsystem.autoCompleteTypingTimeoutNoTimeout value for the auto complete functionality after which the auto complete menu will disappear

Default value — 400

Needs restart?   No

arsystem.min_entries_for_streamingNoMinimum number of entries retrieved in a native report after which the information is transferred to the browser

Default value — 1000

Needs restart? —  No

arsystem.flash.enable_ui_renderingNo

Flag that indicates whether the HTML user interface should be rendered by using flash objects or simple HTML and images

Values are:

  • true (default)
  • false

Needs restart? —  No

arsystem.emit_X_UA_compatible_modeNo 

Flag that indicates whether to emit compatible mode for browsers

Property to set the document mode for the BMC Remedy Mid Tier forms or pages.

Values are:

  • Edge (default)—The browser works at the highest document standard allowed.
  • True—Carried over from 8.1 in the case of an upgrade, but functionally same as Edge.
  • 11—The browser is forced to work at IE11 standard.
  • 10—The browser is forced to work at IE10 standard.
  • 9—The browser is forced to work at IE9 standard.
  • 8—The browser is forced to work at IE8 standard.

Note: This property is exclusively used for Internet Explorer.

Needs restart? —  

arsystem.nativereport.onscreen_max_entriesNoMaximum number of entries that will be displayed on the screen for native reports

Default value — 2000

arsystem.FileExport_max_entriesNoMaximum number of entries that will be displayed for native reports while exporting to a file

Default value — 2000

Needs restart? —  No

arsystem.webreport.onscreen_max_entriesNo

Maximum number of entries that will be displayed on the screen for web (BIRT) reports

Default value — 2000

Needs restart? —  No

arsystem.objectlistNo 

Flag that indicates whether the object list is enabled on mid tier

Values are:

  • true (default)
  • false

Note: When set to true, ensure that the corresponding form to display object the list is imported on the AR System server.

Needs restart? —  No

arsystem.enableSkinsNo 

Flag that indicates whether skins are enabled on the mid tier.

Values are:

  • true (default)
  • false

Needs restart? —  No

arsystem.inclusion_attachment_extensionsNo 

Comma-separated list of all file extensions that are allowed for attachments.

Note: Attachment security must be defined on the server side for this property to have any effect. For more information, see Setting security restrictions on file uploads.

Needs restart? —  No

arsystem.inclusion_goto_urlsNo 

Comma-separated list of URLs that are allowed in the goto request parameter of LoginServlet and LogoutServlet so that the user is automatically redirected to the specified URL.

Needs restart? —  No
For security guidelines see, General security guidelines.

arsystem.myreport.report_cache_limitNo

Maximum number of reports that will be saved for quick reports.

Default value — 20

Needs restart? —  No

arsys.arf.atssoconfirmpwd

No Plugin used by the BMC Remedy AR System server to fetch the user password information from the BMC Atrium Single Sign-On (SSO) server.
arsystem.host.header_listNo

The following procedure is applicable only for BMC Remedy AR System 9.1.00.001 and later

Perform the following steps before applying BMC Remedy AR System 9.1 Patch 001.

  1. Stop the server where Mid Tier is running.
  2. Navigate to \ARSystem\midtier\WEB-INF\classes\config.properties location.
  3. Edit config.properties to add the following parameter.
    For example: arsystem.host.header_list = <Trusted Host name(s) with comma separation>,
    Where,
    localhost is the computer on which the Mid Tier is installed.

  4. Save the settings.
  5. Start the server where Mid Tier is running.

Proceed with the patch installation.

arsystem.ehcache.midTierBackupCacheDir

No

Absolute path of the folder that contains the good copy of the backed up cache.

arsystem.show_session_timeout_PopupNo

Enables notification for mid tier session timeout. Allows you to extend the mid tier session.

Default value — False

Needs restart?   Yes

arsystem.attachments.inmemoryattdatalimitNo

Maximum size (in bytes) that an attachment can be in order to reside in-memory.

Default value — 4 MB

Needs restart?   Yes

arsystem.attachments.inmemory.heapsize.maxNo

Maximum amount of memory available (in bytes) for holding in-memory attachments.

Default value — 20 MB

Needs restart?   Yes

arsystem.attachments.inmemory.heapsize.resize.ratioNo

Percentage of the maximum memory that the heap should be resized to when items need to be moved from memory to disk.

Setting this value avoids a lot of disk I/O operations that occur when moving older attachments to disk or when new attachments are being added.

Default value — 0.75d (75%)

Needs restart?   Yes


Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Andreas Mitterdorfer

    arsystem.xmlhttp.get setting needs a restart of tomcat. Please can you correct the documentation?

    On further review I think this needs to be checked for each setting. I'm quite sure that arsystem.ehcache.diskcache.maxElementsInMemory or other settings require a tomcat restart aswell.

     

    In the note you mention:

    When you modify any property, you must restart BMC Remedy Mid Tier for the changes to take effect.

    but within the settings the needs restart is No?

     

    Nov 16, 2016 01:19
    1. Smita Patil

       Hi Andreas,

      Thanks for your comment. I will get in touch with SME regarding this and update the topic.

      Regards,

      Smita

      Nov 16, 2016 04:43
    1. Smita Patil

      Hello Andreas,

      I contacted SME and based on inputs from him, I have updated the global note. I have also modified restart requirement for arsystem.ehcache.diskcache.maxElementsInMemory setting. As per SME inputs, restart is not required for arsystem.xmlhttp.get setting.

      Regards,

      Smita

      Nov 16, 2016 11:06
  2. Andreas Mitterdorfer

    Thanks Smita (smile)

    However I'm not able to find the midtier component in generic UI?

    Edit: Just checked a second 9.1.01 installation, no midtier component in generic ui. MT is installed on same box as AR server.

    Please can you crosscheck wheter midtier component should be available in generic ui? If yes how does the AR server change the config file of midtier technically considering a midtier installed on a different server (and probably behind a firewall?)?

    Nov 17, 2016 01:21
    1. Smita Patil

       Hi Andreas,

      I will check with SME regarding your query and will get back to you.

      Regards,

      Smita

      Nov 17, 2016 10:30
    1. Smita Patil

      Hello Andreas,

      You need to use BMC Remedy Mid Tier Configuration Tool to set Centralized Configuration Server (CCS) properties. Request you to please visit the following link and follow the steps to set CCS properties: Centralized configuration for the mid tier

      Once you set these properties, Mid Tier will be available in AR System Configuration Generic UI form.

      For details on centralized configuration, see : Centralized configuration

      Regards,

      Smita

       

      Nov 18, 2016 12:45
      1. Andreas Mitterdorfer

        Thank you Smita, I complete missed that this needs to be configured separatly. (smile)

        Nov 18, 2016 01:23
  3. Andreas Mitterdorfer

    Please can you add addtional information to arsystem.xmlhttp.get parameter ?

     

    https://bmcsites.force.com/casemgmt/sc_KnowledgeArticle?sfdcid=kA214000000d3iFCAQ&type=Solution

    mentions that you have to enable the XSS filters in web.xml if you set arsystem.xmlhttp.get= false in order to prevent errors on flashboards. I think it would be good that this is documented for the parameter aswell.

    Dec 12, 2016 05:41
    1. Prachi Kalyani

      Hello Andreas,

      We are working on updating the topic.

      Thanks,

      Prachi

      Dec 18, 2016 11:22
    1. Prachi Kalyani

      Hello Andreas,

      I have updated the topic.

      Thanks,

      Prachi

      Jan 03, 2017 03:54
  4. Jose antonio Gonzalez

    Hi, 

    Currently, I have to modify the arsystem.compression_index in a 9.1 version due a problem with RSSO. Could you add the parameter?

    In version 8.1 docs said:

    The arsystem.enableContentCompression andarsystem.enableBackChannelCompression properties have been replaced byarsystem.compression_index.

    Regards,

    Jose

    Feb 15, 2017 08:15
    1. Prachi Kalyani

      Hello,

      We are verifying this. We will get back to you soon. 

      Thanks,

      Prachi

      Mar 01, 2017 05:03
  5. Sally Ludwig

    https://docs.bmc.com/docs/display/public/ars81/Settings+in+the+config.properties+file#Settingsintheconfig.propertiesfile-content -
    has better information on the arsystem.compression_index, arsystem.enableContentCompression and arsystem.enableBackChannelCommpression parameters. 9.1 docs need to reflect the same - 9.1 docs are currently incorrect.

    Sep 14, 2017 08:55
  6. Stefan Hall

    I found a lot more ehcache setting on one of my config.properties file. Unfortunately I found nothing about them here, maybe older entries arsystem.ehcache.diskExpiryThreadIntervalSeconds=600 arsystem.ehcache.eternal=true arsystem.ehcache.internalSaveToDiskInterval=3600 arsystem.ehcache.timeToIdleSeconds=0 arsystem.ehcache.timeToLiveSeconds=0

    Nov 13, 2017 10:08
  7. Stefan Hall

    I found a lot more ehcache setting on one of my config.properties file. Unfortunately I found nothing about them here, maybe older entries

    arsystem.ehcache.diskExpiryThreadIntervalSeconds=600 arsystem.ehcache.eternal=true arsystem.ehcache.internalSaveToDiskInterval=3600 arsystem.ehcache.timeToIdleSeconds=0 arsystem.ehcache.timeToLiveSeconds=0

    Hope, this will be better readable

    Nov 13, 2017 10:13
    1. Anagha Deshpande

      Hello Stefan,

      Thanks for your feedback. I will work with the SME and will update the topic.

      Regards,

      Anagha

      Nov 13, 2017 09:38
    1. Himanshu Raul

      Hi Stefan,

      Thank you for your feedback on the documentation. We have updated the topic with the missing ehcache parameters.

      Regards,

      Himanshu

      Jul 24, 2019 04:53
  8. Stefan Hall
    1. the page is broken, the parameter table is displayed twice.
    2. I am missing the new(?) parameter "arsystem.disable_popup_blocker". With MT 1805 I see this for the first time
    Aug 22, 2018 04:14
    1. Anagha Deshpande

      Hello Stefan,

      Thanks for bringing this to our notice. We will fix the issue soon.

      Regards,

      Anagha

      Aug 22, 2018 10:24
      1. Anagha Deshpande

        Hello Stefan,

        Sorry for the delayed response.

        I have added the arsystem.disable_popup_blocker property to the topic.

        Please see the documentation here.

        Regards,

        Angaha

        Oct 24, 2018 06:14