Configuration settings A-B

This setting indicates whether credentials are allowed in a cross-origin request.

Valid values:

• True — Credentials are allowed.
• False — Credentials are not allowed.

Default value — true

AR System Administration Console > System > General > Centralized Configuration

(Optional) This setting indicates the HTTP request headers that are exposed to the browser for cross-origin requests.

Valid values:

• * — All HTTP request headers are allowed.
• Comma separated header names — Describe the comma separated header list . For exanple, Content-Type, Authorization.

Default value — "" (empty)

This setting indicates the HTTP request headers that are allowed for cross-origin requests.

Valid values:

• * — All HTTP request headers are allowed.
• Comma separated header names — Describe the comma separated header list . For exanple, Content-Type, Authorization.

Default value — Pragma, X-Requested-By, Authorization,Content-Type, Cache-Control

This setting indicates the HTTP methods that are allowed for cross-origin requests.

Valid values:

• * — All HTTP methods are allowed.
• Comma separated method names — Describe the comma separated methods list . For exanple, GET,POST,PUT,OPTIONS.

Default value — "" (empty)

Access-Control-Allow-Origin
(Component name: com.bmc.arsys.server.shared)

A header that indicates cross-origin requests are allowed.

This setting indicates the origins that can make REST API calls on the AR System Server. An origin consists of a protocol, host, and port number.

Valid values:

• * — All domains are allowed (Not recommended)
• Comma separated origins — Describe the comma separated list of multiple origins. For exanple, http://localhost:8080,http://www.example.com

Default value — "" (empty)

Active-Link-Dir

(Component name: com.bmc.arsys.server)

Directory in which active link server run processes are stored. Only commands in the specified directory can be run. This is a security feature that ensures clients or API programs use only a safe set of server processes.

AR System Administration Console > System > General > Server Information > Advanced > Security section > Active Link Run Process Directory.

(See Setting performance and security options.)

Active-Link-Shell

(Component name: com.bmc.arsys.server)

(UNIX only) Parent shell of any active link server process. This parameter causes the server to start the shell with the specified process as a parameter. This is a security feature. The specified shell might be a security shell that verifies a path or runs with a user ID other than the one the server uses. For example, if the server runs as root and an administrator specifies a shell that runs as a lower user privilege, an active link invokes the shell that runs as a user instead of as root. Because the AR System server passes the shell command to the Active-Link-Shell as a single string without any other command-line arguments, the command parameters can often be interpreted incorrectly. As AR System server does not know which custom shell must be used for active link processing, it cannot supply all of the necessary arguments. To avoid this and use the Active-Link-Shell Feature correctly, follow the steps listed below:

1. Determine what your desired shell is, and how to invoke it passing a single command line. If the desired shell is /bin/csh, the correct way to invoke with a single command line is

   "/bin/csh" "-c" "process command"

2. Write a /bin/shscript that invokes your custom shell in the required manner, as shown below:

   #!/bin/sh
   # Usage:
   #    /path/to/arsystem-csh-helper process-command
   # Pass process-command as a command line to /bin/csh.
   #
   # use "$*" preserve argument as a single string
   exec /bin/csh -c "$*"

3. Put the script in a location where the AR System server will be able to call it. For example, local utilities are often installed in a directory named /usr/local or /usr/local/bin. Another good location might be the AR System server installation directory. Be sure to mark the new program executable:

   # cp arsystem-csh-helper /usr/local/arsystem-csh-helper
   # chmod 755 /usr/local/arsystem-csh-helper

4. In the AR System server configuration, change the Active-Link-Shell to be the new program /usr/local/arsystem-csh-helper.

Admin-Only-Mode

(Component name: com.bmc.arsys.server)

Flag indicating whether only administrators and subadministrators can access the server.

Valid values:

• T — Admin-only mode is on.
• F — (Default) Admin-only mode is off.

AR System Administration Console > System > General > Server Information > Configuration > Administrator-Only Mode.

(See Setting administrative options.)

AE-Log-Enabled

(Component name: com.bmc.arsys.assignment)

Flag indicating whether the Assignment Engine logging is enabled.

Valid values:

• 1 — (Default) Assignment Engine logging is disabled.
• 0 — Assignment Engine logging is enabled.

Assignment Engine Administration Console > Sever Settings > Enable Assignment Engine Logs.

AE-Log-File

(Component name: com.bmc.arsys.assignment)

File name for assignment engine logs.

Restart Required — No

AE-Logging-Level

(Component name: com.bmc.arsys.assignment)

Indicates the type of logging level.

Valid values:

• (Default) INFO
• DEBUG — The maximum logging level
• ERROR —  The minimum logging level

Assignment Engine Administration Console > Sever Settings > Log File Level.

AE-Max-Log-File-Backups

(Component name: com.bmc.arsys.assignment)

Indicates the maximum number of backup (.bak) log files to be allowed when the log file reaches the Max Log File Size value and a new log file is created. 

Default value: 0

Assignment Engine Administration Console > Sever Settings > Max Back-up Index.

(See Configuring the Assignment Engine server settings ).

AE-Max-Log-File-Size

(Component name: com.bmc.arsys.assignment)

Indicates the maximum size (in megabytes) for the log file. 

Default value: 10 MB

Assignment Engine Administration Console > Sever Settings > Max Log File Size.

AE-Poll-Interval

(Component name: com.bmc.arsys.assignment)

Interval (in minutes) at which the Assignment Engine polls the BMC Remedy AR System server. If this option is not specified, the polls occur every 4 minutes.

Default value: 4 minutes

Assignment Engine Administration Console > Sever Settings > Polling Interval.

AE-Worker-Threads

(Component name: com.bmc.arsys.assignment)

Indicates the total number of worker threads that process various assignment requests. 

 Default value: 3

Assignment Engine Administration Console > Sever Settings > Number of Threads.

(See Configuring the Assignment Engine server settings).

Allow-Backquote-In-Process-String

(Component name: com.bmc.arsys.server)

Option that enables the server to run a process with a backquote in the process name or in its arguments.

Valid values:

• T — Allows the server to run a process with a backquote.
• F (Default) — Does not allow the server to run a process with a backquote.

Allow-Guest-Users

(Component name: com.bmc.arsys.server)

Flag indicating whether the BMC Remedy AR System server accepts guest users (users not registered with BMC Remedy AR System in a User form).

Valid values:

• T — (Default) Allow guest users. Unregistered users have no permissions but can perform some basic operations. For example, they can submit requests to forms to which the Public group has access and whose fields allow any user to submit values.
• F — Do not allow guest users. Unregistered users have no access to the system.

The default value is set to F.

AR System Administration Console > System > General > Server Information > Configuration > Allow Guest Users.

(See Setting administrative options.)

Allow-Unqual-Queries

(Component name: com.bmc.arsys.server)

Flag indicating whether unqualified searches can be performed on the BMC Remedy AR System server. Unqualified searches are ARGetListEntry or ARGetListEntryWithFields calls in which the qualifier parameter is NULL or has an operation value of 0 (AR_COND_OP_NONE ). Such searches can cause performance problems because they return all requests for a form. This is especially problematic for large forms.

Valid values:

• T — Allow unqualified searches.
• F — (Default) Do not allow unqualified searches.

Alternate-Approval-Reg²

(Component name: com.bmc.arsys.approval)

Flag indicating how applications such as Approval Server or Reconciliation Engine listen for the BMC Remedy AR System server's signal.

Valid values:

• T — (Default) Listen for the application dispatcher to signal.
  If your application relies on the application dispatcher, set this option to T. To verify that arsvcdsp is configured to start with the BMC Remedy AR System server, check the armonitor.cfg (armonitor.conf ) file.
• F — Listen for the server's signal directly.

Note:

• The BMC Remedy AR System server installation creates this entry and sets the value to T.
• You should change the value to F only when the application dispatcher is not working. This provides an alternative method to receive signals from the AR System server.

AlwaysOn-Log-History

Number of Always On log file backups that you need to store.

Default value: 2

AR System Administration Console > System > General > Server Information > Always On Logging > Maximum Backups.

(See Setting Always On logging.)   

API-Log-File

(Component name: com.bmc.arsys.server)

Full path name of the file to use if API logging is on (see Debug-mode).

AR System Administration Console > System > General > Server Information > Log Files > API Log.

(See Setting log files options.)

API-Recording-Client-Type

(Component name: com.bmc.arsys.server)

Indicates the client types for which you want to monitor the API calls. By default, this field does not have any value set which means that the calls from all client types are monitored.
Use this format:

<clientType>;<ipAddressExpression>;<clientType>;<ipAddressExpression>

• clientType — Indicates the client type to be monitor. This takes an integer value and a * value in this field indicates that API calls from any client type are monitored. For information on supported client types and their values, see Client types.
• ipAddressExpression — Indicates a regular expression used to match the source address. This is an optional value to specify. If you do not specify any value, all source addresses are matched by default.
  For example, you might add the following values:
• 0;1;2 — API calls from client types 0, 1, and 2 (all source addresses are matched).
• 0 ^10\..;1;2* — API calls from client types 1 and 2 included (all source addresses are matched as the regular expression is not specified). API calls from client type 0 included if the source address is from an IP address starting with 10.
• 0;* ^(?!10\.) — API calls from client type 0 ("unknown") are recorded (all source addresses are matched as the regular expression is not specified). API calls from all clients with a source address that does not start with 10 are included.
• ^(?!10\.)(?!11\.) — API calls from all clients with a source address that does not start with 10 or 11 are included.

API-Recording-Enable

(Component name: com.bmc.arsys.server)

Specifies whether you want to enable the system for monitoring API calls.

Valid values:

• Yes —  Indicates that monitoring is enabled.
• No — (Default) Indicates that monitoring is disabled.

Application-Enable

(Component name: com.bmc.arsys.server)

This override flag allows to rename the application pending system form.

Default value — false

Approval-Debug-Type²

(Component name: com.bmc.arsys.approval)

This setting specifies the log level for approval server. Values are:

• 0 — (Default) The minimum logging level for BMC Remedy Approval Server is NORMAL (or INFO).
• 1 — The highest logging level for BMC Remedy Approval Server is ALL (or DEBUG).

Approval-Defn-Check-Interval ²

(Component name: com.bmc.arsys.server)

Approval-Due-Soon²

(Component name: com.bmc.arsys.approval)

The duration after which the approval requests that are due for action are highlighted on Approval Central.

Approval-Log-File ²

(Component name: com.bmc.arsys.server)

Flag indicating whether approval notifications are configured from the Server Settings dialog box. An Approval-Notify entry exists for each ID.

Warning: Do not change this option in the AR System Configuration Component Setting form. Instead, from the AP:Administration form, click the Server Settings link to open a dialog box with configuration settings for the Approval Server.

Approval-Polling-Interval ²

(Component name: com.bmc.arsys.approval)

Interval at which the Approval Server polls the AR System server for pending work. This setting is intended as a backup method, not the primary contact method. Under normal circumstances, the AR System server or the Application Dispatcher (depending on the configuration) contacts the Approval Server when work is pending. When this option is specified, the Approval Server polls the AR System server only if it does not receive a signal from the AR System server in the specified time. Specify the interval in seconds. Minimum is 30 seconds. Maximum is 3600 seconds (one hour).

Approval-Recent-History²

(Component name: com.bmc.arsys.approval)

Approval-RPC-Socket ²

(Component name: com.bmc.arsys.server)

AR-Max-Attach-Size ²

(Component name: com.bmc.arsys.server)

Maximum size (in bytes) of compressed attachments that can be sent to the AR System database from the AR System server. By preventing large attachments from being sent to the database, you can prevent excessive memory growth and reduce transmission time. This limit does not apply to attachments retrieved from the database by the AR System server. This option applies to all databases.

Note: To limit the size of compressed attachments that the server can retrieve from Oracle databases, use Db-Max-Attach-Size.

ARDBC-LDAP-Base-DN 

(Component name: com.bmc.arsys.ldap.ardbc)

Base distinguished name (DN) to use instead of the root DN as the starting point for discovering vendor tables when you design vendor forms. For example: ARBDC-LDAP-Base-DN: CN=Users, DC=ldapesslab, DC=com.

AR System Administration Console > System > LDAP > ARDBC Configuration > Base DN For Discovery. 

(See Configuring the ARDBC LDAP plug-in.)

ARDBC-LDAP-Cache-MaxSize 

(Component name: com.bmc.arsys.ldap.ardbc)

Size limit (in bytes) for the cache. For no size limit, set this to 0.

Default value: 32768 bytes

AR System Administration Console > System > LDAP > ARDBC Configuration > ARDBC Plugin Cache section > Maximum Size.

(See Configuring the ARDBC LDAP plug-in.) 

ARDBC-LDAP-Cache-TTL

(Component name: com.bmc.arsys.ldap.ardbc) 

Time limit (in seconds) that data remains cached. For no time limit, set this to 0.

Default value: 60 seconds

AR System Administration Console > System > LDAP > ARDBC Configuration > ARDBC Plugin Cache section > Time To Live.

(See Configuring the ARDBC LDAP plug-in.) 

ARDBC-LDAP-Cert-DB 

(Component name: com.bmc.arsys.ldap.ardbc)

Directory name of the certificate database. The cert8.db or cert7.db and key3.db certificate database files are in this directory. If the directory is not specified, the LDAP plug-in looks in the BMC Remedy AR System installation directory for these files. The path in this option is used only when ARDBC-LDAP-UsingSSL is set toT.

AR System Administration Console > System > LDAP > ARDBC Configuration > Certificate Database.

(See Configuring the ARDBC LDAP plug-in.)

ARDBC-LDAP-Cert-Name ²

(Component name: com.bmc.arsys.ldap.ardbc)

ARDBC-LDAP-Chase-Referrals ²

(Component name: com.bmc.arsys.ldap.ardbc)

Flag that enables automatic referral chasing by LDAP clients.

Valid values:

• T — Referrals are chased.
• F — (Default) Referrals are not chased.

This option is for Microsoft Active Directories only.

ARDBC-LDAP-Connect-Timeout ²

(Component name: com.bmc.arsys.ldap.ardbc)

ARDBC-LDAP-DN-Timeout ²

(Component name: com.bmc.arsys.ldap.ardbc)

Number of seconds that the plug-in retains the base distinguished name (DN) used to access an LDAP ARDBC vendor form after the user becomes inactive.

Default: 3600 seconds

ARDBC-LDAP-Drop-Large-Values ²

(Component name: com.bmc.arsys.ldap.ardbc)

ARDBC-LDAP-Hostname 

(Component name: com.bmc.arsys.ldap.ardbc)

Host name of the system on which the directory service runs. If the host name is not specified, the ARDBC LDAP plug-in uses localhost as the host name. For example:ARDBC-LDAP-Hostname: server1.eng.remedy.com

AR System Administration Console > System > LDAP > ARDBC Configuration > Host Name. 

(See Configuring the ARDBC LDAP plug-in.) 

ARDBC-LDAP-Page-Size ²

(Component name: com.bmc.arsys.ldap.ardbc)

Page size in the pagedResultsControl of the ARDBC LDAP plug-in search request. This specifies the number of entries to return per page from the external directory server to the client when processing a search request containing the pagedResultsControl. The maximum value is 100,000. The minimum value is 100. (See Using the ARDBC LDAP plug-in.)

Default value: 10,000

ARDBC-LDAP-Port

(Component name: com.bmc.arsys.ldap.ardbc)

Port number on which the directory service listens for clients.

AR System Administration Console > System > LDAP > ARDBC Configuration > Port Number.

(See Configuring the ARDBC LDAP plug-in.)

ARDBC-LDAP-Time-Format ²

(Component name: com.bmc.arsys.ldap.ardbc)

Format of LDAP date and time data.

Valid values:

• 0—Generalized Time Format (YYYYMMDDHHMMSSZ ) This format is recognized by all LDAP servers and is recommended.
• 1—AD Generalized Time Format (YYYYMMDDHHMMSS.0Z ) This format is recognized by Microsoft Active Directory servers only.
• 2—UTC Time Format (YYMMDDHHMMSSZ )

This historical format does not indicate the century. It is not recommended.

ARDBC-LDAP-Use-Cache ²

(Component name: com.bmc.arsys.ldap.ardbc)

ARDBC-LDAP-User-DN 

(Component name: com.bmc.arsys.ldap.ardbc)

Distinguished name (DN) of the user account that the ARDBC LDAP plug-in uses to search and modify the contents of the directory service. For example: ARDBC-LDAP-User-DN: server1\admin

AR System Administration Console > System > LDAP > ARDBC Configuration > Bind User.

(See Configuring the ARDBC LDAP plug-in.) 

ARDBC-LDAP-UsingSSL

(Component name: com.bmc.arsys.ldap.ardbc)

Flag indicating whether to establish a secure socket layer (SSL) connection to the directory service. Values are T and F. If you use LDAP over SSL, you must also specify the file name of the certificate database used to establish the connection.

AR System Administration Console > System > LDAP > ARDBC Configuration > Using Secure Socket Layer.

(See Configuring the ARDBC LDAP plug-in.) 

ARJdbc-Script-Execution-Status

(Component name: com.bmc.arsys.server.shared)

Flag indicating whether the scripts required for defining the database functions by using the AR System JDBC:Generic Db Functions form ran successfully. The AR System Server checks this value during startup and runs the scripts if the value is not set to Done.

Valid values:

• Started—Indicates that the scripts execution has started and is in progress.
• Done—Indicates that the scripts ran successfully.
• Error—Indicates that the scripts failed due to an error.

AREA-LDAP-Bind-Password 

(Component name: com.bmc.arsys.ldap.ardbc)

Password of the user account that the AREA LDAP plug-in uses to find the user object when using the User Search filter. If the distinguished name (DN) is not specified, the AREA LDAP plug-in uses an anonymous login to find the user object. If the target directory service does not allow anonymous access, you must specify a DN and password; otherwise, the plug-in cannot determine the DN of the user.

No

AR System Administration Console > System > LDAP > AREA Configuration > Bind Password.

(See Configuring the AREA LDAP plug-in.)

AREA-LDAP-Bind-User 

(Component name: com.bmc.arsys.ldap.area)

Distinguished name (DN) of the user account that the AREA LDAP plug-in uses to find the user object when using the User Search filter. If the DN is not specified, the AREA LDAP plug-in uses an anonymous login to find the user object. If the target directory service does not allow anonymous access, you must specify a DN and password; otherwise, the plug-in cannot determine the DN of the user. For example: AREA-LDAP-Bind-User: ldapesslab\admin

AR System Administration Console > System > LDAP > AREA Configuration > Bind User.

(See Configuring the AREA LDAP plug-in.)

AREA-LDAP-Cert-DB 

(Component name: com.bmc.arsys.ldap.area)

Directory name of the certificate database. The cert8.db or cert7.db and key3.db certificate database files are in this directory. If the directory is not specified, the LDAP plug-in looks in the BMC Remedy AR System installation directory for these files. This path is used only when ARDBC-LDAP-UsingSSL is set to T.

AR System Administration Console > System > LDAP > AREA Configuration > Directory Service Information section > Certificate Database.

(See Configuring the AREA LDAP plug-in.)

AREA-LDAP-Chase-Referral  ²

(Component name: com.bmc.arsys.ldap.area)

Flag that specifies whether referral chasing is performed by the AD server or the AREA LDAP plug-in.

Valid values:

• T — Referral chasing is performed by the AD server.
• F — (Default) Referral chasing is performed by the AREA LDAP plug-in (via the third-party LDAP library).

This option is for Microsoft Active Directories only.

Note: To force referral chasing logic to be disabled, you must also specify the AREA-LDAP-Disable-Referral option.

AR System Administration Console > System > LDAP > AREA Configuration > Directory Service Information section > Chase Referral.

(See Configuring the AREA LDAP plug-in.)

AREA-LDAP-Connect-Timeout 

(Component name: com.bmc.arsys.ldap.area)

Number of seconds that the plug-in waits to establish a connection with the directory service. The minimum value is 0, in which case the connection must be immediate. The maximum value is the External-Authentication-RPC-Timeout setting. If a value is not specified, this option is set to the value of the External-Authentication-RPC-Timeout option (by default, 40 seconds).

AR System Administration Console > System > LDAP > AREA Configuration > Directory Service Information section > Failover Timeout.

(See Configuring the AREA LDAP plug-in.)

AREA-LDAP-Disable-Referral  ²

(Component name: com.bmc.arsys.ldap.area)

Flag that disables all referral processes by the AREA LDAP plug-in.

Valid values:

• T— Referrals are disabled.

  Note: This overrides the AREA-LDAP-Chase-Referral setting.

• F — (Default) Referrals are not disabled. For information about how the referrals are processed, see ar.cfg or ar.conf options A-B. The referral option is for Microsoft Active Directories only. When connecting to a non-Microsoft Active Directory, you should disabling referral processing.

AREA-LDAP-Email ²

(Component name: com.bmc.arsys.ldap.area)

AREA-LDAP-Email-Default ²

(Component name: com.bmc.arsys.ldap.area)

AREA-LDAP-Group-Base 

(Component name: com.bmc.arsys.ldap.area)

Base of the LDAP directory to search groups from. To determine the option's values at runtime, use these keywords:

Note: The backslash (\) is required.

• $\USER$ — User's login name.
• $\DN$ — User's distinguished name. This applies only to the Group Base Name and Group Search Filter. It does not apply to the User Base name and User Search filter.
• $\AUTHSTRING$ — Value that users enter into the Authentication String field when they log in.
• $\NETWORKADDR$ — IP address of the AR System client accessing the AR System server.

AR System Administration Console > System > LDAP > AREA Configuration > User and Group Information section > Group Base.

(See Configuring the AREA LDAP plug-in.)

AREA-LDAP-Group-Default ²

(Component name: com.bmc.arsys.ldap.area)

AREA-LDAP-Group-Filter 

(Component name: com.bmc.arsys.ldap.area)

LDAP search filter used to locate the groups to which the user belongs. To determine the option's values at runtime, use these keywords:

Note: The backslash (\) is required.

• $\USER$ — User's login name.
• $\DN$--- User's distinguished name. This only applies to the Group Base Name and Group Search Filter. It does not apply to the User Base Name and User Search Filter.
• $\AUTHSTRING$ — Value that users enter into the Authentication String field when they log in.
• $\NETWORKADDR$ — IP address of the AR System client accessing the AR System server.

AR System Administration Console > System > LDAP > AREA Configuration > User and Group Information section > Group Search Filter. 

(See Configuring the AREA LDAP plug-in.) 

AREA-LDAP-Hostname 

(Component name: com.bmc.arsys.ldap.area)

Host name of the system on which the directory service runs. If no value is specified, the AREA LDAP plug-in uses localhost as the host name.

AR System Administration Console > System > LDAP > AREA Configuration > Directory Service Information section > Host Name.

(See Configuring the AREA LDAP plug-in.)

AREA-LDAP-Lic ²

(Component name: com.bmc.arsys.ldap.area)

AREA-LDAP-Lic-Default ²

(Component name: com.bmc.arsys.ldap.area)

AREA-LDAP-LicApp ²

(Component name: com.bmc.arsys.ldap.area)

AREA-LDAP-LicApp-Default ²

(Component name: com.bmc.arsys.ldap.area)

AREA-LDAP-LicFTS 

(Component name: com.bmc.arsys.ldap.area)

AR System Administration Console > System > LDAP > AREA Configuration > Defaults and Mapping Attributes to User Information section > Full Text Search License. 

(See Configuring the AREA LDAP plug-in.) 

AREA-LDAP-LicFTS-Default 

(Component name: com.bmc.arsys.ldap.area)

AREA-LDAP-LicMask 

(Component name: com.bmc.arsys.ldap.area)

Attribute that specifies how to mask the license information returned from the AREA LDAP plug-in. Values are

• 0--No licenses returned from the AREA LDAP plug-in are used.
• 1--Write license from the plug-in is used.
• 4--Reserved license from the plug-in is used.
• 5--Reserved license and Write license from the plug-in are used.
• 8--Application license from the plug-in is used.
• 9--Application and Write licenses from the plug-in are used.
• 12--Application and Reserved licenses from the plug-in are used.
• 13--All licenses from the plug-in are used.

If the license is not used from the plug-in, the license information in the user's User entry is used.

AR System Administration Console > System > LDAP > AREA Configuration > Defaults and Mapping Attributes to User Information section > License Mask. 

(See Configuring the AREA LDAP plug-in.) 

AREA-LDAP-LicMask-Default ²

(Component name: com.bmc.arsys.ldap.area)

AREA-LDAP-LicRes1 ²

(Component name: com.bmc.arsys.ldap.area)

AREA-LDAP-LicRes1-Default ²

(Component name: com.bmc.arsys.ldap.area)

AREA-LDAP-Notify-Meth ²

(Component name: com.bmc.arsys.ldap.area)

AREA-LDAP-Notify-Meth-Default ²

(Component name: com.bmc.arsys.ldap.area)

AREA-LDAP-Port 

(Component name: com.bmc.arsys.ldap.area)

Port number on which the directory service listens for clients.

AR System Administration Console > System > LDAP > AREA Configuration > Directory Service Information section > Port Number.

(See Configuring the AREA LDAP plug-in.) 

AREA-LDAP-SSL-AUTH-OPTION ²

(Component name: com.bmc.arsys.ldap.area)

AREA-LDAP-Use-Groups

(Component name: com.bmc.arsys.ldap.area)

Flag indicating whether to retrieve group information from the LDAP server. If this parameter is not set, group information from the AR System Group form is used.

AR System Administration Console > System > LDAP > AREA Configuration > User and Group Information section > Group Membership.

(See Configuring the AREA LDAP plug-in.)

AREA-LDAP-User-Base 

(Component name: com.bmc.arsys.ldap.area)

User base in the LDAP directory to search for the user. To determine the option's values at runtime, use these keywords:

Note: The backslash (\) is required.

• $\USER$ — User's login name.
• $\DN$ — User's distinguished name. This only applies to the Group Base Name and Group Search Filter. It does not apply to the User Base Name and User Search Filter.
• $\AUTHSTRING$ — Value that users enter into the Authentication String field when they log in.
• $\NETWORKADDR$ — IP address of the AR System client accessing the AR System server.

AR System Administration Console > System > LDAP > AREA Configuration > User and Group Information section > User Base.

(See Configuring the AREA LDAP plug-in.) 

AREA-LDAP-User-Filter 

(Component name: com.bmc.arsys.ldap.area)

LDAP search filter used to locate the user in the directory from the base that the AREA-LDAP-User-Base option specifies. To determine the option's values at runtime, use these keywords:

Note: The backslash (\) is required.

• $\USER$ — User's login name.
• $\DN$ — User's distinguished name. This only applies to the Group Base Name and Group Search Filter. It does not apply to the User Base Name and User Search Filter.
• $\AUTHSTRING$ — Value that users enter into the Authentication String field when they log in.
• $\NETWORKADDR$ — IP address of the AR System client accessing the AR System server.

AR System Administration Console > System > LDAP > AREA Configuration > User and Group Information section > User Search Filter.

(See Configuring the AREA LDAP plug-in.) 

AREA-LDAP-UseSSL 

(Component name: com.bmc.arsys.ldap.area)

Flag indicating whether to establish a secure socket layer (SSL) connection to the directory service. Values are T and F. If you use LDAP over SSL, you must also specify the file name of the certificate database used to establish the connection.

AR System Administration Console > System > LDAP > AREA Configuration > Directory Service Information section > Use Secure Socket Layer.

(See Configuring the AREA LDAP plug-in.) 

Arerror-Exception-List 2

(Component name: com.bmc.arsys.server)

ARF-Java-VM-Options ²

(Component name: com.bmc.arsys.server)

Archive-Interval

(Component name: com.bmc.arsys.server)

Specifies the number of hours scheduled to run the global archive for all forms.

In a server group environment:

1. This configuration setting is shared among all the servers.
2. If you set this parameter on any of the server, it will be applicable for all the servers.

For information about setting, archive interval, see Setting global archive interval for forms.

AR System Administration Console > System > General > Server Information > Configuration > Archive Interval.

(See Setting global archive interval for forms.)   

arsystem.authentication_server 

Mid Tier Configuration Tool > General Settings > Preference Servers.

(See Configuring the General Settings page.) 

Valid values:

• true (Default)
• false

Mid Tier Configuration Tool > General Settings > Homepage Server.

(See Configuring the General Settings page.) 

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: To log out correctly, 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

Mid Tier Configuration Tool > General Settings > License Release Timeout.

(See Configuring the General Settings page.) 

Type of information that should be stored in the BMC Remedy Mid Tier log file.

Valid values:

• 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

Maximum size (in kilobytes) a BMC Remedy Mid Tier log 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 

BMC Remedy Mid Tier log output, which is generated using the standard Java 1.5 logging API, including Simple and XML formatting.

Valid values:

• 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. 

Directory in which the BMC Remedy Mid Tier 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 value: C:\Program Files\BMC Software\ARSystem\midtier\logs 

Level of detail for logging information for BMC Remedy Mid Tier.

Valid values:

• 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.

Method by which you want to view the BMC Remedy Mid Tier log files.

Valid values:

• 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.

Flag that indicates whether the object list is enabled on BMC Remedy Mid Tier.

Valid values:

• 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.

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

Valid values:

• true
• false (Default)

Mid Tier Configuration Tool > General Settings > Preference Servers.

(See Configuring the General Settings page.) 

Maximum number of connections in the AR System server JavaAPI connection pooling.
Default value: 80

• whether your web-page can be loaded in <iframe>, <frame>, <object>, <embed>, or <applet> tags.
• on what domains the web page is loaded.

This parameter has the following options:

• Self — (Default) Enables the current site to render the content.
• URI — Allow the specified URI to frame the page.
  You can pass multiple URIs. The URIs must be space-separated.
  For example, http://www.example.com/ http://www.example2.com
• None — Prevents any domain from rendering the content.

Mid Tier Configuration Tool > General Settings > Session Timeout.

(See Configuring the General Settings page.)

ASJ-Thread-Count ²
(Component name: com.bmc.arsys.approval)

Mode that enables the administrator to use more than one type of authentication on the same system.

Valid values:

• 0 (Off)--Use the default behavior. Users are authenticated based on the settings of Crossref-Blank-Password and Authenticate-Unregistered Users.
• 1 (ARS - AREA) — Use internal authentication as the primary method; use external authentication via the AREA plug-in as the secondary method.
• 2 (AREA - ARS) — Use external authentication via the AREA plug-in as the primary method; use internal authentication as the secondary method.
• 3 (ARS - OS- AREA) — If authentication fails in AR System (internal authentication), use the operating system authentication (for example, NT domain authentication). If the operating system fails, try external authentication (AREA).
• 4 (ARS - AREA - OS) — If authentication fails in AR System, try AREA. If AREA fails, try the operating system authentication.

If the value is not 0, the settings of the Crossref-Blank-Password and Authenticate-Unregistered Users parameters are ignored.

If the value is not 0 and the Crossref-Blank-Password parameter is enabled, users who have a blank password in the User form must provide a valid password (that is, a non-NULL password) during login.

Values 3 and 4 provide greater flexibility. For example, your external users might be authenticated with an AREA plug-in, and internal users might be authenticated by the NT domain.

The default value is set to 1.

Auth-Token-Signature-Salt¹

 (Component name: com.bmc.arsys.server)

Name of a plugin used by the BMC Remedy AR System server to confirm the user password information from the BMC Atrium Single Sign-On server.

Broker-Max-Memory-Usage

(Component name: com.bmc.arsys.server)

Maximum memory usage in MB that ActivqMQ JMS broker can consume. If there are memory issues with ActiveMQ messages, increase the value to above 256 MB.

Default value:  256 MB

Broker-Max-Temp-Storage

(Component name: com.bmc.arsys.server)

Maximum temp storage memory in MB used by ActiveMQ JMS broker. If there are issues with temp storage, increase the value to above 8192 MB.

Default value: 8192 MB

Broker-Send-Failed-No-Space-After-Timeout 

(Component name: com.bmc.arsys.server)

Configuration in seconds indicating the timeout delay before getting the error related to “no space available” for ActiveMQ JMS messages.

Default value: 30 seconds

Broker-Temp-Storage-Directory

(Component name: com.bmc.arsys.server)

Temp storage directory for ActiveMQ JMS broker.

Default value: Empty, meaning system temp folder.