---
name: "uge_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/uge_submit_workers"
---

# uge\_submit\_workers(1)

submit work\_queue\_worker to a Univa Grid Engine (UGE) cluster.

## NAME

**uge\_submit\_workers** - submit work\_queue\_worker to a Univa Grid Engine (UGE) cluster.

## SYNOPSIS

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

when auto mode is not enabled for the worker, or

FCuge\_submit\_workers \[options\] *\<num-workers\>*FT

when auto mode is enabled for the worker.

## DESCRIPTION

FCuge\_submit\_workersFT schedules the execution of **[work\_queue\_worker(1)](/work_queue_worker/1.md)** on the Univa Grid Engine (UGE) 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,--manager-name=*\<name\>***

  Name of the preferred manager for worker. (auto mode enabled)

- **-C,--catalog=*\<catalog\>***

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

- **-C,--catalog=*\<catalog\>***

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

- **-t,--timeout=*\<seconds\>***

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

- **-d,--debug=*\<subsystem\>***

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

- **-w,--tcp-window-size=*\<size\>***

  Set TCP window size

- **-i,--min-backoff=*\<time\>***

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

- **-b,--max-backoff=*\<time\>***

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

- **-z,--disk-threshold=*\<size\>***

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

- **-A,--arch=*\<arch\>***

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

- **-O,--os=*\<os\>***

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

- **-s,--workdir=*\<path\>***

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

- **-P,----password=*\<file\>***

  Password file to authenticate workers to manager.

- **--cores=*\<cores\>***

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

- **--memory=*\<size\>***

  Manually set the amonut of memory (in MB) reported by this worker.

- **--disk=*\<size\>***

  Manually set the amount of disk (in MB) reported by this worker.

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

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

- **-j**

  Use job array to submit workers.

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

  UGE qsub parameters.

- **-h,--help**

  Show help message.

## EXIT STATUS

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

## EXAMPLES

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

```

```

-

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

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

```

```

-

  uge\_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)**