carta
slurm_submit_workers(1)

slurm_submit_workers1

Submit work_queue_worker to a slurm cluster.

Usage

FCslurm_submit_workers [options] <servername> <port> <num-workers>FT

Overview

FCslurm_submit_workersFT schedules the execution of work_queue_worker(1) 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

History

  • Debian 13 (Trixie): the text shown here
  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)

--scratch-dir since Debian 13 (Trixie); -A since Debian 13 (Trixie); -C since Debian 13 (Trixie); -O since Debian 13 (Trixie); -b since Debian 13 (Trixie); -c since Debian 13 (Trixie); -d since Debian 13 (Trixie); -i since Debian 13 (Trixie); -p since Debian 13 (Trixie); -s since Debian 13 (Trixie); -t since Debian 13 (Trixie); -w since Debian 13 (Trixie); -z since Debian 13 (Trixie).

From coop-computing-tools 1:7.14.5-1+b2 in Debian 13 (Trixie). Parsed by carta from the page's man source.