EUCA-INSTALL-IMAGE(1)

NAME
euca-install-image - Bundle, upload and register an image into the cloud

SYNOPSIS
euca-install-image -n NAME [--description DESCRIPTION]

[--max-pending-parts MAX_PENDING_PARTS]
    [--virtualization-type {paravirtual,hvm}] [--platform windows] [--ec2-url EC2_URL] -i FILE [-p PREFIX] [-d DIR] -r {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] -b BUCKET[/PREFIX] [--acl {public-read,aws-exec-read,ec2-bundle-read}] [--upload-policy POLICY | --upload-policy-file FILE] [--upload-policy-signature SIGNATURE] [--location LOCATION] [--retry] [--progress | --no-progress] [--show-empty-fields] [-U URL] [--region USER@REGION] [-I KEY_ID] [-S KEY] [--security-token TOKEN] [--debug] [--debugger] [--version] [-h]

DESCRIPTION
Bundle, upload and register an image into the cloud

  optional arguments:

-n NAME, --name NAME
    name of the new image (required)

--description DESCRIPTION
    description of the new image

--max-pending-parts MAX_PENDING_PARTS
    pause the bundling process when more than this number of parts are waiting to be uploaded (default: 2)

--virtualization-type {paravirtual,hvm}
    virtualization type for the new image

--platform windows
    [Privileged] the new image's platform (windows)

--ec2-url EC2_URL
    compute service endpoint URL

-i FILE, --image FILE
    file containing the image to bundle (required)

-p PREFIX, --prefix PREFIX
    the file name prefix to give the bundle's files (required when bundling stdin; otherwise defaults to the image's file name)

-d DIR, --destination DIR
    location to place the bundle's files (default: dir named by TMPDIR, TEMP, or TMP environment variables, or otherwise /var/tmp)

-r {i386,x86_64,armhf,ppc,ppc64,ppc64le}, --arch {i386,x86_64,armhf,ppc,ppc64,ppc64le}
    the image's architecture (required)

-k FILE, --privatekey FILE
    file containing your private key to sign the bundle's manifest with. If one is not available the bundle will not be signed.

-c FILE, --cert 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.

--ec2cert FILE
    file containing the cloud's X.509 certificate. If one is not available locally it must be available from the bootstrap service.

-u ACCOUNT, --user ACCOUNT
    your account ID

--kernel IMAGE
    ID of the kernel image to associate with this machine image

--ramdisk IMAGE
    ID of the ramdisk image to associate with this machine image

--bootstrap-url BOOTSTRAP_URL
    [Eucalyptus only] bootstrap service endpoint URL (used for obtaining --ec2cert automatically

-B VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,..., --block-device-mappings VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,...
    block device mapping scheme with which to launch instances of this machine image

--productcodes CODE1,CODE2,...
    comma-separated list of product codes for the image

--image-size IMAGE_SIZE
    the image's size (required when bundling stdin)

-b BUCKET[/PREFIX], --bucket BUCKET[/PREFIX]
    bucket to upload the bundle to (required)

--acl {public-read,aws-exec-read,ec2-bundle-read}
    canned ACL policy to apply to the bundle (default: aws-exec-read)

--upload-policy POLICY
    upload policy to use for authorization

--upload-policy-file FILE
    file containing an upload policy to use for authorization

--upload-policy-signature SIGNATURE
    signature for the upload policy (required when an 'upload policy is used)

--location LOCATION
    location constraint of the destination bucket (default: inferred from s3-location-constraint in configuration, or otherwise none)

--retry
    retry failed uploads up to 5 times

--progress
    show progress (the default when run interactively)

--no-progress
    do not show progress (the default when run noninteractively)

--show-empty-fields
    show empty values as "(nil)"

-U URL, --url URL
    object storage service endpoint URL

--region USER@REGION
    region and/or user names to search when looking up config file data

-I KEY_ID, --access-key-id KEY_ID

-S KEY, --secret-key KEY

--security-token TOKEN

--debug
    show debugging output

--debugger
    launch interactive debugger on error

--version
    show the program's version and exit

-h, --help
    show this help message and exit