Prerequisites

To install the monitoring application locally, the instructions Installing HPS Java should be followed, and specifically the whole trunk should be built by typing 'mvn -DskipTests' from the trunk directory in the local copy.  If the build is successful, the runnable jar for the application will be created in trunk/monitoring-app/target and can be executed using the standard java command.

Running the Monitoring Application Jar

 

Jar Version

The following examples assume that the '3.0.2-SNAPSHOT' version of the monitoring application is being used but this may change in the future.  You should use the jar that is actually created by your local build

Aside from a dependence on a platform-dependent library used through JNI (covered under the next section), the monitoring application jar is self-contained and can be run as follows.

 

./target/scripts/start_monitoring_application.sh

This will start the application with the default options.

There are a few options that can be shown by using the help command line switch.

./target/scripts/start_monitoring_application.sh -h

 

To load preexisting settings for the job and connection, a command like this should be executed.

./target/scripts/start_monitoring_application.sh -j job_opts.prop -c conn_opts.prop

Running with Test Data

Assuming that you want to run a local ET ring and not connect to one that is already online, you should open three terminals.  These are for running the monitoring application itself, running an ET ring, and streaming a test file onto the ET ring.  The working directory in each terminal should be trunk/monitoring-app from the full SVN checkout of HPS Java.

In the first terminal, start the monitoring app.

 

./target/scripts/start_monitoring_application.sh

From the second terminal, start up the ET server.

./target/scripts/start_et_ring.sh

Now, in the monitoring application GUI, you should configure the job parameters in the job panel such as the steering file to be run, if necessary.  Then hit the Connect button and make sure that the application connects successfully to the online ET system.

Finally, in the last terminal, a file should be streamed onto the ET ring to activate the event stream in the monitoring application.

./target/scripts/evio_file_producer.sh /nfs/slac/g/hps3/data/testrun/runs/evio/hps_001351.evio.0

 

If everything was successful, plots should be created in the monitoring application should start updating with the event data.
  • No labels