Release Note

Contents

Introduction

As of February 1, 2012, Genesys is no longer an affiliate of Alcatel-Lucent; any indication of such affiliation within Genesys products or packaging is no longer applicable. Please see the Genesys website at http://www.genesyslab.com for more details.

This release note applies to the 7.6 releases of Data Sourcer.

• Links in the Contents section enable you to access information regarding a specific release. Releases are listed by version number rather than in date order. For this reason, a recent release may be listed after earlier releases, if the version number is lower. Except when otherwise noted in the information for a specific release, each release includes all of the features and corrections that were introduced for the applicable operating system at earlier dates, regardless of the version numbering.
• The Release Number table lists the supported operating systems for each release at a high level. For more detailed information, see the Genesys Supported Operating Environment Reference Guide.
• The Known Issues and Recommendations section is a cumulative list. It includes information on when individual items were found and, if applicable, corrected.
• The Corrections and Modifications section for each release may list additional issues that were corrected without first being documented as Known Issues.
• The Discontinued Support section is cumulative. It lists functionality that is no longer supported and the release number of the version in which support was discontinued.

Use of Third-Party Software

Supported Operating Systems

New in This Release

This is a hot fix release for this product. Refer to the Deployment Procedure for this release to deploy the installation package within your environment. This section describes new features that were introduced in this release of Data Sourcer.

• Support for Linux OS was added on 11/15/2013.

Corrections and Modifications

This release includes the following corrections and modifications:

Data Sourcer now updates the object name in the ODS database for objects added in Configuration Manager after the layout is activated. Previously, Data Sourcer updated the object name only after a restart. (CCA-1993, ER# 316695199)

Top of Page

Supported Operating Systems

New in This Release

There are no restrictions for this release. Deployment Procedure for this release to deploy the installation package within your environment. This section describes new features that were introduced in this release of Data Sourcer.

• Support for Oracle Real Application Clusters (RAC) 11g Releases 1 and 2
• Support for Red Hat Enterprise Linux 5 (64-bit)

Corrections and Modifications

This release includes the following corrections and modifications:

Build 2 of this release includes support for Solaris (64-bit) that was missing in the build that was originally released on January 9, 2012. Customers who obtained this software release prior to February 7, 2012, and need support for Solaris (64-bit) must download Build 2 from the Genesys Software Download website. (ER# 293478968)

Data Sourcer can now terminate while scheduling object changes by SCI. (ER# 282857344)

Data Sourcer no longer reports unnecessary messages during startup, such as (4) Collector: New Message (6,3) 'MsgTypeObjectChanged'. (ER# 282794821)

Data Sourcer now continues attempting to connect to unavailable Configuration Servers. Previously, Data Sourcer stopped the attempts to connect to Configuration Servers on unreachable hosts or non-running Configuration Servers on the local host. (ER# 279328586)

Data Sourcer now generates a Standard log event message, 38-04505, when the reconnection request to Configuration Server fails. (ER# 279249472)

Data Sourcer no longer fails during initialization when the objects it is monitoring are being modified in the Configuration Layer. (ER# 272286884)

Data Sourcer no longer delays shutdown because of long-running activation processes that have been scheduled. (ER#s 271346761, 271053845)

Data Sourcer no longer fails to schedule reconnections to Stat Server while simultaneously creating an initial connection or a reconnection to the primary and backup Stat Servers. (ER# 271162458)

Top of Page

Supported Operating Systems

New in This Release

This is a hot fix release for this product. Refer to the Deployment Procedure for this release to deploy the installation package within your environment. This release contains no new features or functionality.

Corrections and Modifications

This release includes the following corrections and modifications:

This release prevents Data Sourcer from entering a deadlock condition when deactivating a schedule. Previous releases entered a deadlock when either of the following occurred:

• A schedule was activated while another schedule was being deactivated.
• A schedule was deactivated while Data Sourcer was in the process of requesting statistics for a new object or statistical type that Data Sourcer encountered.

(ER# 273622102)

This release corrects a memory leak that previously might have occurred during schedule deactivation in deployments in which Data Sourcer 7.6 operated with a primary and backup pair of Stat Servers. (ER# 274051889)

Top of Page

Supported Operating Systems

New in This Release

This is a hot fix release for this product. Refer to the Deployment Procedure for this release to deploy the installation package within your environment. This release contains no new features or functionality.

Corrections and Modifications

This release includes the following corrections and modifications:

Data Sourcer now attempts to reconnect to the backup Configuration Server after the first connection attempt fails. Previously, if Data Sourcer unsuccessfully tried to establish a connection to the backup Configuration Server before the Configuration Server's role changed from the backup to primary completely, Data Sourcer did not make other attempts to reconnect. (ER# 257596176)

Data Sourcer now correctly keeps trying to reconnect to Configuration Server when the connection has been lost. Previously, after a few subsequent attempts to connect to both the primary and backup Configuration Servers had failed, Data Sourcer would stop trying to reconnect to Configuration Server. (ER# 271273400)

Data Sourcer now generates Standard Level log messages indicating whether Data Sourcer is connected to Configuration Server as follows:

• Standard Level log message 38-04503 indicates that Data Sourcer is connected to Configuration Server.
• Standard Level log message 38-04504 indicates that the connection from Data Sourcer to Configuration Server has been lost.
• Standard Level log message 38-04505 indicates that Data Sourcer has been disconnected from Configuration Server.

You can set up an alarm condition to receive a notification of such an error. Refer to the Framework 8.x Management Layer User's Guide for instructions on how to set alarm conditions. (ER# 269907048)

Top of Page

Supported Operating Systems

New in This Release

There are no restrictions for this release. This release of Data Sourcer introduces no new features or functionality.

Corrections and Modifications

This release includes the following corrections and modifications:

Deactivating and then, shortly thereafter, reactivating a layout no longer raises an issue. Previously, that scenario could lead to certain statistics being presented as VOID, with the following type of error logged:

2010-10-08 10:12:22.594 (4988) Error: Can't add object (4,114), probably invalid record in OL_OBJ_TO_REPORT

(ER# 261644801)

This release supports a direct upgrade of Data Sourcer from the 7.0 and 7.1 families. Previously, an intermediate step, upgrading to 7.2, and only then to 7.6, was required. (ER# 261520922)

When the layout for agents is activated, Data Sourcer now reads only Agents from ODS. Previously in this case, Data Sourcer might unnecessarily re-read all objects from ODS. (ER# 261738088)

Now it is possible to start several Data Sourcer instances on a given box running Windows Server 2008. Previously, after the first instance started on this OS, subsequent instances might fail to start. (ER# 261767028)

Data Sourcer now correctly updates all appropriate definitions for statistic types in ODS when the parameters for those statistic types have been changed in the options of a Stat Server Application object. Previously in this case, some of the definition updates were incorrectly omitted. (ER# 261878682)

Data Sourcer now supports performing a configuration recheck, initiated via DMA, for a given layout. Note: You need DMA release 7.6.000.06 or higher to take advantage of this capability. (ER# 261923282)

This release of Data Sourcer is supported for Windows 2000, SP4. (ER# 261521132)

Top of Page

Supported Operating Systems

New in This Release

There are no restrictions for this release. This release of Data Sourcer introduces no new features or functionality.

Corrections and Modifications

This release includes the following corrections and modifications:

Data Sourcer no longer terminates unexpectedly when it is configured to work through a Configuration Server proxy and an update on Configuration Manager of a Configuration Server application object is performed. (ER# 245956269 and 248104150)

Data Sourcer no longer deletes an object from a layout due to a disconnection from Configuration Server when the layout is in the process of being rechecked by Data Sourcer. (ER# 249074114)

Data Sourcer now requests statistics for new objects that had been introduced while Data Sourcer had lost connection with Configuration Server. (ER# 253480712)

Data Sourcer no longer incorrectly attempts to add duplicate objects to ODS. (ER# 253762224)

Data Sourcer no longer terminates unexpectedly, in rare occasions, after the connection with DB Server is lost. (ER# 254588983)

Data Sourcer is now able to detect corrupted chunks files that were previously ignored. (ER# 255263997)

Data Sourcer no longer incorrectly removes switches when a tenant is disconnected from the Data Sourcer application. (ER# 255463518)

Data Sourcer no longer initiates a configuration recheck for unrelated layouts of individual objects when a campaign object is changed in Configuration Manager. (ER# 256028360)

Data Sourcer now correctly shuts down when it is requested to stop while in the process of opening statistics. (ER# 256873348)

Data Sourcer no longer incorrectly excludes existing objects from individual objects layout for Queues and Routing Points. (ER# 257374711)

Data Sourcer now uses the reconnect timeout value configured in the Configuration Server application instead of using a constant value of 10 seconds. (ER# 258197840)

Data Sourcer no longer delays reconnecting to DB Server after the connection has failed in previous reconnect cycles. (ER# 258261607)

Data Sourcer no longer significantly delays its shutdown activities in high-volume data environments. (ER# 258496564)

Data Sourcer, when working with the chunk-composition-mode option set to a value of legacy, now writes to ODS the portion of data that is already collected for the layout that is being deactivated or for all layouts when Data Sourcer is shutting down. (ER# 261445964)

Top of Page

Supported Operating Systems

New in This Release

There are no restrictions for this release. This section describes new features that were introduced in the initial 7.6 release of Data Sourcer.

• Data Sourcer now uses the chunk-composition-mode option, which is located in the collector section.

  chunk-composition-mode
  Default Value: legacy
  Valid Values: legacy, fast, normal, safe
  Changes Take Effect: After a restart

  This option specifies the method of receiving and writing data from the Primary and Backup Stat Server pair:

  • legacy—When this value is configured, Data Sourcer overwrites a chunk from the Backup Stat Server with the chunk from the Primary Stat Server, if it is available. In this mode, this release of Data Sourcer performs the same as Data Sourcer 7.2.100.49 and does not use the Receive queue.

  Receive Queue—A new queue that is introduced for chunks that are received from both the Primary and Backup Stat Servers. The Receive Queue increases the reliability of the statistical data captured in high availability (HA) mode. The memory consumption of Data Sourcer increases because this queue requires additional memory. To activate the Receive Queue, set the chunk-composition-mode option to one of the following valid values:

  • fast—When this value is configured, Data Sourcer uses the Receive Queue. In this mode, Data Sourcer writes the chunk, regardless of whether it originated from the Primary or Backup Stat Server. However, if the received chunk is incomplete, Data Sourcer waits for a subsequent chunk to complete and then decides which copy of the incomplete chunk to submit—the Primary or Backup. Genesys recommends only configuring the fast value in your test environment or in environments that do not include a Backup Stat Server.
  • normal—When this value is configured, Data Sourcer uses the Receive Queue. In this mode, Data Sourcer overwrites a chunk from the Backup Stat Server with the chunk from the Primary Stat Server. In this mode, if a chunk from the Backup Stat Server is received, Data Sourcer waits to receive a chunk from the Primary Stat Server (unless the chunk from the Primary Stat Server was complete—then it does not wait). If a chunk from the Primary Stat Server is received but is incomplete, Data Sourcer waits for the chunk from the Backup Stat Server and then decides which chunk to submit next, Primary or Backup. Genesys recommends using the normal value in all configurations.
  • safe—When this value is configured, Data Sourcer uses the Receive Queue. In this mode, Data Sourcer waits to receive chunks from both the Primary and Backup Stat Servers and once received, decides which chunk to submit. This mode might cause data-writing delays for the one time profile period, depending on the Stat Server connection speed, the number of opened statistics, and the time profile period length. Genesys recommends only setting the safe value in high availability (HA) configurations with a Backup Stat Server. Setting this option in any configuration other than HA might cause constant data writing delays.

  (ER# 254435447)

• Data Sourcer now uses the new-object-delay option, which is located in the collector section.

  new-object-delay
  Default Value: 0
  Valid Values: 0 - 1440
  Changes Take Effect: Immediately

  This option specifies the delay between the moment Data Sourcer receives notification of a new object in Configuration Server and the moment it actually starts to process this notification. Setting this option to 0 enables Data Sourcer to process new objects without delays, as it did in previous releases. (ER# 250750389)

• Data Sourcer now uses the receive-queue-size option, which is located in the collector section.

  receive-queue-size
  Default Value: 3
  Valid Values: 1 - 100
  Changes Take Effect: After a restart

  This option determines the size of the chunk queue that is maintained by Data Sourcer for each schedule, and determines the number of periods for which Data Sourcer is able to keep chunks before it has to submit some of them. This option is useful in high-volume data environments in which Stat Server is supplying data at different speeds. (ER# 250441724)

• Data Sourcer now adds a source thread identifier to the each message in the log in the form "(thread_id)". The following message is an example:

  2009-10-29 05:56:01.949 (3704) DBWriter: Connected to ODS.

  (ER# 239056361)

• Data Sourcer now displays detailed progress information about the number of opened statistics. (ER# 249229829)

• Data Sourcer now processes layout deactivation faster. This significantly decreases delays when incoming data from Stat Server is processed. (ER# 245805090)

Corrections and Modifications

This release includes the following corrections and modifications:

Data Sourcer no longer experiences data loss when multiple Stat Server switchovers are performed while Data Sourcer is requesting statistics. (ER# 248129821)

Data Sourcer now correctly validates the range of values for the data-excess-low-threshold and data-excess-high-threshold options. (ER# 248017371)

In previous releases, Data Sourcer may not have checked for the presence of certain required tables in the ODS. This issues is corrected in this release. (ER# 234727269)

Data Sourcer no longer generates a receive date such as, "1/1/1970," in scenarios in which the new chunk-composition-mode option is used, and Data Sourcer has to flush chunks because of a queue overflow. (ER# 250441653)

Data Sourcer no longer writes data to the ODS that it failed to write previously for a layout that has already been transferred and deleted by ETL Runtime. Previously, this issue occurred in some scenarios on the Oracle RDBMS. (ER# 227425251)

Data Sourcer no longer schedules data flow checks when there are no active layouts or active connections to Stat Server. (ER# 248473188)

Data Sourcer now correctly manages internal Receive Queues. Previously, incorrect handling of internal Receive Queues sometimes resulted in data loss or incorrect data collection. (ER#s 253765620, 254054514)

Data Sourcer now correctly reconnects to Stat Server if during layout deactivation the connection to Stat Server is lost. (ER# 254234565)

Data Sourcer now provides a new and improved chunk composition algorithm, the chunk-composition-mode option, that is more dependable in high-volume data environments. This new option replaces the new-data-processing option. Genesys recommends configuring the safe or normal values for the chunk-composition-mode option. (ER# 249188237)

Data Sourcer no longer opens two connections to Configuration Server at the same time when reconnecting. Previously, as a result of the mis-synchronization caused by opening two active connections in parallel, Data Sourcer might have stopped functioning. (ER# 250667421)

Data Sourcer no longer loses data after reconnecting to Stat Server. Previously, in this scenario data loss might have occurred. (ER# 248735457)

Data Sourcer no longer becomes unresponsive while stopping if the chunk-composition-mode option is used. (ER#s 250715032, 253100983)

Data Sourer no longer loads information for switches that do not belong to those Tenants that are assigned to corresponding Data Sourcer applications. (ER# 252218208)

Data Sourcer no longer tries to include newly-created Tenants in the Tenant-based layout after the Tenant is created in the Configuration Layer. Now Tenants are included in the Tenant-based layout only when the Tenant has been added to the Data Sourcer Application object. (ER# 226768148)

Data Sourcer no longer continues to run while the Solution Control Interface (SCI) indicates that it is stopped. (ER# 229963768)

Data Sourcer now correctly adds statistical parameters to ODS that have been added manually to Stat Server through the Configuration Layer. (ER# 203656281)

The description of the activate-new-layouts option is now correct in the 7.6 release of the Reporting 7.6 Data Sourcer User's Guide. (ER# 220080491)

Data Sourcer now consistently requests statistics for layouts in Tenants that are newly assigned to Data Sourcer. Previously, Data Sourcer sometimes failed to do so. (ER# 224267431)

Data Sourcer now provides improved support for HA during layout activation and prevents the collection of data for objects that were not added to the ODS database. (ER# 225029430)

Data Sourcer now accounts for new switches and the related DN objects that are created while Data Sourcer is running. Previously, switches that were created while Data Sourcer was running were not always noted by Data Sourcer. (ER# 226768111)

Data Sourcer no longer creates new layouts unconditionally from available templates in Tenants that are newly assigned to Data Sourcer. This behavior can be enabled or disabled by using the new AUTO-CREATE-NEW-TENANT-LAYOUTS option, which is located in the collector section. (ER# 226802601)

Data Sourcer no longer writes verbose messages unconditionally while requesting statistics for layouts. These verbose messages are now suppressed by default, and you can enable or disable them using the new VERBOSE-REQUEST-STATISTICS option, which is located in the collector section. (ER# 226803046)

Data Sourcer now correctly deletes a Campaign Group from a report layout, based on individual objects when that Campaign Group was deleted in Configuration Database. (ER# 228113511)

Data Sourcer no longer starts to create chunk files before the chunk queue size has reached the N*2 limit, where N is the number of active layouts. (ER# 228967836)

Data Sourcer now correctly deletes chunk files, in certain situations, after the chunk was written to the ODS database. (ER# 229492461)

Data Sourcer no longer accepts or collects statistical data for objects that were already deleted but not recognized by Stat Server. (ER#s 229607051, 229607131)

This release of Data Sourcer introduces a new binary-format chunk file. Data Sourcer displays the chunk origin server ID in the log and also stores it in this new chunk file. Binary-format chunk files generated with previous releases of Data Sourcer can no longer be used. If you need to write data from the binary-format chunk files to the ODS, use the same release of Data Sourcer from which the binary-format chunk files were generated before upgrading to this 7.6.000.15 release. (ER#s 234278611, 248129823)

Data Sourcer now correctly re-requests statistics from the Stat Server after the connection to Stat Server is restored but server profiles are not received. In such scenarios, by default Data Sourcer now schedules subsequent reconnects to Stat Server every 10 minutes. (ER# 245956223)

Data Sourcer no longer terminates unexpectedly after the connection to Stat Server is lost and then restored during layout deactivation. (ER# 246534311)

Data Sourcer now properly closes and opens modified statistics during configuration re-check. (ER# 246623721)

Data Sourcer now implements a more efficient data-processing algorithm that prevents data loss when both the Primary and Backup Stat Servers are running in Backup mode. (ER# 246749461)

Data Sourcer no longer opens a duplicate connection with a Stat Server when the connection to Stat Server is lost and option values have been changed when Data Sourcer reconnects to Stat Server. (ER# 246749606)

Data Sourcer no longer incorrectly updates ODS definitions of statistical parameters that are not identified as correct by Stat Server. (ER# 246766171)

Data Sourcer no longer terminates unexpectedly in certain circumstances during the layout deactivation process. (ER# 246864471)

Data Sourcer no longer creates chunk files for chunks that do not require them. (ER# 246994511)

Data Sourcer no longer generates chunks with the time boundaries [0,0] at times when the connection to the one of the Stat Servers in the Primary/Backup pair is temporarily unavailable. (ER# 247288714)

Data Sourcer now correctly performs data-flow checks and, when appropriate, generates alarm messages that are related to the data flow. (ER# 247754247)

When Data Sourcer reconnects to Stat Server after the connection was lost while Data Sourcer was checking statistical parameters, it no longer generates a continuous loop. (ER# 248225752)

Top of Page

Known Issues and Recommendations

This section provides the latest information on known issues and recommendations associated with this product.

Data Sourcer version 7.6.000.20, and all earlier versions of Data Sourcer 7.6 will not run on the Windows 2000 operating system. Genesys will provide a fix for this issue with the next release of Data Sourcer 7.6. (ER# 261521132)

The current version of Data Sourcer (7.6.000.20) does not support a direct upgrade from version 7.0.x and 7.1.x of Data Sourcer. If you need to perform these upgrades, follow these instructions:

1. Contact Genesys Customer Care for instructions on obtaining the installation package for Data Sourcer version 7.2.003.12 that is suitable for your operating system.
2. Download the Data Sourcer 7.2.003.12 installation package according to the instructions from Genesys Customer Care.
3. Complete steps 1-5 of the Deployment Procedure for Data Sourcer.
4. Perform steps 6, 8, 9, and 10 of the Deployment Procedure using Data Sourcer 7.2.003.12.
5. Uninstall Data Sourcer 7.2.003.12.
6. Data Sourcer 7.6.000.20 can now be installed by performing the Deployment Procedure starting with step 6.

Genesys will provide support for the direct upgrade path from versions 7.0.x and 7.1.x to versions 7.6.x in the next release of Data Sourcer 7.6.

(ER# 261520922)

Data Sourcer, running on the AIX platform, may terminate unexpectedly after a database error or a lost connection to DB Server is experienced while Data Sourcer is writing data chunks. Data Sourcer should be restarted if you have experienced this problem. (ER# 260640579)

Second, and subsequent, instances of Data Sourcer may not startup when running on the Windows 2008 Server operating system. For this reason, Genesys recommends not to attempt to start more than one instance of Data Sourcer on each Windows 2008 Server machine. There is a planned fix for this issue. (ER# 261767028)

Data Source may not startup normally, under the rare circumstances, if Configuration Server is not running at the moment when Data Sourcer is started. If you experienced this issue, please be certain that Configuration Server is running, and then restart Data Sourcer. (ER# 261604887)

If the [collector] option activate-new-layouts is set to false, Data Sourcer will not restart data collection for the active layouts belonging to any Tenant that detaches from the Data Sourcer Application in Configuration Manager and then reattaches to the Data Sourcer Application. In such a scenario, you must set the [collector] option activate-new-layouts to true to ensure that layouts will activate and Data Sourcer will restart data collection. (ER# 250315436)

In some situations when both Stat Server and DB Server have been disconnected, one Data Sourcer in a Primary/Backup pair may have received chunks not received by the other. This situation may result in "stuck" chunk files, which are present in the Backup Data Sourcer but not in the Primary one. As a result, these chunks are also missing from ODS.

To solve this issue, switch the modes of the two Data Sourcers in Solution Control Interface. This allows the Data Sourcer that has the missing chunks to become the Primary and write the missing data to ODS. (ER# 246714751)

DMA does not enable you to delete newly added time profiles when both the Primary and Backup Data Sourcer applications are running. Instead, you must stop both Data Sourcer applications to delete time profiles within DMA. Genesys, however, does not recommend deleting time profiles or other statistical parameters. (ER# 104297002)

Data Sourcer does not consistently display the application name of its Configuration Server in the log. Instead, Data Sourcer logs the application name it read at startup for the first—usually the Primary—Configuration Server connected. (ER# 100331)

Top of Page

Discontinued Support

This section documents features that are no longer supported in this software. This cumulative list is in release-number order with the most recently discontinued features at the top of the list.

Support for the following operating systems and RDBMS has been discontinued:

• IBM AIX 5.1 and 5.2 (32- and 64-bit)
• Solaris 7 and 8
• HP-UX 11.0
• Red Hat Enterprise Linux AS 3
• Tru64/Alpha 5.1B (64-bit)
• Microsoft Windows Server 2000
• Oracle 9 (all versions)

The new-data-processing configuration option is no longer supported. Instead, use the chunk-composition-mode configuration option.

IBM DB2 8.1 is no longer a supported RDBMS. IBM DB2 8.2 or higher must be used.

Oracle 8.1.7 is no longer a supported RDBMS. Oracle 9 or higher must be used.

IS Cartridge mode is no longer supported.

Top of Page

Internationalization

Information in this section is included for international customers.

There are no known internationalization issues for this product.

Top of Page

Additional Information

Additional information on Genesys Telecommunications Laboratories, Inc. is available on our Customer Care website. The following documentation also contains information about this software. Please consult the Deployment Guide first.

• Reporting 7.6 Data Sourcer User's Guide presents the objects Data Sourcer tracks, operation and function of the emergency save file, and the configuration options available. This document also describes Data Sourcer behavior when server connections are dropped.

• Reporting 8.0 Deployment Guide describes how to configure, install, start, and stop Data Sourcer.

• Reporting 8.0 Master Index directs you to the location of specific topics in the Reporting documentation set.

• Reporting 8.0 Reference Manual includes component performance measurements.

Product documentation is provided on the Customer Care website, the Genesys Documentation website, and the Documentation Library DVD (produced monthly) or the Developer Documentation CD.

Note: For the DVD/CD, the New Documents on this DVD/CD page indicates the production date for that disc. Due to disc production schedules, documentation on the Genesys Documentation website may be more up-to-date than what is available on disc immediately after a product is released or updated. To determine the version of a document, check the version number that is located on the second page in PDFs or on the About This File topic in Help files.

Top of Page