Howto Setup the Citrix ICA Client on Ubuntu

The Citrix ICA Client allows access to remote Windows sessions run from a Citrix server. If you are only using the XenApp web plugin, you may not need to

• install or run wfcmgr (the Citrix ICA Client executable)

• install OpenMotif

but you will need to have libxaw7 installed. If you do need the Citrix ICA Client, this guide explains how to install it.

Citrix ICA Client 11 on Ubuntu versions 8.04 - 10.10

32-bit

Install Citrix's 32-bit client from its linux clients download page (currently ), then add any needed libraries and make them work with your system.

install client

Install the 32-bit Citrix client. This can be done in at least 2 ways:

debian package

To install the :

1. Download the debian package (currently ) to some temp directory, e.g. /tmp/citrix

2. Install the debian package, with, e.g.,
   

DOWNLOAD_DIR="/tmp/citrix"
DEB_FN="icaclient_11.100_i386.patched.deb"
pushd ${DOWNLOAD_DIR}
sudo dpkg -i --force-architecture ${DEB_FN}

tarball

1. Download the linux client tarball (currently ) to some temp dir, e.g. /tmp/citrix

2. Extract the tarball, e.g. (change parameters as necessary)
   

DOWNLOAD_DIR="/tmp/citrix"
TARBALL_FN="linuxx86-11.0.140395.tar.gz"
pushd ${DOWNLOAD_DIR}
tar xfz ${TARBALL_FN} # add '> /dev/null' for quiet

3. From the download directory, run the text-mode installer
   

sudo ./setupwfc

• Take the option to "Install Citrix Receiver"

4. Install to
   

/usr/lib/ICAClient

• Choose additional options as needed, and quit the installer.

test installed client

1. Check to see that the installer created

   • the executable /usr/lib/ICAClient/wfcmgr

   • a launcher like Applications>Internet>Citrix Receiver or Internet>Citrix Receiver

2. Check that /usr/lib/ICAClient/wfcmgr has needed libraries, e.g.

CLIENT_EXEC="/usr/lib/ICAClient/wfcmgr"
ldd ${CLIENT_EXEC}

• You will probably get results like

linux-gate.so.1 => (0xf77a3000)
libXm.so.4 => not found
libXp.so.6 => /usr/lib32/libXp.so.6 (0xf777f000)
libXpm.so.4 => /usr/lib32/libXpm.so.4 (0xf776c000)
libSM.so.6 => /usr/lib32/libSM.so.6 (0xf7763000)
libICE.so.6 => /usr/lib32/libICE.so.6 (0xf7748000)
libXmu.so.6 => /usr/lib32/libXmu.so.6 (0xf772f000)
libdl.so.2 => /lib32/libdl.so.2 (0xf772b000)
libpthread.so.0 => /lib32/libpthread.so.0 (0xf7712000)
libc.so.6 => /lib32/libc.so.6 (0xf75cd000)
libXt.so.6 => /usr/lib32/libXt.so.6 (0xf757a000)
libX11.so.6 => /usr/lib32/libX11.so.6 (0xf744b000)
libXext.so.6 => /usr/lib32/libXext.so.6 (0xf743b000)
libXau.so.6 => /usr/lib32/libXau.so.6 (0xf7437000)
libuuid.so.1 => /lib32/libuuid.so.1 (0xf7431000)
/lib/ld-linux.so.2 (0xf77a4000)
libxcb.so.1 => /usr/lib32/libxcb.so.1 (0xf7413000)
libXdmcp.so.6 => /usr/lib32/libXdmcp.so.6 (0xf740e000)

• Note the not found above. If you don't get one of those, try just running /usr/lib/ICAClient/wfcmgr: if that launches the Citrix Receiver with no errors, you're done, and you can probably exit these instructions. If not, proceed to next step.

install 32-bit libraries

Install all needed 32-bit libraries, e.g. libXm.so.4

1. Install motif and create a symlink to the latest similar library
   

sudo aptitude install libmotif3
ls -al /usr/lib/libXm.so*
# if the latest version is libXm.so.3.0.2, then
sudo ln -s /usr/lib/libXm.so.3.0.2 /usr/lib/libXm.so.4

2. Repeat running ldd until all libraries are found. I.e.
   

CLIENT_EXEC="/usr/lib/ICAClient/wfcmgr"
ERROR_STRING='not found'
ldd ${CLIENT_EXEC} | fgrep -e "${ERROR_STRING}"

• should produce no output.

run client

1. Run the native client from a terminal, e.g.

/usr/lib/ICAClient/wfcmgr

• The Citrix Receiver should launch with no errors. Choose Connections>Exit to quit the native client.
  If you see errors in the terminal, use the terminal messages to guide your efforts. You may need to repeat steps above.

• Run the client from the Ubuntu launcher noted above, e.g., Applications>Internet>Citrix Receiver or Internet>Citrix Receiver

64-bit

If Citrix provides a 64-bit client at its linux clients download page (currently ) download and install that. Unfortunately, at the moment (6 Aug 2010) it does not, so you will need to also install 32-bit libraries and make them work with your 64-bit system.

1. Install the 32-bit Citrix client.

1. Install ia32 libraries which are needed during installation

   sudo apt-get install ia32-libs

2. Download the linux client tarball (currently ) to some temp dir, e.g. /tmp/citrix

3. Extract the tarball, e.g. (change parameters as necessary)

DOWNLOAD_DIR="/tmp/citrix"
TARBALL_FN="linuxx86-11.0.140395.tar.gz"
pushd ${DOWNLOAD_DIR}
tar xfz ${TARBALL_FN} # add '> /dev/null' for quiet

4. From the download directory, run the text-mode script

sudo ./setupwfc

• Take the option to "Install Citrix Receiver", then install to the default directory

/usr/lib/ICAClient

• and exit.

• Check to see that it created the executable /usr/lib/ICAClient/wfcmgr (and also Applications>Internet>Citrix Receiver, though that's just a link).

• Check that /usr/lib/ICAClient/wfcmgr has needed libraries, e.g.

CLIENT_EXEC="/usr/lib/ICAClient/wfcmgr"
ldd ${CLIENT_EXEC}

• You will probably get results like

linux-gate.so.1 => (0xf77a3000)
libXm.so.4 => not found
libXp.so.6 => /usr/lib32/libXp.so.6 (0xf777f000)
libXpm.so.4 => /usr/lib32/libXpm.so.4 (0xf776c000)
libSM.so.6 => /usr/lib32/libSM.so.6 (0xf7763000)
libICE.so.6 => /usr/lib32/libICE.so.6 (0xf7748000)
libXmu.so.6 => /usr/lib32/libXmu.so.6 (0xf772f000)
libdl.so.2 => /lib32/libdl.so.2 (0xf772b000)
libpthread.so.0 => /lib32/libpthread.so.0 (0xf7712000)
libc.so.6 => /lib32/libc.so.6 (0xf75cd000)
libXt.so.6 => /usr/lib32/libXt.so.6 (0xf757a000)
libX11.so.6 => /usr/lib32/libX11.so.6 (0xf744b000)
libXext.so.6 => /usr/lib32/libXext.so.6 (0xf743b000)
libXau.so.6 => /usr/lib32/libXau.so.6 (0xf7437000)
libuuid.so.1 => /lib32/libuuid.so.1 (0xf7431000)
/lib/ld-linux.so.2 (0xf77a4000)
libxcb.so.1 => /usr/lib32/libxcb.so.1 (0xf7413000)
libXdmcp.so.6 => /usr/lib32/libXdmcp.so.6 (0xf740e000)

• Note the not found above. If you don't get one of those, try just running /usr/lib/ICAClient/wfcmgr: if that launches the Citrix Receiver, you're done, and you can probably exit these instructions. If not, proceed to next step.

2. Download and setup needed 32-bit libraries.

1. Download 32-bit libraries (changing parameters in the following as necessary):

SOURCE_DIR="/tmp/motif"
TARGET_DIR="/usr/lib32"
DEB_URI=""
DEB_FN="$(basename ${DEB_URI})"
DEB_FP="${SOURCE_DIR}/${DEB_FN}"
mkdir -p ${SOURCE_DIR}
mkdir -p ${TARGET_DIR} # should be there already
pushd ${SOURCE_DIR}
wget -O ${DEB_FN} ${DEB_URI}
dpkg -x ${DEB_FN} ${SOURCE_DIR}
sudo cp -r ${SOURCE_DIR}/usr/lib/* ${TARGET_DIR}/

2. Link to 32-bit libraries as needed. E.g., for the error

libXm.so.4 => not found

• above, check to see that a similarly-named library exists among your 32-bit libraries, and link to that. E.g.

MISSING_LIB_NAME="libXm.so.4"
MISSING_LIB_BASE="libXm.so"
TARGET_DIR="/usr/lib32"
SOURCE_DIR="/usr/lib"
find ${TARGET_DIR} -name "${MISSING_LIB_BASE}*" | xargs ls -al
sudo ln -s ${TARGET_DIR}/libXm.so.3.0.2 ${TARGET_DIR}/${MISSING_LIB_NAME}

3. Rerun ldd and loop the previous steps until

CLIENT_EXEC="/usr/lib/ICAClient/wfcmgr"
ERROR_STRING='not found'
ldd ${CLIENT_EXEC} | fgrep -e "${ERROR_STRING}"

• produces no output.

3. Run the client from a terminal, e.g.

${CLIENT_EXEC}

You should get no errors; if you do, use the terminal messages to guide your efforts. You may need to repeat steps above.

If you're having trouble at this point, ensure that appropriate file permissions are assigned to /usr/lib32/libXm.so.3.0.2. For example, if you are using a umask setting that is more restrictive than the default value of 022 (such as umask 027), you may find that /usr/lib32/libXm.so.3.0.2 is set to mode 640 (-rw-r-----) instead of 644 (-rw-r--r--). If this is the case, Citrix Receiver will not find libXm.so.4. Change the file permissions to 644:

sudo chmod 644 /usr/lib32/libXm.so.3.0.2

4. Run the client from the launcher, e.g. Applications>Internet>Citrix Receiver

Configuring Firefox

The plugin is created as a 32-bit library: /usr/lib/ICAClient/npica.so. A 64-bit Firefox will not use that this plugin. To use ICA-files from Firefox, surf to such a file and click on it, choose to open it with /usr/lib/ICAClient/wfica.sh, don't forget to add to remember the selection.

Citrix ICA Client 10.6

Download Citrix client 10.6

or and click on 'Download'

Under "Select Downloads by Product," choose "Citrix ."

Now click on "Linux ICA Clients."

Download this item:

• Version 10.6 English 6/28/07 1.8 mb .tar.gz

  x86 client - requires 2.2.x

Install Prerequisite Software

In a terminal window:

  sudo aptitude install libmotif3
  sudo aptitude install libxaw7

Expand Zip file and Install

Move the .tar.gz file to a temporary folder and extract installation files. For example, assuming you downloaded to your Desktop:

  mkdir /tmp/citrix-install
  cd /tmp/citrix-install
  mv ~/Desktop/en.linuxx86.tar.gz ./
  tar xvf en.linuxx86.tar.gz

Now, install the Citrix Client

  sudo ./setupwfc

When you see the menu:

• Select a setup option:

  • 1. Install Citrix Presentation Server Client 10.6 2. Remove Citrix Presentation Server Client 10.6 3. Quit Citrix Presentation Server Client 10.6 setup

Type "1" (without the quotes) and hit enter.

Choose the defaults and accept the license. And yes, you want to integrate with KDE and Gnome.

Finally, at the setup menu, choose:

• 3. Quit Citrix Presentation Server Client 10.6 setup

Put wfica and wfcmgr on the Search Path

Create links in a folder that is on the search path

  sudo ln -s /usr/lib/ICAClient/wfica /usr/local/bin/wfica
  sudo ln -s /usr/lib/ICAClient/wfcmgr /usr/local/bin/wfcmgr

Using the Citrix Client 10.6

This will now be enabled for use with a Citrix Web Interface - without any further action.

If you do not use a Web Interface system, configure the client using the Configuration Manager

/usr/lib/ICAClient/wfcmgr &

(You can download the 'Admin Guide' from the download location - see above.)

Note: If wfcmgr doesn't launch in Gutsy, there may be a problem with the loading of fonts

See

In summary, edit /etc/X11/xorg.conf and change '/usr/share/X11/fonts/' to '/usr/share/fonts/X11'

Citrix Client 10 on Dapper

This following guide is written for Dapper. It works for the author, but YMMV.

Download the Citrix ICA Client RPM

Locate and download the latest (currently version 10.0) ICA Linux client RPM from:

Convert the RPM package to .deb

Install the 'alien' package:

sudo apt-get install alien

Create the .deb

alien ICAClient-10.0-2.i386.rpm

This will create the file 'icaclient-10.0-2.i386.deb'

Install the .deb

sudo dpkg -i icaclient-10.0-2.i386.deb

Install the motif libraries

sudo apt-get install libmotif3

Kubuntu only: install libxp6

sudo apt-get install libxp6

Firefox PNAgent ICA Plugin

Symlink the PNAgent ICA plugin for Firefox

sudo ln -s /usr/lib/ICAClient/npica.so /usr/lib/firefox/plugins/npica.so

Client Setup

You should now be able to configure the client by running:

/usr/lib/ICAClient/wfcmgr

Setup a new connection from: Tools -> Settings -> Preferences (pull down to) Server Location (Your network admin should be able to supply the details)

Configure the server options: Connection -> New -> Network (Again, your network admin should be able to supply the details)

Configure display options: Connection -> Properties -> Network (pull down to) Window Select 16 million colors (if your vid card supports it) & Seamless Window

Once the client is configured, you can launch the ICA client by running:

/usr/lib/ICAClient/wfica

You also might like to update the PATH definition in /etc/environment to include /usr/lib/ICAClient

Alternatively, create a symlink for wfica:

sudo ln -s /usr/lib/ICAClient/wfica /usr/local/bin/wfica

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 &

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.