Application-Level Options

orchestration Section

This section describes orchestration section options.

backup-synch-max-age

Option section: orchestration

Configuration object: ORS Application object

Default value: 600

Valid values: Any integer greater than 10

Value changes: Immediately upon notification

This option specifies the maximum age (in seconds) of the data in the synchronization buffer of the primary ORS. This synchronization data is sent to the backup ORS to ensure data between the two HA servers is synchronized.

Note: Genesys recommends that you use the default values for this option.

backup-synch-max-buffer

Option section: orchestration

Configuration object: ORS Application object

Default value: 100

Valid values: Any integer greater than 100

Value changes: Immediately upon notification

This option specifies the maximum size (in KB) of the synchronization buffer in the primary ORS. This buffer is used to hold synchronization data before it is sent to the backup ORS to ensure data between the two HA servers is synchronized.

Note: Genesys recommends that you use the default values for this option.

call-watching-timeout

Option section: orchestration

Configuration object: ORS Application object

Default value: 5000

Valid values: 1000 - 300000

Value changes: During startup. Changes to this option are not applied dynamically.

This option specifies the maximum amount of time in milliseconds that a reserved ORS node waits for the assigned node to start call processing. If the assigned node fails to create a session during this timeout, the reserved node attempts to create a session.

For example: call-watching-timeout=5000

cookie

Option section: orchestration

Configuration object: ORS Application object

Default value: An empty string

Valid values: Any valid cookie (see RFC 6265, section 4.1.1)

Value changes: Immediately upon notification

This option, introduced in 8.1.400.44, defines the value of the Set-Cookie header in web responses. If empty, the ORS will use its own value in the format ORSSESSIONID=sessionId.nodeId.

def-stat-object-type

Object: ORS Application

Option section: orchestration

Default value: agent.

Valid values:

Option Value	Description
agent	Agent
agent_place	Agent Place
agent_group	Group of Agents
place_group	Group of Places
queue	Queue
route_point	Routing Point

Value changes: Take effect immediately

This option, introduced in Release 8.1.400.17, can be used for Direct Statistic Subscription. This value will be used by default in case an object type is skipped in the object description in the strategy.

def-statserver-name

Object: Name of an object specified below in Configuration Layer as described below.

Location in Configuration Layer by precedence: Routing Point, T-Server, Tenant, ORS Application

Valid value: The name of any available Stat Server

Default value: The first available Stat Server that has the “current” Tenant in its Tenants list

Value changes: In 8.1.400.17, value changes take effect immediately except at Tenant level, when value changes take effect upon restart. In 8.1.400.18, value changes at all levels (including Tenant) take effect immediately.

ORS will look up the def-statserver-name option in following order:

Routing Point, current for interaction/session (section orchestration)
T-Server (section orchestration)
Tenant (section orchestration)
ORS (section orchestration)

This option, introduced in Release 8.1.400.17, can be used for Direct Statistic Subscription.

external-url

Option section: orchestration

Configuration object: ORS Application object

Default value: None

Valid values: Any valid URL

Value changes: For the next interaction

Use to redirect HTTP requests in scenarios when an HTTP request about a specific session is delivered to an ORS node that is not handling the session. This URL will be populated into the Location header of a 307 Temporary Redirect response as a redirect target.

Configure this option on the Primary ORS Application object. Set its value to the URL of Load Balancer located in front of the ORS node. Another ORS node will use this option and populate its value into the Location header of a 307 Temporary Redirect response as a redirect target. It allows delivery of the HTTP request to the session owner.

filter-eval-expr

Option section: orchestration
Configuration object: ORS Application object
Default value: false
Valid values: true or false
Value changes: Immediately upon notification

ORS 8.1.400.31 introduced option, filter-eval-expr, which works with METRIC:eval_expr and Debug Logging Segmentation (see option log-trace-segments). This option enables hiding of sensitive data in expression and result fields of the eval_expr log metric. If set to true, ORS verifies that string data against the regular expression defined in the ors-regex-<name> option.

functions-by-urs

Option section: orchestration

Configuration object: ORS Application object

Default value: true

Valid values: true or false

Value changes: Immediately (starting with ORS Release 8.1.300.39)

This option was introduced in ORS Release 8.1.300.36.

Orchestration Server allows you to retrieve information directly from the Configuration Layer without sending requests to Universal Routing Server when using the following _genesys.session functions: isSpecialDay, timeInZone, dateInZone, dayInZone, listLookupValue, and getListItemValue.

To enable this functionality, use the option functions-by-urs.

If set to true, Orchestration Server sends requests to Universal Routing Server.

If set to false, Orchestration Server retrieves information directly from Configuration Layer.

Note: The get-list-item-by-urs option, which covers only one function, is obsolete and should not be used. It is replaced by the functions-by-urs option, which covers six functions.

getlistitem-binary-conversion

This option, introduced in Release 8.1.400.15, defines how Transaction List item attributes stored in binary format will be treated by function _genesys.session.getListItemValue(list, item) when item is returned as an OBJECT of key/value pairs.

Option section: orchestration

Default value: ignore

Valid values: ignore, string, array

Value changes: Immediately upon notification.

When set to ignore, no value is returned (as if it does not exist in the List).

When set to string, the value is converted to string. If there are bytes with a zero value, then the string will contain bytes only until the first zero byte.

When set to array, each byte is converted to element of array. Previously, binary attributes were converted to array.

Also, if Transaction List item attributes are stored in non-string format and the _genesys.session.getListItemValue(list, item, key) function retrieves the value of a particular key , it is returned as string. Previously, in this scenario, the _genesys.session.getListItemValue() function ignored non-string attributes.

get-list-item-by-urs

This option, which covers only one function, is obsolete and should not be used. It is replaced by the functions-by-urs option, which covers six functions.

heartbeat-backup-status

Option section: orchestration

Configuration object: ORS Application object

Default value: 503

Valid values: Valid HTTP response codes

Value changes: Immediately.

This option, introduced in ORS Release 8.1.300.32, allows you to define a valid HTTP response code sent by an ORS instance running in Backup mode to the requestor, after receiving a heartbeat query.

This option can be used to provide HTTP health monitoring support to determine whether the ORS instance is operating in Primary or Backup mode.

When an ORS instance running in Primary mode receives a specific GET request for /heartbeat URI in the format http://<ORS_host>:<ORS_HTTP_port>/heartbeat, it responds with 200 OK.

If an ORS instance is running in Backup mode, it responds with 503 Service Unavailable or with the HTTP response code defined in the new configuration option heartbeat-backup-status.

Genesys recommends configuring health monitoring in deployments with Load Balancing.

http-pending-max-time

Option section: orchestration

Configuration object: ORS Application object

Default value: 600

Valid values: Any non-negative integer between 1 and 600

Value changes: Takes effect after restart.

Orchestration Server supports pipelining of HTTP requests according to RFC 2616, Section 8.1.2.2. As a result, when ORS receives several HTTP messages over the same connections, the responses are in the same order. This option and http-orphan-section-action implement this functionality.

This option, introduced in Release 8.1.300.43, defines the maximum time, in seconds, that Orchestration Server will process an HTTP request before sending a timeout response (HTTP message with status code 408) to the client.

http-orphan-session-action

Option section: orchestration

Configuration object: ORS Application object

Default value: none

Valid values: none, terminate, <valid scxml event name>

Value changes: Immediately upon notification.

This option, introduced in ORS Release 8.1.300.43, defines the Orchestration Server action if a response to an HTTP request to create an SCXML session cannot be sent to the client or when a timeout message is already sent. Valid values:

none: No action will be taken.
terminate: The SCXML session will be terminated.
<valid scxml event name>: The event will be sent to the SCXML session.

See http-pending-max-time option for additional information on this option.

ixnfm-idle-session-ttl

Option section: orchestration (in Application) or Application (in Enhanced Routing Script)

Configuration Object: Enhanced Routing Script, ORS Application

Default value: 0

Valid values: Any non-negative integer between 0 and 3600

Value changes: Immediately upon notification.

Defines the maximum time that an SCXML session may exist only if interactions have been successfully redirected and there are no other interactions subsequently attached to that session. If configured in Enhanced Routing Script, the value will override value from the ORS Application for sessions created from that Script. Value 0 disables this feature.

Use to eliminate the possibility of the scenario where an SCXML session session gets "stuck" in memory caused by an unsuccessful detach action execution and/or incorrect strategy design. This scenario can prevent the creation of new sessions if the number of sessions reaches the limit of concurrent active sessions per ORS Application.

log-trace-segments

Option section: orchestration

Default value: all

Valid values: Any combination of comma-separated segment names, case sensitive:

ORSInternal, ORSInit, ORSSynch, Cluster, ItxLink, ItxManager, CallMonitor, ORSURS, Persistence, Schedule, SessionManager, ThreadSync, ScxmlCommon, ScxmlLog, ScxmlMetric, ScxmlQOS, ORSScxml, ScxmlConfig, ScxmlIxnAction, ScxmlOrsAction, DFM, ScxmlEvent, FMClassification, FMDialog, FMInteraction, FMQueue, FMResource, FMSession, FMStat, FMWeb, ScxmlProperty, ScxmlIO, SelfMonitoring
Valid changes: Take effect immediately

Debug Logging Segmentation

Starting with Release 8.1.300.52, ORS supports Debug Logging Segmentation, which provides more precise control of the logging when the log-trace-segments option is configured. The debug segment header {<segment_name>:<log_level>} is now added right after the timestamp. For example: 10:31:02.249 {ScxmlMetric:3} METRIC <event_queued sid='MLO6K6519D5UPAGSHNE41VJBSS00000M' name='interaction.added' type='external' thread='15800' />

Use this option to specify the debug messages that will be printed into the log files. When set to all or All (the default), all debug messages are printed with the log level defined by the log/x-server-trace-level option. To control the log levels for each segment, use syntax: <segment_name>:<log_level>. If <log_level> is not specified or invalid, ORS applies the default value (defined in x-server-trace-level). If an unknown segment is specified, ORS ignores it without generating an error.

Example:

Setting	Description
all, ORSInternal:0, ORSURS:0	Everything is enabled except `ORSInternal` and `ORSURS`
ScxmlIO,ThreadSync	Only `ScxmlIO` and `ThreadSync` are enabled
all,ORSURS	Everything is enabled (the same as `all`)
ORSURS:0	Everything is disabled (the same as empty)
CallMonitor,all:0	Everything is disabled (the same as empty)
all,ORSURS:1	Everything is enabled with the default trace level, but the trace level for the `ORSURS` segment will be changed to 1
(empty)	Everything is disabled (the same as `all:0`, or `x-server-trace-level=0`)
all:3	The same as `all` with `x-server-trace-level=3`

Debug Log Segment Header Updates

Starting with ORS 8.1.400.31, a new Debug Log Segment header ScxmlMetricEvalExpr is added for METRIC:eval_expr. In a log file, it will appear as follows:

14:47:11.414 [T:8436] {ScxmlMetricEvalExpr:3} METRIC <eval_expr sid='ors2521' expression='global._data = 
new Object();' result='[object Object]' thread='8436' />

As a result, the log-trace-segments option adds ScxmlMetricEvalExpr as a new value. Also see filter-eval-expr.

Starting with ORS 8.1.400.40, in support of the Elasticsearch Connector feature, a new Debug Log Segment header, ElasticConnector is added. Log file example:

14:30:10.259 {ElasticConnector:1} Response from ElasticSearch host:port:

max-session-create-time

Option section: orchestration

Configuration object: ORS Application object

Default value: 3600

Valid values: Any integer between 5 and 3600

Value changes: Immediately

This option, introduced in ORS Release 8.1.300.45, defines the maximum session creation time in seconds. If session creation will take longer, ORS will enter an overload mode and stop creating sessions until all pending session creation requests are completed.

map-composer-log-levels

Option section: orchestration

Configuration object: ORS Application object

Default value: false

Valid values: true or false

Value changes: Immediately

This option, introduced in ORS Release 8.1.300.29, allows mapping of log levels defined in the <log> action element into the specific Genesys log events. If enabled (set to true), Orchestration Server will generate log events of the Alarm, Standard, Interaction, Trace or Debug levels. The log levels defined in the level attribute of the <log> element are mapped as follows:

Info (log level 1) is mapped into the Trace log event 23023
Error (log level 2) is mapped into the Standard log event 23011
Warning (log level 3) is mapped into the Interaction log event 23022
Debug (log level 4) is mapped into the Debug log event 23026
Alarm (log level 5) is mapped into the Alarm log event 23012

Setting the scxml-log-filter-level option value to 1, 2, 3, 4 or 5 will override the logging results of the map-composer-log-levels option

mcr-pull-after-error-timeout

Option section: orchestration

Default value: 120 (seconds)

Valid values: Any non-negative integer from 60 to 3600

Value changes: Immediately upon notification.

This option is associated with pulling from multiple Interaction Servers. It can work with switch-multi-links-enabled. Option switch-multi-links-enabled is mandatory when pulling from multiple Interaction Servers; mcr-pull-after-error-timeout is optional. The mcr-pull-after-error-timeout option specifies the time interval, in seconds, when the RequestPull for the same strategy or view/queue will be re-sent to the same Interaction Server, if the previous request triggered a response with one of the specific errors listed below.

Interaction Server Error Messages

If Interaction Server receives RequestPull and some object (such as a strategy\submitter\view\queue) that is necessary to process RequestPull is not visible/accessible for this Interaction Server, it will respond with specific error(s). Depending on object, Interaction Server will respond with one of the following errors:

__we_error_unknown_view_in_request (42)
__we_error_view_definition_invalid (83)
__we_error_strategy_does_not_exist (107)
__we_error_stategy_has_no_views (108)
__we_error_stategy_is_disabled (109)

If ORS receives such an error from an Interaction Server, it waits for the specified mcr-pull-after-error-timeout timeout before repeating the RequestPull. ORS then sends all subsequent interaction-related requests to the same Interaction Server that this interaction was pulled from. Consult the eServices documentation for configuration information in these cases.

mcr-pull-by-this-node

Option section: orchestration

Configuration object: ORS Application object

Default value: false

Valid values: true or false

Value changes: in setting the next timer interval

This option specifies that the pulling of eServices interactions will be allowed to be performed by this node If set to true.

Note that by default this option is set to false, so if the default is left on all nodes, no pulling will occur.

Note that it is allowed to have more than one node to pull interactions.

For example: orchestration/ mcr-pull-by-this-node = true

mcr-pull-cycle-quota

Option section: orchestration

Configuration object: ORS Application object

Default value: 100

Valid values: Any non-negative integer less than 50000

Value changes: Immediately upon notification

This option, introduced in 8.1.400.11, allows you to define how many multimedia interactions ORS will request to be pulled from queues in a given pulling cycle during enhanced pulling. This number is divided equally and rounded up to the nearest integer among the routing strategies that have no outstanding pull request. If there is an outstanding pull request for a strategy, then no pull request will be sent and this strategy will not be used in the calculation of the per-strategy quota for this particular pulling cycle.

mcr-pull-interval

Option section: orchestration

Configuration object: ORS Application object

Default value: 1000

Valid values: Any positive integer.

Value changes: in setting the next timer interval

This option provides the number of milliseconds between attempts to pull interactions from the queues/views managed by the ORS.

For example: orchestration/mcr-pull-interval = 5000

mcr-pull-limit

Option section: orchestration

Configuration object: ORS Application object

Default value: 5000

Valid values: Any positive integer from 0 to 50000

Value changes: in setting the next timer interval

This option provides the maximum number of pulled interactions that each node in a cluster (or ORS working in standalone mode) is allowed to have at any given time. A value of 0 disables the pulling of multimedia interactions completely for this instance of ORS. This option is not applicable to the enhanced pulling of multimedia interactions feature. The eServices options control the number of pulled interactions for enhanced pulling.

mcr-queue-on-fails

Option section: orchestration

Configuration object: ORS Application object

Default value: An empty string

Valid values: Name of a valid interaction queue or an empty string

Value changes: Immediately

This option specifies the interaction queue into which an interaction is placed if session creation for the multimedia interaction fails, instead of returning it to the same interaction queue. The feature is enabled if the option value is not an empty string.

new-session-on-reroute

Option section: orchestration

Configuration object: ORS Application object

Default value: false

Valid values: true or false

Value changes: Immediately

This option, introduced in ORS Release 8.1.300.39, controls Orchestration Server behavior when T-Server performs default routing.

In the scenario of T-Server performing default routing, T-Server redirects a call that is processed by some strategy on some Routing Point. The call is then diverted and queued on another Routing Point with call state 22.

The option new-session-on-reroute allows you to explicitly specify how ORS should process the call. It also enables ORS and Universal Routing Server (URS) to handle this scenario in a consistent fashion.

If new-session-on-reroute is set to true, ORS will terminate the existing live session or abort the session recovery process (whatever takes place) when it receives events related to call redirection.

Upon being diverted from the Routing Point (only) with call state 22 (only), ORS breaks the existing call/session association (if any). As a result, the call becomes free to create a new session upon arriving at the default destination DN loaded with the strategy.

If new-session-on-reroute is set to false, ORS reverts to its previous behavior where it does not break the existing call/session association when it receives events related to call redirection. As for live sessions, their execution will be continued, and they will receive the usual events indicating that the initial Routing Point party disappeared. As a result, the live session can handle the situation when the call being handled is moved to another DN by T-Server in the middle of the routing process.

It is necessary to keep the both ORS option new-session-on-reroute and Universal Routing Server option use_ivr_info synchronized (both are either true or false).

parse-start-params

Option section: orchestration

Configuration object: ORS Application object

Default value: false

Valid values: true or false

Value changes: During startup. Changes to this option are not applied dynamically.

This option specifies whether to enable or disable serialization/deserialization of session parameters. When true, parameters delivered to sessions started using invoke or session:start will retain their original type. When false, the session parameters will be converted to string.

For example: parse-start-params = true

restart-session-on-switchover

Option section: orchestration in an ORS Application;
Application in Enhanced Routing Script

Configuration Object: Enhanced Routing Script, ORS Application

Default value: false

Valid values: true, false

Value changes: Immediately, but new value will apply only to sessions created after that change.

Introduced in 8.1.400.45. See Recovery of Voice Calls Without Persistence. Set to true to have the ORS backup instance attempt to restart the processing of voice calls that have been processed by the ORS primary instance and sessions that have not been terminated at the moment of switchover.

same-node-for-cons-prim-calls

Option section: orchestration

Configuration object: ORS Application object

Default value: false

Valid values: true or false

Value changes: Changes to this option will take effect immediately, but only for consult calls created after that change.

For compatibility with ORS 8.1.3, Release 8.1.400.33 introduced the same-node-for-cons-prim-calls option. Its purpose is to control call distribution compatibility between ORS nodes when a deployment contains nodes from both 8.1.3 and 8.1.4 releases.

When set to false, ORS 8.1.4 and 8.1.3 call distribution works the same: ORS determines the ownership of consult calls in the same way as it determines the ownership of any other call. The only exceptions are ORS versions 8.1.400.30 through 8.1.400.32, where compatibility with 8.1.3 was broken. When set to true, consult calls will be handled by the same node that handled the related primary call.

session-restart-timeout

Option section: orchestration in an ORS Application;
Application in Enhanced Routing Script

Configuration Object: Enhanced Routing Script, ORS Application

Default value: 50

Valid values: Any integer value starting from 10

Value changes: Immediately.

Introduced in 8.1.400.45. See Recovery of Voice Calls Without Persistence. Specifies the timeout (msec) between cycles of session starts upon call processing recovery. The restart quota per cycle is equal to the number of engine-working threads defined with session-processing-threads option in the ORS scxml section (default = 8).

scxml-log-filter-level

Option section: orchestration

Configuration object: ORS Application object

Default value: empty (disabled)

Valid values: any valid combination of custom-defined and Genesys log levels where

Custom log level: An Integer composed of the digits 1, 2, 3, 4, or 5 and less than or equal to 9 digits in length (minimum of 1 and maximum of 555555555).

Genesys log levels: STD, INT, TRC, ALR and DEBUG. These are not case-sensitive.

Value changes: Immediately

This option was introduced in ORS Release 8.1.300.29. If this option is configured and the level parameter of the __Log function or level attribute of the <log> action element in the SCXML application matches the custom log level value, ORS generates corresponding Genesys log events of the Standard (23011), Alarm (23012), Interaction (23022), Trace (23023) or Debug (23026) levels. The value of scxml-log-filter-level option can contain:

A semi-colon list of colon-delimited pairs of custom and Genesys log levels.
A semi-colon list of custom log levels (no explicit mapping to Genesys log levels). ORS always generates a log event of the Standard (23011) level.
Any combination of both value types listed above.

Setting the scxml-log-filter-level option value to 1, 2, 3, 4 or 5 will override the logging results of the map-composer-log-levels option.
For example, if the SCXML application contains:

<log> action element:
		<log expr="'Custom Log Level 45'" level="45" />
		<log expr="'Custom Log Level 222'" level="222" /> 

or __Log()</code> function:

		__Log('Custom Log Level 45',45);
		__Log('Custom Log Level 222',222);


a.	scxml-log-filter-level = 45:TRC;222:INT

ORS will generate following events:


Trc 23023 METRIC <log sid='31RJ0AHJQP3851BFQ6QSJR0LA4000001' expr='Custom Log Level 45' label='' level='45' />
Int 23022 METRIC <log sid='31RJ0AHJQP3851BFQ6QSJR0LA4000001' expr='Custom Log Level 222' label='' level='222' />

b.	scxml-log-filter-level = 45;222

ORS will generate following events:

Std 23011 METRIC <log sid='31RJ0AHJQP3851BFQ6QSJR0LA4000001' expr='Custom Log Level 45' label='' level='45' />
Std 23011 METRIC <log sid='31RJ0AHJQP3851BFQ6QSJR0LA4000001' expr='Custom Log Level 222' label='' level='222' />

c.	scxml-log-filter-level = 45:TRC;222

ORS will generate following events:

Trc 23023 METRIC <log sid='31RJ0AHJQP3851BFQ6QSJR0LA4000001' expr='Custom Log Level 45' label='' level='45' />
Std 23011 METRIC <log sid='31RJ0AHJQP3851BFQ6QSJR0LA4000001' expr='Custom Log Level 222' label='' level='222' />

sessionfm-fetch-timeout

Option section: orchestration
Configuration object: ORS Application object
Default value: 60
Valid values: any Any integer from 0 to 86400
Value changes: Immediately
This option, introduced in ORS Release 8.1.300.32, allows you to set a custom value for the timeout attribute used in the <session:fetch> action element. The option specifies the timeout in seconds that ORS will use when the timeout attribute is omitted in the <session:fetch> action element.
When ORS is operating on Windows, due to the operating system default settings, the timeout reaches a 21-second maximum regardless of the value configured in the sessionfm-fetch-timeout option.

session-hung-timeout

This option is obsolete and no longer used.

statserver-source

Object: Transaction of Statistic type
Option section: orchestration
Default value: False
Valid values: False, True
Value changes: Upon ORS restart.
This option, introduced in Release 8.1.400.17, defines the source for the statistical data in the Statistic configuration.For more information, see Direct Statistic Subscription.

switch-multi-links-enabled

Option section: orchestration
Configuration object: ORS Application object
Default value: false
Valid values: true or false
Value changes: after restart
This option can be used as follows:

It determines whether ORS supports multi-link switch configurations (load sharing Network T-Servers or IVR Servers). When set to true, ORS enables support of multi-link switch configuration. When set to false, ORS does not enable multi-link switch support.

This option must be set to true to enable support for pulling from multiple Interaction Servers. Note: For multiple Interaction Server support, it is not necessary to set this option on the load sharing Switch object as described below.

Load Sharing Switch Object

The switch-multi-links-enabled option, specified on the load sharing switch object (Switches\"SharedSwitchObject"\Annex\gts), determines whether the switch is working in load-balancing mode; that is, it is served by multiple Network T-Servers or IVR T-Servers. Orchestration uses this option to determine whether to enable connection to more than one Network T-Server or IVR T-Server serving this switch.
switch-multi-links-enabled
Default value: 0



Value

Description


1

A network or IVR switch in load-balancing mode.


Any other integer

Not a network or IVR switch in load-balancing mode.

Changes Take Effect: After ORS restart.
This option should be used only in a configuration in which Network T-Servers or IVR T-Servers are working in load-balancing mode; that is, when there is no duplication in notification events received in Orchestration via connections to these T-Servers. Currently, load balancing mode is supported only for Network T-Servers and IVR T-Servers. This option was introduced in ORS 8.1.2+.

statserver-source

Object: Transaction of Statistic type
Option section: orchestration
Default value: False
Valid values: False, True
Value changes: Immediately upon notification.
Starting with Release 8.1.400.17, ORS can now request data directly from Stat Server instead of going through Universal Routing Server. This option defines the source for the statistical data in the Statistic configuration. or more information, see requesting data directly from Stat Server.

thread-synch-ipv

Option section: orchestration
Configuration object: ORS Application object
Default value: any
Valid values: any, 4, 6.
Value changes: During startup. Option changes take effect after restart only.
This option can improve strategy execution time by preventing delays that can occur when establishing the initial connection to session processing threads. The option specifies the protocol version for inter-thread communication in ORS. The value any indicates any version (this mode was used before introducing the option). The value 4 indicates the IPv4 protocol version. The value 6 indicates the IPv6 protocol version. Mixed modes are not allowed, such as 4, 6 or 6, 4. 
For example: thread-synch-ipv=4

webfm-event-hold-response

Option section: orchestration
Configuration object: ORS Application object
Default value: true
Valid values: true or false
Value changes: Immediately
When this option is set to true, the HTTP response depends on how the event is processed:

If a transition has been selected as a result of the event, response contains headers Status-Code: 200, Reason-Phrase: OK
If no transition has been selected, response contains headers Status-Code: 204, Reason-Phrase: No Content
If an error has occurred while processing the event, response contains headers Status-Code: 400, Reason-Phrase: Bad Request

When the option is set to false, once the event has been successfully published, ORS responds with 200 OK.

persistence Section

This section describes persistence section options.

cassandra-connect-attempt-timeout

Option section: persistence
Configuration object: ORS Application object
Default value: 2000
Valid values: Any integer greater than or equal to 1
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the maximum time, in milliseconds, allowed for a connection to the Cassandra cluster to complete. 
For example: persistence/cassandra-connect-attempt-timeout = 5000
Configuring a value for cassandra-connect-attempt-timeout above the default value could cause excessive delays in Orchestration startup if the Cassandra store is not available.

cassandra-keyspace-name

Option section: persistence
Configuration object: ORS Application object
Default value: Orchestration
Valid values: Strings of alpha-numeric characters and underscores. Must begin with a letter.
Value changes: take effect during startup. Changes to this option are not applied dynamically.
This option specifies the name of the Cassandra keyspace to use for this ORS cluster. This option would be used if you plan to run multiple distinct ORS clusters using the same Cassandra cluster. This option must be unique for an Orchestration cluster. If nodes in different Orchestration clusters inadvertently define the same keyspace, cross-contamination of persisted data will lead to unpredictable operation in a failover scenario. 
For example: persistence/cassandra-keyspace-name = ORS_Cluster_west
For the most current information on using ORS with Cassandra, see the Cassandra Installation/Configuration Guide.

cassandra-listenport

Option section: persistence
Configuration object: ORS Application object
Default value: 9160
Valid values: Any valid socket port.
Value changes: take effect during startup. Changes to this option are not applied dynamically.
This option provides the Cassandra client connection port when using the Cassandra-based persistence method. This option must be supplied with an appropriate value for correct Cassandra-based persistence operation to occur. 
For example: persistence/cassandra-listenport = 9160

cassandra-max-latency

Option section: persistence
Configuration object: ORS Application object
Default value: 400
Valid values: Any non-negative integer greater than 100 and less than 5000
Value changes: take effect during startup. Changes to this option are not applied dynamically.
Maximum request latency allowed before messages are logged warning of excessive delays in response to Cassandra requests. If subsequent requests have a latency less than this value a message is logged indicating the excessive latency condition has cleared. This option is not required, and the default is 400 msec.

cassandra-nodes

Option section: persistence
Configuration object: ORS Application object
Default value: <unknown>
Valid values: A list of host names for Cassandra nodes in the Cassandra cluster.
Value changes: take effect during startup. Changes to this option are not applied dynamically.
This option provides the Cassandra client connection port when using the Cassandra-based persistence method. This is a semi-colon separated list of host names or IP addresses. 
For example: persistence/cassandra-nodes = DWS;mpswin;test47

cassandra-read-timeout

Option section: persistence
Configuration object: ORS Application object
Default value: 500
Valid values: Any integer value from 201 to 4999
Value changes: Takes effect after restart.
This option, introduced in ORS Release 8.1.300.47, defines the maximum time, in milliseconds, that ORS will wait for a Cassandra connection to become ready to read. If this time is exceeded, ORS considers the connection to be lost.

cassandra-schema-version

Option section: persistence
Configuration object: ORS Application object
Default value: ORS8130000
Valid values: This is a required parameter, which may be left at the default value or set to a previous schema version, 
but it must agree with the Column Family name for the cassandra cluster to which ORS is connecting. This is a string and 
must be of the form ORSddddddd, where ddddddd must be numeric
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the schema version that either exists in the Cassandra cluster, or is to be loaded automatically by Orchestration upon the first successful connection to the Cassandra cluster. 
On startup and connection to Cassandra, Orchestration verifies that the requested schema agrees with the existing Cassandra schema, if the schema has been previously loaded. Or, it loads the schema automatically at the schema version defined by the default. 
If the schema disagrees or is not defined, Orchestration will continue to operate, but without persistence, and therefore, without the ability to restore sessions or scheduled events. 
For example: persistence/cassandra-schema-version = ORS8130000

cassandra-strategy-class

Option section: persistence
Configuration object: ORS Application object
Default value: SimpleStrategy
Valid values: SimpleStrategy or NetworkTopologyStrategy.
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the strategy class that Cassandra uses for the cluster. SimpleStrategy defines a single cluster, without multiple Data Centers. 
The NetworkTopologyStrategy, which is network strategy in conjunction with the Cassandra-topology properties file (located in each Cassandra instance install configuration directory), defines the Data Centers for the Cassandra cluster. Multiple Data Centers typically are geographically dispersed. 
For the most current information on Cassandra, see the Cassandra Installation/Configuration Guide.
For example: persistence/cassandra-strategy-class = SimpleStrategy

cassandra-strategy-options

Option section: persistence
Configuration object: ORS Application object
Default value: Unknown
Valid values: replication_factor:N, where N is the replication factor desired, or DC1:K;DC2:J…Where DC1, etc. are the Data Center names defined in the topology properties file, and K,J, 
etc. are the replication factors for each Data Center.
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the replication_factor to be configured for the given Orchestration keyspace. The two variations apply to SimpleStrategy or NetworkTopologyStrategy respectively. See the Cassandra Installation and Configuration Guide.
Examples:

If SimpleStrategy, cassandra-strategy-options = replication_factor:2
If NetworkTopologyStrategy, cassandra-strategy-options = DC1:2;DC2:3

cassandra-thread-count

Option section: persistence
Configuration object: ORS Application object
Default value: 8
Valid values: Any integer greater than or equal to 1
Value changes: During startup. Changes to this option are not applied dynamically.
This option sets the number of threads in the persistence worker thread pool. Recommended value: 2x the number of cores. 
For example: persistence/cassandra-thread-count = 4

cassandra-write-timeout

Option section: persistence
Configuration object: ORS Application object
Default value: 500
Valid values: Any integer value from 201 to 4999
Value changes: Takes effect after restart.
This option, introduced in ORS Release 8.1.300.47, defines the maximum time, in milliseconds, that ORS will wait for a Cassandra connection to become ready to write. If this time is exceeded, ORS considers the connection to be lost.

max-cache-count

Option section: persistence
Configuration object: ORS Application object
Default value: 100000
Valid values: Any integer greater than or equal to 10000
Value changes: During startup. Changes to this option are not applied dynamically.
Defines the number of entries allowed within the internal Orchestration persistence cache. 
For example: persistence/max-cache-count = 150000
For example: persistence/max-cache-count = 
When connection to persistent storage is disabled or persistent storage is not available, Orchestration Server removes the cached data of terminated sessions. This enables the processing of long–lived sessions, if the number of current active sessions does not exceed the number specified in the max-cache-count option.

max-cache-size

Option section: persistence
Configuration object: ORS Application object
Default value: 100,000,000
Valid values: Any integer greater than or equal to 0
Value changes: During startup. Changes to this option are not applied dynamically.
This option sets the maximum size of the amount of memory (in bytes) that the internal Orchestration persistence cache can use. 
For example: persistence/max-cache-size = 100000

password

Option section: persistence
Configuration object: ORS Application object
Default value: Empty string
Valid values: Valid ASCII string
Value changes: On restart
Starting with 8.1.400.48, ORS supports Cassandra internal authentication. This option defines the password associated with the username that will be used to login to the Cassandra cluster. This is optional and will default to an empty string. If Cassandra is configured to require password authentication to log in, then the password must be provided. See also option username. The value specified must have been set for the Cassandra cluster with the CQL client interface. See the Cassandra 2.2.5 Installation/Configuration Guide for details.

username

Option section: persistence
Configuration object: ORS Application object
Default value: Empty string
Valid values: Valid alphanumeric string
Value changes: On restart
Starting with 8.1.400.48, ORS supports Cassandra internal authentication. This option defines the username that will be used to login to the Cassandra cluster. This is optional and will default to an empty string. If Cassandra is configured to require password authentication to log in, then the user name must be provided. See also option password. The value specified must have been set for the Cassandra cluster with the CQL client interface. See the Cassandra 2.2.5 Installation/Configuration Guide for details.

scxml Section

This section describes scxml section options.

assembled-cache-reload-threshold

Option section: scxml
Configuration object: ORS Application object
Default value: 45
Valid values: Any non-negative integer
Value changes: Takes effect after restart
Options max-assembled-cache-age and assembled-cache-reload-threshold allow you to fine-tune the behavior of the Assembled Document Cache. This option determines the period of time, in seconds, after which the pre-emptive re-validation of a cached entry occurs. When the age of a cached document in the Assembled Document Cache exceeds the assembled-cache-reload-threshold, the next request re-validates the document and updates the cache.
Starting with 8.1.400.55, the assembled-cache-reload-threshold and max-assembled-cache-age options may be provisioned in the Application section of the Enhanced Routing Script objects, in which case they will override the corresponding options configured in the scxml section of the Orchestration Server Application.

debug-enabled

Option section: scxml
Configuration object: ORS Application object
Default value: false
Valid values: Boolean
Value changes: During startup. Changes to this option are not applied dynamically.
This option allows you to specify whether debugging with Genesys Composer is enabled in the system. If it is enabled, you must also specify the debug-port.

debug-port

Option section: scxml
Configuration object: ORS Application object
Default value: 7999
Valid values: any available port
Value changes: During startup. Changes to this option are not applied dynamically.
This option allows you to specify and enable or disable the port to be used by the debug client Genesys Composer to interact with the SCXML Engine during a debug session.

default-encoding

Option section: scxml
Configuration object: ORS Application object
Default value: UTF-8
Valid values: Any valid converter name supported by ICU.
Value changes: After restart
This option defines the source encoding that ORS will use to encode all input String data into Unicode before it is passed into the SCXML engine. Input String data includes:

SCXML and JavaScript String literals
variables
properties of String type
values of String type message attributes from the incoming API such as TLib and Ixn
values of String type properties of Configuration Objects retrieved from Configuration Server, and so on.

This option also defines the destination encoding that ORS will use to encode all SCXML Actions, function attributes, and parameters of String type from Unicode before those values will be used as attribute values in all ORS external APIs like TLib, Ixn, HTTP, and so on.

fips-enabled

Option section: scxml
Configuration object: ORS Application object
Default value: false
Valid values: true or false
Value changes: During startup. Changes to this option are not applied dynamically.
Enables FIPS compliance in the SCXML library.
For example: scxml/fips-enabled = false

http-client-side-port-range

Option section: scxml
Configuration object: ORS Application object
Default value: <empty string>
Valid values: A number between 1 and 65535 followed by a "-" and then another number between 1 and 65535; 
with the second number larger than the first number.
Value changes: During startup. Changes to this option are not applied dynamically.
Specifies the port range of the socket used for an HTTP client side connection. An empty value, or lack of option, indicates that the default should be used.
For example: scxml/http-client-side-port-range = 1000-2000

http-curl-ip-family

Option section: scxml
Configuration object: ORS Application object
Default value: <empty string>
Valid values: ipv4, ipv6
Value changes: During startup. Changes to this option are not applied dynamically.
Introduced in 8.1.400.49, this option allows you to explicitly define the IPv4 for connections used by the ORS SCXML engine to retrieve SCXML documents from a web server. You specify the type of IP address to be used in the SCXML library for host name resolution upon SCXML document retrieval via HTTP protocol or execution of the SCXML action of the HTTP method (GET, POST, and so on). Use this option to eliminate any possible delays that may occur upon opening a connection to a web server if the host has enabled more than one version of IP protocol for both interfaces; such as both ipv4 and ipv6.
Example: scxml/http-curl-ip-family = ipv4

Starting with 8.1.400.50, ipv6 is supported as a valid value.http-enable-continue-header

Option section: scxml
Configuration object: ORS Application object
Default value: false
Valid values: true or false
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies whether to enable or disable the 100-continue header in the HTTP 1.1 post request. 
For example: scxml/http-enable-continue-header = true

http-enable-keepalive

Option section: scxml
Configuration object: ORS Application object
Default value: false
Valid values: true or false
Value changes: Changes take effect after restart.
This option, introduced in Release 8.1.300.35, enables keepalive transmissions on TCP sockets used by Orchestration Server. If set to true, enables keepalive transmissions on TCP sockets for fetching documents from an application server. Both http-keepalive-idle and http-keepalive-intvl work when keepalive is enabled (http-enable-keepalive is set to true).

http-keepalive-idle

Option section: scxml

Configuration object: ORS Application object
Default value: 7200
Valid values: Any valid integer 
Value changes: Take effect after restart. 
This option, introduced in Release 8.1.400.39, defines the time between keepalive transmissions in idle condition for TCP sockets for fetching documents from an application server.  
Both http-keepalive-idle and http-keepalive-intvl work when keepalive is enabled (http-enable-keepalive is set to true).

http-keepalive-intvl

Option section: scxml
Configuration object: ORS Application object
Default value: 75
Valid values: Any valid integer
Value changes: Take effect after restart. 
This option, introduced in Release 8.1.400.39, defines the time interval between keepalive re-transmissions, if an acknowledgement to the previous keepalive transmission was not received. Both http-keepalive-idle and http-keepalive-intvl work when keepalive is enabled (http-enable-keepalive is set to true).

http-max-age

Option section: scxml
Configuration object: ORS Application object
Default value: 60
Valid values: Any integer greater than or equal to 0
Value changes: During startup. Changes to this option are not applied dynamically.
Defines the value of the max-age directive of the cache-control header in HTTP requests for documents that the SCXML library retrieves from the web server upon SCXML application assembly. Also, if the response from the server does not change it, the value of that option defines the time interval for how long a cached copy of a document will be used without re-validation. However, since an SCXML application usually consists of multiple documents, that option cannot be used to change the interval until the next re-validation of the entire SCXML application. For that purpose, please use options assembled-cache-reload-threshold and max-assembled-cache-age.
Note: If max-age is configured for an Enhanced Routing Script object, the value from max-age takes precedence over the http-max-age Application level option.

http-max-age-local-file

Option section: scxml
Configuration object: ORS Application object
Default value: 60000
Valid values: Any integer greater than or equal to 0
Value changes: During startup. Changes to this option are not applied dynamically.
This option sets the maximum age of the local file in milliseconds. 
For example: scxml/http-max-age-local-file = 65000

http-max-cache-entry-count

Option section: scxml
Configuration object: ORS Application object
Default value: 4000
Valid values: Any integer greater than or equal to 0
Value changes: During startup. Changes to this option are not applied dynamically.
This option sets the maximum number of entries that can be stored in the cache. 
For example: scxml/http-max-cache-entry-count = 2250
Starting with 8.1.400.48, the default value changes from 1000 to 4000.

http-max-cache-entry-size

Option section: scxml
Configuration object: ORS Application object
Default value: 5000000  
Valid values: Any integer greater than or equal to 0
Value changes: During startup. Changes to this option are not applied dynamically.
This option sets the maximum size of each cache entry in bytes. 
For example: scxml/http-max-cache-entry-size = 4000000
If caching of scxml documents has to be disabled, ORS options scxml\http-max-cache-entry-size and scxml\max-assembled-cached-doc-size have to be set to 0.  
Starting with 8.1.400.48, the default value changes from 100000 to 5000000.

http-max-cache-size

Option section: scxml
Configuration object: ORS Application object
Default value: 400000000
Valid values: Any integer greater than or equal to 0
Value changes: During startup. Changes to this option are not applied dynamically.
This option sets the maximum size of the HTTP cache in bytes. 
For example: scxml/http-max-cache-size = 12500000
Starting with 8.1.400.48, the default value changes from 10000000 to 400000000.

http-max-redirections

Option section: scxml
Configuration object: ORS Application objectt
Default value: 5
Valid values: 0 - 100
Value changes: During startup. Changes to this option are not applied dynamically.
This option sets the maximum number of times to follow the Location: header in the HTTP response. Set to 0 to disable HTTP redirection. 
For example: scxml/http-max-redirections = 10

http-max-stale

Option section: scxml
Configuration object: ORS Application object
Default value: 60
Valid values: Any integer greater than or equal to 0
Value changes: During startup. Changes to this option are not applied dynamically.
Defines time in seconds to extend the lifetime of cached files, retrieved from a web server, upon assembly of an SCXML application document.
For example, if the value of the http-max-age option is set to 60 seconds and value of the max-stale option is set to 30 seconds, then the fetched document will be cached for the timeframe of 90 seconds.

If value is set to 0, the lifetime of a cached file will not be extended.
If max-stale is configured for an Enhanced Routing Script object, the value from max-stale takes precedence over the http-max-stale Application level option.

http-no-cache-urls

Option section: scxml
Configuration object: ORS Application object
Default value:<empty string>
Valid values: Comma-delimited set of strings
Value changes: During startup. Changes to this option are not applied dynamically.
This option sets a comma-delimited list of substrings that would prevent a response from being cached, if the URL contains any of the substrings. 
For example: scxml/http-no-cache-urls=myserver.com, yourserver.com

http-proxy

Option section: scxml
Configuration object: ORS Application object
Default value: <empty string>
Valid values: Valid IP Address : Port or URL: Port
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the HTTP proxy server (if applicable). If specified, all HTTP fetches done by the ORS will be done via this proxy server. 
For example:

scxml/http-proxy = 127.0.0.1:3128
scxml/http-proxy = myproxy:3128

http-ssl-ca-info

Option section: scxml
Configuration object: ORS Application object
Default value: <empty string>
Valid values: Valid file name
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the file name holding one or more CA certificates with which to verify the peer. This is only useful when ssl-verify-peer=true. 
For example: scxml/http-ssl-ca-info = myca.cer

http-ssl-ca-path

Option section: scxml
Configuration object: ORS Application object
Default value: ""
Valid values: Valid path
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the path holding one or more CA certificates with which to verify the peer. The certificate directory must be prepared using the openssl c_rehash utility. 
For example: scxml/http-ssl-ca-path = c:\ssl\ca

http-ssl-cert

Option section: scxml
Configuration object: ORS Application object
Default value:<empty string>
Valid values: Valid file name
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the file name of the SSL certificate. 
For example: scxml/http-ssl-cert = mycert.crt
Spaces are not valid in the directory name that is specified in the file path for this option. For example C:\Program Files\ Certificates\my_cert.pem is not a valid path.

http-ssl-cert-type

Option section: scxml
Configuration object: ORS Application object
Default value: PEM
Valid values: PEM, DER
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the SSL Certificate Type:

PEM – PEM encoded certificate
DER – DER encoded certificate

For example: scxml/http-ssl-cert-type = DER

http-ssl-cipher-list

Option section: scxml
Configuration object: ORS Application object
Default value:<empty string>
Valid values: String value
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the cipher list as defined by OpenSSL. Paste the following url into your web browser to see valid cipher list formats:
http://www.openssl.org/docs/apps/ciphers.html#CIPHER_LIST_FORMAT
For example: scxml/http-ssl-cipher-list=RC4-SHA

http-ssl-key

Option section: scxml
Configuration object: ORS Application object
Default value:<empty string>
Valid values: Valid path or file name
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the path or file name of the SSL private key. For example: scxml/http-ssl-key = c:\ssl\mykey.key
Spaces are not valid in the directory name that is specified in the file path for this option. 
For example C:\Program Files\ Certificates\my_cert.pem is not a valid path.

http-ssl-key-type

Option section: scxml
Configuration object: ORS Application object
Default value: PEM
Valid values: PEM, DER
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the SSL Key Type:

PEM – PEM encoded key
DER – DER encoded key

For example: scxml/http-ssl-key-type = DER

http-ssl-random-file

Option section: scxml
Configuration object: ORS Application object
Default value:<empty string>
Valid values: Valid file name
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the file which is read from in order to see the random engine for SSL. The more random the specified file is, the more secure the SSL connection will become. 
For example: scxml/http-ssl-random-file=c:\ssl\random-seed

http-ssl-verify-host

Option section: scxml
Configuration object: ORS Application object
Default value: disable
Valid values: disable, common, match
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies how the common name from the peer certificate should be verified during the SSL handshake.

disable – the connection succeeds regardless of the names in the certificate
common – the certificate must contain a “Common Name” field, but the field’s contents are not validated
match – the certificate must indicate correct server name, or the connection will fail

For example: scxml/http-ssl-verify-host = match

http-ssl-verify-peer

Option section: scxml
Configuration object: ORS Application object
Default value: false
Valid values: true or false
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies whether the system should verify the peer’s certificate. When this is true, either http-ssl-ca-path or 
http-ssl-ca-info would be set. 
For example: scxml/http-ssl-verify-peer = true

http-ssl-version

Option section: scxml
Configuration object: ORS Application object
Default value: default
Valid values: String (default, TLSv1, SSLv2 or SSLv3)
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the SSL version to be used. By default, the system will determine the correct version to use. 
However, this option may be useful when some servers make it difficult to determine the correct SSL version. 
For example: scxml/http-ssl-version = SSLv2
Starting with ORS 8.1.400.49, additional values  are supported: TLSv1_0, TLSv1_1, and TLSv1_2.

http-verbose

Option section: scxml
Configuration object: ORS Application object
Default value: true
Valid values: true, false
Value changes: Take effect after restart.
The option, released in 8.1.400.20, allows you to configure the amount of information written to the log when ORS reuses the connection for a new HTTP request.

https-proxy

Option section: scxml
Configuration object: ORS Application object
Default value:<empty string>
Valid values: Valid IP Address: Port or URL: Port
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the HTTPS proxy server (if applicable). If specified, all HTTPS fetches done by the ORS will be done via this proxy server. 
For example: scxml/https-proxy = 127.0.0.1:3128

js-preload-files

Option section: scxml
Configuration object: ORS Application object
Default value: ors.js
Valid values: A semi-colon delimited list of JavaScript files
Value changes: During startup. Changes to this option are not applied dynamically.
This option provides a list of JavaScript files that are pre-loaded at ORS startup. If the full file path is not provided, ORS will look for 
files in the ORS working directory. This allows users to specify functions or variables that are available to all sessions.
The 8.1.400.21 release changed the default value for the js-preload-files option to ors.js. The ors.js file must always be defined to insure successful execution of SCXML applications if the ixnid parameter is not explicitly provided in the request.

max-assembled-cache-age

Option section: scxml
Configuration object: ORS Application. object
Default value: 60
Valid values: Any non-negative integer
Value changes: Takes effect after restart
Options max-assembled-cache-age and assembled-cache-reload-threshold allow you to fine-tune the behavior of the Assembled Document Cache. This option determines the expiration time, in seconds, of an entry in the Assembled Document Cache.

max-assembled-cached-docs

Option section:	scxml
Configuration object: ORS Application object
Default value: 2000
Valid values: Minimum = 0, no maximum value
Valid changes: Take effect after restart.
This option, introduced in ORS Release 8.1.300.48, determines the maximum number of documents to be stored in the assembled document cache. If this number is exceeded, the least referenced cached items will be removed from the cache to make room for new entries. 
Starting with 8.1.400.48, the default value changes from 1000 to 2000.

max-assembled-cached-doc-size

Option section:scxml
Configuration object: ORS Application object
Default value: 50000000
Valid values: Minimum = 0, no maximum value
Valid changes: Take effect after restart.
This option, introduced in ORS Release 8.1.300.48, determines the maximum allowed size (in bytes) of each individual entry in the cache. If a fully-assembled SCXML strategy exceeds this size, it cannot be stored in the cache.
If caching of scxml documents has to be disabled, ORS options scxml\http-max-cache-entry-size and scxml\max-assembled-cached-doc-size have to be set to 0.
Starting with 8.1.400.48, the default value changes from 10000000 to 50000000.

max-assembled-cache-size

Option section:	scxml
Configuration object: ORS Application object
Default value: 400000000
Valid values: Minimum = 0, no maximum value
Valid changes: Take effect after restart.
This option was introduced in ORS Release 8.1.300.48. Use max-assembled-cache-size, max-assembled-cached-docs, and max-assembled-cached-doc-size to configure the document cache by storing fully-assembled SCXML documents, eliminating the need for document fetches for xincludes in subsequent sessions. 
This option determines the maximum allowed size (in bytes) of the assembled document cache. The size of the cache is determined by the total size of all cached documents stored in the cache.
Starting with 8.1.400.48, the default value changes from 10000000 to 400000000.

max-cache-entry-count

Option section: scxml
Configuration object: ORS Application object
Default value: 1000
Valid values: Any integer greater than or equal to 0
Value changes: During startup. Changes to this option are not applied dynamically.
This option sets the maximum number of entries that can be stored in the cache. For example: scxml/http-max-cache-entry-count = 1250

max-cache-entry-size

Option section: scxml
Configuration object: ORS Application object
Default value: 100000
Valid values: Any integer greater than or equal to 0
Value changes: During startup. Changes to this option are not applied dynamically.
This option sets the maximum size of each cache entry in bytes. 
For example: scxml/http-max-cache-entry-size = 125000

max-compiler-cache-size

Option section: scxml
Configuration object: ORS Application object
Default value: 400000000
Valid values: non-negative integer
Value changes: Takes effect after restart. Changes to this option are not applied dynamically.
The maximum amount of memory (in bytes) allowed for the <xi:include> compiler cache. 
Starting with 8.1.400.48, the default value changes from 10000000 to 400000000.

max-compiler-cached-docs

Option section: scxml
Configuration object: ORS Application object
Default value: 2000
Valid values: non-negative integer
Value changes: Takes effect after restart. Changes to this option are not applied dynamically.
The maximum number of items that the <xi:include> compiler cache can have. 
Starting with 8.1.400.48, the default values changes from 1000 to 2000.

max-compiler-cached-doc-size

Option section: scxml
Configuration object: ORS Application object
Default value: 50000000
Valid values: non-negative integer
Value changes: Takes effect after restart. Changes to this option are not applied dynamically.
The maximum size, in bytes, allowed to cache the results of the compiled <xi:include> document. 
Starting with 8.1.400.48, the default value changes from 10000000 to 50000000.

max-debug-sessions

Option section: scxml
Configuration object: ORS Application object
Default value: 0
Valid values: an integer
Value changes: During startup. Changes to this option are not applied dynamically.
When debugging with Genesys Composer, this option allows you to set the maximum number of simultaneous debug sessions within the current SCXML Engine instance. 
Note that this value must be at least one digit less than the value specified in the session-processing-threads option to 
prevent session thread starvation. If it is not, it will default to 0.

max-includes

Option section: scxml
Configuration object: ORS Application object
Default value: 1000
Valid values: 0 to 10000
Value changes: During startup. Changes to this option are not applied dynamically.
This option sets the maximum number of documents that may be included using <xi:include>. 
For example: scxml/max-includes = 200
Starting with 8.1.400.48, the default value changes from 500 to 1000.

max-microstep-count

Option section: scxml
Configuration object: ORS Application object
Default value: 1000
Valid values: any integer (no maximum)
Value changes: During startup
For infinite loop protection, this option is used along with max-state-entry-count. Both options may be configured globally in ORS configuration, or may be configured per session by setting the attribute in the SCXML document:

<scxml _microStepLimit="1000" . /> 
<scxml _stateEntryLimit=100" . />

For example, max-microstep-count = 500
This option specifies the maximum number of times in which transitions may be taken during a session without the processing of a new event. Once this value has been exceeded, the session is exited gracefully before being terminated by the system. A value of 0 indicates that the session is not to be forcibly terminated.

max-pending-events

Option section: scxml
Configuration object: ORS Application object
Default value: 100
Valid values: positive integer between 30 and 100000, inclusive.
Value changes: Changes take effect During startup. Changes to this option are not applied dynamically.
This option specifies the maximum number of events allowed to be queued to a session (inclusive of internal, external, delayed and undelivered events). 
If this number is reached, ORS shall attempt to exit the session. This feature cannot be disabled. 
For example: scxml/max-pending-events = 1000

max-preprocessor-cache-size

Option section: scxml
Configuration object: ORS Application object
Default value: 400000000
Valid values: Any integer greater than or equal to 0
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the amount of memory, in bytes, that the <xi:include> pre-processor cache can use. 
For example: scxml/max-preprocessor-cache-size = 20000000
Starting with 8.1.400.48, the default value changes from 10000000 to 400000000.

max-preprocessor-cached-docs

Option section: scxml
Configuration object: ORS Application object
Default value: 2000
Valid values: Any integer greater than or equal to 0
Value changes: During startup. Changes to this option are not applied dynamically.
This option sets the maximum number of items that the <xi:include> pre-processor cache can have. 
For example: scxml/max-preprocessor-cache-docs = 2000.
Starting with 8.1.400.48, the default value changes from 1000 to 2000.

max-preprocessor-cached-doc-size

Option section: scxml
Configuration object: ORS Application object
Default value: 50000000
Valid values: non-negative integer
Value changes: Takes effect after restart. Changes to this option are not applied dynamically.
The maximum size, in bytes, of the cached results of the preprocessed <xi:include> documents. 
Starting with 8.1.400.48, the default value changes from 10000000 to 50000000.

max-script-duration

Option section: scxml (in the ORS Application object) or Application (in an Enhanced Routing Script object)
Configuration object: ORS Application object and Enhanced Routing Script object 
Default value: 2,000 milliseconds
Valid values: 500 - 10,000 milliseconds
Value changes: When configured on an ORS Application object, takes effect during startup. When configured on an Enhanced Routing Script object, takes effect for sessions that started after that update. When configured in an Enhanced Routing Script object, that option takes precedence over the option configured in the ORS Application object.
If the execution time for JavaScript within a <Script> element exceeds the configured limit, execution will be interrupted, an Alarm-level message will be printed in ORS log, and the error.script Script event will be raised for the corresponding session.
Starting with ORS 8.1.400.43, the JavaScript execution time can now be restricted by the ORS option scxml\max-script-duration, if any ORS extension functions (such as _genesys.statistic.sData) were called from the <script> action element.

max-session-age

Option section: scxml
Configuration object: ORS Application object
Default value: 604800
Valid values: A positive integer
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the maximum age in seconds that an ORS session should exist. If this age is reached, ORS shall attempt to exit the session. 
To disable this feature, set the max-session-age to 0. The SCXML Engine supports _maxtime as an attribute on the <scxml> element, and also supports the option max-session-age, which is intended to queue a terminate event for the session after the time expired. 
The value specified in the _maxtime attribute overrides the value in the 
max-session-age configuration option. 

A connection to Cassandra is required for this functionality.
Orchestration Server sets the time to live in Cassandra for information required to support proactive session recovery. The time to live for the information in Cassandra is the configured scxml/max-session-age plus 3600 seconds. After this period, the data within Cassandra will be marked as deleted.

max-state-entry-count

Option section: scxml
Configuration object: ORS Application object
Default value: 500
Valid values: any integer (no maximum)
Value changes: During startup
For example, max-state-entry-count = 250
Starting with release 8.1.400.43, the default value of this option is changed from 100 to 500. 
For infinite loop protection, this option is used along with max-microstep-count. Both options may be configured globally in ORS configuration, or may be configured per session by setting the attribute in the SCXML document:

<scxml _microStepLimit="1000" . />
<scxml _stateEntryLimit="100" . />

This option specifies the maximum number of times that a transition may be taken to a target state. Every state element within an SCXML document keeps an individual count of the number of times entered via a targeted transition. Once this value has been exceeded, the session is exited gracefully before being terminated by the system. 
A value of 0 indicates that the session is not to be forcibly terminated.

password

Option section: scxml
Configuration object: ORS Application object
Default value: <empty string>
Valid values: String value
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the SSL key password. 
For example: scxml/password = agent007

persistence-default

Option section: scxml
Configuration object: ORS Application object
Default value: false
Valid values: true or false
Value changes: Takes effect after restart. Changes to this option are not applied dynamically.
This option defines the default session persistence.  If set to true, then Orchestration will persist the session if Cassandra is available.  If set to false, Orchestration will not attempt to persist the session. 
Note: In your routing strategy, you can set the _persist attribute in the <scxml> element, which will take precedence over the value set in the persistence-default Application level option.

persistence-max-active

Option section: scxml
Configuration object: ORS Application object
Default value: 10000
Valid values: 100 - 1000000
Value changes: During startup. Changes to this option are not applied dynamically.
This option allows setup of a maximum number of active sessions that the SCXML engine will keep in memory. 
For example: scxml/persistence-max-active = 5000

process-event-timeout

Option section: scxml
Configuration object: ORS Application object
Default value: 10000
Valid values: A positive integer
Value changes: During startup. Changes to this option are not applied dynamically.
This option specifies the maximum time (in milliseconds) allotted for the processing of the event queue. 
The processing of one event may lead to additional events being queued. Processing of the event queue does not 
complete until the event queue is empty. This feature sets an upper bound to the amount of time dedicated to processing these events. 
If the timeout is reached, ORS attempts to exit the session. To disable this feature, set the process-event-timeout to 0. 
For example: scxml/process-event-timeout = 60000

session-processing-threads

Option section: scxml
Configuration object: ORS Application object
Default value: 8
Valid values: Integer from 1 to 128 (inclusive)
Value changes: During startup. Changes to this option are not applied dynamically.
This option sets the number of threads in the thread pool. The recommended value is two times the number of cores. 
For example: scxml/session-processing-threads = 16

system-id

Option section: scxml
Configuration object: ORS Application object
Default value: -1
Valid values: Any integer greater than or equal to -1
Value changes: During startup. Changes to this option are not applied dynamically.
This option allows setup of the ORS system ID in order to have unique session IDs across ORS instances. 
If -1 is specified, ORS creates a session ID based on the IP address of the host running ORS. 
For example: scxml/system-id = 11

log Section

This section describes log options specific to ORS

log-trace-segments

Option section: orchestration
Default value: all
Valid values (in any combination, case-sensitive):
OrsInternal, OrsInit, OrsSynch, Cluster, ItxLink, ItxManager, CallMonitor, OrsUrs, Persistence, Schedule, SessionManager, ThreadSync, ScxmlCommon, ScxmlSession, ScxmlMetric, ScxmlQOS, ScxmlOrs, ScxmlConfig, ScxmlIxnAction, ScxmlOrsAction, ScxmlDFM, ScxmlEvent, ScxmlClassification, ScxmlFMDialog, ScxmlFMInteraction, ScxmlFMQueue, ScxmlFMResource, ScxmlFMSession, ScxmlFMStat, ScxmlFMWeb, ScxmlProperty, ScxmlIO
Value changes: 	Immediately upon notification. 
Use this option for Debug Log Segmentation.

Debug Log Segmentation

The log-trace-segments option, using a comma separated list, specifies the types of information that are written to the Debug log files. Setting this option logs all messages that fall into the specified segment or list of segments. This option works with the x-server-trace-level option, which must be set to 1, 2 or 3.
Background: Orchestration Server produces a large number of Debug level log messages. The sheer volume of log messages can make it difficult to isolate the specific messages needed to troubleshoot different types of deployments. The ORS Debug Log Segmentation feature groups log messages by functional segments, such as common module, API, or feature group. Segment names are added at the beginning of each log message.

Use the ! character before a segment to exclude messages falling under this segment.

The all keyword lists all segments (used as regular segment).

To control the log levels more selectively for each segment, use this syntax: 

<segment_name>:<log_level>.

If no log level is specified, the default value (x-server-trace-level) is applied.The log level specified with the excluded segment (with ! prefix) will be ignored.

In the case of a syntax error, the default value will be applied.

Segment Descriptions

N  Segment name         Functionality
1. OrsInternal	        Processing of ORS internal objects and events
2. OrsInit	        ORS instance initialization
3. OrsSynch	        Synchronization between primary and backup instances
4. ScxmlQOS	        Message for SCXML engine load/session creation time upon each session start
5. Cluster	        Messages related to ORS node initialization within ORS cluster 
(cluster assignment, cluster configuration, etc.) 
6. AgentFM	        Reserved
7. ItxManager	        Low-level messages for eServices communication
8. ItxLink	        Low-level messages for eServices communication
9. CallMonitor	        Call/Interaction processing events/requests
10.AgentMonitor	        Reserved
11.OrsUrs	        Communication with URS
12.Persistence	        Operations with Cassandra persistent storage
13.Schedule	        Scheduling via persistence layer
14.SessionManager       Session management-related messages
15.ThreadSync	        Internal inter-thread communication
16.ScxmlCommon	        Common operations within SCXML engine (such as HTTP doc requests 
preparation and execution, caching, and so on)
17.ScxmlSession	        Session-related non-metric SCXML messages
18.ScxmlMetric	        SCXML METRIC messages
19.ScxmlOrs	        ORS core messages about SCXML sessions created/terminated
20.ScxmlConfig	        Configuration options used by SCXML engine
21.ScxmlIxnAction       Messages related to SCXML actions execution
22.ScxmlOrsAction       Messages related to internal processing of SCXML action data 
(validation, compilation)
23.ScxmlDFM	        Messages from Distributed Function Module
24.ScxmlEvent	        Messages about low-level SCXML event generation/processing
25.ScxmlClassification	Messages from Classification Function Module
26.ScxmlFMDialog        Messages from Dialog Function Module
27.ScxmlFMInteraction   Messages from Interaction Function Module
28.ScxmlFMQueue	        Messages from Queue Function Module
29.ScxmlFMResource	Messages from Resource Function Module
30.ScxmlFMSession	Messages from Session Function Module
31.ScxmlFMStat	        Messages from Statistics Function Module
32.ScxmlFMWeb	        Messages from Web Function Module
33.ScxmlProperty	Messages about low-level SCXML object properties processing
34.ScxmlIO	        Messages from SCXML engine internal fetching module 
(low-level HTTP doc operations)

Examples

all,!OrsInternal,!OrsUrs - All segments enabled except OrsInternal and OrsUrs.
ScxmlIO,ThreadSync - Enable ScxmlIO and ThreadSync only.
all,OrsUrs – All segments enabled (the same as all).
!OrsUrs – All segments disabled (the same as empty)
CallMonitor,!all – All segments disabled (the same as empty).
all,OrsUrs:1 – All segments enabled with default trace level, but trace level for OrsUrs segment will be changed to 1.
“” – All segments disabled (the same as !all, or x-server-trace-level=0).
all,!OrsUrs:3 – All segments enabled except OrsUrs.
all:3 – The same as all with x-server-trace-level=3.

x-server-trace-level

Option section: log
Configuration object: ORS Application object
Default value: 0
Valid values: 0 - 3
Value changes: as soon as committed to Configuration Server
This option specifies the level of tracing to be enabled for the ORS. 
For example: log/x-server-trace-level = 2
See log-trace-segments for information on segmenting log output.

x-server-gcti-trace-level

Option section: log
Configuration object: ORS Application object
Default value: 0
Valid values: 0 - 3
Value changes: as soon as committed to Configuration Server
This option specifies the level of GCTI tracing to be enabled for the ORS. It controls how much detail should be in the logs for GCTI-related events, such as those from T-Server. 
For example: log/x-server-gcti-trace-level = 2

x-server-config-trace-level

Option section: log
Configuration object: ORS Application object
Default value: 0
Valid values: 0 - 3
Value changes: as soon as committed to Configuration Server
This option specifies the level of configuration tracing to be enabled for the ORS. It controls how much detail should be in the logs for Configuration-related events, such as reading from Configuration Server and reacting to dynamic changes. 
For example: log/x-server-config-trace-level = 2

x-print-attached-data

Option section: log
Configuration object: ORS Application object
Default value: 0
Valid values: 0, 1
Value changes: as soon as committed to Configuration Server
This option specifies whether or not attached data should be formatted and printed in the logs.

0—Suppress printing attached data
1—Format and print attached data

For example: log/x-print-attached-data = 1

log-filter-data Section

Starting with ORS Release 8.1.400.30, ORS can now selectively hide sensitive data in logs when the printing of such sensitive data is not explicitly requested by an SCXML strategy. A new option supports the hiding of sensitive data in ORSURS request and Web request logging.

ors-regex-<name>[;<filter-type>]

For more information on this option, see hiding sensitive data.

mcr Section

This section describes mcr section options.

om-memory-optimization

Option section: mcr
Configuration object: ORS Application object
Default value: true
Valid values: true or false
Value changes: take effect immediately.
This option specifies whether memory optimization will be in effect for the current ORS. When the value is set to true, ORS will remove passive multi-media interactions from memory cache. 
For example: mcr/om-memory-optimization = true

om-max-in-memory

Option section: mcr
Configuration object: ORS Application object
Default value: 50
Valid values: 1 to 2000
Value changes: take effect immediately.
This option specifies a maximum number of interactions to store in memory cache before interactions will begin to be removed from the cache (oldest first), when om-memory-optimization is set to true. The value is in thousands, so that the default value of 100 represents 100,000 interactions that are to be stored in memory cache. The maximum value for this option is 2000, which represent 2,000,000 interactions. 
For example: mcr/om-max-in-memory = 100
Note: For high volume loading, Genesys recommends the default value of 100.

om-delete-from-memory

Option section: mcr
Configuration object: ORS Application object
Default value: 1
Valid values: 1 to 2000000
Value changes: take effect immediately.
This option specifies how many interactions should be deleted when the value of om-max-in-memory has been reached. 
For example: mcr/om-delete-from-memory = 1

performance-alarms Section

This section describes performance-alarms section options.

alarm-name

The name of this option is the alarm name.
Option section:	performance-alarms
Configuration object: ORS Application object
Default value: None
Valid values: Specify an alarm definition string.
Value changes: Immediately upon notification.
Starting with Release 8.1.400.21, ORS supports Performance Monitoring. You can use a set of performance-related counters and configure conditions that will trigger Management Layer alarms. This option defines the alarm name and the performance monitoring parameters. For more information, see Performance Monitoring.

alarm-check-interval

Option section:	performance-alarms
Configuration object: ORS Application object
Default value: 60
Valid values: Any non-negative integer from 1 to 600
Value changes: Immediately upon notification.
Starting with Release 8.1.400.21, ORS supports Performance Monitoring. This option is where you specify how often alarm conditions will be checked. For more information, see Performance Monitoring.

datastream-update-interval

Configuration object: Orchestration Server Application

Option section:	 performance-alarms

Default value: 	1

Valid values: 	A number between 1 and 120

Value changes: 	Immediately upon notification
Introduced in Release 8.1.400.30 to support displaying ORS Performance Data in a RTME client such as Pulse. Defines the time interval in seconds between performance counters submissions from ORS to Stat Servers.
Starting with Release 8.1.400.21, ORS supports Performance Monitoring. You can use a set of performance-related counters and configure conditions that will trigger Management Layer alarms. This option defines the time interval, in seconds, to use when checking for alarm conditions. For more information, see Performance Monitoring.

elasticsearch Section

See Elasticsearch Connector for more information.

ors-es-bulk-max-size

Option section:	elasticsearch
Configuration object: ORS Application object
Default value: 	10000
Valid values:  Integer value in range from 1000 to 10000000
Value changes: Take effect immediately upon notification.
Introduced in ORS 8.1.400.40.
The word "bulk" refers to the possibility of having ORS accumulate a configurable amount reporting data and then sending the data to Elasticsearch instead of sending one reporting request at a time. 
Used for both Elasticsearch session and performance reporting. This option specifies the maximum number of actions inside a single bulk request. If reporting is enabled, ORS stores all requests in its internal bulk requests cache. This option can be set to control cache overgrowth. If the maximum number of actions in the cache is reached, ORS removes the oldest actions and inserts the newest. 

Note: Genesys recommends clustering Elasticsearch nodes with several master nodes to prevent a potential loss of reporting data should an extended node disconnect occur (unless all available Master nodes in an Elasticsearch cluster are excluded).

ors-es-bulk-write-period

Option section:	elasticsearch
Configuration object: ORS Application object
Default value: 	5 seconds
Valid values: 	An Integer value in the range of 5 to 120 seconds. 
Value changes: Take effect immediately upon notification.
Introduced in ORS 8.1.400.40.
Used for both Elasticsearch session and performance reporting. 
This option specifies the maximum time interval between the sending of two bulk requests to Elasticsearch. The bulk mechanism is based on an internal buffer that stores all requests that should be sent to Elasticsearch. In cases where there are no buffered requests, the actual time between two bulk requests could exceed the ors-es-bulk-write-period. However, when there is a steady stream of the requests to be handled by single bulk operation, the actual time between two bulk requests will be equal to the time defined by this option.

ors-es-node-exclude-timeout

Option section:	elasticsearch
Configuration object: ORS Application object
Default value: 600 seconds
Valid values: Integer value in range from 5 to 86400 seconds. 
Valid changes: Take effect immediately upon notification.
Introduced in ORS 8.1.400.40.
After successfully connecting to an Elasticsearch node, ORS checks the node status. In case of a red status, ORS disconnects from the node and excludes the node from the reconnection procedure for the time period defined by the option ors-es-node-exclude-timeout.

ors-es-node-info-report

Option section:	elasticsearch
Configuration object: ORS Application object
Default value: 	false
Valid values: 	true, false 
Value changes: 	Take effect immediately upon notification.
Introduced in ORS 8.1.400.40.
This option specifies if node reporting via the Elasticsearch engine is enabled. If, upon ORS startup, ors-es-node-info-report has a value of false, and the value is subsequently changed to true, the report information will not be sent.

ors-es-nodes

Option section:	elasticsearch
Configuration object: ORS Application object
Default value: <empty string>
Valid values: String containing a semicolon-separated list of http(s)://host:port of ElasticSearch servers. 
Value changes: 	Take effect after restart.
Introduced in ORS 8.1.400.40.
This option is used for connectivity to Elasticsearch. It specifies the addresses of Elasticsearch nodes.  Configure each ORS to work with an Elasticsearch node. For valid values:

If the node is specified as http://<ES host>:<port>, then a non-encrypted connection will be used for communication with Elasticsearch.
If the node is specified as https://<ES host>:<port>, then an encrypted connection will be used for communication with Elasticsearch.

ors-es-perfsnapshot-report

Option section:	elasticsearch
Configuration object: ORS Application object
Default value: 	false
Valid values: 	true, false 
Value changes: 	Take effect immediately upon notification.
Introduced in ORS 8.1.400.40.
This option specifies if performance reporting is enabled via Elasticsearch.

If set to true, performance reporting via the Elasticsearch is enabled.
If set to false), performance reporting via Elasticsearch is disabled.

ors-es-reconnect-timeout

Option section:	elasticsearch
Configuration object: ORS Application object
Default value: 5 seconds
Valid value: 1 to 20 seconds. 
Valid changes: Take effect immediately upon notification.
Introduced in ORS 8.1.400.40.
This option specifies the timeout period that ORS uses when trying to reconnect to an Elasticsearch node. If a  connection to Elasticsearch is lost, then ORS will try to reconnect to the next Elasticsearch node in the ors-es-nodes list.

ors-es-session-report

Option section:	elasticsearch
Configuration object: ORS Application object
Default value: 	false
Valid values: 	true, false 
Value changes: 	Take effect immediately upon notification.
Introduced in ORS 8.1.400.40.
This option specifies if Elasticsearch session reporting is enabled or disabled. When set to true, session reporting is enabled. When set to false, session reporting is disabled.
If an ors-es-session-report value is changed from false to true in the middle of a session, ORS will send an update request for a non-existing session document. Elasticsearch will respond with a "document missing" exception, which ORS will ignore.

password

Option section:	elasticsearch
Configuration object: ORS Application object
Default value: <empty string>
Valid value:  String value
Valid changes: Take effect immediately upon notification.
Introduced in ORS 8.1.400.40.
This option specifies the password that should be used for basic authentication on the Elasticsearch server.

username

Option section:	elasticsearch
Configuration object: ORS Application object
Default value: <empty string>
Valid value:  String value
Valid changes: Take effect immediately upon notification.
Introduced in ORS 8.1.400.40.
This option specifies the username that should be used for basic authentication on the Elasticsearch server.

Value	Description
1	A network or IVR switch in load-balancing mode.
Any other integer	Not a network or IVR switch in load-balancing mode.

Contents

Application-Level Options

orchestration Section

backup-synch-max-age

backup-synch-max-buffer

call-watching-timeout

cookie

def-stat-object-type

def-statserver-name

external-url

filter-eval-expr

functions-by-urs

getlistitem-binary-conversion

get-list-item-by-urs

heartbeat-backup-status

http-pending-max-time

http-orphan-session-action

ixnfm-idle-session-ttl

log-trace-segments

Debug Logging Segmentation

max-session-create-time

map-composer-log-levels

mcr-pull-after-error-timeout

Interaction Server Error Messages

mcr-pull-by-this-node

mcr-pull-cycle-quota

mcr-pull-interval

mcr-pull-limit

mcr-queue-on-fails

new-session-on-reroute

parse-start-params

restart-session-on-switchover

same-node-for-cons-prim-calls

session-restart-timeout

scxml-log-filter-level

sessionfm-fetch-timeout

session-hung-timeout

statserver-source

switch-multi-links-enabled

Load Sharing Switch Object

statserver-source

thread-synch-ipv

webfm-event-hold-response

persistence Section

cassandra-connect-attempt-timeout

cassandra-keyspace-name

cassandra-listenport

cassandra-max-latency

cassandra-nodes

cassandra-read-timeout

cassandra-schema-version

cassandra-strategy-class

cassandra-strategy-options

cassandra-thread-count

cassandra-write-timeout

max-cache-count

max-cache-size

password

username

scxml Section

assembled-cache-reload-threshold

debug-enabled

debug-port

default-encoding

fips-enabled

http-client-side-port-range

http-curl-ip-family

http-enable-continue-header

http-enable-keepalive

http-keepalive-idle

http-keepalive-intvl

http-max-age

http-max-age-local-file

http-max-cache-entry-count

http-max-cache-entry-size

http-max-cache-size

http-max-redirections

http-max-stale

http-no-cache-urls

http-proxy