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.
-M,--master-name <name> | |
Set the name of the project this worker should work for. A worker can have multiple projects. | |
-C,--catalog <catalog> | |
Set catalog server to <catalog>. Format: HOSTNAME:PORT | |
-d,--debug <flag> | |
Enable debugging for the given subsystem. Try -d all as a start. | |
-o,--debug-file <file> | |
Send debugging to this file. | |
--debug-max-rotate <bytes> | |
Set the maximum file size of the debug log. If the log exceeds this size, it is renamed to "filename.old" and a new logfile is opened. (default=10M. 0 disables) | |
--debug-release-reset | Debug file will be closed, renamed, and a new one opened after being released from a master. |
-f, --foreman | Enable foreman mode. |
--foreman-port <port[:highport]> | |
Set the port for the foreman to listen on. If <highport> is specified the port is chosen from between <port> and <highport>. | |
-Z,--foreman-port-file <file> | |
Select port to listen to at random and write to this file. Implies --foreman. | |
-F,--fast-abort <mult> | |
Set the fast abort multiplier for foreman (default=disabled). | |
--specify-log <logfile> | |
Send statistics about foreman to this file. | |
-N,--foreman-name <name> | |
Set the project name of this foreman to <project>. If in worker, classic or auto mode, behaves as -M for backwards compatibility. | |
-P,--password <pwfile> | |
Password file for authenticating to the master. | |
-t,--timeout <time> | |
Abort after this amount of idle time. (default=900s) | |
-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 the architecture string the worker reports to its supervisor. (default=the value reported by uname) | |
-O,--os <os> | |
Set the operating system string the worker reports to its supervisor. (default=the value reported by uname) | |
-s,--workdir <path> | |
Set the location where the worker should create its working directory. (default=/tmp) | |
--bandwidth <mbps> | |
Set the maximum bandwidth the foreman will consume in Mbps. (default=unlimited) | |
--volatility <chance> | |
Set the percent chance a worker will decide to shut down every minute. | |
--cores <n> | |
Set the number of cores this worker should use. Set it to 0 to have the worker use all of the available resources. (default=1) | |
--memory <mb> | |
Manually set the amount of memory (in MB) reported by this worker. | |
--disk <mb> | |
Manually set the amount of disk space (in MB) reported by this worker. | |
-v | Show version string. |
-h | Show this help message. |
Foreman mode is enabled by either specifying a port to listen on using the -f <port> option or by setting the mode directly with the --foreman option. The foreman can be directed to advertise its presence on the catalog_server() with the -N <project name> flag, which other workers can use to contact the foreman.
% work_queue_worker master.somewhere.edu 9123To 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 -M project_ATo run work_queue_worker as a foreman working for project_A and advertising itself as foreman_A1 while listening on port 9123:
% work_queue_worker --foreman -M project_A -N foreman_A1 -f 9123