Citrix states in their article: CTX268692

CTX268692 - How to Install the Citrix Java Client

This document was published at: http://support.citrix.com/kb/entry.jspa?externalID=CTX268692

Document ID: CTX268692, Created on: Jun 23, 2000, Updated: Apr 23, 2003

Products: Citrix WinFrame 1.8

1. Make sure the client system is properly configured and connected to the network.

2. Start a Web browser. In the browsers address field, type the IP address or DNS name of the Web server containing the ICA Java Client files, followed by the name of the ICA Java Client setup HTML file (download.htm). For example, if you copied the ICA Java Client installation files into a directory named /JICA on a Web server with IP address 126.4.2.7, type http://126.4.2.7/JICA/download.htm. The ICA Java Client setup HTML page appears.

3. If the IcaclntIcajava directory on your CD-ROM contains JavaEnt.zip, JavaEnt.sea.hqx, and JavaEnt.tar.gz, download.htm contains a link to each of these installation archives. Click the link corresponding to the desired client platform. Save the file to the client systems hard drive. You can create a directory named "Citrix" on the client computer and save the file to this directory. Use a decompression utility to extract the installation archive. Extracting the installation file yields the ICA Java Client archives. These archives contain the ICA Java Client class files.

If the IcaclntIcajava directory on your CD-ROM contains setup.class, click the link to setup.class in download.htm and save the file to the client systems hard drive. You can create a directory named "Citrix" on the client computer and save the file to this directory. Use the JVM installed on the client system or run setup.class. See "Running Setup.class" for more information about executing this Java setup program on various platforms.

4. After you uncompress the installation archive or run setup.class, installation is complete for Windows, UNIX, and OS/2 client systems.

Macintosh users may see an error message warning that some batch files were not created during installation. The batch file that cannot be created is a launching script used to automate starting the ICA Java Client in application mode. Macintosh users can create this batch file manually using the procedure in "Creating a Macintosh Launching Script." Application mode installations on JavaStation Servers and JavaOS for Business Servers require additional configuration, covered in "Configuring the JavaOS for Business Server 2.0," "Configuring the JavaOS for Business Server 2.1," and "Configuring the JavaStation Server."

NOTE: If the operating systems of the Web server or the client systems do not support long filenames, you must rename the compressed installation files and edit the links in the download.htm file.

Running Setup.class

The following procedures describe how to run setup.class on different platforms:

To run setup.class on a Windows PC

1. Start a command prompt.

For Windows 95, click Start and then click Run. In the Run dialog box, type command and press ENTER.
For Windows NT 4.0, click Start and then click Run. In the Run dialog box, type cmd and press ENTER.

2. Insert the CD-ROM in the CD-ROM drive. At acommand prompt, type cd x:, where x is the letter of your CD-ROM drive. Press ENTER.

3. Type cd icaclnticajava and press ENTER.

4. Type x jvmpgm setup, where x is the full path of your JVM program and jvmpgm is the JVM programs name. Press ENTER. For example, if you use the Microsoft JVM program Jview and it is located in a directory called C:Windows, type c:windowsjview setup. The ICA Java Client installation wizard appears.

To run setup.class on a UNIX system

1. Log on as root.

2. Start a shell.

3. Insert the CD-ROM in the CD-ROM drive and mount the CD.

4. Change to the /ICACLNT/ICAJAVA directory on the CD-ROM.

5. Type x jvmpgm setup, where x is the full path of your JVM program and jvmpgm is the JVM programs name. Press ENTER. For example, if you use Suns JVM program Java and it is located in a directory called /usr/bin, type /usr/bin/java setup. The ICA Java Client installation wizard appears.

To run setup.class on an OS/2 system

1. Start an OS/2 command prompt. From the Start menu, point to OS/2 System and then point to Command Prompts. Click OS/2 Window.

2. Insert the CD-ROM in the CD-ROM drive. At the command prompt, type cd x:, where x is the letter of your CD-ROM drive. Press ENTER.

3. Type cd icaclnticajava and press ENTER.

4. Type x jvmpgm setup, where x is the location of your JVM program and jvmpgm is the JVM programs name. Press ENTER. For example, if you use IBMs JVM program Java and it is located in a directory called C:Java11, type c:java11java setup. The ICA Java Client installation wizard appears.

To run setup.class on the JavaOS for Business Server

1. Copy the ICA Java Client installation file setup.class from the installation media to some directory on your JavaOS for Business Server.

2. Start a command prompt. On the JavaOS for Business Server, click Start, Programs, and then click Command Prompt.

3. Change to the directory where you saved setup.class. At the command prompt, type cd x:, where x is the drive and path to setup.class.

4. Type x jvmpgm setup, where x is the full path of your JVM program and jvmpgm is the JVM programs name. Press ENTER. For example, if you use IBMs JVM program Java and it is located in a directory called C:Java11, type c:java11java setup. The ICA Java Client installation wizard appears.

To run setup.class on a JavaStation Server

1. Log in as root.

2. Start a shell.

3. Insert the CD-ROM in the CD-ROM drive and mount the CD.

4. Change to the /ICACLNT/ICAJAVA directory on the CD-ROM.

5. Type x jvmpgm setup, where x is the full path of your JVM program and jvmpgm is the JVM programs name. Press ENTER. For example, if you use Suns JVM program Java and it is located in a directory called /usr/bin, type /usr/bin/java setup. The ICA Java Client installation wizard appears.

To run setup.class on a Macintosh system

1. Insert the CD-ROM in the CD-ROM drive. Double-click the CD-ROM icon on your desktop.

2. Double-click the ICACLNT folder and then double-click the ICAJAVA folder.

3. Drag setup.class onto the JVM application on your desktop. For example, if you use the Macintosh JVM JBindery 2.0, drag setup.class onto JBindery 2.0 on the desktop.

4. Execute setup.class. For example, in JBindery 2.0, click Run.

The ICA Java Client installation wizard appears. When using this wizard, make sure you change the destination folder to some location on the client systems hard drive; for example, /HardຈDisk/Citrix/JavaClient.

Creating a Macintosh Launching Script

1. Open the folder
where you installed the Citrix ICA Java Client.

2. Open the JVM program, JBindery 2.0.

3. From the list of icons on the left of the JBindery dialog, click Command.

4. In the Class Name field, type com.citrix.JICA.

5. In the Optional Parameters field, add the following parameter:

-address:CitrixServer

where CitrixServer is the name of a Citrix server to which you want to connect.

6. From the list of icons on the left, click Classpath.

7. Drag JICAEngJ.jar from the Citrix ICA Java Client installation folder onto the Additions to class path field. The file name appears in the field. Click Save Settings. You can create a folder on your desktop called Citrix Files and save the icon there. Type a name for the launching file in the Save Settings field. Make sure Save as Application is checked. Click Save.

8. Click Quit. To run the ICA Java Client, double-click the icon you created.

NOTE: If you want to use the GUI Command Line feature, create a script following the procedure above but instead of adding the -address:CitrixServer parameter and value, add the parameter -guicmdline in the Optional Parameters field. When you run this script, a dialog box appears where you can type parameters to pass to the ICA Java Client. Type the address parameter and any other optional parameters in the dialog box and click Run. By doing this you avoid having to edit the launching file whenever you want to specify different command line parameters.