27/5/2016 HowtoSetUpYourCitrixEnvironment

LoadRunnerHelpCenter Search
Version 12.53

Citrix Protocol HowtoSetUpYourCitrix

Citrix Protocol - Environment
Overview
BeforecreatingaCitrixscript,youneedtoproperlyconfigure
How to Set Up Your yourCitrixclientandserver.
Citrix Environment
1. Prerequisite
Agent for Citrix
Presentation Server Ensurethatyouareworkingwithsupportedversionsof
- Overview yourCitrixclientandserveraslistedintheProduct
AvailabilityMatrix,availablefromtheSoftwareSupport
Citrix Recording Tips site.
Citrix Synchronization
2. Setup your Citrix ICA clients
Citrix Replaying Tips

Citrix Debugging Tips a. InstalltheclientontheVuGenandLoadGenerator

machines.Torunyourscript,youmustinstallaCitrix
Citrix - clientontheVuGenmachineeachLoadGenerator
Troubleshooting and machine.Ifyoudonothaveaclientinstalled,you
Limitations candownloadonefromtheCitrixwebsite
www.citrix.comundertheDownloadssection.
b. VerifytherequiredVuGenCitrixsettings.Forsome
Citrixversions,theTCP/IPCitrixconnectionoption
doesnotwork.Inthatcase,usetheTCP/IP+HTTP
Citrixconnectionoption:
IntheVuGenRecordingOptionsdialogbox,select
Citrix>Login.IntheConnectionarea,select
TCP/IP+HTTPastheNetworkProtocol.Formore
details,seeCitrix>LoginRecordingOptions.

3. Set up your Citrix Web Interface clients (Only when connecting to

Citrix server via Web Interface)

a. DEP.Beforerecording,TurnoffMicrosoftDEPonthe
VuGenmachine.Thisisdoneindifferentwayson
differentoperatingsystems.
OnewaytodothisonVista,Windows7,and
Windows2008isasfollows:
i.Fromthecmdshell,runbcdedit.exe/setnx
AlwaysOff.
ii.Restartthecomputer.

http://lrhelp.saas.hpe.com/en/latest/help/WebHelp/Content/VuGen/129550_t_how_to_configure_citrix_client_server.htm#InstallAgent 1/4
27/5/2016 HowtoSetUpYourCitrixEnvironment

b. SecuritySoftware.Ifpossible,disableantimalware
andothersecurityorantivirussoftware.Alternatively,
addanexceptiontoignorevugen.exe,
runcitrixclient.exe(aLoadRunnerprocess)and
wfica32.exe(theCitrixclientprocess).Otherwise,
yoursecuritysoftwaremaysuspectLoadRunner's
WebrecordingengineandpreventLoadRunnerfrom
launchingyourapplication.
c.Disablethedesktoptoolbar.TheCitrixadministrator
shoulddisablethedesktoptoolbar.Thereareseveral
waystodothis.AddConnectionBar=0tothe
default.icafile,orfollowthemethoddescribedin:
http://support.citrix.com/article/CTX122544.
(Relevantonlyforpublisheddesktops,notpublished
applications.)
d. InternetExplorerSettings.
i.WhenworkingwithInternetExplorer8orlater,
ensurethattheEnableSmartScreenFilteroption
(InternetOptions>Advanced)isnotselected.
ii.WhenrecordingontheCitrixWebInterfacefrom
aWindowsserveroperatingsystem,Internet
ExplorerEnhancedSecurity(IEESC)mustbe
disabled.Thisoptionissetindifferentlocations
indifferentoperatingsystems.
Forexample,inWindows2008server,youset
thisoptionfromtheServerManager,usingthe
ConfigureIEESCoption.
e. VuGenSettings.
i.MakesurethatVuGenissettocreatescripts
containingonlyexplicitURLs.
IntheVuGenRecordingOptionsdialogbox,
selectGeneral>Recordingandclickthe
HTMLAdvancedbutton.IntheScripttypearea,
select:AscriptcontainingexplicitURLsonly.
ii.EnabletheCitrixserverSessionToken
correlationrules:
IntheVuGenRecordingOptionsdialogbox,
selectCorrelations>Rules,expandthe
Citrix_XenAppnodeandselecttherelevant
tokenoptionfortheCitrixversionyouareusing.
(Ifyouarenotsurewhichoptiontoselect,you
canselectallofthem.)

4. Set Your Citrix client to work in non-seamless mode

http://lrhelp.saas.hpe.com/en/latest/help/WebHelp/Content/VuGen/129550_t_how_to_configure_citrix_client_server.htm#InstallAgent 2/4
27/5/2016 HowtoSetUpYourCitrixEnvironment

LoadRunnercancreateCitrixscriptsonlyinnon
seamlessmode(clientopenswithinaCitrixICAwindow
andnotasalocalapplication).
IntheCitrixclient,selectPreferences>SessionSettings
andsetWindowsizetoNopreference.Thissettingis
savedacrossCitrixsettingsforthesameuser.
Alternatively,addTWIMode=Offinthedefault.icafileon
theserver.

5. Congure the Citrix Server

a. SessionDisconnect.Bydefault,whenaclienttimes
outordisconnectsfromtheCitrixserver,thesession
remainsopenforadefinedtimeperiod.However,
beginningaruninaCitrixsessionthathasan
unpredictablestatecancauseyourtesttofail.
Therefore,theCitrixserveradministratorshould
configuretheCitrixservertoend(reset)theclient
sessionwhenaclientdisconnectsforanyreason.
b. MultiSessionSupport.Ifyouaregoingtorunmore
thanoneCitrixVuseronaloadgenerator,ensure
thattheCitrixserverisconfiguredtoenablemultiple
sessionsperuser/client.

6. Install the LoadRunner Citrix Agent on the Citrix Server (Optional)

TheLoadRunnerCitrixAgentprovidesanadditionallevel
ofobjectorientedinformationabouttheCitrixpublished
applicationordesktopthatenablesyoutoimprovethe
functionalityandrobustnessofyourCitrixscript.Italso
providessomeextraenhancementsoverthenormal
Citrixfunctionality.Fordetails,seeAgentforCitrix
PresentationServerOverview.
a.Ifyouareupgradingtheagent,makesuretouninstall
thepreviousversionbeforeinstallingthenextone.
b.IfyourCitrixserverrequiresadministrator
permissionstoinstallsoftware,loginasan
administratortotheserver.
c.EnsurethatMicrosoftDEPisfullydisabled.
(DEPmustbedisabledwhenusingtheagent.)
d.Locatetheinstallationfile,SetupCitrixAgent.exe,on
theHPproductinstallationdiskintheAdditional
Components\AgentforCitrixServerfolder.
e.Followtheinstallationwizardtocompletion.
f.Toenableloggingfortheagent,setDebugEnabled=1
inthe[General]sectionofCtrxAgent.inifile.Thelog
http://lrhelp.saas.hpe.com/en/latest/help/WebHelp/Content/VuGen/129550_t_how_to_configure_citrix_client_server.htm#InstallAgent 3/4
27/5/2016 HowtoSetUpYourCitrixEnvironment

filewillbecreatedineithertheAgentsbin\folderor
insessions%TEMP%folder,dependingonuser
permissions.

Note:

Afterinstallation,theagentwillbeactive
onlyforLoadRunnerinvokedCitrixsessions
itwillnotbeactiveCitrixsessionsstarted
withoutLoadRunner.
Touninstall,selectHPSoftwareAgentfor
CitrixPresentationServerinthe
Add/RemoveProgramswindowonthe
servermachine.
TheCitrixagentwasdesignedtobecross
compatible,allowingyoutouseoneversion
ofLoadRunnerandyetanotherversionof
theagent.Itisrecommendedthatyouuse
themostrecentversionoftheagent.

Explore Connect Contact

HelpCenterHome BuyLoadRunner GetSupport

LastupdatedMay10,2016 HelpCenterTips LoadRunnerBlogs
andCommunity
19932016HewlettPackard
EnterpriseDevelopmentLP

http://lrhelp.saas.hpe.com/en/latest/help/WebHelp/Content/VuGen/129550_t_how_to_configure_citrix_client_server.htm#InstallAgent 4/4