Installation Guide for Goliath Logon Simulator for Citrix v1.0

Installation Guide for Goliath Logon Simulator for Citrix v1.0
Document Date: May 2015
www.goliathtechnologies.com
Legal Notices
Copyright © 2015 Goliath Technologies Inc. All rights reserved. www.goliathtechnologies.com
Goliath Technologies believes the information in this publication is accurate as of its publication date. The
information is subject to change without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS IS.” GOLIATH TECHNOLOGIES MAKES NO
REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION,
AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
PURPOSE.
Use, copying, and distribution of any Goliath Technologies software described in this publication requires an
applicable software license.
Linux is a registered trademark of Linus Torvalds.
Windows, Hyper-V, SQL Server and SQL Server Express are either trademarks or registered trademarks of Microsoft
Corporation.
Java is a registered trademark of Oracle Corporation.
VMware, vCenter, and vSphere are either trademarks or registered trademarks of VMware Corporation.
Citrix, NetScaler, Xen, XenServer, XenApp, XenDesktop and XenCenter are either trademarks or registered
trademarks of Citrix Systems, Inc.
All other trademarks and copyrights referred to are the property of their respective owners.
2
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
Contents
I.
Introduction to Goliath Logon Simulator for Citrix ........................................................................................... 4
II.
Deployment Architecture .................................................................................................................................. 5
A. Standalone .................................................................................................................................................5
B. Integrated with Goliath Performance Monitor .........................................................................................6
III. Goliath Logon Simulator for Citrix Prerequisites ............................................................................................... 7
IV. Deployment Scenarios....................................................................................................................................... 8
A. Logon Simulator Standalone: Testing the Citrix Delivery Infrastructure for Local and Remote Users .....8
B. Logon Simulator Integrated with GPM: End User Troubleshooting for Local and Remote Users ..........10
V.
Logon Simulator Server Installation ................................................................................................................ 12
VI. Prepare the Simulation Endpoint to Launch Simulations ............................................................................... 19
VII. Prepare the Citrix Environment for Logon Simulations................................................................................... 21
A. Deploy Agent to the Citrix Delivery Controller ........................................................................................21
B. Enable Logon Simulator Session Handler to Logoff sessions at the end of simulations ..........................23
VIII. Configure Simulations ..................................................................................................................................... 24
A. Create a new Citrix Logon Simulator Monitoring Rule .............................................................................24
B. Configure Scheduling ................................................................................................................................26
C. Testing the Simulations ............................................................................................................................27
D. Common Problems ...................................................................................................................................27
IX. Alerting ............................................................................................................................................................ 28
X.
Reporting ......................................................................................................................................................... 29
XI. Abbreviations and Acronyms .......................................................................................................................... 30
3
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
I.
Introduction to Goliath Logon Simulator for Citrix
The Goliath Logon Simulator enables a Citrix Administrator to:




Simulate the logon process locally, remotely, or in the cloud.
Generate failure and application/desktop availability alerts.
Identify the root cause of issues encounters.
Troubleshoot and resolve these issues prior to end users being impacted.
Much more than a point-in-time testing utility or traditional load testing tool, the Goliath Logon Simulator is a musthave proactive performance tool for Citrix Administrators that can be integrated into the ongoing IT operations
toolset.
When Citrix logon issues occur, they are usually a result of problems in one of these three areas:



Remote location connectivity.
Application or desktop availability
The Citrix delivery infrastructure
The Goliath Logon Simulator facilitates continuous and real-time testing of the Citrix delivery infrastructure by
simulating the exact same steps a user would take during the logon process. By launching real sessions with test
user accounts, the Goliath Logon Simulator provides visibility into all applications and desktops being launched and
whether they are succeeding, failing or slow. This allows the Goliath Logon Simulator to alert the Citrix administrator
to a problem the moment it occurs.
If there is a logon failure, an administrator will be alerted immediately and pinpoint where the failure occurred and
the root cause. In cases where the logon is simply slow, the administrator can see the breakdown of the logon
process, in real-time, to determine where in the process the slowness occurred. For example, group policy
processing, scripts and profile loading.
If you require assistance during the installation and configuration of the Logon Simulator, please contact Support
using the information below:
Goliath Logon Simulator Proof of Concept Limitations
Goliath Logon Simulator Proof of Concepts (POC) will be limited to launching a single Citrix XenApp or XenDesktop
application or desktop from one location.
If your evaluation or POC process requires a different configuration than the licensing allows for, please contact
your account manager or Goliath Sales or Support as follows for assistance:
Sales
Email: [email protected]
Phone: 1-855-465-4284
Support
Email: [email protected]
Phone: 1-855-465-4282
4
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
II.
Deployment Architecture
There are two different ways to deploy Logon Simulator:
A. Standalone
5
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
B. Integrated with Goliath Performance Monitor
LOGON SIMULATOR + PERFORMANCE MONITOR
INTEGRATED DEPLOYMENT ARCHITECTURE
GOLIATH INFRASTRUCTURE
REMOTE SQL SERVER *
MS SQL Server
2008 - 2014
WEB CONSOLE
Service Account
with DBO rights
TCP: 80
Configuration
Scheduling
Alert Configuration
Reporting
LOGON SIMULATOR &
PERFORMANCE MONITOR
SERVER
TCP: 82
Windows 2008R2 – 2012R2
Minimum of 4 vCPUs & 8 GB Memory
25 GB of Disk Space
.NET 3.5 SP1
TCP: 82
XENAPP SESSION
HOST
TCP: 82
TCP: 82
VDI
CITRIX DELIVERY CONTROLLERS
XENAPP ZDC/DC
**
4.5 – 7.6
.NET 3.5 SP1
TCP: 80/443
XENDESKTOP
DDC/DC
**
5.5 – 7.6
.NET 3.5 SP1
REMOTE CITRIX
ENVIROMENT
LOCAL CITRIX
ENVIROMENT
WORKSTATION
WORKSTATION
TCP
80/443
TCP
80/443
NETSCALER
SERVER
SERVER
TCP
80/443
TCP
80/443
STOREFRONT /
WEB INTERFACE
VM
VM
LEGEND
* Agents deployed to XenApp and XenDesktop controllers ensure simulated users are logging off correctly following simulations
** For evaluation, Goliath ships with embedded SQL Express 2008R2 database
NOTE: The ports and protocols displayed are the defaults. They can be modified if desired.
Citrix Receiver
Goliath Intelligent Agent: very light weight, it uses 0.1% CPU, 1.5 MB size on Disk, about 25 MB RAM
Goliath Logon Simulator Agent for Citrix
6
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
III.
Goliath Logon Simulator for Citrix Prerequisites
Table 1 - Goliath Logon Simulator Requirements
Goliath Logon Simulator Server
Platform: Virtual Machine or Physical Server
OS: Windows Server 2008 R2 – 2012 R2
Network: Static IP Address
vCPU: Minimum of 4 cores or vCPUs
Memory: Minimum of 8GB RAM
Disk: 25GB of disk space
Dependencies: .NET 3.5 SP1
Firewall: TCP ports 80 and 82. Both must be opened
inbound and port 80 must be enabled outbound for remote
access to the console. These ports can be changed from the
default as needed.
Optional: PDF Reader to view installed product
documentation
Simulation Endpoint
Citrix XenApp/XenDesktop Delivery
Controller
7
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
OS: Windows Server 2008 R2 – 2012 R2, Windows 7 – 8.1
Dependencies: GPM Agent deployed & .NET 3.5
Web Browser: Internet Explorer 11
Citrix Receiver: versions 4+
Citrix Account: Dedicated Citrix test account with rights to
applications or desktops to be launched
User Account Control: Disabled at the System level
IE Security: Disabled for trusted sites with Citrix Portal
added to whitelist
Firewall: TCP port 82 must be opened outbound. All ports
can be changed.
Dependencies: Intelligent Agent deployed to ZDC/ Delivery
Controller with the Logon Simulator Session Interface
Handler enabled
Citrix XenApp/XenDesktop 7.0-7.6: The Intelligent Agent
must run as a Windows Service account with Citrix Admin
read-only rights and local admin rights
Note: If using Windows Server 2012 or later, .NET 3.5
Feature must be installed.
IV.
Deployment Scenarios
There are two main deployment scenarios which you may choose when deploying the technology. These
scenarios, including the capabilities of each and the deployment architecture, are explained below:
 Standalone: Testing the Citrix Delivery Infrastructure for Local and Remote Users
 Integrated with GPM: End User Troubleshooting for Local and Remote Users
A. Logon Simulator Standalone: Testing the Citrix Delivery Infrastructure for Local and Remote
Users
In this use case the logon simulator agent is deployed on a server, workstation, or VM at the data center,
another office, or to remote users to execute the simulation. The simulator will go through the process of
connecting to a Citrix NetScaler or directly to the Citrix Web Interface or StoreFront and then launch the
application or desktop session to ensure availability.
A test in this manner allows an administrator to test and validate 3 main aspects of the logon and session
launch process:
1. The workflow to launch an application or desktop session is working
2. Users external to the Citrix architecture can access it successfully
3. Objective evidence of the time it takes for local and remote users to connect, specifically with regard
to location specific connection issues and delays. This provides defined data to determine if a location
is experiencing longer logon times than others, and then perform a logon analysis and produce a
report identifying the problem.
8
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
GOLIATH INFRASTRUCTURE
GOLIATH LOGON SIMULATOR
STANDALONE DEPLOYMENT ARCHITECTURE
REMOTE SQL SERVER *
MS SQL Server
2008 - 2014
Service Account
with DBO rights
WEB CONSOLE
TCP: 80
Configuration
Scheduling
Alert Configuration
Reporting
LOGON SIMULATOR SERVER
TCP: 82
Windows 2008R2 – 2012R2
Minimum of 4 vCPUs & 8 GB Memory
25 GB of Disk Space
.NET 3.5 SP1
TCP: 82
XA
TCP: 82
TCP: 82
VDI
CITRIX DELIVERY CONTROLLERS
XENAPP ZDC/DC
**
4.5 – 7.6
.NET 3.5 SP1
TCP: 80/443
XENDESKTOP
DDC/DC
**
5.5 – 7.6
.NET 3.5 SP1
REMOTE CITRIX
ENVIROMENT
LOCAL CITRIX
ENVIROMENT
WORKSTATION
WORKSTATION
TCP
80/443
TCP
80/443
NETSCALER
SERVER
SERVER
TCP
80/443
TCP
80/443
STOREFRONT /
WEB INTERFACE
VM
VM
LEGEND
* Agents deployed to XenApp and XenDesktop controllers ensure simulated users are logging off correctly following simulations
** For evaluation, Goliath ships with embedded SQL Express 2008R2 database
NOTE: The ports and protocols displayed are the defaults. They can be modified if desired.
Citrix Receiver
Goliath Intelligent Agent: very light weight, it uses 0.1% CPU, 1.5 MB size on Disk, about 25 MB RAM
Goliath Logon Simulator Agent for Citrix
9
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
B. Logon Simulator Integrated with GPM: End User Troubleshooting for Local and Remote Users
Testing the Citrix Delivery Infrastructure for local and remote users can be used for troubleshooting, and in
addition to that, the simulator can be deployed for additional user specific troubleshooting.
On a case by case basis, the logon simulator agent could be deployed to a specific end user’s computer,
locally or at home/remote, to test and get hard data on exactly what problems the user is experiencing.
The simulator would be configured with the end user’s credentials, the application or desktop they are
attempting to launch, and the administrator could see the process taking place from the initiation of the
session itself, before the user gets brokered into the session. This allows the administrator to ascertain
the following items:
1. Validation of the end user’s claim of how it is failing, and appearing to the end user
2. Where in the process the launch is failing from a technical perspective, and not just in terms of how it
appears to the end user.
3. If the launch is successful, evidence that it is operator error
10
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
LOGON SIMULATOR + PERFORMANCE MONITOR
INTEGRATED DEPLOYMENT ARCHITECTURE
GOLIATH INFRASTRUCTURE
REMOTE SQL SERVER *
MS SQL Server
2008 - 2014
WEB CONSOLE
Service Account
with DBO rights
TCP: 80
Configuration
Scheduling
Alert Configuration
Reporting
LOGON SIMULATOR &
PERFORMANCE MONITOR
SERVER
TCP: 82
TCP: 82
XENAPP SESSION
HOST
Windows 2008R2 – 2012R2
Minimum of 4 vCPUs & 8 GB Memory
25 GB of Disk Space
.NET 3.5 SP1
TCP: 82
TCP: 82
VDI
CITRIX DELIVERY CONTROLLERS
XENAPP ZDC/DC
**
4.5 – 7.6
.NET 3.5 SP1
TCP: 80/443
XENDESKTOP
DDC/DC
**
5.5 – 7.6
.NET 3.5 SP1
REMOTE CITRIX
ENVIROMENT
LOCAL CITRIX
ENVIROMENT
WORKSTATION
WORKSTATION
TCP
80/443
TCP
80/443
NETSCALER
SERVER
SERVER
TCP
80/443
TCP
80/443
STOREFRONT /
WEB INTERFACE
VM
VM
LEGEND
* Agents deployed to XenApp and XenDesktop controllers ensure simulated users are logging off correctly following simulations
** For evaluation, Goliath ships with embedded SQL Express 2008R2 database
NOTE: The ports and protocols displayed are the defaults. They can be modified if desired.
Citrix Receiver
Goliath Intelligent Agent: very light weight, it uses 0.1% CPU, 1.5 MB size on Disk, about 25 MB RAM
Goliath Logon Simulator Agent for Citrix
11
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
V.
Logon Simulator Server Installation
In the following section we will install the Logon Simulator Server
A.
Before you install Goliath Logon Simulator:
In order to complete the installation of Goliath Logon Simulator (GPM), please ensure you have the
following items available and prepared.
1. Goliath Logon Simulator installation files
2. Your license key
3. Static IP applied to the server hosting Goliath Logon Simulator
4. Use the correct version of the install program:
There are two versions of the install program: one for 32-bit versions of Windows
(gpmserver_setup32.exe) and one for 64-bit versions of Windows (gpmserver_setup64.exe)
B.
Install Goliath Logon Simulator
The Setup program will install the Goliath Logon Simulator server on the system you want to be
designated as the Server computer.
1. Exit all programs
2. To install GPM, run the downloaded executable, either ‘gpmserver_setup32.exe’ or
‘gpmserver_setup64.exe’
Please be aware at this point, that you will see screens indicating you are about to install Goliath Performance
Monitor. Goliath Logon Simulator is actually architecturally integrated into the Goliath Performance Monitor
Server. The following setup screens will also feature references to Goliath Performance Monitor and MonitorIT,
which is correct. Just to be clear, the following screens will correctly appear as you run the installer:
12
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
3. The executable will start the install process and display a Welcome installer
4. Click ‘Next’ to view the End User License Agreement.
Note: It is strongly recommended that you exit all open Windows programs before continuing with the
installation
5. Read the agreement and if you agree with the terms, select ‘I agree to the terms of this license
agreement’ and click ‘Next’. If you do not agree or do not wish to continue, select ‘I do not agree to
the terms of this license agreement’ and click ‘Cancel’ to exit the installer.
13
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
6. You are then prompted to provide your information to register the product.
7. Enter your Goliath Logon Simulator license key provided by Goliath Technologies, or if you have
downloaded Goliath Logon Simulator for evaluation, enter ‘EVAL’ as the license key to enable the
full featured version for 30 days and select ‘Next’ to continue.
Note: If you enter a valid license key, you will be given several options to configure your database.
(Please refer to Appendix E to configure an external or remote SQL database) If you are performing an
evaluation of the product, it automatically connects to the embedded SQL Express 2008 R2 database.
14
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
8. Please verify the ‘STATIC IP Address’ or ‘DNS Name’ for the Goliath Logon Simulator Server and
‘Console Port’ select ‘Next’ to continue.
9. Once ‘Next’ is selected, the wizard will verify that the Console Port is available. If it is, Goliath
Logon Simulator will then connect to it.
15
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
10. The next step lets you select where to install the Goliath Logon Simulator program. On 32-bit
versions of Windows, the default location is ‘C:\Program Files\ MonitorIT’. On 64-bit versions of
Windows, the default location is ‘C:\Program Files (x86)\MonitorIT. When the location is entered,
click ‘Next’ to continue.
Note: It is recommended that you use the default location.
16
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
11. Now please verify that the following installation settings are correct, if so select the ‘Next’ button to
proceed with the installation.
12. During the first part of the installation process, a progress bar will show the progress of installing
the Goliath Logon Simulator, as seen in the figure below.
17
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
13. Once Goliath Logon Simulator is successfully installed, the remaining database components will be
installed and configured. At some point during these additional installations, your screen may go
blank. This is a normal part of the installation process.
14. Finally, the installer program will display a message that the installation is complete. Click ‘Finish’ to
exit the install program
15. You have successfully installed Goliath Logon Simulator software.
18
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
VI.
Prepare the Simulation Endpoint to Launch Simulations
The simulation endpoint is the server or virtual machine in which the simulation(s) will be launching from. In the
following section we will discuss how to prepare your simulation endpoint by creating a local service account with
admin rights, installing Internet Explorer 11 and Citrix Receiver, as well as configure automatic logons, disable UAC
at the system level and more.
NOTE: If your instance of Goliath Logon Simulator is integrated with Goliath Performance Monitor, for POC
purposes the simulation endpoint can be the same as the Goliath Performance Monitor Server, but for production
we do recommend that the instances stay separate.
A. Service Account with Local Admin Rights
In order for the simulations to launch, we will need a local service account with admin rights. This
is important because this user will be signed onto the server at all times. Please create this local
service account with admin rights and log in with it before continuing.
B. Internet Explorer 11
Please confirm that Internet Explorer 11 is installed:
1.
2.
3.
4.
Open Internet Explorer
Select the gear icon in the top right hand corner
Select “About Internet Explorer”
A window displaying the Internet Explorer version will appear
a. If it is not version 11, please upgrade your Internet Explorer
b. If it is version 11, please continue on
C. Citrix Receiver
Please confirm that Citrix Receiver is installed:
1.
2.
3.
4.
Open Windows Control Panel
In the top right hand corner, change the “View By” settings to be “Small Icons”
Select “Programs and Features”
Sort by Name and confirm whether or not Citrix Receiver is installed
a. If it is not installed, you can download & install it from the following website:
i. http://www.citrix.com/go/receiver.html
b. If it is installed, please continue on
D. .NET 3.5
Please confirm that .NET 3.5 is installed.
Note: .NET 4.5 is not backwards compatible. Also, .NET 3.5 is not automatically included with
Windows Server 2012 – 2012 R2.
19
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
E. Move LogonSimulator.exe to the Simulation Endpoint.
This file can be found in <Goliath Logon Simulator Install Directory>/bin and needs to be running
under the service account on the simulation endpoint. This file will also need to be placed it in the
startup folder so it runs automatically.
1. Go to the install directory of the Logon Simulator Server and then navigate to the Bin
folder and find LogonSimulator.exe.
a. The default location for the 64-bit version is:
C:\Program Files (x86)\MonitorIT\Bin
2. Copy LogonSimulator.exe and move it to the Simulation Endpoint desktop
3. Open the Startup folder
a. This can be done by clicking the start menu and typing “shell:Startup” and hitting
enter
4. Copy the LogonSimulator.exe file from the desktop into the Startup folder
5. Run the file
Note: If there are security prompts when you run it the first time, please uncheck the box to
check the executable in the future, to ensure successful starts of LogonSimualtor.exe following
restarts of the simulation endpoint.
F. Configure Automatic Logins
The Logon Simulator needs to be run as a logged in user. Whenever a VM is restarted, the test
account needs to be logged back in otherwise the simulation(s) will not be able to run. To
facilitate this process in the circumstance of a restart of the simulation endpoint, we define the
local service account with admin rights, to ensure the simulation continues to run.
1. Go to the install directory of the Logon Simulator Server and then navigate to the Bin
folder and find LogonSimulatorRegistryEdit.exe.
a. The default location for the 64-bit version is:
i.
C:\Program Files (x86)\MonitorIT\Bin
2. Copy the LogonSimulatorRegistryEdit.exe file onto the desktop of the simulation endpoint
3. Right-click the file and select “Run as Administrator”
4. Fill out the account information
5. Leave the “Disable User Account Control” box checked.
6. Hit submit
Note: This process requires a reboot of the simulation endpoint server. Please reboot the
server before continuing on or else the new settings will not be saved.
G. Lower Internet Security for Trusted Sites
IE Security should be set to the minimum for trusted sites with your Citrix portal added to the
whitelist.
Note: The purpose for this step is to ensure the ICA file is opened automatically by Citrix Receiver
and the application or desktop is launched.
1. Open Internet Explorer and open the Internet Options window
2. Under security, go to trusted sites
3. Set the security to the lowest setting
20
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
4. Click on the trusted sites button, then add your Citrix portal to this site
H. Deploy a Goliath Agent to the Simulation Endpoint
In order to execute the Logon Simulator simulations, an agent must be installed. This agent also
sends metrics regarding the simulation logon process to the Logon Simulator server.
1. Open Internet Explorer
2. Use the following URL to connect to the Logon Simulator Server and download the
Goliath Agent.
a. http://nn.nn.nn.nn/InstallAgent.exe where nn.nn.nn.nn is the IP address of the
Logon Simulator Server.
3. Launch the Agent installer to begin the installer and follow the onscreen prompts
a. You will be asked to enter the IP address for the Logon Simulator Server.
b. The port number can be kept the same unless you changed the Logon
Simulator Server ports during your original Logon Simulator installation.
c. The optional name field is provided if you’d like the server to appear as a
name in inventory ie. “SQL Server” instead of “SVR-SQ01”
4. The agent will automatically check into the Logon Simulator Server after the installer
has finished to begin monitoring.
VII.
Prepare the Citrix Environment for Logon Simulations
A. Deploy Agent to the Citrix Delivery Controller
You will need an agent deployed to your Citrix XenApp ZDC/DC or XenDesktop DDC/DC. For Citrix versions
7.0 and newer the agent must run as a Citrix Admin Account with local admin rights and also have .NET
3.5 installed. This is needed for the Logon Session Handler to cleanly log off of each simulation.

21
Deploy an Agent: Citrix XenApp 4.5 to 6.5 and Citrix XenDesktop 5.5 to 6.5
1. Log into your Citrix XenApp ZDC/DDC or Citrix XenDesktop DDC (based on your
environment)
2. Open Internet Explorer
3. Use the following URL to connect to the Logon Simulator Server and download the Goliath
Agent.
a. http://nn.nn.nn.nn/InstallAgent.exe where nn.nn.nn.nn is the IP address of the
Logon Simulator Server.
4. Launch the Agent installer to begin the installer and follow the onscreen prompts
a. You will be asked to enter the IP address for the Logon Simulator Server.
b. The port number can be kept the same unless you changed the Logon Simulator
Server ports during your original Logon Simulator installation.
c. The optional name field is provided if you’d like the server to appear as a name
in inventory ie. “SQL Server” instead of “SVR-SQ01”
5. The agent will automatically check into the Logon Simulator Server after the installer has
finished to begin monitoring.
6. You can now log off of the ZDC/DDC
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies

22
Deploy an Agent: Citrix XenApp & Citrix XenDesktop 7.0 to 7.6
1. Log into your Citrix XenApp DC or Citrix XenDesktop DC (based on your environment)
2. Open Internet Explorer
3. Use the following URL to connect to the Logon Simulator Server and download the Goliath
Agent.
a. http://nn.nn.nn.nn/InstallAgent.exe where nn.nn.nn.nn is the IP address of the
Logon Simulator Server.
4. Launch the Agent installer to begin the installer and follow the onscreen prompts
a. You will be asked to enter the IP address for the Logon Simulator Server.
b. The port number can be kept the same unless you changed the Logon Simulator
Server ports during your original Logon Simulator installation.
c. The optional name field is provided if you’d like the server to appear as a name in
inventory ie. “SQL Server” instead of “SVR-SQ01”
5. The agent will automatically check into the Logon Simulator Server after the installer has
finished to begin monitoring.
6. Open Windows Services
7. Find “MonitorIT Agent Service” and stop the service
8. Right-click the “MonitorIT Agent Service” and select “Properties”
9. Select the “Log On” tab
10. Select the radio button for “This Account” and enter in the credentials for a Citrix Admin
account with local admin rights for the agent to run as.
11. Select Ok and Restart the “MonitorIT Agent Service”
12. Confirm that .NET 3.5 is installed on the DC, if it is not, please install it
13. You can now log off of the DC
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
B. Enable Logon Simulator Session Handler to Logoff sessions at the end of simulations
On one of the XenApp ZDC/DC’s or XenDesktop DDC/DC’s in each of your Citrix farms, enable Logon
Simulator Session Handling to send disconnect messages to the Citrix farm when the Logon Simulator is
finished with each session. This ensures subsequent sessions successfully launch completely, instead of
simply reconnecting to existing sessions. Follow these steps to configure:
1.
2.
3.
4.
5.
6.
7.
Logon to the Logon Simulator Server
If the Goliath Performance Monitor Evaluation notice appears, click “Continue”
On the menu bar, click on “Configure” then “Inventory”
Locate and select one of your Citrix Delivery Controllers with an agent on it
Click “Edit” at the bottom
Check the box next to “Enable Logon Simulator Session Interface Handler”
The other options are not necessary but will provide diagnostic information for the Logon
Duration Report when licensed for Goliath Logon Simulator
8. Click “Save”
23
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
VIII. Configure Simulations
In the following section we will create the simulation conditions, test the simulations and cover some
common troubleshooting steps.
A. Create a new Citrix Logon Simulator Monitoring Rule
1. Open the Logon Simulator Server console
2. Navigate to the “Configure” tab and then “Monitoring Rules”
3. Click “New” at the bottom and select the radio button next to “Citrix Logon Simulator” and then
select “Ok”
4. A new Citrix Logon Simulator Monitoring Rule page will appear.
5. Please enter the appropriate data for each field:
Field Name
Description
Rule Name
The name of the monitoring rule
Description
Description of the monitoring rule
Severity
The importance of the monitoring rule alerts
Site URL
The URL of your Citrix Portal
Authentication
Citrix Portal credentials for the Logon Simulator test service account
App & Title Names
Enter the information for the Applications and or Desktops that you
would like the Logon Simulator to launch.
This information is entered in the format of: App/Desktop,Window Title
Tab/Folder Name
Script Name
Citrix Account name
Note: If your window title includes a “-“ you only need to enter the
information before the “-“. For Example, if you launch Chrome and it
opens to a new tab, the window title is “New Tab – Google Chrome”,
therefore you will only need to enter “New Tab” for the window title in
the monitoring rule.
Verify the Tab or Folder Name that the Application and or Desktop is in.
For Example, if your Citrix Storefront has the “Apps” and “Desktops” tabs
at the bottom of the page, you will need to enter which tab the item is
under. Also, folders can be separated by ‘/’ if there are any nested
folders; e.g. ‘Apps/Browsers”.
This field is to be kept as the default SFLauncherSTD and is not to be
edited
Enter the Citrix Portal username in the format of DOMAIN\username
6. Finally, select the Logon Simulator endpoint server in the “Server/Workstation Tree”.
24
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
25
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
B. Configure Scheduling
In the Schedule tab, you can edit the alert notification frequency as well as, schedule how often you would like
the simulations to run.
26
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
C. Testing the Simulations
Logon onto the Simulation Endpoint as the local service account and wait for the simulation to run at its
scheduled time. Make sure nothing interrupts the Logon Simulator – first time run windows are not handled,
so accept and confirm those. A common example is an installation prompt for the Citrix receiver the first time
you try to log in.
Verify the Results:
1. Navigate to the “Monitor” and then “Logon Simulator”. This page shows all of the apps and or
desktops being monitored.
2. If the app is green, it was successful. If it is red, it failed.
3. You can click on the box in the “Details” column to view a detailed, time stamped log of the logon
simulation process
4. If the page is blank, you may not have saved the monitoring rule or you may not be licenses for
Logon Simulator.
D. Common Problems



The Logon fails, but the text log is empty.
This happens when LogonSimulator.exe isn’t running under an admin account. Check the server to see
if it is running. User Account Control also needs to be turned off. This can be confirmed by opening a
command prompt and checking the window name. If it starts with “Administrator:”, UAC is off.
Logon Simulator can’t open the apps, but it gets to the app page.
It is possible that your apps are nested in the HTML structure in a way that prevents Logon Simulator
from finding them. You can usually resolve this by filling in the App/Folder name field of the
monitoring rule with the name of the container.
The wrong application is showing up.
The Citrix sessions aren’t being disconnected properly. There needs to be an agent on the Citrix farm
with session handling enabled in order to disconnect the test sessions. The Citrix farm will also need
.NET 3.5 installed.
More detailed questions and answers can be found in our Goliath Logon Simulator FAQ’s, available
here. If you are still having trouble, contact Goliath support at [email protected].
27
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
IX. Alerting
When the Logon Simulator detects a problem with Citrix, an alert will be created. These alerts are
configured in the monitoring rule. In the Schedule tab, you can select how often an alert will be
generated in a given time frame. The Notifications tab will allow you to send alerts through email or
other methods to allow for instant notifications of alerts.
To enable alerting for Logon Simulator:
1. Open the Monitoring Rules page
It is located under Configure->Monitoring Rules
2. Edit the Logon Simulator rule
Click the rule and select “Edit”. It may be easier to find your Logon Simulator rules if you sort by
Type, since all Logon Simulator rules are “Advanced Type”.
3. Enable Email alerts
In the Alerts tab, check “Enable Email Alerts”
4. Edit the Email details
Fill out the subject line and enter the email addresses that should receive the alerts
28
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
X.
Reporting
A Logon Simulator report can be generated. The report will break down all of the Logon sessions that succeeded
or failed and break them down by location and rule. The Logon Simulator report will also contain a copy of all the
logs in collapsible frames. These reports can be scheduled and analyzed like any other Goliath Reports.
To schedule a Logon Simulator Report:
1. Open the reports page
You can schedule a report under Reports->Schedule
2. Select “Alert Analysis”
Select the Alert Analysis report type. Fill out the Report Name/Notes field.
3. Choose LOS Alert types
Click on “Choose Alert Types & Servers/Devices”. Check the box for “AdvancedWatch & LOS Alerts”. By
default it reports on all Logon Simulator locations.
4. Schedule Report
Select the time the report should be run, how often it runs, and the time period it should analyze. The
report can also be emailed if needed. The following example shows a weekly report that runs every
Sunday morning.
29
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies
XI.
Abbreviations and Acronyms
List all abbreviations and acronyms used in this document.
Table 1 Abbreviations and Acronyms
Abbreviation / Acronym
Description
CPU
Central Processing Unit
GB
Gigabyte
GPM
Goliath Logon Simulator
IE
Internet Explorer
IP
Internet Protocol
IT
Information Technology
MB
Megabyte
PDF
Portable Document Format
POC
Proof of Concept
RAM
Random Access Memory
SP
Service Pack
SQL
Structured Query Language
TCP
Transmission Control Protocol
vCPU
Virtual CPU
ZDC
Zone Data Collector
30
Logon Simulator Installation Guide
Copyright © 2015 Goliath Technologies