--------------------------
 XELFI INSTALLATION GUIDE                 
--------------------------

This text will tell you how to install Xelfi. Please read it before you start.

The installation is based on two steps:
 - install the xelfi package
 - install the sun.tools package (if you haven't got it yet)

1) install the xelfi package
  
The Xelfi classes are all situated in one package "xelfi" (with many 
subpackages).The package is compressed in the file .....
Install this package. If you are expierenced with installing java packages
you can skip the next paragraph and continue with section 2.

How to install the xelfi package:
  - select the root directory for the xelfi package. If you have other java 
    packages installed you can choose the same root directory.
  
  - unzip the xelfi classes into this directory. You will see new 
    subdirectory "xelfi" with many subdirectories and class files.
  
  - make sure that your CLASSPATH contains this root directory. If not add it
    there. On most systems CLASSPATH is the environment variable containing 
    all root directories for java packages It uses the same syntax as the 
    PATH variable. 
    On Unix machines don't forget to export the CLASSPATH by command "export 
    CLASSPATH" before running java.

2) install sun.tools package
  
Xelfi needs sun.tools package to run properly. Without it you will not be able 
to compile and debug from the Xelfi environment.

If you are using Sun JDK 1.0.2 (or other java kit based on Sun JDK 
like Symantec JDK) you have this already package installed (it comes with 
the JDK). 

If not please install it. It is available for free download on the Internet.
Our notes for the installation:
  - install the pacakge, update your CLASSPATH  

  - If you are not using JDK please copy file java.properties into your 
    java-home directory after instalation (for example for Microsoft J++ it 
    is "Win95\java\lib").

  - You have to install the TCP/IP support on your computer to make xelfi 
    debugger running. But if your computer is not connected to the network you 
    may have problems with IP address. The author of the Xelfi debugger tested 
    on his computer (Windows NT 4.0) this configuration

    IP = 1.1.1.1
    MASK = 255.0.0.0 

    If you would try to start the debugger without TCP/IP installed
    (using sun.tools.debug) you will get UnknownHostException.

Note on the xelfi debugger:
  Due to poor sun.tools.debug implementation the xelfi debugger currently 
  runs well only under JDK from Suns (but on all platforms). See the xelfi 
  documentation for more info. We are working to fix it.
