.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH EUCA-INSTALL-IMAGE "1" "March 2016" "euca2ools 3.3" "User Commands"
.SH NAME
euca-install-image \- Bundle, upload and register an image into the cloud
.SH SYNOPSIS
euca\-install\-image \fB\-n\fR NAME [\-\-description DESCRIPTION]
.TP
[\-\-max\-pending\-parts MAX_PENDING_PARTS]
[\-\-virtualization\-type {paravirtual,hvm}]
[\-\-platform windows] [\-\-ec2\-url EC2_URL] \fB\-i\fR FILE
[\-p PREFIX] [\-d DIR] \fB\-r\fR
{i386,x86_64,armhf,ppc,ppc64,ppc64le} [\-k FILE]
[\-c FILE] [\-\-ec2cert FILE] [\-u ACCOUNT]
[\-\-kernel IMAGE] [\-\-ramdisk IMAGE]
[\-\-bootstrap\-url BOOTSTRAP_URL]
[\-B VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,...]
[\-\-productcodes CODE1,CODE2,...]
[\-\-image\-size IMAGE_SIZE] \fB\-b\fR BUCKET[/PREFIX]
[\-\-acl {public\-read,aws\-exec\-read,ec2\-bundle\-read}]
[\-\-upload\-policy POLICY | \fB\-\-upload\-policy\-file\fR FILE]
[\-\-upload\-policy\-signature SIGNATURE]
[\-\-location LOCATION] [\-\-retry]
[\-\-progress | \fB\-\-no\-progress]\fR [\-\-show\-empty\-fields]
[\-U URL] [\-\-region USER@REGION] [\-I KEY_ID] [\-S KEY]
[\-\-security\-token TOKEN] [\-\-debug] [\-\-debugger]
[\-\-version] [\-h]
.SH DESCRIPTION
Bundle, upload and register an image into the cloud
.SS "optional arguments:"
.TP
\fB\-n\fR NAME, \fB\-\-name\fR NAME
name of the new image (required)
.TP
\fB\-\-description\fR DESCRIPTION
description of the new image
.TP
\fB\-\-max\-pending\-parts\fR MAX_PENDING_PARTS
pause the bundling process when more than this number
of parts are waiting to be uploaded (default: 2)
.TP
\fB\-\-virtualization\-type\fR {paravirtual,hvm}
virtualization type for the new image
.TP
\fB\-\-platform\fR windows
[Privileged] the new image's platform (windows)
.TP
\fB\-\-ec2\-url\fR EC2_URL
compute service endpoint URL
.TP
\fB\-i\fR FILE, \fB\-\-image\fR FILE
file containing the image to bundle (required)
.TP
\fB\-p\fR PREFIX, \fB\-\-prefix\fR PREFIX
the file name prefix to give the bundle's files
(required when bundling stdin; otherwise defaults to
the image's file name)
.TP
\fB\-d\fR DIR, \fB\-\-destination\fR DIR
location to place the bundle's files (default: dir
named by TMPDIR, TEMP, or TMP environment variables,
or otherwise \fI\,/var/tmp\/\fP)
.TP
\fB\-r\fR {i386,x86_64,armhf,ppc,ppc64,ppc64le}, \fB\-\-arch\fR {i386,x86_64,armhf,ppc,ppc64,ppc64le}
the image's architecture (required)
.TP
\fB\-k\fR FILE, \fB\-\-privatekey\fR FILE
file containing your private key to sign the bundle's
manifest with. If one is not available the bundle will
not be signed.
.TP
\fB\-c\fR FILE, \fB\-\-cert\fR FILE
file containing your X.509 certificate. If one is not
available it will not be possible to unbundle the
bundle without cloud administrator assistance.
.TP
\fB\-\-ec2cert\fR FILE
file containing the cloud's X.509 certificate. If one
is not available locally it must be available from the
bootstrap service.
.TP
\fB\-u\fR ACCOUNT, \fB\-\-user\fR ACCOUNT
your account ID
.TP
\fB\-\-kernel\fR IMAGE
ID of the kernel image to associate with this machine
image
.TP
\fB\-\-ramdisk\fR IMAGE
ID of the ramdisk image to associate with this machine
image
.TP
\fB\-\-bootstrap\-url\fR BOOTSTRAP_URL
[Eucalyptus only] bootstrap service endpoint URL (used
for obtaining \fB\-\-ec2cert\fR automatically
.TP
\fB\-B\fR VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,..., \fB\-\-block\-device\-mappings\fR VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,...
block device mapping scheme with which to launch
instances of this machine image
.TP
\fB\-\-productcodes\fR CODE1,CODE2,...
comma\-separated list of product codes for the image
.TP
\fB\-\-image\-size\fR IMAGE_SIZE
the image's size (required when bundling stdin)
.TP
\fB\-b\fR BUCKET[/PREFIX], \fB\-\-bucket\fR BUCKET[/PREFIX]
bucket to upload the bundle to (required)
.TP
\fB\-\-acl\fR {public\-read,aws\-exec\-read,ec2\-bundle\-read}
canned ACL policy to apply to the bundle (default:
aws\-exec\-read)
.TP
\fB\-\-upload\-policy\fR POLICY
upload policy to use for authorization
.TP
\fB\-\-upload\-policy\-file\fR FILE
file containing an upload policy to use for
authorization
.TP
\fB\-\-upload\-policy\-signature\fR SIGNATURE
signature for the upload policy (required when an
\&'upload policy is used)
.TP
\fB\-\-location\fR LOCATION
location constraint of the destination bucket
(default: inferred from s3\-location\-constraint in
configuration, or otherwise none)
.TP
\fB\-\-retry\fR
retry failed uploads up to 5 times
.TP
\fB\-\-progress\fR
show progress (the default when run interactively)
.TP
\fB\-\-no\-progress\fR
do not show progress (the default when run noninteractively)
.TP
\fB\-\-show\-empty\-fields\fR
show empty values as "(nil)"
.TP
\fB\-U\fR URL, \fB\-\-url\fR URL
object storage service endpoint URL
.TP
\fB\-\-region\fR USER@REGION
region and/or user names to search when looking up
config file data
.HP
\fB\-I\fR KEY_ID, \fB\-\-access\-key\-id\fR KEY_ID
.HP
\fB\-S\fR KEY, \fB\-\-secret\-key\fR KEY
.HP
\fB\-\-security\-token\fR TOKEN
.TP
\fB\-\-debug\fR
show debugging output
.TP
\fB\-\-debugger\fR
launch interactive debugger on error
.TP
\fB\-\-version\fR
show the program's version and exit
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit