blob: 9ebca8440313fafa82a8f3bf35f047a34d3653a1 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
# Requirements
The `htc_utils.bindings` package requires a working HTCondor installation in your `PATH` in order to function properly.
### Python 2.6.x:
* `argparse` >= 1.2
* `multiprocessing` >= 2.6
### Python 2.7.x ~ 3.x.x:
All dependencies are satisfied by default.
# Installation
### At the system level
```
python setup.py install
```
### Or at the user level
```
python setup.py install --user
```
# HTCondor Bindings
## Job & Submit Classes
This is an example of how to generate and submit simple jobs to a HTCondor cluster using htc_utils.
```
#!python
import random
from htc_utils.bindings import Job, Submit
# Create job object (filename will be "my_neato_condor.job")
job = Job('my_neato_condor')
# Populate initial job attributes
job.attr('getenv', True)
job.attr('executable', '/bin/sleep')
job.attr('arguments', 1)
job.logging('logs', create=True)
job.attr('queue')
# Populate additional sub-attributes (i.e. re-execute job with
# a different set of arguments.
for fileno in range(5):
x = random.Random().randint(2, 5)
job.subattr('arguments', x)
job.subattr('queue')
# Write job file to disk
job.commit()
# Pass our job to the Submit class
submit = Submit(job)
# Send our job to the cluster
submit.execute()
```
### Contents of `my_neato_condor.job`
```
universe = vanilla
getenv = true
executable = /bin/sleep
arguments = 1
notification = Never
priority = 0
transfer_executable = true
should_transfer_files = IF_NEEDED
when_to_transfer_output = ON_EXIT
hold = false
log = logs/condor_$(Cluster).log
output = logs/stdout_$(Cluster)_$(Process).log
error = logs/stderr_$(Cluster)_$(Process).log
queue
arguments = 5
queue
arguments = 2
queue
arguments = 2
queue
arguments = 4
queue
arguments = 4
queue
```
## CLI Components
`htc_utils` provides a wrapper to the `Job` class to aid job creation outside of Python.
### Job example rewritten using `condor_batch`
```
#!bash
condor_batch -n my_neato_condor \
--logging logs \
--logging-create \
--getenv true \
--subarg 5 \
--subarg 2 \
--subarg 2 \
--subarg 4 \
--subarg 4 \
/bin/sleep 1
```
|
