Netra j 3.0 Administrator's Guide

Citrix Software

Citrix software provides for the NC a thin-client that can access virtually any Windows application across any type of network connection. Citrix produces a client/server product for Windows NT 3.5.1 called WinFrame. Citrix also produces a client product for Windows NT 4.0 called MetaFrame. MetaFrame works with Microsoft Windows NT Server, Terminal Server Edition (the server portion for Windows NT 4.0).

For additional information, and to download the Citrix software refer to: http://www.sun.com/desktop/products/PCCP/remotewindowing/citrix.

After downloading the client software from the web and uncompressing it read the README file for detailed installation instructions.

After configuring the Windows NT server with the appropriate server software, use the Netra j Network Computer Application Management module to specify the host name or IP address of the NT server for the Netra server (see "To Reference Remote Windowing Servers"). In the rest of this section, NT Server refers to the NT server that has been configured with the appropriate server software for use with NCs.

Running the Citrix ICA Client, Java version as an Applet

The Citrix ICA Client, Java version, running as an applet requires that the applet be inside an HTML file. The HTML file is the default HTML file for the web server running (at port 80) on the WinFrame server, or the Microsoft Windows NT Server Terminal server. See the README for any modifications that need to be made to the server. Use the HotJava Views Administration module to add this Citrix Client applet as a HotJava Views application (see "Adding an Application Icon to the HotJava Views Selector").

Create an HTML page or modify the example (see "Example") to suit your environment. The example assumes that the .class files are located in the same directory as the .html file, but you can store them elsewhere by using the CODEBASE applet tag. The applet class is named JICA.class.

The following parameters can be specified in the HTML file. The Address parameter is the only required parameter.

1. Address - This is the address of the NT server, or the name of the published application if the TCPBrowserAddress parameter is present. This parameter is required.

2. TCPBrowserAddress - This is the address of the NT server, used when specifying the name of a published application instead of the name of a NT server.

3. Start - Values for Start are manual or auto. This is used to specify whether the Citrix ICA Client, Java version starts immediately (auto) or after user interaction (manual). The default value is manual.

4. Username - This is the user name to use during login.

5. Domain - This is the name of the domain for the user name.

6. Password - This is the password of the user.

7. InitialProgram - This is the name of the initial program to run after connecting to the WinFrame server.

8. WorkDirectory - This is the path of the working directory for the initial program to run after connecting to the WinFrame server.

9. EndSessionTimeout - When users leave a page containing an open ICA session for more than 300 seconds (5 minutes), the session is disconnected. Use this parameter to specify a different value in seconds.

10. Border - This parameter turns the border on or off. Values for this parameter are on or off (the default).

11. BorderWidth - This parameter enables the user to specify a border width in pixels. The default value is 6.

12. ICAPortNumber - The default ICA port number is 1494. A different port number can be specified using this parameter or by appending the port number to the address value. For example, WFServer:1495.

13. LargeCacheSize - This parameter can be used to modify the size of the client system's cache in bytes. Ordinarily, the size of the cache is determined automatically based on the dimensions of the connection.

Example

This example shows the applet part of the HTML file:

<applet archive=
JICA.zip code=JICA.class width=640 height=480>
        <param name="Address"            value="llama2">
        <!param name="Start"             value="manual">        <!default>
        <!param name="Start"             value="auto">
        <param name="Border"             value="on">
        <!param name="Border"            value="off">           <!default>
        <!param name="BorderWidth"       value="6"> <!default when border on>
        <!param name="Username"          value="jack">
        <!param name="Domain"            value="llama2">
        <!param name="Password"          value="">
        <!param name="InitialProgram"    value="notepad.exe">
        <!param name="WorkDirectory"     value="c:users\jack">
        <!param name="TCPBrowserAddress" value="llama2">
        <!param name="ICAPortNumber"     value="1494">          <!default>
        <!param name="LargeCache"        value="5000000">
    </applet>

Running the Citrix ICA Client, Java version as an Application

You can run the Citrix ICA Client, Java version, as an application if you have the .class files stored locally on your client system (Netra j server). The .class file to run is the same as the applet class, JICA.class.

The same parameters apply to the client in application mode as to the client in applet mode, with the exception of the Start, Border, BorderWidth, and EndSessionTimeout. These parameters have no meaning when running the client as an application.

Use "Client Application Administration" to add the Citrix ICA Client as an application for an NC (see the README for the values of the options). After you have added the application, it is displayed as one of the choices for default application when adding NCs.