Starting the Client or Server

The Habanero Client and Server are invoked differently on UNIX, Windows and Macintosh. The Client and Server also accept command line parameters or switch statements that increase their configuration ability. Check out the following links for more information:

UNIX

The Habanero Client and Server are invoked from the command line and are dependant on environment variables. These variables define the PATH to the Java interpreter, the CLASSPATH to the .class files, and the LD_LIBRARY_PATH defines the location of any system specific libraries. If these variables are set in your config file, (e.g. .cshrc under C-shell), then you can simply invoke the application from the command line.   e.g.     java Habanero

Another way of starting the Habanero Client or Server is to create a simple script. E.g.

#!/bin/ksh
PATH=$PATH:/java/bin
CLASSPATH=.:/java/lib/classes.zip:/java/habanero/:/java/habanero/demos:/java/habanero/tools
LD_LIBRARY_PATH=/java/habanero/rsc/lib/Solaris:$LD_LIBRARY_PATH
java Habanero  
#(or java HabaneroServer)

 

Windows

The installation program takes care of the details of creating batch files for the Client and Server. It also creates icons for the Client and Server in the NCSA Habanero folder on the Start Menu. Simply click on either one to invoke the application.

 

Macintosh

Under Macintosh there are icons for the Client and Server in the Habanero folder. Simply click on either icon to start the application.

Creating and Joining a Session

a)	Creating a Session requires both the Server and Client. The Server must be running before you create it with the Client. Start a Habanero Server as described in section 1. By default the Server uses port 2000 to communicate data. If you want to change the port number use the -listen option and see the Server command line parameters file for an example. NOTE: The server runs in the background and does not have a graphical user interface.
b)	Next click the Habanero Client icon. By default the Client uses port 3000 to communicate data. If you want to change the port number use the -listen option and see the Client command line parameters file for an example.
c)	In the Habanero Environment Window enter the session's name, server address and port number in the corresponding fields. - Enter a Session Name. This name is distinct and is used by the server to identify a session. NOTE: The server is capable of serving more than one session at a time and it uses the name to distinguish between the different sessions. - Enter the name or address of the Server hosting the session. eg. havefun.ncsa.uiuc.edu - Enter the port number used by the server to communicate data.
d)	Click on the start button, , and the Client will create a session.
e)	Select a tool from the session control window.

Joining a Session

a)	Launch the Habanero Client
b)	In the Habanero Environment Window enter the session's name, server address and port number in the corresponding fields. - Enter a Session Name. This name is distinct and is used by the server to identify a session. - Enter the name or address of the Server hosting the session. - Enter the port number used by the server to communicate data.
c)	Click on the start button, , and the Client will connect to the server and attempt to join the session.
d)	Select a tool from the session control window.
e)	After a connection has been established, give Habanero a couple of moments to update your collaborative environment and open the current set of active applications.

Collaborating on the Same Machine

Running in Stand-alone Mode

Running Habanero in local mode allows you to run the Client without a Server. This is useful for using the applications outside of a collaborative session, configuring session preparations and familiarizing your self with the environment. While running a session in 'local' mode, your network dependent applications will still run but the data is not be shared and is limited to your system. Use the following steps to create a 'local' session:
a)	start the Habanero Client
b)	enter a session name
c)	enter "local" for the server address
d)	enter a port number
e)	Click on the start button, , and the Client creates a local copy of Habanero.

[ 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 April, 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.