~ubuntu-branches/ubuntu/natty/euca2ools/natty-201106142030

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.

.TH EUCA-RUN-INSTANCES "1" "July 2010" "euca-run-instances     Version: 1.2 (BSD)" "User Commands"

.SH NAME

euca-run-instances \- Eucalyptus tool: Starts instances.  

.SH DESCRIPTION

Starts instances.

.PP

euca\-run\-instances [\-n, \fB\-\-instance\-count\fR count] [\-g, \fB\-\-group\fR group_name] [\-k, \fB\-\-keypair\fR keyname]

[\-d user_data] [\-f user_data_file] [\-\-addressing addressing] [\-t, \fB\-\-instance\-type\fR instance_type]

[\-z, \fB\-\-availability\-zone\fR zone] [\-\-kernel kernel_id] [\-\-ramdisk ramdisk_id] [\-b block_device_mapping]

[\-\-monitor] [\-s, \fB\-\-subnet\fR subnet_id] [\-\-disable\-api\-termination] [\-\-instanceinitiatedshutdown\-behavior behavior]

[\-h, \fB\-\-help]\fR [\-\-version] [\-\-debug] image_id

.PP

REQUIRED PARAMETERS

.PP

        

image_id                                identifier for the image to run.

.PP

OPTIONAL PARAMETERS

.PP

\fB\-n\fR, \fB\-\-instance\-count\fR                    Number of instances to run.

.PP

        

\fB\-g\fR, \fB\-\-group\fR                             Security group to run the instance under.

.PP

\fB\-k\fR, \fB\-\-keypair\fR                           Name of a (previously created) keypair to associate with this reservation.              

\fB\-d\fR, \fB\-\-user\-data\fR                         User data for instances read from the command line.

.PP

\fB\-f\fR, \fB\-\-user\-data\-file\fR                    User data for instances as a filename.

.PP

\fB\-\-addressing\fR                            Addressing mode (e.g., private).

.PP

\fB\-t\fR, \fB\-\-instance\-type\fR                     VM Image type to run the instance(s) as (default: m1.small).

.PP

\fB\-z\fR, \fB\-\-availability\-zone\fR                 Availability zone to run the instance(s) in.

.PP

\fB\-\-kernel\fR                                Id of the kernel to be used to launch instance(s).

.PP

\fB\-\-ramdisk\fR                               Id of the ramdisk to be used to launch instance(s).

.PP

\fB\-b\fR, \fB\-\-block\-device\-mapping\fR              Block device mapping for the instance(s). Option may be used multiple times.

.PP

\fB\-\-monitor\fR                               Enable monitoring for instance.

.PP

\fB\-s\fR, \fB\-\-subnet\fR                            Amazon VPC subnet ID for the instance.

.PP

\fB\-\-disable\-api\-termination\fR               Disabled termination using API calls.

.PP

\fB\-\-instanceinitiatedshutdown\-behavior\fR    Instance behavior on shutdown (can be 'stop' or 'terminate').

.PP

\fB\-a\fR, \fB\-\-access\-key\fR                User's Access Key ID.

.PP

\fB\-s\fR, \fB\-\-secret\-key\fR                User's Secret Key.

.PP

\fB\-U\fR, \fB\-\-url\fR                       URL of the Cloud to connect to.

.PP

\fB\-\-config\fR                        Read credentials and cloud settings from the

.IP

specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc).

.PP

\fB\-h\fR, \fB\-\-help\fR                      Display this help message.

.PP

\fB\-\-version\fR                       Display the version of this tool.

.PP

\fB\-\-debug\fR                         Turn on debugging.

.PP

Euca2ools will use the environment variables EC2_URL, EC2_ACCESS_KEY, EC2_SECRET_KEY, EC2_CERT, EC2_PRIVATE_KEY, S3_URL, EUCALYPTUS_CERT by default.