null  User manual
Administrator’s Guide
Citrix ICA Win32 Clients
Version 6.01
Citrix Systems, Inc.
Information in this document is subject to change without notice. Companies, names, and data used in
examples herein are fictitious unless otherwise noted. No part of this document may be reproduced or
transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express
written permission of Citrix Systems, Inc.
Copyright ©1999-2000 Citrix Systems, Inc. All rights reserved.
Citrix, ICA (Independent Computing Architecture), Independent Management Architecture (IMA),
Program Neighborhood, MetaFrame, and NFuse are registered trademarks or trademarks of Citrix
Systems, Inc. in the U.S.A. and other countries.
Microsoft, MS, MS-DOS, Windows, Windows NT, and Windows 2000 Servers are registered trademarks
or trademarks of Microsoft Corporation in the U.S.A and other countries.
RSA Encryption (c) 1996-1997 RSA Security Inc., All Rights Reserved.
All other trade names referred to are the Servicemark, Trademark, or Registered Trademark of the
respective manufacturers.
Document Code ica32.6.01.acr
3
Contents
Chapter 1 Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Who Should Use this Manual. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
How to Use this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Finding More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Citrix on the World Wide Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Reader Comments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Chapter 2 Introduction to the
ICA Win32 Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
The ICA Win32 Program Neighborhood Client . . . . . . . . . . . . . . . . . . . . . . . . 11
The ICA Win32 Web Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
New in this Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Per-User Time Zone Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
ICA Win32 Client Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Program Neighborhood . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
TAPI Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Seamless Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Client Device Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Sound Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Dialing Prefixes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Client Auto Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Windows Clipboard Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Low Bandwidth Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Disk Caching and Data Compression. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
SpeedScreen Latency Reduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Business Recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
TCP/IP+HTTP Server Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Wheel Mouse Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Multiple-Monitor Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Pass-Through Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Panning and Scaling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4
Citrix ICA Win32 Clients Administrator’s Guide
Chapter 3 Deploying the ICA Win32 Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Preconfiguring the ICA Win32 Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Preconfiguring the ICA Win32 Program Neighborhood Client . . . . . . . . . . . . 23
Preconfiguring the ICA Win32 Web Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Deploying the ICA Win32 Clients. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Creating an ICA Client Download Web Site
on a Web Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Deploying ICA Clients over a Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Creating client installation diskettes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Using the ICA Client CD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Installing the ICA Win32 Program Neighborhood Client . . . . . . . . . . . . . . . . . . . 28
Starting the ICA Win32 Program Neighborhood Client . . . . . . . . . . . . . . . . . . . . . 32
Installing the ICA Win32 Web Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Updating the ICA Clients. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
The ICA Client Update Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Configuring the Client Update Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Using the Client Update Configuration Utility . . . . . . . . . . . . . . . . . . . . . . . . . 35
Creating a New Client Update Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Specifying a Default Client Update Database . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Configuring Default Client Update Options . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Adding ICA Clients to the Client Update Database. . . . . . . . . . . . . . . . . . . . . . 40
Working with the ICA Win32 Client Downloaded from the Citrix Web Site . 40
Removing an ICA Client From the Client Update Database. . . . . . . . . . . . . . . 44
Changing the Properties of the ICA Win32 Client . . . . . . . . . . . . . . . . . . . . . . 45
Contents
5
Chapter 4 Configuring the ICA Win32 Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Mapping Client Devices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Turning Off Client Device Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Mapping Client Drives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Mapping Client Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Mapping Client COM Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Mapping Client Audio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Configuring Multiple Monitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
System Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Connection Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Configuring a SOCKS Proxy Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Using SOCKS to Direct ICA Traffic Through Firewalls . . . . . . . . . . . . . . . . . 58
Locating Your Proxy Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Configuring Connections to Citrix Servers and Published Applications . . . . . . . . 60
Configuring Server Location and Business Recovery . . . . . . . . . . . . . . . . . . . . 61
Configuring TCP/IP+HTTP Server Location . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Using Application Sets and Custom ICA Connections . . . . . . . . . . . . . . . . . . . 63
Adding Application Sets and Custom ICA Connections. . . . . . . . . . . . . . . . . . 64
Configuring Application Sets and Custom ICA Connections . . . . . . . . . . . . . . 65
Configuring Default Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Configuring Login Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Preventing Users From Saving Passwords. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Configuring General Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Configuring Bitmap Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Configuring Hotkeys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Configuring Event Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Using Applications Published on MetaFrame for UNIX . . . . . . . . . . . . . . . . . . . . 76
Using the Window Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Cutting and Pasting Graphics Using ctxgrab and ctxcapture. . . . . . . . . . . . . . . 78
Using the ICA Win32 Clients with Application Launching and Embedding . . . . 81
Application Launching and Embedding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Launched Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Embedded Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
CHAPTER 1
Before You Begin
Who Should Use this Manual
This manual is for system administrators responsible for installing, configuring,
deploying, and maintaining the Citrix ICA Win32 Clients (also called the Citrix
ICA Clients for 32-bit Windows). This manual assumes knowledge of:
•
The Citrix server to which your ICA Clients connect
•
The operating system on the client computer (Windows 95, Windows 98,
Windows NT, or Windows 2000)
•
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 Win32 Clients 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, “Before You Begin”
Gives an overview of the documentation.
Chapter 2, “Introduction to the
Citrix ICA Win32 Clients”
Gives a detailed list of features.
Chapter 3, “Deploying the
Citrix ICA Win32 Clients”
Describes how to deploy, install, and update the
Citrix ICA Win32 Clients.
8
Citrix ICA Win32 Clients Administrator’s Guide
Chapter
Contents
Chapter 4, “Configuring the
Citrix ICA Win32 Clients”
Describes how to configure connection properties
and device mappings for the Citrix ICA Win32
Program Neighborhood Client and how to use both
ICA Win32 Clients with Web-based application
delivery.
Conventions
The following conventional terms, text formats, and symbols are used throughout
the printed documentation:
Convention
Meaning
Boldface
Commands, names of interface items such as text boxes and option
buttons, and user input.
Italics
Placeholders for information or parameters that you provide. For example,
filename in a procedure means you type the actual name of a file. Italics
also are used for new terms and the titles of books.
UPPERCASE
Keyboard keys, such as CTRL for the Control key and F2 for the function
key that is labeled F2.
Monospace
Text displayed at a command prompt or in a text file.
%SystemRoot%
The Windows system directory, which can be WTSRV, WINNT,
WINDOWS, or other name specified when Windows is installed.
{ braces }
A series of items, one of which is required in command statements. For
example, { yes | no } means you must type yes or no. Do not type the
braces themselves.
[ brackets ]
Optional items in command statements. For example, [/ping] means that
you can type /ping with the command. Do not type the brackets
themselves.
| (vertical bar)
A separator between items in braces or brackets in command statements.
For example, { /hold | /release | /delete } means you type /hold or
/release or /delete.
… (ellipsis)
You can repeat the previous item or items in command statements. For
example, /route:devicename[,…] means you can type additional
devicenames separated by commas.
Step-by-step procedural instructions.
Chapter 1 Before You Begin
9
The Citrix ICA Clients allow users to connect to Citrix servers. When describing a
feature or procedure common to all types of MetaFrame XP, MetaFrame, and
WINFRAME servers, this manual uses the term Citrix server. When describing a
feature unique to a particular MetaFrame or WINFRAME server, this manual
specifies the appropriate server and version number.
Finding More Information
This manual contains conceptual information and installation and configuration
steps for the ICA Win32 Clients. For additional information, consult the following:
•
The online help for the ICA Client you deploy
•
The Citrix ICA Client Administrator’s Guides for the other ICA Clients you
deploy
•
The documentation included in your Citrix server package for instructions on
installing, configuring, and maintaining your Citrix servers
This book and other Citrix documentation is available in Adobe PDF format in the
following locations:
•
The documentation directory of your Citrix ICA Client CD-ROM
•
http://www.citrix.com/download, on the Citrix downloads page, click ICA
Clients
•
http://www.citrix.com/support, on the Services Portfolio page, click the Product
Documentation tab and choose ICA Clients
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 files for your Citrix server and the Citrix
ICA Client for any last-minute updates, installation instructions, and corrections to
the documentation.
10
Citrix ICA Win32 Clients Administrator’s Guide
Citrix on the World Wide Web
The Citrix Web site, at http://www.citrix.com, offers a variety of information and
services for Citrix customers and users. From the Citrix home page, you can access
Citrix online Technical Support Services and other information designed to assist
MetaFrame administrators, including the following:
•
Downloadable Citrix ICA Clients (at http://www.citrix.com/download)
•
Citrix Product Documentation Library containing the latest documentation for
all Citrix products (at http://www.citrix.com/support, select Product
Documentation)
•
Program information on Citrix Preferred Support Services options
•
An FTP server containing the latest service packs, hotfixes, utilities, and
product literature for download
•
An online knowledge base containing an extensive collection of application
notes, technical articles, troubleshooting tips, and white papers
•
Interactive online Solution Forums for discussion of technical issues with other
users
•
Information about programs and courseware for Citrix training and
certifications
•
Contact information for Citrix headquarters, including worldwide, European,
Asia Pacific, and Japan headquarters
•
The Citrix Developer Network (CDN) at http://www.citrix.com/cdn. This open
enrollment membership program provides access to developer tool kits,
technical information, and test programs, for software and hardware vendors,
system integrators, ICA licensees, and corporate IT developers who incorporate
Citrix server-based computing solutions into their products.
•
Frequently Asked Questions pages with answers to common technical and
troubleshooting questions
Reader Comments
We strive to provide accurate, clear, complete, and usable documentation for Citrix
products. If you have any comments, corrections, or suggestions for improving our
documentation, we want to hear from you.
You can send e-mail to the documentation authors at [email protected]
Please include the product name and version number, and the title of the document
in your message.
CHAPTER 2
Introduction to the
ICA Win32 Clients
Overview
When connected to a Citrix server, the ICA Win32 Clients make remote computing
like running applications on a local desktop. Citrix provides two versions of the
ICA Win32 Client:
•
An ICA Win32 Program Neighborhood Client
•
An ICA Win32 Web Client
The ICA Win32 Program Neighborhood Client
Use the ICA Win32 Program Neighborhood Client if your users require a graphical
user interface to access applications published on a Citrix server. This ICA Client
can also be used with NFuse and to launch or run applications embedded in a Web
browser.
12
Citrix ICA Win32 Clients Administrator’s Guide
The ICA Win32 Program Neighborhood Client provides the following features:
•
Program Neighborhood
•
TAPI support
•
Seamless windows
•
Client device mapping
•
Sound support
•
Dialing prefixes
•
Client Auto Update
•
Windows clipboard integration
•
Low bandwidth requirements
•
SpeedScreen Latency Reduction
•
Disk caching and data compression
•
Business recovery
•
TCP/IP+HTTP server location
•
Wheel mouse support
•
Multi-monitor support
•
Pass-through authentication
•
Panning and scaling
•
Per-user time zone support
For a detailed description of the features listed above, see the “New in this Release”
and “ICA Win32 Client Features” sections later in this chapter.
The ICA Win32 Web Client
Use the ICA Win32 Web Client if your users access published applications using a
Web browser with Citrix NFuse or through traditional application launching and
embedding. The ICA Win32 Web Client replaces the ActiveX Control and
Netscape Plug-In Clients, and is packaged in the file ica32t.exe.
Chapter 2 Introduction to the ICA Win32 Clients
13
The ica32t.exe file is a self-extracting executable, approximately 1.3MB in size.
This package is significantly smaller than the full ICA Win32 Program
Neighborhood Client. The smaller size allows quicker downloads and installation.
You can configure the ICA Win32 Client for silent user installation. For more
information about configuring the ICA Win32 Web Client, see “Configuring the
ICA Win32 Web Client for Silent User Installation” in Chapter 3 of this guide.
Important The ICA Win32 Web Client does not support the Program
Neighborhood user interface and associated help files, Start menu shortcut, passthrough authentication, or Client Auto Update. If you need any of these features,
use the full ICA Win32 Program Neighborhood Client.
The ICA Win32 Web Client supports the following features:
•
Seamless windows
•
Client device mapping
•
Sound support
•
TCP/IP+HTTP server location
•
Wheel mouse support
•
Multi-monitor support
•
Panning and Scaling
•
Per-user time zone support
•
Windows clipboard integration
•
Low bandwidth requirements
•
SpeedScreen Latency Reduction
•
Disk caching and data compression
For a detailed description of the features listed above, see the “New In This
Release” section below.
14
Citrix ICA Win32 Clients Administrator’s Guide
New in this Release
The following are new or significantly enhanced features in this release of the ICA
Win32 Clients:
Per-User Time Zone Support
This MetaFrame XP feature allows the user, when logging on to a Citrix server in a
different time zone, to have the ICA session reflect the time zone of the client
device.
For example: A user in Los Angeles, which is in the Pacific time zone, logs onto a
Citrix server in New York City, which is in the Eastern time zone, and launches
Microsoft Outlook as a published application. Microsoft Outlook stamps emails
sent during this ICA session with the user’s Pacific time zone information.
ICA Win32 Client Features
Program Neighborhood
With Program Neighborhood, server-based applications can be deployed to the
client, integrated into the local 32-bit Windows desktop, or deployed directly to the
client’s Start menu.
Similar in concept to Windows Network Neighborhood, Program Neighborhood
provides complete administrative control over application access and local desktop
integration, with no client configuration required.
TAPI Support
The Citrix ICA Win32 Client includes TAPI modem support for dial-up
connections to Citrix servers. TAPI support allows the Win32 Client to detect the
presence of TAPI Version 1.4 or greater modems on the client computer. Users need
not manage separate modem entries for their local communications programs.
When a TAPI modem is detected, the ICA Win32 Client uses the modem
installation and configuration utilities built into Windows to manage the modem. If
the client computer is not TAPI-capable, the ICA Win32 Client uses its own modem
installation and configuration utilities.
Chapter 2 Introduction to the ICA Win32 Clients
15
Seamless Windows
The Citrix ICA Win32 Client supports the seamless integration of local and remote
applications on the local desktop. By selecting the Seamless Windows option when
configuring a connection, a user no longer needs to access an entire remote desktop
to run remote applications. With a single session, a user can gain access to multiple
applications, have fully functional local keyboard controls (such as ALT+TAB),
switch between local and remote applications on the local taskbar, define remote
application icons on the local desktop, and even tile and cascade between local and
remote applications.
Client Device Mapping
The Citrix ICA Clients support client device mapping. Client device mapping
allows a remote application running on the Citrix server to access printers, disk
drives, and COM port devices attached to the local client computer. These features
are not available when connecting to MetaFrame for UNIX Operating Systems 1.0
and 1.1 servers.
•
Client drive mapping
•
Client printer mapping
•
Client COM port mapping
Client Drive Mapping
Client drive mapping allows drive letters on the Citrix server to be redirected to
drives that exist on the client computer; for example, drive H in a Citrix user session
can be mapped to drive C on the local computer running the Citrix ICA Client.
These mappings are used by the File Manager or Explorer and your applications
just like any other network mappings. The drive letters used for drive mapping are
configurable and long filenames are supported.
Client Printer Mapping
Client printer mapping allows a remote application running on the Citrix server to
access printers attached to the client computer. Client printers can be browsed and
connected to in the same way as network printers. Users who access a Citrix server
with the Citrix ICA Client can transparently access their local printers and disk
drives (fixed and removable).
16
Citrix ICA Win32 Clients Administrator’s Guide
Client COM Port Mapping
The ICA Client COM port redirector gives Citrix ICA Client users access to
virtually any peripheral that requires a COM port for operations. COM port
mapping is similar to printer and drive mapping, and allows users to access a COM
port on the client computer as if it were connected to the Citrix server.
Sound Support
ICA Client sound support allows a client computer with a compatible sound card to
play sound files on the server and present them on the local client computer’s sound
system. Client computers can play 8- or 16-bit mono or stereo Windows Wav files
at 8, 11.025, 22.05, and 44.1KHz. Audio support can be configured to use one of
three different sound compression schemes. Each scheme provides different sound
quality and bandwidth usage. This feature is not available when connecting to
MetaFrame for UNIX 1.0 and 1.1 servers.
Dialing Prefixes
The Citrix ICA Clients support dialing prefixes. Dialing prefixes allow a user to
easily add special dialing codes as required by different telephone systems for
dialing out and accessing a remote Citrix server.
The most common use of dialing prefixes is defining different dialing methods for
different telephone systems. For example, a user with a laptop computer may need
to dial 9 to get an outside line at the office and need to dial 1 plus the area code
when working on the road or at home. In this case, the user can define a dialing
prefix named Office for use when dialing out from the office and a prefix called
Remote for use when dialing in from the road or at home.
Client Auto Update
The Client Auto Update feature allows administrators to update ICA Client
installations from a central location instead of having to manually install new client
versions on each client computer. New versions of Citrix ICA Clients are stored in a
central Client Update Database. The latest versions of the ICA Client software are
downloaded to ICA Client devices when users connect to the Citrix server.
MetaFrame for UNIX does not use the Client Update Database. To use the Client
Update Database, you must have either a MetaFrame for Windows or WINFRAME
server in your server farm.
ICA Client Auto Update works with all transport types supported by ICA (TCP/IP,
IPX, NetBIOS, and serial).
Chapter 2 Introduction to the ICA Win32 Clients
17
ICA Client Auto Update supports the following features:
•
Automatically detects older client files
•
Transparently copies new files over any ICA connection
•
Provides full administrative control of client update options for each client
•
Updates clients from a single database on a network share point
•
Safely restores older client versions when needed
Windows Clipboard Integration
Users can cut and paste data between ICA sessions and local applications using the
Windows clipboard.
Low Bandwidth Requirements
The highly efficient Citrix ICA protocol typically uses 20K of bandwidth for each
session.
Disk Caching and Data Compression
These features 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.
SpeedScreen Latency Reduction
SpeedScreen Latency Reduction is a collective term used to describe functionality
that enhances the user’s experience on slower network connections. SpeedScreen
Latency Reduction is not available when connecting to MetaFrame for UNIX 1.0
and 1.1 servers. SpeedScreen Latency Reduction functionality includes:
Local Text Echo
This ICA Client and MetaFrame server option accelerates the display of the input
text on the client device.
Mouse–Click Feedback
This ICA Client and MetaFrame server option provides visual feedback for mouse
clicks to show that the user’s input is being processed.
18
Citrix ICA Win32 Clients Administrator’s Guide
Business Recovery
The Citrix ICA Client includes the additional intelligence to support multiple server
sites (such as a primary and hot backup) with different addresses for the same
published application name.
This feature provides consistent connections to published applications in the event
of a primary server disruption.
TCP/IP+HTTP Server Location
TCP/IP + HTTP server location allows you to retrieve Citrix server and published
application information across network configurations that restrict broadcast and
UDP packets.
Selecting TCP/IP + HTTP under Network Protocol has several advantages for most
server farms:
•
The protocol uses XML data encapsulated in HTTP packets and uses TCP port
80 by default. Most firewalls are set to allow the HTTP packets to pass on port
80.
•
The protocol does not rely on UDP or broadcasts to locate servers in the server
farm.
•
The Citrix XML service works in a server farm that contains MetaFrame XP
servers alone or in combination with Citrix NFuse, which allows users to
connect to application portals with their Web browsers.
Routers will pass TCP/IP packets between subnets, so clients can locate servers that
are not on the same subnet
Wheel Mouse Support
If you run applications that take advantage of a wheel mouse, the ICA Win32 Client
transmits the wheel mouse movements in the same manner that it transmits other
mouse data. ICA Win32 Client wheel mouse support requires MetaFrame1.8
Service Pack 1 or MetaFrame XP or later and a local client device that supports
wheel mouse functionality.
Multiple-Monitor Support
The Citrix ICA Win32 Client supports multiple monitors connected to a single
computer. Multiple-monitor support is available only when connecting to
MetaFrame 1.8 Feature Release 1 and MetaFrame XP servers.
Chapter 2 Introduction to the ICA Win32 Clients
19
Pass-Through Authentication
Pass-through authentication provides the ability to pass the user’s desktop password
to the server, eliminating the need for multiple system and application
authentications. You can give users running other ICA Clients access to the features
of Program Neighborhood by publishing the server desktop, or publishing Program
Neighborhood as an application.
Users running other ICA Clients can define a single connection to the Program
Neighborhood published application. When users connect to the Program
Neighborhood published application, they can launch all other applications
published on the MetaFrame XP servers in your farm from a single interface.
Note If pass-through authentication is enabled on the ICA Win32 Client, auto client
update is disabled.
Panning and Scaling
Panning provides scroll bars that allow you to scroll an ICA session image
configured at a higher resolution than that of your local client desktop. Scaling
provides controls that enable you to shrink an ICA session image to fit your
desktop.
CHAPTER 3
Deploying the ICA Win32 Clients
Overview
This chapter explains how to deploy, install, and update the ICA Win32 Program
Neighborhood Client and the ICA Win32 Web Client. Topics covered in this
chapter include:
•
System requirements
•
Preconfiguring the ICA Win32 Clients
•
Deploying the ICA Win32 Clients
•
Installing the ICA Win32 Clients
•
Updating the ICA Clients
System Requirements
Computers used with the ICA Win32 Program Neighborhood Client must meet the
following requirements:
•
Standard PC architecture, 80386 processor or greater as required for the
operating system
•
Windows 9x, Windows 2000, Windows Me, or Windows NT 3.5 or greater
•
8MB RAM or greater for Windows 9x, 16MB RAM or greater for Windows NT
3.51 or 4.0
22
Citrix ICA Win32 Clients Administrator’s Guide
•
If you are using the Program Neighborhood ICA Win32 Client with a Web
browser, the client device must run a standard Web browser; Internet Explorer
Version 4.0 or greater, or Netscape Navigator or Communicator Version 4.0 or
greater
•
Microsoft mouse or 100% compatible mouse
•
VGA or SVGA video adapter with color monitor
•
High-density 3.5-inch diskette drive (optional) and available hard disk space
•
Windows-compatible sound card for sound support (optional)
•
For serial (dial-up) connections to the Citrix server, an internal modem or serial
port and external modem using a 16550 Universal Asynchronous Receiver/
Transmitter (UART) is recommended
•
For network connections to the Citrix server, a network interface card (NIC) and
the appropriate network transport software are required. Supported network
transports are:
• NetBIOS
• IPX
• SPX
• TCP/IP
Computers used with the ICA Win32 Web Client must meet the following
requirements:
•
Standard PC architecture, 80386 processor or greater as required for the
operating system and Web browser.
•
Windows 9x, Windows 2000, Windows Me, or Windows NT 3.5 or greater.
•
8MB RAM or greater for Windows 9x, 16MB RAM or greater for Windows NT
3.51 or 4.0.
•
Standard Web browser; Internet Explorer Version 4.0 or greater, or Netscape
Navigator or Communicator Version 4.0 or greater.
•
Microsoft mouse or 100% compatible mouse.
•
VGA or SVGA video adapter with color monitor.
•
High-density 3.5-inch diskette drive (optional) and available hard disk space.
•
Windows-compatible sound card for sound support (optional).
•
For network connections to the Citrix server, a network interface card (NIC) and
the appropriate network transport software are required. The ICA Win32 Web
Client supports the TCP/IP network transport only.
Chapter 3 Deploying the ICA Win32 Clients
23
Preconfiguring the ICA Win32 Clients
You can configure numerous ICA Client settings before you deploy the ICA Win32
Client software to your users. Doing so allows your end-users to install the ICA
Client software and begin using it immediately, without having to configure
settings.
Preconfiguring the ICA Win32 Program Neighborhood
Client
You can customize many ICA Win32 Client settings, including default application
sets, server location, screen display resolution, and encryption level, among others.
General instructions for preconfiguring the client are included below. For a detailed
discussion of preconfiguring the ICA Win32 Clients see the Configuration Guide
for the ICA Win32 Clients on the Citrix Web site at http://www.citrix.com/support,
select Product Documentation.
Important You can use any standard compression utility to extract the client files
from the packaged executable. However, you must use commercially available
software to repackage the client files for distribution to your end-users.
When the ICA Win32 Program Neighborhood Client is installed on a client device,
several of the .Ini files you can modify are copied to the user’s profile directory. If
you modify settings for a new version of the ICA Win32 Program Neighborhood
Client prior to updating with the Client Auto Update feature, your changes are not
migrated to the .Ini files under the user’s profile directory.
To preconfigure settings for the ICA Win32 Program Neighborhood Client
1. Extract the client file set from ica32.exe, using your preferred compression
utility software.
2. Open the files containing the customizable settings in a text editor. These files
are:
Appsrv.src
Module.src
Pn.src
Wfclient.src
24
Citrix ICA Win32 Clients Administrator’s Guide
3. Change the parameters to reflect your desired settings. For definitions of the
parameters in these files, see the Configuration Guide for the ICA Win32 Clients
on the Citrix Web site at http://www.citrix.com/support, select Product
Documentation.
4. Repackage the client files for distribution to your users.
Preconfiguring the ICA Win32 Web Client
You can configure the ICA Win32 Web Client for silent user installation.
Configuring the ICA Win32 Web Client for Silent User Installation
Installing the ICA Win32 Web Client requires minimal user interaction. A typical
installation presents the user with the following:
1. An initial prompt informing the user that the Citrix ICA Win32 Web Client is
about to be installed. The user clicks Yes to continue with setup or No to stop
setup.
2. A Citrix License Agreement. The user clicks Yes to accept the agreement or No
to reject the agreement. If the user clicks No, setup stops.
3. An indication that the setup program is copying files to the client device. The
default file location for the ICA Win32 Web Client is Program
Files\Citrix\icaweb32.
4. A message box informing the user that the Citrix ICA Web Client was installed
successfully. The user must click OK to clear the message.
5. If the user is running Netscape Navigator, the user must restart the browser.
You can further limit user interaction with the setup program by suppressing the
appearance of the initial user prompt (described in Step 1) and the Citrix License
Agreement (described in Step 2). These parameters are contained in the file
ctxsetup.ini.
Important You can use any standard compression utility to extract the client files
from the packaged executable. However, you must use commercially available
software to repackage the client files for distribution to your end-users.
Chapter 3 Deploying the ICA Win32 Clients
25
To configure the ICA Win32 Web Client for silent user installation
1. Extract the ICA Client files from ica32t.exe using your preferred compression
utility software. These executables are located in the following directory
(substitute language with the language of your server software):
Icaweb\language\ica32
where language is one of:
• En (English)
• Fr (French)
• De (German)
• Ja (Japanese)
• Es (Spanish)
2. Locate the file ctxsetup.ini.
3. Open ctxsetup.ini in any text editor.
4. Locate the InitialPrompt parameter. Change the value of the setting from 1 to 0.
5. Locate the DisplayLicenseDlg parameter. Change the value of the setting from
1 to 0.
6. Save the file and exit the text editor.
7. Repackage the client files for distribution to your end-users.
Deploying the ICA Win32 Clients
You can deliver the ICA Clients to your users and install the software with the
following methods:
•
Creating an ICA Client download Web site on a Web server
•
Copying the ICA Win32 files to a network share point
•
Creating installation diskettes
•
Using the ICA Client CD
For a detailed discussion of the latest deployment methods available with the
release of MetaFrame XP, see the MetaFrame XP Administrator’s Guide. If you are
using Citrix NFuse in conjunction with Citrix MetaFrame, see the NFuse
Administrator’s Guide for information about deploying the ICA Clients with Citrix
NFuse.
26
Citrix ICA Win32 Clients Administrator’s Guide
Creating an ICA Client Download Web Site
on a Web Server
If you are not using Citrix NFuse, Citrix offers an installation method that uses a
Web browser on the client device as the interface for downloading the ICA Client.
You can create an ICA Client download Web site on a Web server. Users access a
setup page containing a link to the ICA Win32 Client setup program.
You can download the elements required to create an ICA Client download Web
site and the corresponding documentation from the Citrix Web site at http://
www.citrix.com/download.
Deploying ICA Clients over a Network
The following instructions discuss how to deploy the ICA Win32 Client software
over a network.
To deploy ICA Win32 Client software from a network share point
1. Create a share point on a file server, accessible to your users.
2. Copy the desired ICA Win32 Client executable (ica32.exe or ica32t.exe) from
the ICA Client CD to the share point. These executables are located in the
following directory (substitute language with the language of your server
software):
Icaweb\language\ica32
where language is one of:
• En (English)
• Fr (French)
• De (German)
• Ja (Japanese)
• Es (Spanish)
3. Supply your users with the path to the executable.
4. Users double-click the executable to begin the installation process.
Chapter 3 Deploying the ICA Win32 Clients
27
Creating client installation diskettes
Use the ICA Client Creator to create client installation diskettes for the ICA Win32
Program Neighborhood Client. You will need three to four 3.5-inch floppy disks to
create the client installation diskettes.
To create Citrix ICA Client installation disks
1. From a MetaFrame XP server: Click Start> Programs> Citrix> MetaFrame
XP> ICA Client Creator. The Make Installation Disk Set dialog box appears.
From a MetaFrame 1.8 server: Click Start> Programs> MetaFrame Tools>
ICA Client Creator. The Make Installation Disk Set dialog box appears.
From a WINFRAME server: In the Administrative Tools folder, double-click
ICA Client Creator. The Make Installation Disk Set dialog box appears.
2. In the Network Client or Service list, click the desired Citrix ICA Client. Select
the Format Disks check box to format the disks when creating the installation
media. Click OK.
3. Follow the on-screen instructions.
Using the ICA Client CD
The ICA Client CD contains setup and installation files for all ICA Clients. You can
use the ICA Client CD to directly install ICA Client software on client devices that
have CD-ROM drives, or copy the CD image to a network share point on a file
server.
28
Citrix ICA Win32 Clients Administrator’s Guide
Installing the ICA Win32 Program Neighborhood Client
To install the ICA Win32 Program Neighborhood Client
1. Make sure the client computer is properly configured and cabled. Make sure
any previous installations of the Citrix ICA Client (including the ICA
Connection Center, whose icon appears in the system tray of the task bar if it is
active) are not running.
2. If you are installing from diskettes: Insert ICA Win32 Client Setup diskette
number 1 in drive A (or other appropriate drive) of the client computer. For
Windows 9x, Windows 2000, and Windows NT 4.0 client computers, click
Start > Run a:\setup. For Windows NT 3.5x client computers, on the File pulldown menu of Program Manager run a:\setup.
If you are installing from a Citrix server: run setup.exe, located in the
following directory on your Citrix server:
%SystemRoot%\System32\Clients\Ica\Ica32\Disks\Disk1
3. If you are installing from the Citrix ICA Client CD: run ica32.exe, located in
the following directory (substitute language with the language of your server
software):
Icaweb\language\ica32
where language is one of:
• En (English)
• Fr (French)
• De (German)
• Ja (Japanese)
• Es (Spanish)
Chapter 3 Deploying the ICA Win32 Clients
29
4. The Welcome screen appears. Read the information on this screen and click
Next.
The installation program searches your client computer for previously installed
versions of the ICA Win32 Program Neighborhood Client. If an older version is
detected, the screen shown in Step 5 appears. If no older version is detected, the
screen shown in Step 6 appears.
5. The Choose Installation Type dialog box appears:
The Choose Installation Type dialog box lets you choose to either upgrade the
existing client or create a new and separate installation of the ICA Win32 Client
in a new location. The default value is Upgrade the existing client. Click Next.
30
Citrix ICA Win32 Clients Administrator’s Guide
6. The Choose Destination Location dialog box appears:
You can change the displayed path if desired by clicking Browse. Click Next to
accept the displayed path and continue installation.
7. The Select Program Folder dialog box appears:
You can choose to use the default Citrix ICA Client folder, specify the name of
a new program folder, or add the ICA Win32 Client icons to an existing folder.
The program folder you specify is created if it does not already exist. Click Next
to continue.
Chapter 3 Deploying the ICA Win32 Clients
31
8. The ICA Client Name dialog box appears:
Specify a unique client name for your client computer. Citrix servers use the client
name to manage client printers and other system resources. If you do not always
assign a unique machine name to each client computer, device mapping and
application publishing may not operate correctly. When you are done, click Next
to continue. A progress window appears, displaying the file names as they are
copied to your hard drive.
9. If you are installing from diskette, the Setup Needs the Next Disk dialog box
appears. Remove the first ICA Win32 Client diskette from drive A (or other
appropriate drive) and insert the second diskette. Click OK.
10. When the Citrix ICA Client finishes copying the program files, the
Information dialog box appears. Click OK to exit this window.
The Citrix ICA Client program group appears on your desktop:
32
Citrix ICA Win32 Clients Administrator’s Guide
Starting the ICA Win32 Program Neighborhood Client
Users run Program Neighborhood to access applications published on Citrix
servers.
To start Program Neighborhood
1. Double-click the Program Neighborhood icon on your desktop to open the
Program Neighborhood window.
If you have specified a default application set for this user, this window contains
all the applications the user can run. If no default is specified, a list of
application sets appears. Select the application set to view and click Open from
the File menu. A login dialog box appears.
2. Enter a valid user name, domain, and password.
Installing the ICA Win32 Web Client
The instructions below describe how to install the ICA Win32 Web Client using a
typical installation. For information on configuring the ICA Win32 Web Client for
silent user installation, see “Configuring the ICA Win32 Web Client for Silent User
Installation” on page 24.
The ICA Win32 Web Client executable, ica32t.exe, is located on the ICA Client CD
in the following directory (substitute language with the language of your server
software):
Icaweb\language\ica32
where language is one of:
•
En (English)
•
Fr (French)
•
De (German)
•
Ja (Japanese)
•
Es (Spanish)
If you are using the ICA Win32 Web Client with Citrix NFuse, see the NFuse
Administrator’s Guide for information about deploying this ICA Client with NFuse.
Chapter 3 Deploying the ICA Win32 Clients
33
To install the ICA Win32 Web Client
1. Run ica32t.exe.
2. The initial prompt informs you that the Citrix ICA Win32 Web Client is about to
be installed. Click Yes to continue with setup or No to stop setup.
3. The Citrix License Agreement appears. Click Yes to accept the agreement or No
to reject the agreement. If you click No, setup stops.
4. You are informed that the setup program is copying files to the client device.
The default file location for the ICA Win32 Web Client is Program
Files\Citrix\icaweb32.
5. You are informed that the Citrix ICA Web Client was installed successfully.
Click OK to clear the message.
6. If you are running Netscape Navigator, you must restart the browser.
Updating the ICA Clients
Use the Client Auto Update feature to update ICA Client installations with new
versions of ICA Client software. As new versions of ICA Clients are released by
Citrix, you add them to the Client Update Database. New versions of ICA Clients
are released periodically and can be downloaded, along with the updated
documentation, from the Citrix Web site at http://www.citrix.com/download.
When users log on to a Citrix server, the server queries the ICA Client to determine
the version number. If the version matches the one in the Client Update Database,
the logon continues. If the server detects an older version on the client device, the
user is informed that a newer version of the ICA Client is available for download.
The user can update the client according to the options you set in the database.
Note For users of NFuse Version 1.5: If you have populated the Client Update
Database with the ICA Clients from the ICA Client CD included in the MetaFrame XP
media, users may receive unnecessary update notifications.
When a user visits an NFuse 1.5 Web site (either a site produced by the NFuse 1.5 Web
Site wizard or an example Web site), the client detection code in the site may incorrectly
notify the user that the client device does not have the latest ICA Client installed and
prompt the user to update the ICA Client. Select the Do not show this window at login
checkbox in the update message box to prevent the message from appearing again.
The client detection process has been corrected in NFuse Version 1.51, which is
included in the MetaFrame XP package. You can also download NFuse from the Citrix
Web site at http://www.citrix.com/download.
34
Citrix ICA Win32 Clients Administrator’s Guide
Client auto update works with all transport types supported by ICA (TCP/IP, IPX,
NetBIOS, and asynchronous). Client auto update supports the following features:
•
Automatically detects older ICA Client files
•
Copies new files over any ICA connection without user intervention
•
Provides administrative control of update options for each ICA Client
•
Updates ICA Clients from a single database on a network share point
•
Safely restores older ICA Client versions when needed
Important Client auto update can update client files to newer versions of the same
product and model. For example, it can update the ICA Win32 Client to a new
version. It cannot upgrade the ICA Win16 Client to the ICA Win32 Client.
The ICA Client Update Process
ICA Clients are identified by platform with a product and model number. The
version number is assigned when new ICA Clients are released.
The process of updating ICA Clients with new versions uses the standard ICA
protocol.
•
If an update is needed, by default, the Citrix server informs the user that a new
client is available and asks to perform the update. You can specify that the
update occurs without informing the user and without allowing the user to
cancel the update.
•
By default, the user can choose to wait for the client files to finish downloading
or to download the files in the background and continue working. Users
connecting to the Citrix server with a modem get better performance waiting for
the update process to complete. You can force the client update to complete
before allowing the user to continue.
•
During the update, new ICA Client files are copied to the user’s computer. You
can force the user to disconnect and complete the update before continuing the
session. The user must log on to the Citrix server again to continue working.
•
When the user disconnects from the server and closes all client programs, the
ICA Client update process finishes.
•
As a safeguard, the existing ICA Client files are saved to a folder named
Backup in the Citrix\ICA Client subdirectory of the Program Files directory on
the user’s local disk.
Chapter 3 Deploying the ICA Win32 Clients
35
Configuring the Client Update Database
You can configure a Client Update Database on each Citrix server in a server farm,
or configure one database to update the ICA Clients for multiple Citrix servers.
The Client Update Database contains several ICA Clients. As new versions of the
ICA Clients are released by Citrix, you add them to the Client Update Database.
Using the Client Update Configuration Utility
Use the Client Update Configuration utility to manage the client update database.
From this utility, you can:
•
Create a new update database
•
Specify a default update database
•
Configure the properties of the database
•
Configure client update options
•
Add new ICA Clients to the database
•
Remove outdated or unnecessary ICA Clients
•
Change the properties of an ICA Client in the database
The following sections give an overview of the Client Update Configuration utility.
For details, see the utility’s online help.
To start the ICA Client Update Configuration utility
1. From a MetaFrame XP server: From the Start menu, choose Programs >
Citrix > MetaFrame XP > ICA Client Update Configuration.
From a MetaFrame 1.8 server: From the Start menu, choose Programs >
MetaFrame Tools > ICA Client Update Configuration.
From a WINFRAME server: In the Administrative Tools folder, double-click
ICA Client Update Configuration.
36
Citrix ICA Win32 Clients Administrator’s Guide
2. The ICA Client Update Configuration window appears. The status bar shows
the location of the current update database, which the Citrix server uses to
update ICA Clients. The window shows the ICA Clients in the database.
Note MetaFrame for UNIX does not use the Client Update Database. To use the
Client Update Database, you must have either a MetaFrame for Windows or
WINFRAME server in your server farm.
Creating a New Client Update Database
The ICA Client Distribution wizard creates the Client Update Database in the
location %SystemRoot%\Ica\ClientDB. You can create a new update database in
any location on a server disk or on a network share point.
To create a new update database
1. From the Database menu, choose New. The Path for the new Client Update
Database dialog box appears.
2. Enter the path for the new update database and click Save. The utility creates a
new update database in the specified location and opens the new database.
Specifying a Default Client Update Database
You can configure one Client Update Database to be used by multiple Citrix
servers. If the Client Update Database is on a shared network drive, use the ICA
Client Update Configuration utility to configure your Citrix servers to use the same
shared database.
Chapter 3 Deploying the ICA Win32 Clients
37
To set the default database for Citrix servers
1. From the Database menu, choose Open.
2. Specify the path to the default database and click Open. The database opens.
3. On the Database menu, click Set Default. The Set Default Database dialog
box opens:
4. Select Set as Default Database on Local Machine to make the currently
opened database the default database. You can also set other Citrix servers to
use the currently open database as the default database.
5. Double-click a domain name to view the servers in that domain. Click a server
to set its default database to the currently open database. You can select multiple
servers by holding down the CTRL key and clicking each server.
6. Click OK.
38
Citrix ICA Win32 Clients Administrator’s Guide
Configuring Default Client Update Options
Use the Database Properties dialog box to configure overall database-wide
settings for the current Client Update Database. Choose Properties from the
Database menu to display the dialog box.
•
The Database Path box displays the path and file name of the database you are
configuring.
•
The Enabled check box must be selected for this database to perform ICA
Client updates.
Tip If the ICA Clients do not need to be updated, disable the database to
shorten your users’ logon time.
•
The options in the Default update properties for clients section specify the
default behavior for the ICA Clients added to the database. You can also set
properties for individual ICA Clients (as described later in this chapter).
Individual ICA Client properties override the database properties.
Chapter 3 Deploying the ICA Win32 Clients
39
• Under Client Download Mode, select Ask user to give the user the choice
to accept or postpone the update process. Select Notify user to notify the
user of the update and require the client update. Select Transparent to
update the user’s ICA Client software without notifying or asking the user.
• Under Version Checking, select Update older client versions only to
update only client versions that are older than the new client. Select Update
any client version with this client to update all client versions to this
version; choose this option to force an older client to replace a newer client.
• Under Logging, select Log downloaded clients to write an event to the
event log when a client is updated. By default, errors that occur during a
client update are written to the event log. Clear the Log errors during
download check box to turn this option off.
• Under Update Mode, select the Force disconnection option to require users
to disconnect and complete the update process after downloading the new
client. The Allow background download option is selected by default to
allow users to download new client files in the background and continue
working. Clear this check box to force users to wait for all client files to
download before continuing.
•
Specify the number of simultaneous updates on the server. When the specified
number of updates is reached, new client connections are not updated. When the
number of client updates is below the specified number, new client connections
are updated.
Click OK when you finish configuring the database settings.
40
Citrix ICA Win32 Clients Administrator’s Guide
Adding ICA Clients to the Client Update Database
When you want to deploy a newer version of the ICA Win32 Client, add it to the
Client Update Database. You can download the latest ICA Clients from the Citrix
Web site at http://www.citrix.com/download.
Working with the ICA Win32 Client Downloaded from the
Citrix Web Site
If you downloaded a new version of the ICA Win32 Program Neighborhood Client,
you must first extract the files from the executable ica32.exe before you can add the
client to the Client Update Database.
To extract files from ica32.exe
1. Copy ica32.exe to the root of your Citrix server’s hard drive.
2. Create a directory to contain the extracted files.
3. At a command prompt, type the following, substituting samplepath with the
path to the directory you created in Step 2:
ica32.exe /a /extract /path c:\samplepath
Note In the above command, the /path command is optional, but recommended. If
you do not specify a path, the files are extracted to %SystemRoot%\Ica\Cltimage by
default.
Chapter 3 Deploying the ICA Win32 Clients
41
To add a Citrix ICA Client to the Client Update Database
1. From the Client menu, click New to display the Description screen.
2. In the Client Installation File box, browse to or enter the path to the client
installation file Update.ini. If you ran the ICA Client Distribution Wizard, you
can find the Update.ini file in System32\Clients\Ica. You can also find the
Update.ini file on the ICA Client CD.
3. The client name, product number, model number, and version number are
displayed. The Comment text box displays a description of the new client. You
can modify this comment. Click Next to continue.
42
Citrix ICA Win32 Clients Administrator’s Guide
4. The Update Options dialog box appears. The options on this dialog box specify
how the client update process occurs for this client. The database-wide update
options are displayed. You can specify different behavior for individual clients.
For definitions of the options available in this dialog box, see the online help for
this dialog box.
Click Next when you finish configuring the client update options.
Chapter 3 Deploying the ICA Win32 Clients
43
5. The Event Logging dialog box appears.
The database-wide logging options are displayed. You can specify different
behavior for individual clients.
Select Log Downloaded Clients to write an event to the event log when this
client is updated. By default, errors that occur during a client update are written
to the event log. Clear the Log Errors During Download check box to turn this
option off.
Click Next.
44
Citrix ICA Win32 Clients Administrator’s Guide
6. The Enable Client dialog box appears.
The Client Update Database can contain multiple versions of an ICA Client
with the same product and model numbers. For example, when Citrix releases a
new version of the ICA Win32 Client, you add it to the Client Update Database.
However, only one version of the client can be enabled. The enabled client is
used for client updating.
Click Finish to copy the ICA Client installation files into the Client Update
Database.
Removing an ICA Client From the Client Update Database
It is important to delete ICA Clients that are not used from the Client Update
Database. A database that contains multiple versions of the same client significantly
slows the checking procedure that is carried out each time a user connects to the
server.
To remove the ICA Win32 Client from the database
1. Select the Win32 Client you want to remove from the database.
2. From the Client menu, choose Delete. A message box asks you to confirm the
deletion.
3. Click Yes to remove the client.
Chapter 3 Deploying the ICA Win32 Clients
45
Changing the Properties of the ICA Win32 Client
Use the Properties dialog box to set properties for an individual ICA Client.
Individual ICA Client properties override the database properties.
To change the properties of the ICA Win32 Client
1. Select the Win32 Client.
2. On the Client menu, choose Properties. The Properties dialog box appears.
This dialog box contains tabs labeled Description, Update Options, Event
Logging, and Client Files.
3. The Description tab of the Properties dialog box lists the client name, product
number, model number, and version number.
Select the Enabled check box to update the same platform ICA Client to this
version.
Optionally, enter a new comment in the Comment text box.
46
Citrix ICA Win32 Clients Administrator’s Guide
4. Use the Update Options tab to configure update options for the client.
• Under Client Download Mode, select Ask user to give the user the choice
to accept or postpone the update process. Select Notify user to notify the
user of the update and require the client update. Select Transparent to
update the user’s ICA Client software without notifying or asking the user.
• Under Version Checking, select Update older client versions only to
update only client versions that are older than the new client. Select Update
any client version with this client to update all client versions to this
version. Select this option to force an older client to replace a newer client.
• Select the Force Disconnection option to require users to disconnect and
complete the update process after downloading the new client.
• Select the Allow Background Download option to allow users to download
new client files in the background and continue working. Clear this check
box to force users to wait for all client files to download before continuing.
• Type a message to be displayed to users when they connect to the server.
Chapter 3 Deploying the ICA Win32 Clients
47
5. Use the Event Logging tab to configure logging settings for this client.
• Select the Log Downloaded Clients option to write an event to the event log
when a client is updated.
• Select the Log Errors During Download option to write errors that occur
during a client update to the event log.
48
Citrix ICA Win32 Clients Administrator’s Guide
6. Use the Client Files tab to view the list of files associated with this client.
The Client Update Database stores the following information about each client
file: file name, group, flags, file size, and file CRC.
7. Click OK when you finish configuring the settings for the client.
CHAPTER 4
Configuring the ICA Win32 Clients
Overview
This chapter describes how to use and configure the ICA Win32 Clients. Topics in
this chapter include:
•
Mapping client devices
•
Configuring multiple monitors
•
Connection types
•
Configuring connections to Citrix servers and published applications
•
Using the ICA Win32 Clients with Application Launching and Embedding
(ALE)
Mapping Client Devices
The Citrix ICA Client supports mapping devices on client computers so they are
available to the user from within an ICA session. Users can:
•
Transparently access local drives, printers, and COM ports
•
Cut and paste between the ICA session and the local Windows clipboard
•
Hear audio (system sounds and Wav files) played from the ICA session
During logon, the ICA Client informs the Citrix server of the available client drives,
COM ports, and LPT ports. By default, client drives are mapped to server drive
letters and server print queues are created for Windows ICA Client printers so they
appear to be directly connected to the Citrix server. These mappings are available
only for the current user during the current session. They are deleted when the user
logs off and recreated the next time the user logs on.
You can use the net use and change client commands to map client devices not
automatically mapped at logon. See your Citrix server documentation for
information about the change client command.
50
Citrix ICA Win32 Clients Administrator’s Guide
Turning Off Client Device Mappings
On a MetaFrame server, specify client device mapping options in the Client
Settings dialog box in Citrix Connection Configuration. On a WINFRAME server,
specify client device mapping options in Citrix Connection Configuration.
The Connection options control whether drives and printers are mapped to client
drives and printers. If these options are cleared, the devices are still available but
must be mapped to drive letters and port names manually.
Use the Client Mapping Overrides to disable client device connections.
Option
Description
Connect Client
Drives at Logon
If this option is checked, the client computer’s drives are
automatically mapped at logon.
Connect Client
Printers at Logon
If this option is checked, the client computer’s printers are
automatically mapped at logon. This option applies only to
Windows clients and maps only printers already configured in
Print Manager on the client computer.
Default to Main
Client Printer
If this option is checked, the user’s default client printer is
configured as the default printer for the ICA session.
(inherit user config)
If this option is checked, the per-user settings in User Manager
override these settings.
Chapter 4 Configuring the ICA Win32 Clients
51
Mapping Client Drives
Client drive mapping allows drive letters on the Citrix server to be redirected to
drives that exist on the client computer; for example: drive H in a Citrix user session
can be mapped to drive C of the local computer running the Citrix ICA Client.
Client drive mapping is transparently built into the standard Citrix device
redirection facilities. These mappings can be used by the File Manager or Explorer
and your applications just like any other network mappings.
Important Client drive mapping is not supported when connecting to MetaFrame
for UNIX 1.0 and 1.1 servers.
The Citrix server can be configured during installation to automatically map client
drives to a given set of drive letters. The default installation mapping maps drive
letters assigned to client drives starting with V and works backwards, assigning a
drive letter to each fixed disk and CD-ROM. (Floppy drives are assigned their
existing drive letters.) This method yields the following drive mappings in a client
session:
Client drive letter
Is accessed by the Citrix server as:
A
A
B
B
C
V
D
U
The Citrix server can be configured so that the server drive letters do not conflict
with the client drive letters; in this case the Citrix server drive letters are changed to
higher drive letters. For example, changing Citrix server drives C to M and D to N
allows client computers to access their C and D drives directly. This method yields
the following drive mappings in a client session:
Client drive letter
Is accessed by the Citrix server as:
A
A
B
B
C
C
D
D
52
Citrix ICA Win32 Clients Administrator’s Guide
The drive letter used to replace the Citrix server drive C is defined during Setup. All
other fixed disk and CD-ROM drive letters are replaced with sequential drive letters
(for example; C->M, D->N, E->O). These drive letters must not conflict with any
existing network drive mappings. If a network drive is mapped to the same drive
letter as a Citrix server drive letter, the network drive mapping is not valid.
When an ICA Client computer connects to a Citrix server, client mappings are
reestablished unless automatic client device mapping is disabled. Automatic client
device mapping can be configured for ICA connections and users. In the Client
Settings dialog box, you can enable or disable automatic client device mapping for
an ICA connection. The User Configuration dialog box in User Manager for
Domains allows you to enable or disable automatic client device mapping for a
user.
Mapping Client Printers
The Citrix ICA Win32 Client supports auto-created printers. With auto-created
printers, users find their local printers mapped to their sessions and ready for use as
soon as they connect.
Published applications and ICA server connections configured to run a specified
initial program offer users the same access to their local printers. When connected
to published applications, users can print to local printers in the same way they
would print to a local printer when using locally run applications.
Important For information about how to configure ICA Client printing for
MetaFrame for UNIX connections, see the MetaFrame for UNIX Operating
Systems Administrator’s Guide.
If the Connect Client Printers at Logon check box is checked in the terminal
connection or user profile, the client printers are automatically connected when
users log on and are deleted when they log off if the printers do not contain any
print jobs. If print jobs are present, the printer (and its associated jobs) is retained.
If users do not want the automatically created printers deleted when they log off,
use Print Manager in the ICA session to view the Properties dialog box for the
client printer. This dialog box contains a Comment field (on MetaFrame servers) or
a Description field (on WINFRAME servers) that contains the string Auto Created
Client Printer for automatically created client printers. If you modify or delete this
description, the printer is not deleted at logoff. Subsequent logins will use the
printer already defined and not modify it. If users change the Windows printer
settings, they will not automatically be set in this case. One reason for not wanting
them deleted may be the use of custom print settings.
Chapter 4 Configuring the ICA Win32 Clients
53
If your user and terminal connection profile do not specify Connect Client
Printers at Logon, you can use Print Manager to connect to a client printer. These
printers are not automatically deleted when you log off.
To view mapped client printers when connected to a MetaFrame server
While connected to the MetaFrame server, double-click My Computer on the
remote desktop and then double-click Printers. The Printers dialog box appears:
The Printers screen displays the local printers mapped to the ICA session. The
name of the printer takes the form clientname#printername, where clientname is the
unique name given to the client computer during ICA Client Setup and printername
is the Windows printer name. In this example ICA session, a client machine called
“Snoop40” has access to its local printer named “Laser.” This name cannot be
changed and is used to locate the specific printer. Because the Windows printer
name is used and not the port name (as with DOS Client printing), multiple printers
can share a printer port without conflict.
To view mapped client printers when connected to a WINFRAME server
While connected to the WINFRAME server, double-click Print Manager in the Main
program group. The Print Manager dialog box appears:
54
Citrix ICA Win32 Clients Administrator’s Guide
Print Manager displays the local printers mapped to the ICA session. The name of
the printer takes the form clientname#printername, where clientname is the unique
name given to the client computer during ICA Client setup and printername is the
Windows printer name. In this example ICA session, a client machine called
“Snoop40” has access to its local printer named “Laser.” This name cannot be
changed and is used to locate the specific printer. Because the Windows printer
name is used and not the port name (as with DOS Client printing), multiple printers
can share a printer port without conflict.
Mapping Client COM Ports
Client COM port mapping allows devices attached to the client computer’s COM
ports to be used during ICA sessions on a Citrix server. These mappings can be
used just like any other network mappings.
Note Client COM port mapping is not supported when connecting to MetaFrame for
UNIX 1.0 and 1.1 servers.
To map a client COM port
1. Start the ICA Client and log on to the Citrix server.
2. Start a DOS command prompt: on WINFRAME, double-click Command Prompt
in the Main program group. On MetaFrame, click Start, then click Programs,
then click Command Prompt.
3. At the prompt, type net use comx: \\client\comz: where x is the number of the
COM port on the server (ports 1 through 9 are available for mapping) and z is
the number of the client COM port you want to map. Press ENTER.
4. To confirm the operation, type net use at the prompt. The list that appears
contains mapped drives, LPT ports, and mapped COM ports.
To use this COM port in a session on a Citrix server, install your device to the
mapped name. For example, if you map COM1 on the client to COM5 on the
server, install your COM port device on COM5 during the session on the server.
Use this mapped COM port as you would a COM port on the client computer.
Note COM port mapping is not TAPI-compatible. TAPI devices cannot be mapped to
client COM ports.
Chapter 4 Configuring the ICA Win32 Clients
55
Mapping Client Audio
Client audio mapping enables applications running on the Citrix server to play
sounds through a Windows-compatible sound device installed on the client
computer. You can control the amount of bandwidth used by client audio mapping.
Note Client audio mapping is not supported when connecting to MetaFrame for
UNIX 1.0 and 1.1 servers.
To configure ICA Client audio on a MetaFrame server
1. Click ICA Settings in Terminal Server Connection Configuration.
2. Select an option from the Client Audio Quality drop-down list.
To configure ICA Client audio on a WINFRAME server
1. Click ICA Settings in Citrix Connection Configuration.
2. Select an option from the Client Audio Quality drop-down list.
Client Audio Mapping can cause excessive load on the Citrix servers and the
network. The higher the audio quality, the more bandwidth is required to transfer
the audio data. Higher quality audio also uses more server CPU to process. Three
different audio quality settings are available, or client audio mapping can be
disabled completely.
Important You can set audio quality on a per-connection basis, but users can also
set it on the client computer. If the client and server audio quality settings are
different, the lower of the two qualities is used.
The Client Audio Quality options are:
•
High. This setting is recommended only for connections where bandwidth is
plentiful and sound quality is important. This setting allows clients to play a
sound file at its native data rate. Sounds at the highest quality level require about
1.3Mbps of bandwidth to play clearly. Transmitting this amount of data can
result in increased CPU utilization and network congestion.
56
Citrix ICA Win32 Clients Administrator’s Guide
•
Medium. This setting is recommended for most LAN-based connections. This
setting causes any sounds sent to the client to be compressed to a maximum of
64Kbps. This compression results in a moderate decrease in the quality of the
sound played on the client computer. The host CPU utilization will decrease
compared with the uncompressed version due to the reduction in the amount of
data being sent across the wire.
•
Low. This setting is recommended for low-bandwidth connections, including
most modem connections. This setting causes any sounds sent to the client to be
compressed to a maximum of 16Kbps. This compression results in a significant
decrease in the quality of the sound. The CPU requirements and benefits of this
setting are similar to those of the Moderate setting; however, the lower data rate
allows reasonable performance for a low-bandwidth connection.
Configuring Multiple Monitors
If your client operating system with video hardware and drivers provides multiple
monitor support with the Windows taskbar on the primary (left) monitor (Windows
98 and 2000 mode of multiple monitor support), there are restrictions in the level of
support when using the client configured with “seamless” windows. Multiple
monitors are fully supported when the client is configured in a non-seamless mode
and set with the same color depth on all monitors in use.
Note Secondary windows sometimes appear in the primary monitor (uppermost, left).
System Hardware Requirements
To enable multiple monitor support the system must have the following:
•
Multiple PCI video boards, compatible with the Citrix ICA Client on the
appropriate Windows platform
-Or-
•
A special multiple monitor video board, such as Matrox G400, compatible with
the Citrix ICA Client on the appropriate Windows platform
Chapter 4 Configuring the ICA Win32 Clients
57
The following hardware configurations have been tested with multiple monitor
support.
Note It is highly recommended that you test these configurations on your own
hardware to ensure that they function properly for your specific machine configuration.
•
On Windows 98, Matrox G400 is fully supported as a Windows 98/2000-style
multiple monitor
•
On Windows 2000, Matrox G400 works in a Windows NT4.0/Windows 95style multiple monitor
•
Both Windows 98 and Windows 2000 support Matrox G200 PCI (multiple
cards installed) as a Windows 98/2000-style multiple monitor
•
Windows 98 supports a wide variety of PCI video boards, including many
models from ATI and Cirrus Logic
Connection Types
Using the Citrix ICA Win32 Client, users can connect to a Citrix server in the
following ways:
•
By dialing into a Citrix server using the modem installed on the client PC. This
method uses a serial connection to a Citrix server (custom ICA connections
only).
•
Over a direct serial cable connection to a Citrix server. This method uses a serial
connection to a Citrix server (custom ICA connections only).
•
Over the local or wide-area network connection between the client PC and the
Citrix server. This method uses one of the following network protocols:
• TCP/IP
• TCP/IP+HTTP
• IPX
• SPX
• NetBIOS
You can also use Microsoft’s Remote Access Service (RAS) or Dial-Up
Networking (DUN) in combination with the Citrix ICA Client to connect a client
PC with a Citrix server.
58
Citrix ICA Win32 Clients Administrator’s Guide
This type of connection requires:
•
The RAS or DUN client software is installed on the client PC
•
The RAS server or third-party PPP server is in the same network as the Citrix
server
Configuring a SOCKS Proxy Connection
You can configure the ICA Win32 Client to connect to a Citrix server through a
SOCKS proxy server. This section describes:
•
Why you use a SOCKS proxy server
•
Where to locate your SOCKS proxy server
Using SOCKS to Direct ICA Traffic Through Firewalls
To limit access into and out of your Citrix servers, configure a SOCKS proxy server
to handle connections between clients and the server. You can place the proxy
server on either side of the firewall, or in some situations, on both sides of the
firewall.
The benefits of using a SOCKS proxy server include:
•
Information hiding, where system names inside the firewall are not made
known to systems outside the firewall through DNS (Domain Name System)
•
Authentication between an ICA Client and SOCKS proxy servers
•
Authentication between two SOCKS proxy servers
•
Relaying between two SOCKS proxy servers
•
Channeling different TCP connections through one connection
•
UDP proxying
Note The ICA Win32 Client supports only clear text username and password
authentication.
The general procedure for connecting the ICA Win32 Client through a proxy is:
1. Be sure that your firewall is configured and working properly.
2. Install your SOCKS proxy server and test that it works with Web browsers.
3. Configure and deploy the ICA Win32 Client.
Chapter 4 Configuring the ICA Win32 Clients
59
Locating Your Proxy Server
You can locate your proxy server on either side of your firewall. In some situations,
you may want to locate a proxy server on both sides of the firewall. Typical SOCKS
proxy configurations are described below. See your proxy documentation for
further details about placement and implementation of your proxy server.
Setting Up a Proxy Between Clients and a Firewall
(for Outbound Connections)
To restrict clients from connecting directly to servers outside your firewall, install a
proxy server between the client systems and the firewall, as shown below.
The proxy server uses its authentication features to determine whether ICA Clients
can access networks outside the firewall. Configure the firewall to pass only
network traffic that comes from the SOCKS proxy server.
Setting Up a Proxy Between Citrix Servers and a Firewall (for Inbound
Connections)
To protect your Citrix servers, install a proxy server between your servers and the
firewall. You can configure the firewall in two ways:
Maximize Trust. Configure the firewall to pass only network traffic that is directed
to the SOCKS proxy server. The proxy server performs the authentication of the
ICA Client.
60
Citrix ICA Win32 Clients Administrator’s Guide
Minimize Risk. Configure the firewall to allow only connections from specific
machines in addition to passing network traffic that is directed only to the SOCKS
proxy server.
Setting Up a Virtual Private Network Using Two Proxy Servers
You can create a Virtual Private Network (VPN) between two sites by configuring a
proxy server inside the firewall at both the client and server sites. Set up the
firewalls to allow only directed UDP traffic between the two SOCKS proxy servers
and TCP on the SOCKS port. For additional security, configure the SOCKS proxy
server on the ICA Client side to authenticate with the SOCKS proxy server on the
Citrix server side. To obtain the address of a SOCKS proxy server within an outside
firewall, contact the system administrator responsible for configuring that firewall.
Configuring Connections to Citrix Servers and Published
Applications
This section describes how to configure connections to Citrix servers and published
applications. Program Neighborhood offers the user two methods of connection:
•
Connecting to Citrix servers and published applications using application sets
•
Connecting to Citrix servers and published applications using custom ICA
connections
For detailed information about application publishing, see your Citrix server
documentation.
Chapter 4 Configuring the ICA Win32 Clients
61
Configuring Server Location and Business Recovery
Server location (also called server browsing) provides a method for a user at a
network-connected ICA Client to view a list of all Citrix servers on the network that
have ICA connections configured for that network protocol, and a list of all
published applications. You can specify a separate server location for each network
protocol.
The default setting for server location is (Auto-Locate). The auto-locate function
works as follows:
1. The ICA Client broadcasts a “Get Nearest Citrix server” packet. The first Citrix
server to respond returns the address of the master ICA Browser, which is used
in the next step.
2. The ICA Client sends a request for the server and published application lists to
the master ICA Browser.
3. The master ICA Browser responds with a list of all Citrix servers on the
network and a list of all published applications.
Business recovery provides consistent connections to published applications in
the event of a master ICA Browser server disruption. You can define up to three
groups of Citrix servers to which you want to connect: a primary and two
backups. Each group can contain from one to five servers. When you specify a
server group for your client, the client attempts to contact all the servers within
that group simultaneously (broadcasting) and the first server to respond is the
one to which you connect. The client broadcasts only if you have selected
(Auto-locate) from the address list.
To eliminate broadcasts on your network, or if your network configuration uses
routers or gateways, you can set a specific server address for the Citrix server
that functions as the master browser.
To configure server location and business recovery settings
On the Connection page for both custom ICA connections and application sets, use
the following fields to configure server location and business recovery settings:
Network Protocol. Use the Network Protocol field to instruct the Citrix ICA
Client what low-level network protocol to use to connect to a Citrix server. The
protocol that you select must be installed on your local computer and must also be
in use on the Citrix server to which you want to connect.
Server Group. Use the Server Group field to create lists of specific servers that
you want to designate as primary and backup servers for connecting to published
applications.
62
Citrix ICA Win32 Clients Administrator’s Guide
Use this field to designate whether the servers entered in the Address List field
belong to your Primary, first backup (Backup 1), or second backup (Backup 2)
group.
Important Each of these server groups must be located on different subnets.
Address List. Use the Address List field to:
•
Designate servers for your primary and backup server groups.
•
View and change the list of Citrix servers used in the selected server group.
•
Specify an address of a Citrix server that will retrieve server and published
application information from the network.
If you have not selected any servers, [Auto-Locate] is selected by default.
• Click Add to add a Citrix server to your server group’s address list. You can
use the IP address or name of the Citrix server.
Important All Citrix servers within a server group must be located on the
same subnet.
• Click Delete to remove the selected Citrix server from the Address List.
• If [Auto-Locate] is selected, the first server is located automatically.
•
Firewalls. Click Firewalls to display the Firewall Settings page. Use this page
to configure the ICA Win32 Client to connect to a Citrix server through a
SOCKS proxy server, or to use an alternate address to browse for Citrix servers
and published applications that are inside a firewall.
To configure firewall settings
1. Click Firewalls on the Connection properties page.
2. Select Use alternate address for firewalls to browse for Citrix servers or
published applications that are inside a firewall from a client machine that is
outside the firewall. The firewall and the Citrix servers must be configured to
map the internal network addresses of Citrix servers to external Internet
addresses. Enter the external Internet address in the Address List.
3. Click the check box next to Connect via SOCKS proxy. Enter the SOCKS
proxy’s IP address in the Address of proxy to use box. Enter the port number of
the SOCKS proxy server (if different than 1080) in the Port box. See the online
help for more information.
Chapter 4 Configuring the ICA Win32 Clients
63
Note Because you can enter only one SOCKS proxy server address, you cannot
configure separate SOCKS settings for primary and backup servers.
Configuring TCP/IP+HTTP Server Location
You can retrieve Citrix server and published application information across a
firewall that does not allow UDP broadcasts by using TCP/IP+HTTP server
location.
To configure TCP/IP+HTTP server location
1. Select TCP/IP + HTTP from the Network Protocol drop-down list.
2. Click Add to display the Add Server Location Address box.
3. Enter the name or IP address of a Citrix server and a recognized port number
(the default is port 80) and click OK.
Note If you do not enter an IP address, you must have a Citrix server on your
network mapped to the default name of ica.domainname, where domainname is a
TCP/IP domain name. TCP/IP+HTTP server location does not support the [AutoLocate] function.
4. The specified server responds with a list of all servers and published
applications in its server farm.
Important TCP/IP+HTTP server location retrieves information only on a perserver farm basis. To retrieve information from more than one server farm, you
must configure TCP/IP+HTTP server location settings for each application set.
For custom ICA connections, you must configure the TCP/IP+HTTP server
location settings for each ICA connection. Do not place addresses from separate
farms into the same server location list.
For more information about configuring connections, see “Configuring Connection
Properties” later in this chapter.
Using Application Sets and Custom ICA Connections
An application set is a user’s view of the applications published on a given server
farm that the user is authorized to access. Applications published in an application
set are preconfigured for such session properties as window size and colors and
supported level of encryption, audio, and video. If these settings are not required to
run the published application (such as a required level of encryption), they can be
changed on the client machine at the application set level.
64
Citrix ICA Win32 Clients Administrator’s Guide
Important Application set functionality is not available for applications published
on a MetaFrame for UNIX server. To connect to an application published on a
MetaFrame for UNIX server, you must use a custom ICA connection.
A custom ICA connection is a connection to:
•
An existing Citrix server outside of a server farm scope of management
•
An application published prior to the installation of a MetaFrame or WINFRAME
1.8 server that cannot be migrated into a server farm
•
An application published on a MetaFrame for UNIX Operating Systems server
Applications published in this way are not enabled for automatic configuration of
Program Neighborhood sessions.
Adding Application Sets and Custom ICA Connections
To locate additional application sets that you can access, or to add a custom ICA
connection, use the Find a New Application Set and the Add New ICA Connection
wizards.
To find a new application set
1. Double-click the Find a New Application Set icon in the Program
Neighborhood window.
2. Follow the instructions in the Find a New Application Set wizard.
To add a custom ICA connection
1. Double-click the Custom ICA Connections option to display the Custom ICA
Connections window.
2. Double-click the Add ICA Connection icon
3. Follow the instructions in the Add New ICA Connection wizard.
For details about the settings in the Find a New Application Set and Add New
ICA Connection wizards, see the wizards’ application help.
Chapter 4 Configuring the ICA Win32 Clients
65
Configuring Application Sets and Custom ICA
Connections
The following procedures describe how to configure the properties and settings of
application sets and custom ICA connections:
•
Configuring connection properties
•
Configuring default options
•
Configuring login properties
•
Configuring general settings
•
Configuring bitmap caching
•
Configuring hotkeys
•
Configuring event logging
Configuring Connection Properties
To configure connection properties
1. Start Program Neighborhood.
2. Select an application set or a custom ICA connection.
3. In the Program Neighborhood toolbar, click Properties to display the
Properties dialog box.
4. Click the Connection tab to display the Connection page.
From the Connection page, you can configure the following:
Connection Type. Choose a connection type. Select Local Area Network to
connect to the Citrix server over a local network that covers a confined
geographical area (such as an office building or complex). Select Wide Area
Network to connect to the Citrix server over a network that covers a wide
geographical area.
If you are configuring to a custom ICA connection, you can select either Server
or Published Application. When you select the Server radio button, this field
specifies the Citrix server that will be used to connect and run the published
application.
66
Citrix ICA Win32 Clients Administrator’s Guide
Configuring Default Options
To configure default options
1. Start Program Neighborhood.
2. If you are configuring an application set:
Select the application set and click Settings in the Program Neighborhood
toolbar.
If you are configuring a custom ICA connection:
Right-click in the custom ICA connection window and select Custom
Connections Settings.
3. Click the Default Options tab to display the Default Options page. For custom
ICA connections: Any options configured in this dialog box are applied to all
custom ICA connections. To override these default options on an individual
custom ICA connection, select the ICA connection and click Properties on the
Program Neighborhood toolbar. Select the Options tab.
From the Options and Default Options pages, you can configure the following:
Use data compression. Data compression reduces the amount of data that
needs to be transferred but requires additional processor resources to compress
and decompress the data. If your connection is bandwidth-limited, enabling data
compression increases performance.
Use disk cache for bitmaps. Bitmap caching to disk stores commonly-used
graphical objects such as bitmaps in a local cache on the client’s hard disk
space. If your connection is bandwidth-limited, enabling disk caching increases
performance. If your client is on a high-speed LAN, you do not need disk
caching. Dial-in connections have disk caching enabled by default.
Queue mouse movements and keystrokes. Queuing causes the client to send
mouse and keyboard updates less frequently to the Citrix server. Check this
option to reduce the number of network packets sent from the ICA Client to the
Citrix server. Leaving this option unchecked makes the session more responsive
to keyboard and mouse movements. Checking this option improves
performance if you dial in to RAS and then use a network to connect.
Chapter 4 Configuring the ICA Win32 Clients
67
Turn off desktop integration for this application set. You can configure
Program Neighborhood to create desktop shortcuts and add items to the Start
menu for published applications. If users do not want published applications
sent directly to the desktop, they can select this check box.
Enable sound. Check this box to enable sound support. The client computer
must have a compatible sound card installed. Published applications can then
play sounds on the client.
Select one of the following values for Quality:
• High. This setting is recommended only for connections where bandwidth is
plentiful and sound quality is important. This setting allows clients to play a
sound file at its native data rate. Sounds at the highest quality level require
about 1.3Mbps of bandwidth to play clearly. Transmitting this amount of
data can result in increased CPU utilization and network congestion.
• Medium. This setting is recommended for most LAN-based connections.
This setting causes any sounds sent to the client to be compressed to a
maximum of 64Kbps. This compression results in a moderate decrease in the
quality of the sound played on the client computer. The host CPU utilization
will decrease compared with the uncompressed version due to the reduction
in the amount of data being sent across the wire.
• Low. This setting is recommended for low-bandwidth connections, including
most modem connections. This setting causes any sounds sent to the client to
be compressed to a maximum of 16Kbps. This compression results in a
significant decrease in the quality of the sound. The CPU requirements and
benefits of this setting are similar to those of the Moderate setting; however,
the lower data rate allows reasonable performance for a low-bandwidth
connection.
Encryption Level. Select the level of encryption for the ICA connection. The
default level is Basic. Select RC5 128-bit Login Only to use encryption during
authentication.
The Citrix server must be configured to allow the selected encryption level or
greater. To enable encryption levels higher than Basic, the Citrix server must
support RC5 encryption. This support is included with SecureICA Services,
MetaFrame 1.8 Feature Release 1, and MetaFrame XP.
Note Selecting RC5 encryption disables automatic logon to the Citrix server.
68
Citrix ICA Win32 Clients Administrator’s Guide
SpeedScreen Latency Reduction. SpeedScreen Latency Reduction is a
collective term used to describe the functionality that helps enhance user
experience on slower network connections. Latency reduction is available only
if you are connecting to a server that is configured and licensed for latency
reduction.
For slower connections (for example if you are connecting over a WAN or a
dial-in connection), set mode to On to decrease the delay between user input
and screen display. Choose either Mouse Click Feedback, or Local Text Echo.
For faster connections (for example, if you are connecting over a LAN), set
mode to Off.
If you are not certain of the connection speed, set mode to Auto to turn latency
reduction on or off depending on the speed of the connection. You can override
Auto mode using the Toggle Latency Reduction hotkey.
Window Size. This field specifies the window size that a published application
runs in.
If you are connecting to a published application, you can select Seamless
Windows to run the application on your local desktop in a separate, seamless
window.
Window Colors. This field specifies the number of colors displayed.
Use Server Default (for application sets). To use the server-configured default
settings for the properties, make sure this box is checked. To change the
settings, deselect this check box and choose new settings.
Use Custom Default (for custom ICA connections). To override the default
options, deselect this check box.
Configuring Login Properties
To configure login properties
1. Start Program Neighborhood.
2. Select an application set or custom ICA connection.
Chapter 4 Configuring the ICA Win32 Clients
69
3. If you are configuring an application set, select the application set and click
Settings in the Program Neighborhood toolbar. If you are configuring a custom
ICA connection, select the custom ICA connection and click Properties in the
Program Neighborhood toolbar
4. Click the Login Information tab.
5. Enter a valid username, domain, and password for this application set. If the
Use local username and password box is checked, the user’s local desktop
credentials are passed to the server.
6. To save your password after you exit Program Neighborhood and close all
connections, select Save password. If you leave this box unchecked, this
password is retained only as long as Program Neighborhood and all current
connections are open.
Note The Save password option is available only for application sets.
7. Click OK.
Preventing Users From Saving Passwords
Program Neighborhood provides administrators with the ability to disable password
saving for a single application set or all application sets. By setting a parameter in
one of two Program Neighborhood Ini files, you can prevent the Save Password
check box from appearing in the Login Information tab and in the initial logon
screen a user sees when authenticating to an application set.
To disable password saving, you must add a parameter and value to one of two
Program Neighborhood Ini files located in the Program Neighborhood installation
directory. The file you choose to add the parameter and value to determines which
application sets prohibit password saving. Add the parameter and value to:
•
Appsrv.ini to prevent all application sets from saving password information
•
Pn.ini to prevent individual application sets from saving password information
Note If you add the parameter to both files, the parameter in Appsrv.ini overrides the
Pn.ini entry if the Appsrv.ini entry is set to On. If the entry in Appsrv.ini is set to Off or
if it does not exist, the entry in Pn.ini is used (if it exists). Setting an entry to Off and
leaving it out of the Ini files results in Save Password check boxes appearing in
Program Neighborhood.
70
Citrix ICA Win32 Clients Administrator’s Guide
To disable password saving for all application sets
1. Exit Program Neighborhood if it is running. Make sure all Program
Neighborhood components, including the Connection Center, are closed.
2. Load the file Appsrv.ini in a text editor.
3. Locate the section named [WFClient].
4. Add the following text to the list of parameters and values in [WFClient]:
NoSavePwordOption=On
If the parameter already exists, make sure its value is set to On.
5. Save the file and exit the text editor.
6. Start Program Neighborhood.
Adding this parameter and setting it to On prevents users from saving passwords
for all application sets. Any existing cached passwords are deleted.
To disable password saving for individual application sets
1. Exit Program Neighborhood if it is running. Make sure all Program
Neighborhood components, including the Connection Center, are closed.
2. Load the file Pn.ini in a text editor.
3. Locate the section name that corresponds to the application set on which you
want to disable password saving; for example, [MyAppSet].
4. Add the following text to the list of parameters in the section:
NoSavePwordOption=On
If the parameter already exists, make sure its value is set to On.
Add the parameter and value to each application set section as desired.
5. Save the file and exit the text editor.
6. Start Program Neighborhood.
Adding this parameter and setting it to On prevents users from saving passwords
for the specified application set(s). Any existing cached passwords are deleted.
Chapter 4 Configuring the ICA Win32 Clients
71
Configuring General Settings
To configure the general settings
1. Start Program Neighborhood.
2. From the Tools menu, click ICA Settings to display the ICA Settings dialog
box.
3. Click the General tab.
From the General page, you can configure the following settings:
• Client Name. This field allows you to change the name of the client
computer. The Citrix server uses the client name to uniquely identify
resources (such as mapped printers and disk drives) associated with a given
client PC. The client name must be unique for each computer running the
Citrix ICA Client.
• Serial Number. This is the serial number of the ICA Client software. This
field is necessary only when you are using the Citrix ICA Client with a Citrix
Terminal product such as WINFRAME for Terminals and MetaFrame for
Terminals, which require each client to have a Citrix PC Client Pack serial
number to connect to the server. If a serial number is required, you must enter
it exactly as it appears on the Serial Number card.
• Keyboard Layout. Allows you to specify the keyboard layout of your client
computer. The Citrix server uses the keyboard layout information to configure
your user session for your keyboard layout. The default value of (User Profile)
uses the keyboard layout specified in your user profile.
• Keyboard Type. Allows you to specify the keyboard type of your client
computer. The Citrix server uses the keyboard type information to configure
your user session for your keyboard type. Use the default value of Default
for most English and European keyboards. When used with a Japanese
keyboard, Default auto-detects the keyboard type.
• Display Connect To screen when making Dial-in Connections. Check this
box to display the Connect To screen when you make a dial-in connection.
• Display terminal window when making Dial-in Connections: Check this
box if your dial-in configuration includes third-party products, such as
security devices and X.25 PADs, that require an ASCII dialog before
connecting to the Citrix server.
72
Citrix ICA Win32 Clients Administrator’s Guide
• Allow automatic client updates: Check this box to allow the Citrix server to
update your Citrix ICA Client software when newer versions become
available. When the Citrix server detects an outdated client version, it
notifies you that a newer version is available and replaces the ICA Client
files.
• Use local username and password for logon: Check this box to enable this
feature in the Login dialogs.
Configuring Bitmap Caching
To configure bitmap caching
1. Start Program Neighborhood
2. From the Tools menu, click ICA Settings to display the ICA Settings dialog
box.
3. Click the Bitmap Cache tab.
From the Bitmap Cache page, you can configure the following settings:
• Amount of disk space to use. Use this tool to configure the amount of disk
space as a percentage of the partition containing the caching directory.
• Bitmap cache directory. The default directory where the cached data is
stored is displayed in this field.
• Change Directory. If you want to specify a new directory for cached data,
click the Change Directory button to display the Change Bitmap Cache
Directory dialog box.
• Minimum size bitmap to be cached. The size of the smallest bitmap to be
cached to disk.
• Clear cache. Click this button to remove all cached data from the directory.
Tip It is not recommended to clear the cache if any ICA connections are open.
Before clearing the cache, verify that all ICA connections are closed.
Chapter 4 Configuring the ICA Win32 Clients
73
Configuring Hotkeys
To configure the hotkeys
1. Start Program Neighborhood.
2. From the Program Neighborhood menu bar, click Settings to display the
Settings dialog box.
3. Click the Hotkeys tab.
4. For each hotkey in the list, select a shift state and a key.
5. You can disable the hotkey by selecting (none) for the key.
Hotkeys are used to control the behavior of the Win32 Client, and as substitutes
for the standard Windows hotkeys for a published application.
The fields on the Hotkeys page are:
• Task List. The Task List hotkey displays the Windows Task List for your
local Windows NT 3.51 computer or the local Start menu if your local
machine is a Windows NT 4.0 or Windows 95/98/2000 computer.
• Close Remote Application.The Close Remote Application hotkey
disconnects the published application from the Citrix server and closes the
Citrix ICA Client window. The behavior of this hotkey is the same as
choosing Close from the system menu of the ICA Client window.
Closing the published application in this manner either leaves the associated
application in a disconnected state on the Citrix server, or exits the
application on the Citrix server, depending on how the server is configured.
• Toggle Title Bar. This hotkey causes the ICA Client window to alternately
display and hide its title bar. When the title bar is displayed, the ICA Client
window can be moved or closed.
Tip This hotkey must be used to return to a seamless window after accessing
the Windows NT Security dialog box using the CTRL+ALT+DEL hotkey.
• CTRL-ALT-DEL. This hotkey causes the CTRL-ALT-DEL key sequence to
be sent to the server that is running the published application. In Windows
NT, the CTRL-ALT-DEL key sequence causes a Windows NT session to
switch to the Windows NT Security desktop.
74
Citrix ICA Win32 Clients Administrator’s Guide
• CTRL-ESC. This hotkey causes the CTRL-ESC key sequence to be sent to
the server that is running the published application. CTRL-ESC is a standard
Windows hotkey. See your Windows documentation for more information
about the CTRL-ESC hotkey.
• ALT-ESC. This hotkey causes the ALT-ESC key sequence to be sent to the
server that is running the published application. ALT-ESC is a standard
Windows hotkey. See your Windows documentation for more information
about the ALT-ESC hotkey.
• ALT-TAB. This hotkey causes the ALT-TAB key sequence to be sent to the
server that is running the published application. ALT-TAB is a standard
Windows hotkey. See your Windows documentation for more information
about the ALT-TAB hotkey.
• ALT-BACKTAB. This hotkey causes the ALT-SHIFT-TAB key sequence to
be sent to the server that is running the published application. ALT-SHIFTTAB is a standard Windows hotkey. See your Windows documentation for
more information about the ALT-SHIFT-TAB hotkey.
• CTRL-SHIFT-ESC. This hotkey causes the CTRL-SHIFT-ESC key
sequence to be sent to the server that is running the published application.
CTRL-SHIFT-ESC is a standard Windows NT hotkey. See your Windows
NT documentation for more information about the CTRL-SHIFT-ESC
hotkey.
• Toggle Latency Reduction. This hotkey turns SpeedScreen Latency
Reduction on or off. Turning on latency reduction reduces the time between
your keyboard or mouse input and a visible response on the screen.
Chapter 4 Configuring the ICA Win32 Clients
75
Configuring Event Logging
Use the Event Logging page to instruct the Citrix ICA Client whether or not to
keep a log of various events that occur while running published applications.
To configure event logging
1. Start Program Neighborhood.
2. From the Program Neighborhood menu bar, click ICA Settings to display the
ICA Settings dialog box.
3. Click the Event Logging tab.
From the Event Logging page, you can configure the following settings:
Event Log File. Enter the name of the file to log Citrix ICA Client events to in
the Name field.
• Select the Overwrite existing event log button to cause the event log file to
be overwritten with new events when a published application is run.
• Select the Append to existing event log button to keep old events and add
new ones to the end of the file.
Log Events. Select the event categories that you want to log. If no events are
selected, no logging takes place.
Five event categories can be selected for logging:
• Connections and Disconnections. Logs an event whenever the Citrix ICA
Client connects and disconnects from a Citrix server. This category is
selected by default.
• Errors. Logs an event whenever an error is encountered by the Citrix ICA
Client. This category is selected by default.
• Data Transmitted. Logs an event for each packet of information sent by the
Citrix ICA Client to the Citrix server. This is intended primarily for technical
support purposes.
• Data Received. Logs an event for each packet of information received by the
Citrix ICA Client from the Citrix server. This category is intended primarily
for technical support purposes.
• Keyboard and Mouse Data. Logs an event whenever you press a key on the
keyboard or move the mouse. This category is intended for technical support
purposes.
76
Citrix ICA Win32 Clients Administrator’s Guide
Using Applications Published on MetaFrame for UNIX
For connections to applications published on a MetaFrame for UNIX server, two
additional utilities provide functionality for configuring session display and cutting
and pasting objects between the ICA session and the client device. This section
describes how to use these utilities.
Using the Window Manager
If you are connecting to an application published on a MetaFrame for UNIX server,
use the Citrix window manager to minimize, resize, position, and close windows,
and access seamless “full screen” mode. This section describes how to use the
window manager.
About Seamless Windows
Seamless windows are ICA Client session windows containing published
applications that are configured to run in seamless mode. In seamless mode,
applications running on the MetaFrame server appear to the client as if they are
running locally, and each application appears in its own resizable window.
You can also display seamless windows in “full screen” mode, which places the
published application in a full-screen sized desktop. This mode lets you access the
ctxwm menu system.
Accessing Seamless “Full Screen” Mode
To switch between seamless and seamless “full screen” modes
Press SHIFT and F2.
Minimizing, Resizing, Positioning, and Closing Windows
When you connect to a published application on a MetaFrame server, buttons to
minimize, resize, position, and close windows are provided by the ctxwm window
manager.
Chapter 4 Configuring the ICA Win32 Clients
To minimize, resize, position and close window
Use the left mouse button to click on the following buttons:
To
Click
Note
Minimize published
application
windows on your
desktop
Seamless windows are minimized as buttons
on the desktop’s taskbar. Non-seamless and
seamless “full screen” windows are
minimized as icons on the desktop.
Open a minimized
window
Click its button on the taskbar or its icon on
the desktop
Adjust the size of
published
application
windows
Click and hold down the mouse button, then
move the pointer to the edge of the window
and drag it in the direction you want to scale
it. The window dimensions are displayed in
the top left-hand corner. Release the mouse
button to apply the resizing.
To resize the window proportionately, move
the mouse pointer to a corner of the window
and drag it.
Reposition
published
application
windows
Click and hold down the mouse button, drag
the window to the required position on the
desktop, and release the mouse button.
Close and exit a
published
application
When you close the last application in a
session, after 20 seconds the session
disconnects automatically.
Using the Citrix Window Manager Menus
In remote desktop and seamless “full screen” windows, you can use the ctxwm
menu system to log off, disconnect, and exit from published applications and
connection sessions.
To access the ctxwm menu system
1. On a blank area of the remote desktop window, click and hold down the left
mouse button. The ctxwm menu is displayed.
2. Drag the mouse pointer over Shutdown to display the shutdown options.
77
78
Citrix ICA Win32 Clients Administrator’s Guide
To choose an option from the ctxwm menu
Drag the pointer over the required option to highlight it. Release the mouse button
to select the option.
To
Choose
Terminate the connection and all
running applications
Logoff
Disconnect the session but leave the
application running
Disconnect
Disconnect the session and
terminate the application
Exit
Note Your Citrix server may be configured to terminate any applications that are
running if a session is disconnected.
Cutting and Pasting Graphics Using ctxgrab and
ctxcapture
If you are connected to an application published on a MetaFrame for UNIX server,
use ctxgrab or ctxcapture to cut and paste graphics between the ICA session and the
local desktop. These utilities are configured and deployed from the MetaFrame for
UNIX server.
Using ctxgrab
The ctxgrab utility is a simple tool you can use to cut and paste graphics from ICA
applications to applications running locally on the client device. This utility is
available from the command prompt or, if you are using a published application,
from the ctxwm window manager.
To access the ctxgrab utility from the window manager
1. In seamless mode, right click the ctxgrab button in the top, left-hand corner of
the screen to display a menu and choose the screengrab option.
In full screen mode, left click to display the ctxwm menu and choose the
screengrab option.
2. When ctxgrab is started, a dialog box is displayed.
Chapter 4 Configuring the ICA Win32 Clients
79
To copy from an application in an ICA Client window to a local application
1. From the ctxgrab dialog box, click From screen.
2. To:
Select a window: move the cursor over the window you want to copy and click
the middle mouse button.
Select a region: hold down the left mouse button and drag the cursor to select
the area you want to copy.
Cancel the selection: click the right mouse button. While dragging, cancel the
selection by clicking the right mouse button before releasing the first button.
3. Use the appropriate command in the local application to paste the object.
Using ctxcapture
The ctxcapture utility is a more fully-featured utility for cutting and pasting
graphics between ICA applications and applications running on the client device.
With ctxcapture you can:
•
Grab dialogs or screen areas and copy them between an application in an ICA
Client window and an application running on the local client device, including
non-ICCCM-compliant applications.
•
Copy graphics between the ICA Client and the X graphics manipulation utility
xvf.
If you are connected to a published desktop, ctxcapture is available from the
command prompt. If you are connected to a published application and the Citrix
server administrator has made it available, you can access ctxcapture through the
ctxwm window manager.
To access the ctxcapture utility from the window manager
1. Left click to display the ctxwm menu and choose the screengrab option.
2. When ctxcapture is started, a dialog box is displayed.
80
Citrix ICA Win32 Clients Administrator’s Guide
To copy from a local application to an application in an ICA Client window
1. From the ctxcapture dialog box, click From screen.
2. To:
Select a window: move the cursor over the window you want to copy and click
the middle mouse button.
Select a region: hold down the left mouse button and drag the cursor to select
the area you want to copy.
Cancel the selection: click the right mouse button. While dragging, cancel the
selection by clicking the right mouse button before releasing the first button.
3. From the ctxcapture dialog box, click To ICA. The xcapture button changes
color to indicate that it is processing the information.
4. When the transfer is complete, use the appropriate command in the application
in the ICA Window to paste the information.
To copy from an application in an ICA Client window to a local application
1. From the application in the ICA Client window, copy the graphic.
2. From the ctxcapture dialog box, click From ICA.
3. When the transfer is complete, use the appropriate command in the local
application to paste the information.
To copy from xv to an application in an ICA Client window or local
application
1. From xv, copy the graphic.
2. From the ctxcapture dialog box, click From xv and To ICA.
3. When the transfer is complete, use the appropriate command in the ICA Client
window to paste the information.
To copy from an application in an ICA Client window to xv
1. From the application in the ICA Client window, copy the graphic.
2. From the ctxcapture dialog box, click From ICA and To xv.
3. When the transfer is complete, use the paste command in xv.
Chapter 4 Configuring the ICA Win32 Clients
81
Using the ICA Win32 Clients with Application Launching and
Embedding
If you are not planning to use Citrix NFuse but still want to deliver applications to
your users by a Web-based method, you can use Application Launching and
Embedding (ALE) in conjunction with the Web-based ICA Client Installation
feature. Both versions of the ICA Win32 Client can be used with launched and
embedded applications.
The ICA Win32 Web Client replaces the ActiveX control and Netscape Plug-In
Clients, and is packaged in the file ica32t.exe. This file contains both the ActiveX
control and Netscape Plug-In.
The ica32t.exe file is a self-extracting executable, approximately 1.3MB in size.
This package is significantly smaller than the full ICA Win32 Program
Neighborhood Client. The smaller size allows quicker downloads and installation.
You can configure the ICA Win32 Client for silent user installation.
Application Launching and Embedding
Application Launching and Embedding (ALE) allows full-function Windows-based
applications to be launched from or embedded into HTML pages without rewriting
application code. Using ALE, administrators can provide access to existing
applications over Intranets or the Internet. The application looks and feels as if it
were running locally, even though it is actually executing on the Citrix server. There
are two ways to run an application from a Web page: launching and embedding.
•
Launching an application from a Web page involves clicking a hyperlink that
references an ICA file. Clicking the hyperlink causes the application to start and
appear in a separate window on the local desktop. You can then use this
application as if it were installed and running on your local computer.
•
Embedding an application places the window in which the program runs within
the Web browser window.
82
Citrix ICA Win32 Clients Administrator’s Guide
Launched Applications
The Citrix Management Console in MetaFrame XP and the Published Application
Manager in MetaFrame 1.8 both include wizards that allow you to create ICA files
and HTML pages. The HTML pages are saved on your Web server for users to visit
and launch ICA sessions. HTML pages that launch ICA sessions contain a
hyperlink to a valid ICA file that is located in a public HTML directory. When
clicked, the hyperlink downloads the ICA file to the client device. The client device
then passes the ICA file to the ICA Client software installed on the client device.
The ICA Client software uses the parameters in the ICA file to launch the
application on the user’s desktop. If the ICA Client software is not detected on the
client device, it is presented to the user to be downloaded and installed.
To set up a Web page so users can launch an application
1. Copy the ica32t.exe or ica32.exe file to your Web server. This file is located on
the Citrix ICA Client CD in the following directory: \Icaweb\en\Ica32.
2. Publish an application. See the Administrator’s Guide for the version of
MetaFrame you are using or the WINFRAME Systems Guide for more
information about publishing applications.
3. Use the Create HTML File wizard (using MetaFrame XP) or the Write HTML
File wizard (using MetaFrame 1.8) to create an HTML page on your server.You
can also create an ICA file. For more information on creating HTML files that
contain published applications, see your Citrix server documentation and the
online help for the Citrix Management Console (if you are using MetaFrame
XP) or the Published Application Manager (if you are using MetaFrame 1.8).
4. Open the HTML file in a text editor and edit the client type parameter to include
the full path to the ica32.exe or ica32t.exe file. This parameter calls the ICA
Win32 Client to run the published application.
Embedded Applications
The Citrix ICA Win32 Clients allow you to embed applications into Internet
Explorer and Netscape Navigator.
Rather than create separate Web pages for Microsoft Internet Explorer and
Netscape Navigator users, you can create a single Web page that contains two types
of HTML tags to embed applications for Internet Explorer and Netscape Navigator.
Chapter 4 Configuring the ICA Win32 Clients
83
Complete the following steps to use one of the ICA Win32 Clients to embed
applications into Internet Explorer or Netscape Navigator:
1. Create an ICA Client download Web site using the Web-based ICA Client
Installation feature. The elements required for the download Web site are
located on the NFuse CD and the ICA Client CD, or can be downloaded from
the Download area of the Citrix Web site at http://www.citrix.com/download.
Click the “Download Web-based ICA Clients Install Components” link.
For more information about constructing an ICA Client download Web site
using the NFuse CD and the ICA Client CD, see the “Deploying ICA Clients to
Your Users” chapter in the MetaFrame XP Administrator’s Guide.
For more information about constructing an ICA Client download Web site
using the packages downloaded from the Citrix Web site, see the corresponding
Readme.htm file located on the same Web page as the packages.
2. Create an HTML page with the appropriate wizard on your Citrix server.
3. Set the cabLoc parameter for Internet Explorer users.
4. Set the Pluginspage parameter for Netscape Navigator users.
Detailed instructions for Steps 2, 3, and 4 are below.
To create an HTML page using Citrix server software
1. If you are using MetaFrame XP, open the Create HTML File wizard on your
Citrix server. This wizard is accessed through the Citrix Management Console.
If you are using MetaFrame 1.8, open the Write HTML File wizard on your
Citrix server. This wizard is accessed through the Published Application
Manager.
2. Create the HTML file, saving it to your Web server. Follow the on-line help for
the appropriate wizard.
3. Open the HTML file in a text editor.
84
Citrix ICA Win32 Clients Administrator’s Guide
To set the cabLoc parameter for Internet Explorer users
1. In the HTML file you created with your Citrix server software, locate the line
that begins with the following text: var cabLoc =.
Replace the value after the equal sign (=) with the URL of the appropriate
Win32 Client:“http://Webserver/directory/ica32.exe or ica32t.exe”;
Make sure you include the quotation marks and semicolon.
2. Save the file and make sure it is stored on your Web server with the ICA file for
the embedded session. When users visit the HTML page, Internet Explorer
automatically downloads and installs the ActiveX control.
3. Keep the HTML file open.
To set the Pluginspage parameter for Netscape Navigator users
1. Locate the line that begins with the following text: var plugRefLoc =.
Replace the value after the equal sign (=) with the full path to the default Web
page of the ICA Client download Web site you created with the Web-based ICA
Client Installation feature: “http://Webserver/directory/ica32.exe or ica32t.exe”;
Example: var plugRefloc = “http://mywebserver/ica60/setup.htm”;
Make sure you include the quotation marks and semicolon.
2. Save the file and make sure it is stored on your Web server along with the ICA
file for the embedded session.
3. Publish a link to the HTML page. When users visit the HTML page, Netscape
Navigator refers users who do not have the Plug-In to the appropriate ICA
Client download page.
Index
85
Index
A
D
Adding application sets 64
Adding custom ICA connections 64
Application Launching and Embedding 81
application publishing
using the window manager 76
application set 63
authentication 19
Deploying the ICA Win32 Clients 25
creating an ICA Client download Web site 26
from a network share point 26
from the ICA Client CD 27
using installation diskettes 27
disable password saving 70
C
Citrix Documentation Library 10
Citrix Web site 10
Client Auto Update
overview 33
Client Update Configuration Utility 35
Client Update Database 35
adding clients 40
changing client properties 45
creating a new database 36
removing clients 44
specifying a default database 36
Configuring bitmap Caching for Application Sets 72
Configuring Connection Properties for Application Sets 65
Configuring Connections to Citrix Servers and Published
Applications 60
Configuring Default Options for Application Sets 66
Configuring Event Logging for Application Sets 75
Configuring General Settings for Application Sets 71
Configuring Hotkeys for Application Sets 73
Configuring the Citrix ICA Win32 Client 49
Connection Types 57
Conventions 8
Creating Client Installation Diskettes 27
ctxwm, window manager 76–77
custom ICA connection 64
E
event logging 75
F
Finding Further Information 9
firewalls 58
Frequently Asked Questions 10
full screen seamless mode 76
H
How to Use this Guide 7
I
ICA Clients
downloading 10
ICA Win32 Program Neighborhood Client
customizing 23
installing 28
starting 32
system requirements 21
updating 33
using with ALE 81
ICA Win32 Web Client
installing 32
preconfiguring 24
preconfiguring for silent user installation 24
system requirements 22
using with ALE 81
Installing the ICA Win32 Program Neighborhood Client
28
Installing the ICA Win32 Web Client 32
86
Citrix ICA Win32 Clients Administrator’s Guide
L
W
local text echo 68
login information 68
window manager, published applications 76
windows
remote desktop 76
seamless 76
M
Mapping Client Audio 55
Mapping Client COM Ports 54
Mapping Client Devices 49
Mapping Client Drives 51
Mapping Client Printers 52
MetaFrame for UNIX 76
mouse click feedback 68
P
pass-through authentication 72
password 68
Preconfiguring the ICA Win32 Clients 23
Preconfiguring the ICA Win32 Program Neighborhood
Client 23
Preconfiguring the ICA Win32 Web Client 24
Preventing password saving 69
publishing applications
using the window manager 76
R
remote desktop windows 76
S
Save password 69
seamless windows 76
SOCKS proxy connection,configuring 58
System requirements
ICA Win32 Program Neighborhood Client 21
ICA Win32 Web Client 22
T
TCP/IP server location 63
Turning Off Client Device Mappings 50
U
UNIX applications 76
Use local username and password 69
Using Application Sets 63
Using the ICA Win32 Clients with ALE 81
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement