You are on page 1of 20

TS&T & IBM Version 1.

7








RLP Citrix Setup Guide











IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 2
Trademarks
IBM is a registered trademark of International Business Machines Corporation.
The following are trademarks of International Business Machines Corporation in the
United tates! or other countries! or "oth#
$I% &B' &B' Connect
&B' Uni(ersal &ata"ase &)&$ Informi*
MV MV+,$ -+'
-+./0 )ed"ooks 1
2e"phere 3+- 400
5a(a and all 5a(a6"ased trademarks are trademarks of un Micros7stems! Inc. in the
United tates! other countries! or "oth.
2indows! 2indows 8T and the 2indows logo are trademarks of Microsoft Corporation
in the United tates! other countries! or "oth.
Intel is a trademark of Intel Corporation in the United tates! other countries! or "oth.
U8I% is a registered trademark of The -pen 9roup in the United tates and other
countries.
:inu* is a trademark of :inus Tor(alds in the United tates! other countries! or "oth.
-ther compan7! product and ser(ice names ma7 "e trademarks or ser(ice marks of
others.






Januray 2014 diti!n " #ersi!n 1$%
The information contained in this document has not "een su"mitted to an7 formal IBM test and is distri"uted on an ;as
is< "asis without an7 warrant7 either e*press or implied. The use of this information or the implementation of an7 of
these techni=ues is a customer responsi"ilit7 and depends on the customer>s a"ilit7 to e(aluate and integrate them into
the customer>s operational en(ironment. 2hile each item ma7 ha(e "een re(iewed "7 IBM for accurac7 in a specific
situation! there is no guarantee that the same or similar results will result elsewhere. Customers attempting to adapt
these techni=ues to their own en(ironments do so at their own risk.

& C!pyri'(t Internati!na) Business Ma*(ines C!rp!rati!n 200+$ ,)) ri'(ts reser-ed$
T(is d!*ument may n!t .e repr!du*ed in /(!)e !r in part /it(!ut t(e pri!r /ritten permissi!n !0 IBM$

8ote to U.. 9o(ernment Users ? &ocumentation related to restricted rights ? Use! duplication or disclosure is su"@ect
to restrictions set forth in 9$ $&1 chedule Contract with IBM Corp.
IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 3
Ta.)e !0 *!ntents

1. ):1 Citri* $ccess )e=uirements........................................................................ 4
1.1. Intel 2orkstation )e=uirements .................................................................. 4
1.'. Classroom 8etwork )e=uirements ............................................................... 4
1... Incompati"le 8etwork Configurations........................................................... A
1.4. Unsupported Configurations........................................................................ A
'. etting Up Bor a )emote Class......................................................................... C
'.1. Installing Citri* -nline 1lug6in 1'................................................................ C
'.1.1. Installing 2indows Citri* -nline 1lug6in........................................................ C
'.'. Testing Dour Configuration.........................................................................10
'.'.1. )egular Connecti(it7 Test ..........................................................................11
'... Connect to the la" en(ironment .................................................................1.
'.4. 8etwork Configuration ..............................................................................14
'.4.1. $pplication :e(el 1ro*ies ...........................................................................14
'.4.'. 1ersonal Birewalls.....................................................................................14
'.4... Eow Citri* 2orks......................................................................................14
'.4.4. Collecting Dour :ocation>s Birewall Configuration...........................................14
'.4.A. Basic Connecti(it7 Test .............................................................................1A
'.A. Bi*ing Common 8etwork ,rror Messages .....................................................1C
.. Eints and Tips...............................................................................................1F
4. Trou"leshooting ............................................................................................1/




IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 4
1$ RLP Citrix ,**ess Re1uirements
1$1$ Inte) 2!rkstati!n Re1uirements
The computers to "e used for the class! including those at an7 remote locations
must meet the following re=uirements#
Minimum of 'AC MB of memor7
2indows %1! Vista or e(en G.'6"it or C46"its editionH
Internet ,*plorer C through / or Birefo* 1.* through A.*
1

Ge(en though C46"its "rowsers can work! we recommend 7ou to use the
.'6"its editionsH
1'F6"it encr7ption
Citri* )ecei(er Gsee Installing Citri* H
$ccess to Internet
-pen 7our "rowser and enter https#++ela"gatewa7.edu.ihost.com in the ,ddress
"ar. If 7ou can access the we"site! then 7ou ha(e Internet access. -therwise 7ou
will need to contact 7our local network support for assistance.
1$2$ C)assr!!m 3et/!rk Re1uirements
The rooms where the class will "e taught! including e(er7 remote student>s location!
must meet the following re=uirements#
,ach student will re=uire a minimum of .0 k"ps dedicated internet
"andwidth.
$ we" "rowser connection to https#++ela"gatewa7.edu.ihost.com on
port 44. GhttpsH.
1ro*7 rules that permit Citri* )ecei(er access to
ela"gatewa7.edu.ihost.com using IC$+: packets.

1
igher !er"ion" of #irefo$ may %or& "'((e""f'lly b't they are not offi(ially "'pporte) by Citri$

IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page *
1$4$ In*!mpati.)e 3et/!rk C!n0i'urati!ns
The following network configurations will not work with ):1 Citri* $ccess#
&ialup connections.
1ro*7 $utomatic Configuration G1$CH scripts loaded on the local machine
Gusing 0i)e566 under 7se aut!mati* *!n0i'urati!n s*ript in Internet
,*plorer>s L!*a) ,rea 3et/!rk 8L,39 Settin'sH. Use a 1$C script on a
we" ser(er Gusing (ttp566H instead.
2e" 1ro*7 $uto &isco(er7 G21$&H onl7 configurations. Contact 7our
location>s network administrator a"out alternati(e configurations.
1$4$ 7nsupp!rted C!n0i'urati!ns
The following configurations ma7 or ma7 not work with ):1 Citri* $ccess! "ut are
unsupported "7 ):1#
Citri* )ecei(ers under the following operating s7stems#
:inu*
U8I%
Macintosh

Though it is not supported "7 ):1 here are the re=uirements gi(en "7 Citri*.
Bor a :inu* workstation the re=uirements are#
:inu* kernel (ersion '.C.'/ or a"o(e! with gli"c '.7 or a"o(e! gtk '.1'.0 or
a"o(e! li"cap1 or li"cap' and ude( support
Dou can find more information on#
http#++support.citri*.com+proddocs+topic+recei(er+recei(ers6linu*6wrapper.html
Bor a Macintosh computer the re=uirements are#
Mac - % 10.C or Mac - % 10.7! .'6"it or C46"it
Intel6"ased processor
afari Version A.* or later
Mo3illa Birefo* Versions ..* through A.*
Dou can find more information on#
http#++support.citri*.com+proddocs+topic+recei(er+recei(ers6mac6wrapper.html
IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page +
2$ Settin' 7p :!r a Rem!te C)ass
2$1$ Insta))in' Citrix ;n)ine P)u'<in 12$4
$ Citri* -nline 1lug6in must "e installed on each computer that will "e used for ):1
Citri* $ccess. Bor most locations! no configuration is necessar7. Eowe(er! if 7ou
recei(e error messages! 7ou ma7 need to consult paragraph Testing Dour
Configuration.
2$1$1$ Insta))in' 2ind!/s Citrix ;n)ine P)u'<in
1. -pen a "rowser GMicrosoft Internet ,*plorer or Birefo*! see paragraph 1.4H
and connect to https#++ela"gatewa7.edu.ihost.com
'. :og on with the userid ;ela"< and password ;passw0rd< Gwith a 3eroH.


.. If the s7stem in(ites 7ou to install a plug6in! check the Citri* :icence
$greement "o* and click Install otherwise 7our we" "rowser is read7

4. elect ;-nline plug6in 1'..<.
IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page ,

If 7ou can>t see correctl7 this we" page! cop7+paste the link "elow in 7our
we" "rowser
http#++www.citri*.com+downloads+citri*6recei(er+legac76client6software.html

A. elect ;&ownload< Citri* -nline plug6in.



C. $ccept :icense $greement.
IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page -



7. elect ;&ownload 8ow<.


F. elect ;Install<.

IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 9



/. Choose to sa(e the file in ;M7 &ocuments< folder.


10. $t the end of the download! open ;m7 documents< folder and launch the
setup program 7ou ha(e @ust sa(ed.






11. 2ait for the end of the plugin installation

IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 10



1'. $s soon as the setup is complete press -I.


1.. 9o "ack to 7our we" "rowser. Dou ma7 ha(e to accept Citri* Eelper Control
$cti(e % e*ecution. Click on ;This we"site wants to run the following add6
on# JCitri* Eelper Control> fromK<! and ;)un $cti(e% Control<.

14. The Citri* -nline 1lug6in is installed.


2$2$ Testin' =!ur C!n0i'urati!n
1lease run this test "efore class "egins so that pro"lems can "e detected and
corrected "efore students arri(e. This test must "e run at each location where a
student will "e working! including separate classrooms and remote locations.
IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 11
2$2$1$ Re'u)ar C!nne*ti-ity Test
1. -pen 7our "rowser.
'. ,nter https#++ela"gatewa7.edu.ihost.com in the $ddress field and press
,nter.
.. Dou should see a logon screen.
IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 12
4. ,nter the userid ;ela"< and the password ;passw0rd< Gwith a 3eroH.


A. Click the T,T D-U) C-88,CTI-8 icon.


C. $ Citri* window appears# ;Citri* )ecei(er connecting<.

7. In a moment! a countdown timer appears.







IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 13

F. If the message sta7s running for appro*imatel7 A minutes! click the ok
"utton to close the message. Dou ha(e successfull7 completed the regular
connecti(it7 test and 7ou do not need to do an7 further testing.









/. If the window disappears! 7ou ma7 ha(e a firewall timeout on 7our network.
)un the test again and if it disappears after "eing connected for the same
amount of time as "efore! there is a timeout set on 7our firewall. Dou will
need to contact 7our network administrator to ena"le longer connectionsL
otherwise students will "e regularl7 disconnected.
10. If 7ou recei(e an7 errors! see 8etwork configuration or Trou"leshooting.

2$4$ C!nne*t t! t(e )a. en-ir!nment
-nce the test is successful! 7ou can connect to 7our la" en(ironment.
If 7ou are still connected to https#++ela"gatewa7.edu.ihost.com with the ela" user
id! 7ou ha(e to logoff first# click on ;:og -ff< link.

Then reconnect#
Bor I:T GInstructor :ed TrainingH or I:- GInstructor :ed -nlineH Class deli(er7#
using the information gi(en "7 7our Teacher
IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 14
2$4$ 3et/!rk C!n0i'urati!n
,rrors generall7 result from a firewall or pro*7 not configured to permit traffic
IC$+: traffic through it. If 7ou recei(e an error! we recommend running the
;Testing 7our configuration< "elow and then ;Collecting 7our location>s firewall
configuration<.
2$4$1$ ,pp)i*ati!n Le-e) Pr!xies
If 7our location is using application le(el pro*ies! 7ou will need to contact 7our
location>s network administrator to permit the Citri* )ecei(er to connect to
ela"gatewa7.edu.ihost.com.
2$4$2$ Pers!na) :ire/a))s
1ersonal firewalls Gsuch as Mone :a"s Integrit7 &esktop and 8orton 1ersonal
BirewallH can permit or "lock traffic "ased on the application and+or port. Make
sure than an7 personal firewall is configured to permit the Citri* )ecei(er
GN1rogramBilesNOCitri*Oicawe".'Owfica.'.e*e for the we" client and
N1rogramBilesNOCitri*OIC$ ClientOwfica.'.e*e for the full packageH access to
the internet using port 44. GhttpsH.
2$4$4$ >!/ Citrix 2!rks
2hen 7ou click on an icon in the ):1 Citri* application page! Internet ,*plorer
downloads a small configuration file Gthe IC$ fileH. 2indows loads Citri* )ecei(er
with that file and then tries to connect to the application specified in the IC$ file
on ela"gatewa7.edu.ihost.com (ia IC$+: Gport 44.H using the network
configuration read from "oth 7our "rowser and the IC$ file. The Citri* ser(er
ela"gatewa7.edu.ihost.com starts the application on one of the machines in the
cluster Gthe hostH and then acts as an encr7pted -CI pro*7 "etween the
Citri* )ecei(er Gor the pro*7 ser(er for 7our location>s networkH and the host.
2$4$4$ C!))e*tin' =!ur L!*ati!n?s :ire/a)) C!n0i'urati!n
Before contacting the Eelp &esk! we recommend collecting 7our location>s
firewall configuration in order to ha(e the information read7 when the Techs ask
how 7our network is configured.
1. -n a computer with a working Internet connection! open up Internet
,*plorer.
'. elect T!!)s on the menu "ar and then select Internet ;pti!ns@ in the
menu.
IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 1*
.. Click the C!nne*ti!ns ta".
4. Click the L,3 Settin's@ "utton.
A. If onl7 ;$utomaticall7 detect< settings is checked! 7ou are using 2e"
1ro*7 $uto &isco(er7 G21$&H. 21$& is not a compati"le configuration.
Contact 7our location>s network administrator a"out alternati(e
configurations.
C. If the Use configuration script check "o* is checked! 7ou are using a
1ro*7 $utomatic Configuration G1$CH script. 8ote the entr7 in the
$ddress "o*. If the address is a local file Git "egins with file#++H! e:a"s will
not work. Contact 7our location>s network administrator a"out using a
ser(er "ased 1$C script Gone that "egins with an http#++ address.H or a
different configuration.
7. If the 7se a pr!xy ser-er for 7our :$8 check "o* is checked! 7ou are
using one of a (ariet7 of pro*7 configurations#
i. If the ,ddress and P!rt fields are filled in! 7ou are using a single
pro*7. 8ote the contents of those two fields.
ii. If those fields are not checked! click the ,d-an*ed@ "utton.
iii. If onl7 the S!*ks field and P!rt is filled in! 7ou are using a -CI
pro*7ing. 8ote the contents of those two fields.
i(. If se(eral of the fields are filled in! 7ou are using multiple pro*ies.
8ote what is in each field and the associated port.
F. If nothing is checked! 7ou are using Transparent 1ro*7ing.

2$4$A$ Basi* C!nne*ti-ity Test
Bor locations using destination or traffic pro*ies! 7ou can test the "asic
connecti(it7 of 7our network using telnet should the regular connecti(it7 test
fail. GThis test ma7 not work for sites using application le(el pro*ies.H If 7ou
ha(e pro"lems with connecting to ):1 Citri* ser(er! 7ou should run this test.
1. -pen a command prompt.
'. ,nter te)net e)a.'ate/ay$edu$i(!st$*!m 444 and press ,nter.
'

.. The message C!nne*tin' T! e)a.'ate/ay$edu$i(!st$*!m$$$ should
flash on the screen and then the screen should go "lank. If 7ou press
a ke7! 7ou will "e returned to the command prompt.
4. T7pe exit and press ,nter to close the command prompt.

2
.elnet (lient i" not in"talle) by )efa'lt on /in)o%" Se!en
IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 1+
If 7ou recei(e the message C!nne*tin' T!
e)a.'ate/ay$edu$i(!st$*!m$$$C!u)d n!t !pen *!nne*ti!n t! t(e
(!stB !n p!rt 4445 C!nne*t 0ai)ed! 7our firewall is "locking access
to ):1 Citri* ser(ers or 7our location is using application le(el pro*ies.

2$A$ :ixin' C!mm!n 3et/!rk rr!r Messa'es

SSLRe)ay rr!r 40
This error indicates that the Citri* )ecei(er cannot connect to
ela"gatewa7.edu.ihost.com. There are two reasons wh7 7ou will recei(e this
error message. The first is that Citri* )ecei(er cannot resol(e the full
=ualified domain name GBP&8H. Verif7 that the computer has the right
network configuration for 7our location. If that does not fi* the pro"lem! then
open the hosts file GNwindirNOhosts for 2indows /F Q Me and
NwindirNOs7stem.'Odri(ersOetcOhosts for 2indows 8T 4.0! '000! %1! Q
'00.H in 8otepad and add the following line to the end of the file#
1'/..A.1C1.40 ela"gatewa7.edu.ihost.com
8ote that the line should contain the I1 address! followed "7 an7 amount of
white space Gta"s or spacesH! and then the BP&8. a(e the file and tr7 to
connect to the application again.
The second reason is that Citri* )ecei(er detected the network configuration
incorrectl7 and the Citri* )ecei(er is tr7ing to use ela"gatewa7.edu.ihost.com
as the pro*7 for 7our network. Contact the Eelp &esk for information on
o(erriding the Citri* )ecei(er>s pro*7 configuration. 1lease collect 7our
location>s firewall configuration "efore calling.

SSL rr!r 4
Dour location>s network ma7 "e using application6le(el pro*ies. )un the
;Testing 7our configuration<. If it fails! contact 7our location>s network
administrator to permit IC$+: traffic through the firewall. If it passes!
contact the Eelp &esk.
T(e Citrix SSL ser-er y!u se)e*ted is n!t a**eptin' *!nne*ti!ns$
IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 1,
$ firewall is "locking the Citri* )ecei(er from reaching
ela"gatewa7.edu.ihost.com. Verif7 that an7 personal firewall is properl7
configured Gsee 1ersonal BirewallsH. If configuring a personal firewall does not
correct the pro"lem or there is no personal firewall installed! then contact
7our location>s network administrator.
IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 1-
4$ >ints and Tips

,na"ling mouse pointer shadows in (irtual machines will cause dou"le cursors
and make the mouse less responsi(e.
In 2indows %1 (irtual machines! lea(ing the s7stem set to ,dCust 0!r .est
per0!rman*e Gright6click on My C!mputer! select Pr!perties! select the
,d-an*ed ta"! click Settin's in the Per0!rman*e "o*! and click ;D "ack to
the desktopH will impro(e performance.
IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 19
4$ Tr!u.)es(!!tin'

Problem Solution
Uninstall Citri* )ecei(er! re"oot 7our
s7stem and reinstall Citri* )ecei(er
Clicking on icon results in message
;penB Sa-e !r *an*e) Laun*($i*a
Internet ,*plorer must "e set as the
default we" "rowser.
Clicking on icon results in message 3!
IC, 0i)e 0!und
)ight6click on Virtual 1C icon and select
Sa-e<,s. a(e Laun*($i*a to desktop
and then open Laun*($i*a Gdou"le clickH.
Clicking on icon results in message
SSL R!ute n!t 0!und
Make sure that Internet ,*plorer is set as
the &efault Browser.
Clicking on icon results in message
SSL rr!r 4.
Clicking on icon results in message
SSLRe)ay rr!r 40.
Clicking on icon results in message
T(e Citrix SSL ser-er y!u se)e*ted
is n!t a**eptin' *!nne*ti!ns$
ee ;Testing Dour Configuration<. If those
instructions do not help! contact the Eelp
&esk.
Clicking on icon results in message
SSL rr!r A.
$fter clicking the icon! Citri* will
connect and a window "ut disappears
immediatel7.
,pp)i*ati!n )imit rea*(ed error
,)) ser-ers are d!/n error appears.
Contact the Eelp &esk.
=!ur administrat!r (as disa.)ed
t(is app)i*ati!n error appears.
)efresh the we" page and tr7 again. If the
icon disappears and 7ou need access to it!
contact the Eelp &esk.
$nother user is using the same username
and connected to the same session. Verif7
that each student is using a uni=ue
username.
User is suddenl7 disconnected.
Verif7 local internet access.
Virtual machine loads in read6onl7
mode or refuses to load.
Two users are tr7ing to access the same
student account at the same time.
tudents should each use their own
separate user I&s.
IBM PSSC Montpellier - Central Lab Platform


Copyright IBM 2009 Page 20
Problem Solution
$ student got disconnected and the old
session has not e*pired. Contact the Eelp
&esk to reset the I&.
8um"ers are appearing instead of
letters when t7ping.
8um :ock is on. Toggle the 8um :ock ke7.
Virtual machine is sluggish.
&ou"le cursors.
Mouse is sluggish.
ee Eints and Tips for wa7s to impro(e
performance.