Product Documentation

Installing EdgeSight Active Application Monitoring Software

Oct 16, 2015
EdgeSight AAM depends on the deployment of several software components. For AAM component system requirements, see “Active Application Monitoring Requirements” in System Requirements for EdgeSight 5.4.


Conceptual illustration of deployment

  1. Install EdgeSight Server, adhering to the system requirements listed in “Server Requirements” in System Requirements for EdgeSight 5.4.
  2. Install the AAM Controller and Launcher, adhering to the system requirements listed in “Active Application Monitoring Requirements” in System Requirements for EdgeSight 5.4. These components can be installed on the same machine or on different machines.
  3. Optionally, install the Web Interface Connector. This component is required if users will be connecting to XenApp systems using the XML service. The Web Interface Connector requires the installation of Microsoft Visual J# .NET Redistributable Package.
  4. Install the EdgeSight for XenApp Agent on each XenApp system to be tested, adhering to the system requirements listed in “Agent Requirements” in System Requirements for EdgeSight 5.4. The agent must be installed in Advanced Mode to ensure that AAM-related alerts can be generated.

    The Launcher is installed as a service (Citrix EdgeSight Launcher Service). The default location for Launcher installation is:

    %ProgramFiles%\Citrix\Citrix EdgeSight Simulation\LauncherService.exe

    Launchers and the Controller use port 18747 to communicate.

    After deploying the software components, you can perform the following tasks, as described in EdgeSight Active Application Monitoring Help and EdgeSight Server Online Help:

    • Configure the systems to be tested, as well as the systems hosting the Controller and Launchers.
    • Using the Controller, create a script, including monitoring points, and create virtual users.
    • Using the EdgeSight Server Console, create Application Response Time and Application Response Failure alerts for real-time notification of application response times that exceed thresholds or application response failures.
    • Using the EdgeSight Server Console, monitor applications under test using the Application Response Time and Application Response Failure historical reports.

Installing the Active Application Monitoring Components

Important: If you previously installed the AAM components included with the EdgeSight 5.3 or 5.4 release, you will be prompted to uninstall those components before running the EdgeSight AAM 5.3 Service Pack 2 installer.

Use the following steps to initially install the software:

  1. Insert the media or run Autorun.
  2. Select EdgeSight Component Installers.
  3. Select EdgeSight Active Application Monitoring Installation to display the Welcome screen.
  4. Click Next to display the License Agreement screen.
  5. After reading the license, select I accept and click Next to display the Installation Type screen.
  6. Select the type of installation you want to perform. If you selected Custom, go to Step 7. If you selected Typical or Complete, skip to Step 8.
    • Typical – Install the Controller and Launcher
    • Custom – Select the components you want to install from Controller, Launcher, and Web Interface Connector. When you use the Web Interface Connector, it must be installed on the Controller and Launcher. The Web 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.
    • Complete – Install the Controller, Launcher, and Web Interface Connector.
  7. By default, all components are enabled. To disable installation of a component, click the component and select Entire feature will be unavailable. Click Disk Usage to display disk space availability, or click Reset to return to the default component selections. When you have completed feature selection, click Next.
  8. The system prompts for a password. This password will be required when using each Launcher and the Controller. The password must be at least 8 characters in length and should match the passwords set on all Launcher machines to be used in the test.
  9. Click Install to install the software and display the Performing Installation Tasks screen. The Installation Complete screen is displayed after the software is installed.
  10. Click Finish to exit the Setup Wizard.
  11. After the installation is complete, go to Citrix > Citrix EdgeSight Active Application Monitoring > AAM Controller and log in using the previously specified password. Select Help > Help Topics to display online help. The help file includes information about configuring Controllers, Launchers, and XenApp systems under test.