====== Interoperation of GridWay with GridSAM through BES ======

GridSAM provides a job submission interface for submitting computational jobs to many commonly used distributed resource management systems. It provides a implementation of BES (Basic Execution Service). The OGSA-BES specification defines Web Services interfaces for creating, monitoring, and controlling computational entities such as UNIX or Windows processes, Web Services or parallel programs, called activities, within a defined environment. A BES implementation executes each
activity that it accepts on an appropriate computational resource. This document describes how to install and configure GridWay to submit jobs to BES endpoints provided by GridSAM, and control and monitoring the execution of jobs.


===== Installation =====

  * Install the ''IGE'' repository.

  * Install the ''gridway-BES'' package that provides the GridWay drivers to interface with BES endpoints. IGE and official repos must resolve all dependencies. They are: ''gridway-core'', ''java'', ''axis'', ''wsdl4j'', ''log4j'' and ''xalan-j2''.

  * Alternatively, you can build and install the BES and dummy drivers by yourself. It is needed to install the ''java-devel'', ''axis'' and ''xalan-j2'' packages, and the ''xmlbeans.jar'' and ''gridsam-schema.jar'' files to build the BES driver. Finally, set up the ''JAVA_EXT'' variable, if needed, in ''Makefile'' and ''gw_em_mad.sh'' files to find all jar files.

===== Configuration of Drivers =====

The GridWay Configuration Guide provides complete information about configuration of the meta-scheduler. Next steps describe the specific configuration to interface with BES endpoints provided by GridSAM.

  * Add the following lines in the ''/usr/etc/gwd.conf'' file:
<file>
   # MADs for OGSA-BES (GridSAM)
   IM_MAD = static:gw_im_mad_static:-l etc/GridSAM_hosts.list:dummy:bes
   EM_MAD = bes:GW_em_mad_bes:-t gridsam:jsdl
   TM_MAD = dummy:gw_tm_mad_dummy:-u gsiftp\://<hostname>
</file>

Don't forget to set up the GridFTP server.

  * Nodes list (''/usr/etc/GridSAM_hosts.list'') is a list of nodes and files with static information of each node, this is an example:
<file>
  <hostname1> etc/<hostname1>.machine
  <hostname2> etc/<hostname2>.machine
  <hostname3> etc/<hostname3>.machine
  ...
</file>
The files ''/usr/etc/<hostname>.machine'' contain static information about each node where you want to send jobs. Please refer to the [[:documentation:release_5.12:cg|configuration]] guide for more details.

  * Some privileges are required to be set in the ''/etc/sudoers'' file. Please add the following lines.

<file>
   Defaults>GWUSERS env_keep="GW_LOCATION GLOBUS_LOCATION"
   #GridWay entries (OGSA-BES MAD)
   gwadmin ALL=(GWUSERS) NOPASSWD: /usr/bin/GW_em_mad_bes *
   gwadmin ALL=(GWUSERS) NOPASSWD: /usr/bin/gw_tm_mad_dummy *
</file>

  * Configure the ''crypto.properties'' file in ''/usr/etc/''.

  * Create a ''$HOME/.myproxy'' file with access data to a MyProxy server, where the first line is the hostname of the MyProxy server, the second line is the username and the last line is the password.

  * BES driver uses transport-level security, while message-level security is not supported.

===== Using GridWay =====

The functionality and interfaces provided by GridWay are independent from the underlying Grid infrastructure. Please refer to the guides (user's guide, command reference, programming guide...) available at the [[:documentation|Documentation]] section.