work_queue_worker(1)

NAME

work_queue_worker - worker process for executing tasks dispatched through Work Queue

SYNOPSIS

work_queue_worker [options] <masterhost> <port>

DESCRIPTION

work_queue_worker is the worker process for executing tasks dispatched from a master application built using the Work Queue API. work_queue_worker connects to the master application, accepts, runs, and returns tasks dispatched to it.

The masterhost and port arguments specify the hostname and port number of the master application for work_queue_worker to connect. These two arguments become optional when the auto mode option is specified.

work_queue_worker can be run locally or deployed remotely on any of the grid or cloud computing environments such as SGE, Amazon EC2, Condor using sge_submit_workers(1), ec2_submit_workers(1), condor_submit_workers(1) respectively.

OPTIONS

`-a`	Enable auto mode. In this mode the worker would ask a catalog server for available masters.
`-C <catalog>`
	Set catalog server to <catalog>. Format: HOSTNAME:PORT
`-s`	Run as a shared worker. By default the worker would only work on preferred projects.
`-d <subsystem>`
	Enable debugging for the given subsystem. Try -d all as a start.
`-o <file>`
	Send debugging to this file.
`-N <project>`
	Set the project name to <project>.
`-t <time>`
	Abort after this amount of idle time. (default=900s)
`-w <size>`
	Set TCP window size.
`-i <time>`
	Set initial value for backoff interval when worker fails to connect to a master. (default=1s)
`-b <time>`
	Set maxmimum value for backoff interval when worker fails to connect to a master. (default=60s)
`-z <size>`
	Set available disk space threshold (in MB). When exceeded worker will clean up and reconnect. (default=100MB)
`-v`	Show version string.
`-h`	Show this help message.

EXIT STATUS

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

EXAMPLES

To run work_queue_worker to join a specific master process running on host master.somewhere.edu port 9123:

% work_queue_worker master.somewhere.edu 9123

To run work_queue_worker in auto mode with debugging turned on for all subsystems and to accept tasks only from a master application with project name set to project_A:

% work_queue_worker -a -d all -N project_A

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.