qcg-pilotjob 0.12.2rc1

Manage many jobs inside one allocation

QCG-PilotJob

QCG-PilotJob is a lightweight service for execution of many computing tasks inside one allocation

Author: Piotr Kopta [e-mail], Tomasz Piontek [e-mail], Bartosz Bosak [e-mail]

Copyright (C) 2017-2021 Poznan Supercomputing and Networking Center

Overview

The QCG-PilotJob system is designed to schedule and execute many small jobs inside one scheduling system allocation. Direct submission of a large group of jobs to a scheduling system can result in long aggregated time to finish as each single job is scheduled independently and waits in a queue. On the other hand the submission of a group of jobs can be restricted or even forbidden by administrative policies defined on clusters. One can argue that there are available job array mechanisms in many systems, however the traditional job array mechanism allows to run only bunch of jobs having the same resource requirements while jobs being parts of a multiscale simulation by nature vary in requirements and therefore need more flexible solutions.

The core component of QCG-PilotJob system is QCG-PilotJob Manager. From the scheduling system perspective, QCG-PilotJob Manager, is seen as a single job inside a single user allocation. It means that QCG-PilotJob Manager controls an execution of a complex experiment consisting of many jobs on resources reserved for the single job allocation. The manager listens to user's requests and executes commands like submit job, cancel job and report resources usage. In order to manage the resources and jobs the system takes into account both resources availability and mutual dependencies between jobs. Two interfaces are defined to communicate with the system: file-based (batch mode) and API based. The former one is dedicated and more convenient for a static scenarios when a number of jobs is known in advance to the QCG-PilotJob Manager start. The API based interface is more general and flexible as it allows to dynamically send new requests and track execution of previously submitted jobs during the run-time.

To allow user's to test their scenarios, QCG-PilotJob Manager supports local execution mode, in which all job's are executed on local machine and doesn't require any scheduling system allocation.

Documentation

The documentation of the QCG-PilotJob system is available at https://qcg-pilotjob.readthedocs.org

Installation

The latest stable version of QCG-PilotJob can be installed with pip

$ pip install qcg-pilotjob