euca-bundle-vol

Bundles an image for use with Eucalyptus or Amazon EC2, compressing, encrypting and signing a snapshot of the local machine's root file system.

Syntax

euca-bundle-vol [-p PREFIX] [-d DIR] [-r {i386,x86_64,armhf,ppc,ppc64}]
                       [-e PATH,...] [-i PATH,...] [-s MiB] [--no-filter]
                       [--all] [--inherit | --no-inherit] [-v DIR]
                       [-P {mbr,gpt,none}] [-S FILE]
                       [--fstab FILE | --generate-fstab] [--grub-config FILE]
                       [-k FILE] [-c FILE] [--ec2cert FILE] [-u ACCOUNT]
                       [--kernel IMAGE] [--ramdisk IMAGE]
                       [-B VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,...]
                       [--productcodes CODE1,CODE2,...]
                       [--progress | --no-progress] [--debug] [--debugger]
                       [--version] [-h]

Options

Option Description Required
-p,--prefix prefix File name prefix for the bundle files. Default is "image". No
-k,--privatekey private_key Path to user's PEM-encoded private key. Yes
-u,--user user_id 12-digit account ID of the person who is bundling the image. Yes
-c,--cert Path the user's PEM-encoded certificate. Yes
-r architecture, --arch architecture Target architecture for the image.

Default: x86_64

Valid values: i386 | x86_64 | armhf | ppc | ppc64

Yes
-s,--size size_in_mib Size of the image in MiB.

Default: 10240 MiB

No
-B,--block-device-mapping Default block device mapping for the image. The format of the mapping is a comma-separated list of key=value pairs. No
-d directory, --destination directory Directory where the bundle image files go. Eucalyptus recommends that you include this option where allowed. This is the directory specified by TMPDIR, TEMP, or TMP environment variables.

Default: /var/tmp

No
-e,--exclude directory_1, directory_2,... Comma-separated list of directories to exclude. Default exclusions are stored in /etc/euca2ools/bundle-vol/excludes. No
-i,--include directory_1, directory_2,... Comma-separated list of directories to include. No
-a,--all Bundle all directories (including mounted filesystems). No
--inherit Explicitly inherit instance metadata and add it to the bundled image (this is the default behavior). No
--no-inherit Do not inherit instance metadata and add it to the bundled image. No
-P, --partition Which partition standard you want to use: Master Boot Record, GUID Partition Table, or no partition

Valid values: mbr | gpt | none

--no-filter Do not use the default filtered files list. No
--fstabpath Path to the fstab to bundle in the image. No
--generate-fstab Generate fstab to bundle in the image. No
--ec2certfile File containing the cloud's X.509 certificate. No
--kernelimage ID of the kernel image to associate with the machine bundle. No
--ramdiskimage ID of the ramdisk image to associate with the machine bundle. No
-\-productcodescode1 [, code2, ...] Comma-delimited list of product codes. No
--progress Show a progress bar during command execution. This is the default when this command is run interactively. No
--no-progress Do not show a progress bar during command execution. This is the default when this command is run non-interactively. No

Common Options

Option Description
--region region Region to direct requests to. Only valid for EC2 endpoints.
-U,--url url URL of the cloud to connect to. Expects an EC2 endpoint /services/Eucalyptus.
-a,--access-key access_key_id User's access key ID
-S,--secret-key secret_key User's secret key
--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 returns status messages describing the stages and status of the bundling.

Example

euca-bundle-vol -d /mnt/ebsvol -p myimage -s 2048 --arch x86_64
1+0 records in
1+0 records out
1048576 bytes (1.0 MB) copied, 0.00358811 s, 292 MB/s
mke2fs 1.41.9 (22-Aug-2009)
Filesystem label=
OS type: Linux
Block size=4096 (log=2)
Fragment size=4096 (log=2)
131072 inodes, 524288 blocks
26214 blocks (5.00%) reserved for the super user
First data block=0
Maximum filesystem blocks=536870912
16 block groups
32768 blocks per group, 32768 fragments per group
8192 inodes per group
Superblock backups stored on blocks:
 32768, 98304, 163840, 229376, 294912

Writing inode tables: done
Creating journal (16384 blocks): done
Writing superblocks and filesystem accounting information: done

This filesystem will be automatically checked every 39 mounts or
180 days, whichever comes first.  Use tune2fs -c or -i to override.
Checking image
Tarring image
Encrypting image
Splitting image...
Part: myimage.part.0
Part: myimage.part.1
Part: myimage.part.2
Part: myimage.part.3
Part: myimage.part.4
Part: myimage.part.5
Part: myimage.part.6
Part: myimage.part.7
Part: myimage.part.8
Part: myimage.part.9
Part: myimage.part.10
Part: myimage.part.11
Part: myimage.part.12
Part: myimage.part.13
Part: myimage.part.14
Part: myimage.part.15
Part: myimage.part.16
Part: myimage.part.17
Part: myimage.part.18
Part: myimage.part.19
Part: myimage.part.20
Part: myimage.part.21
Part: myimage.part.22
Generating manifest /mnt/ebsvol/myimage.manifest.xml
x