NAME

       makeflow_mpi_starter - mpi wrapper program for makeflow and workqueue

SYNOPSIS

       makeflow_mpi_starter [options]

DESCRIPTION

       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 --with-mpi-path.

OPTIONS

       When makeflow_mpi_starter 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

COPYRIGHT

       The  Cooperative Computing Tools are Copyright (C) 2005-2019 The University of Notre Dame.  This software
       is distributed under the GNU General Public License.  See the file COPYING for details.

SEE ALSO

       •   Cooperative Computing Tools Documentation

       •   Makeflow User Manual

       •   makeflow(1) makeflow_monitor(1) makeflow_analyze(1) makeflow_viz(1)  makeflow_graph_log(1)  starch(1)
           makeflow_ec2_setup(1) makeflow_ec2_cleanup(1) makeflow_ec2_estimate(1)

           SEE_ALSO_WORKQUEUE

CCTools 8.0.0 DEVELOPMENT                                                                makeflow_mpi_starter(1)