= Integrate applications in JUBE =

== Introduction ==

* JUBE Benchmarking Environment: provides a script based framework to easily create benchmark sets, run those sets on different computer systems and evaluate the results.
* Documentation: http://apps.fz-juelich.de/jsc/jube/jube2/docu/index.html
* Current version available in the DEEP and DEEP-ER systems: 2.1.0
* Example commands:

{{{
ssh user@deep

$ jube2 info benchmark_directory
$ jube2 status benchmark_directory [-i run_id]
$ jube2 run benchmark_xml_file [--tag tag1 tag2 ...]
$ jube2 analyse benchmark_directory [-i run_id]
$ jube2 result benchmark_directory [-i run_id]
}}}

== Example application ==

{{{
ssh manzano@deep

cd /usr/local/deep-er/sdv-benchmarks/applications/MAXW-DGTD
}}}

=== Compile ===

See for instance the JUBE xml file of the example application:

{{{
vim MAXW-DGTD-jube-master-SDV.compile.xml
}}}

Important parts in the file are:

1) Platform

{{{
  <include-path>
    <path>/usr/local/jube2/platform/deep</path>
  </include-path>
}}}

Under /usr/local/jube2/platform/deep there are a series of files with default values for the DEEP and DEEP-ER systems:

{{{
deep-chainJobs.sh
submit.job.in
platform.xml
}}}

These files won't be modified but the default values can be overwritten in the JUBE xml file.

2) Sources

{{{
    <fileset name="sources">
      <copy>MAXW-DGTD.tar.gz</copy>
      <prepare>tar -xzf MAXW-DGTD.tar.gz</prepare>
    </fileset>
}}}

...