ec2_submit_workers(1)

NAME

ec2_submit_workers - submit and run work_queue_worker on the Amazon EC2 service.

SYNOPSIS

ec2_submit_workers [options] <servername> <port> <EC2-key-name> <EC2-key-file> <num-workers>

DESCRIPTION

ec2_submit_workers submits and runs work_queue_worker(1) on the Amazon EC2 service. It calls EC2-run-instances and EC2-describe-instances that are part of the EC2 API tools to create EC2 instances and run work_queue_worker on them. The number of EC2 instances created is given by the num-workers argument since each instance runs one work_queue_worker. 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. The EC2-key-name argument specifies the name of the key to use in authenticating to the EC2 service. The EC2-key-file gives the path of the file containing the (private) key.

OPTIONS

-M Name of the preferred master for worker.
-N <name>
Same as -M (backwards compatibility).
-c <cores>
Set the number of cores each worker should use (0=auto). (default=1)
-C <catalog>
Set catalog server to . 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 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)
-A <arch>
Set architecture string for the worker to report to master instead of the value in uname.
-O <os>
Set operating system string for the worker to report to master instead of the value in uname.
-s <path>
Set the location for creating the working directory of the worker.
-I <image_id>
EC2 OS image ID. Default = ami-fa01f193 (Ubuntu 10.04 x86_64).
-Z <instance_size>
EC2 instance size. Default = m1.large.
-p <parameters>
EC2-run-instances parameters.
-h Show help message.

EXIT STATUS

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

EXAMPLES

Submit 10 work_queue_worker instances to run on EC2 service using key_1 as the authentication key whose private key string is found in key_1.priv. Run work_queue_worker in auto mode with the preferred project name set to Project_A and abort timeout set to 3600 seconds:
ec2_submit_workers -a -t 3600 -M Project_A key_1 key_1.priv 10

COPYRIGHT

The Cooperative Computing Tools are Copyright (C) 2003-2004 Douglas Thain and Copyright (C) 2005-2015 The University of Notre Dame. This software is distributed under the GNU General Public License. See the file COPYING for details.

SEE ALSO


CCTools 6.1.8 FINAL from source released on