EndUserMonitoring Install

Foglight
5.6.5
End User Monitoring

Installation and Configuration Guide
2012 Quest Software, Inc.

ALL RIGHTS RESERVED.
This guide contains proprietary information protected by copyright. The software described in this guide is furnished under
a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of
the applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic
or mechanical, including photocopying and recording for any purpose other than the purchasers personal use without the
written permission of Quest Software, Inc.
The information in this document is provided in connection with Quest products. No license, express or implied, by estoppel
or otherwise, to any intellectual property right is granted by this document or in connection with the sale of Quest products.
EXCEPT AS SET FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR
THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR
STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO
EVENT SHALL QUEST BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR
INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS
INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT,
EVEN IF QUEST HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or
warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make
changes to specifications and product descriptions at any time without notice. Quest does not make any commitment to
update the information contained in this document.
If you have any questions regarding your potential use of this material, contact:
Quest Software World Headquarters
LEGAL Dept
5 Polaris Way
Aliso Viejo, CA 92656
www.quest.com
email: legal@quest.com
Refer to our Web site for regional and international office information.
Trademarks
Quest, Quest Software, the Quest Software logo, Foglight, IntelliProfile, PerformaSure, Spotlight, StealthCollect, TOAD, Tag
and Follow, Vintela Single Sign-on for Java, and vFoglight are trademarks and registered trademarks of Quest Software, Inc
in the United States of America and other countries. For a complete list of Quest Softwares trademarks, please see http://
www.quest.com/legal/trademark-information.aspx. Other trademarks and registered trademarks are property of their
respective owners.
Third Party Contributions

Foglight contains some third party components. For a complete list, see the License Credits page in Foglight online help.
Installation and Configuration Guide

September 2012
Version 5.6.5
End User Monitoring: Installation and Configuration Guide
Table of Contents
Introduction to this Guide..................................................................................................................................................5
About Quest Software, Inc. ............................................................................................................................................................. 5
Contacting Quest Software ..................................................................................................................................................... 6
Contacting Quest Support ....................................................................................................................................................... 6
Installing the End User Core Cartridge.............................................................................................................................7

Installing the Foglight Agent Manager............................................................................................................................................. 7
Installing the End User Core Cartridge............................................................................................................................................ 7
Enabling the Cartridges................................................................................................................................................................... 8
Installing the Cartridge for FxM.......................................................................................................................................10

Installing and Configuring the Cartridge for FxM........................................................................................................................... 10
Verifying the Foglight Agent Manager Version...................................................................................................................... 11
Installing the Cartridge for FxM ............................................................................................................................................. 11
Deploying the Foglight Experience Monitor (FxM) Agent Package....................................................................................... 12
Creating, Configuring, and Activating the Foglight Experience Monitor (FxM) Agent ........................................................... 13
Configuring Foglight Experience Appliance Settings .................................................................................................................... 18
Configuring the Foglight IP Settings on the Foglight Experience Monitor Appliance ............................................................ 18
Configuring the Database Settings........................................................................................................................................ 19
Configuring the Metric Data Settings..................................................................................................................................... 20
Upgrading the Cartridge for FxM................................................................................................................................................... 21
Deactivating the FxM Agents ................................................................................................................................................ 21
Upgrading the Foglight Experience Monitor .......................................................................................................................... 22
Upgrading the Foglight Management Server ........................................................................................................................ 22
Upgrading the End User Core Cartridge ............................................................................................................................... 22
Upgrading the Cartridge for FxM........................................................................................................................................... 22
Deploying and Updating the Agent Package......................................................................................................................... 22
Creating, Configuring, and Activating the FxM Agent ........................................................................................................... 23
Installing the Cartridge for FxV .......................................................................................................................................25

Installing and Configuring the Cartridge for FxV ........................................................................................................................... 25
Installing the Cartridge for FxV on Foglight ........................................................................................................................... 25
Installing the Cartridge for FTR and Its Components ...................................................................................................29

Foglight Transaction Recorder System Requirements ................................................................................................................. 29
Table of Contents
Software................................................................................................................................................................................. 29
Hardware ............................................................................................................................................................................... 29
Installing the Foglight Transaction Recorder on Windows Vista or Newer Operating Systems .................................................... 30
Upgrading and Using Existing FTR Scripts from SPID to the Foglight Agent Manager ................................................................ 30
Installing and Configuring the Cartridge for FTR and Its Components .......................................................................................... 30
Installing and Enabling the EU-Core Cartridge on the Foglight Management Server............................................................ 31
Installing and Enabling the Cartridge for FTR on the Foglight Management Server ............................................................. 31
Installing the Foglight Transaction Recorder, Player, and Agent........................................................................................... 33
Upgrading the Foglight Transaction Recorder and Transaction Player Agent....................................................................... 35
Installing Tevron CitraTest to Record Thick Client Applications ............................................................................................ 36
Installing the CitraTest Recording Environment..................................................................................................................... 36
Installing the CitraTest Playback Environment ...................................................................................................................... 37
Deploying the Foglight Transaction Player Agent Package................................................................................................... 40
Creating, Configuring, and Activating the Foglight Transaction Recorder (FTR) Agent ........................................................ 41
Publishing Foglight Transaction Recorder Scripts to Foglight ............................................................................................... 44
Configuring the Transaction Player Agent on Foglight to Replay Scripts .............................................................................. 46
Index.................................................................................................................................................................................. 51
Introduction to this Guide

This guide provides the procedures and discusses the requirements you need to install and
configure the following Foglight end user monitoring components:
Foglight End User Core Cartridge (EU-Core-5_6_5.car) that contains common elements
used by the End User cartridges.
Foglight Cartridge for FxM (EU-FXM-5_6_5.car) to receive data from the Foglight
Experience Monitor appliance.
Foglight Cartridge for FxV (EU-FXV-5_6_5.car) to receive data from the Foglight
Experience Viewer appliance.
Foglight Cartridge for FTR (EU-FTR-5_6_5.car) to play back scripts created on the Foglight
Transaction Recorder and uploaded to Foglight, for playback using the Foglight Transaction
Player agent.
Note
When you install the EU-FTR cartridge in Foglight, the Foglight Transaction Recorder and
Tevron CitraTest executable files are placed in the Components for Download dashboard
for installation.
Foglight Transaction Recorder:

FLTRP_5_6_5.exe
Tevron CitraTest (CitraTest FTRA Setup 751e1.exe)
This guide is intended for those who need to install and configure Foglight end user monitoring
software components.
About Quest Software, Inc.

Established in 1987, Quest Software (Nasdaq: QSFT) provides simple and innovative IT
management solutions that enable more than 100,000 global customers to save time and money
across physical and virtual environments. Quest products solve complex IT challenges ranging
from database management, data protection, identity and access management, monitoring, user
workspace management to Windows management. For more information, visit www.quest.com.
Introduction to this Guide
Contacting Quest Software

Email
info@quest.com
Mail
Quest Software, Inc.

World Headquarters
5 Polaris Way
Aliso Viejo, CA 92656
USA
Web site
www.quest.com
Refer to our Web site for regional and international office information.
Contacting Quest Support

Quest Support is available to customers who have a trial version of a Quest product or who have
purchased a Quest product and have a valid maintenance contract. Quest Support provides
unlimited 24x7 access to our Support Portal at http://www.quest.com/support.
From our Support Portal, you can do the following:
Retrieve thousands of solutions from our Knowledge Base
Download the latest releases and service packs
Create, update, and review Support cases
View the Global Support Guide for a detailed explanation of support programs, online services,
contact information, policies, and procedures. The guide is available at: http://www.quest.com/
support.
1
Installing the End User Core Cartridge
To install and gather end user data on the Foglight Management Server, you need to first install the
End User Core (EU-Core) cartridge, an agent-less cartridge which contains common elements
used by the End User cartridges. After installing the EU-Core cartridge, you install the following
cartridges to gather end user metrics data:
The Cartridge for FxMthis cartridge communicates with the Foglight Experience
Monitoring appliance and reports end user data to the Foglight.
The Cartridge for FxVthis cartridge communicates with the Foglight Experience Viewer
appliance and reports end user data to the Foglight.
The Cartridge for FTRthis cartridge plays back scripts created on the Foglight
Transaction Recorder and uploaded to Foglight for playback using the Foglight Transaction
Player agents.
All three cartridges report on end user performance and require the EU-Core cartridge to report
data and metrics.
Note
If you have already installed and are using any of the end user cartridges, the EU-Core cartridge
is already present on your Foglight Management Server. It is recommended that you install the
latest version of the EU-Core cartridge on your system.
Installing the Foglight Agent Manager

The Foglight Agent Manager (FglAM) is installed on monitored Foglight hosts, providing a
centralized communications link between Foglight and its agents. The Foglight Agent Manager
also provides a number of support services, such as installation, upgrade, and the ability to
configure agents. The Foglight Agent Manager installs when you install the End User Core
cartridge (EU-Core-5_6_5.car).
Installing the End User Core Cartridge

The following procedure installs the End User Core Cartridge on the Foglight Management Server.
Chapter 1Installing the End User Core Cartridge
To install the End User Cartridge:

1 Log in to the Foglight browser interface.
2 Ensure that the navigation panel is open.
To open the navigation panel, click the right-facing arrow
on the left.
3 On the navigation panel, under Dashboards click Administration > Cartridges > Cartridge
Inventory.
4 If the CAR (EU-Core-5_6_5.car) resides in a location that you can access from your local
computer:
a Select the File on Local Computer option.
b Click Browse, navigate to and select the EU-Core-5_6_5.car, and click Open.
c The File on Local Computer box refreshes, showing the full path to the CAR file.
or
If the CAR (EU-Core-5_6_5.car) resides in a location that you can access from your local
computer:
b Type the path and file name. The path should be relative to the Foglight installation
directory.
Optionalto enable the cartridge immediately after its installation, select the Enable on
install check box.
Alternatively, you can enable the cartridge at a later time. To do this, ensure that the Enable
on install check box is cleared, and follow the instructions in Enabling the Cartridges on
page 8 after the cartridge installation.
5 Click Install Cartridge.
A status bar appears in the Cartridge Inventory dashboard indicating the installation
progress. If the installation succeeds, the Cartridge Operation Result message box appears.
Click OK to close this message.
6 To refresh the cartridge list, click
in the upper-right corner.
Enabling the Cartridges

Enabling a cartridge completes the process of adding it to Foglight by making the cartridges
components available for use. The following procedure should be performed only if you did not
enable your cartridges during the installation process as outlined in step in Installing the End User
Core Cartridge.
Note
You can enable a cartridge upon installation or after installation. General installation information
can be found under the Installing and Managing Cartridges chapter in the Foglight Administration
and Configuration Guide.

Chapter 1Installing the End User Core Cartridge
To enable a cartridge:
2 On the navigation panel, under Dashboards, click Administration > Cartridges >
Cartridge Inventory.
The Status column contains icons that indicate if a cartridge is enabled or disabled.
3 Select one or more disabled cartridges that you want to enable.
4 Click the Enable button.
If the operation succeeds, the Cartridge Operation Result message box appears.
5 Click OK.
2
Installing the Cartridge for FxM
The Cartridge for FxM gives Foglight users the ability to view end user data captured by Foglight
Experience Monitor appliances. Successful Foglight to Foglight Experience Monitor integration
requires implementing the correct product versions. Although essential compatibility information
is listed here, refer to the Foglight Experience Monitor Release Notes for complete compatibility
information. This document can be found on Quest Softwares SupportLink site: http://
support.quest.com.
Foglight Experience Monitor version 5.6.5 is required for use with this version of the Cartridge for
FxM 5.6.5 cartridge. If your appliance is on an older version, refer to the Foglight Experience
Monitor Release Notes for upgrade details and recommended upgrade path.
In addition, the FxM Agent no longer resides on the appliance and is now deployed on the agent
host, typically the Foglight Management Server. For more information see, Upgrading the
Cartridge for FxM on page 21.
Note
It is recommended that you back up your data on the appliance before performing any upgrade
procedures.
Note
The Cartridge for FxM uses the Foglight Agent Manager (FglAM) to communicate with the
Foglight Management Server.
Installing and Configuring the Cartridge for FxM

The following steps are required to install and configure the Cartridge for FxM:
1 Verifying the Foglight Agent Manager Version on page 11.
2 Installing the Cartridge for FxM on page 11.
3 Deploying the Foglight Experience Monitor (FxM) Agent Package on page 12.
4 Creating, Configuring, and Activating the Foglight Experience Monitor (FxM) Agent on
page 13.
5 Configuring Foglight Experience Appliance Settings on page 18.
11
Chapter 2Installing the Cartridge for FxM
Verifying the Foglight Agent Manager Version

Ensure that the correct version of the Foglight Agent Manager (FglAM) is installed on the Foglight
Management Server. By default, an embedded FglAM instance is installed during the installation
of the Foglight Management Server.
For more information about installing FglAM, see the Foglight Installation Guide.
Installing the Cartridge for FxM

The following procedure installs the Cartridge for FxM.
To install the Cartridge for FxM:
on the left.
3 On the navigation panel, under Dashboards select Administration > Cartridges >
4 If the CAR (EU-FXM-5_6_5.car) resides in a location that you can access from your local
computer:
b Click Browse, navigate to and select the EU-FXM-5_6_5.car file, and click Open.
c The File on Local Computer dialog box refreshes, showing the full path to the CAR file.
or
If the CAR file (EU-FXM-5_6_5.car) resides in a location that you can access from your local
computer:
directory.
5 Optionalto enable the cartridge immediately after its installation, choose the Enable on
install check box.

Alternatively, you can enable the cartridge at a later time. To do this, ensure that the Enable
on install check box is cleared, and follow the instructions in Enabling the Cartridges on
7 Click OK.
12
8 To refresh the cartridge list, click
Deploying the Foglight Experience Monitor (FxM) Agent Package

The Foglight Agent Manager component, installed on each monitored host, is used to manage
agent instances and their communication with the Foglight Management Server. A cartridge may
include one or more Foglight Agent installers. An agent monitors a specific part of your
environment, such as an operating system, application, or server. You deploy the agent package
file to the host machine that is running that agent.
To deploy the FxM Agent package:
2 On the navigation panel, click Dashboards > Administration > Agents > Agent Status.
3 In the Agent Status dashboard, click Deploy Agent Package in the lower-left corner.
The Deploy Agent Package dialog box appears.

Note
In order to select the host, the Foglight Agent Manager must be running and available on
the monitored host. To deploy an agent package to multiple hosts, navigate to the Agent
Hosts dashboard by clicking Agent Hosts in the Deploy Agent Package dialog box.
4 In the Host list, select the monitored host where you want to deploy the agent package from.
Note
In versions 5.5.4 and later, this is never the FxM appliance machine. Typically, the agent
package is deployed on the host running the Foglight Management Server.
5 In the Package list, select the FxM-FglAM-Agent.gar package to deploy on the monitored
host.
Optionally, you can show agent packages that can be deployed on any platform by selecting
the Show Packages for All Platforms check box.
Tip
You can only deploy agent packages whose cartridges are already installed on the
6 Click Deploy.
The Deploy Agent Package dialog box refreshes, showing the status of the deployment
operation. A green check mark indicates the success of the deployment operation.
13
7 Click OK.
Creating, Configuring, and Activating the Foglight Experience Monitor (FxM)

Agent
After deploying the FxM Agent package, you create, configure, and activate the FxM Agent
adapter. Foglight uses the FxM Agent adaptors to communicate with agents that collect
information from monitored hosts. The following steps are required:
1 Creating the Foglight Experience Monitor (FxM) Agent
2 Configuring Agent Properties
3 Activating the Agent
Creating the Foglight Experience Monitor (FxM) Agent

The Agent Status dashboard allows you to view information about agents as well as perform
agent-related operations, such as deploy agent packages, activate and deactivate agents, start and
stop data collections for one or more agent instances, and view information about agents.
Note
The FxM Agent version 5.5.5 and later uses the Foglight Agent Manager (FglAM).
To create the FxM Agent:

1 Log in to the Foglight browser interface and ensure that the navigation panel is open.
on the left.
2 On the navigation panel, under Dashboards, click Administration > Agents > Agent
Status.
The Agent Status dashboard appears displaying all agents installed on the Foglight
Management Server.
3 Click Create Agent.
The Create Agent dialog box appears.
14
4 From the Host list, select the host on which you want to create the agent instance.
After you have selected a host, the Agent Type box populates with all agents that are
deployed on that host. You can now create agent instances of the FxM Agent whose package
has been deployed to the selected host.
5 In the Agent Type box, select FxM.
6 In the Instance Name box, type a display name for the agent.
For example, FxMAppliance.
7 Click Create.
The new agent appears in the Agent Status dashboard. A green check mark indicates the
success of the operation.
8 Click OK.
15
9 Click OK.
The Create Agent dialog box closes and the new FxM Agent instance appears selected on the
Agent Status dashboard.
Configuring Agent Properties

You configure the agent properties of the Foglight Management Server so that the agent instance
can initiate data collection from the Foglight Experience Monitor appliance.
To configure Agent Properties:
1 In the Agent Status dashboard, select the agent for which you want to configure properties.
2 Click Edit Properties.
The Agent Status page appears.
16
3 From the Property Scope area, select Modify properties for this agent only.
The FxM Appliance fields appear.

4 In the IP Address box, type the IP address of the Foglight Experience Monitor appliance.
5 In the Database user password box, type the password of the database that was enabled on
the FxM Appliances Configure > Appliance > Database page.
17
For more information see Configuring the Database Settings on page 19 and Configuring
Remote Database Access in the Foglight Experience Monitor Installation and
Administration Guide.
6 Optionally, in the Web Console URL field, type the URL of the Foglight Experience Monitor
Web console. If this box is left empty, Foglight uses the IP address of the Foglight
Experience Monitor appliance and the control port 80.
Important If you override the Web Console URL, you must enter the full URL including the protocol.
If a port other than 80 is needed, it should also be part of the URL. For example, entering
"http://myfxmappliance.quest.corp" or "http://10.4.4.168:81" are proper entries.
7 Click Save.
8 Click Back To Agent Status.
You are returned to the Agent Status page.
Activating the Agent

After the agent has been created and the properties have been configured, you activate the agent.
To activate the agent:
1 Select the agent name that you just created.
18
For example, FxMAppliance.

2 Click Activate.
The Agent Operation dialog box appears with the agent status.
3 Click OK.
The dialog closes and you are returned to the Agent Status dashboard. Data collection is
enabled.
The Agent Operation box appears.
4 Click OK.
Configuring Foglight Experience Appliance Settings

Before the Foglight Experience Monitor and the Foglight Management Server can communicate,
you need to configure connectivity information on the appliance. For more information about
configuring the appliance settings, see the Foglight Experience Monitor Installation and
Administration Guide.
To configure the Foglight Experience Monitor Appliance, perform the following procedures:
Configuring the Foglight IP Settings on the Foglight Experience Monitor Appliance on
page 18
Configuring the Database Settings on page 19
Configuring the Metric Data Settings on page 20
Configuring the Foglight IP Settings on the Foglight Experience Monitor

Appliance
You can enable the communication between the FxM appliance and a Foglight Management
Server by configuring the network settings for the appliance (navigate to Configure > Appliance >
Network Settings in the FxM Web console). If Foglight Experience Monitor is set up as a multi-
19
tier configuration, ensure that you use the IP address of the Portal in the URL used to access the
appliance.
High Availability functionality is available when you type a comma-delimited list of IP address for
the Foglight Management Servers to which you are connected. For example, on the Network
Settings page, type the following Foglight Server IP addresses XXX.XXX.X.X, xxx.xxx.x.x. Use
8080 for the Foglight Server Port, or the port number that is used to connect to the Foglight
Management Server.
To configure Foglight settings:
1 In a Web browser, enter the IP address for the FxM appliance.
2 Log in to the Foglight Experience Monitor Web console.
3 On the main menu, click Configure > Appliance > Network Settings.
The Network Settings page appears.

4 In the Foglight Server IP box, type the IP address for the Foglight Management Server with
which the appliance is communicating.

5 In the Foglight Server Port box, type the control port number that the appliance uses to
communicate with the Foglight Management Server.

By default the port setting is 8080.
6 Click Apply.
Configuring the Database Settings

Configuring the database setting allows data to flow from the appliance to the Foglight
Management Server.
To configure the database settings:
1 On the Foglight Experience Monitor, navigate to Configure > Appliance > Database.
2 On the Database page, click the Remote Access link.

3 Select the Enable remote database access for SQL user dbusercheck box.
4 In the Password box, type a password that will be used with the dbuser account.
5 Click OK.
Configuring the Metric Data Settings

The metric data settings allow you to select which metric categories are sent to the Foglight
Management Server.
To configure the metric data settings:
1 On the Foglight Experience Monitor, navigate to Configure > Reporting > Foglight
Metrics.
2 Select the add link at the bottom of the metric category that you want to configure (for
example, Add City). You may have to scroll down to view this link.
The Resource List opens.

3 From the Resource List, select the metrics that you want available to the Foglight
Management Server.
20
21
The selected metric is displayed in the Foglight Metrics page, under its corresponding metric
category.
Upgrading the Cartridge for FxM

To upgrade the Cartridge for FxM, perform the following steps:
1 Deactivating the FxM Agents on page 21
2 Upgrading the Foglight Experience Monitor on page 22
3 Upgrading the Foglight Management Server on page 22
4 Upgrading the Cartridge for FxM on page 22
5 Deploying and Updating the Agent Package on page 22
6 Creating, Configuring, and Activating the FxM Agent on page 23
Deactivating the FxM Agents

Before you upgrade the Foglight Experience Monitor or install the Cartridge for FxM version, you
must deactivate all FxM Agents running on the agent host machine.
To deactivate the FxM Agents:
1 On the host machine, under Dashboards click Administration > Agents > Agent Status.
2 Select the required agent(s) and click Deactivate.
22
Upgrading the Foglight Experience Monitor

Important To avoid losing any data, you must upgrade the Foglight Management Server, the Cartridge for
FxM, and the Foglight Experience Monitor. For information about version upgrade and
compatibility, see the Foglight Experience Monitor Release Notes, which is available on http://
support.quest.com.
You upgrade the Foglight Experience Monitor by referring to the instructions in one of the
following guides found on SupportLink:
Cartridge for FxM Appliance Upgrade Installation and Configuration Guide
or
Foglight Experience Monitor Installation and Administration Guide

Important Before you upgrade the appliance, create a full system backup of the appliance. For more
information see, Backing Up and Restoring Data in the Foglight Experience Monitor Installation
and Administration Guide.
After you finish upgrading the Foglight Experience Monitor appliance, you need to configure the
settings so that the Cartridge for FxM and the Foglight Management Server can communicate. For
more information, see Configuring Foglight Experience Appliance Settings on page 18.
Upgrading the Foglight Management Server

If you have an existing version of the Foglight Management Server installed, ensure that you have
upgraded it to the latest version. For more information about upgrading the Foglight Management
Server, see the Foglight Upgrade Guide.
Upgrading the End User Core Cartridge

After upgrading the Foglight Management Server, install the EU-Core-5_6_5.car file on the
Foglight Management Server. For more information, see Installing the End User Core Cartridge
on page 7.
Upgrading the Cartridge for FxM

After upgrading the Foglight Management Server, you install the EU-FXM-5_6_5.car file on the
Foglight Management Server. For more information, see Installing the Cartridge for FxM on
page 11.
Deploying and Updating the Agent Package

Note
Before deploying the agent package, ensure that the version of the Foglight Agent Manager
(FglAM) is correct.
23
To deploy and update agent packages:

2 Under Dashboards, navigate to Administration > Agents > Agent Status.
3 Click Deploy Agent Package.
4 In the Host list, select the monitored host where you want to deploy the agent package.
Note
In versions 5.5.4 and later, this is never the FxM machine. Typically, the agent package
would be deployed on the host running the Foglight Management Server.
5 Select the FxM-FglAM-Agent.gar package that you want to deploy on the monitored host.
6 Click Deploy.
Creating, Configuring, and Activating the FxM Agent

Note the following before beginning these procedures:
You do not need to perform the following procedures if you have already created an FxM
Agent.
If you have already installed an FxM Agent, you need to upgrade the Foglight Agent
Manager (FglAM) to the correct version.
To create, configure, and activate the FxM Agent:
1 Under Dashboards, navigate to End User > FxM > FxM System Health page and write
down the name of the existing FxM system name.

Important Use the existing FxM system name when naming the new FxM Agent. If you do not use
the same FxM system name, data may be lost during the upgrade process.
2 From the Agent Status page, click Create Agent to create the FxM Agent.
Tip
To create agent instances on multiple hosts, navigate to the Agent Hosts dashboard by
clicking Agent Hosts in the Create Agent dialog box.
4 In the Agent Type box, select FxM.
The list of available agent types reflects the cartridges that have been installed and enabled
on the Foglight Management Server and whose packages are deployed to the monitored host.
5 In the Instance Name box, type the system name that you wrote down in step 1.
6 Click Create.
The new agent appears in the Agent Status dashboard. A green check mark indicates the
success of the operation.
7 Click OK.
8 From the Agent Status page, select the agent page and click Edit Properties to configure the
Agent Properties.
9 Click Modify properties for this agent only.
10 Configure the IP address and the database password.

11 Click Back to Agent Status.

12 Click Activate to activate the FxM Agent.
13 Click Start Data Collection to start the data collection process.
24
3
Installing the Cartridge for FxV
Successful Foglight-FxV integration requires the correct product versions. Although essential
compatibility information is listed here, refer to the Foglight Experience Viewer Release Notes for
complete compatibility information. This document can be found on Quest Softwares
SupportLink site: http://support.quest.com.
Installing and Configuring the Cartridge for FxV

The following steps are required to install and configure the Cartridge for FxV:
1 Install and enable the Core End User (EU-Core) cartridge on the Foglight Management
Server, see Installing the End User Core Cartridge on page 7.

2 Install and enable the Cartridge for FxV on the Foglight Management Server, see Installing
the Cartridge for FxV on Foglight on page 25.

3 Configure the FxV appliance to send data to the cartridge on the Foglight Management
Server, see Configuring the FxV Appliance to Send Data to the FxV Cartridge on page 27.
Installing the Cartridge for FxV on Foglight

The following procedure installs the Cartridge for FxV.
Note
If you have already installed and configured the Cartridge for FTR or the Cartridge for FxM, the
EU-Core cartridge is already present on your Foglight Management Server. It is recommended
that you install the latest version of the EU-Core cartridge on your system.
To install the Cartridge for FxV:

To open the navigation panel, click the right-facing
arrow on the left.
3 On the navigation panel, under Dashboards, navigate to Administration > Cartridges >
4 If the CAR file (EU-FXV-5_6_5.car) resides in a location that you can access from your
local computer:
26
Chapter 3Installing the Cartridge for FxV

b Click Browse, navigate to and select the EU-FXV-5_6_5.car, and click Open.
c The File on Local Computer dialog box refreshes, showing the full path to the CAR file.
or
If the CAR (EU-FXV-5_6_5.car) resides in a location that you can access from your local
computer:
directory.
Optional. To enable the cartridge immediately after its installation, select the Enable on
install check box.
Alternatively, you can enable the cartridge at a later time. Ensure that the Enable on install
check box is cleared, and follow the instructions in Enabling the Cartridges on page 26
after the cartridge installation.
Click OK.
6 To refresh the view of the cartridges, click
Enabling the Cartridges

Enabling a cartridge makes the cartridges components available for use. The following procedure
should be performed only if you did not enable your cartridges during the installation process, as
outlined in step in Installing the Cartridge for FxV on Foglight.
Note
can be found in the Installing and Managing Cartridges chapter in the Foglight Administration
The Status column contain icons that indicate if a cartridge is enabled or disabled.
3 Select one or more disabled cartridges in the table that you want to enable.

5 Click OK.
Configuring the FxV Appliance to Send Data to the FxV Cartridge

Enabling a cartridge completes the process of adding it to the Foglight Management Server, by
making the cartridges components available for use. The final step is configuring the Foglight
Experience Viewer appliance to send data to the FxV Cartridge on the Foglight Management
Server.
To configure Foglight Experience Viewer appliance to communicate with the Foglight
Management Server:
1 In a Web browser, enter the URL for the FxV appliance.
27
28
For example, http://192.168.1.1/console or https://192.168.1.1/console.

Note
If your system is configured not to use the default http or https ports (80/443 respectively)
you need to add the port numbers to the URLs as follows:
http://192.168.1.1:7630/console
https://192.168.1.1:7643/console
2 Log in to the FxV browser interface as a user with administrative privileges.

3 On the menu bar, click Configure > Superuser Tasks.
4 Click Manage Foglight Integration to display the configuration page.
5 Type the IP address and port number of the Foglight Management Server in the FMS Hosts
For Metric Updates field.

6 Click OK.
The Foglight Experience Viewer appliance should now begin to send data to the Cartridge
for FxV on the Foglight Management Server. After a short delay, the pre-configured
dashboards that ship with the cartridge start to display data.
4
Installing the Cartridge for FTR and Its
Components
This chapter provides the procedures necessary to install and configure the components required to
record scripts with the Foglight Transaction Recorder, upload those scripts to the Foglight, and
configure the scripts for playback on Foglight for end user monitoring.
Foglight Transaction Recorder System Requirements

The following lists provide system requirements for the Foglight Transaction Recorder.
Note
The Foglight Transaction Player requires the 32-bit Foglight Agent Manager (FglAM).
Software
Foglight Transaction Recorder and Tevron CitraTest software requirements:
Microsoft Windows XP Professional, Windows Server 2003, Windows Vista, Windows
Server 2008, Windows 7, and Windows Server 2008 R2
Internet Explorer version 6.x or later
Windows .Net Framework 2.0 (install if not present)
WinPcap 4.1.2 (install if not present)
CitraTest version 751e1 is required for thick client monitoring
Note
Microsoft Visual Basic is only required if you want to compile or edit CitraTest scripts with
Visual Basic instead of using the .NET compiler.
Hardware
You need the following minimum hardware requirements:
1 GB of RAM
1.5 GHz Processor
30
Chapter 4Installing the Cartridge for FTR and Its Components
The hardware requirements listed in this section represent the minimum requirements for a
machine running a single Transaction Player agent configured for one worker process (a client
machine running one Foglight Transaction Recorder script at a time).
Installing the Foglight Transaction Recorder on Windows Vista or

Newer Operating Systems
When installing the Foglight Transaction Recorder on Windows Vista or a newer operating
system, you must save the installation files to the local machine and run the process as a user with
administrative privileges.
Upgrading and Using Existing FTR Scripts from SPID to the Foglight
Agent Manager
Previous versions of the Cartridge for Foglight Transaction Recorder used SPID to upload scripts
to Foglight from the Foglight Transaction Recorder. Foglight 5.5.5 and later versions use the
Foglight Agent Manager (FglAM) to upload the recorded scripts. When the EU-Core-5_6_5.car
installs, a new FglAM script list is created for any existing SPID script list when there is no
FglAM script list with the same name. Changes made to the SPID script list after the upgrade
will not be reflected in the FglAM list. The SPID script list and the FglAM script list are not
connected. A copy of the SPID list is made only when the upgrade of the EU-FTR Cartridge is
performed.
Installing and Configuring the Cartridge for FTR and Its

Components
To install the Foglight Transaction Recorder, Tevron CitraTest, and the Cartridge for Foglight
Transaction Player, and upload recorded scripts to Foglight, perform the following steps:
1 Install and enable the EU-Core cartridge on the Foglight Management Server, see Installing
and Enabling the EU-Core Cartridge on the Foglight Management Server on page 31.
2 Install and enable the EU-FTR cartridge on Foglight Management Server, see Installing and
Enabling the Cartridge for FTR on the Foglight Management Server on page 31.
3 Install the Foglight Transaction Player/Agent and Web Content on the client machine, see
Installing the Foglight Transaction Recorder, Player, and Agent on page 33.
For procedures on upgrading the Foglight Transaction Recorder and Transaction Player
Agent see Upgrading the Foglight Transaction Recorder and Transaction Player Agent
on page 35.
Optional: If you want to record thick client scripts, install Tevron Citra Test, see
Installing Tevron CitraTest to Record Thick Client Applications on page 36.
31
4 Deploying the Foglight Transaction Player (FTR) Agent Package, see Deploying the
Foglight Transaction Player Agent Package on page 40.

5 Creating, configuring, and activating the Foglight Transaction Player (FTP) Agent, see
Creating, Configuring, and Activating the Foglight Transaction Recorder (FTR) Agent on
page 41.
6 Publish the Foglight Transaction Recorder scripts to the EU-FTR Agent, see Publishing
Foglight Transaction Recorder Scripts to Foglight on page 44.

7 Configure the Transaction Player Agent to replay published scripts on Foglight, see
Configuring the Transaction Player Agent on Foglight to Replay Scripts on page 46.
Installing and Enabling the EU-Core Cartridge on the Foglight Management

Server
For EU-Core Cartridge installation and enabling procedures see, Installing the End User Core
Cartridge on page 7.
Installing and Enabling the Cartridge for FTR on the Foglight Management
Server
The EU-FTR cartridge provides the downloadable files containing the Foglight Transaction
Recorder Player, Foglight Transaction Player Agent, and Tevron CitraTest. The following
procedures install the Cartridge for FTR on the Foglight Management Server.
Note
If you have already installed and configured the Cartridge for FxV or the Cartridge for FxM, the
EU-Core cartridge is already present on your Foglight Management Server. It is recommended
that you install the latest version of the EU-Core cartridge.
To install the Cartridge for FTR:

To open the navigation panel, click the right-facing
arrow on the left.
4 In the Install Cartridge area, complete one of the following steps:
a Select the File on Local Computer option if the CAR (EU-FTR-5_6_5.car) resides in a
location that you can access from your local computer, specify the path and name of the
CAR file.
b Click Browse and navigate to the CAR file using the file browser and select the .car.
c Click Open.
32
d The File on Local Computer box refreshes, showing the full path to the CAR file.
or
a Select the File on Server option if the CAR file resides on the computer hosting the

b Specify its path and name.
Optional. To enable the cartridge immediately after its installation, select the Enable on
install check box.
Alternatively, you can enable the cartridge at a later time. To do that, ensure that the Enable
on install check box is cleared, and follow the instructions in Enabling the Cartridge on
6 Click OK.
7 To refresh the view of the cartridges, click
Enabling the Cartridge
Enabling a cartridge makes the cartridges components available for use. The following procedure
should be performed only if you did not enable your cartridges during the installation process as
outlined in step in Installing and Enabling the Cartridge for FTR on the Foglight Management
Server on page 31.
Note
can be found under Installing and Managing Cartridges chapter in the Foglight Administration
The Status column contain icons that indicate if a cartridge is enabled or disabled.
3 Select one or more disabled cartridges in the table that you want to enable.
33
5 Click OK.
Installing the Foglight Transaction Recorder, Player, and Agent

Note
Due to the possibility of conflicts with other applications, using too many resources, DLL
conflicts, and desktop instability, it is recommended that the Foglight Transaction Recorder be
installed on a dedicated machine.
After installing and enabling the cartridge for FTR on the Foglight Management Server, you install
the Foglight Transaction Recorder, Player, and Agent.

To install the Foglight Transaction Recorder, Player, and Agent:

1 In the Foglight browser interface, click Dashboards > Administration > Cartridges.
2 Click Components for Download.
3 Click FTR Recorder and Player.
The file downloads and the Internet Security dialog appears.

4 Click Run.
5 Click Run.
The InstallShield Wizard dialog appears.

6 Click Next.
The Licenses Agreement dialog appears.

7 Accept the license terms and click Next.
The Select Features dialog appears.

8 Select the Transaction Recorder, Transaction Player Agent, and FTR Agent Web
Content check boxes.
9 Click Next.
34
35
The Choose Destination Location folder appears.

10 Click Next.
The Select Program Folder appears.

11 Click Next.
The Setup Status dialog appears, then the WinPcap Setup dialog appears.
Note
If the WinCap is already installed, continue with step step 19. If the WinCap is not
installed, the WinCap wizard appears. Continue with step 11.
12 Click Next.
The WinPcap 4.1.2 Setup Wizard dialog appears.

13 Click Next.
The WinPcap Licenses Agreement dialog appears.

14 Click I Agree.
The WinPcap Setup dialog appears.

15 Click Yes.
The WinPcap Setup dialog appears.

16 Click OK.
17 Click Next.
18 Click Finish.
WinPcap installs and the setup completion dialog appears.

19 Click Finish.
The Foglight Transaction Player setup status dialog appears, the Recorder/Player installation
process continues, and the Configure Apache dialog appears.
20 Accept the default port setting and click Next.
The Apache Server configures and the InstallShield Wizard completion dialog appears.
21 Click Finish.
The Starting Apache Web Server dialog appears.
Upgrading the Foglight Transaction Recorder and Transaction Player Agent

Upgrading the Foglight Transaction Recorder and Transaction Player Agent requires the following
procedures.
To upgrade the Foglight Transaction Recorder and Transaction Player Agent:
1 Uninstall the old version of the Foglight Transaction Recorder and Transaction Player Agent.
2 Reboot the machine.
3 Install the new version.
36
Installing Tevron CitraTest to Record Thick Client Applications

Note
The operating system and video settings for the machine running the Foglight Transaction
Recorder and the machine running the Foglight Transaction Player agent must be the same. For
detailed information, refer to Consistent Display Property Settings When Using CitraTest,
Running CitraTest Scripts with CitraTest, and Video Settings for procedures.
To use the Foglight Transaction Recorder to record thick client applications, you must install the
following:
For the recording machine:
Foglight Transaction Recorder and Foglight Transaction Player
The CitraTest recording environment
For the playback/client machine:
Foglight Transaction Player on the Foglight Client machine
The CitraTest playback environment
Installing the CitraTest Recording Environment

The following provides procedures on installing the CitraTest recording environment.
Note
CitraTest version 751e1 or later is required for thick client monitoring.
To install the CitraTest recording environment:

1 On the navigation panel, click Dashboards > Administration > Cartridges.
2 Click Components for Download.
3 Click CitraTest.
4 Click Run.
5 Click Run.
The CitraTest Install Wizard appears.

6 Click Next, then select the I accept the terms of the license agreement option button.
7 Click Next.
8 The Customer Information dialog appears.
9 Enter the user and company name, then click Next, and select CitraTest Full Script
Development setup.
37
10 Click Next.
The Choose Destination Location dialog appears.

11 Click Next.
The Ready to Install the Program dialog appears.

12 Click Install.
CitraTest installs. After installation, the IntallShield Wizard Complete dialog appears.
13 Click Finish.
14 Navigate to the CitraTest ID file located in C:\Program Files\Citra Test.
15 Double-click GenerateMachineID.
This generates the CitraID file.

16 Email the CitraID file to support@tevron.com.
The CitraTest license key will be emailed back to you. Copy and paste this license key into
C:\Program Files\Citra Test.
Installing the CitraTest Playback Environment

The CitraTest playback environment is included in the CitraTest Full Script Development install.
The following provides procedures on installing only the CitraTest playback environment.
To install the CitraTest playback environment:
Components for Download.

2 Click CitraTest.
3 Click Run.
4 Click Run.
The CitraTest Install Wizard appears.

5 Click Next, then select the I accept the terms of the license agreement radio button.
6 Click Next.
7 The Customer Information dialog appears.
8 Enter the user and company name, then click Next.
9 Select CitraTest Playback Only.
38
10 Click Next.
After installation, the IntallShield Wizard Complete dialog appears.

11 Click Finish.
12 Navigate to the CitraTest ID file located in C:\Program Files\Citra Test and double-click the
GenerateMachineID.
This generates the CitraID file.
13 Email the Citra Test file to support@tevron.com.
The CitraTest license key will be emailed back to you. Copy and paste this license key into
C:\Program Files\Citra Test.
14 You must remove the CitraTest Agent from the Startup Group. Select Start > Programs >
Startup. Drag and drop the CitraTest Agent on the desktop or Recyle Bin.
Consistent Display Property Settings When Using CitraTest

CitraTest uses image matching. It is vital that all systems running scripts render the images as they
were displayed on the development machine. You must ensure that all systems have identical:
Operating systems
Screen resolution
Color depth
Other configurable settings, such as background, appearance, and effects that also affect the
display. Screen resolution and color depth are hardware dependent. Changing the operating system
can affect recording results. Scripts should be written and tested on the same machine as outlined
above.
Running CitraTest Scripts with CitraTest
CitraTest requires control of the desktop. When a CitraTest script is running, the machine cannot
be used for any other purpose. For this reason, and because of the requirement for consistent
desktop Display Property settings, VMWare or VirtualPC are useful tools. You can create a virtual
machine with a base configuration, which can be used to run Foglight Transaction Player agents.
This provides consistent video, and allows the virtual machine to be minimized while scripts are
executing, freeing up the machine for other use.
39
Video Settings
Note
The video setting requirements pertain to thick client testing using CitraTest. They are not
required when recording thin client scripts.
The video settings for the machine running the Foglight Transaction Recorder and the Foglight
Transaction Recorder Agent must be the same. The following procedures use Windows XP
Professional as the operating system.
To set the video settings:
1 Click Start > Control Panel > Display.
2 Select the Settings tab.
3 Set the desired Screen resolution.
This setting must be the same on the machine running the Foglight Transaction Recorder and
the machine running the Foglight Transaction Recorder Agent.
4 Set the desired Color quality.
This setting must be the same on the machine running the Foglight Transaction Recorder and
the machine running the Foglight Transaction Player Agent.
5 Select Appearance > Effects.

6 Set the desired settings for transition effect and smooth edges.
7 Click OK > OK.
40
Deploying the Foglight Transaction Player Agent Package

The following provides procedures to deploy the Foglight Transaction Recorder Agent.
Note
The EU-FTR Agent Package must be deployed before creating the EU-FTR Agent.
To deploy the Foglight Transaction Player agent package:

1 On the navigation panel, click Administration > Agents > Agent Status.
2 In the Agent Status dashboard, click Deploy Agent Package in the lower-left corner.
The Deploy Agent Package dialog box appears.

Note
In order to select the host, the Foglight Agent Manager must be running and available on
the monitored host. To deploy an agent package to multiple hosts, navigate to the Agent
Hosts dashboard by clicking Agent Hosts in the Deploy Agent Package dialog box.
3 In the Host list, select the monitored host where you want to deploy the agent package.
4 In the Package list, select the FTR-FglAM-Agent.gar package to deploy on the monitored
host.
5 Optionally, you can show agent packages that can be deployed on any platform by selecting
the Show Packages for All Platforms check box.

Tip
You can only deploy agent packages whose cartridges are already installed on the
6 Click Deploy.
41
The Deploy Agent Package dialog box refreshes, showing the status of the deployment
operation. A green check mark indicates the success of the deployment operation.
7 Click OK.
Creating, Configuring, and Activating the Foglight Transaction Recorder (FTR)

Agent
Foglight uses adaptors to communicate with agents that collect information from monitored hosts.
The following steps allow you to create, configure, and activate the FTP Agent adapter:
1 Creating and Configuring the Foglight Transaction Player Agent
2 Activating the Agent
Creating and Configuring the Foglight Transaction Player Agent

The Agent Status dashboard allows you to view information about agents, as well as perform
agent-related operations, such as deploy agent packages, activate and deactivate agents, start and
stop data collections for one or more agent instances, and view information about agents. For more
information about these operations see the Foglight Administration and Configuration Guide.
Note
The FTR Agent version 5.5.5 and higher uses the Foglight Agent Manager (FglAM).
To create and configure the FTR Agent:

1 Log in to the Foglight browser interface and ensure that the navigation panel is open.
on the left.
2 On the navigation panel, under Dashboards, navigate to Administration > Agents > Agent
Status.
The Agent Status page appears displaying all agents installed on the Foglight Management
Server.
3 Click Create Agent.
42
The Create Agent dialog dialog appears.
Tip
To create agent instances on multiple hosts, navigate to the Agent Hosts dashboard by
clicking Agent Hosts in the Create Agent dialog box.
After you have selected a host, the Agent Type box populates with all agents that deployed
on that host. (This means that you can create agent instances of the FTP Agent whose
package has been deployed to the selected host).
5 In the Agent Type box, select FTR.
The list of available agent types reflects the cartridges that have been installed and enabled
on the Foglight Management Server, and whose packages are deployed to the monitored
host.
6 In the Instance Name box, type a display name for the agent.
For example, FTRAgent.

7 Click Create.
The new agent appears in the Agent Status dashboard. A green check mark appears
indicating the success of the operation.
8 Click OK.
The Create Agent dialog box closes and the newly-created FTR agent instance appears
selected on the Agent Status dashboard.
43
44
Activating the Agent

After the agent has been created and the properties have been configured you activate the agent.
To activate the agent:
1 Select the agent name that you just created.
For example, FTRAgent.

2 Click Activate.
The Agent Operation dialog box appears with the agent status.
3 Click OK.
The dialog closes and you are returned to the Agent Status dashboard. Data collection is
enabled.
The Agent Operation box appears.
4 Click OK.
Publishing Foglight Transaction Recorder Scripts to Foglight

Note
Before scripts can be published to Foglight, the Foglight Management Server must be started.
After recording, Foglight Transaction Recorder scripts are published to Foglight for playback on
the Transaction Player Agent.
Note
The Foglight Transaction Recorder online help and User Guide provide complete procedures on
using the Foglight Transaction Recorder.
To publish scripts to Foglight from the Foglight Transaction Recorder:

1 From the Foglight Transaction Recorder, click Publish
The Publish Script dialog appears.

2 Click Add Location
The Manage Locations Setting dialog appears.
3 Click Add.
The Add Location dialog appears.

The following provides field descriptions:

Field
Description
Name
The location name the Foglight Transaction Recorder uses.
Foglight
Server
Foglight Server name.

For example, abc10678.prod.acme.corp:8080.
Server
Version
Foglight Server version.
Path to
Projects
The directory on the server where the scripts are stored. (Foglight 4 and
earlier server versions only).
User Name
Foglight server user name.
Password
Foglight server password.
Requires
SSL
Select the check box to implement a Secure Sockets Layer.
4 Enter the connection information.
45
46
5 Click OK.
The Manage Locations Setting dialog appears.

6 Check the desired location in Location Name.
7 Click OK.
The Publish Script dialog appears.

8 Verify that the new location is displayed in the location.
9 Enter a script name File Name.
10 Click Save.
The script publishes to the designated Foglight server.
Configuring the Transaction Player Agent on Foglight to Replay Scripts

The Foglight Transaction Player Agent must be configured to playback scripts uploaded from the
Foglight Transaction Recorder. For procedures on publishing scripts to Foglight from the Foglight
Transaction Recorder, see Publishing Foglight Transaction Recorder Scripts to Foglight on
page 44.
To configure scripts for playback on Foglight:
1 On the navigation panel, click Dashboards > Administration > Agent > Agent Status.
2 Click the agent that you want to configure.
47
3 Click Edit Properties.

4 Click Modify properties for this agent only.
The Configuration view dialog appears.
Field
Description
Base Agent URL
The root URL for the Intelligent Agent if installed with the Foglight
Transaction Recorder binaries. Typically, it is in the format of http://
machinename:port. The port is only necessary if the Intelligent Agent
is configured to run on a port other than 80.
Location Name
The logical location name for where the scripts are being played back,
for example, St. Louis, New York, or Paris.
Country Name
Name of a country where the scripts are being played back.
48
Field
Description
Region Name
Name of a region where the scripts are being played back.
City Name
Name of a city where the scripts are being played back.
Script List
Script Listlist of scripts for this agent instance to run. You can
choose from all scripts published to the server.
Editallows you to edit the script list.
Cloneclones the script list.
Deleteremoves script list.
Play Script as
User
Allows the playback of a script as a particular user account, instead of

the default local system.
User Name
User name used when playing scripts as a particular user.
Password
Server password. The username password from the credentials for the
user to playback scripts.
Domain
The domain of the user, used to playback scripts.

The domain is necessary even if the user is a local machine user. In
that case, the domain is the agent machine name.
Number of
Worker
Processes
Number of worker processes used to set an upper limit on the number

of scripts that can be played back simultaneously by this agent
instance. It does not force simultaneous playback, rather it allows it up
to the number specified, when needed.
5 From the Script List, select a list to which you want to add your script.
Note
To create a new script list, use the Clone button to create a copy of a blank or populated
list.
6 Click Edit.
The FTR Script List dialog appears.
49
7 Click Add Row.
A row is added to the list.
Field
Description
Enable
Enables the script to run once it is uploaded.
Script
From this list, you select the script you published from the Foglight
Transaction Recorder.
Expected Time
When set to zero, the script uses the Expected Time (response time)
values set in the script. Otherwise this value overrides the Expected
Time values set in the script. The Expected Time of Transactions in the
script is altered by the same ratio as the value set here. If the script has
an Expected Time of 30 seconds and this value is set to 45 seconds, all
transactions in the script are altered by 150 percent (45 seconds/30
seconds).
Sample Interval
The interval time between script runs.
8 Select the script you want to run on from the Foglight Transaction Recorder Player agent.
50
9 Select the check box to enable the script, or clear it to disable the script.
10 Click inside Expected Time to set the desired Expected Time.
11 Click inside Sample Interval to set the desired Sample Interval.

12 Click Save Changes.
13 Click the close button in the upper right corner of the dialog.
The uploaded script is now available to run on the Foglight Transaction Recorder agent and
collect end user data.
51
Index
A
agent
activation 41
configuring 13, 41
creating 13, 41
agent package
deploying 12
C
cartridges
enabling 8, 32
installing and configuring the Cartridge for FTR and its
components 30
installing the Cartridge for FxV 27
Installing the End User Core Cartridge 7
upgrading the Cartridge for FxM 21
D
deploying
Foglight Experience Monitor Agent Package 12
Foglight Transaction Player Agent Package 40
E
enabling cartridges 32
F
Foglight Agent Manager
installing 7
upgrading to from SPID 30
version 11
Foglight Experience Monitor
database settings 19
metric data 20
Foglight Experience Monitor Appliance
configuring the database settings 19
configuring the Foglight IP settings 18
configuring the metric data settings 20
upgrading the cartridge 21
Foglight Experience Viewer

configuring to send data to the FxV Cartridge 27
Foglight Transaction Player Overview 44
Foglight Transaction Recorder
configuring on Foglight to replay scripts 46
creating, configuring, and activating the agent 41
installing and configuring 30
installing on Vista or newer operating system 30
publishing Foglight Transaction Recorder scripts to the
Foglight Management Server 44
system requirements 29
upgrading from SPID to the Foglight Agent Manager 30
Foglight Transaction Recorder, Player, and Agent
installation 33
I
installation
Cartridge for FTR and its components 30
Cartridge for FxM 10
Cartridge for FxV 25
End User Core Cartridge 7
overview 10, 25
installation and setup 30
installing the Foglight Transaction Recorder/Player and
Agent 33
P
publishing the Foglight Transaction Recorder scripts to
Foglight 44
R
requirements and compatibility 10
S
SPID
upgrading to Foglight Agent Manager 30
support 6

Index
T
technical support 6
Tevron CitraTest
consistent display settings 38
installing to record thick client scripts 36
running CitraTest scripts with CitraTest 38
video settings 39
U
upgrade
Foglight Experience Monitor 22
V
verifying the Foglight Agent Manager version 11
W
Windows Vista
Foglight Transaction Recorder installation 30
52

EndUserMonitoring Install

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

EndUserMonitoring Install

Transféré par

Droits d'auteur :

Formats disponibles

Foglight

End User Monitoring

2012 Quest Software, Inc.

Third Party Contributions

Installation and Configuration Guide

End User Monitoring: Installation and Configuration Guide

Installing the End User Core Cartridge.............................................................................................................................7

Installing the Cartridge for FxM.......................................................................................................................................10

Installing the Cartridge for FxV .......................................................................................................................................25

Installing the Cartridge for FTR and Its Components ...................................................................................................29

End User Monitoring: Installation and Configuration Guide

Introduction to this Guide

Foglight Transaction Recorder:

About Quest Software, Inc.

End User Monitoring: Installation and Configuration Guide

Introduction to this Guide

Contacting Quest Software

Quest Software, Inc.

Contacting Quest Support

Installing the Foglight Agent Manager

Installing the End User Core Cartridge

End User Monitoring: Installation and Configuration Guide

Chapter 1Installing the End User Core Cartridge

To install the End User Cartridge:

To open the navigation panel, click the right-facing arrow

in the upper-right corner.

Enabling the Cartridges

End User Monitoring: Installation and Configuration Guide

Installing and Configuring the Cartridge for FxM

End User Monitoring: Installation and Configuration Guide

Chapter 2Installing the Cartridge for FxM

Verifying the Foglight Agent Manager Version

Installing the Cartridge for FxM

To open the navigation panel, click the right-facing arrow

install check box.

End User Monitoring: Installation and Configuration Guide

Chapter 2Installing the Cartridge for FxM

8 To refresh the cartridge list, click

in the upper-right corner.

Deploying the Foglight Experience Monitor (FxM) Agent Package

The Deploy Agent Package dialog box appears.

End User Monitoring: Installation and Configuration Guide

Chapter 2Installing the Cartridge for FxM

Creating, Configuring, and Activating the Foglight Experience Monitor (FxM)

Creating the Foglight Experience Monitor (FxM) Agent

To create the FxM Agent:

To open the navigation panel, click the right-facing arrow

The Create Agent dialog box appears.

End User Monitoring: Installation and Configuration Guide

Chapter 2Installing the Cartridge for FxM

For example, FxMAppliance.

End User Monitoring: Installation and Configuration Guide

Chapter 2Installing the Cartridge for FxM

Configuring Agent Properties

2 Click Edit Properties.

The Agent Status page appears.

End User Monitoring: Installation and Configuration Guide

Chapter 2Installing the Cartridge for FxM

The FxM Appliance fields appear.

the FxM Appliances Configure > Appliance > Database page.

End User Monitoring: Installation and Configuration Guide

Chapter 2Installing the Cartridge for FxM

You are returned to the Agent Status page.

Activating the Agent