Added condor_submit Quick Reference Guide #905
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,122 @@ | ||||||
| --- | ||||||
| layout: guide | ||||||
| title: "Quick reference: HTCondor Submission commands" | ||||||
| alt_title: "Quick reference: HTCondor Submission commands" | ||||||
| guide: | ||||||
| category: Get started | ||||||
| tag: htc | ||||||
| --- | ||||||
|
|
||||||
| ## Introduction | ||||||
|
|
||||||
| This page lists common HTCondor commands and options for jobs. Users familiar with HTCondor and job submission on CHTC's High Throughput Computing (HTC) system can use this page as a quick reference. For users who are just starting out, we suggest reading the full guides (linked) to understand the full context of each command or option. | ||||||
|
|
||||||
| {% capture content %} | ||||||
| - [Introduction](#introduction) | ||||||
| - [Submit jobs](#submit-jobs) | ||||||
| - [Basic Submit File Options](#basic-submit-file-options) | ||||||
| - [Managing File Transfers in HTCondor](#managing-file-transfers-in-htcondor) | ||||||
| - [Controlling Where Your Job Runs](#controlling-where-your-job-runs) | ||||||
| - [Controlling How Your Job Runs](#controlling-how-your-job-runs) | ||||||
| - [Queue Statement Options](#queue-statement-options) | ||||||
| - [Glossary](#glossary) | ||||||
| - [Related Pages](#related-pages) | ||||||
| {% endcapture %} | ||||||
| {% include /components/directory.html title="Table of Contents" %} | ||||||
|
|
||||||
| > **Please note the following!** | ||||||
| > | ||||||
| > * Bracketed items (`<>`) denote where to place your input. | ||||||
| > Do not include the brackets in your command. | ||||||
| > * All commands should be entered on a single line. | ||||||
|
|
||||||
| ## Submit jobs | ||||||
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
|
||||||
| | Command | Use | Notes and Examples | | ||||||
| | --- | --- |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ||||||
| | `condor_submit` | submits job(s) as specified by `submit_file` | See [monitor your jobs](condor_q) <br><br> **Example:** <br>`condor_submit helloWorld.sub` | | ||||||
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
| | `condor_submit -i <submit_file>` | submits an interactive job as specified by `submit_file` | **Example:** <br>`condor_submit -i helloWorld.sub` | | ||||||
| | `condor_submit <submit_file> -append <attribute>` | appends Condor commands to `submit_file` during submission | Commands are added inplace prior to the `queue` command while leaving the `submit_file` unedited. Can pass `queue` commands as appended, if needed. <br><br> **Example:** <br>`condor_submit helloWorld.sub -append "request_disk = 1GB"` | | ||||||
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
| {:.command-table} | ||||||
|
|
||||||
| ## Basic Submit File Options | ||||||
|
|
||||||
| | Command | Use | Notes and Examples | | ||||||
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
| | --- | --- |----------------------------------------------------------------------------------------------------------------------------------------------------| | ||||||
| | `executable = <executable.sh>` | path to the executable script | The executable script is automatically transferred to the Execution Point (EP) by HTCondor. <br><br> **Example:** <br>`executable = helloWorld.py` | | ||||||
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
| | `arguments = "<args>"` | lists arguments to be passed to the executable as part of the command line | Arguments are wrapped by quotes(") and space separated. <br><br> **Example:** <br>`arguments = "hello world"` | | ||||||
|
||||||
| | `environment = <parameter_list>` | lists environmental variables | Wrapped by quotes(") and space separated. <br><br> **Example:** <br>`environment = "VARIABLE1=Value1 VAR2='hello world'"` | | ||||||
|
||||||
| | `environment = <parameter_list>` | lists environmental variables | Wrapped by quotes(") and space separated. <br><br> **Example:** <br>`environment = "VARIABLE1=Value1 VAR2='hello world'"` | | |
| | `environment = <parameter_list>` | sets additional environmental variables in the job environment | Wrapped by quotes(") and space separated. <br><br> **Example:** <br>`environment = "VARIABLE1=Value1 VAR2='hello world'"` | |
I think this should be in a section called "Additional Options"
There was a problem hiding this comment.
a single line table feels awkward. Should I move it anyways or drop the row entirely?
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
dmora127 marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Update this after making changes.