JavaParty

JavaParty Setup

1. Unpack the distribution archive

Suppose you downloaded the JavaParty distribution called jp-karmi-1.9.5.tgz. You have to extract the archive to a directory of your choice:

gzip -d jp-karmi-1.9.5.tgz
tar -xvf jp-karmi-1.9.5.tar

The extraction of the archive creates a single directory jp-karmi containing all files and directories of the distribution, so you possibly want to extract the archive directly in your home directory.

2. Make invocation scripts accessible

The JavaParty distribution ships with a set of scripts that enable you to easily start and stop the JavaParty environment. Make sure, your shell can find the scripts in the bin/ directory of the distribution by including this directory into your PATH environment variable:

setenv PATH <install-directory>/jp-karmi/bin:$PATH

Do not move the scripts to another location, because otherwise they will fail to find required files from the distribution.

3. Unix only: Configure hosts for execution

There is a convenient way to start a JavaParty application from a Unix system. You only need a configuration file .jp-nodefile in your home directory that lists the host names to use for execution. The contents of this file may look like the following:

host1.mydomain.com
host2.mydomain.com
host3.mydomain.com
host4.mydomain.com

Make sure, you can log into the listed machines via ssh without entering a password on the command line and you have access to your home directory via network filesystem. You may accomplish that by installing a public key for authentication (see man ssh).

Note: Use hostnames that are valid on each of the participating machines. Furthermore, they must not only be valid, but point to the same physical machine, no matter where they are looked up. For example, you shouldn't use localhost in .jp-nodefile.

Test whether the login works for all machines type:

jpinvite -test

4. Test the components

To check whether JavaParty can find all required components, try the following command on your shell prompt:

javaparty -help

If the command completes without an error, it prints a brief help information and lists the properties of your installed JavaParty runtime environment. Next you will want to see JavaParty in operation. Go to the "Quick Tour" section to learn how JavaParty programs are executed.

If an error is reported and you are unable to resolve the problem from the description, you should check, whether your system meets all requirements for your version of JavaParty or consult the "Trouble Shooting" section.