Olena/8.5.104
verbose
Section: db-direct-connection
Default Value: 0
Valid Values: 0 - 4
Changes Take Effect: After restart
This option controls the SQL statement and message sending debug information.
identity-in-login-table
Section: statserver
Default Value: off
Valid Values: on, off
Changes Take Effect: After restart
Turning this option on enables Stat Server to operate with an Oracle Real Application Clusters (RAC). This option requires a database access point connection to an Oracle RAC database. The user must also initialize their LOGIN table with the oracle/login_oracle.sql script that comes with the Stat Server installation.
enable
Section: db-direct-connection
Default Value: off
Valid Values: on, off
Changes Take Effect: After restart
This option enables direct database connection to the DBMS.
debug
Section: db-direct-connection
Default Value: 0
Valid Values: 0 - 5
Changes Take Effect: After restart
This option controls advanced debugging information such as function calls.
reconnect-timeout
Section: statserver
Default Value: 10
Valid Values: Positive integers less than or equal to 2147483; Stat Server sets any negative or 0 values that you might configure to 10.
Changes Take Effect: After restart
Modified: 8.5.104
Indicates the time interval, in seconds, between Stat Server attempts to reconnect to a T-Server or the database (DB Server if [db-direct-connection]/enable is set to no) if either is disconnected or not running.
This option was previously named reconnect_timeout (spelled with an underscore).
db-txn-max-retries
Section: statserver
Default Value: 3
Valid Values: Integers greater or equal to 1 and less than or equal to 10 retries
Changes Take Effect: After restart
This option controls how many times Stat Server re-sends a transaction to the database connection after a timeout has occurred, before it disconnects and reconnects to the database.
db-timeout
Section: statserver
Default Value: 30
Valid Values: Integers greater or equal to 10 and less than or equal to 3600 seconds
Changes Take Effect: After restart
This option controls how long Stat Server waits for a response from the database connection, before re-sending the current transaction.
accept-clients-in-backup-mode
Section: statserver
Default Value: yes
Valid Values: yes, no
Changes Take Effect: After restart
Modified: 8.5.1. New default value is yes
Specifies whether Stat Server accepts client connections when operating in backup mode.
With this option set to yes, Stat Server notifies the clients about its redundancy mode after a client's registration and after a change in mode. Moreover, when its redundancy mode is changed to backup, Stat Server does not close the communication port and accepts clients' connections and requests.
media-type
Section: statserver
Default Value: No default value
Valid Values: Any value, preconfigured within Configuration Server—in the Business Attributes/MediaType folder in Genesys Administrator
Changes Take Effect: Immediately upon notification
Modified: 8.5.102
Determine the media type of interactions that the virtual queue has been configured to handle. This option is set only for a Virtual Queue object. Only one media type should be configured for any given virtual queue. Starting with Stat Server release 8.5.102, voice is a valid value.
disconnect-from-lca-on-history-log-expired
Section: statserver
Default Value: false
Valid Values: true, false
Changes Take Effect: After restart
Introduced: 8.5.102
Controls whether Stat Server disconnects from LCA upon receiving the HistoryLogExpired event.
backup-file-aggregates-store
Section: statserver
Default Value: true
Valid Values: true, false
Changes Take Effect: Immediately upon notification
Dependencies: auto-backup-interval != 0
Introduced: 8.5.102
Controls whether the statistical aggregates are read from/written into the backup file.
interaction-wait-on-sa-media-list
Section: statserver
Default Value: "chat"
Valid Values: “Media 1, Media 2, …, Media N” or “All”
Changes Take Effect: After restart
Introduced: 8.5.103
Specifies the list of media type name(s) for which the InteractionWait (StagingAreas) action is generated.
interaction-wait-on-sa-max-number
Section: statserver
Default Value: 2147483647
Valid Values: Integers 0 through 2147483647
Changes Take Effect: After restart
Introduced: 8.5.103
Specifies the maximum allowed number of InteractionWait (StagingAreas) actions. When the threshold is reached, Stat Server does not create any more instances of the InteractionWait (StagingAreas) action, until the number of such actions falls back below the threshold.
If the debug-level option is set to Server, the following message is printed in the Stat Server log every minute while the threshold is reached:
"ATTN: InteractionWait actions threshold of (Max Number) reached”
suppress-user-data
Section: statserver
Default Value: undefined
Valid Values: yes or no when the option is defined
Changes Take Effect: Upon DN re-registration
Introduced: 8.5.104
If this option is not defined, there is no change to the existing Stat Server behavior. If the option is defined, its value overrides the value of the suppress-user-data option of Switch and/or DN objects. If the option is defined but the value is missing or wrong, then it is considered as defined no value.
reg-dns-chunk-delay
Section: statserver
Default Value: 10
Valid Values: Positive integers less than or equal to 2147483
Changes Take Effect: After restart
Modified: 8.5.104
Related Options: reg-dns-chunk-volume
Specifies the interval, in seconds, between two subsequent registration requests. Stat Server waits for the specified interval before sending a request to T-Server to register a subsequent set of DNs, thus allowing T-Server to process the previous request.
In a large configuration environment, use this option in conjunction with reg-dns-chunk-volume to optimize DN registration at Stat Server startup.
reg-delay
Section: statserver
Default Value: 0
Valid Values: 0 (zero) or positive integer less than or equal to 2147483
Changes Take Effect: After restart
Modified: 8.5.104
Causes Stat Server to wait the specified number of seconds before registering DNs that have been added to Configuration Server.
This option was previously named reg_delay (spelled with an underscore).
reconnect-timeout
Section: statserver
Default Value: 10
Valid Values: Positive integers less than or equal to 2147483; Stat Server sets any negative or 0 values that you might configure to 10.
Changes Take Effect: After restart
Modified: 8.5.104
Indicates the time interval, in seconds, between Stat Server attempts to reconnect to a T-Server or the database (DB Server if [db-direct-connection]/enable is set to no) if either is disconnected or not running.
This option was previously named reconnect_timeout (spelled with an underscore).
consult-acw-mode
Section: statserver
Default Value: always
Valid Values: always, last
Changes Take Effect: After restart
Introduced: 8.5.104
When a consult call is released on a regular DN and the after-call-work (ACW) is pending, Stat Server generates the AfterCallWork action only in the following cases:
- consult-acw-mode=always
- consult-acw-mode=last and there are no more calls on a DN
auto-backup-interval
Section: statserver
Default Value: 15
Valid Values: Integers 0 through 35791
Changes Take Effect: After restart
Modified: 8.5.104
Related Options: backup-file-name
Sets the time, in minutes, for checking persistent statistics and storing them in the file specified by the backup-file-name option. A value of 0 disables automated backups.
This option was previously named AutoBackupInterval.
suppress-user-data
Section: statserver
Default Value: undefined
Valid Values: yes or no when the option is defined
Changes Take Effect: Upon DN re-registration
Introduced: 8.5.104
If this option is not defined, there is no change to the existing Stat Server behavior. If the option is defined, its value overrides the value of the suppress-user-data option of Switch and/or DN objects. If the option is defined but the value is missing or wrong, then it is considered as defined no value.
consult-acw-mode
Section: statserver
Default Value: always
Valid Values: always, last
Changes Take Effect: After restart
Introduced: 8.5.104
When a consult call is released on a regular DN and the after-call-work (ACW) is pending, Stat Server generates the AfterCallWork action only in the following cases:
- consult-acw-mode=always
- consult-acw-mode=last and there are no more calls on a DN
Stat Server 8.5.104
RTME 8.5.1 Iteration 5
New in This Release
- Stat Server supports new Routable and NotRoutable actions on an agent or place.
- New DistinquishBy feature is introduced.
- Stat Server supports new ApplyFilterAtActionEndOnly stat type option.
- Stat Server supports new ExternalServiceRequested and ExternalServiceResponded actions for Tenants.
- Stat Server supports the ActorType and RequestEnvelope System attributes on selected actions.
- The following new configuration options are added in the statserver section:
Configuration Options
New/updated options:
- auto-backup-interval
- consult-acw-mode
- reconnect-timeout
- reg-delay
- reg-dns-chunk-delay
- suppress-user-data
Actions
New/updated Actions:
- ExternalServiceRequested (Tenants)
- ExternalServiceResponded (Tenants)
- Handling
- NotRoutable
- Routable
Updated Pages
- https://docs.genesys.com/Documentation/RTME/8.5Source/Library/8.5.1New
- https://docs.genesys.com/Documentation/RTME/8.5DRAFT/User/NewRelease
- https://docs.genesys.com/Documentation/RTME/8.5DRAFT/User/StatType#ApplyFilterAtActionEndOnly
- DistinguishBy
- ApplyFilterAtActionEndOnly
- https://docs.genesys.com/Documentation/RTME/8.5DRAFT/User/Filters
- ActorType
- IsOnline
- RequestEnvelope
Migration
Stat Server 8.5.1 General Changes
- Stat Server supports Routable and NotRoutable actions on an agent or place.
- Stat Server supports GroupBy and DistinquishBy features.
- Stat Server supports ApplyFilterAtActionEndOnly stat type option.
- Stat Server natively supports the Tenant statistical object.
- Stat Server supports ActorType, AgentID, and RequestEnvelope System attributes.
- Stat Server supports the GlobalUserData key-value list in filters and formulas.
- Stat Server serializes statistical aggregates to/from the backup file.
- Stat Server connects to Configuration Server in an asynchronous mode.
- Stat Server rereads the whole configuration upon receiving the event HistoryLogExpired from Configuration Server.
- Stat Server natively supports the StagingArea statistical object.
- Stat Server supports new observer-related and outbound-call related actions for a regular DN.
- Stat Server supports JDK 1.8.
- Stat Server includes functionality for the prevention of database update losses due to commit failures or loss of database server connection.
- Stat Server now only loads JVM, if it is defined in the configuration with absolute path.
Stat Server 8.5.0 General Changes
- Stat Server supports multiple Interaction Servers that handle the same Tenant.
- Stat Server supports the EventHint panic signal from Interaction Server. Refer to the eServices Reference Manual for more information about this feature.
- Stat Server supports Interaction Server Proxy.
- Stat Server supports direct connection to the database.
- Stat Server features a more robust DND model implementation for voice.
- Stat Server processes network messages (client and server) in a separate thread.
- Stat Server supports a higher number of concurrent client connections (on most platforms).
- Stat Server no longer supports Genesys suite-wide deployment wizards. All deployment wizards migrate to Genesys Administrator Extension (GAX):
- Resource Capacity Editor of GAX covers all the functionality that was covered by the Recourse Capacity Wizard.
Compatibility with Framework Components
Stat Server 8.5 interoperates successfully with the following Framework components:
- Configuration Server, releases 6.5 through 8.5
- Local Control Agent, releases 6.5 through 8.5
- Message Server, releases 6.5 through 8.5
- DB Server, releases 6.5 through 8.1
- T-Server, release 6.5 through 8.5
- Solution Control Server, release 6.5 through 8.5
However, to access all of the features that are available in a particular release, Genesys recommends that you operate Stat Server within the same family of Framework components in which it was released, or the latest available component release. Otherwise, some documented features may not be available to you.
Configuration Option Changes
| Current Option Name |
Section | Type of Change |
Release # in Which Change Occurred |
Details |
|---|---|---|---|---|
| auto-backup-interval | [statserver] | Modified | 8.5.104 | New max value is 35791. |
| consult-acw-mode | [statserver] | Added | 8.5.104 | Controls when Stat Server generates the AfterCallWork action. |
| reconnect-timeout | [statserver] | Modified | 8.5.104 | New max value is 2147483. |
| reg-delay | [statserver] | Modified | 8.5.104 | New max value is 2147483. |
| reg-dns-chunk-delay | [statserver] | Modified | 8.5.104 | New max value is 2147483. |
| suppress-user-data | [statserver] | Added | 8.5.104 | Determines whether Stat Server should transmit call-extracted attached data. |
| interaction-wait-on-sa-max-number | [statserver] | Added | 8.5.103 | Specifies the maximum allowed number of InteractionWait (StagingAreas) actions. |
| interaction-wait-on-sa-media-list | [statserver] | Added | 8.5.103 | Specifies the list of media type name(s) for which the InteractionWait (StagingAreas) action is generated. |
| backup-file-aggregates-store | [statserver] | Added | 8.5.102 | Controls whether the statistical aggregates are read from/written into the backup file. |
| disconnect-from-lca-on-history-log-expired | [statserver] | Added | 8.5.102 | Controls whether Stat Server disconnects from LCA upon receiving the HistoryLogExpired event. |
| media-type | [statserver] | Meaning extended | 8.5.102 | Now voice is a valid value. |
| accept-clients-in-backup-mode | [statserver] | Modified | 8.5.101 | New default value is yes. |
| db-timeout | [statserver] | Added | 8.5.101 | Controls the timeout, during which Stat Server waits for response from DB Server. |
| db-txn-max-retries | [statserver] | Added | 8.5.101 | Controls the number of transaction retries with DB Server. |
| reconnect-timeout | [statserver] | Meaning extended | 8.5.101 | The option is now also applicable to the Configuration Server connection. |
| debug | [db-direct-connection] | Added | 8.5.0 | Controls advanced debugging information on interactions with a database in the direct connection mode. |
| enable | [db-direct-connection] | Added | 8.5.0 | Enables direct database connection. |
| identity-in-login-table | [statserver] | Added | 8.5.0 | Applicable only for Oracle. Enables Stat Server to fill the APP_DBID field in LOGIN table. This option is required for Stat Server to operate with an Oracle Real Application Clusters (RAC). |
| verbose | [db-direct-connection] | Added | 8.5.0 | Controls the verbosity level of Stat Server log messages about SQL statement and other database-related activities. |
Diagnostics changes
- Stat Server ignores identically named places and indicates that with the following LMS message: GCTI_SS_NAME_UNIQUENESS_VIOLATION.
- Stat type definitions are now printed at startup if the Init:6 value is specified for the [statserver]\debug-level configuration option.
- Statistical requests to open statistics (OpenStat, GetStat) and associated responses (EventStatOpened, EventError) are printed at Init:4 (previously, at Init:5).
- Stat Server recognizes the [log]\time-format configuration option when printing timestamps in the log.
- If session with Configuration Server cannot be restored, new LMS message GCTI_SS_CFG_SESSION_RESTORE_FAILED is printed in standard log.
- If Init:7 is specified in [statserver]\debug-level, then additional diagnostics is printed on Init log level.
Migrating from Stat Server 8.1.2 with Connection to DB Server, to Stat Server 8.5.0 with Direct Database Connection
Prerequisites:
- A Database Access Point (DAP) properly configured for connection to the database with initialized Stat Server tables.
- Installed and properly configured related DBMS client software.
Migration steps:
- Install Stat Server 8.5.0.
- In the Stat Server application object, under Options / Application Options (GAX), in the [db-direct-connection] section set the enable option to on. Default value for the enable option is off.
- Optional. Set the verbose option in the db-direct-connection section to a value from 1 to 4 to produce more verbose log output on Stat Server database-related activities.
For DB2, you can install the IBM Data Server Runtime Client.
For SQL Server, you can install Microsoft Data Access Components (which includes ODBC), but this should not be necessary as Windows ships with ODBC.Migrating LOGIN table from 8.1.2 to 8.5.0 for Oracle
In general, Stat Server tables upgrade is not required, because Stat Server 8.5 works properly with tables from previous releases. If you use Oracle RAC environment, you must upgrade the LOGIN table using the upgrade script, which adds extra fields.
Using the Oracle sqlplus client, run the script sql_scripts/oracle/upgrade_850_login_oracle.sql, which will upgrade the table for use with Stat Server 8.5.0, and migrates existing data. This script creates two additional fields, ID and APP_DBID. Note that for existing data, the APP_DBID field will simply be set to 0.
- Running the script login_oracle.sql creates the table, and deletes previously existing data from it.
- Before you begin, back up your original LOGIN table, because running this script will reinitialize it, removing any old data from this table.
In the Stat Server application object, under Options / Application Options (GAX), in the [statserver] section set the identity-in-login-table option to on. This setting is not on by default.