Filename: ES530XA6AgentWX64005.zip
For: EdgeSight for XenApp 6 Agents, Version 5.3, running on 64-bit editions of one of the following operating systems, with or without EdgeSight software being previously installed:

• Windows Server 2008 R2

Readme Revision History

Important Note(s)

Caution! This hotfix may require you to edit the registry. Using Registry Editor incorrectly can cause serious problems that may require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk.

Where to Find Documentation

This document describes the issue(s) resolved by this release and includes installation instructions. For additional product information, see Citrix Knowledge Center.

Important Disclaimer - Limited Release Hotfix

This limited release hotfix is available only upon request. Contact Citrix technical support to obtain the hotfix package. The fix(es) or enhancement(s) contained in this hotfix will be included in a future service pack, hotfix rollup pack, or version release for this product. Testing of this hotfix was targeted only at the affected functionality, and regression and stress testing were minimal. Therefore, this hotfix might cause undesirable and unknown side effects. Introduce this hotfix to a test environment for evaluation before deploying it to a production environment. Your use of this hotfix is at your own risk.

TO THE EXTENT PERMITTED BY APPLICABLE LAW, CITRIX AND ITS SUPPLIERS MAKE AND YOU RECEIVE NO WARRANTIES OR CONDITIONS, EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE, AND CITRIX AND ITS SUPPLIERS SPECIFICALLY DISCLAIM WITH RESPECT TO THE HOTFIX ANY CONDITIONS OF QUALITY, AVAILABILITY, RELIABILITY, SECURITY, LACK OF VIRUSES, BUGS OR ERRORS, OR SUPPORT AND ANY IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, ANY WARRANTY OF TITLE, QUIET ENJOYMENT, QUIET POSSESSION, MERCHANTABILITY, NONINFRINGEMENT, OR FITNESS FOR A PARTICULAR PURPOSE. TO THE EXTENT PERMITTED BY APPLICABLE LAW, NEITHER CITRIX, NOR ITS SUPPLIERS SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL, MULTIPLE, PUNITIVE OR OTHER DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF DATA, LOSS OF INCOME, LOSS OF OPPORTUNITY, LOST PROFITS, COSTS OF RECOVERY OR ANY OTHER DAMAGES), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, AND WHETHER OR NOT FOR BREACH OF CONTRACT, NEGLIGENCE OR OTHERWISE, AND WHETHER OR NOT CITRIX, ITS SUPPLIERS, OR LICENSORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

New Fixes in This Release

1. The Citrix System Monitoring Agent can exit unexpectedly, causing sessions running on XenApp servers to be disconnected at random several times a day. The following error message appears:

   "The Citrix System Monitoring Agent service terminated unexpectedly. It has done this 1 time(s). The following corrective action will be taken in 60000 milliseconds: Restart the service."

   [From ES530XA6AgentWX64005][#259762]

Fixes from Replaced Hotfixes

1. When an EdgeSight Agent upgrade is performed using the MSIEXEC command line, some registry values may be corrupted and the System Monitoring Service will not start.

   [From ES530XA6AgentWX64001][#234109]

2. EdgeSight for XenApp Agent in Basic mode stops and records the following application log entry: "Event ID : 41 The Citrix System Monitoring Agent can not run in reduced mode on a non Enterprise server."

   [From ES530XA6AgentWX64001][#234262]

3. Session Performance alerts are not generated when the poll interval selected is 360 seconds.

   [From ES530XA6AgentWX64002][#234266]

4. Published application information is not collected when the application is launched from a script, for example a file with .cmd extension. This fix is dependent on the installation of hotfix EUEM100W001, which addresses the underlying EUEM issue for Windows Server 2003 32-bit and 64-bit systems.

   [From ES530XA6AgentWX64002][#244070]

5. When the EdgeSight agent is started and worker 128 has run, the associated worker log file shows an undefined variable error.

   [From ES530XA6AgentWX64002][#244661]

6. If the scheduled job for daily data deletion and the database maintenance worker run at the same time, the EdgeSight Agent hangs and is restarted.

   [From ES530XA6AgentWX64003][#239632]

7. Large amounts of data were generated when monitoring Windows Event Log alerts. Event log alert data can be throttled using registry keys located at HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\System Monitoring\Agent\EdgeSight\4.00. There is one registry key per event log (System, Application, and Security). The registry key type is DWORD.

   • MaxSysEventLogThreshold
   • MaxAppEventLogThreshold
   • MaxSecEventLogThreshold

   Specify a value to indicate the maximum number of event log messages allowed per 10 minute window. Event log alerts can be throttled to zero. Any missing value will be considered as unlimited, meaning that no throttling will be applied to alerts for the corresponding event log.

   This feature is only included in EdgeSight 5.3. In future releases, the registry key will be ignored and an equivalent function will be available from the EdgeSight Server console.

   [From ES530XA6AgentWX64003][#240693]

8. The XenApp server was slow to restart or logoff after upgrading the HP System Management Homepage to version 6.1.0.102.

   [From ES530XA6AgentWX64003][#241240]

9. The EdgeSight Agent service (rscorsvc.exe) is terminated unexpectedly.

   [From ES530XA6AgentWX64003][#245683]

10. The EdgeSight Agent service (rscorsvc.exe) experiences memory leaks.

    [From ES530XA6AgentWX64003][#245749]

11. After upgrading from XenApp Enterprise to XenApp Platinum Edition, the EdgeSight Agent remains in "Basic" mode instead if being upgraded to "Advanced" mode automatically. The upgrade also removes the Mode tab, making it impossible to upgrade the agent manually. This fix restores the Mode tab, allowing for the agent mode to be set manually.

    [From ES530XA6AgentWX64004][#234273]

12. The EdgeSight Agent can exit unexpectedly with the following error:

    "The application attempted to release a resource it did not own, ntdll!RtlpNotOwnerCriticalSection+0xac invoked by SemsCollector (SemsPerf, SessionDef)."

    [From ES530XA6AgentWX64004][#242578]

13. Version 5.3 (or 5.3, Build 4109) of the EdgeSight Agent can exit unexpectedly with the following error: "INVALID_POINTER_READ_c0000005_es_ext.dll!CProcessCounterSet::IterThreads."

    [From ES530XA6AgentWX64004][#242580]

14. Thread Hang Detection is tripped repeatedly resulting in an error messages ("The queue thread has stopped responding" or "The Scheduler thread has stopped responding") and a restart of the EdgeSight agent.

    [From ES530XA6AgentWX64004][#242581]

15. In the Session Memory report, data can be missing from the Virtual, Private and Working Set columns.

    [From ES530XA6AgentWX64004][#249004]

16. The EdgeSight Agent can exit unexpectedly.

    [From ES530XA6AgentWX64004][#254596]

17. When processing a payload (for example, from a shadow session), the EdgeSight server registers the following error message in the core_zpd_loader log and administrative emails:

    "Cannot insert the value NULL into column 'app_name', table 'EdgeSight.dbo.ctrx_published_app'."

    [From ES530XA6AgentWX64004][#257898]

18. The EdgeSight for XenApp Agent can exit unexpectedly with the following error:

    "(0xc0000005 - The instruction at 0x%08lx referenced memory at 0x%08lx- generic symptom of following a null pointer)."

    [From ES530XA6AgentWX64004][#258478]

Installing This Release

Notes:

• This version is packaged as a .zip file containing the replacement EdgeSightXA6Agent64.msi file. For more information about deploying msi files, see Microsoft article 884016 or visit the Microsoft Web site and search on keyword msiexec.
• To install this version successfully, servers must not have registry modification restrictions in place.
• If you are installing this release on a German (DE), French (FR), Spanish (ES), or Japanese (JA) operating system, run the MSI file using the msiexec command and specify the language-specific MST file as the value for the TRANSFORMS argument. Each MST file name includes the two letter language code. For example: msiexec /I EdgeSightXA6Agentx64.msi TRANSFORMS=:de_transform.mst.

To install this version:

1. Copy the file to a shared folder on the network.
2. Extract the compressed file and save the EdgeSightXA6Agent64.msi file on the computer you want to update.
3. Run the .msi file.
4. Restart the computer if prompted to do so.

If it does not exist already, this will add a new entry, Citrix System Monitoring Agent, to the Add/Remove Programs list.