Installation Guide for Goliath Logon Simulator for Citrix

v1.0

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
Legal Notices
Copyright © 2016 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.

Logon Simulator Installation Guide

2 Copyright © 2016 Goliath Technologies
Table of Contents
I. Goliath Logon Simulator for Citrix Prerequisites ............................................................................................... 4
II. Logon Simulator Server Installation .................................................................................................................. 5
III. Prepare the Simulation Endpoint to Launch Simulations ............................................................................... 12
A. Disable UAC at the Kernel/System Level ................................................................................................ 12
B. Windows Service Account for the Endpoint........................................................................................... 12
C. Internet Explorer 11 ............................................................................................................................... 13
D. Citrix Receiver ......................................................................................................................................... 13
E. Move LogonSimulator.exe to the Simulation Endpoint. ........................................................................ 13
F. Configure Automatic Logins for the Service Account ............................................................................. 14
G. Lower Internet Security for Trusted Sites .............................................................................................. 14
H. Deploy a Goliath Agent to the Simulation Endpoint .............................................................................. 14
IV. Prepare the Citrix Environment for Logon Simulations................................................................................... 15
V. Configure the Logon Simulations .................................................................................................................... 17
A. Create a new Citrix Logon Simulator Monitoring Rule .............................................................................17
B. Schedule the Simulations .........................................................................................................................19
C. Test the Simulation ..................................................................................................................................20
VI. Simulation Results ........................................................................................................................................... 20
D. Navigating to the Logon Simulator Dashboard ........................................................................................20
E. Analyzing the Simulation Results .............................................................................................................20
VII. Appendix.......................................................................................................................................................... 21
A. Pull the Goliath Intelligent Agent down from the Goliath Server ............................................................21
B. Determining the Goliath Server IP Address/FQDN ..................................................................................21
C. Determining the Goliath Agent Port ........................................................................................................21
D. Determining the Goliath Web Port ..........................................................................................................21
E. Alerting .....................................................................................................................................................22
F. Reporting..................................................................................................................................................23
G. Troubleshooting Common Problems .......................................................................................................24

Logon Simulator Installation Guide

3 Copyright © 2016 Goliath Technologies
I. Goliath Logon Simulator for Citrix Prerequisites
International users: For installations in environments requiring foreign language versions of
Windows, Goliath requires that the base installation be performed with the English version of
Windows OS. Localization should be done using language packs only, no localized Windows OS
install.

Table 1 - Goliath Logon Simulator Requirements

Platform: Virtual Machine or Physical Server
Goliath Server OS: Windows Server 2008 R2 – 2016
(please disregard if also using (English version of Windows required for Goliath server)
Goliath Performance Monitor) Network: Static IP Address
vCPU: Minimum of 4 cores or vCPUs
Memory: Minimum of 8GB RAM
Disk: minimum of 25GB of disk space available
Dependencies:
 .NET 3.5 Framework
 If you are launching sessions for XenApp or XenDesktop 7.X, an
account with Full Citrix Admin Rights is required to execute the
simulation logoff sequence.

Optional: PDF Reader to view installed product documentation

Firewall Goliath Server:

TCP 80* opened inbound and outbound for web console connection
TCP 8282* opened inbound for agent connection to agent location

Goliath Intelligent Agent:

TCP 8282* opened outbound for agent connection to the Goliath Server

* Default ports listed and can be modified.

OS: Windows Server 2008 R2 – 2016, Windows 7 – 10
Simulation Endpoint (English version of Windows required for Goliath server)
Dependencies: GPM Agent deployed
Web Browser: Internet Explorer 11
Citrix Receiver: Versions 4+
Citrix Account: Dedicated Citrix test account with rights to applications or
desktops to be launched
Local or Domain Account: Dedicated account that must be
logged/disconnected always. This can be the same as the Citrix account,
especially if you’re automating logons using integrated Windows
authentication.
User Account Control: Disabled at the System level, not through Control Panel
IE Enhanced Security: Set this to be “off” for Administrators and Users
Update Trusted Sites: Add Citrix Portal to whitelist for trusted sites and the
security zone set to “Low” to bypass file downloads

Logon Simulator Installation Guide

4 Copyright © 2016 Goliath Technologies
II. Logon Simulator Server Installation
In the following section, we will install the Logon Simulator Server. Please note, the Logon Simulator integrates
into the Goliath Performance Monitor technology. If you already have this product deployed, please skip this
section and proceed to section 4.

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 (if not an evaluation)
3. .NET 3.5 Framework Installed
4. Static IP applied to the server hosting Goliath Logon Simulator

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:

Logon Simulator Installation Guide

5 Copyright © 2016 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.

Logon Simulator Installation Guide

6 Copyright © 2016 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.

Logon Simulator Installation Guide

7 Copyright © 2016 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.

Logon Simulator Installation Guide

8 Copyright © 2016 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.

Logon Simulator Installation Guide

9 Copyright © 2016 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.

Logon Simulator Installation Guide

10 Copyright © 2016 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.

Logon Simulator Installation Guide

11 Copyright © 2016 Goliath Technologies
III. Prepare the Simulation Endpoint to Launch Simulations
The simulation endpoint is the server, virtual machine, or workstation in which the simulation(s) will be launching
from. In the following section, we will discuss how to prepare your simulation endpoint to allow simulations to
execute.

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. Disable UAC at the Kernel/System Level

For the simulations to launch, the UAC must be disabled at the system level (not through Control
Panel). To accomplish this, Goliath includes a registry file to update the system. This file must be
run by a user with Admin privileges and requires a machine reboot.

1. On the Goliath Server, open Windows File Explorer and navigate to C:\Program Files
(x86)\MonitorIT\Tools
2. Locate the Disable_UAC.reg file and copy it over to the simulation endpoint.
3. Double click to run the file
4. A warning will appear for changing the registry, click ‘Yes’ to continue

5. A confirmation window will appear, click ‘Ok’

6. Reboot the simulation endpoint

B. Windows Service Account for the Endpoint

Since the Logon Simulator is creating real Citrix sessions, you will need a local or domain service
account that is logged into the endpoint always, either logged in or disconnected. Please create
this service account and log in with it before continuing.

Logon Simulator Installation Guide

12 Copyright © 2016 Goliath Technologies
 C. Internet Explorer 11
Please confirm that Internet Explorer 11 is installed:

1. Open Internet Explorer

2. Select the gear icon in the top right hand corner
3. Select ‘About Internet Explorer’
4. 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

D. Citrix Receiver
Please confirm that Citrix Receiver is installed:

1. Open Windows Control Panel

2. In the top right hand corner, change the ‘View By’ settings to be ‘Small Icons’
3. Select ‘Programs and Features’
4. Sort by Name and confirm whether 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

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 defined in section 4B above on the simulation endpoint. This file will
also need to be placed it in the startup folder so it runs automatically when the user logged into
the machine.

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. This file will run in the background, therefore no windows will open upon
running 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.

Logon Simulator Installation Guide

13 Copyright © 2016 Goliath Technologies
 F. Configure Automatic Logins for the Service Account
As mentioned previously, the Logon Simulator requires a user account to be signed into the
simulation endpoint always for the simulations to run. Therefore, if the machine is ever
rebooted, we want the service account to automatically log back into the machine so that the
simulations continue.

To facilitate this process in the circumstance of a restart of the simulation endpoint, we suggest
using the Windows Sysinternals Autologin utility.
1. Download the Autologon utility - https://technet.microsoft.com/en-
us/sysinternals/autologon.aspx
2. Extract the zip file
3. Run the Autologon utility
4. Define the service account information mentioned in section 4B
5. Click Enable

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. 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
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. Download the agent to the Windows machine that you would like to monitor using
the link provided – Click Here to Download.
a) If you have a closed network or would like to use your local Goliath server to
obtain the agent install, please see the instructions in Appendix A.
2. Launch the Goliath Intelligent Agent setup installer (InstallAgent.exe) and click ‘Next’
3. Enter the IP Address or FQDN of the Goliath Server. If you are unsure of this
information, please see the instructions in Appendix B on how to obtain it.
4. Enter the Goliath Agent Port used for communication and click ‘Next’. If you are
unsure of the port number, please see the instructions in Appendix C on how to obtain
it.
5. Confirm the agent install directory, this should remain “C:\Program Files\MonitorIT”
unless there is no C drive.
6. Confirm the installation settings then click ‘Next’ to start the installation.
7. After 1-2 minutes the installation will complete, click ‘Finish’.

Logon Simulator Installation Guide

14 Copyright © 2016 Goliath Technologies
IV. Prepare the Citrix Environment for Logon Simulations
You will need an agent deployed to your Citrix XenApp ZDC/DC or XenDesktop DDC/DC for the Logon
Simulator Session Handler to cleanly log off each simulation. This ensures subsequent sessions
successfully launch completely, instead of simply reconnecting to existing sessions.

For Citrix versions 7.0 and newer, you will an account that has Citrix Full Admin Rights to complete the
logoff.

1. Open the Goliath Console

2. Navigate to the Configure tab, and select the ‘Inventory’ sub menu
3. Click the ‘New’ button at the bottom of the page. A configuration pane will appear, enter in the
hostname and IP address for the ZDC/DC.
a. If you are also using Goliath Performance Monitor and there is already an agent on the
ZDC/DC, please proceed to step 13.
4. Click ‘Save’
5. Repeat steps 3-4 to add all additional ZDC/DC. Please note, only 1 per environment is necessary.
6. To now deploy an agent to those delivery controllers, click the ‘Manage Agents’ button at the
bottom of the page
7. When the ‘Manage Agent’ screen appears, select the ZDC/DC(s) that you would like to deploy an
agent to
8. Click the ‘Deployment Settings’ button and enter one-time local administrator credentials. These
credentials are only used to copy over and run the install files and are not saved in the database
9. Click the ‘Install/Update Agents’ button at the bottom of the screen to begin the agent
installation.
a. You will see a prompt warning you to enter credentials if this is the 1st agent deployment,
click ok the bypass and begin the agent installation
10. Depending on the number of Agents that are being installed, the process may take a few minutes
to complete.
a. You will see green checkboxes appear as the agent installation succeeds
11. Once all agents have been installed, you will receive a prompt that the installation is complete.
Click the ‘Close’ button at the bottom of the screen to return to the inventory page.
12. Once on the Inventory screen, you can confirm that the agents are connecting into the product by
looking at the ‘stat’ column and identifying a green box. This could process could take about 1-3
minutes, you’ll need to refresh the page as well.
a. Please note, if you do not see any icon in the ‘Stat’ column after 5 minutes, confirm that
the Goliath Server is accepting inbound TCP communication on all firewall levels (Domain,
public, private) and that the server where the agent is installed is allowing outbound TCP
communication for all firewall levels.
13. Once the agent for the ZDC/DC(s) are connected, select the inventory entry and click the ‘Edit’
button at the bottom of the page.

Logon Simulator Installation Guide

15 Copyright © 2016 Goliath Technologies
 14. When the edit pane is open for the ZDC/DC, under the ‘Enable Citrix XenApp and XenDesktop
Monitoring Options’ section and check the boxes for ‘Enable Logon Simulation Logoffs’
a. If this is a Citrix 7.X Delivery Controller, please define a user account that has Full Citrix
Admin Rights. This is required for the application/desktop logoff to occur.

Logon Simulator Installation Guide

16 Copyright © 2016 Goliath Technologies
V. Configure the Logon Simulations
In the following section we will create the simulation conditions, test the simulations and cover some
common troubleshooting steps. Please note, it is important to do a manual launch of the
applications/desktops on the simulation endpoint as you are configuring the simulations to verify all
settings.

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. These must be
entered the same exact way they are entered into the Citrix Portal.
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

Please Note: Application and Desktop names require an exact match but are not
case sensitive. On the other hand, the window title only needs to be a partial
match. If you’re window titles often change, the Boolean character of ‘+’ is
accepted. To specify more than application or desktop per simulation, use the
semicolon character ‘;’ to delimit each ordered pair. This field has a 250 character
maximum.
Tab/Folder Name 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 or top 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”.
Citrix Account name Enter the Citrix Portal username in the format of DOMAIN\username, this account
name will be used to connect to the ZDC/DC to execute the logoff
Launch Timeout This is the threshold for whether or not the simulation is a success or failure. If any
stage of the simulation process exceeds this threshold the simulation will report
back as failed.
Web Logoff Delay Once the simulation has been deemed a success or failure, the windows will delay
to logoff after the defined number plus 60 seconds. So if you’d like to keep the
session open for 2 minutes, you’d input 60
Logon Simulator Installation Guide
17 Copyright © 2016 Goliath Technologies
 6. Select the Logon Simulator endpoint server in the ‘Server/Workstation Tree’

Advanced Options:
When clicking the ‘Advanced Options’ button you can configure additional settings.
Field Name Description
Auto-Launch App/Desktop Enabled Check this box if your environment auto-launches an
app/desktop at logon
Single Sign-On Enabled Check this box if single sign-on is enabled in your environment
‘Continue’ Sign-On option If your environment uses 2 factor authentication please enter
your credentials here.
Alert on Logon Duration To alert on the logon duration of an app/desktop please enter
the threshold here. With this option you can be alerted on the
simulated session logon duration if it exceeds the specified
value.
Script Type This field is to be kept as the default Standard and is not to be
edited unless Goliath Technologies has advised otherwise

Logon Simulator Installation Guide

18 Copyright © 2016 Goliath Technologies
B. Schedule the Simulations
In the Schedule tab, you can edit the alert notification frequency as well as, schedule how often you
would like the simulations to run. More than one simulation accessing the same Citrix portal address can’t
be run at the same time.

Please Note: It is important to make sure that your scheduled simulations have the appropriate time to
execute and logoff properly. We suggest determining the maximum simulation time and scheduling the
frequency based off that. The maximum simulation time is the amount of time the simulation would take
to execute if all the apps/desktops configure were to fail.

Here is how to calculate the maximum simulation time (in seconds):

180 + ( A ( B + 15) ) + C
Where:
 A = the number of applications/desktops being launch
 B = the launch timeout
 C = the web logoff delay

For example, if you wanted to launch 2 applications, with a launch timeout of 45 seconds and web logoff
delay of 0 here is what the maximum simulation time would be:

180 + ( 2 ( 45 + 15) ) + 0
180 + ( 2 (60) )
180 + (120)
300 seconds which converts to 5 minutes
Therefore, I would not schedule the simulations to run any less then every 6 minutes.

Logon Simulator Installation Guide

19 Copyright © 2016 Goliath Technologies
 C. Test the Simulation
Before putting the simulation into production, we suggest running a simulation and watching it take
place. This is to validate that the simulation is configured properly and to also make sure that nothing
interrupts the Logon Simulator.
Common examples are:
 installation prompt for the Citrix receiver the first time the simulated user tries to log in
 prompt to download the ICA file
 Incorrect application name or window title

VI. Simulation Results

Once the simulations have completed, the Logon Simulator Dashboard includes all the results for the most
recent simulations. Please note, to see historical simulation details, you will need to run the Logon Simulator
report.
D. Navigating to the Logon Simulator Dashboard
1. Open the Goliath Console
2. Click the ‘Monitor’ tab
3. Select the ‘Logon Simulator’ sub

E. Analyzing the Simulation Results

 Successful simulations will appear in green font and failed simulations will appear in red font
 You can drill into the simulation details by selecting the button in the ‘Details’ column
 Simulation Details Information:
o SF Resources Page Not Found: This error is indicative of the Logon Simulator being unable to
confirm that it has successfully signed into Storefront successfully. This error can manifest for
2 reasons, first is invalid user credentials and the second is the storefront server is down and
not accepting logins as the simulator was unable to reach the storefront page.
o Resource '______' not found: This error entails that the Logon Simulator was unable to find
the defined application/desktop on the Storefront page. When first deploying the simulator,
please ensure that application/desktop is spelled correctly and matches the content on the
page exactly. If the resource is spelled correctly, we often suggest our customers to do an
‘Inspect Element’ of the resource to ensure there is no hidden space characters that may not
be visible.
o WARNING: Unable to confirm that session launched for Resource= ‘_____' and Title='____':
This error is the result of the Logon Simulator being unable to confirm that the session has
been successfully launched. Once the simulator clicks on the application/desktop, next the
simulation will confirm that the session did indeed launch by using the defined window title
for the application/desktop. If any windows open instead of the application, ie an error
prompt, the window title will be included the lines above this message.
o Try #_ Waiting: This is an informational message, not an error message. With the simulation
configuration process, a ‘Launch Timeout’ value is defined. This value is the threshold that is
used for the stages of the Logon Simulation. If any stage of the simulation process, ie loading
the page, signing in, finding the application, etc, exceeds the threshold the simulation is
deemed as a failure. The ‘Try’ messages simply countdown how long it takes each stage to
execute. If the ‘try’ reaches the value of the launch timeout a failure will occur.
Logon Simulator Installation Guide
20 Copyright © 2016 Goliath Technologies
VII. Appendix
A. Pull the Goliath Intelligent Agent down from the Goliath Server
1. Start up and sign into the Gold Image
2. Open the web browser
3. Navigate to http://nn.nn.nn.nn:##/InstallAgent.exe where nn.nn.nn.nn is the IP Address or FQDN
of the Goliath Server and ## is the web port for the Goliath Server. If you are unsure of the IP
Address or FQDN of the Goliath Server, please see the instructions in Appendix B on how to obtain
it. If you are unsure of the web port for the Goliath Server, please see the instructions in Appendix
D on how to obtain it.

B. Determining the Goliath Server IP Address/FQDN

1. Sign into the Goliath Server
2. Navigate to the install directory of Goliath Performance Monitor. The default location is
C:\Program Files (x86)\MonitorIT
3. Open the Bin directory
4. Launch ‘MonitorITCFU.exe’ as administrator
5. Within the application, go to File and Open
6. Navigate to the Bin directory of the Goliath Performance Monitor install directory. The default
location is C:\Program Files (x86)\MonitorIT\Bin
7. Select the file named ‘default.btc’ to open
8. The Goliath Server IP address or FQDN is in the ‘Server IP Addr’ field.

C. Determining the Goliath Agent Port

1. Sign into the Goliath Server
2. Navigate to the install directory of Goliath Performance Monitor. The default location is
C:\Program Files (x86)\MonitorIT
3. Open the Bin directory
4. Launch ‘MonitorITCFU.exe’ as administrator
5. Within the application, go to File and Open
6. Navigate to the Bin directory of the Goliath Performance Monitor install directory. The default
location is C:\Program Files (x86)\MonitorIT\Bin
7. Select the file named ‘default.btc’ to open
8. The Goliath Agent port is in the ‘Agent Port’ field.

D. Determining the Goliath Web Port

1. Sign into the Goliath Server
2. Navigate to the install directory of Goliath Performance Monitor. The default location is
C:\Program Files (x86)\MonitorIT
3. Open the Bin directory
4. Launch ‘MonitorITCFU.exe’ as administrator
5. Within the application, go to File and Open

Logon Simulator Installation Guide

21 Copyright © 2016 Goliath Technologies
 6. Navigate to the Bin directory of the Goliath Performance Monitor install directory. The default
location is C:\Program Files (x86)\MonitorIT\Bin
7. Select the file named ‘default.btc’ to open
8. The Goliath Agent port is in the ‘Web Port’ field.

E. 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 each 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

Logon Simulator Installation Guide

22 Copyright © 2016 Goliath Technologies
F. Reporting
To see historical Logon Simulation results, there is a Logon Simulator report that can be generated. The
report will list all the Logon Simulations that succeeded or failed and will also contain a copy of all the logs
in collapsible frames. These reports can be scheduled or ran on-demand.

Schedule a Logon Simulator Report:

1. Click the ‘Report’ tab and then select the ‘Schedule’ submenu
2. Once the Schedule page is fully loaded, choose the ‘Alert Analysis’ report type
3. In the ‘Report Name/Notes field’, enter ‘Logon Simulator Report’

4. Select the ‘Choose Alert Types & Servers/Devices’ button

5. A ‘Specify Report Parameters’ page will appear, check the box for ‘AdvancedWatch & LOS Alerts’
a. By default, the report will include the information for all the Logon Simulations created.
To only report on one simulation, click the ‘Select’ button and choose the simulations you
want to report on.
6. Click ‘Ok’ to approve the report parameters
7. Select the time the report should be run, how often it will run, and the historical period it should
analyze.

Logon Simulator Installation Guide

23 Copyright © 2016 Goliath Technologies
 Run the Logon Simulator Report On-demand:
1. Click the ‘Report’ tab and then select the ‘View’ submenu
2. Once the page is fully loaded, choose the ‘Alert Analysis’ report type highlighted in blue
3. Click the ‘Analyze’ button at the bottom of the page
4. A ‘Specify Timeframe for Alert Notifications’ page will appear
5. Choose how many days/hours that you’d like to report on and then check the box for
‘AdvancedWatch & LOS Alerts’
a. By default, the report will include the information for all the Logon Simulations created. To
only report on one simulation, click the ‘Select’ button and choose the simulations you want
to report on.
6. Click ‘Ok’ to approve the report parameters and run the report
a. Please note that the report generation process is tied to this page. If you navigate away from
the page or click any other buttons on the page it will break the report process.
7. When the report is completed, select the report and then click the ‘Status’ tab to view the results.

G. Troubleshooting Common Problems

1. The Logon fails and the details log is empty.
This means that the simulation could not start due to an invalid or missing parameter. Please check
and make sure all required fields in the simulation rule are filled in appropriately. Also, please make
sure that User Account Control is turned off on the simulation endpoint. This can be confirmed by
opening a command prompt (with normal privileges) and checking the window name. If it starts with
“Administrator:”, UAC is off.

2. The Logon fails, and the text log shows ‘Unable to Start the Logon Simulator Powershell Command
and Script for App’
This means that at least one of the Logon Simulator Prerequisites are not configured on the
simulation endpoints. Please review the documentation and confirm all prereqs are in place.

3. 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. Also, make sure that there are no extra space
characters in the name that would not appear to the naked eye.
4. 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 to disconnect the test sessions.

Logon Simulator Installation Guide

24 Copyright © 2016 Goliath Technologies