Difference between revisions of "UEC: Peritah-perintah Euca"

From OnnoWiki
Jump to navigation Jump to search
Line 55: Line 55:
  
  
===euca-bundle-vol====
+
===euca-bundle-vol===
  
 
Bundle the local filesystem of a running instance as a bundled image.
 
Bundle the local filesystem of a running instance as a bundled image.
Line 185: Line 185:
 
Unbundles a previously bundled image.
 
Unbundles a previously bundled image.
  
01 euca-unbundle-image -m, --manifest manifest_path [-k, --privatekey private_key_path]
+
euca-unbundle-image -m, --manifest manifest_path [-k, --privatekey private_key_path]
02 [-s, --source source_directory] [-d, --destination destination_directory]
+
[-s, --source source_directory] [-d, --destination destination_directory]
03 [-h, --help] [--version] [--debug]
+
[-h, --help] [--version] [--debug]
04
+
05 REQUIRED PARAMETERS
+
REQUIRED PARAMETERS
06
+
07 -m, --manifest Path to the manifest file for the bundled image.
+
-m, --manifest Path to the manifest file for the bundled image.
08
+
09 OPTIONAL PARAMETERS
+
OPTIONAL PARAMETERS
10
+
11 -d, --destination Directory to store the image to (defaults to the current directory).
+
-d, --destination Directory to store the image to (defaults to the current directory).
12
+
13 -s, --source Source directory for the bundled image parts (defaults to manifest directory).
+
-s, --source Source directory for the bundled image parts (defaults to manifest directory).
14
+
15 -a, --access-key User's Access Key ID.
+
-a, --access-key User's Access Key ID.
16
+
17 -s, --secret-key User's Secret Key.
+
-s, --secret-key User's Secret Key.
18
+
19 -U, --url URL of the Cloud to connect to.
+
-U, --url URL of the Cloud to connect to.
20
+
21 --config Read credentials and cloud settings from the
+
--config Read credentials and cloud settings from the
22 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc).
+
specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc).
23
+
24 -h, --help Display this help message.
+
-h, --help Display this help message.
25
+
26 --version Display the version of this tool.
+
--version Display the version of this tool.
27
+
28 --debug Turn on debugging.
+
--debug Turn on debugging.
  
  
Line 219: Line 219:
 
Upload a previously bundled image to the cloud.
 
Upload a previously bundled image to the cloud.
  
01 euca-upload-bundle -b, --bucket bucket -m, --manifest manifest_path [-a, --access-key access_key_id]
+
euca-upload-bundle -b, --bucket bucket -m, --manifest manifest_path [-a, --access-key access_key_id]
02 [-s, --secret-key secret_key] [--acl canned_acl] [--ec2cert ec2cert_path] [-d, --directory bundle_path]
+
[-s, --secret-key secret_key] [--acl canned_acl] [--ec2cert ec2cert_path] [-d, --directory bundle_path]
03 [--part part] [--url url] [--skipmanifest] [--debug] [-h, --help] [--version]
+
[--part part] [--url url] [--skipmanifest] [--debug] [-h, --help] [--version]
04
+
05 REQUIRED PARAMETERS
+
REQUIRED PARAMETERS
06
+
07 -b, --bucket The name of the bucket to upload to. Bucket will be created if it does not exist.
+
-b, --bucket The name of the bucket to upload to. Bucket will be created if it does not exist.
08
+
09 -m, --manifest The path to the manifest file for the bundled image.
+
-m, --manifest The path to the manifest file for the bundled image.
10
+
11 OPTIONAL PARAMETERS
+
OPTIONAL PARAMETERS
12
+
13 --acl Canned access control policy (defaults to "aws-exec-read").
+
--acl Canned access control policy (defaults to "aws-exec-read").
14
+
15 --ec2cert The path to the Cloud's X509 public key certificate.
+
--ec2cert The path to the Cloud's X509 public key certificate.
16
+
17 -d, --directory The directory containing the bundled image to upload (defaults to the manifest directory).
+
-d, --directory The directory containing the bundled image to upload (defaults to the manifest directory).
18
+
19 --part Uploads specified part and all subsequent parts.
+
--part Uploads specified part and all subsequent parts.
20
+
21 --skipmanifest Do not upload the manifest file.
+
--skipmanifest Do not upload the manifest file.
22
+
23 -a, --access-key User's Access Key ID.
+
-a, --access-key User's Access Key ID.
24
+
25 -s, --secret-key User's Secret Key.
+
-s, --secret-key User's Secret Key.
26
+
27 -U, --url URL of the Cloud to connect to.
+
-U, --url URL of the Cloud to connect to.
28
+
29 --config Read credentials and cloud settings from the
+
--config Read credentials and cloud settings from the
30 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc).
+
specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc).
31
+
32 -h, --help Display this help message.
+
-h, --help Display this help message.
33
+
34 --version Display the version of this tool.
+
--version Display the version of this tool.
35
+
36 --debug Turn on debugging.
+
--debug Turn on debugging.
  
  

Revision as of 06:26, 22 October 2010

Image Management

euca-bundle-image

Bundles an image for use with Eucalyptus or Amazon EC2.

	euca-bundle-image -i, --image image_path -u, --user user [-c, --cert cert_path]
	[-k, --privatekey private_key_path] [-p, --prefix prefix] [--kernel kernel_id]
	[--ramdisk ramdisk_id] [-B, --block-device-mapping mapping]
	[-d, --destination destination_path] [--ec2cert ec2cert_path]
	[-r, --arch target_architecture] [--batch] [-h, --help] [--version] [--debug]
	 
	REQUIRED PARAMETERS
	 
	-i, --image Path to the image file to bundle.
	 
	-u, --user User ID (12-digit) of the user who is bundling the image.
	 
	OPTIONAL PARAMETERS
	 
	-c, --cert Path to the user's PEM encoded certificate.
	 
	-k, --privatekey Path to the user's PEM encoded private key.
	 
	-p, --prefix The prefix for the bundle image files. (default: image name).
	 
	--kernel The kernel to be associated with the bundled image.
	 
	--ramdisk The ramdisk to be associated with the bundled image.
	 
	-B, --block-device-mapping Default block device mapping for the image (comma-separated list of key=value pairs).
	 
	-d, --destination Directory to store the bundled image in (default: "/tmp"). Recommended.
	 
	--ec2cert The path to the Cloud's X509 public key certificate.
	 
	-r, --arch Target architecture for the image ('x86_64' or 'i386' default: 'x86_64').
	 
	--batch Run in batch mode (compatibility only. has no effect).
	 
	-a, --access-key User's Access Key ID.
	 
	-s, --secret-key User's Secret Key.
	 
	-U, --url URL of the Cloud to connect to.
	 
	--config Read credentials and cloud settings from the
	specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc).
	 
	-h, --help Display this help message.
	 
	--version Display the version of this tool.
	 
	--debug Turn on debugging.


euca-bundle-vol

Bundle the local filesystem of a running instance as a bundled image.

	euca-bundle-vol -u, --user user -s, --size size_in_MB
	 
	[-c, --cert cert_path] [-k, --privatekey private_key_path]
	 
	[-a, --all] [-e, --exclude dir1, dir2,...dirN] [-p, --prefix prefix] [--[no-]inherit] [-v, --volume volume_path] [--fstab fstab_path] [--generate-fstab] [--kernel kernel_id] [--ramdisk ramdisk_id] [-B, --block-device-mapping mapping]
	 
	[-d, --destination destination_path] [--ec2cert ec2cert_path] [-r, --arch target_architecture] [--batch] [--version]
	 
	REQUIRED PARAMETERS
	 
	-u, --user User ID (12-digit) of the user who is bundling the image.
	 
	-s, --size Size for the image in MB (default: 10GB or 10240MB).
	 
	OPTIONAL PARAMETERS
	 
	-c, --cert Path to the user's PEM encoded certificate.
	 
	-k, --privatekey Path to the user's PEM encoded private key.
	 
	-a, --all Bundle all directories (including mounted filesystems).
	 
	-p, --prefix The prefix for the bundle image files. (default: image name).
	 
	--[no-]inherit Add (or do not add) instance metadata to the bundled image. Inherit is set by default.
	 
	-e, --exclude comma-separated list of directories to exclude.
	 
	--kernel The kernel to be associated with the bundled image.
	 
	--ramdisk The ramdisk to be associated with the bundled image.
	 
	-B, --block-device-mapping Default block device mapping for the image (comma-separated list of key=value pairs).
	 
	-d, --destination Directory to store the bundled image in (default: "/tmp"). Recommended.
	 
	--ec2cert The path to the Cloud's X509 public key certificate.
	 
	-r, --arch Target architecture for the image ('x86_64' or 'i386' default: 'x86_64').
	 
	-v, --volume Path to mounted volume to create the bundle from (default: "/").
	 
	--fstab Path to the fstab to be bundled into the image.
	 
	--generate-fstab Generate fstab to bundle into the image.
	 
	--batch Run in batch mode (compatibility only. has no effect).


euca-delete-bundle

Delete a previously uploaded bundle.

	euca-delete-bundle -b, --bucket bucket [-m, --manifest manifest_path]
	[-p, --prefix prefix] [--clear] [-h, --help] [--version] [--debug]
	 
	REQUIRED PARAMETERS
	 
	bucket The name of the bucket to delete from.
	 
	OPTIONAL PARAMETERS
	 
	-m, --manifest The path to the manifest file.
	 
	-b, --bucket The bucket to delete the bundle from (if no
	manifest is specified, all images from this
	bucket will be deleted).
	 
	-p, --prefix The filename prefix for bundled files. Defaults
	to image name.
	 
	--clear Delete the bucket containing the image.
	 
	-a, --access-key User's Access Key ID.
	 
	-s, --secret-key User's Secret Key.
	 
	-U, --url URL of the Cloud to connect to.
	 
	--config Read credentials and cloud settings from the
	specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc).
	 
	-h, --help Display this help message.
	 
	--version Display the version of this tool.
	 
	--debug Turn on debugging.


euca-download-bundle

Downloads a bundled image from a bucket.

	euca-download-bundle -b, --bucket bucket [-m, --manifest manifest_path] [-d, --directory directory]
	[-h, --help] [--version] [--debug]
	 
	REQUIRED PARAMETERS
	 
	-b, --bucket The name of the bucket to download from.
	 
	OPTIONAL PARAMETERS
	 
	-m, --manifest The path to the manifest file.
	 
	-d, --directory The name of the directory to download the bundled parts to.
	 
	-a, --access-key User's Access Key ID.
	 
	-s, --secret-key User's Secret Key.
	 
	-U, --url URL of the Cloud to connect to.
	 
	--config Read credentials and cloud settings from the
	specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc).
	 
	-h, --help Display this help message.
	 
	--version Display the version of this tool.
	 
	--debug Turn on debugging.


euca-unbundle

Unbundles a previously bundled image.

	euca-unbundle-image -m, --manifest manifest_path [-k, --privatekey private_key_path]
	[-s, --source source_directory] [-d, --destination destination_directory]
	[-h, --help] [--version] [--debug]
	 
	REQUIRED PARAMETERS
	 
	-m, --manifest Path to the manifest file for the bundled image.
	 
	OPTIONAL PARAMETERS
	 
	-d, --destination Directory to store the image to (defaults to the current directory).
	 
	-s, --source Source directory for the bundled image parts (defaults to manifest directory).
	 
	-a, --access-key User's Access Key ID.
	 
	-s, --secret-key User's Secret Key.
	 
	-U, --url URL of the Cloud to connect to.
	 
	--config Read credentials and cloud settings from the
	specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc).
	 
	-h, --help Display this help message.
	 
	--version Display the version of this tool.
	 
	--debug Turn on debugging.


euca-upload-bundle

Upload a previously bundled image to the cloud.

	euca-upload-bundle -b, --bucket bucket -m, --manifest manifest_path [-a, --access-key access_key_id]

[-s, --secret-key secret_key] [--acl canned_acl] [--ec2cert ec2cert_path] [-d, --directory bundle_path]

	[--part part] [--url url] [--skipmanifest] [--debug] [-h, --help] [--version]
	 
	REQUIRED PARAMETERS
	 
	-b, --bucket The name of the bucket to upload to. Bucket will be created if it does not exist.
	 
	-m, --manifest The path to the manifest file for the bundled image.
	 
	OPTIONAL PARAMETERS
	 
	--acl Canned access control policy (defaults to "aws-exec-read").
	 
	--ec2cert The path to the Cloud's X509 public key certificate.
	 
	-d, --directory The directory containing the bundled image to upload (defaults to the manifest directory).
	 
	--part Uploads specified part and all subsequent parts.
	 
	--skipmanifest Do not upload the manifest file.
	 
	-a, --access-key User's Access Key ID.
	 
	-s, --secret-key User's Secret Key.
	 
	-U, --url URL of the Cloud to connect to.
	 
	--config Read credentials and cloud settings from the
	specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc).
	 
	-h, --help Display this help message.
	 
	--version Display the version of this tool.
	 
	--debug Turn on debugging.


euca-describe-images

Shows information about machine images.

01 euca-describe-images [-a] [-o owner] [-x user] [-h, --help] [--version] [--debug] [image1 image2 ... imageN] 02 03 OPTIONAL PARAMETERS 04 05 image1 image2 ... imageN Images to describe. 06 07 -a Show all images that the user has access to. 08 09 -o Show only images owned by the owner specified are displayed. 10 11 -x Show only images that the specified user is permitted to launch. 12 13 -A, --access-key User's Access Key ID. 14 15 -S, --secret-key User's Secret Key. 16 17 -U, --url URL of the Cloud to connect to. 18 19 --config Read credentials and cloud settings from the 20 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 21 22 -h, --help Display this help message. 23 24 --version Display the version of this tool. 25 26 --debug Turn on debugging.


euca-describe-image-attribute

Show image attributes.

01 euca-describe-image-attribute [-l, --launch-permission] [-p, --product-code] 02 [-B, --block-device-mapping] [--kernel] [--ramdisk] 03 [-h, --help] [--version] [--debug] image_id 04 05 REQUIRED PARAMETERS 06 07 image_id unique identifier for the image that you want to retrieve the attributes for. 08 09 OPTIONAL PARAMETERS 10 11 -B, --block-device-mapping show block device mapping. 12 -l, --launch-permission show launch permissions. 13 -p, --product-code show the product codes associated with the image 14 --kernel show the kernel id associated with the image. 15 --ramdisk show the ramdisk id associated with the image. 16 17 -a, --access-key user's Access Key ID. 18 19 -s, --secret-key user's Secret Key. 20 21 -U, --url URL of the Cloud to connect to. 22 23 -h, --help Display this help message. 24 25 --version Display the version of this tool. 26 27 --debug Turn on debugging.


euca-register

Registers a manifest for use with the cloud.

01 euca-register [-h, --help] [--version] [--debug] image_location 02 03 REQUIRED PARAMETERS 04 05 image_location - path to the uploaded image (bucket/manifest). 06 07 OPTIONAL PARAMETERS 08 09 -a, --access-key user's Access Key ID. 10 11 -s, --secret-key user's Secret Key. 12 13 -U, --url URL of the Cloud to connect to. 14 15 -h, --help Display this help message. 16 17 --version Display the version of this tool. 18 19 --debug Turn on debugging.


euca-deregister

Deregisters an image from the cloud.

01 euca-deregister [-h, --help] [--version] [--debug] image_id 02 03 REQUIRED PARAMETER 04 05 image_id unique identifier for the image to be deregistered. 06 07 OPTIONAL PARAMETER 08 09 -a, --access-key User's Access Key ID. 10 11 -s, --secret-key User's Secret Key. 12 13 -U, --url URL of the Cloud to connect to. 14 15 --config Read credentials and cloud settings from the 16 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 17 18 -h, --help Display this help message. 19 20 --version Display the version of this tool. 21 22 --debug Turn on debugging.


Instance Management

euca-describe-instances

Shows information about instances.

01 euca-describe-instances [-h, --help] [--version] [--debug] 02 [instance1... instanceN] 03 04 OPTIONAL PARAMETERS 05 06 instance1... instanceN instances to describe. 07 08 -a, --access-key User's Access Key ID. 09 10 -s, --secret-key User's Secret Key. 11 12 -U, --url URL of the Cloud to connect to. 13 14 --config Read credentials and cloud settings from the 15 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 16 17 -h, --help Display this help message. 18 19 --version Display the version of this tool. 20 21 --debug Turn on debugging.


euca-reboot-instances

Reboots specified instances.

01 euca-reboot-instances [-h, --help] [--version] [--debug] 02 [instance1... instanceN] 03 04 OPTIONAL PARAMETERS 05 06 instance1... instanceN instances to reboot. 07 08 -a, --access-key User's Access Key ID. 09 10 -s, --secret-key User's Secret Key. 11 12 -U, --url URL of the Cloud to connect to. 13 14 --config Read credentials and cloud settings from the 15 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 16 17 -h, --help Display this help message. 18 19 --version Display the version of this tool. 20 21 --debug Turn on debugging.


euca-run-instances

Starts instances.

01 euca-run-instances [-n, --instance-count count] [-g, --group group_name] [-k, --key keyname] 02 [--addressing addressing] [-t, --instance-type instance_type] [-z, --availability-zone zone] 03 [--kernel kernel_id] [--ramdisk ramdisk_id] [-h, --help] [--version] [--debug] image_id 04 05 REQUIRED PARAMETERS 06 07 image_id identifier for the image to run. 08 09 OPTIONAL PARAMETERS 10 11 -n, --instance-count Number of instances to run. 12 13 -g, --group Security group to run the instance under. 14 15 -k, --key Name of a (previously created) keypair to associate with this reservation. 16 17 -d, --user-data User data for instances read from the command line. 18 19 -f, --user-data-file User data for instances as a filename. 20 21 --addressing Addressing mode (e.g., private). 22 23 -t, --instance-type VM Image type to run the instance(s) as (default: m1.small). 24 25 -z, --availability-zone Availability zone to run the instance(s) in. 26 27 --kernel Id of the kernel to be used to launch instance(s). 28 29 --ramdisk Id of the ramdisk to be used to launch instance(s). 30 31 -a, --access-key User's Access Key ID. 32 33 -s, --secret-key User's Secret Key. 34 35 -U, --url URL of the Cloud to connect to. 36 37 --config Read credentials and cloud settings from the 38 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 39 40 -h, --help Display this help message. 41 42 --version Display the version of this tool. 43 44 --debug Turn on debugging.


euca-terminate-instances

Stops specified instances.

01 euca-terminate-instances [-h, --help] [--version] [--debug] 02 [instance1... instanceN] 03 04 REQUIRED PARAMETERS 05 06 instance1... instanceN instances to terminate. 07 08 OPTIONAL PARAMETERS 09 10 -a, --access-key User's Access Key ID. 11 12 -s, --secret-key User's Secret Key. 13 14 -U, --url URL of the Cloud to connect to. 15 16 --config Read credentials and cloud settings from the 17 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 18 19 -h, --help Display this help message. 20 21 --version Display the version of this tool. 22 23 --debug Turn on debugging.


euca-confirm-product-instance

Confirm if instance is running with product code attached.

01 euca-confirm-product-instance i, --instance instance_id [-h, --help] [-version] [--debug] product_code 02 03 REQUIRED PARAMETERS 04 05 -i, --instance Unique identifier for a running instance. 06 07 product_code The product code to verify. 08 09 OPTIONAL PARAMETERS 10 11 -a, --access-key User's Access Key ID. 12 13 -s, --secret-key User's Secret Key. 14 15 -U, --url URL of the Cloud to connect to. 16 17 --config Read credentials and cloud settings from the 18 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 19 20 -h, --help Display this help message. 21 22 --version Display the version of this tool. 23 24 --debug Turn on debugging. Storage Management euca-attach-volume

Attaches a volume to an instance. view source print? 01 euca-attach-volume -i, --instance instance_id -d, --device device 02 [-h, --help] [--version] [--debug] volume_id 03 04 REQUIRED PARAMETERS 05 06 -i, --instance unique id of a running instance to attach the volume to. 07 08 -d, --device local device name (inside the guest VM) to use. 09 10 volume_id unique id for a volume to attach. 11 12 OPTIONAL PARAMETERS 13 14 -a, --access-key User's Access Key ID. 15 16 -s, --secret-key User's Secret Key. 17 18 -U, --url URL of the Cloud to connect to. 19 20 --config Read credentials and cloud settings from the 21 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 22 23 -h, --help Display this help message. 24 25 --version Display the version of this tool. 26 27 --debug Turn on debugging. euca-create-volume

Creates a volume in a specified availability zone. view source print? 01 euca-create-volume -S, --size size | --snapshot snapshot_id -z zone 02 [-h, --help] [--version] [--debug] 03 04 REQUIRED PARAMETERS 05 06 -s, --size size of the volume (in GiB). 07 08 --snapshot snapshot id to create the volume from. Either size or snapshot can be specified (not both). 09 10 -z, --zone availability zone to create the volume in 11 12 OPTIONAL PARAMETERS 13 14 -A, --access-key User's Access Key ID. 15 16 -S, --secret-key User's Secret Key. 17 18 -U, --url URL of the Cloud to connect to. 19 20 --config Read credentials and cloud settings from the 21 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 22 23 -h, --help Display this help message. 24 25 --version Display the version of this tool. 26 27 --debug Turn on debugging. euca-delete-volume

Deletes a volume. view source print? 01 euca-delete-volume [-h, --help] [--version] [--debug] volume_id 02 03 REQUIRED PARAMETERS 04 05 volume_id unique identifier for the volume to be deleted. 06 07 OPTIONAL PARAMETERS 08 09 -a, --access-key User's Access Key ID. 10 11 -s, --secret-key User's Secret Key. 12 13 -U, --url URL of the Cloud to connect to. 14 15 --config Read credentials and cloud settings from the 16 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 17 18 -h, --help Display this help message. 19 20 --version Display the version of this tool. 21 22 --debug Turn on debugging. euca-describe-volumes

Shows information about volumes. view source print? 01 euca-describe-volumes [-h, --help] [--version] [--debug] 02 [volume1 volume2...volumeN] 03 04 OPTIONAL PARAMETERS 05 06 volume1 volume2...volumeN volumes to describe. 07 08 -a, --access-key User's Access Key ID. 09 10 -s, --secret-key User's Secret Key. 11 12 -U, --url URL of the Cloud to connect to. 13 14 --config Read credentials and cloud settings from the 15 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 16 17 -h, --help Display this help message. 18 19 --version Display the version of this tool. 20 21 --debug Turn on debugging. euca-detach-volume

Detaches a volume from an instance. view source print? 01 euca-detach-volume [-h, --help] [--version] [--debug] volume_id 02 03 REQUIRED PARAMETERS 04 05 volume_id unique id for a volume to detach. 06 07 OPTIONAL PARAMETERS 08 09 -a, --access-key User's Access Key ID. 10 11 -s, --secret-key User's Secret Key. 12 13 -U, --url URL of the Cloud to connect to. 14 15 --config Read credentials and cloud settings from the 16 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 17 18 -h, --help Display this help message. 19 20 --version Display the version of this tool. 21 22 --debug Turn on debugging. euca-create-snapshot

Creates a snapshot from an existing volume. view source print? 01 euca-create-snapshot [-h, --help] [--version] [--debug] volume_id 02 03 REQUIRED PARAMETERS 04 05 volume_id unique id for a volume to snapshot. 06 07 OPTIONAL PARAMETERS 08 09 -a, --access-key User's Access Key ID. 10 11 -s, --secret-key User's Secret Key. 12 13 -U, --url URL of the Cloud to connect to. 14 15 --config Read credentials and cloud settings from the 16 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 17 18 -h, --help Display this help message. 19 20 --version Display the version of this tool. 21 22 --debug Turn on debugging. euca-delete-snapshot

Deletes a snapshot. view source print? 01 euca-delete-snapshot [-h, --help] [--version] [--debug] snapshot_id 02 03 REQUIRED PARAMETERS 04 05 snapshot_id unique identifier for the snapshot to be deleted. 06 07 OPTIONAL PARAMETERS 08 09 -a, --access-key User's Access Key ID. 10 11 -s, --secret-key User's Secret Key. 12 13 -U, --url URL of the Cloud to connect to. 14 15 --config Read credentials and cloud settings from the 16 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 17 18 -h, --help Display this help message. 19 20 --version Display the version of this tool. 21 22 --debug Turn on debugging. euca-describe-snapshots

Shows information about snapshots. view source print? 01 euca-describe-snapshots [-h, --help] [--version] [--debug] 02 [snapshot1 snapshot2...snapshotN] 03 04 OPTIONAL PARAMETERS 05 06 snapshot1 snapshot2...snapshotN - snapshots to describe. 07 08 -a, --access-key User's Access Key ID. 09 10 -s, --secret-key User's Secret Key. 11 12 -U, --url URL of the Cloud to connect to. 13 14 --config Read credentials and cloud settings from the 15 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 16 17 -h, --help Display this help message. 18 19 --version Display the version of this tool. 20 21 --debug Turn on debugging. Network Management euca-allocate-address

Allocate a public IP address. view source print? 01 euca-allocate-address [-h, --help] [--version] [--debug] 02 03 OPTIONAL PARAMETERS 04 05 -a, --access-key User's Access Key ID. 06 07 -s, --secret-key User's Secret Key. 08 09 -U, --url URL of the Cloud to connect to. 10 11 --config Read credentials and cloud settings from the 12 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 13 14 -h, --help Display this help message. 15 16 --version Display the version of this tool. 17 18 --debug Turn on debugging. euca-associate-address

Associate an instance with a public IP address. view source print? 01 euca-associate-address -i, --instance instance_id 02 [-h, --help] [--version] [--debug] ip 03 04 REQUIRED PARAMETERS 05 06 -i, --instance unique identifier for a running instance to associate the address with. 07 08 ip IP address to associate. 09 10 OPTIONAL PARAMETERS 11 12 -a, --access-key user's Access Key ID. 13 14 -s, --secret-key user's Secret Key. 15 16 -U, --url URL of the Cloud to connect to. 17 18 -h, --help Display this help message. 19 20 --version Display the version of this tool. 21 22 --debug Turn on debugging. euca-describe-addresses

Shows information about addresses. view source print? 01 euca-describe-addresses [-h, --help] [--version] [--debug] [ip1 ip2...ipN] 02 03 OPTIONAL PARAMETERS 04 05 ip1 ip2...ipN IP addresses to display information about. 06 07 -a, --access-key User's Access Key ID. 08 09 -s, --secret-key User's Secret Key. 10 11 -U, --url URL of the Cloud to connect to. 12 13 --config Read credentials and cloud settings from the 14 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 15 16 -h, --help Display this help message. 17 18 --version Display the version of this tool. 19 20 --debug Turn on debugging. euca-disassociate-address

Disassociate a public IP address from an instance. view source print? 01 euca-disassociate-address [-h, --help] [--version] [--debug] ip 02 03 REQUIRED PARAMETERS 04 05 ip IP address to disassociate. 06 07 OPTIONAL PARAMETERS 08 09 -a, --access-key User's Access Key ID. 10 11 -s, --secret-key User's Secret Key. 12 13 -U, --url URL of the Cloud to connect to. 14 15 --config Read credentials and cloud settings from the 16 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 17 18 -h, --help Display this help message. 19 20 --version Display the version of this tool. 21 22 --debug Turn on debugging. euca-release-address

Releases a public IP address. view source print? 01 euca-release-address [-h, --help] [--version] [--debug] ip 02 03 REQUIRED PARAMETERS 04 05 ip The public IP address to release. 06 07 OPTIONAL PARAMETERS 08 09 -a, --access-key User's Access Key ID. 10 11 -s, --secret-key User's Secret Key. 12 13 -U, --url URL of the Cloud to connect to. 14 15 --config Read credentials and cloud settings from the 16 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 17 18 -h, --help Display this help message. 19 20 --version Display the version of this tool. 21 22 --debug Turn on debugging. Security euca-add-group

Creates a new security group. view source print? 01 euca-add-group -d, --description group_description 02 [-h, --help] [--version] [--debug] group_name 03 04 REQUIRED PARAMETERS 05 06 -d, --description Description for the group to be created. 07 08 OPTIONAL PARAMETERS 09 10 -a, --access-key User's Access Key ID. 11 12 -s, --secret-key User's Secret Key. 13 14 -U, --url URL of the Cloud to connect to. 15 16 --config Read credentials and cloud settings from the 17 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 18 19 -h, --help Display this help message. 20 21 --version Display the version of this tool. 22 23 --debug Turn on debugging. euca-delete-group

Deletes a security group. view source print? 01 euca-delete-group [-h, --help] [--version] [--debug] group_name 02 03 REQUIRED PARAMETER 04 05 group_name unique name for a group to delete. 06 07 OPTIONAL PARAMETER 08 09 -a, --access-key User's Access Key ID. 10 11 -s, --secret-key User's Secret Key. 12 13 -U, --url URL of the Cloud to connect to. 14 15 --config Read credentials and cloud settings from the 16 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 17 18 -h, --help Display this help message. 19 20 --version Display the version of this tool. 21 22 --debug Turn on debugging. euca-describe-groups

Shows information about groups. view source print? 01 euca-describe-groups [-h, --help] [--version] [--debug] [group1 group2...groupN] 02 03 OPTIONAL PARAMETERS 04 05 group1 group2...groupN groups to describe. 06 07 -a, --access-key User's Access Key ID. 08 09 -s, --secret-key User's Secret Key. 10 11 -U, --url URL of the Cloud to connect to. 12 13 --config Read credentials and cloud settings from the 14 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 15 16 -h, --help Display this help message. 17 18 --version Display the version of this tool. 19 20 --debug Turn on debugging. euca-add-keypair

Creates a new key pair for use with instances. view source print? 01 euca-add-keypair [-h, --help] [--version] [--debug] keypair_name 02 03 REQUIRED PARAMETERS 04 05 keypair_name - unique name for a keypair to create. 06 07 OPTIONAL PARAMETERS 08 09 -a, --access-key User's Access Key ID. 10 11 -s, --secret-key User's Secret Key. 12 13 -U, --url URL of the Cloud to connect to. 14 15 --config Read credentials and cloud settings from the 16 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 17 18 -h, --help Display this help message. 19 20 --version Display the version of this tool. 21 22 --debug Turn on debugging. euca-delete-keypair

Delete a key pair. view source print? 01 euca-delete-keypair [-h, --help] [--version] [--debug] keypair_name 02 03 REQUIRED PARAMETERS 04 05 keypair_name unique name for the keypair to delete. 06 07 OPTIONAL PARAMETERS 08 09 -a, --access-key User's Access Key ID. 10 11 -s, --secret-key User's Secret Key. 12 13 -U, --url URL of the Cloud to connect to. 14 15 --config Read credentials and cloud settings from the 16 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 17 18 -h, --help Display this help message. 19 20 --version Display the version of this tool. 21 22 --debug Turn on debugging. euca-describe-keypairs

Shows information about keypairs. view source print? 01 euca-describe-keypairs [-h, --help] [--version] [--debug] 02 [keypair1 keypair2...keypairN] 03 04 OPTIONAL PARAMETERS 05 06 keypair1 keypair2...keypairN keypairs to describe. 07 08 -a, --access-key User's Access Key ID. 09 10 -s, --secret-key User's Secret Key. 11 12 -U, --url URL of the Cloud to connect to. 13 14 --config Read credentials and cloud settings from the 15 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 16 17 -h, --help Display this help message. 18 19 --version Display the version of this tool. 20 21 --debug Turn on debugging. euca-describe-availability-zones

Shows information about availability zones. view source print? 01 euca-describe-availability-zones [--region region] [-h, --help] [--version] [--debug] [zone1 zone2...zoneN] [verbose] 02 03 OPTIONAL PARAMETERS 04 05 --region region to describe availability zones for 06 07 zone1 zone2...zoneN zones to describe. 08 09 verbose show verbose resource information (Eucalyptus administrator-only functionality). 10 11 -a, --access-key User's Access Key ID. 12 13 -s, --secret-key User's Secret Key. 14 15 -U, --url URL of the Cloud to connect to. 16 17 --config Read credentials and cloud settings from the 18 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 19 20 -h, --help Display this help message. 21 22 --version Display the version of this tool. 23 24 --debug Turn on debugging. euca-describe-regions

Shows information about regions. view source print? 01 euca-describe-regions [-h, --help] [--version] [--debug] 02 [region1 region2...regionN] 03 04 OPTIONAL PARAMETERS 05 06 region1 region2...regionN regions to describe. 07 08 -a, --access-key User's Access Key ID. 09 10 -s, --secret-key User's Secret Key. 11 12 -U, --url URL of the Cloud to connect to. 13 14 --config Read credentials and cloud settings from the 15 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 16 17 -h, --help Display this help message. 18 19 --version Display the version of this tool. 20 21 --debug Turn on debugging. euca-get-console-output

Prints console output from a running instance. view source print? 01 euca-get-console-output [-h, --help] [--version] [--debug] instance_id 02 03 REQUIRED PARAMETERS 04 05 instance_id unique identifier for the instance show the console output for. 06 07 OPTIONAL PARAMETERS 08 09 -a, --access-key User's Access Key ID. 10 11 -s, --secret-key User's Secret Key. 12 13 -U, --url URL of the Cloud to connect to. 14 15 --config Read credentials and cloud settings from the 16 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 17 18 -h, --help Display this help message. 19 20 --version Display the version of this tool. 21 22 --debug Turn on debugging. euca-modify-image-attribute

Modify attributes for an image. view source print? 01 euca-modify-image-attribute [-l, --launch-permission] [-p, --product-code] 02 [-a, --add entity ] [-r, --remove entity] 03 [-h, --help] [--version] [--debug] image_id 04 05 REQUIRED PARAMETERS 06 07 image_id Unique identifier for the image that you want to modify the attributes for. 08 09 OPTIONAL PARAMETERS 10 11 -l, --launch-permission Show launch permissions. 12 13 -p, --product-code Show the product codes associated with the image 14 15 -a, -add Entity (typically, user id) to add. 16 17 -r, --remove Entity (typically, user id) to remove. 18 19 -A, --access-key User's Access Key ID. 20 21 -S, --secret-key User's Secret Key. 22 23 -U, --url URL of the Cloud to connect to. 24 25 --config Read credentials and cloud settings from the 26 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 27 28 -h, --help Display this help message. 29 30 --version Display the version of this tool. 31 32 --debug Turn on debugging. euca-reset-image-attribute

Reset attributes for an image. view source print? 01 euca-reset-image-attribute -l, --launch-permission 02 [-h, --help] [--version] [--debug] image_id 03 04 REQUIRED PARAMETERS 05 06 -l, --launch-permission show launch permissions. 07 08 image_id - unique identifier for the image that you want to reset the attributes for. 09 10 OPTIONAL PARAMETERS 11 12 -a, --access-key User's Access Key ID. 13 14 -s, --secret-key User's Secret Key. 15 16 -U, --url URL of the Cloud to connect to. 17 18 --config Read credentials and cloud settings from the 19 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 20 21 -h, --help Display this help message. 22 23 --version Display the version of this tool. 24 25 --debug Turn on debugging. euca-revoke

Revoke a rule for a security group. view source print? 01 euca-revoke [-P | --protocol protocol] [-p | --port-range port_range] 02 [-t | --icmp-type-code type:code] [-o | --source-group source_group] 03 [-u | --source-group-user source_group_user] [-s | --source-subnet source_subnet] 04 [-h, --help] [--version] [--debug] group_name 05 06 REQUIRED PARAMETERS 07 08 group_name Name of the group to add the rule to. 09 10 OPTIONAL PARAMETERS 11 12 -P, --protocol Protocol ("tcp" "udp" or "icmp"). 13 14 -p, --port-range Range of ports for the rule (specified as "from-to"). 15 16 -t, --icmp-type-code ICMP type and code specified as "type:code" 17 18 -o, --source-group Group from which traffic is authorized by the rule. 19 20 -u, --source-group-user User ID for the source group. 21 22 -s, --source-subnet The source subnet for the rule. 23 24 -A, --access-key User's Access Key ID. 25 26 -S, --secret-key User's Secret Key. 27 28 -U, --url URL of the Cloud to connect to. 29 30 --config Read credentials and cloud settings from the 31 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 32 33 -h, --help Display this help message. 34 35 --version Display the version of this tool. 36 37 --debug Turn on debugging. euca-version

Shows the Euca2ools version view source print? 1 euca-version [-h, --help] [--debug] euca-authorize

Add a new rule to a security group. view source print? 01 euca-authorize [-P, --protocol protocol] [-p, --port-range port_range] 02 [-t, --icmp-type-code type:code] [-o, --source-group source_group] 03 [-u, --source-group-user source_group_user] [-s, --source-subnet source_subnet] 04 [-h, --help] [--version] [--debug] group_name 05 06 REQUIRED PARAMETERS 07 08 group_name Name of the group to add the rule to. 09 10 OPTIONAL PARAMETERS 11 12 -P, --protocol Protocol ("tcp" "udp" or "icmp"). 13 14 -p, --port-range Range of ports for the rule (specified as "from-to"). 15 16 -t, --icmp-type-code ICMP type and code specified as "type:code" 17 18 -o, --source-group Group from which traffic is authorized by the rule. 19 20 -u, --source-group-user User ID for the source group. 21 22 -s, --source-subnet The source subnet for the rule. 23 24 -A, --access-key User's Access Key ID. 25 26 -S, --secret-key User's Secret Key. 27 28 -U, --url URL of the Cloud to connect to. 29 30 --config Read credentials and cloud settings from the 31 specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc). 32 33 -h, --help Display this help message. 34 35 --version Display the version of this tool. 36 37 --debug Turn on debugging. 38 39 Commands Available in UEC and not available in Eucalyptus installations Uec-publish-tarball view source print? 01 Usage: uec-publish-tarball [ options ] tarfile bucket [arch] 02 03 register a UEC tarball (ie, per http://uec-images.ubuntu.com) 04 05 if arch is not provided, a name-based attempt is made to guess 06 options: 07 08 -k | --kernel k use previously registered kernel with id 'k' 09 10 specify 'none' for no kernel 11 12 -K | --kernel-file f bundle, upload, use file 'f' as kernel 13 14 -r | --ramdisk r use previously registered ramdisk with id 'r' 15 16 specify 'none' for no ramdisk 17 18 -R | --ramdisk-file f bundle, upload, use file 'f' as ramdisk 19 --resize s resize the image to 's' bundling uploading 20 21 's' must be valid input to uec-resize-image 22 23 -q | --quiet be quiet, only output published ids 24 Example: uec-publish-tarball lucid-uec-i386.tar.gz my-lucid-bucket i386 uec-registration view source print? 1 uec-registration [--manual|--auto|--help] 2 3 Options: 4 5 --manual Disable automatic component registration 6 7 --auto Enable automatic component registration 8 9 -h, --help This message uec-run-instances view source print? 1 Same as euca-run-instances uec-publish-image view source print? 01 Usage: uec-publish-image [ options ] arch image bucket 02 03 arch : one of i386 or x86_64 04 05 image : the image to upload and register 06 07 bucket : bucket to publish image to 08 options: 09 10 l|-add-launch <user_id> : user_id can be "all", or "none" 11 12 --dry-run : only report what would be done 13 14 --allow-existing : if a image is already registered 15 16 simply report as if work was done 17 18 o|-output <file> : write registered id and manifest to file 19 |--rename <publish_path> : publish to bucket/<publish_path> 20 21 default: bucket/<basename(image)> 22 23 t|-type <type> : type is one of kernel/ramdisk/image 24 25 v|-verbose : increase verbosity 26 if type is 'image', then: 27 28 -k | --kernel k : use previously registered kernel with id 'k' 29 30 specify 'none' for no kernel 31 32 -K | --kernel-file f : bundle, upload, use file 'f' as kernel 33 34 -r | --ramdisk r : use previously registered ramdisk with id 'r' 35 36 specify 'none' for no ramdisk 37 38 -R | --ramdisk-file f : bundle, upload, use file 'f' as ramdisk 39 40 -B | --block-device-mapping m : specify block device mapping in bundle uec-query-builds view source print? 01 Usage: uec-query-builds [options] 02 03 Options: 04 -h, --help show this help message and exit 05 --suite=SUITE suite to query ('hardy', 'karmic', 'lucid') 06 --build-name=BUILD_NAME 07 build name ('server', 'desktop' ..) 08 --stream=STREAM stream query ('released', 'daily') 09 --base-url=BASE_URL the base url to query 10 --output=FILE write output to file, default is stdout 11 --serial=SERIAL build serial serial to use (YYYYMMDD) 12 --system-suite use output of 'lsb_release --codename --short' for 13 suite 14 --config=CONFIG yaml config file to read 15 --region=REGION the ec2 region to query 16 --img-type=TYPE the ec2 image type (one of: ebs, instance) 17 --arch=ARCH the architecture. (one of: i386, amd64) uec-resize-image view source print? 01 Usage: uec-query-builds [options] 02 03 Options: 04 -h, --help show this help message and exit 05 --suite=SUITE suite to query ('hardy', 'karmic', 'lucid') 06 --build-name=BUILD_NAME 07 build name ('server', 'desktop' ..) 08 --stream=STREAM stream query ('released', 'daily') 09 --base-url=BASE_URL the base url to query 10 --output=FILE write output to file, default is stdout 11 --serial=SERIAL build serial serial to use (YYYYMMDD) 12 --system-suite use output of 'lsb_release --codename --short' for 13 suite 14 --config=CONFIG yaml config file to read 15 --region=REGION the ec2 region to query 16 --img-type=TYPE the ec2 image type (one of: ebs, instance) 17 --arch=ARCH the architecture. (one of: i386, amd64) 18 uecadmin@ubuntuclustercontroller:~$ uec-resize-image --help 19 Usage: uec-resize-image [ options ] image size [output] 20 Resize a UEC image to a new size. 21 if output is given, do not modify 'image', but create new file 'output' 22 23 New size is specified per resize2fs(8), e.g. "1G" for 1 gigabyte 24 options: 25 26 -v | --verbose show command output

Referensi


Pranala Menarik