pegasus-run [-Dproperty=value...][-c propsfile][-d level]
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.
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
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.
- Raises debug level. Each invocation increase the level by 1.
- Enable grid checks to see if your submit machine is GRID enabled.
- 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.
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.
The following files are created, opened or written to:
- This file is located in the rundir. pegasus-run uses this file to find out paths to several other files, properties configurations etc.
- This file is located in the rundir. pegasus-run uses this properties file by default to configure its internal settings.
- 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
pegasus-run reads its properties from several locations.
- The default location for pegasus-run to read the properties from
- properties file provided in the conf option replaces the default properties file used.
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
- The path variable is used to locate binaries for condor-submit-dag, condor-dagman, condor-submit,pegasus-submit-dag, pegasus-dagman and pegasus-monitord
Gaurang Mehta <gmehta at isi dot edu>
Jens-S. Vöckler <voeckler at isi dot edu>
Pegasus Team m[blue]http://pegasus.isi.edum