What is DRMAA?

--------------

Content

-------

1. Introduction

2. Getting Started

3. Getting Support

4. Copyright

1. Introduction

---------------

DRMAA is a specification developed by a working group in the Global Grid

Forum (GGF). The best way to describe DRMAA is to cite the DRMAA-WG

Charter:

"Develop an API specification for the submission and control of jobs

to one or more Distributed Resource Management (DRM) systems. The

scope of this specification is all the high level functionality which

is necessary for an application to consign a job to a DRM system

including common operations on jobs like termination or suspension.

The objective is to facilitate the direct interfacing of applications

to today's DRM systems by application's builders, portal builders, and

Independent Software Vendors (ISVs)."

Simply put, DRMAA is an API for submitting and controling jobs. DRMAA

has been implemented in several lanuages and for several DRMs. The Grid

Engine release since 6.0 includes a C implementation, or C binding. Since Grid

Engine release 6.0u2 both, the C binding and the Java[TM] language binding, are

included.

For more information about DRMAA and the various bindings that are

available, visit the DRMAA website at:

http://www.drmaa.org/

There you will find links to the DRMAA specification and mailing list

archives detailing the thought process that went into DRMAA.

Information about grid computing standards in general can be found at the

GGF website:

http://www.gridforum.org/

The Perl language binding module for DRMAA can be found at:

http://search.cpan.org/src/THARSCH/Schedule-DRMAAc-0.81/

For information on the C language binding included with the Condor 6.7

release, see:

http://www.cs.wisc.edu/condor/manual/v6.7/4_4Application_Program.html#SECTION00542000000000000000

2. Getting Started

-------------------

To develop applications that utilize the Java language binding, you will need

two files. The first is the jar file, drmaa.jar. This file is need for both

compiling and running applications utilizing the Java language binding. The

second file is the DRMAA shared library. This file will need to be

accessible from the shared library path in order for your application to

link properly and run. If you built the binaries yourself (using "aimk

-java" and "distinst -local") or installed the prebuilt binaries, you will

find the shared library in $SGE_ROOT/lib/$ARCH and the jar file in

$SGE_ROOT/lib. Note that the DRMAA shared library is the same one used by

DRMAA C language binding programs.

The first step is to look at the example program found at:

https://github.com/gridengine/gridengine/raw/master/source/libs/jdrmaa/src/DrmaaExample.java

The example program demonstrates a simple usage of the DRMAA library to

submit several bulk jobs and several single jobs, wait for the jobs to

finish, and then output the results.

In the:

https://github.com/gridengine/gridengine/tree/master/source/libs/jdrmaa/src/com/sun/grid/drmaa/howto

directory you will find the example programs from the online tutorial at:

http://arc.liv.ac.uk/SGE/howto/drmaa_java.html

API documentation can be found at:

$SGE_ROOT/doc

Once you're familiar with DRMAA, you're ready to begin development of your

Java application. When compiling your file, you will need to have

$SGE_ROOT/lib/drmaa.jar included in your CLASSPATH.

3. Getting Support

------------------

For commercial deployments Univa Grid Engine DRMAA is recommended.

If you're having trouble with the DRMAA library delivered with Univa Grid

Engine, please visit:

http://www.gridengine.org

or http://www.univa.com

to see if the problem your having is a know problem. Alternately or for

additional help you can send email to the dev@gridengine.org

mailing list. You can also browse archives of this mailing list at:

http://gridengine.org/pipermail/dev

4. Copyright

------------

___INFO__MARK_BEGIN__

The Contents of this file are made available subject to the terms of the Sun

Industry Standards Source License Version 1.2

Sun Microsystems Inc., March, 2001

Sun Industry Standards Source License Version 1.2

=================================================

The contents of this file are subject to the Sun Industry Standards Source

License Version 1.2 (the "License"); You may not use this file except in

compliance with the License. You may obtain a copy of the License at

http://gridengine.sunsource.net/Gridengine_SISSL_license.html

Software provided under this License is provided on an "AS IS" basis,

WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,

WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,

MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.

See the License for the specific provisions governing your rights and

obligations concerning the Software.

The Initial Developer of the Original Code is: Sun Microsystems, Inc.

Copyright: 2001 by Sun Microsystems, Inc.

All Rights Reserved.

Portions of this text are Copyright 2011 Univa Corporation.

___INFO__MARK_END__