====== Interoperation of GridWay with UNICORE through BES ======

UNICORE (UNiform Interface to COmputing REsources) is a grid computing technology that provides seamless, secure, and intuitive access to distributed Grid resources. 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 UNICORE, 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.

  * Alternatively, you can build and install the BES and dummy drivers by yourself. Install ''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 UNICORE.

  * Add the following lines in the ''/usr/etc/gwd.conf'' file:
<file>
   # MADs for OGSA-BES (UNICORE)
   IM_MAD = static:gw_im_mad_static:-l etc/UNICORE_hosts.list:dummy:bes
   EM_MAD = bes:GW_em_mad_bes:-t unicore:jsdl
   TM_MAD = dummy:gw_tm_mad_dummy:-i
</file>

  * Nodes list (''/usr/etc/UNICORE_hosts.list'') is a list of nodes and files with static information of each node, this is an example:
<file>
  <hostname1>/<gateway_name> etc/<hostname1>.machine
  <hostname2>/<gateway_name> etc/<hostname2>.machine
  <hostname3>/<gateway_name> 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/''.

  * 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.