AppManager for Citrix XenApp lets you manage the performance and availability of Citrix XenApp servers. By monitoring your Citrix server implementation at the component level, you can quickly identify areas that might have a negative impact on overall performance, and then you can modify the configuration to improve performance.

This release improves usability and resolves previous issues. Many of these improvements were made in direct response to suggestions from our customers. We thank you for your time and valuable input. We hope you continue to help us ensure that our products meet all your needs. You can post feedback in the AppManager forum on NetIQ Communities, our online community that also includes product information, blogs, and links to helpful resources.

The documentation for this product is available on the NetIQ Web site in HTML and PDF formats on a page that does not require you to log in. If you have suggestions for documentation improvements, click comment on this topic at the bottom of any page in the HTML version of the documentation posted at the AppManager Modules page. To download this module, log into the AppManager Module Upgrades & Trials page.

What's New?

This release of AppManager for Citrix XenApp resolves the following issue:

XenApp_FarmUserLoad Knowledge Script does not generate datapoints if no users are connected to the XenApp server. This release resolves an issue in which the XenApp_FarmUserLoad Knowledge Script failed to generate datapoints unless a user was connected to a XenApp server in the server farm. With this release, changes to the XenApp_FarmUserLoad script enables the script to generate datapoints even if no users are connected to a XenApp server. (ENG333515)

To get the updates provided in this release, you must install the module to the AppManager repository (QDB), and then propagate changes to any running jobs for the Knowledge Scripts that were updated in this release. AppManager 7.x does not automatically update renamed or copied Knowledge Scripts. For more information, see the "Upgrading Knowledge Script Jobs" section in the management guide.

This release of AppManager for Citrix XenApp replaces all Previous Releases.

Return to Top

System Requirements

For the most recently updated list of supported application versions, see the AppManager Supported Products page. Unless noted otherwise, this module supports all updates, hotfixes, and service packs for the releases listed below.

AppManager for Citrix XenApp has the following system requirements:

AppManager version 7.0 or later installed on the AppManager repository (QDB) computer, on the Citrix XenApp computers you want to monitor (agents), and on all console computers
Note Support for Windows Server 2008 on AppManager 7.x requires AppManager Windows Agent hotfix 71704 or later. For more information, see the AppManager Suite Hotfixes page.
One of the following Microsoft operating systems installed on the agent computers:
- Windows Server 2008 R2
- Windows Server 2008 (32-bit and 64-bit)
One of the following Citrix XenApp versions installed on the agent computers:
- Citrix XenApp or Citrix XenApp License Server 6.5
- Citrix XenApp or Citrix XenApp License Server 6.0
- Citrix XenApp (Platinum or Enterprise edition) or Citrix XenApp License Server 5.0
Citrix XenApp Server SDK installed on the Citrix XenApp Server computers
The following components installed on the agent computers:
- Microsoft PowerShell 2.0 or later installed on the agent computers
- Microsoft XML parser 3.0 Service Pack 1 or later installed on the agent computers
- Citrix XenApp IMA and MFCOM Services running on the agent computers
AppManager for Microsoft Windows module installed on the AppManager repository (QDB) computer, on the Citrix XenApp computers you want to monitor (agents), and on all console computers
Note Support for Windows Server 2008 R2 on AppManager 7.x requires the AppManager for Windows module, version 7.6.170.0 or later. For more information, see the AppManager Module Upgrades & Trials page.

For more information, see the AppManager for Citrix XenApp Management Guide, included in the download package.

Return to Top

Contents of the Download Package

AppManager for Citrix XenApp includes AppManager Knowledge Scripts that discover and monitor XenApp resources. The download package includes these release notes, a management guide, Help for Knowledge Scripts, and several files that are used during installation:

AM70-XenApp-8.1.33.0.msi, the module installer.
AM70-XenApp-8.1.33.0.ini, a configuration file used with the AppManager setup program.
AM70-XenApp-8.1.33.0.xml, a configuration file used for deploying the module with Control Center. This is the file you check into the Control Center Web Depot.
AM70-XenApp-8.1.33.0-RepositoryFiles.exe, a compressed file that contains the QDB and console files. You do not need to run this file during installation.
DefaultRule_XenApp.xml, a configuration file used for deploying the module with Control Center.
ckXenApp.exe, the pre-installation check used with the AppManager setup program.

When you download the module, these files are copied by default to the local folder on the download computer. Consider copying these files to the \windows_installation\setup\Setup Files folder on the same distribution computer on which you saved your main AppManager software and documentation. By doing so, you maintain all AppManager software in one location that is easily accessible when you want to add more repositories, management servers, or agents.

Return to Top

Installing This Module

Run the module installer to install the module components in the following locations:

On the XenApp computers you want to monitor to install the agent components
On all console computers to install the Help and console extensions

Run the module installer only once on each of these computers.

You must also install the Knowledge Scripts. You can install these module components to either local or remote databases. When installing to the primary QDB, select the option to install Knowledge Scripts, and then specify the SQL Server name of the server hosting the QDB, as well as the case-sensitive QDB name.

Important If you use Control Center 7.x, run the module installer for each QDB attached to Control Center. If you use Control Center 8.x, run the module installer only for the primary QDB, and Control Center will automatically replicate this module to secondary QDBs.

Install Knowledge Scripts only once per QBD. The module installer now installs Knowledge Scripts for each module directly into the QDB instead of to the \AppManager\qdb\kp folder as in previous releases.

For more information about installing this module, see the AppManager for Citrix XenApp Management Guide, included in the download package.

Return to Top

Known Issues

NetIQ Corporation strives to ensure our products provide quality solutions for your enterprise software needs. The following issue is currently being researched. If you need further assistance with any issue, please contact Technical Support.

Discovery does not pick up XenApp configuration changes. If you make a configuration change to any server associated with a Citrix farm, AppManager for Citrix XenApp might not report the correct information even if you repeat discovery after making the change. For example, if you rename a zone using the XenApp Delivery console, and then run the Discovery Knowledge Script, the old and the new zone names display in the AppManager TreeView. To work around this issue, restart the IMA or MFCOM service from the Citrix agent before you repeat the discovery process. (DOC310170)
Error message for failing to initialize PowerShell session does not describe how to resolve the issue. The error message Failed to initialize MCPSHostServer PowerShell session has the error description The process failed to start because user username could not be impersonated: System.ComponentModel.Win32Exception: Logon failure: the user has not been granted the requested logon type at this computer. This description is accurate, but does not tell you how to resolve the issue. If you receive this message, use Security Manager to specify that the Domain Account should log on as a service. You can specify this by adding the domain account under Local Policies>User Rights>User Rights Assignment>Log on as service. (ENG314408)

Return to Top

Previous Releases

This release of AppManager for Citrix XenApp includes enhancements added in previous releases.

Release 8.1.26.0, December 2011

This release combined the features of AppManager for Citrix XenApp 8.0 and 8.1 to provide the following:

Support for Citrix XenApp 5.0, 6.0, and 6.5 in one module. This release adds backward compatibility for XenApp version 5 to the latest XenApp module. XenApp version 5 is already supported by the AppManager for Citrix MetaFrame version 7.2, and that module is still available if you need support for older operating systems. AppManager for Citrix XenApp version 8.0 provided support for XenApp 6.0 and 6.5. With this release, AppManager for Citrix XenApp now combines support for all major XenApp versions in one module.
PowerShellHost server can run as a different user than the AppManager agent. This release allows you to configure user permissions so that the the PowerShellHost server, MCPSHostServer.exe runs under a different user account than the AppManager agent service, netiqmc.exe. With this release, netiqmc can run under an account that does not have XenApp privileges, while having MCPSHostServer.exe run under an account with the XenApp permissions required for monitoring.
XenApp category of Knowledge Scripts. With the AppManager for Citrix XenApp module, you have a XenApp category of Knowledge Scripts that work with XenApp servers and server farms to track vital aspects of system performance in clustered and non-clustered environments.

This release also resolved the following issue:

Duplicate applications appear multiple times in TreeView. This release resolves an issue where published applications on farms were displayed on the TreeView for every discovered object. With this release, the Discovery_XenApp Knowledge Script now allows you to specify whether you want to discover published applications in a farm environment. If you do want to discover applications on a farm, use the new XenApp_ApplicationUsersHighAll Knowledge Script instead of the existing XenApp_ApplicationUsersHigh Knowledge Script to eliminate issues with having duplicate published applications. If you do not have applications on a farm, continue using the XenApp_ApplicationUsersHigh Knowledge Script. (ENG311406)

Release 8.0.50.0, September 2011

This release provided a new module that supports Citrix XenApp versions 6.0 and 6.5 with all new Knowledge Scripts. This release was not an upgrade of the AppManager for Citrix MetaFrame module that continues to provide support for some older versions of XenApp, MetaFrame, and Presentation Server.

The new XenApp category of Knowledge Scripts works with Citrix XenApp versions 6.0 and 6.5 servers and server farms to track vital aspects of system performance in clustered and non-clustered environments, including:

Number of sessions on a server
Number of sessions opened by each user
Number of bytes transferred from each session by each user
Average and high latency of server sessions
Session states
Number of processes on a server across all sessions
Memory and CPU resources used by server processes
Number of users running an application across all sessions
Percentage of all licenses that are in use on the License Server, in clustered and non-clustered environments
Whether a specific application is on the list of published applications, and which servers are assigned to that published application
Whether a server is the default data collector along with zone information for a specific Citrix Server

Return to Top

Contact Information

Our goal is to provide documentation that meets your needs. If you have suggestions for improvements, please email Documentation-Feedback@netiq.com. We value your input and look forward to hearing from you.

For detailed contact information, see the Support Contact Information page.

For general corporate and product information, see the NetIQ Corporate Web site.

For interactive conversations with your peers and NetIQ experts, become an active member of our community. The NetIQ online community provides product information, useful links to helpful resources, blogs, and social media channels.

Return to Top

Legal Notice

THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT ARE FURNISHED UNDER AND ARE SUBJECT TO THE TERMS OF A LICENSE AGREEMENT OR A NON-DISCLOSURE AGREEMENT. EXCEPT AS EXPRESSLY SET FORTH IN SUCH LICENSE AGREEMENT OR NON-DISCLOSURE AGREEMENT, NETIQ CORPORATION PROVIDES THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. SOME STATES DO NOT ALLOW DISCLAIMERS OF EXPRESS OR IMPLIED WARRANTIES IN CERTAIN TRANSACTIONS; THEREFORE, THIS STATEMENT MAY NOT APPLY TO YOU.

For purposes of clarity, any module, adapter or other similar material ("Module") is licensed under the terms and conditions of the End User License Agreement for the applicable version of the NetIQ product or software to which it relates or interoperates with, and by accessing, copying or using a Module you agree to be bound by such terms. If you do not agree to the terms of the End User License Agreement you are not authorized to use, access or copy a Module and you must destroy all copies of the Module and contact NetIQ for further instructions.

This document and the software described in this document may not be lent, sold, or given away without the prior written permission of NetIQ Corporation, except as otherwise permitted by law. Except as expressly set forth in such license agreement or non-disclosure agreement, no part of this document or the software described in this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, or otherwise, without the prior written consent of NetIQ Corporation. Some companies, names, and data in this document are used for illustration purposes and may not represent real companies, individuals, or data.

This document could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein. These changes may be incorporated in new editions of this document. NetIQ Corporation may make improvements in or changes to the software described in this document at any time.

U.S. Government Restricted Rights: If the software and documentation are being acquired by or on behalf of the U.S. Government or by a U.S. Government prime contractor or subcontractor (at any tier), in accordance with 48 C.F.R. 227.7202-4 (for Department of Defense (DOD) acquisitions) and 48 C.F.R. 2.101 and 12.212 (for non-DOD acquisitions), the government's rights in the software and documentation, including its rights to use, modify, reproduce, release, perform, display or disclose the software or documentation, will be subject in all respects to the commercial license rights and restrictions provided in the license agreement.

For information about NetIQ trademarks, see http://www.netiq.com/company/legal/.

Return to Top