Launcher is a utility for performing simple, data parallel, high throughput computing (HTC) workflows on clusters, massively parallel processor (MPP) systems, workgroups of computers, and personal machines.
Launcher does not need to be compiled. Unpack the tarball or clone the repository in the desired directory. Then, set
LAUNCHER_DIR to point to that location. Python 2.7 or greater and hwloc are required for full functionality. See INSTALL for more information.
Included in the download is a file called "quickstart" found in the folder "tests". In order to verify installation, open the command line and find the launcher file, and then type "cd tests" and then press the enter key. If the quickstart file is in the correct place, there is no need for arguments, so type "./quickstart". However, if the Launcher directory is found somewhere else, type "./quickstart ". The script will run in the terminal and if there are no errors in the process, the last line will say "Launcher: Done. Job exited without errors".
LAUNCHER_JOB_FILEto point to your job file. Example job files are provided in extras/examples.
- Be sure that
LAUNCHER_DIRis set to the directory containing the launcher source files (user-installed ONLY. Not required if using system installed version of launcher).
- From the command-line or within your jobscript, run:
Available Environment Variables
You should set the following environment variables:
$LAUNCHER_JOB_FILEis the file containing the jobs to run in your parametric submission.
$LAUNCHER_WORKDIRis the directory where the launcher will execute. All relative paths will resolve to this directory.
The launcher defines the following environment variables for each job that is started:
$LAUNCHER_NPROCScontains the number of processes running simultaneously in your parametric submission.
$LAUNCHER_NHOSTScontains the number of hosts running simultaneously in your parametric submission.
$LAUNCHER_PPNcontains the number of processes per node.
$LAUNCHER_NJOBScontains the number of jobs in your job file.
$LAUNCHER_TSK_IDis the particular processing core that the job is running on, from 0 to
$LAUNCHER_JIDrepresents the particular job instance currently running.
$LAUNCHER_JIDis numbered from 1 to
Example: If you want to redirect stdout to a file containing the unique ID of each line, you can specify the following in the paramlist file:
a.out > out.o$LAUNCHER_JID
If this particular execution instance of a.out was the first line in the job file, the output would be placed in the file "out.o1".
Note: you can also use the launcher to run a sequence of serial jobs when you have more jobs to run than the requested number of processors.
Task Scheduling Behavior
The launcher has three available behaviors for scheduling jobs, available by setting the environment variable
$LAUNCHER_SCHED: (descriptions below assume k = task, p = num. procs, n = num. jobs)
- dynamic (default) - each task k executes first available unclaimed line
- interleaved - each task k executes every (k+p)th line
- block - each task k executes lines [ k(n/p)+1, (k+1)(n/p) ]
Using Launcher on Multi-/Many-core Processors
Launcher uses the hwloc utility to determine layout of cores on the node. If hwloc is installed on your system and the commands are in the default
PATH, Launcher will use this to partition the cores on node between the tasks. You can enable task binding by setting
LAUNCHER_BIND=1 before calling
Using Launcher with Intel Xeon Phi (KNC) Co-processor Cards
Launcher has the ability to execute appropriately compiled executables natively on first generation Intel Xeon Phi (KNC) cards.
Available Environment Variables for Intel Xeon Phi execution:
$LAUNCHER_NPHIis the number of Intel Xeon Phi cards per node. This is set to zero (0) by default. Acceptable values are '1' and '2'.
$LAUNCHER_PHI_PPNis the number of processes per Intel Xeon Phi card.
$LAUNCHER_PHI_JOB_FILEis the file containing the jobs to run on the Intel Xeon Phi cards.
Copy the example job submission script
launcher.<sched> to your working directory to use as a starting point for interfacing with the desired batch system. Note that this script provides some simple error checking prior to the actual submission to aid in diagnosing missing executables and misconfiguration.
The launcher/extras/batch-scripts directory contains several example submission scripts:
- SGE: launcher.sge
- SLURM: launcher.slurm
If you are using Launcher, please remember to make a reference to it when publishing results. The file
paper/paper.bib contains the BibTeX-formatted citation list. Please reference entry
Wilson:2014:LSF:2616498.2616533 (i.e., in LaTeX: