NexusRMI
========

Contents
--------

NexusJava runtime version 4.3 (slightly modified from the original)
NexusRMI runtime version 1.4
NexusRMI compilers version 1.4

Installation requirements
-------------------------
- GNU gcc (other compilers should work but currently not supported)
- GNU make (other make versions will fail to expand some macro's,
            which causes installation to fail)
- GNU Bison and Flex (Yacc/Lex should also work but are not supported)
- GNU cp (part of file-utils, needed to maintain symbolic links)

These utilities can be obtained from any GNU ftp mirror site (see
http://www.gnu.org/order/ftp.html).

Installation
------------

To install the nexusrmi runtime and compilers:
 1. Unpack the archive, this creates a nexusrmi directory
 2. Change to the nexusrmi directory and edit the 'config.mk' file
    to specify the target directories and architecture.
 3. Type make in the nexusrmi directory.

To compile and run RMI applications:

 4. Make sure the binary directory is included in your PATH.
 5. Make sure the runtime directory is included in your CLASSPATH.
 6. Make sure that all system class files are available and their
    location specified in the CLASSPATH variable in the nexusrmis
    and nexusrmic scripts.
 7. Make sure all your sources import rmi classes from
    the NexusRMI-package instead of from the standard JavaRMI 
    package. You can use 'java2nexus' and 'nexus2java' to switch
    between JavaRMI and NexusRMI usage.
 8. Compile all your application sources with your favorite Java
    compiler.
 9. run 'nexusrmis' on all serializable classes
10. run 'nexusrmic' on all remote classes.
11. if needed, run the registry with 'nexusrmiregistry'.
12. run your application client and server in the same way as you
    would run it when using JavaRMI.

For more information, check out the html-documentation in nexusrmi/doc.

Mail any questions to breg@cs.indiana.edu.