---
name: "slurm_submit_workers"
section: "1"
platform: "linux"
package: "coop-computing-tools"
version: "1:7.14.5-1+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/slurm_submit_workers"
---

# slurm\_submit\_workers(1)

submit work\_queue\_worker to a SLURM cluster.

## NAME

**slurm\_submit\_workers** - submit work\_queue\_worker to a SLURM cluster.

## SYNOPSIS

FCslurm\_submit\_workers \[options\] *\<servername\>* *\<port\>* *\<num-workers\>*FT

## DESCRIPTION

FCslurm\_submit\_workersFT schedules the execution of **[work\_queue\_worker(1)](/work_queue_worker/1.md)** on the SLURM batch system through its job submission interface, qsub. The number of **work\_queue\_worker** scheduled and run is given by the **num-workers** argument.

The **servername** and **port** arguments specify the hostname and port number of the manager for the work\_queue\_worker to connect. These two arguments become optional when the auto mode option is specified for work\_queue\_worker.

## OPTIONS

- **-M *\<name\>***

  Name of the preferred manager for worker.

- **-c *\<cores\>***

  Set the number of cores each worker should use (0=auto). (default=1)

- **-C *\<catalog\>***

  Set catalog server for work\_queue\_worker to *\<catalog\>*. *\<catalog\>* format: HOSTNAME:PORT.

- **-C *\<catalog\>***

  Set catalog server for work\_queue\_worker to *\<catalog\>*. *\<catalog\>* format: HOSTNAME:PORT.

- **-t *\<seconds\>***

  Abort work\_queue\_worker after this amount of idle time (default=900s).

- **-d *\<subsystem\>***

  Enable debugging on worker for this subsystem (try -d all to start).

- **-w *\<size\>***

  Set TCP window size

- **-i *\<time\>***

  Set initial value for backoff interval when worker fails to connect to a manager. (default=1s)

- **-b *\<time\>***

  Set maxmimum value for backoff interval when worker fails to connect to a manager. (default=60s)

- **-z *\<size\>***

  Set available disk space threshold (in MB). When exceeded worker will clean up and reconnect. (default=100MB)

- **-A *\<arch\>***

  Set architecture string for the worker to report to manager instead of the value in uname.

- **-O *\<os\>***

  Set operating system string for the worker to report to manager instead of the value in uname.

- **-s *\<path\>***

  Set the location for creating the working directory of the worker.

- **-p *\<parameters\>***

  SLURM qsub parameters.

- **--scratch-dir=*\<path\>***

  Set the scratch directory location created on the local machine. (default=${USER}-workers)

- **-h**

  Show help message.

## EXIT STATUS

On success, returns zero. On failure, returns non-zero.

## EXAMPLES

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

```

```

-

  slurm\_submit\_workers manager.somewhere.edu 9123 10

Submit 10 work\_queue\_worker instances to run on SLURM in auto mode with their preferred project name set to Project\_A and abort timeout set to 3600 seconds:

```

```

-

  slurm\_submit\_workers -a -t 3600 -M Project\_A 10

## COPYRIGHT

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

## SEE ALSO

- •

  **Cooperative Computing Tools Documentation**

- •

  **Work Queue User Manual**

- •

  **[work\_queue\_worker(1)](/work_queue_worker/1.md)** **[work\_queue\_status(1)](/work_queue_status/1.md)** **[work\_queue\_factory(1)](/work_queue_factory/1.md)** **[condor\_submit\_workers(1)](/condor_submit_workers/1.md)** **[uge\_submit\_workers(1)](/uge_submit_workers/1.md)** **[torque\_submit\_workers(1)](/torque_submit_workers/1.md)**