How to start JAG

If you want to run a test on several machines, or on a single machine that is not your localhost, you have to install and start JAG on all the machines where you want to run a test.

General

The jag.jar file in the jet~framework/jag/target/ directory contains all the dependencies you need to start JAG.

JAG needs a configuration file, there is an example in jet~framework/config/jag.properties.

This is how you would start JAG manually:

  cd jet~framework/jag
  java -jar target/jag-1.0-SNAPSHOT.jar -config config/jag.properties

If you want to overwrite configuration settings in the configuration file, you can use

  java -Dconfig.setting -jar jag.jar -config ...

JAG wants to run as a separate user. The normal username for this user is jaguser

Embedded

When a test is only run on a single client host, and the client host is localhost,and no JAG is already running on localhost, a embedded JAG will be startet in JET or JETBatch that runs the test.

Platform Specific

Scripts to install JAG on different machines are found in the jet~framework/scripts directory.

Solaris

JAG runs as a SMF service under Solaris 10, OpenSolaris and Illumos. SMF makes crashed JAG processes respawn.

Read jet~framework/scripts/solaris/README for instructions on how to install.

Linux

On Linux, JAG runs as a init.d script. You have to create a jaguser for JAG to run as, but the way to do this differs from distribution to distribution. useradd might be one way to do it, depending on the distribution.

Read jet~framework/scripts/linux/README for instructions on how to install.

OS-X

On Mac OS-X, JAG runs under the SystemStarter system.

You have to do some editing and copying before you can install it.

Read jet~framework/scripts/mac/README for instructions on how to install.

Windows

JAG can be setup as a service on Windows.

Read jet~framework/scripts/windows/README for instructions on how to install.