NAME

       pegasus-run - executes a workflow that has been planned using *pegasus-plan*.

SYNOPSIS

       pegasus-run [-Dproperty=value...][-c propsfile][-d level]
                   [-v][--grid*][rundir]

DESCRIPTION

       The pegasus-run command executes a workflow that has been planned using pegasus-plan. By
       default pegasus-run can be invoked either in the planned directory with no options and
       arguments or just the full path to the run directory. pegasus-run also can be used to
       resubmit a failed workflow by running the same command again.

OPTIONS

       By default pegasus-run does not require any options or arguments if invoked from within
       the planned workflow directory. If running the command outside the workflow directory then
       a full path to the workflow directory needs to be specified.

       pegasus-run takes the following options

       -Dproperty=value
           The -D option allows an advanced user to override certain properties which influence
           pegasus-run. One may set several CLI properties by giving this option multiple times.

           The -D option(s) must be the first option on the command line. CLI properties take
           precedence over the file-based properties of the same key.

           See the PROPERTIES section below.

       -c propsfile, --conf propsfile
           Provide a property file to override the default Pegasus properties file from the
           planning directory. Ordinary users do not need to use this option unless the
           specifically want to override several properties

       -d level, --debug level
           Set the debug level for the client. Default is 0.

       -v, --verbose
           Raises debug level. Each invocation increase the level by 1.

       --grid
           Enable grid checks to see if your submit machine is GRID enabled.

       rundir
           Is the full qualified path to the base directory containing the planned workflow DAG
           and submit files. This is optional if the pegasus-run command is invoked from within
           the run directory.

RETURN VALUE

       If the workflow is submitted for execution pegasus-run returns with an exit code of 0.
       However, in case of error, a non-zero return value indicates problems. An error message
       clearly marks the cause.

FILES

       The following files are created, opened or written to:

       braindump
           This file is located in the rundir. pegasus-run uses this file to find out paths to
           several other files, properties configurations etc.

       pegasus.?????????.properties
           This file is located in the rundir. pegasus-run uses this properties file by default
           to configure its internal settings.

       workflowname.dag
           pegasus-run uses the workflowname.dag or workflowname.sh file and submits it either to
           condor for execution or runs it locally in a shell environment

PROPERTIES

       pegasus-run reads its properties from several locations.

       RUNDIR/pegasus.??????????.properties
           The default location for pegasus-run to read the properties from

       --conf propfile
           properties file provided in the conf option replaces the default properties file used.

       $HOME/.pegasusrc
           will be used if neither default rundir properties or --conf propertiesfile are found.

           Additionally properties can be provided individually using the -Dpropkey=propvalue
           option on the command line before all other options. These properties will override
           properties provided using either --conf or RUNDIR/pegasus.???????.properties or the
           $HOME/.pegasusrc

           The merge logic is CONF PROPERTIES || DEFAULT RUNDIR PROPERTIES || PEGASUSRC overriden
           by Command line properties

ENVIRONMENT VARIABLES

       PATH
           The path variable is used to locate binaries for condor-submit-dag, condor-dagman,
           condor-submit,pegasus-submit-dag, pegasus-dagman and pegasus-monitord

SEE ALSO

       pegasus-plan(1)

AUTHORS

       Gaurang Mehta <gmehta at isi dot edu>

       Jens-S. Vöckler <voeckler at isi dot edu>

       Pegasus Team http://pegasus.isi.edu

                                            02/28/2012                             PEGASUS-RUN(1)