Error: Invalid spaceKey on retrieving a related space config.

Configuration settings S-Z

The centralized configuration forms store the configuration settings. All the numeric values for the settings are in base 10 system. You can modify the settings by using the AR System Configuration Generic UI form. The settings are case- and space-sensitive. See Updating configuration settings by using the AR System Configuration Generic UI form.

Note

BMC recommends that you use the AR System Configuration Generic UI form to modify the configuration settings. Do not use the ar.cfg file to modify the configuration settings on the AR System Configuration Generic UI form.

The following table lists the settings available for centralized configuration.  

Tip

  • If you cannot view all the columns, click Full screen in the upper-right corner of the page to open it in full screen mode. Alternatively, use the scroll bar at the bottom of the table.
  • Press F to view the table in full screen mode. Press Esc to exit full screen mode.
  • To easily search for a specific parameter in the table, select the parameter from the Setting list. Alternatively, type the name of the parameter in the Setting text box. For example, to search for the Next-ID-Block-Size parameter, select it from the Setting list, or type the parameter name in the Setting text box.
  • To search for the parameters which have a specific text string in the description, type the string in the Description text box. For example, to search for the parameters which have Configuration in the description, type Configuration in the Description text box.

 Configuration options (S-Z)

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

SettingDescriptionServer group configuration Maps to
Save-Login

Flag indicating whether users must log in to client tools. This option enables users to save a previous login of their choice.

Valid values:

  • 0 — (Default) Login is controlled by user.
  • 1 — Do not force a login controlled by the administrator.
  • 2 — Force a login controlled by the administrator.

This option does not apply to the mid tier.

No AR System Configuration Generic UI form.
SCC-Comment-Checkin

Flag indicating whether a source code control integration requires you to enter a comment at checkin. Valid values:

  • 0 — (Default) No comment is required.
  • 1 — A comment is required.
NoAR System Configuration Generic UI form.  
SCC-Comment-Checkout

Flag indicating whether a source code control integration requires you to enter a comment at checkout. Valid values:

  • 0 — (Default) No comment is required.
  • 1 — A comment is required.
NoAR System Configuration Generic UI form.  
SCC-Enabled

Flag indicating whether a source code control system is being used with BMC Remedy AR System.

Valid values:

  • 0 — (Default) Source code control system is disabled.
  • 1 — Source code control system is in use.
 NoAR System Configuration Generic UI form.  
SCC-Integration-Mode

Flag indicating the level of source code control integration.

Valid values:

  • 0 — (Default) Advisory level.
  • 1 — Enforced level.
 NoAR System Configuration Generic UI form.  
SCC-Provider-NameName of the source code control provider. For example: Visual Source Safe. NoAR System Configuration Generic UI form.  
SCC-Target-DirCharacter string for the source code control system target directory. If none is present, this value is NULL. This string is limited to 255 characters. NoAR System Configuration Generic UI form.  
Select-Query-Hint 2Text to use in a query hint in the WITH clause of a SELECT statement when queries are supplied to Microsoft SQL Server databases. This option works only for queries triggered by GLE, GLEWF, and GME API calls. If this option is an empty string or is not present, no WITH clause is generated. To determine the appropriateness of using this feature in your environment, consult your SQL Server documentation. This option is commonly used with a NOLOCK setting for allowing queries to execute without being blocked by simultaneous updates, thereby improving performance. For example, to allow SQL Server to read data being updated and avoid blocking, use this syntax:Select-Query-Hint: NOLOCK NoAR System Configuration Generic UI form.  
(Starting from version 9.1.04) Send-JMS-User-Property-Change

Configuration to decide if a user property change should be replicated to other servers via JMS or only rely on ehcache RMI replication. Enable this configuration by setting the value to “T” in shared component in CCS in case you are seeing issues in user properties replication across servers in a server group. Acceptable value is “T” or “F”.

Default value: “F”.

Yes

ServerConnectAttempts

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

Number of attempts, the BMC Remedy Flashboards server tries to connect to the BMC Remedy AR System server. Flashboard waits for the BMC Remedy AR System server to start up and tries to connect. If the connection fails, the flashboard keeps on retrying for the connection, based on number of attempts value. 

Default value: 10

 AR System Administration Console > System > General > Flashboard Server Configuration > Server Reconnect Attempts. (See AR System Administration - Flashboard Server Configuration.)

Server-Connect-Name 2

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

New name for a server in a server group. By default, a server in a server group uses a fully qualified server name with domain to identify itself. Others servers in the group use this name to communicate. To change the server name, add this option to the configuration file:

Server-Connect-Name: <myServerName>

If a common server alias is specified, this option is required.

This name must be resolvable by DNS and is used exactly as specified. See Configuring server groups.

 NoAR System Configuration Generic UI form.

Server-directory 1

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

Full path name of the AR System data directory. This directory contains support and log files for the AR System server. NoAR System Configuration Generic UI form.  
Server-Group-Email-Admin-Port 2

Port number (RMIPort ) for email administration in Email Engine. If RMIPort is different from the default (1100 ), set this option to the new, port number to enable the server to communicate email administration information to Email Engine during server group processing. For example, in a single Email Engine configuration, use this syntax:

Server-Group-Email-Admin-Port: 2020

If multiple Email Engines are configured for the server, each engine must have a unique RMIPort. For a multiple Email Engine configuration, use semicolons to separate the RMIPort numbers. For example:

Server-Group-Email-Admin-Port: 2020;2030;2040
 NoAR System Configuration Generic UI form.  

Server-Group-Flashboards-Admin-Port 2

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

Port number (RMIRegistryPort ) for Flashboards administration in the Flashboards server. If the default Flashboards port number is changed, set this option to the new port number to enable the server to communicate Flashboards administration information to the Flashboards server during server group processing. For example:

Server-Group-Flashboards-Admin-Port: 2021
 NoAR System Configuration Generic UI form.  
Server-Group-Log-FileName and location of the server group trace log file. The default name is arsrvgrp.log. For example: Server-Group-Log-File: c:\temp\servgroup.log NoAR System Configuration Generic UI form.  

Server-Group-Member

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

Flag indicating whether the server is a member of a server group.

Valid values: T and F (default).

 NoSystem > General > Server Information > Configuration > Server Group Member. (See Setting administrative options.)

Server-Name

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

An alias that is always interpreted as the current server. This option is used in multiple server installations to differentiate servers. If you specify a value for this option, enter the value after the -h option when you use the arreload command-line utility. Otherwise, arreload uses the default server name rather than the name specified by this option. Do not specify a fully qualified name for this option. For example, use alpha instead of alpha.remedy.com.

Note: If this server belongs to a server group and you use a common server alias, you must also specify the Server-Connect-Name option. See Server-Connect-Name.

 NoAR System Configuration Generic UI form.  

Server-Plugin-Alias 2

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

Alias of a plug-in server. When the BMC Remedy AR System server calls a plug-in server, it must determine whether the plug-in server name is an alias. Aliases can direct the BMC Remedy AR System server to access a plug-in server running on a different host or listening at a specified port number. The syntax is

Server-Plugin-Alias:  <aliasName> <realName> <hostName>[:<portNumber>]

Workflow (that is, references to AR Filter API and ARDBC plug-ins) references a plug-in name. This name can be an alias. This enables you to run a plug-in on a remote host or to run more than one instance of a plug-in on a host. For example, to run the RMDY.ARDBC.XML plug-in on the remote host foo at port number 12345, add the following entry to the AR System server configuration file: Server-Plugin-Alias: RMDY.ARDBC.XML RMDY.ARDBC.XML foo:12345 The alias and real plug-in names can be identical if you run the plug-in on a remote host. To run more than one instance of the plug-in on the same or different hosts, create different aliases that reference the same plug-in on its respective hosts.

 NoAR System Configuration Generic UI form.  
Server-Plugin-Default-Timeout

Number of seconds in which the plug-in server must respond to a call before an error is returned. The minimum value is 0. The maximum is 600.

Default: 60

 NoAR System Configuration Generic UI form.  
Server-Plugin-Target-PasswordEncrypted password used to call a plug-in server. The BMC Remedy AR System server uses this password whenever it communicates with a plug-in server running on the specified host and port. The syntax is {{Server-Plugin-Target-Password: <hostName>:<portNumber>: <encryptedPassword> NoAR System Configuration Generic UI form.  
Server-Side-Table-Chunk-Size

For server-side table fields, the number of requests (or size of the chunk) that the server retrieves at one time from the database and stores in memory to process during filter or filter guide actions. The server then retrieves, stores, and processes the next chunk until all requests are processed. The value 0 causes the server to retrieve an unlimited number of requests. The default is 1000 requests. Specifying a lower value causes the server to process smaller chunks, which reduces server memory use but results in slower processing because the server must access the database many times, especially for large tables. Specifying a higher value causes the server to retrieve and process large chunks of data and access the database fewer times. This results in improved performance at the cost of increased memory use.

 No System > General > Server Information > Configuration > Server Table Field Chunk Size.(See Setting administrative options.)
Server-Stats-Rec-Interval

Interval (in seconds) at which the server records server statistics.

Default: 60 seconds

 NoAR System Configuration Generic UI form.  
Server-Stats-Rec-Mode

Server statistics recording mode. This option determines what information is recorded in the server statistics form.

Valid values:

  • 0 — (Default) Recording is off.
  • 1 — The server records only cumulative queue statistics (the sum of all the individual queue statistics).
  • 2 — The server records both cumulative and individual queue statistics. One entry is written for the cumulative statistics and a separate entry is written for each queue.

To see the statistics, open the Server Statistics form.

 NoAR System Configuration Generic UI form.  
Set-Process-Timeout

Number of seconds the BMC Remedy AR System server waits before ending a Set Fields process that did not finish. Values are 1 through 60.

Default value: 5

 NoAR System Configuration Generic UI form.  
SQL-Log-FileFull path name of the file to use if SQL logging is on (see Debug-mode). NoAR System Configuration Generic UI form.  
SQL-Secure-Connection

(Microsoft SQL Server only) Flag indicating the type of authentication to use to connect BMC Remedy AR System to a Microsoft SQL Server database.

Valid values:

  • T — Windows Authentication
  • F — SQL Authentication
 NoAR System Configuration Generic UI form.  

SQL-Server-Always-On

To enable the multi-subnet failover parameter for Microsoft SQL server database failover

  • T- Set the multi-subnet failover parameter.
  • F- Disabled (Default)
No

AR System Configuration Generic UI form.

SQL-Server-Set-ANSI-Defaults 2Option that causes the server to issue a SET ANSI_NULLS ON command. NoAR System Configuration Generic UI form.  
Submitter-Mode

Flag indicating whether the Submitter field can be changed and whether the submitter of a request must have a write license to modify it.

Valid values:

  • 1 — Locked mode. The Submitter field cannot be changed after a request is submitted. If the Submitter group has change permission, the request can be modified by submitters with a read or write license but not by users with a restricted read license.
  • 2 — (Default) Changeable mode. The Submitter field can be changed after a request is submitted. If the Submitter group has change permission, the submitter must have a write license to modify the request.
 NoAR System Configuration Generic UI form.
Suppress-Logoff-Signals

Flag indicates whether other servers in the server group are notified when a user logs off from a server in a server group. Accordingly, the license is released back to the license pool.

  • T
  • F (Recommended)
 AR System Configuration Generic UI form.
Suppress-warnings 2A series of zero or more message numbers (separated by spaces) that identify informational or warning messages that the system should suppress. Only server warnings and notes can be suppressed. NoAR System Configuration Generic UI form.  
System-Logging-Options 2

Bitmask that sets logging options for the operating system.

Valid values:

  • 0 — (Default) Use normal operating system logging.
  • Bit 1 (value = 1 ) — Suppress logging to the operating system log file.
 NoAR System Configuration Generic UI form.  
System-Messages-Displayed

Flag to specify whether system messages appear in the prompt bar or a pop-up box.

Valid values:

  • 0 — (Default) Notes and warnings appear in the prompt bar, but errors will appear in a pop-up box.
  • 1 — All system messages willl appear in the prompt bar.
  • 2 — No messages will appear in a prompt bar. All messages will appear in a pop-up box.

Alternatively, you can specify how system messages appear by changing the value in the Use Prompt Bar For field on the Configuration tab of the Server Information form.

 NoAR System Configuration Generic UI form.  

TCD-Specific-Port

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

TCP port for the arserver process. If this option is not set, the dispatcher is randomly assigned to an available port. (TCD stands for transaction control daemon.)

 NoSystem > General > Server Information > Ports and Queues > Server TCP/IP Port. (See Setting ports and RPC numbers.)
Thread-Log-FileFull path name of the file to use if thread logging is on (see Debug-mode). NoAR System Configuration Generic UI form.  
Track-Admin-Op-Progress 2

Flag indicating whether the BMC Remedy AR System server populates progress information (if any) during long-running administrative operations, such as definition imports.

Valid values:

  • T — Track progress.
  • F — (Default) Do not track progress.

To retrieve the progress information, clients can use the GetServerInfo function with the AR_SERVER_INFO_ADMIN_OP_PROGRESS request tag.

 NoAR System Configuration Generic UI form.  
Two-Digit-Year-Cutoff 2

Integer that specifies the cutoff year for interpreting a two-digit year as a four-digit year. For example, if the two-digit cutoff year is 2040:

  • Two-digit years fall between 1941 and 2040.
  • 1/1/55 is interpreted as 1/1/1955.
  • 1/1/30 is interpreted as 1/1/2030.

If a two-digit year cutoff is not specified, a rolling two-digit year is used: Two-digit years are the years between the current year plus 29 years and the current year minus 70 years. For example, if the current year is 2002, two-digit years are the years between 1922 and 2031.

 NoAR System Configuration Generic UI form.  
Use-FTS-In-Workflow

Controls whether the server will use full text searches when executing queries during workflow that have full text indexed fields in the qualification. If this option is not used, the server will use the search capability of the database. The options are T (use FTS in workflow) and F (do not use FTS in workflow).

 No

System > General > Server Information > FTS > Use FTS in Workflow.

(See FTS tab configuration options.)

Use-Password-File

Validation mechanism for unregistered AR System users. To set this value, use the Authenticate Unregistered Users check box in the EA tab of the AR System Administration: Server Information form. Windows Indicates whether the Windows domain service is used to validate users not registered with BMC Remedy AR System.

Valid values:

  • T — Use domain service. Users in the Windows domain are considered valid users of BMC Remedy AR System and are assigned to the Public group.
  • F — (Default) Do not use domain service.

UNIX and Linux Indicates whether the /etc/passwd file is used to validate users not registered with BMC Remedy AR System.

Valid values:

  • T — (Default) Use password file. Users in /etc/passwd are considered valid users of BMC Remedy AR System and are assigned to a group identified by the UNIX group ID.
  • F — Do not use password file.
 NoAR System Configuration Generic UI form.  
Use-Server-Connect-Name-In-Stats 2

Flag indicating whether the server name specified by the Server-Connect-Name option is used as the value for the Server Name field when Server Statistics form entries are created.

Valid values:

  • T — Use the Server-Connect-Name. This provides server-specific statistics when the server runs in a server group because the server enters a unique server name into the Server Statistics form.

If the Server-Connect-Name is not configured, the default behavior occurs.

  • F — (Default) Use the host name (or server alias if configured) with the domain name appended.

When a common server alias is specified for all servers in a server group, the same server name is used for the servers, effectively combining the statistics for all servers in the group.

 NoAR System Configuration Generic UI form.  

Use-SHA256

Note: Modify the following settings if you are using AR System Server 9.1.03 or earlier..

Flag indicating whether to use SHA-256 algorithm to encrypt user passwords.
Note: You cannot disable encryption once you enable it.

Valid value:

  • T — This is the only value you can set for this flag. When enabled, all user passwords you specify are encrypted to SHA-256.
  • F — This setting is not available for this flag.
 No

AR System Configuration Generic UI form. 

 
User-Log-FileFull path name of the file to use if user logging is on (see Debug-mode). NoAR System Configuration Generic UI form.  
VersionControl-Object-Modification-Log-Mode

Option indicating whether the object modification log is enabled or disabled. When the log is enabled, it records every change to AR System objects in your system (see Version control in BMC Remedy AR System).

Valid values:

  • 0 — (Default) Disabled
  • 10 — Enabled

You can also set this option by using the Object Modification Log field on the Version Control tab in the AR System Administration: Server Information form. See Setting version control options.

 NoAR System Configuration Generic UI form.  
VersionControl-Object-Modification-Log-Save-Definition-Files

Option indicating whether the AR System server writes a definition file each time an object is created or changed (see Version control in BMC Remedy AR System). This option is effective only when the object modification log is enabled.

Valid values:

  • 0 — (Default) No, a definition file is not created.
  • 10 — Yes, a definition file is created.

You can also set this option by using the Save Definition Files field on the Version Control tab in the AR System Administration: Server Information form. See Setting version control options.

 NoAR System Configuration Generic UI form.  
VersionControl-Object-Reservation-Mode

Option indicating whether object reservation is enforced or disabled. When object reservation is enforced, users can reserve server objects, and BMC Remedy AR System prevents other users from modifying the reserved objects (see Version control in BMC Remedy AR System).

Valid values:

  • 0 — (Default) Disabled
  • 10 — Enforced

You can also set this option by using the Object Reservation field on the Version Control tab in the AR System Administration: Server Information form. See Setting version control options.

 NoAR System Configuration Generic UI form.  

1. Options you can view (but not set) using the AR System Administration: Server Information form.
2. Options you cannot set or view using the AR System Administration: Server Information form.

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

Comments