makeflow_mpi_starter(1)

makeflow_mpi_starter1

Mpi wrapper program for makeflow and workqueue

Usage

FCmakeflow_mpi_starter [options] FT

Overview

makeflow_mpi_starter is an MPI wrapper program that will start Makeflow and WorkQueue on the nodes allocated to it. It is intended as a simple, easy way for users to take advantage of MPI-based system while using Makeflow and WorkQueue. To use it, the user simply needs to call it as one would a regular MPI program. For the program to work, cctools needs to be configured with FC--with-mpi-pathFT.

Options

When FCmakeflow_mpi_starterFT is ran without arguments, it will attempt to execute the workflow specified by the Makeflow dagfile.

Commands

-m, --makeflow-arguments=<option>

Options to pass to makeflow, such as dagfile, etc

-p, --makeflow-port=<port>

The port for Makeflow to use when communicating with workers

-q, --workqueue-arguments=<option>

Options to pass to work_queue_worker

-c, --copy-out=<location>

Where to copy out all files produced

-d, --debug=<debugprefix>

Base Debug file name

-h, --help

Print out this help

Exit status

On success, returns zero. On failure, returns non-zero.

Examples

Run with debugging:


    

    
        

mpirun -np $NUM_PROC makeflow_mpi_starter -m "Makeflow.mf" -d mydebug

Run makeflow with custom port:


    

    
        

mpirun -np $NUM_PROC makeflow_mpi_starter -m "Makeflow.mf" -d mydebug -p 9001

Run makeflow with garbage collection


    

    
        

mpirun -np $NUM_PROC makeflow_mpi_starter -m "-gall Makeflow.mf" -d mydebug

Example SGE submission script


    

    
        

#!/bin/csh

#$ -pe mpi-* 120 #$ -q debug #$ -N mpi_starter_example

module load ompi

mpirun -np $NSLOTS makeflow_mpi_starter -m "Makeflow.mf" -d mydebug

Releases

2 releases since Debian 11 (Bullseye); the text changed 1 time.

  1. 11
  2. 12

From coop-computing-tools 9.9-2+b4 in Debian 12 (Bookworm). Parsed by carta from the page's man source.