Launching Mechanism - Fork

Architecture

Single machine (B) running the OMII container with the GridSAM Web Service deployed. Jobs are launched on the same machine (B) as the OMII container. OMII container (B) is available to the Internet. User holding a certificate trusted by the OMII container (B) can submit jobs over the internet to the GridSAM instance running on the OMII container (B).

Configuration

This is the default setup of the GridSAM service. The following parameters in the jobmanager.xml file can be modified to reflect the local setup on host (B).

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

        <!-- dependent modules -->
        <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"/>
        <sub-module descriptor="database.xml"/>
                <sub-module descriptor="authorisation.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>
  • [SYMBOL] spool.directory: Path to a directory used to spool and stage jobs. This directory must be readable, writable and owned by the user running the OMII container.

Consideration

Jobs are executed under the same account as the user running the OMII container. Jobs are not partitioned, therefore each job can potentially interfere with other jobs in the system. At the time of writing, GridSAM does not have the ability to change user while forking the executable. This setup is intended to be used in small-scale trusted network, and security concerns are not a consideration.