Citrix EdgeSight for Load Testing 3.5
copy of the End User License Agreement is included on your product CD-ROM.
Information in this document is subject to change without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Citrix Systems, Inc.
© 2009 Citrix Systems, Inc. All rights reserved.
Citrix is a registered trademark, and Citrix XenApp, Citrix Presentation Server, and Citrix EdgeSight are trademarks of Citrix Systems, Inc. in the United States and other countries.
Trademark Acknowledgements
Microsoft, Windows, Windows Server, and Internet Explorer are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
All other trademarks and registered trademarks are the property of their respective owners.
Contents
Chapter 1
Installation Overview
EdgeSight for Load Testing Requirements. . . 6
EdgeSight Web Interface Support Requirements . . . 6
Citrix License Server for Windows 4.5 Requirements . . . 7
Chapter 2
Installing EdgeSight for Load Testing
Obtaining the MSI Files. . . 9Citrix EdgeSight for Load Testing Licensing . . . 9
Installing the EdgeSight for Load Testing Components. . . 10
Installing the Web Interface Support Components. . . 11
Upgrading EdgeSight for Load Testing Components. . . 12
C
HAPTER1
Installation Overview
Citrix® EdgeSight™ for Load Testing software is installed using the following Windows Installer (MSI) files:
• EdgeSight for Load Testing.msi • EdgeSight Web Interface Support.msi
Note Do not modify the base MSI file. Modifying the base MSI file can interfere with support efforts in case of installation issues.
The EdgeSight for Load Testing MSI file installs the following components of the EdgeSight for Load Testing software:
• EdgeSight for Load Testing Controller—Used to record and create virtual user scripts and define tests. When the test is ready for playback, the Controller instructs the Launchers to run the test with a certain number of virtual users for a certain period of time.
• EdgeSight for Load Testing Launcher—Receives the commands from the Controller and generates virtual user ICA sessions on the target XenApp servers or Presentation Servers. The number of Launchers required will vary based on the target virtual user load. Launchers report session information back to the Controller for run-time and post run-time analysis. • XML Interface Connector—Allows users to connect to applications made
available through the XML Service. This feature requires the Visual J# Version 2.0 Redistributable Package available from Microsoft at http:// msdn2.microsoft.com/en-us/vjsharp/default.aspx.
Launchers are installed on clients of the servers that will be under test. They can be installed on systems with the Controller and as stand-alone Launchers. The EdgeSight Web Interface Support MSI file installs the following components of the Web Interface (WI) interface on the Controller system and the XenApp or Presentation Server system:
identify the location of the Application Page when configuring the Web interface.
• EdgeSightWISecurity group—Created on the XenApp server or Presentation Server system to allow Web Interface users to authenticate. • Web Interface Connector—Allows EdgeSight for Load Testing users to connect to applications made available through the Citrix Web Interface.
EdgeSight for Load Testing Requirements
The requirements for systems running the EdgeSight for Load Testing Controller and Launcher are listed in the following table.
EdgeSight Web Interface Support Requirements
The EdgeSight Web Interface Support software is designed to be deployed on machines running Web Interface 4.5 or higher. The target machine must meet the requirements listed in the Citrix Web Interface Administrator’s Guide. In addition, the Windows Authentication Security IIS role is required.
Controller and Launcher Requirements
OS Microsoft Windows Vista, Microsoft Windows XP, Microsoft Windows Server 2003, and Microsoft Windows Server 2008 (32-bit and 64-bit systems)
Citrix License Server for Windows 4.5 or higher ICA Client Version 8.1 or higher
Citrix Presentation Server 3 or higher, or Citrix XenApp 5.0 Microsoft Excel (for displaying Log files)
.NET Framework 2.0 or later is required for all Launchers and Controllers that will be establishing connections using the Web Interface.
Chapter 1 Installation Overview 7
Citrix License Server for Windows 4.5
Requirements
EdgeSight for Load Testing requires Citrix License Server for Windows 4.5 or higher. If the license server is not installed and running, license information cannot be obtained and Citrix EdgeSight for Load Testing is not allowed to start Launchers. You will receive instructions by email for downloading EdgeSight license keys. For documentation on licensing, see the Citrix licensing
documentation at http://support.citrix.com/.
If you are unfamiliar with the Citrix License Server, you should start by reading
Getting Started with Citrix Licensing Guide.
C
HAPTER2
Installing EdgeSight for Load
Testing
This chapter provides instructions on installing and configuring the Citrix EdgeSight for Load Testing software. The instructions are based on an initial installation. Before starting an installation, make sure that you have reviewed the prerequisites and system requirements listed in Chapter 1, “Installation
Overview.”
Obtaining the MSI Files
Citrix EdgeSight software is distributed both electronically and on media, depending on the specific product purchased. Consult with your sales representative for more information.
Citrix EdgeSight for Load Testing Licensing
When a test is replayed, the EdgeSight for Load Testing software checks for the presence of a XenApp Platinum or Enterprise license on the specified licensing server. If a valid license is detected, you can run as many users as required. If you do not have a XenApp Platinum or Enterprise license on the specified licensing server, but have CCU licenses, the number of users you can test with is limited by the amount for which you are licensed. If no licenses of any kind are detected, the software displays the a message (Could not find a valid license on the designated license server) and offers to run in 15 user evaluation mode. Citrix EdgeSight for Load Testing licensing is provided by the Citrix License Server for Windows. See “Citrix License Server for Windows 4.5 Requirements” for information on obtaining the license server documentation.
Installing the EdgeSight for Load Testing Components
You can install EdgeSight for Load Testing Version 3.5 as a direct upgrade from Version 3.0 or higher, or as a clean installation by first removing the older version. A clean installation creates the Alarms, Debug, ICA Files, Logs, Reports, Tests, and Tmp folders in My Documents\Citrix EdgeSight for Load Testing. An update maintains the folders in the original folders, \Program Files\Citrix\Citrix EdgeSight for Load
Testing\.
Note Before performing an upgrade, back up all scripts.
The EdgeSight for Load Testing software supports installation from media or by directly invoking the MSI user interface. Use the following steps to install the EdgeSight for Load Testing software:
1. If you are installing from media, insert the media. Click on EdgeSight for
Load Testing Installation.
If you are installing directly from the MSI file, double click the EdgeSight for Load Testing MSI file to start the setup wizard.
The Welcome screen is displayed.
2. Click Next to continue. The End-User License Agreement screen is displayed.
3. After reading the license, select I accept and click Next. The Choose Setup Type screen is displayed.
4. Select the type of installation you want to perform and click Next. • Typical – Install the Controller and Launcher.
• Custom – Select the components you want to install from Controller,
Launcher, and Web Interface XML Service Connector. The Web Interface XML Service Connector is installed on the same machine as the Controller and Launcher and allows users to connect to
applications made available through the XML Service. This feature requires the Visual J# Version 2.0 Redistributable Package available from Microsoft at http://msdn2.microsoft.com/en-us/vjsharp/ default.aspx.
• Complete – Install the Controller, Launcher, and Web Interface XML
Service Connector.
Chapter 2 Installing EdgeSight for Load Testing 11
6. The Installation Complete screen is displayed after the software is installed. Click Finish to exit the Setup Wizard.
After the installation is complete, see the Online Help (available from the Controller) and the EdgeSight for Load Testing User’s Guide for information about configuring Servers, Controllers, and Launchers.
Installing the Web Interface Support Components
The EdgeSight Web Interface Support software is installed on XenApp or Presentation Server systems running Web Interface 4.5 or higher. The software allows EdgeSight for Load Testing software to access applications that are available through the Presentation Server or XenApp Web Interface. To install the Web interface Support software.
1. If you are installing from media, insert the media. Click on Web Interface
Support Installation.
If you are installing directly from the MSI file, double click the EdgeSight Web Interface Support MSI file to start the setup wizard. The Welcome screen is displayed.
2. Click Next to continue. The License Agreement screen is displayed. 3. After reading the license, select I accept and click Next. The User Info
screen is displayed.
4. Enter the username and password for the user to be added to the
EdgeSightWISecurity group. If you are performing the installation using a local machine account, enter the computer name and username
(computername\username). If you are performing the installation using a domain account, enter the domain name and username
(domainname\username).
5. Click Validate to validate the credentials. After the credentials are validated, click Next to continue. The Website Selection screen is displayed.
6. Select the Website where you want to install the application page. Click
Next. The Ready to Install screen is displayed.
7. Click Install to start the installation.
Upgrading EdgeSight for Load Testing Components
Important Upgrading EdgeSight for Load Testing from a Beta or Technology Preview release is not supported. You must first uninstall the early release version of the software and then install the released version of the EdgeSight for Load Testing software.
You can directly upgrade to the current version of the software from EdgeSight for Load Testing 3.0 or later. Tests developed on EdgeSight for Load Testing 2.7 or later can be used with this release.
