iHEAT Client Readme
Version 8.03 

Contents
1.   System Requirements
2.   Running the Windows Client 
3.   Running the Netscape Plug-in
4.   Running the ActiveX Control 
5.   Running the Java Client
6.   Running the Linux Client
7.   Running the Macintosh Client
8.   General Notes
 

1. SYSTEM REQUIREMENTS

The Windows Client supports Windows 98/XP, Windows 2000, Windows Server 2003, and Windows NT 4.0.

The Linux Client supports Red Hat Linux 9.0

The Macintosh Client supports Mac OS X version 10.3 "Panther."

The Netscape Plug-in for Windows support Windows 98/XP, Windows 2000, Windows Server 2003, and Windows NT 4.0 with Netscape Navigator 7.1. 

The Netscape Plug-in for Linux supports Red Hat Linux 9.0 with Netscape Navigator 7.1.

The Microsoft ActiveX Control supports Windows 98/XP, Windows 2000, and Windows Server 2003 with Internet Explorer 6.0.

The Java Client supports the following platforms: 
    Windows 98/XP, Windows 2000, Windows Server 2003, Windows NT 4.0 with Internet Explorer 6.0 and Netscape Navigator 7.1
    Red Hat Linux 9.0 with Netscape Navigator 7.1
    OS/2 with Netscape Navigator 4.61
    Macintosh 8.6 and 9 with Internet Explorer 5.1

Clients must have TCP/IP as a network protocol. 

Back to top


2. RUNNING THE WINDOWS CLIENT

2.1 Installing the Window Client
1.   Start Netscape Navigator or Internet Explorer. 
2.   In the Location box, type http:// followed by the server name and iHEAT logon page. For example, http://server/logon.html.
3.   Select the Native Windows Client link from the list of iHEAT clients. 
4.   Follow the on-screen instructions which will prompt you to download the Windows client executable. 

With the Windows Client, you can log on to a iHEAT Server from the Start menu or from a Windows shortcut. 

2.2   Running the Windows Client from the Start Menu
1.  Click the Start button on the Windows taskbar. 

2.  Click Programs | iHEAT Windows Client | iHEAT Client.

3.  Type your server address in the Connection dialog and click Connect. You can create a shortcut to the specified server by selecting the check box on the Connection dialog. Once the shortcut is set up, you will bypass the Connection dialog when connecting to the specified server. 

4.  When the Logon dialog appears, type the following information: 

     • Your network user name in the User name box. 

     • Your network password in the Password box. 

2.3   Running the Windows Client from a Shortcut 
A shortcut named iHEAT Client is created during installation of the Windows Client. This shortcut launches the Program Window. 

1.  Double-click the iHEAT Client icon. 

2.  Enter your server address in the Connection dialog and click Connect. If you would like to create a shortcut to the specified server, select the check box. Once the shortcut is set up, you will bypass the Connection dialog when connecting to the specified server. 

3.  When the Logon dialog appears, type the following information: 

     • Your network user name in the User name box. 

     • Your network password in the Password box. 

2.4    Creating iHEAT Shortcuts
Additional shortcuts can be created for launching specific applications, among other options. 
1.  Right-click on the desktop. 
2.  Click New | Shortcut. 
3.  In the Create Shortcut dialog box, browse to the iHEAT Client Executable, e.g., \Program Files\iHEAT Client\iHEATClient.exe. 
4.  Type a name for the shortcut and click Finish.

2.5    Using Command-line Arguments
For users running the Windows Client, command-line arguments can be used to make the logon process easier. Command-line arguments allow users to directly launch an application, among other options, as described below. 

1.  Right-click on the iHEAT shortcut and click Properties
2.  In the Shortcut tab, place your cursor in the Target edit box and append any of the following command-line arguments after the quote ("): 
 
-h  The iHEAT Server address or host name. 
-u  The client's network user name. 
-p  The client's network password. 
-a  The display name of the application to be launched. The application's display name must be identical to the application name in the Program Window. 
-r Startup parameters for the application. 
-c Compression is enabled by default. To disable compression, remove -c from the command-line. 
-ac Determines how printers are initialized at startup. When -ac is followed by all, all client printers are automatically configured. When -ac is followed by none, client printers are not automatically configured. When -ac is followed by default only the default printer is configured automatically. This is the default setting.

Example: ...\iHEATClient.exe" -h server -u username -p password -c  -ac all

Startup parameters passed on by the -r argument are specific to each application. Please refer to the application's documentation for information about launch parameters.

Command-line arguments are optional and case-insensitive. Arguments can be appended in any order, with the exception of -r. If -r is used, it must be the last argument on the command-line and it must be used with the -a argument.

In order to accommodate spaces in user names, passwords, or application display names, quotation marks must be included when using command-line arguments. For example, user name Jim C would be specified as -u "Jim C".

Back to top


3.  RUNNING THE NETSCAPE PLUG-IN 

3.1  Running the Netscape Plug-in for Windows
The Netscape Plug-in for Windows is available to Windows users running Netscape Navigator.

To run the Netscape Plug-in for Windows
1.   Start Netscape Navigator.
2.   In the Location box, type http:// followed by the server name and iHEAT logon page. For example, http://server/logon.html.
3.   Select the Netscape Plug-in link from the list of Windows clients. If you have the choice of running the Plug-in in loose or embedded windows mode, select embedded windows if you would like to run the Program Window inside the browser. Select loose windows if you would like to run the Program Window outside the browser. 
4.   When the Logon dialog appears, type the following information: 
     Your network user name in the User name box. 
     Your network password in the Password box. 

3.2  Running the Netscape Plug-in for Linux
The Netscape Plug-in for Linux is available for users of Red Hat Linux running Netscape Navigator.

To run the Netscape Plug-in for Linux
1.     Start Netscape Navigator. 
2.     In the Location box, type http:// followed by the server name and the iHEAT logon file. For example, http://server/logon.html.
3.     Select the appropriate Netscape Plug-in link from the list of Linux clients. This Web page will either prompt you to download the Netscape Plug-in or will launch the Logon dialog automatically.
4.    If you need to install the Plug-in, login as root with the following command: su
5.    Install the Plug-in from your home directory with the following command:
tar zxf iHEAT-plugin.tgz
6     Copy the Plug-in to the Netscape Plug-in directory with the following command:
cp ~/.netscape/plugins/libnpg.so ~/.netscape/plugins/libpbr.so /usr/local/netscape/plugins
7     Exit from root with the following command: exit
8     Restart your browser.
9     Return to the install page. 
10.  When the Logon dialog appears, type the following information: 
      Your network user name in the User name box. 
      Your network password in the Password box. 

Back to top


4.  RUNNING THE MICROSOFT ACTIVEX CONTROL 

The Active X Control is available to Windows users running Internet Explorer.

To run the ActiveX Control

1.   Start Internet Explorer. 

2.   In the Address box, type http:// followed by the server name and iHEAT logon page. For example, http://server/logon.html.

3.   Select Microsoft ActiveX Control from the list of Windows clients. If you have the choice of running the Plug-in in either loose or embedded window mode, select embedded windows if you would like to run the Program Window inside the browser. Select loose windows if you would like to run the Program Window outside the browser.

4.   Trust the digitally signed ActiveX control.  

5.   When the Logon dialog appears, type the following information: 

     • Your network user name in the User name box. 

     • Your network password in the Password box. 

Back to top


5.  RUNNING THE JAVA CLIENT 

The Java Client is available to Windows, Linux, Macintosh, and OS/2 users. Launch iHEAT by browsing to an HTML page containing the iHEAT logon applet.

To run the Java Client

1.  Start Netscape Navigator or Internet Explorer. 

2.  In the Location box, type http:// followed by the server name and the logon file containing the Java applet. For example, http://server/logon.html.

3.  Select either the signed or unsigned Java Client from the list of iHEAT clients. 

4.  When the Logon dialog appears, type the following information: 

     • Your network user name in the User name box. 

     • Your network password in the Passw
ord box. 

If you wish to take advantage of the client integration features of iHEAT, and you are not concerned with the Java applet having access to your file system and clipboard, select the signed Java Client. Otherwise, select the unsigned Java Client. This will prevent the applet from accessing your machine's file system, making the clipboard, client printing, and client file access features unavailable.

Back to top


6. RUNNING THE LINUX CLIENT

The Linux Client is a lightweight native X Window System application that delivers excellent performance to Linux desktops. 

6.1  To install the Linux Client
1.   Launch your Web browser.
2.   In the Location box, type http:// followed by the server name and iHEAT logon file. For example, http://server/logon.html

3.   Click the Native Linux Client link from the list of Linux clients.

4.   Save the iHEAT package.

5.   Launch the Linux Console and become root (Super User). 

6.   Install the package using: rpm –Uvh. (For example, rpm –Uvh iHEAT.rpm

6.2   To run the Linux Client
1.   Type iHEAT

2.   Type your server address in the Connection dialog.

3.   When the Logon dialog appears, type the following information: 

     • Your network user name in the User name box. 

     • Your network password in the Password box. 

6.3   Command-Line Arguments
The Linux Client supports the following command-line arguments:
 
-h The iHEAT Server address or host name. 
-u The client's network user name.
-p  The client's network password.
-a  The display name of the application to be launched. (The application's display name must be identical to the application name in the Program Window.) 
-r Startup parameters for the application. 
-c Enables compression. 
-f By default, the Linux Client runs in loose window mode. The command-line argument -f will run the Linux Client in a restricted frame mode
-ac Determines how printers are initialized at startup. When -ac is followed by all, all client printers are automatically configured. When -ac is followed by none, client printers are not automatically configured. When -ac is followed by default only the default printer is configured automatically. This is the default setting.

Example: iHEAT -h server1 -p password -ac all

Startup parameters passed on by the -r argument are specific to each application. Please refer to the application's documentation for information about launch parameters.

Command-line arguments are optional and case-insensitive. Arguments can be appended in any order, with the exception of -r. If -r is used, it must be the last argument on the command-line, and it must be used with the -a argument. 

In order to accommodate spaces in user names, passwords, application display names, or application arguments, quotation marks must be included when using command-line arguments. For example, the argument -a "Corel Ventura" would launch Corel's Ventura application. Likewise, user name Jim C would be specified as -u "Jim C" 

The Linux Client can be uninstalled by typing rpm -e iHEAT

Back to top


7. RUNNING THE MACINTOSH CLIENT
The Macintosh Client is a lightweight X based application that provides seamless integration with the native Macintosh environment. The Macintosh Client requires Apple's X11 library implementation. X11 can be downloaded from Apple's web site at http://www.apple.com. It can also be installed during a custom installation of Mac X 10.3.

7.1  To install the Macintosh Client 
1.   Launch your Web browser.

2.   In the location box, type http:// followed by the server name and the iHEAT logon file. For example, http://server/logon.html
3.   Click the Native Macintosh Client link from the list of clients.
4.   Unzip iHEAT.tgz.

5.   Open Terminal

6.   Type su.

7.   Press Return and enter your root password if prompted. 
8.   Change to the directory with the unzipped iHEAT files. 
9.   Type chmod a+x InstallMacX.sh

10. Press Return

11. Type ./InstallMacX.sh

12. Press Return

7.2   To run the Macintosh Client 
1.   Launch X11. 

2.   Type iHEAT.

3.   Press Return

4.   Type the server address in the Connection dialog. 

3.   When the Logon dialog appears, type the following information: 

     • Your network user name in the User name box. 

     • Your network password in the Password box. 

7.3   Command-Line Arguments
The Macintosh Client supports the following command-line arguments:
 
-h The IP address of the iHEAT Server. 
-u The client's network user name.
-p  The client's network password.
-a  The display name of the application to be launched. (The application's display name must be identical to the application name in the Program Window.) 
-r Startup parameters for the application. 
-c Enables compression. 
-f By default, the Macintosh Client runs in loose window mode. The command-line argument -f will run the Macintosh Client in a restricted frame mode
-ac Determines how printers are initialized at startup. When -ac is followed by all, all client printers are automatically configured. When -ac is followed by none, client printers are not automatically configured. When -ac is followed by default only the default printer is configured automatically. This is the default setting.

Example: iHEAT -h 196.125.101.222 -p password -ac all
 
7.4   To uninstall the Macintosh Client

1.   Open Terminal.
2.   Type su.
3.   Press Return and enter your root password if prompted.
4.   Change to the directory with the unzipped iHEAT files.
5.   Type chmod a+x InstallMacX.sh.
6.   Press Return.
7.   Type ./InstallMacX.sh -uninstall.
8.   Press Return.
 


8. GENERAL NOTES

8.1   User name and Password
In the Logon dialog, type your network user name and password, or a user name and password that has been set up for you on the iHEAT Server. See your system administrator for more information. 

8.2   Server Address 
In the Connection dialog, type the host name of the iHEAT Server. If your client doesn't recognize Windows host names, you can type the IP Address of the iHEAT Server instead. 

8.3   User Authentication 
The iHEAT Server first tries to authenticate users on the local machine, followed by the local machine's domain, and lastly on trusted domains. You can override this default behavior and specify a specific domain by typing the domain name followed by a backslash and your network user name in the User name box of the Logon dialog. For example, NORTH\johnw.

8.4   Client File Access 
iHEAT allows users to access files stored on the client computer and to save files locally. Client drives are designated with a Client prefix. For example, Client A (J:), Client C (K:). To open or save a file locally, select the desired local drive from the drop-down menu of the Open or Save As dialog box. See your system administrator for more information.

8.5   Client Clipboard
iHEAT allows client and server-based applications to exchange information using the clipboard. You can cut and copy information from applications running on your client machine and paste it into applications running on a iHEAT Server, and vice versa. See your system administrator for more information.

8.6   Client Printing
iHEAT provides transparent access to client-side printers for users running the Windows Client, the Linux Client, the Netscape Plug-in, the Microsoft ActiveX Control, and the signed version of the Java Client. Depending on the server configuration, iHEAT will automatically detect your printer information once you have logged on to iHEAT. If the iHEAT Server is not set to automatically configure client printers or is unable to locate your printer driver, you can manually configure a printer driver using the Program Window's Client Printer Wizard. Access the Client Printer Wizard by clicking File | Printers | Configure Client Printer.

8.7 Session Reconnect
Session reconnect allows sessions to be maintained on a iHEAT Server without a client connection. If your connection to the server is lost, intentionally or unintentionally, your session and applications remain running on the iHEAT Server for the length of the time specified by the administrator. Through the Program Window, you can disconnect rather than exit from iHEAT, and you will be able to return to your session in the exact state you left it. To disconnect a session, click File | Disconnect. If the administrator has not enabled the session reconnect feature, the Disconnect option will not appear in the Program Window's File menu.


Back to top


©FrontRange Solutions Inc, USA 2004.- All Rights Reserved.