GridSAM Deployment Guide

Introduction

The GridSAM Web Service is modular in design. The DRMConnector abstraction provides a pluggable submission pipeline to a variety of Distributed Resource Managers and novel Grid launching mechanism (e.g. super-scheduler). The Deployment Guide introduces several common deployment s cenarios and the associated configuration instruction.

Readers are expected to have completed the procedure set out in the Quick Start Guide and successfully run a GridSAM service using the default settings.

GridSAM makes use of Apache Hivemind XML configuration extensively. It allows individual component of the GridSAM submission pipeline to be customised and composed simply by modifying the set of predefined configuration files and overridable properties.

The main configuration file can be found in $OMII_HOME/webapps/gridsam/WEB-INF/classes/jobmanager.xml, we will refer to this file as jobmanager.xml in this document. The out-of-the-box setting configures the fork DRMConnector with several defaults defined (e.g. spool directory).

<?xml version="1.0" encoding="UTF-8"?>
<module id="jobmanager.fork" version="1.0.0">

    <!-- dependent modules - collectively define the fork connector -->
    <sub-module descriptor="org/icenigrid/gridsam/resource/config/common.xml"/>
    <sub-module descriptor="org/icenigrid/gridsam/resource/config/embedded.xml"/>
    <sub-module descriptor="org/icenigrid/gridsam/resource/config/fork.xml"/>
    <sub-module descriptor="org/icenigrid/gridsam/resource/config/shell.xml"/>

    <!-- the database module -->
    <sub-module descriptor="database.xml"/>

    <!-- override the factory defaults here -->
    <contribution configuration-id="hivemind.ApplicationDefaults">
        <!--
        The spooling directory for shell-based job submission
        -->
        <default symbol="spool.directory" value="/tmp"/>
    </contribution>
</module>

GridSAM can be configured by altering the set of dependent modules to load based on the backend Distributed Resource Manager (DRM) in use, and a set of named contributions that are configurable symbols required by those modules.

This document will introduce you to the major elements configurable in GridSAM. To reconfigure GridSAM, the administrator MUST

  1. Shutdown the service container
  2. Edit the file jobmanager.xml and associated files
  3. Restart the service container to use the new settings.

For further information, please consult the following documents