.TH "condor_submit_workers" 1 "" "CCTools 8.0.0 DEVELOPMENT" "Cooperative Computing Tools"

.SH NAME
.LP
\fBcondor_submit_workers\fP - submit work_queue_worker to the Condor grid.

.SH SYNOPSIS
.LP
.fam C
.nf
.nh
.IP "" 8
\FC\fBcondor_submit_workers [options] <servername> <port> <num-workers>\fP\FT
.fi
.hy
.fam
.P

or

.fam C
.nf
.nh
.IP "" 8
\FC\fBcondor_submit_workers [options] --manager-name <name> <num-workers>\fP\FT
.fi
.hy
.fam
.P


.SH DESCRIPTION
.LP
\FCcondor_submit_workers\FT schedules the execution of \fBwork_queue_worker(1)\fP
on a grid managed by Condor through its job submission interface, condor_submit.
The number of \fBwork_queue_worker\fP scheduled and run is given by the \fBnum-workers\fP
argument.

The \fBservername\fP and \fBport\fP arguments specify the hostname and port number of the
manager for the work_queue_worker to connect. Alternatively, this information can be obtained from
the catalog server by specifying the name of the work queue using the --manager-name parameter.

.SH OPTIONS
.LP
.LP
.TP
\fB-M\fP, \fB-\-manager-name\fP=\fI<name>\fP
.
Name of the preferred manager for worker.
.TP
\fB-N\fP, \fB-\-name\fP=\fI<name>\fP
.
Same as -M (backwards compatibility).
.TP
\fB-C\fP, \fB-\-catalog\fP=\fI<catalog>\fP
.
Set catalog server to <catalog>. <catalog> format: HOSTNAME:PORT.
.TP
\fB-t\fP, \fB-\-timeout\fP=\fI<time>\fP
.
Abort after this amount of idle time (default=900s).
.TP
\fB-d\fP, \fB-\-debug\fP=\fI<subsystem>\fP
.
Enable debugging on worker for this subsystem (try -d all to start).
.TP
\fB-w\fP, \fB-\-tcp-window-size\fP=\fI<size>\fP
.
Set TCP window size
.TP
\fB-i\fP, \fB-\-min-backoff\fP=\fI<time>\fP
.
Set initial value for backoff interval when worker fails to connect to a manager. (default=1s)
.TP
\fB-b\fP, \fB-\-max-backoff\fP=\fI<time>\fP
.
Set maxmimum value for backoff interval when worker fails to connect to a manager. (default=60s)
.TP
\fB-z\fP, \fB-\-disk-threshold\fP=\fI<size>\fP
.
Set available disk space threshold (in MB). When exceeded worker will clean up and reconnect. (default=100MB)
.TP
\fB-A\fP, \fB-\-arch\fP=\fI<arch>\fP
.
Set architecture string for the worker to report to manager instead of the value in uname.
.TP
\fB-O\fP, \fB-\-os\fP=\fI<os>\fP
.
Set operating system string for the worker to report to manager instead of the value in uname.
.TP
\fB-s\fP, \fB-\-workdir\fP=\fI<path>\fP
.
Set the location for creating the working directory of the worker.
.TP
\fB-P\fP, \fB-\-password\fP=\fI<file>\fP
.
Password file to authenticate workers to manager.
.TP
\fB-E\fP, \fB-\-worker-options\fP=\fI<<str>>\fP
.
Extra options passed to work_queue_worker

.TP
.BI \ --cores \ <cores>
.
Set the number of cores each worker should use (0=auto). (default=1)
.TP
.BI \ --memory \ <size>
.
Manually set the amonut of memory (in MB) reported by this worker.
.TP
.BI \ --disk \ <size>
.
Manually set the amount of disk (in MB) reported by this worker.

.TP
\fB-r\fP, \fB-\-requirements\fP=\fI<<reqs>>\fP
.
Condor requirements expression.
.TP
.BI \ --class-ad \ <<ad>>
.
Extra condor class ad. May be specified multiple times.
.TP
.B \ --autosize
.
Condor will automatically size the worker to the slot.
.TP
.BI \ --docker-universe \ <<image>>
.
Run worker inside <image> using condor's docker universe

.TP
.B \ -h,--help
.
Show help message.




.SH EXIT STATUS
.LP
On success, returns zero. On failure, returns non-zero.

.SH EXAMPLES
.LP

Submit 10 worker instances to run on Condor and connect to a specific manager:

.fam C
.nf
.nh
.IP "" 8
condor_submit_workers manager.somewhere.edu 9123 10
.fi
.hy
.fam
.P

Submit 10 work_queue_worker instances to run on Condor in auto mode with their
preferred project name set to Project_A and abort timeout set to 3600 seconds:

.fam C
.nf
.nh
.IP "" 8
condor_submit_workers -a -t 3600 -M Project_A 10
.fi
.hy
.fam
.P

.SH COPYRIGHT
.LP
The Cooperative Computing Tools are Copyright (C) 2005-2019 The University of Notre Dame.  This software is distributed under the GNU General Public License.  See the file COPYING for details.

.SH SEE ALSO
.LP

.IP \(bu 4
\fBCooperative Computing Tools Documentation\fP
.IP \(bu 4
\fBWork Queue User Manual\fP
.IP \(bu 4
\fBwork_queue_worker(1)\fP \fBwork_queue_status(1)\fP \fBwork_queue_factory(1)\fP \fBcondor_submit_workers(1)\fP \fBsge_submit_workers(1)\fP \fBtorque_submit_workers(1)\fP