bkr job-submit: Submit job XML to Beaker¶

Synopsis¶

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)