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

-a Enable auto mode for work_queue_worker.
-s Run as a shared worker.
-N <name>
Preferred project name for work_queue_worker to connect.
-C <catalog>
Set catalog server for work_queue_worker to . format: HOSTNAME:PORT.
-t <seconds>
Abort work_queue_worker after this amount of idle time (default=900s).
-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 -N Project_A key_1 key_1.priv 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 3.7.3 released on 06/12/2013