EUCA2OOLS(1)

NAME
euca2ools - Starts instances.

DESCRIPTION
Starts instances.

euca-run-instances [-A, --access-key <access_key> ][-S, --secret-key

    <secret_key> ][--config <config_path> ][--debug][--debugger][-h, --help][--region <region_name> ][-U, --url <url> ][--version][--euca-auth][-n, --instancecount <count> ][-g, --group <group_name> ][-k, --key <keyname> ][-d, --user-data <user_data> ][--user-data-force <user_data_force> ][-f, --user-data-file <user_data_file> ][--addressing <addressing> ][-t, --instance-type <instance_type> ][--kernel <kernel> ][--ramdisk <ramdisk> ][-b, --block-device-mapping <block_device_mapping> ][--monitor][-s, --subnet <subnet> ][-z, --availability-zone <zone> ] image_id

REQUIRED PARAMETERS

image_id
    ID of the image to run.

OPTIONAL PARAMETERS

-A,--access-key
    User's Access Key ID.

-S,--secret-key
    User's Secret Key.

--config
    Read credentials and cloud settings from the specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc).

--debug
    Turn on debugging output.

--debugger
    Enable interactive debugger on error

-h,--help
    Display this help message.

--region
    region to direct requests to

-U,--url
    URL of the Cloud to connect to.

--version
    Display the version of this tool.

--euca-auth
    Use NC authentication mode

-n,--instance-count
    Number of instances to run.

-g,--group
    Security group to run the instance in.

-k,--key
    Name of a keypair.

-d,--user-data
    User data to pass to the instance.

--user-data-force
    Just like --user-data, but ignore any checks.

-f,--user-data-file
    File containing user data to pass to the instance.

--addressing
    Deprecated.

-t,--instance-type
    VM Image type to run the instance as.

--kernel
    ID of the kernel to be used.

--ramdisk
    ID of the ramdisk to be used.

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

--monitor
    Enable monitoring for the instance.

-s,--subnet
    Amazon VPC subnet ID for the instance.

-z,--availability-zone
    availability zone to run the instance in