Citrix ICA Client for Unix (Versions 10.6 & 10.0 & 8.0)



Documentation & Online Help
Configuring the Citrix ICA Client
Setting up the Citrix ICA Client as a helper application for Netscape Communicator 4.x
Connecting to MetaFrame Server

The Citrix ICA (Independent Computing Architecture) Client is a UNIX application that pro- vides access to a Windows session running on a high-performance Citrix server. Once the connection to the Citrix server is established, you can access Windows applications and work with files in a similar way to working on a local PC. Because the Windows applications are running remotely on a Citrix server you get excellent performance, even on a low-performance UNIX workstation.

The ICA Client displays the Windows session in a separate window on the UNIX workstation screen, and is fully integrated with your other UNIX X applications. You can cut and paste text and graphics between Windows applications in the ICA Client window and your other X applications.

Your UNIX workstation's mouse and keyboard can be used with Windows applications in the usual way, and you can set up key mappings to enable you to enter PC keys not available on your UNIX workstation's keyboard.

Documentation & Online Help

Configuring the ICA Client

First of all, ensure that the environment variable ICAROOT is set to point to the actual installation directory for the ICA Client. Type

% echo $ICAROOT

at the UNIX prompt and you should get one of the following answers:

Cluster $ICAROOT $PATH
LinuX (version 10.0)
/net/appls/ICAClient /net/appls/bin
LinuX (version 10.6)  
(for CentOS 5)
/usr/lib/ICAClient /usr/lib/ICAClient
LinuX (version 8.0)  
(for CentOS 4)
/usr/lib/ICAClient /usr/lib/ICAClient

If you don't get the right answer, set the environment variable $ICAROOT yourself according to the above table. Best you can do this once and forever according to your login shell in one of the files .cshrc, .bashrc, .login, .profile, .bash_profile etc.

Now, before running the ICA Client the first time, you'll have to configure the ICA Client (e. g. the keyboard, window size, drive mapping). To do this, type the following command at the UNIX prompt:

% wfcmgr &

(The application wfcmgr is in the path $PATH.) The Citrix ICA Client window is displayed:

Citrix ICA Client window

Note: If your OS is CentOS 4, you can start the ICA Client (version 8.0) window by clicking on item "Citrix ICA Client" in the "Internet" folder of the KPanel. Here you don't need to set the ICAROOT environment variable!

  1. To display the Settings dialog box choose Settings... from the Option menu. It contains the following panels:
    • Preferences Page (to specify the Keyboard Layout and the Keyboard Type)
    • Window Page (to select the Window Size and Window Colors)
    • Server Location Page
    • Hotkeys Page
    • Disk Cache Page
    • Drive Mapping Page (allows you to map directories mounted on your UNIX workstation as PC drive letters in your ICA session)
    • COM Ports Page
    • Firewall Settings Page
  2. Select the suitable keyboard and window settings etc and click OK.

Setting up the Citrix ICA Client as a helper application for
Netscape Communicator 4.x

If you want to run the Citrix ICA Client wfica automatically from Netscape when you click on a link to an .ica file, you need to do the following:

  1. Pull down the Edit menu item and select Preferences....
  2. On the Netscape: Preferences dialog, select the Navigator / Applications tab item.
  3. Select the New... button to create a new entry. In the Netscape: Application dialog box, fill in

    Description: "Citrix ICA"
    MIMEType: "application/x-ica"
    Suffixes: "ica"

    and select Plug In "Citrix ICA Client" or (if not available) select the item marked Application and enter the pathname to the Citrix ICA Client along with the "%s" field identifier for the temporary file name:

    wfica %s

    The application wfica is in the path $PATH.
  4. Select the OK button in the Netscape: Application dialog box.
  5. Select the OK button in the Netscape: Preferences dialog box.