~ubuntu-branches/ubuntu/lucid/euca2ools/lucid-proposed

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

.TH EUCA-RUN-INSTANCES "1" "August 2009" "euca-run-instances     euca-run-instances version: 1.0 (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]

[\-\-addressing addressing] [\-t, \fB\-\-instance\-type\fR instance_type] [\-z, \fB\-\-availability\-zone\fR zone]

[\-\-kernel kernel_id] [\-\-ramdisk ramdisk_id] [\-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\-\-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\-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\-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.

.SH "SEE ALSO"

The full documentation for

.B euca-run-instances

is maintained as a Texinfo manual.  If the

.B info

and

.B euca-run-instances

programs are properly installed at your site, the command

.IP

.B info euca-run-instances

.PP

should give you access to the complete manual.