sge_submit_workers(1)

NAME

sge_submit_workers - submit work_queue_worker to a SUN Grid Engine (SGE).

SYNOPSIS

sge_submit_workers [options] <servername> <port> <num-workers>
when auto mode is not enabled for the worker, or
sge_submit_workers [options] <num-workers>
when auto mode is enabled for the worker.

DESCRIPTION

sge_submit_workers schedules the execution of work_queue_worker(1) on the SUN Grid Engine (SGE) 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 master 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,--master-name <name>
Name of the preferred master for worker. (auto mode enabled)
-N,--name <name>
Preferred project name for work_queue_worker to connect. (auto mode enabled)
-C,--catalog <catalog>
Set catalog server for work_queue_worker to . 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 master. (default=1s)
-b,--max-backoff <time>
Set maxmimum value for backoff interval when worker fails to connect to a master. (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 master instead of the value in uname.
-O,--os <os>
Set operating system string for the worker to report to master 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 master.
--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.
-j Use job array to submit workers.
-p <parameters>
SGE 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 SGE and connect to a specific master:
sge_submit_workers master.somewhere.edu 9123 10
Submit 10 work_queue_worker instances to run on SGE in auto mode with their preferred project name set to Project_A and abort timeout set to 3600 seconds:
sge_submit_workers -a -t 3600 -M Project_A 10

COPYRIGHT

The Cooperative Computing Tools are Copyright (C) 2003-2004 Douglas Thain and Copyright (C) 2005-2011 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_pool(1)
  • condor_submit_workers(1)
  • sge_submit_workers(1)
  • torque_submit_workers(1)
  • ec2_submit_workers(1)
  • ec2_remove_workers(1)

  • CCTools 4.1.4rc5 released on 04/10/2014