Collapse AllExpand All

eustore-install-image

Installs an image on your cloud. If you don’t have administrator credentials, you can install an image using the –kernel and –ramdisk options to refer to a kernel id and ramdisk ID already installed on the cloud. Eualyptus will ignore the kernel and ramdisk bundled with the image and refer to the previously uploaded ones.

Syntax

eustore-install-image -i image_name [-b bucket_name | 
    	-t tarball] [-s description] [-a architecture]
    	[-p prefix] [-k kernel_type] [-d directory] 
    	[--kernel] [--ramdisk]

Options

Option Description Required
-i image_name, --image_name=image_name Name of the image to install Yes
-b bucket, --bucket=bucket Specify the bucket to store the images in. You must specify a bucket if you don't specify a local image tarball. Conditional
-t tarball, --tarball=tarball Name local image tarball to install from. You must specify a local tarball if you don't specify a bucket. Conditional
-s description, --description=description Description of image, mostly used with -t option No
-a architecture, --architecture=architecture Use with the -t option.
Valid values: i386 | x86_64
No
-p prefix, --prefix=prefix Prefix to use when naming the image, mostly used with -t option No
-k kernel_type, --kernel_type=kernel_type Kernel type you're using. This option is required if you use the kernel option.
Valid values: xen | kvm
Conditional
-d directory, --dir=directory Specify a temporary directory for large files No
--kernel=kernel Override bundled kernel with one already installed No
--ramdisk=ramdisk Override bundled ramdisk with one already installed No
-y, --yes Answers yes to questions during installation. Eucalyptus has a check-in tool that helps prevent duplicate image/kernel/ramdisk installs. If there is one of the components already installed, Eucalyputus prompts the user to use the existing one (yes), or install a new one. No

Common Options

Option Description
--region=region Region to direct requests to.
-U url,--url=url Override service URL with this value
-I access_key_id, --access-key=access_key_id Override configured access key ID with this value
-S secret_key, --secret-key=secret_key Override configured secret key with this value
-D, --debug Prints what the command sends to the server and what it receives from the server. Use when you're trying to debug Euca2ools.
--debugger Enable interactive debugger on error
-h,--help Display the manual page for the command.
--version Display the version of this tool

Output

Eucalyptus generates the status of the install process.

Example

The following example shows an installation using an image from a bucket.
eustore-install-image -i 3235725435 -b myimages
Downloading Image :  CentOS 6 1.3GB root, Single Kernel
0-----1-----2-----3-----4-----5-----6-----7-----8-----9-----10
##############################################################

Checking image bundle
Unbundling image
tar root = euca-centos-2012.1.14-x86_64
path = euca-centos-2012.1.14-x86_64
path = euca-centos-2012.1.14-x86_64/initrd.img-2.6.32-5-amd64
Bundling/uploading ramdisk
Checking image
...
The following example shows an installation using an image from a local tarball.
eustore-install-image -t /tmp/euca-centos-5.8-2012.05.14-x86_64.tgz -b images -s "centos 5.8 image" -k kvm -a x86_64