eclat-mkinst, eclat-run-instances − launch new EC2 instances


eclat mkinst [−a IFACE] [−d STRING] [−f FILE] [−g STRING] [−k ID] [−m DEV=SPEC] [−n N] [−p NAME] [−s ID] [−t TYPE] [−z ZONE] [−−data=STRING] [−−data−file=FILE] [−−devmap=DEV=SPEC] [−−block−device−mapping=DEV=SPEC] [−−disable−api−termination] [−−ebs−optimized] [−−iam−profile=NAME] [−−kernel=ID] [−−keypair=ID] [−−monitor] [−−network−interface=IFACE] [−−iface=IFACE] [−−number−secondary−ip=N] [−−secondary−private−ip−address−count=N] [−−placement−group=NAME] [−−private−ip−address=IP] [−−ramdisk=ID] [−−secondary−ip=IP] [−−secondary−private−ip−address=IP] [−−security−group=STRING] [−−shutdown=stop|terminate] [−−instance−initiated−shutdown−behavior=stop|terminate] [−−subnet=ID] [−−tenancy=STRING] [−−type=TYPE] [−−instance−type=TYPE] [−−zone=ZONE] [−−availability−zone=ZONE] AMI-ID

eclat mkinst −−help


The mkinst command launches one or more EC2 instances from an existing AMI identified by the AMI-ID argument. The number of instances to launch is determined by the −n option. In its absense, one instance will be launched.

If ID mapping is enabled (see the section MAPS in eclat(1)), the ImageId map is used to translate AMI-ID to the corresponding AMI identifier.

Options supply additional details for the instances to be created.


−a, −−network−interface, −−iface=IFACE

Specify the network attachment for a VPC instance.

−d, −−data=STRING

User data to pass to the instance.


Disable API termination.


Optimize the instances for EBS I/O.

−f, −−data−file=FILE

Read user data from FILE.

−g, −−security−group=STRING

The name of the security group.

−k, −−keypair=ID

Key pair name.


Select kernel ID.

−m, −−devmap, −−block−device−mapping=DEV=SPEC

Set block device mapping. The DEV part is the device name of the physical device on the instance to map. The SPEC sets the mapping specification and can be one of:


Disable the existing mapping. E.g. −m /dev/xvdb=none disables the mapping for the device /dev/xvdb.


Map an instance store volume to the device. E.g. −m /dev/xvdb=ephemeral1.


Specifies an EBS volume to be mapped to the device. The snapshot−id specifies the ID of the snapshot to create the volume from, volume−size gives the desired size of the volume in gigabytes. The DOT parameter (delete on termination) specifies whether the device should be deleted after the instance is terminated. Possible values are true and false. The last parameter defines the volume type. The value standard instructs Amazon to create a standard volume. This is the default. To create a provisioned IOPS volume, specify io1. In that case you can also supply the number of IOPS that the volume supports in the iops argument. For example, −m /dev/xvdf=snap-12345abc::false:io1:500.


Enable monitoring.

−n N

Number of instances to launch.

−−number−secondary−ip, −−secondary−private−ip−address−count=N

Number of secondary IP addresses to assign.

−p, −−iam−profile=NAME

IAM instance profile to associate with the launched instances.


Name of the placement group.


Assign a specific private IP to the VPC instance.


Select ramdisk ID.

−s, −−subnet=ID

Subnet to launch the instance into.

−−secondary−ip, −−secondary−private−ip−address=IP

Assign the IP as a secondary private IP address.

−−shutdown, −−instance−initiated−shutdown−behavior=stop|terminate

What to do on instance shutdown.

−t, −−type, −−instance−type=TYPE

Instance type.


Placement tenancy.

−z, −−zone, −−availability−zone=ZONE

Set availablility zone.


On success, the command outputs detailed description of each created instance in the same format as the eclat-lsinst(1) command


eclat(1), eclat−lsiattr(1), eclat−lsinst(1), eclat−lsistat(1), eclat−reboot(1), eclat−setiattr(1), eclat−start(1), eclat−stop(1).


Sergey Poznyakoff


Report bugs to <bug−>.


Copyright © 2012-2015 Sergey Poznyakoff
License GPLv3+: GNU GPL version 3 or later <>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.