Installation under Windows is performed by an installation program. This program installs the Habanero class files, installs a Java VM (if necessary), creates the shell scripts, sets the registry so Habanero is recognized as a helper application for .def(session definitions) and .hab(replay data) files and it creates shortcuts in the Start menu. If the installation program fails to perform these tasks, you may not have write permission on the system and you will need to have the system administrator perform the installation.

1.   Install or locate the Java VM

Windows has an installation program that comes in two flavors: one version which includes the Java VM and one without Java. If you don't have the Sun^® Java VM installed we recommend you download the version of Habanero that includes the VM. If you already have the Sun JDK installed download the version of Habanero without Java. The installation program will prompt you for the location of the JDK.

2.   Install the Habanero class files

Install NCSA Habanero for Windows by:

• downloading the Habanero installation program
• running the program
• and follow the instructions from the program.

NOTE:   The following sections describe manual installation procedures which are normally performed by the installation program. This information is only relevant if the installation program fails or you have moved the Habanero class files.

2.   Create a batch file
The installation program creates the batch files for your system. If your installation was successful you will not have to create batch files for Habanero. If the installation program failed to create your batch files or you have moved the Habanero class files you will need to create or modify the Client, habanero.bat, and Server, habanerServer.bat, files to reflect the following information.

Habanero uses a shell script to define its resources and launch the Java VM with the correct class file. There are three environment variables that must be set before the VM is called with the application's class file. These include: the PATH, CLASSPATH and LD_LIBRARY_PATH.

• The PATH defines the location of the Java VM
• The CLASSPATH defines the location of the class files for the VM and application.
• The LD_LIBRARY_PATH defines the location of any native libraries.

A sample batch file for the Habanero Client (habanero.bat)

	@ECHO OFF
	SET PATH=d:\java;d:\java\bin;C:\Program Files\NCSA\Habanero\rsc\lib\w95;
	SET LD_LIBRARY_PATH=d:\java\lib
	SET HOME=C:\Program Files\NCSA\Habanero
	SET CLASSPATH=.;d:\java\lib\classes.zip
	SET CLASSPATH=%CLASSPATH%;C:\Program Files\NCSA\Habanero
	SET CLASSPATH=%CLASSPATH%;C:\Program Files\NCSA\Habanero\apps
	ECHO Starting the Habanero Client.
	ECHO Press Ctrl-C in this window to terminate the Client.
	java Habanero

A Batch File Example for the Habanero Server

	@ECHO OFF
	SET PATH=d:\java;d:\java\bin;C:\Program Files\NCSA\Habanero\rsc\lib\w95
	SET LD_LIBRARY_PATH=d:\java\lib
	SET HOME=C:\Program Files\NCSA\Habanero
	SET CLASSPATH=.;d:\java\lib\classes.zip
	SET CLASSPATH=%CLASSPATH%;C:\Program Files\NCSA\Habanero
	SET CLASSPATH=%CLASSPATH%;C:\Program Files\NCSA\Habanero\apps
	ECHO Starting the Habanero Server.
	ECHO Press Ctrl-C in this window to terminate the Server.
	java HabaneroServer

4.   Configure the Habanero resource (habanero.rsc) files

The installation program normally sets these environment variables. However, if you need to change them use a text editor locate, open and edit the user.props file located in the habanero.rsc directory. The parameters   habanero.home   and   dir.record   should reflect the directory path to the Habanero files and the path to the location where you want to write recorded data.

For example:

   habanero.home=c:\\program files\\ncsa\\habanero2.0
   
   dir.record=c:\\program files\\ncsa\\habanero2.0\\capture

5.   Configure ID data in Habanero Client

The User ID area of NCSA Habanero, allows users to customize their 'identification' or what other session participants can see about them, whenever they are in a session. To find out more about how to customize the 'identification' of a user, check out the section in the Habanero Environment Properties regarding the myself file.

[ Download ] [ User Docs ] [ FAQs ] [ Home ] [ Dev API ] [ Tools ] [ License ]

Habanero^® is a registered trademark owned by The Board of Trustees of the University of Illinois. Copyright 1996-1998. All rights reserved.   Java^(TM) is a proprietary trademark owned by Sun Microsystems, Inc.

 

Contact CONTACT_EMAIL@ncsa.uiuc.edu with questions or comments regarding this page. Last updated January, 1999 -- For more information on NSF's PACI program see http://www.cise.nsf.gov/acir/ and http://www.npaci.edu/online/ All rights reserved. Do not copy or redistribute in any form. NCSA Access ©1998 Board of Trustees of the University of Illinois.