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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
.. _root_install_macos:
macOS (as root)
===============
Installing HTCondor on macOS as root user is a multi-step process.
For a multi-machine HTCondor pool, information about the roles each
machine will play can be found here: :doc:`admin-quick-start`.
Note that the ``get_htcondor`` tool cannot perform the installation
steps on macOS at present. You must follow the instructions below.
Note that all of the following commands must be run as root, except for
downloading and extracting the tarball.
The condor Service Account
--------------------------
The first step is to create a service account under which the HTCondor
daemons will run.
The commands that specify a ``PrimaryGroupID`` or ``UniqueID`` may fail with an
error that includes ``eDSRecordAlreadyExists``.
If that occurs, you will have to retry the command with a different id number
(other than ``300``).
.. code-block:: shell
dscl . -create /Groups/condor
dscl . -create /Groups/condor PrimaryGroupID 300
dscl . -create /Groups/condor RealName 'Condor Group'
dscl . -create /Groups/condor passwd '*'
dscl . -create /Users/condor
dscl . -create /Users/condor UniqueID 300
dscl . -create /Users/condor passwd '*'
dscl . -create /Users/condor PrimaryGroupID 300
dscl . -create /Users/condor UserShell /usr/bin/false
dscl . -create /Users/condor RealName 'Condor User'
dscl . -create /Users/condor NFSHomeDirectory /var/empty
Download
--------
The next step is to download HTCondor.
If you want to select a specific version of HTCondor, you can download
the corresponding file from
`our website <https://research.cs.wisc.edu/htcondor/tarball/>`_.
Otherwise, we recommend using our download script, as follows.
.. code-block:: shell
cd
curl -fsSL https://get.htcondor.org | /bin/bash -s -- --download
If you use a web browser to download a tarball from our web site, then
the OS will mark the file as quarantined. All binaries extracted from
the tarball will be similarly marked. The OS will refuse to run any
binaries that are quarantined. You can remove the quarantine marking
from the tarball before extracting it, like so:
.. code-block:: shell
xattr -d com.apple.quarantine condor-10.7.1-x86_64_macOS13-stripped.tar.gz
Install
-------
Unpack the tarball.
.. code-block:: shell
mkdir /usr/local/condor
tar -x -C /usr/local/condor --strip-components 1 -f condor.tar.gz
You won't need ``condor.tar.gz`` again, so you can remove it now if you wish.
Set up the log directory and default configuration files.
.. code-block:: shell
cd /usr/local/condor
mkdir -p local/log
mkdir -p local/config.d
cp etc/examples/condor_config etc/condor_config
cp etc/examples/00-htcondor-9.0.config local/config.d
If you are setting up a single-machine pool, then run the following
command to finish the configuration.
.. code-block:: shell
cp etc/examples/00-minicondor local/config.d
If you are setting up part of a multi-machine pool, then you'll have to
make some other configuration changes, which we don't cover here.
Next, fix up the permissions of the the installed files.
.. code-block:: shell
chown -R root:wheel /usr/local/condor
chown -R condor:condor /usr/local/condor/local/log
Finally, make the configuration file available at one of the well-known
locations for the tools to find.
.. code-block:: shell
mkdir -p /etc/condor
ln -s /usr/local/condor/etc/condor_config /etc/condor
Start the Daemons
-----------------
Now, register HTCondor has a service managed by launchd and start up
the daemons.
.. code-block:: shell
cp /usr/local/condor/etc/examples/condor.plist /Library/LaunchDaemons
launchctl load /Library/LaunchDaemons/condor.plist
launchctl start condor
Using HTCondor
--------------
You'll want to add the HTCondor ``bin`` and ``sbin`` directories to your
``PATH`` environment variable.
.. code-block:: shell
export PATH=$PATH:/usr/local/condor/bin:/usr/local/condor/sbin
If you want to use the Python bindings for HTCondor, you'll want to add
them to your PYTHONPATH.
.. code-block:: shell
export PYTHONPATH="/usr/local/condor/lib/python3${PYTHONPATH+":"}${PYTHONPATH-}"
.. include:: minicondor-test-and-quickstart.include
|
