Installing the Citrix ICA Java Client

Downloading Setup.class

Download Setup.class and save it to your system's hard drive. See Running Setup.class below for information about executing Setup.class with a Java virtual machine.

Note: Some browsers may try to execute the class file instead of displaying a Save as dialog box. In this case, click the right mouse button on the link to Setup.class and select the Save as option.

Note : You must do additional configuration after running Setup.class for Macintosh. See the Citrix ICA Java Client Administrator's Guide for more information.

Important: Because the ICA Java Client is a Java application, you must use a Java virtual machine to execute it. Java virtual machines are available from various Web sites including Apple, IBM, Sun Microsystems, and Microsoft. Java virtual machines often can be found in the Java development kits available in the "Developer" areas of these sites.

Windows 95 and Windows NT 4.0 users who have installed Internet Explorer 4.0 or greater have a Java virtual machine (Jview) already available for use.

Running Setup.class

Once you have downloaded Setup.class to the client system use one of the following procedures to run it:

To run Setup.class on a Windows PC

  1. Start a command prompt. On Windows 95 or Windows 98, click Start and then click Run. In the Run dialog box, type command and press ENTER. On Windows NT 4.0, click Start and then click Run. In the Run dialog box, type cmd and press ENTER.
  2. If you downloaded the ICA Java Client, change to the directory where you saved the Setup.class file. For example, if you saved Setup.class in \Downloads, type cd \downloads.
  3. Type x\jvmpgm setup, where x is the full path of your Java virtual machine program and jvmpgm is the Java virtual machine program’s name. Press ENTER. For example, if you use the Microsoft Java virtual machine program Jview and it is located in a directory called C:\Windows\, type c:\windows\jview setup.

    Notes: To find your Java virtual machine, click Start on the Windows Taskbar. Select Find and then click Files or Folders. The Find dialog box appears. In the Named field, type jview.exe. Click Find Now. Note the location of Jview.exe.

    To force installation messages to display in a language other than that used by the system's default local, you must specify the system property user.language with the desired local. For example, to display French installation messages, type c:\windows\jview /d:user.language=fr setup.

  4. The ICA Java Client installation wizard appears. Follow the instructions on your screen. Application mode installations are complete once you have finished using the installation wizard. See the Citrix ICA Java Client Administrator's Guide for more details. Applet mode installations require additional configuration that is also covered in the Citrix ICA Java Client Administrator's Guide.

Note: If you install the ICA Java Client on a system running Microsoft Windows NT and do not have administrator privileges, the install process will complete but an error message will appear. You can ignore this error message; the ICA Java Client has been correctly installed. However, uninstall information has not been added to Add/Remove Programs in Control Panel. To uninstall the ICA Java Client, see the Citrix ICA Java Client Administrator's Guide.

To run Setup.class on a UNIX system

  1. Log in as root.
  2. Start a shell.
  3. If you downloaded the ICA Java Client, change to the directory where you saved the Setup.class file. For example, if you saved Setup.class in /downloads, type cd /downloads.
  4. Type x/jvmpgm setup, where x is the full path of your Java virtual machine program and jvmpgm is the Java virtual machine program's name. Press ENTER. For example, if you use Sun's Java virtual machine program Java and it is located in a directory called /usr/bin, type /usr/bin/java setup.

    Note: To force installation messages to display in a language other than that used by the system's default local, you must specify the system property user.language with the desired local. For example, to display French installation messages, type /usr/bin/java -Duser.language=fr setup.
  5. The ICA Java Client installation wizard appears. Follow the instructions on your screen. Application mode installations are complete once you have finished using the installation wizard. See the Citrix ICA Java Client Administrator's Guide for further details. Applet mode installations require additional configuration that is also covered in the Citrix ICA Java Client Administrator's Guide.

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. If you downloaded the ICA Java Client, change to the directory where you saved the Setup.class file. For example, if you saved Setup.class in \downloads, type cd \downloads.
  3. Type x\jvmpgm setup, where x is the location of your Java virtual machine program and jvmpgm is the Java virtual machine program's name. Press ENTER. For example, if you use IBM's Java Virtual machine program Java and it is located in a directory called C:\Java11, type c:\java11\java setup.

    Note: To force installation messages to display in a language other than that used by the system's default local, you must specify the system property user.language with the desired local. For example, to display French installation messages, type c:\java11\java /d:user.language=fr setup.

  4. The ICA Java Client installation wizard appears. Follow the instructions on your screen. Application mode installations are complete once you have finished using the installation wizard. See the Citrix ICA Java Client Administrator's Guide for further details. Applet mode installations require additional configuration that is also covered in the Client Administrator's Guide.

To run Setup.class on a Macintosh system

  1. Download (or copy from the CD-ROM) Setup.class to your Macintosh hard drive.
  2. Drag Setup.class onto the JVM application on your desktop. For example, if you use the Macintosh Java virtual machine JBindery 2.0, drag Setup.class onto JBindery 2.0 on the desktop.

    Note: To force installation messages to display in a language other than that used by the system's default local, you must specify the system property user.language with the desired local. For example, to display French installation messages, click Properties in JBindery 2.0. In the text box to the left of the equal sign type user.language. In the text box to the right of the equal sign, enter fr.

  3. Execute Setup.class. For example, in JBindery 2.0, click Run.
  4. The ICA Java Client installation wizard appears. Follow the instructions on your screen. In the installation wizard's Choose Destination Location screen, you must change the destination folder to some location on the Macintosh system’s hard drive; for example, /Hard%20Disk/Citrix/JavaClient.
  5. You 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 documented in the Citrix ICA Java Client Administrator's Guide.
  6. Applet mode installations require additional configuration that is also covered in the Citrix ICA Java Client Administrator's Guide.