Before you Begin


Who Should Use this Manual

This manual is for system administrators responsible for installing, configuring, deploying, and maintaining Citrix ICA Clients for UNIX (also called the Citrix ICA UNIX Clients). This manual assumes knowledge of:

Citrix MetaFrame Application Server for Windows or Citrix WinFrame

The operating system on the client computer (UNIX)

Installation, operation, and maintenance of network and asynchronous communication hardware, including serial ports, modems, and device adapters


How to Use this Guide

To get the most out of the Citrix ICA Client Administrator's Guide, review the table of contents to familiarize yourself with the topics discussed.

This guide contains the following sections:

Chapter	Contents
Chapter 1, "Introduction to the Citrix ICA UNIX Client"	Gives a detailed list of features.
Chapter 2, "Deploying the Citrix ICA UNIX Client"	Describes how to install and deploy the Citrix ICA UNIX Client.
Chapter 3, "Configuring the Citrix ICA UNIX Client"	Describes how to configure connection properties and device mappings for the Citrix ICA UNIX Client.


Conventions

The following conventional terms, text formats, and symbols are used throughout the printed documentation:

Convention	Meaning
Bold	Indicates boxes and buttons, column headings, command-line commands and options, icons, dialog box titles, lists, menu names, tabs, and menu commands.
Italic	Indicates a placeholder for information or parameters that you must provide. For example, if the procedure asks you to type filename, you must type the actual name of a file. Italic also indicates new terms and the titles of other books.
ALL UPPERCASE	Represents keyboard keys (for example, CTRL, ENTER, F2).
[brackets]	Encloses optional items in syntax statements. For example, [password] indicates that you can choose to type a password with the command. Type only the information within the brackets, not the brackets themselves.
...(ellipsis)	Indicates a command element can be repeated.
Monospace	Represents examples of screen text or entries that you can type at the command line or initialization files.
	Indicates a procedure with sequential steps.
•	Indicates a procedure with only one step.
	Indicates a list of related information, not procedural steps.
The Citrix ICA Client for UNIX allows users to connect to MetaFrame and WinFrame servers. When describing a feature or procedure common to MetaFrame and WinFrame servers, this manual uses the term Citrix server. When describing a feature unique to a MetaFrame or WinFrame server, this manual specifies either a MetaFrame or WinFrame server.


Finding More Information

This manual contains conceptual information and installation and configuration steps for the Citrix ICA UNIX Client. For additional information, consult the following manuals:

The Citrix ICA Client Quick Reference Cards give users step-by-step instructions for using the Citrix ICA Clients to connect to Citrix servers and run published applications.

The Citrix ICA Client Administrator's Guides for the ICA DOS, Win16, Win32, Java, Web, and Macintosh Clients.

For instructions on installing, configuring, and maintaining your Citrix servers, see the documentation included in your MetaFrame or WinFrame package.

This book and other Citrix documentation is available in Adobe PDF format in the documentation directory of your MetaFrame or WinFrame CD-ROM. Using the Adobe Acrobat Reader, you can view and search the documentation electronically or print it for easy reference. To download the Adobe Acrobat Reader for free, please go to Adobe's Web site at http:\\www.adobe.com.

Important  Always consult the Readme.txt files for MetaFrame, WinFrame, and the Citrix ICA Clients for any last-minute updates, installation instructions, and corrections to the documentation.


Citrix on the World Wide Web

Citrix offers online Technical Support Services at http://www.citrix.com that include the following:

Downloadable Citrix ICA Clients, available at http://download.citrix.com

A Frequently Asked Questions page with answers to the most common technical issues

An FTP server containing the latest service packs and hotfixes for download

An Online Knowledge Base containing an extensive collection of technical articles, troubleshooting tips, and white papers

Interactive online support forums


Year 2000 Readiness

For a detailed description of the Year 2000 Readiness of Citrix products, see our Web site at http://www.citrix.com/misc/y2000.htm.


Overview
Introduction to the Citrix ICA UNIX Client

Overview

When connected to a Citrix server, the Citrix ICA UNIX Client provides additional features that make remote computing just like running applications on a local desktop. The Citrix ICA UNIX Client has the following features:

Client device mapping

Client drive mapping

Client printer mapping

Encryption

Disk caching and data compression

True color desktop support (Linux and SCO clients only)

ICA UNIX Client hotkeys

Transparent clipboard access

Application publishing support

The Citrix ICA UNIX Client comes in a number of versions for different UNIX operating systems. For a list of system requirements and platforms supports, see Chapter 2.


Client Device Mapping

The Citrix ICA UNIX Client supports client device mapping. Client device mapping allows a remote application running on the Citrix server to access printers and disk drives attached to the local client computer.


Client Drive Mapping

Client drive mapping makes any directory mounted on your UNIX computer, including CD-ROMs, available to you during ICA sessions on Citrix servers. When a Citrix server is configured to allow client drive mapping, you can access your locally stored files, work with them during your ICA sessions, and then save them either on a mounted directory or on a drive on the Citrix server.


Client Printer Mapping

Client printer mapping lets users access printers attached to their computers during ICA sessions. ICA UNIX Client users can print to any spooled printer available from the UNIX workstation.


Encryption

The ICA UNIX Clients support basic encryption.


Disk Caching and Data Compression

These features can increase performance over low speed asynchronous and WAN connections. Disk caching stores commonly used portions of your screen (such as icons and bitmaps) locally, increasing performance by avoiding retransmission of locally cached data. Data compression reduces the amount of data sent over the communications link to the client computer.


True Color Desktop Support

The Linux and SCO Clients work on UNIX desktops configured for true color (24-bit) color support.


ICA UNIX Client Hotkeys

The Citrix UNIX Client provides hotkeys that can be used to control various functions while in an ICA session. ICA Client hotkeys let you define alternative key combinations for the hotkeys Alt+F1 to Alt+F12, because these are reserved for use by X Windows. By default, UNIX hotkeys Alt+F1 to Alt+F12 are mapped to Alt+Ctrl+F1 to Alt+Ctrl+F12 in your ICA sessions.

Any Alt key combinations not used by your X Window manager can be used as usual within your Citrix session. In addition, the key combination Ctrl+Alt+Enter can be used to produce the PC key combination Ctrl+Alt+Delete.


Transparent Clipboard Access

You can use the client workstation's clipboard to cut and paste objects between applications running locally on the client computer and applications running remotely in an ICA session.

Access to the local clipboard requires no special configuration or procedures; using the familiar cut, copy, and paste commands, you can transfer text, pictures, and other objects back and forth between local and remote applications.


Deploying the Citrix ICA UNIX Client

Overview

This chapter describes how to install and remove the ICA UNIX Client. Topics covered in this chapter include:

System requirements

Installing the ICA UNIX Client


System Requirements

The ICA UNIX Client supports the following systems and versions. Features may vary among the supported platforms.

UNIX System	Version
Digital UNIX	3.2 or above
HP-UX	10.2 or above
IBM AIX	4.1.4 or above
Linux	Red Hat 5.x or greater
SCO	UnixWare 7, UnixWare 2.1*, OpenServer 5*
SGI IRIX	6.3 or above
Sun Solaris	1.0** (SunOS 4.1.4) or 2.5.1 (SunOS 5.5.1)

*	The SCO client requires the Binary Compatibility Module to run under UnixWare 2.1 and OpenServer 5.

**	Requires OpenWindows patch 100444-76.tar.Z, available from SunSolve Online.

Systems running the ICA UNIX Client require the following:

12MB of free disk space for installation

16 or 256 color video display

TCP/IP networking

Access to a CD-ROM drive for installation


Installing the ICA UNIX Client

Before installing the Citrix ICA UNIX Client you need to ensure that you have at least 12MB of free disk space available. Depending on your UNIX platform, you can check the available disk space with one of the following commands:

df -k <Return>

df <Return>

bdf <Return>

To install the Citrix ICA UNIX Client:

1.	Login as root at the client workstation.

2.	Open a command window.

3.	Insert the Metaframe CD-ROM in the drive.

4.	Mount the CD-ROM using the appropriate instructions for your workstation.

5.	Change to the ICAClient/Icaunix directory on the mounted CD-ROM.

6.	Run the setup program  by typing ./setupwfc and press RETURN.

— or —

If file names on the CD-ROM are displayed in upper case and are followed by other characters (such as ;1), use the command ./SETUPWFC* and press RETURN.

A menu similar to the following appears:

Select a setup option:

1. Install Citrix ICA Client 2.7

2. Remove Citrix ICA Client 2.7

3. Quit Citrix ICA Client 2.7 setup

Enter option number 1-3 [1]:

7.	Enter 1 and press RETURN to install the ICA Client.

The installation procedure prompts:

Please enter the directory in which Citrix ICA Client is to be installed [default /usr/lib/ICAClient] or type "quit" to abandon the installation:

8.	Press RETURN to install in the default location.

The installation procedure prompts:

Proceed with installation? [default n]:

9.	Type y and press RETURN to proceed or n and press RETURN to cancel the installation.

The installation procedure displays the Client Software License Agreement and then prompts:

Proceed with installation? [default y]:

10.	Type y and press RETURN to proceed or n and press RETURN to cancel the installation.

11.	When the installation is complete, the main installation menu is displayed again. Enter 3 and press RETURN to exit from the setup program.

To remove the Citrix ICA Client

1.	Log on as root.

2.	Run the setup program by typing /usr/lib/ICAClient/setupwfc and press RETURN.

—  or  —

If you installed the ICA UNIX Client to a different location, enter that path and press RETURN.

3.	Enter 2 and press RETURN to remove the ICA UNIX Client.


Configuring the Citrix ICA UNIX Client

Overview

This chapter describes how to configure the ICA UNIX Client. Topics in this chapter include:

Starting the ICA UNIX Client

Creating a connection entry

Mapping client devices

Mapping client drives

Mapping client printers

Configuring connections to Citrix servers and published applications


Starting the ICA UNIX Client

To start the UNIX client

•	At the UNIX prompt, type /usr/lib/ICAClient/wfcmgr and press RETURN (where /usr/lib/ICAClient is the directory in which you installed the ICA UNIX Client).

Note  If the ICA Client has not been installed in the default installation directory, ensure that the environment variable ICAROOT is set to point to the actual installation directory.


Creating a Connection Entry

You can create two types of connections to Citrix servers: ICA connections and published applications. An ICA connection lets a user access the desktop of a Citrix server. The user can run any applications available on the desktop, in any order. A published application is a predefined application and its associated environment.

To create a connection entry

1.	Start the ICA UNIX Client. From the Entry menu, click New, or click New on the toolbar. The Properties dialog box appears with the Network page displayed:

2.	In the Description field, enter a description for the entry. The description is used to identify the connection entry in the ICA UNIX Client main window.

3.	Click Server or Published Application.

4.	For a server connection, type the name or IP address of the Citrix server or select the name from the pop-up menu to the right of the Server field.

 — or  —

For a published application, type the name of the published application or select the name from the pop-up menu to the right of the Server field.

5.	If you want to allow the user to log on to the Citrix server automatically, enter values for Username, Password, and Domain. If you leave these fields blank, the Citrix server prompts for this information each time a user tries to connect to the server.

6.	Click OK to save the entry or Cancel to exit the Properties dialog box without saving the entry.


Mapping Client Devices

The Citrix ICA Clients support client device mapping. Client device mapping allows a remote application running on the Citrix server to access printers and disk drives attached to the local client computer.


Mapping Client Drives

Client drive mapping makes any directory mounted on the UNIX Client workstation, including CD-ROMs, available to the user during ICA sessions on Citrix servers. When a Citrix server is configured to allow client drive mapping, users can access their locally stored files, work with them during their ICA sessions, and then save them again either on a local drive or on a drive on the Citrix server.

To map a directory on the UNIX workstation to an ICA session

1.	In the ICA Client main window, click Options and then click Settings. In the Settings dialog box, select Drive Mapping from the pull-down menu:

For each Citrix server drive letter, the Drive Mapping list shows the disk or pathname of the UNIX directory mapped to the drive. In the Enable/Read/Write columns, icons display whether each mapped drive is enabled for use and what type of access the user has to the drive.

2.	Click the check box in the Enable column next to an available drive letter and then click in the field for the drive. For example, in the dialog box shown above, you select F:.

3.	Click Modify. A standard UNIX file selection dialog box appears. Select the UNIX directory you want to map and click OK.

4.	The mapped directory appears in the Drive Mapping list. If the drive letter you selected is not available on the Citrix server, the specified directory is mapped to another free drive letter at logon.

5.	Make sure Enable Drive Mapping is checked. Click Save. Log off any ICA connections already established and reconnect. The same drive mapping and access settings will apply to all connection entries.

To view mapped client drives when connected to a MetaFrame server

•	From within the ICA Client session, double-click My Computer on the remote desktop. The My Computer screen appears:

In this example, drives A, C, D, and E are storage devices on the MetaFrame server. Drives G and H are directories on the UNIX workstation mapped to this ICA session. A user can access these directories by specifying drive G or H for any operation.

Published applications and ICA server connections that run a specified initial program offer users the same access to their local drives. When connected to published applications, users can access local drives in the same way they would when using locally run applications.

To manually map a client drive on a Citrix server

Mapped drives that do not appear after logon can be manually mapped from within an ICA session. Use the following procedure to manually map a client drive.

1.	Log on to the Citrix server.

2.	On a WinFrame server, Start File Manager. In the Disk menu, click Connect Network Drive. The Connect Network Drive dialog box appears.

On a MetaFrame server, start Windows NT Explorer. In the Tools menu, click Map Network Drive. The Map Network Drive dialog box appears.

3.	In the Drive field, select a server drive letter. This drive letter will represent the mapped client drive.

4.	In the Shared Directories list, double-click Client Network, Client, and then select the appropriate icon for your UNIX directory from the list of available client drives.

5.	If you want to have this drive available to you each time you log on to this server, check Reconnect at Logon. Click OK.


Mapping Client Printers

Client printer mapping lets users access printers attached to their client computers during ICA sessions. When a Citrix server is configured to allow client printer mapping, applications running remotely on the Citrix server can print to local printers. ICA UNIX Client users can print to any spooled printer available from the UNIX workstation.

To map a local printer on a MetaFrame server

1.	From the UNIX workstation, start an ICA connection and log on to the MetaFrame server.

2.	Click Start on the taskbar, point to Settings, then click Printers.

3.	In the Printers window you should see an icon for a network printer with a name similar to workstation#printer, where workstation is the UNIX workstation name and printer is the UNIX name for the printer.

4.	If no client printer is available, double-click Add Printer. The Add Printer Wizard appears.

5.	Click Network printer server and then click Next.

6.	Double-click Client Network and then double-click Client.

7.	Select the printer from the list displayed. Spooled printers available on the UNIX workstation have a name similar to workstation#printer. Click OK.

8.	If you want this printer to be the default printer, click Yes and then click Next.

9.	Click Finish.

To map a local printer on a WinFrame server

1.	Log on to the WinFrame server.

2.	In the Main program group, double-click Print Manager. In the Printer Manager window you should see an icon or open dialog box for a network printer with a name similar to workstation#printer, where workstation is the UNIX workstation name and printer is the UNIX name for the printer.

3.	If no client printer is available, select Connect to Printer from the Printer menu.

4.	In the Shared Printer list, double-click Client Network and then double-click Client.

5.	Select the client printer icon, which will have a name similar to workstation#printer, and click OK.

6.	If you want this printer to be your default printer, select it in the Default menu at the top of the Printers window.


Configuring Connections to Citrix Servers and Published Applications

The following procedures describe how to configure properties and default settings for connections to Citrix servers and published applications:

Configuring connection properties

Configuring network properties

Configuring window properties

Configuring application properties

Configuring default settings

Configuring preferences

Configuring default window settings

Configuring server browsing

Configuring hotkeys


Configuring Connection Properties

You can configure existing connection entries using the Properties dialog box.

To display connection properties

•	From the Entry menu, click Properties. The Properties dialog box appears.

You can access the following pages from the Properties dialog box:

Network

Window

Application


Configuring Network Properties

The Network page allows you to specify the server name and the user logon parameters.

To configure network properties

•	From the Properties page, select Network from the drop-down list to display the Network page:

Enter a description of the connection in the Description field.

Click Server to configure a connection to a Citrix server. Click Published Application to configure a connection to a published application.

The server can be specified either by its name or its IP address.

The Username, Domain, and Password should be those set up on the specified Citrix server. If you do not provide these parameters, you will be prompted for them each time you connect.


Configuring Window Properties

From the Window page, you can specify the window size and number of colors used for the ICA Client window.

To configure window properties

•	From the Properties page, select Window from the drop-down list to display the Window page.

Window Size allows you to select one of four standard window sizes. Alternatively click Custom to enter a custom size up to 2048 x 2048 pixels, or Use Full Screen to use the full screen. If you select Use Full Screen, the menu bar is hidden when you run the ICA Client.

Window Colors allows you to set the number of window colors to 16 or 256.

Select Use Default to use the default window size or window colors setting. For more information on setting defaults, see "Configuring Default Settings" later in this chapter.


Configuring Application Properties

To configure application properties

•	From the Properties page, select Application from the drop-down list to display the Application page.

In the Application field, you can specify the pathname of an application to be run after connecting to a Citrix server. If you specify an application, you do not see the Windows desktop when you connect and the connection is closed when you quit the application.

In the Working Directory field, you can specify the pathname of a directory to be used with the application.

Note  If you the entry you are configuring is a connection to a published application, the Application dialog box will not be available.


Configuring Default Settings

To display the Default Settings page

•	In the Citrix ICA Client window, select Settings from the Options menu to display the Settings dialog box.

You can access the following pages from the Settings dialog box:

Preferences

Window

Server browsing

Hotkeys


Configuring Preferences

To configure preferences

•	Select Preferences from the drop-down list on the Settings dialog box to display the Preferences page.

In the Keyboard Layout field, specify the keyboard layout of the client computer. The Citrix server uses the keyboard layout information to configure the session for the keyboard layout. The default value (User Profile) uses the keyboard layout specified in the user profile. If the keyboard layout of the client computer does not match the one specified in the user profile, select a keyboard layout from the list.

Select Enable Windows Alert Sounds to cause Windows alert sounds to be played using the UNIX workstation sound system.


Configuring Default Window Settings

To configure default window settings

•	Select Window from the drop-down list on the Settings dialog box to display the Window page:

Select one of four standard window sizes. Click Custom to enter a custom size up to 2048 x 2048 pixels, or Use Full Screen to use the full screen. If you select Use Full Screen, the menu bar is hidden when you run the ICA Client.

Set the number of window colors to 16 or 256.

These settings are used as the default for all new connection files.


Configuring Server Browsing

To configure default window settings

•	From the Settings page, select Server Browsing from the drop-down list to display the Server Browsing page:

In the TCP/IP field, enter the TCP/IP address of a server browser. This provides a list of available Citrix compatible servers, in addition to any servers on your local network, and allows you to select one from the pull-down list on the Network properties page.


Configuring Hotkeys

To configure default window settings

•	From the Settings page, select Hotkeys from the drop-down list to display the Hotkeys page:

On the Hotkeys page, you can define alternative key combinations for the hotkeys <Alt> <F1> to <Alt> <F12>, which are reserved for use by X Windows.

By default, these key combinations are generated by <Alt> <Ctrl> <F1> to <Alt> <Ctrl> <F12>, but you can change the definitions by selecting alternative keys from the pop-up menus.

Any <Alt> key combinations not used by your X Window manager can be used as normal within the ICA session.

In addition, the key combination <Ctrl> <Alt> <Enter> can be used to produce the PC key combination <Ctrl> <Alt> <Delete>.