Cluster Scheduler DRMAA Java API

The DRMAA Java is a wrapper around the Cluster Scheduler DRMAA version 1 C/C++ API. It uses JNI to access the libdrmaa shared library.

It comes with how-tos (same logic as the DRMAA C howtos but in Java) and Javadoc documentation. A comprehensive test suite can be run from within the Cluster Scheduler testsuite.

Prerequisites

Cluster Scheduler DRMAA Java requires the following oftware for building

• Java JDK >= 1.8
• Maven
• A Cluster Scheduler installation including the architecture specific drmaa shared library (usually libdrmaa.so)

Build / Package

Build the jdrmaa jar file with Maven and copy it to the Cluster Scheduler installation:

mvn -Dmaven.test.skip package
cp target jdrmaa-1.0.jar $SGE_ROOT/lib

Basic Test

A basic DRMAA Java example application DrmaaExample (src/main/java/DrmaaExample.java) is part of the DRMAA Java jar file. In order to run it you need a Cluster Scheduler installation, the host running the example must be submit host.

The example application submits a number of array jobs and sequential jobs and waits for them to get scheduled and finish.

source $SGE_ROOT/$SGE_CELL/common/settings.sh
java -cp target/jdrmaa-1.0.jar DrmaaExample $SGE_ROOT/examples/jobs/sleeper.sh

Running the Test Suite

Testing the Cluster Scheduler DRMAA Java API requires and is called from the Cluster Scheduler testsuite. The testsuite will be open sourced in the near future.

License

The original files contributed by Sun Microsystems are licensed under

• Sun Industry Standards Source License v1.2

Newer contributions from HPC-Gridware GmbH (and others like Univa Inc. or individual contributors) are licensed under

• Apache License v2.0