|
Prerequisites
Software Installation
Job Scheduler API
Prerequisites
Job Scheduler consists
of three main components which must be installed in following order:
1)
The SmoaCore library:
This component depends on libxml (version at least 2.6.28), openssl
(0.9.7), and unixodbc (at least 2.2.0) or iodbc (3.0.0).
2)
The Job Scheduler Service (aka
Open DSP or SMOA Computing): Before
the installation of the Job Scheduler You a DRM system that support
DRMAA interface must be installed and configured (Sun Grid Engine (http://gridengine.sunsource.net)
is the recommended DRM system). The Postgres database must be
installed.
3)
SBA registrar: The ‘SBA_access’ and ‘rdfConversor’
artefacts of BREIN must be installed previously to the installation
of this component.
Installation
SMOACore
First of all, the
SMOACore package has to be installed. In order to install it just
click on the 'smoa-core-2.0.3-3.i386.rpm' package, and the package
installer is launched. It is a not interactive installation, so it
should install the core software automatically.
Alternatively, it can
be installed from the command line executing the following command
in a shell:
rpm -i smoa-core-2.0.3-3.i386.rpm
Job Scheduler Service / aka SMOA Computing
The installation of the Job Scheduler Service or
SMOA Computing component is a bit more interactive. The installation
process is shown in REF _Ref235441492 \h Figure 14.
The package is installed and a new user and group are created. After
the package is installed, a post-installation script must be
executed to configure it. This script asks for some information as
if PostgreSQL is installed locally, and a set of names and passwords
for users.
To start the
‘smoa_comp’ service you must be logged as the ‘root’ and run:
#/sbin/service
smoa-compd start
and to start the 'smoa-coordinatord'
service:
#/sbin/service
smoa-coordinatord start
SBA registrar
This component must be
installed previously to the installation of the Job Scheduler.
JobScheduler API
Table Job Scheduler BES-Management
Port-type Interface
|
Method |
StopAcceptingNewActivities |
|
Arguments |
None |
|
Return Value[s] |
None |
|
Description |
Request the Job Scheduler to stop accepting new
activities (i.e. jobs) |
|
Method |
StartAcceptingNewActivities |
|
Arguments |
None |
|
Return Value[s] |
None |
|
Description |
Request the Job Scheduler to start accepting new
activities (i.e. jobs) |
Table - Job Scheduler BES-Factory
Port-type Interface
|
Method |
CreateActivity |
|
Arguments |
ActivityDocumentType ActivityDocument – an XML document describing the activity to be created. The document
must contain valid JSDL document |
|
Return Value[s] |
EPR
– the Endpoint Reference of the created activity |
|
Description |
Request the Job Scheduler to create new activity (i.e.
job) |
|
Method |
GetActivityStatuses |
|
Arguments |
EPR ActivityIdentifier[]
– a vector of EndpointReferences identifying activities
from which status information is being required |
|
Return Value[s] |
XMLElement[] – a vector of XML elements describing current state of the
activities
|
|
Description |
Request the Job Scheduler to return the status of a set
of activities (i.e. jobs) |
|
Method |
TerminateActivities |
|
Arguments |
EPR ActivityIdentifier[]
– a vector of EndpointReferences identifying activities
that are to be aborted. |
|
Return Value[s] |
XMLElement[] – a vector detailing the results of the abort operation on
each activity |
|
Description |
Request the Job Scheduler to abort a set of activities
(i.e. jobs) |
|
Method |
GetActivityDocuments |
|
Arguments |
EPR ActivityIdentifier[]
– a vector of EndpointReferences identifying activities
for which ActivityDocument are requested |
|
Return Value[s] |
XMLElement[]
– a vector of ActivityDocuments containg JSDL document of
the each activity |
|
Description |
Request the Job Scheduler to return JSDL documents
describing set of activities (i.e. jobs) |
|
Method |
GetFactoryAttributesDocument |
|
Arguments |
None |
|
Return Value[s] |
XML document containing BES properties of the Job
Scheduler. |
|
Description |
Request the XML document containing BES properties of
the Job Scheduler. |
Table - Job Scheduler BES-Activity
Port-type Interface
|
Method |
HoldActivities |
|
Arguments |
EPR ActivityIdentifier[]
– a vector of EndpointReferences identifying activities
that are to be held. |
|
Return Value[s] |
XMLElement[]
– a vector detailing the results of the hold operation on
each activity |
|
Description |
Request the Job Scheduler to hold a set of activities
(i.e. jobs) |
|
Method |
ReleaseActivities |
|
Arguments |
EPR ActivityIdentifier[]
– a vector of EndpointReferences identifying activities
that are to be released. |
|
Return Value[s] |
None |
|
Description |
Request the Job Scheduler to release a set of activities
(i.e. jobs) |
|
Method |
SuspendActivities |
|
Arguments |
EPR ActivityIdentifier[]
– a vector of EndpointReferences identifying activities
that are to be suspended. |
|
Return Value[s] |
XMLElement[] – a vector detailing the results of the suspend operation
on each activity |
|
Description |
Request the Job Scheduler to suspend a set of activities
(i.e. jobs) |
|
Method |
ResumeActivites |
|
Arguments |
EPR ActivityIdentifier[]
– a vector of EndpointReferences identifying activities
that are to be resumed. |
|
Return Value[s] |
XMLElement[] – a vector detailing the results of the resume operation
on each activity |
|
Description |
Request the Job Scheduler to resume a set of activities
(i.e. jobs) |
|
Method |
PutInputFiles |
|
Arguments |
String targetFileNames[]
– a vector containing names of files to be staged in |
|
Return Value[s] |
None |
|
Description |
Sends files (using SOAP attachments) from local host to
Job Scheduler submit host |
|
Method |
GetOutputFiles |
|
Arguments |
String sourceFileNames[]
– a vector containing names of files to be staged out |
|
Return Value[s] |
None |
|
Description |
Retrieves files (using SOAP attachments) from Job
Scheduler submit host to local host |
|
