bkr-job-submit man page

bkr-job-submit — Submit job XML to Beaker

Synopsis

bkr job-submit [options]
[–debug] [–convert] [–combine] [–ignore-missing-tasks]
[--dry-run | --wait]
[<filename>…]

Description

Reads Beaker job XML descriptions and submits them to Beaker.

Specify one or more filenames containing job XML to be submitted. If multiple filenames are given, each one is submitted as a separate job. If no filenames are given, job XML is read from stdin. The special filename ‘-‘ also reads from stdin.

Options

--debug

Legacy option, replaced by ‘–xml’

--xml

Print the job XML before submitting it.

--convert

Attempt to convert legacy RHTS XML to Beaker XML. Use this with --xml and --dry-run to grab the converted XML without submitting it.

--combine

If more than one job XML argument is given, the recipe sets from each job are extracted and combined into a single job before submission.

--ignore-missing-tasks

If the job refers to tasks which are not known to the scheduler, silently discard these from the recipe. Normally this is a fatal error which prevents submission of the job.

--dry-run

Do not submit the job(s) to Beaker. Use this with --xml to see what would be submitted.

--wait

Watch the newly submitted jobs for state changes and print them to stdout. The command will not exit until all submitted jobs have finished. See bkr-job-watch(1).

--job-owner <username>

Submit the job on behalf of <username>. The submitted job will be owned by <username> rather than the submitting user.

The existing user attribute in the job XML will be overridden if set.

The submitting user must be a submission delegate of <username>. Users can add other users as submission delegates on their Preferences page in Beaker’s web UI.

Common bkr options are described in the Options section of bkr(1).

Exit Status

1 if any jobs failed submission or execution, otherwise zero.

Examples

Submit a job and watch its progress on stdout:

bkr job-submit --wait my-beaker-job.xml

See Also

bkr(1)

Author

The Beaker team <beaker-devel@lists.fedorahosted.org>

Referenced By

bkr(1).

Nov 17, 2017 24.5 Beaker