plucky (1) torque_submit_workers.1.gz

Provided by: coop-computing-tools_7.14.5-1_amd64 bug

NAME
       torque_submit_workers - submit work_queue_worker to a Torque cluster.


SYNOPSIS
       torque_submit_workers [options] <servername> <port> <num-workers>


DESCRIPTION
       torque_submit_workers  schedules the execution of work_queue_worker(1) on the Torque 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.

        -j <> Use job array to submit workers.

        -p <parameters>
              Torque 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 Torque and connect to a specific manager:

               torque_submit_workers manager.somewhere.edu 9123 10

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

               torque_submit_workers -a -t 3600 -M Project_A 10


       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_status(1)     work_queue_factory(1)      condor_submit_workers(1)
           uge_submit_workers(1) torque_submit_workers(1)