Parent page: Internet and Networking

The Citrix ICA Client (=Citrix Receiver) allows access to remote Windows sessions run from a Citrix server.

DON'T PANIC: This page is long, but you only need to read the sections that are specific to your version. Instructions for older/unsupported Ubuntu and ICA versions are at CitrixICAClientHowToOlderVersions.

If you are using the XenApp web plugin, which is NOT exactly the same as the ICA Client, you should also see this page: CitrixXenAppPlugin. You will need to have libxaw7 installed, but no wfcmgr (the Citrix ICA Client executable) and OpenMotif.

If you are considering deployment of the Receiver in your workplace (as opposed to installation on just your machine), have a look at the Citrix Receiver deployment how-to in the Ubuntu for the Enterprise wiki.

If you are running KDE 4.10 or a newer version, you need to make sure that in System Settings that GTK is set to a theme other than Oxygen as this will cause the Citrix Receiver to constantly crash when trying to launch fullscreen applications (such as Terminal Servers or VDI).

Citrix Receiver 13.0 on Ubuntu 13.10 64-bit

1. Install the dependencies

By executing the following command:

sudo dpkg --add-architecture i386 # only needed once
sudo apt-get update
sudo apt-get install nspluginwrapper lib32z1 libc6-i386 libxml2:i386 libstdc++6:i386 libxerces-c3.1:i386 libcanberra-gtk-module:i386 libcurl3:i386 libasound2-plugins:i386 libgstreamer-plugins-base0.10-0:i386

2. Check out a fixed version of the .deb

git clone https://github.com/CloCkWeRX/citrix-receiver-ubuntu-fixed.git ica_temp
dpkg -b ica_temp icaclient-modified.deb

Skip to step 4

2. (Manual alternative) Get the official Citrix Receiver 13.0 .deb

from: https://www.citrix.com/downloads/citrix-receiver/linux/receiver-for-linux-130.html

Note: Get the download from the "For 64-bit Systems" section. The Download popup doesn't work in chrome, use Firefox.

3. (Manual alternative) Fix the broken .deb package manually

The .deb package is broken. You can fix it using the following commmands:

cd ~/Downloads
mkdir ica_temp
dpkg-deb -x icaclient_13.0.0.256735_amd64.deb ica_temp
dpkg-deb --control icaclient_13.0.0.256735_amd64.deb ica_temp/DEBIAN
sudo gedit ica_temp/DEBIAN/control

And change the line that starts with "Depends: ..." to:

Depends: libc6-i386 (>= 2.7-1), lib32z1, nspluginwrapper

Now, change the postinst script:

sudo gedit ica_temp/DEBIAN/postinst

And change line 2283 from:

echo $Arch|grep "i[0-9]86" >/dev/null

To

echo $Arch|grep -E "i[0-9]86|x86_64" >/dev/null

Now rebuild the package

dpkg -b ica_temp icaclient-modified.deb

4. Install the fixed package

sudo dpkg -i icaclient-modified.deb

5. Add more SSL certificates

Some sites can give an SSL error. Firefox has many more certificates than does Citrix, so add them: e.g.

sudo ln -s /usr/share/ca-certificates/mozilla/* /opt/Citrix/ICAClient/keystore/cacerts/
sudo c_rehash /opt/Citrix/ICAClient/keystore/cacerts

6. Accessing your PC Drive

To set up Citrix Receiver Preferences use:

/opt/Citrix/ICAClient/util/configmgr &

Under the tab "File Access" you can add a Mapped Drive.

7. Possible problem - invisible/corrupted windows

Some people have experienced that applications started via Citrix Receiver 13.0 do not show their windows properly - just random fragments appear. It is not clear if this is a bug in the graphics library that Citrix has adopted with this version and/or its interaction with certain Citrix server configurations. If you experience this, you are likely to have better success with version 12.1, see below.

Citrix Receiver 12.1 on Ubuntu 14.04 64-bit

1. Install the dependencies

libmotif4:i386 nspluginwrapper lib32z1 libc6-i386 libxp6:i386 libxpm4:i386 libasound2:i386

by executing the following command:

sudo apt-get install libmotif4:i386 nspluginwrapper lib32z1 libc6-i386 libxp6:i386 libxpm4:i386 libasound2:i386

2. Get the official Citrix Receiver 12.1 .deb

from: https://www.citrix.com/downloads/citrix-receiver/receivers-by-platform/receiver-for-linux-121.html

Note: Get the download from the "For 64-bit Systems" section. If the Download popup doesn't work in Chrome, use Firefox.

3. Fix the broken .deb package

The .deb package is broken. You can fix it using the following commmands:

cd ~/Downloads
mkdir ica_temp
dpkg-deb -x icaclient_12.1.0_amd64.deb ica_temp
dpkg-deb --control icaclient_12.1.0_amd64.deb ica_temp/DEBIAN
sudo gedit ica_temp/DEBIAN/control

And change the line that starts with "Depends: ..." to:

Depends: libc6-i386 (>= 2.7-1), lib32z1, nspluginwrapper, libxp6:i386, libxpm4:i386

Now, change the postinst script:

sudo gedit ica_temp/DEBIAN/postinst

And change line 2648 from:

echo $Arch|grep "i[0-9]86" >/dev/null

to:

echo $Arch|grep -E "i[0-9]86|x86_64" >/dev/null

(Note the -E flag!) Now rebuild the package

dpkg -b ica_temp icaclient-modified.deb

4. Install the fixed package

sudo dpkg -i icaclient-modified.deb

5. Add more SSL certificates

Some sites can give an SSL error. Firefox has many more certificates than does Citrix, so add them: e.g.

sudo ln -s /usr/share/ca-certificates/mozilla/* /opt/Citrix/ICAClient/keystore/cacerts/

6. Accessing your PC Drive etc

To run the Citrix Receiver Preferences use:

/opt/Citrix/ICAClient/wfcmgr &

Under Tools | Settings you can select the Preferences dropdown, then Drive Mapping, and add a Mapped Drive, or set other preferences.

Citrix Receiver 12.1 on Ubuntu 13.10 64-bit

1. Install the dependencies

libmotif4:i386 nspluginwrapper lib32z1 libc6-i386 libxp6:i386 libxpm4:i386

by executing the following command:

sudo apt-get install libmotif4:i386 nspluginwrapper lib32z1 libc6-i386 libxp6:i386 libxpm4:i386

2. Get the official Citrix Receiver 12.1 .deb

from: https://www.citrix.com/downloads/citrix-receiver/receivers-by-platform/receiver-for-linux-121.html

Note: Get the download from the "For 64-bit Systems" section. If the Download popup doesn't work in Chrome, use Firefox.

3. Fix the broken .deb package

The .deb package is broken. You can fix it using the following commmands:

cd ~/Downloads
mkdir ica_temp
dpkg-deb -x icaclient_12.1.0_amd64.deb ica_temp
dpkg-deb --control icaclient_12.1.0_amd64.deb ica_temp/DEBIAN
sudo gedit ica_temp/DEBIAN/control

And change the line that starts with "Depends: ..." to:

Depends: libc6-i386 (>= 2.7-1), lib32z1, nspluginwrapper, libxp6:i386, libxpm4:i386

Now, change the postinst script:

sudo gedit ica_temp/DEBIAN/postinst

And change line 2648 from:

echo $Arch|grep "i[0-9]86" >/dev/null

to:

echo $Arch|grep -E "i[0-9]86|x86_64" >/dev/null

(Note the -E flag!) Now rebuild the package

dpkg -b ica_temp icaclient-modified.deb

4. Install the fixed package

sudo dpkg -i icaclient-modified.deb

5. Add more SSL certificates

Some sites can give an SSL error. Firefox has many more certificates than does Citrix, so add them: e.g.

sudo ln -s /usr/share/ca-certificates/mozilla/* /opt/Citrix/ICAClient/keystore/cacerts/

6. Accessing your PC Drive etc

To run the Citrix Receiver Preferences use:

/opt/Citrix/ICAClient/wfcmgr &

Under Tools | Settings you can select the Preferences dropdown, then Drive Mapping, and add a Mapped Drive, or set other preferences.

Citrix Receiver 12.1 on Ubuntu 13.04 64-bit

1. Install packages

libmotif4:i386 nspluginwrapper

Either by executing the following command:

sudo apt-get install libmotif4:i386 nspluginwrapper

Or by installing Open Motif - shared libraries using your package manager of choice (e.g., Ubuntu Software Centre).

2. Get the official Citrix Receiver 12.1 .deb from https://www.citrix.com/downloads/citrix-receiver/receivers-by-platform/receiver-for-linux-121.html

Note: Get the download from the "For 64-bit Systems" section.

3. Install the downloaded .deb running the following command in the folder where you stored the download (note the version of the downloaded file may differ if it's more recent that these instructions):

sudo dpkg --install Downloads/icaclient_12.1.0_amd64.deb

This installation will likely throw the following error:

dpkg: error processing icaclient (--install):
 subprocess installed post-installation script returned error exit status 2
Errors were encountered while processing:
 icaclient

This can be resolved by changing line 2648 in /var/lib/dpkg/info/icaclient.postinst:

echo $Arch|grep "i[0-9]86" >/dev/null

to:

echo $Arch|grep -E "i[0-9]86|x86_64" >/dev/null

Then execute the following command:

sudo dpkg --configure icaclient

4. Try accessing your site. You may find that this gives an SSL error, that you do not trust the relevant site. Firefox has many more certificates than does Citrix, so add them: e.g.

sudo ln -s /usr/share/ca-certificates/mozilla/* /opt/Citrix/ICAClient/keystore/cacerts/

TODO: add options for other browsers.

Citrix ICA Client 12.1 on Ubuntu 12.10 64-bit

1. Install packages

libmotif4 flashplugin-installer curl nspluginwrapper ia32-libs

using your package manager of choice (e.g., aptitude). Note that just installing package=libmotif4 worked for me (Dec 2012); I did not need to subsequently make symlinks in /usr/bin (as noted in other sections below).

2. Get the Citrix Receiver 12.1 .deb, either

3. Install the downloaded .deb via, e.g.,

sudo dpkg -i icaclient_12.1.0_amd64.deb

This will probably fail, but dpkg will tell you what dependencies are unsatisfied. So install those packages, and remove package=icaclient_12.1.0 if your package manager (e.g., aptitude) wants to. Then reinstall icaclient_12.1.0_amd64.deb; loop if required.

4. Firefox has many more certificates than does Citrix, so add them: e.g.

sudo ln -s /usr/share/ca-certificates/mozilla/* /opt/Citrix/ICAClient/keystore/cacerts/

TODO: add options for other browsers.

5. Try accessing your Citrix site (in my case, here). Note that Firefox 17 will open launch.ica in an editor! but I'm able to access my site, login, and access applications.

Citrix ICA Client 12 on Ubuntu 12.04 64-bit

Install the 32-bit version of Citrix client. You can find the .deb from the citrix download page. Hooray for multi-arch!

If you want to use wfcmgr, install required library:

sudo apt-get install libmotif4:i386

Configuring Firefox

Attempt to access your Citrix site. If Firefox prompts you to open a *.ica file, choose to open it with /opt/Citrix/ICAClient/wfica.sh, and tell Firefox to remember that choice.

Missing Certificates

Note that the ICA client for linux is missing lots of certificates - you may need to copy in your CA's root certificates, e.g.

sudo cp /usr/share/ca-certificates/mozilla/* /opt/Citrix/ICAClient/keystore/cacerts

Video Refresh Issue

If you experience strange video refresh, e.g. strange screen paint behaviour, it may be because of an apparent conflict with compiz and the ICA client. To work around, sign out and change your desktop session from 'unity' to 'unity-2d'.

This issue appears to be related to AMD64 (e.g. Bulldozer), and some Radeon video chips.

Citrix ICA Client 12.1 on Ubuntu 11.10 64-bit

This is available as a .deb from the Citrix site:

http://www.citrix.com/English/SS/downloads/details.asp?downloadId=2323812&productId=1689163

Beware - this should be used with caution as it will install with an error. The postinst script exits 2 as it fails to correctly determine the architecture of the system. The ICAClient package will function, but APT will complain that ICAClient is "not fully installed or removed" and you will get errors each time you use a package manager.

This can be fixed by unpacking the .deb and editing the regular expression in line 2648 of the postinst script to match x86_64. Replace grep "i[0-9]86i" with grep -E "i[0-9]86i|x86_64". Then rebuild the .deb (or use this rebuilt .deb).

Alternatively /var/lib/dpkg/info/icaclient.postinst can be edited after an installation that gives an error and  apt-get -f install  can be run afterwards.

Note that although flagged as a 64-bit package, this will simply pull in the required compatibility libs - it is not a true 64-bit version.

Citrix ICA Client 12.1 on Ubuntu 11.10 32-bit

Download and install the 32-bit version of libmotif 3 and create a symlink:

wget -c http://nl.archive.ubuntu.com/ubuntu/pool/multiverse/o/openmotif/libmotif3_2.2.3-4_i386.deb
dpkg -i libmotif*i386.deb
ln -s /usr/lib/libXm.so.3 /usr/lib/libXm.so.4

Download the Citrix Receiver 12.1 .deb files for 'Receiver for Linux 12.1' and the 'USB Support Package' from:

http://www.citrix.com/English/ss/downloads/details.asp?downloadId=2323812&productId=1689163

Install the .deb files with the Ubuntu Software Manager.

Install or update the Adobe Flash Player plugin and update cURL for HDX Flash redirection.

sudo apt-get install flashplugin-installer
sudo apt-get install curl

Run hdxcheck.sh, which was installed with the Citrix Receiver:

/opt/Citrix/ICAClient/util/hdxcheck.sh

Look back through the messages displayed to check that it found libjpeg.so, as it might fail to do so despite it being installed. If it failed to find it then you can edit /opt/Citrix/ICAClient/util/hdxcheck.sh and change

Lib=find *libjpeg.so*

to

Lib=find / -name *libjpeg.so*

Configuring Firefox

Attempt to access your Citrix site. If Firefox prompts you to open a .ica file, choose to open it with /opt/Citrix/ICAClient/wfica.sh, and tell Firefox to remember that choice.

You might see the following error when accessing remote sessions:

Citrix Receiver
SSL error
Contact your help desk with the following information:
You have not chosen to trust"/C=US/ST=/L=/O=Equifax/OU=Equifax Secure Certificate Authority/CN=", the issuer of the server's security certificate ((SSL error 61).


If you see the above error, make Firefox's certificates accessible to Citrix using the following:

sudo ln -s /usr/share/ca-certificates/mozilla/* /opt/Citrix/ICAClient/keystore/cacerts

Citrix ICA Client 12 on Ubuntu 11.10 32-bit and 64-bit

Install the appropriate 32-bit or 64-bit Citrix client .deb from the download page (currently here) Secondary click the file and click Open with "Ubuntu Software Center".

To prevent the following error when accessing remote sessions:

Citrix Receiver
SSL error
Contact your help desk with the following information:
You have not chosen to trust"/C=US/ST=/L=/O=Equifax/OU=Equifax Secure Certificate Authority/CN=", the issuer of the server's security certificate ((SSL error 61).


Make Firefox's certificates accessible to Citrix, e.g.,

sudo ln -s /usr/share/ca-certificates/mozilla/* /opt/Citrix/ICAClient/keystore/cacerts

Accessing your PC Drive and Local Printer from a Citrix Session

Printing

Your default Ubuntu printer should be available within the Citrix session automatically

In Presentation Server 3/4, the name will be something like - 'PIXMA-IP4000 [UPD:PS] (from APAC-whcold_sin) in session 1' using driver 'HP Color LaserJet PS'

If you do not see a printer like this, ask your Citrix Administrator to check that the 'HP Color LaserJet PS' driver is installed on the Presentation Server.

Accessing your PC Drive

Run the Citrix Client Manager

/usr/lib/ICAClient/wfcmgr &

wfcmgr-drivemapping.png

Choose Tools/Settings/Preferences/Drive Mapping

Choose settings similar to the attached screen-shot

The Read & Write Access options have 3 settings - enabled, disabled(X), and prompt(?)

Click the 'Apply' button, then 'OK'

If you do NOT see a C: drive in your Citrix session - or it is already being used for another drive - don't worry - you will see your Ubuntu folder in Windows Explorer under My Network Places - Entire Network - Client Network - \\Client - \\Client\C$. At the command prompt or in batch files, use the UNC \\Client\C$.   Note: The C$ must be uppercase.

You can do likewise with other drives - D:, E:, etc. and create drives \\Client\D$, \\Client\E$, etc. in your Citrix session. It is usual practice to assign A: and B: to floppy drives.


CategorySystem CategoryNetworking

CitrixICAClientHowTo (last edited 2014-04-20 06:17:42 by daniel-oconnor)