[cloud-guide] Updated POTs

Eric Christensen sparks at fedoraproject.org
Mon Nov 7 22:04:19 UTC 2011


commit 4f57aaaa20acce6bbaf6e0fcf62da8782e51c3bf
Author: Eric 'Sparks' Christensen <sparks at fedoraproject.org>
Date:   Mon Nov 7 17:04:02 2011 -0500

    Updated POTs

 pot/Aeolus.pot           |    4 +-
 pot/AmazonEC2.pot        |  668 +++++++++++++++++++++++++++++++++++++++++++++-
 pot/AmazonS3.pot         |    4 +-
 pot/Author_Group.pot     |    4 +-
 pot/Book_Info.pot        |    4 +-
 pot/BoxGrinder.pot       |    4 +-
 pot/Ceph.pot             |    4 +-
 pot/Cloud_Guide.pot      |    4 +-
 pot/Cloudstack.pot       |    4 +-
 pot/Deltacloud.pot       |    4 +-
 pot/HekaFS.pot           |    4 +-
 pot/Images.pot           |    4 +-
 pot/Introduction.pot     |    4 +-
 pot/Matahari.pot         |    4 +-
 pot/Openshift.pot        |    4 +-
 pot/Openstack.pot        |    4 +-
 pot/Preface.pot          |    4 +-
 pot/Revision_History.pot |    9 +-
 pot/Sheepdog.pot         |    4 +-
 19 files changed, 701 insertions(+), 44 deletions(-)
---
diff --git a/pot/Aeolus.pot b/pot/Aeolus.pot
index e3fd8e2..b0930e5 100644
--- a/pot/Aeolus.pot
+++ b/pot/Aeolus.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:43\n"
+"PO-Revision-Date: 2011-11-07T22:03:43\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/AmazonEC2.pot b/pot/AmazonEC2.pot
index 95cf1ba..3368abf 100644
--- a/pot/AmazonEC2.pot
+++ b/pot/AmazonEC2.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:43\n"
+"PO-Revision-Date: 2011-11-07T22:03:43\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
@@ -24,7 +24,137 @@ msgstr ""
 
 #. Tag: para
 #, no-c-format
-msgid "The Amazon EC2 provides a place for anyone with an account to create and operate their own virtualized computing environment. As one of the largest Infrastructure-as-a-Service (IaaS) providers, Amazon provides an almost unlimited"
+msgid "Amazon Web Services (commonly refered to as <acronym>AWS</acronym>) is a <emphasis>public cloud</emphasis>, a collection of computing services that allows one to build and run software services in Amazon's data centers. Fedora publishes system images for AWS's virtual machine platform, <emphasis>Amazon Elastic Compute Cloud</emphasis> (or <acronym>EC2</acronym>), which allows one to create virtual machines in the Amazon cloud with very little effort. The objective of this section is to familiarize the reader with EC2's terminology and functionality. For more detailed documentation, see the <ulink url=\"http://aws.amazon.com/\">AWS website</ulink>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "EC2 concepts"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "What follows are some short explanations of EC2 terminology. For more detailed information, see the <ulink url=\"http://aws.amazon.com/documentation/ec2/\">EC2 documentation</ulink>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Images and Instances"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "A <emphasis>machine image</emphasis> is a snapshot of a system (specifically its root filesystem) that provides the basis for a virtual machine in EC2. When you run a new virtual machine in EC2 you choose a machine image to use as a template. The new virtual machine is then an <emphasis>instance</emphasis> of that machine image that contains its own copy of everything in the image. The instance keeps running until you stop or terminate it, or until it fails. If an instance fails, you can launch a new one from the same image. You can create multiple instances of a single machine image. Each instance will be independent of the others."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can use a single image or multiple images, depending on your needs. From a single image, you can launch different types of instances. An <emphasis>instance type</emphasis> defines what hardware the instance has, including the amount of memory, disk space, and CPU power."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Amazon, Fedora, other groups, and individuals publish images for public use. You might only need to use images that reputable sources provide, and you can simply customize the resulting instances to suit your needs as you launch them. You can also create your own machine images, but that is beyond the scope of this document."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Machine images in EC2 are sometimes referred to as <emphasis>AMIs</emphasis>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Machine images have identifiers that begin with <literal>ami</literal>, such as <literal>ami-6ebe4507</literal>. Instances have identifiers that begin with the letter <literal>i</literal>, such as <literal>i-12459dbd</literal>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Regions and Availability Zones"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Amazon hosts datacenters many parts of the world. Those from a particular part of the world make up a <emphasis>region</emphasis>. Regions' names are based on their locations, such as in <literal>us-east-1</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Regions are broken up into <emphasis>availability zones</emphasis>, which are designed to isolate failures from one another but still provide faster communication than communication between regions. Distributing a web application amongst several availability zones can help improve its reliability if an availability zone encounters problems. Availability zones' names are based on the regions in which they reside, such as <literal>us-east-1a</literal>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Storage"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "EC2 instances use one or more of three types of storage provided by AWS:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Simple Storage Service (S3)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Amazon Simple Storage Service (S3) is a web service-based storage system that is accessible inside EC2 and elsewhere on the Internet. As this document will not focus on S3, see the <ulink url=\"http://aws.amazon.com/s3\">Amazon S3</ulink> documentation for more details."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Elastic Block Store (EBS)"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Amazon Elastic Block Store (EBS) provides instances with persistent, disk-like storage that you can attach to and detach from instances, similar to portable disk drives. By creating EBS <emphasis>volumes</emphasis> and attaching them to instances you can store data that you wish to be portable to more than one instance in the event an instance fails or is replaced. Since instances' root filesystem tend to have limited space, volumes also provide a simple way of adding additional disk capacity to instances."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Volumes have identifiers that begin with <literal>vol</literal>, such as <literal>vol-ffe93704</literal>."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can create a backup <emphasis>snapshot</emphasis> of a volume. From the snapshot you can then create a new volume and attach it to another instance. You can create multiple volumes from the same snapshot. Each volume will be independent of the others."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Snapshots have identifiers that begin with <literal>snap</literal>, such as <literal>snap-773491a0</literal>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Instance Storage"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Some instance types have <emphasis>instance storage</emphasis>, scratch space that persists only as long as an instance runs. Instance storage is destroyed when an instance stops, terminates, or fails. For this reason, it is also referred to as ephemeral storage."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When EC2 was first introduced, all machine images were <emphasis role=\"strong\">backed by instance storage</emphasis>, meaning that their instances' root filesystems were stored in instance storage. Machine images can now also be <emphasis role=\"strong\">backed by EBS</emphasis>, meaning that their instances' root filesystem instead reside on EBS volumes."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Security Groups"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "A <emphasis>security group</emphasis> defines firewall rules for your EC2 instances. These rules specify which incoming network traffic should be delivered to an instance (e.g., accept web traffic on port <literal>80</literal> or SSH traffic on port <literal>22</literal>). All other traffic is ignored. By default, a security group has no rules, which causes it to block all incoming traffic. You can modify the rules for a security group at any time."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Every instance runs inside of a security group. You can create your own security groups, or you can use the <literal>default</literal> security group that EC2 provides for you. When you run a new instance it will run in the <literal>default</literal> security group unless you choose a different one."
 msgstr ""
 
 #. Tag: title
@@ -32,6 +162,21 @@ msgstr ""
 msgid "Signing up for an EC2 account"
 msgstr ""
 
+#. Tag: para
+#, no-c-format
+msgid "To use AWS you need to create an online account. You can do this by following the steps below:"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Amazon AWS is not free"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "AWS is designed as a pay-as-you-go online service. Much of EC2 is free for new users; the rest is available for per-hour or per-month fees that are detailed on the <ulink url=\"http://aws.amazon.com/ec2/#pricing\">EC2 Website</ulink>. As such, Amazon requests a credit card number to keep on file with your new account."
+msgstr ""
+
 #. Tag: title
 #, no-c-format
 msgid "Launch Web Browser"
@@ -139,26 +284,533 @@ msgstr ""
 
 #. Tag: title
 #, no-c-format
-msgid "Access Identifiers"
+msgid "Connecting to EC2 using euca2ools"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "One can interact with EC2 through either a web-based <ulink url=\"https://console.aws.amazon.com/ec2/\">management console</ulink> or via <application>euca2ools</application>, a suite of command line tools designed for services like EC2. This tutorial will focus on using EC2 with euca2ools at the command line."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To using the command line tools you first need to obtain access keys for your account. You can find them by going to the AWS management console on the web, clicking your name on the top, followed by <emphasis>Security Credentials</emphasis>, and scrolling down to the section titled <emphasis>Access Credentials</emphasis>. Make note of the <emphasis>Access Key ID</emphasis> and the <emphasis>Secret Access Key</emphasis> that appears beside it. Both of them should be long sets of alphanumeric characters. Create a file called <filename>.iamrc</filename> in your home directory that contains those keys in this format:"
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "AWSAccessKeyId=<replaceable>your_access_key_id</replaceable>\n"
+"AWSSecretKey=<replaceable>your_secret_key</replaceable>\n"
+""
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Since euca2ools is designed to work with all AWS-compatible clouds, not just AWS itself, it needs to know which cloud to contact. Create a file called <filename>.eucarc</filename> in your home directory with the following content to point it toward AWS:"
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "export AWS_CREDENTIAL_FILE=~/.iamrc\n"
+"export EC2_URL=https://ec2.amazonaws.com/\n"
+"export S3_URL=https://s3.amazonaws.com/\n"
+"export EUARE_URL=https://iam.amazonaws.com/\n"
+"\n"
+"source \"$AWS_CREDENTIAL_FILE\"\n"
+"export EC2_ACCESS_KEY=$AWSAccessKeyId\n"
+"export EC2_SECRET_KEY=$AWSSecretKey\n"
+"export AWS_ACCESS_KEY=$AWSAccessKeyId\n"
+"export AWS_SECRET_ACCESS_KEY=$AWSSecretKey\n"
+""
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Finally, add these settings to your shell's environment by running: <command><prompt>$ </prompt>source ~/.eucarc</command>"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Installing the euca2ools package"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Installing the <application>euca2ools</application> package is simple. To do so with yum, run the following command as the <literal>root</literal> user: <command><prompt># </prompt>yum install euca2ools</command>"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Choosing your EC2 region"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Next, choose an EC2 region to use. Things to consider when choosing a region include its geographic location, the pricing for instances in that region, and whether the image you wish to use is available in that region. You can get a list of regions by running the <command>euca-describe-regions</command>, which results in a list such as this:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "REGION  eu-west-1       ec2.eu-west-1.amazonaws.com\n"
+"REGION  us-east-1       ec2.us-east-1.amazonaws.com\n"
+"REGION  ap-northeast-1  ec2.ap-northeast-1.amazonaws.com\n"
+"REGION  us-west-1       ec2.us-west-1.amazonaws.com\n"
+"REGION  ap-southeast-1  ec2.ap-southeast-1.amazonaws.com\n"
+""
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When you choose an EC2 region you can make euca2ools start using it by editing the line that contains <literal>EC2_URL</literal> in your <filename>.eucarc</filename> file. For example:"
+msgstr ""
+
+#. Tag: programlisting
+#, no-c-format
+msgid "export EC2_URL=https://ec2.us-east-1.amazonaws.com/"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "After adjusting the region in the <filename>.eucarc</filename> file, reset the settings in your shell's environment by running this command: <command><prompt>$ </prompt>source ~/.eucarc</command>"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Creating a key pair"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The primary way of logging into Fedora instances running in EC2 is via <application>SSH</application>. Since Fedora instances have no passwords, you need a SSH <emphasis>key pair</emphasis> to log in to them. The private half of this key pair is stored on your computer, while the public half is stored in EC2 so instances can download them as they start. This allows you to securely log into your instances without a password."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can have multiple key pairs. Each key pair has its own name. Key pairs are specific to each EC2 region."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Choose a name for a new key pair and then use the <command>euca-add-keypair</command> command to create it and write the private key to a file. Be sure to choose a name that is easy to remember. To create your new key pair, run the following command, replacing <replaceable>mykey</replaceable> with a memorable name:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-add-keypair <replaceable>mykey</replaceable> &gt; <replaceable>mykey</replaceable>.pem</command>"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Key pairs are irreplaceable"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "EC2 does not store the private halves of key pairs. The time you run <command>euca-add-keypair</command> is the only chance you will have to save a copy of the private key. There is no way to recover a lost private key from EC2."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can use <code>euca-describe-keypairs</code> to display a list of your keypairs."
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-describe-keypairs</command>\n"
+"KEYPAIR mykey1  7b:9b:33:cf:bf:12:4d:62:b6:7c:fa:02:f2:f7:bc:59:e3:7e:40:fb\n"
+"KEYPAIR mykey2  f9:93:1e:73:4b:2e:c1:0d:7f:79:e1:bc:c0:d0:7c:95:32:55:b7:dd\n"
+""
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can use <command>euca-delete-keypairs</command> to delete a keypair. Deleting a keypair does not remove it from instances that are already running; it merely prevents new instances from using it."
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-delete-keypair <replaceable>mykey1</replaceable></command>"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Setting up a security group"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Each security group has its own set of firewall rules. While this tutorial uses the <literal>default</literal> security group that EC2 provides for you, you can also create your own security groups."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <command>euca-authorize</command> command lets you tell EC2 to allow traffic from ranges of IP addresses and ports into a security group. To allow access to SSH (TCP port <literal>22</literal>) running on instances in the <literal>default</literal> security group, run the following command replacing <replaceable>1.2.3.4</replaceable> with the IP address from which you will connect to your EC2 instances."
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-authorize default -p 22 -s <replaceable>1.2.3.4/32</replaceable></command>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "If you do not specify a range of IP addresses then the port(s) you choose will be open to the entire Internet. For example, the following command allows SSH access from any machine, not just your computer:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-authorize default -p 22</command>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To allow pings and other ICMP traffic you can run:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-authorize default -P icmp</command>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The opposite of <command>euca-authorize</command> is <command>euca-revoke</command>. You can use <command>euca-describe-groups</command> to obtain a list of security groups and the firewall permissions you have applied to them."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Running EC2 Instances"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Now that our preparation work is done, we can start running EC2 instances."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Choosing an image"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The Cloud SIG maintains an <ulink url=\"http://fedoraproject.org/wiki/Cloud_SIG/EC2_Images\">index of machine images published by Fedora</ulink>. While all of the images for a given release behave the same, they differ by architecture, EC2 region, and where the root filesystem is stored (that is, instance store or EBS). Choose the image that is most appropriate for you and note its ID, which begins with <literal>ami</literal>."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Choosing an instance type"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Amazon offers several instance types, which are <ulink url=\"http://aws.amazon.com/ec2/instance-types/\">detailed on the EC2 web site</ulink>. As of the time of writing, the smallest and cheapest instance types are <literal>m1.small</literal> and <literal>t1.micro</literal>, though each of those carries a restriction: <literal>m1.small</literal> instances must use the i386 architecture. <literal>t1.micro</literal> instances have no instance storage and therefore must boot from EBS. If the image you choose fits neither of these criteria or if you simply need more resources than they can provide then you need to use a larger and more expensive instance type."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Running an instance"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can start a new instance of the image and instance type you chose with <command>euca-run-instances</command>. To be able to log into the new instance, you must also specify the name of the key pair you created earlier. For example, to run a <literal>t1.micro</literal> instance of the image <literal>ami-7f5a063a</literal> with a key pair named <literal>mykey</literal>, run the following command:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-run-instances ami-7f5a063a -t t1.micro -k mykey</command>\n"
+"RESERVATION  r-4d5ea00a  0123456789ab  default\n"
+"INSTANCE     i-910fbbd6  ami-7f5a063a  pending  0  mykey  t1.micro  2011-10-11T00:00:00.000Z us-east-1c  aki-9ba0f1de\n"
+""
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The output of <command>euca-run-instances</command> contains the ID of the instance you just started. In the example above, the instance's ID is <literal>i-910fbbd6</literal>. You will need this ID to use tools that need to refer to the instance."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The instance starts in the <literal>pending</literal> state. When it finished booting it changes to the <literal>running</literal> state. When you terminate it it changes to the <literal>shutting-down</literal> and finally <literal>terminated</literal> states."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Logging into an instance"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "As the instance starts it obtains an IP address from EC2 and changes to the <literal>running</literal> state. You can check on your instances by running <literal>euca-describe-instances</literal>, optionally with the ID of the instance in question. When the instance is ready (or nearly ready) to use, <command>euca-describe-instances</command> will display the address you can use to log into it:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-describe-instances</command>\n"
+"RESERVATION  r-4d5ea00a  0123456789ab  default\n"
+"INSTANCE     i-910fbbd6  ami-7f5a063a  ec2-204-236-168-22.us-east-1.compute.amazonaws.com  ip-10-170-15-23.us-east-1.compute.internal  running  0  mykey  t1.micro  2011-10-11T00:00:00.000Z us-east-1c  aki-9ba0f1de\n"
+""
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The public address of the instance in this example is <literal>ec2-204-236-168-22.us-east-1.compute.amazonaws.com</literal>. Other useful bits of information from this command include the availability zone in which the instance is running (<literal>us-east-1c</literal> in this case) and the time that the instance started."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Once the instance is <literal>running</literal> you can log into it with <command>ssh</command>. On Fedora's images you should log in as the user <literal>ec2-user</literal>:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>ssh -i mykey.pem ec2-user at ec2-204-236-168-22.us-east-1.compute.amazonaws.com</command>\n"
+"<command><prompt>[ec2-user at i-910fbbd6 ~]$ </prompt>cat /etc/fedora-release</command>\n"
+"Fedora release 16 (Verne)\n"
+""
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can now use the instance as you would use any other computer running Fedora."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Terminating an instance"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When you finish using an instance you should terminate it with the <command>euca-terminate-instances</command> command to free up resources and reduce your costs:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-terminate-instances <replaceable>i-910fbbd6</replaceable></command>"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Using Elastic Block Storage (EBS)"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Managing volumes"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "EBS volumes act like removable disks that you can attach to instances, except you can create and destroy them at will. Each volume is specific to an availability zone. The following section will show you how to use and manage EBS volumes."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Creating volumes"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can create a volume of nearly any size, in 1 GiB increments. As of the time of writing, the maximum size of a volume is 1 TiB. To create a new, empty volume, choose a size (in GiB) and the availability zone in which to create it and supply those values to <command>euca-create-volume</command>:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-create-volume -s 10 -z us-east-1c</command>\n"
+"VOLUME  vol-23ca3542  10  creating  2011-10-11T00:00:00.000Z\n"
+""
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The command's output contains the ID of the newly-created volume. In the example above, the volume's ID is <literal>vol-23ca3542</literal>. You will need this ID to use tools that need to refer to the volume."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Describing volumes"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <command>euca-describe-volumes</command> will provide a list of all volumes available to you in the entire region in addition to where they are attached:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-describe-volumes</command>\n"
+"VOLUME  vol-23ca3542  10  us-east-1c  available  2011-10-11T00:00:00.000Z\n"
+""
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Using volumes"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "For an instance to make use of a volume you must first <emphasis>attach</emphasis> the volume to the instance. You also need to supply a <emphasis role=\"strong\">device name</emphasis> that the volume should appear as from inside the instance. The device name you choose must be <literal>/dev/sd<replaceable>X</replaceable></literal>, where <replaceable>X</replaceable> is a letter. It will appear inside the instance as either <literal>/dev/sd<replaceable>X</replaceable></literal> or <literal>/dev/xvd<replaceable>X</replaceable></literal>."
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-attach-volume -i i-910fbbd6 -d /dev/sdf vol-23ca3542</command>"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Volumes are zone-specific"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Each volume exists only within one availability zone. A volume in a given zone can therefore only be attached to instances that are running in the same zone."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Once you have attached a volume to the instance it will appear as a disk in the instance's /dev directory, ready to be formatted and used."
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>[ec2-user at i-910fbbd6 ~]$ </prompt>mkfs.ext4 /dev/xvdf</command>\n"
+"<command><prompt>[ec2-user at i-910fbbd6 ~]$ </prompt>mount /dev/xvdf /mnt</command>\n"
+""
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When you finish using a volume you can unmount it from within the instance and then <emphasis>detach</emphasis> it:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>[ec2-user at i-910fbbd6 ~]$ </prompt>umount /dev/xvdf</command>\n"
+"<command><prompt>[ec2-user at i-910fbbd6 ~]$ </prompt>logout</command>\n"
+"<command><prompt>$ </prompt>euca-detach-volume vol-23ca3542</command>\n"
+""
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Deleting volumes"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "When you finish using an EBS volume you can delete it to free up resources and reduce your costs:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-delete-volume vol-23ca3542</command>"
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Using snapshots"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Volume snapshots provide an easy way to save a backup copy of an entire volume. Unlike a volume, a snapshot is available to all availability zones within a region, which makes snapshots the simplest way to copy a volume between availability zones."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Creating a snapshot"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can create a snapshot by providing the name of the volume you wish to take a snapshot of to <command>euca-create-snapshot</command>:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-create-snapshot vol-23ca3542</command>\n"
+"SNAPSHOT  snap-00acc96e  vol-23ca3542  pending  2011-10-11T00:00:00.000Z\n"
+""
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The command's output contains the ID of the newly-created snapshot. In the example above, the snapshot's ID is <literal>snap-00acc96e</literal>. You will need this ID to use tools that need to refer to the snapshot."
+msgstr ""
+
+#. Tag: title
+#, no-c-format
+msgid "Volumes should not change while creating snapshots"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Snapshots take time to complete. While a snapshot is in progress, ensure that the contents of the volume do not change to avoid data corruption. You can monitor a snapshot's progress with <command>euca-describe-snapshots</command>."
 msgstr ""
 
 #. Tag: title
 #, no-c-format
-msgid "AMIs and the available Fedora AMIs"
+msgid "Describing snapshots"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "The <command>euca-describe-snapshots</command> will provide a list of all snapshots available to you in the region:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-describe-snapshots</command>\n"
+"SNAPSHOT   snap-00acc96e   vol-042d3a6a  completed  2011-10-12T05:56:29.000Z  100%\n"
+""
 msgstr ""
 
 #. Tag: title
 #, no-c-format
-msgid "Connecting to EC2 via ElasticFox"
+msgid "Dealing with too much output"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "By default, <command>euca-describe-snapshots</command> will list all snapshots that you can access, including those that you do not own. To narrow down the command's output you can supply a list of snapshots to the command or use any of its numerous methods of filtering output."
 msgstr ""
 
 #. Tag: title
 #, no-c-format
-msgid "Connecting to EC2 via Amazon's Web Interface"
+msgid "Creating volumes from snapshots"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To copy the contents of a snapshot to a new volume, run <code>euca-create-volume</code> and specify a snapshot instead of a size:"
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-create-volume --snapshot snap-00acc96e -z us-east-1c</command>"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can create multiple volumes from the same snapshot. Each volume will be independent of the others."
 msgstr ""
 
 #. Tag: title
 #, no-c-format
-msgid "Connecting to EC2 via Python Boto"
+msgid "Deleting snapshots"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To delete a snapshot, use <code>euca-delete-snapshot</code>. Any volumes created from that snapshot will be unaffected."
+msgstr ""
+
+#. Tag: screen
+#, no-c-format
+msgid "<command><prompt>$ </prompt>euca-delete-snapshot snap-00acc96e</command>"
 msgstr ""
 
diff --git a/pot/AmazonS3.pot b/pot/AmazonS3.pot
index 6dedf45..accb5ed 100644
--- a/pot/AmazonS3.pot
+++ b/pot/AmazonS3.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:43\n"
+"PO-Revision-Date: 2011-11-07T22:03:43\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/Author_Group.pot b/pot/Author_Group.pot
index 7973315..0c14868 100644
--- a/pot/Author_Group.pot
+++ b/pot/Author_Group.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:43\n"
+"PO-Revision-Date: 2011-11-07T22:03:43\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/Book_Info.pot b/pot/Book_Info.pot
index 364d199..e78be95 100644
--- a/pot/Book_Info.pot
+++ b/pot/Book_Info.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:43\n"
+"PO-Revision-Date: 2011-11-07T22:03:43\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/BoxGrinder.pot b/pot/BoxGrinder.pot
index 7054008..901e759 100644
--- a/pot/BoxGrinder.pot
+++ b/pot/BoxGrinder.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:43\n"
+"PO-Revision-Date: 2011-11-07T22:03:43\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/Ceph.pot b/pot/Ceph.pot
index 66985f6..a333e57 100644
--- a/pot/Ceph.pot
+++ b/pot/Ceph.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:43\n"
+"PO-Revision-Date: 2011-11-07T22:03:43\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/Cloud_Guide.pot b/pot/Cloud_Guide.pot
index c16e951..b30c919 100644
--- a/pot/Cloud_Guide.pot
+++ b/pot/Cloud_Guide.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:43\n"
+"PO-Revision-Date: 2011-11-07T22:03:43\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/Cloudstack.pot b/pot/Cloudstack.pot
index 5032fb1..0385c87 100644
--- a/pot/Cloudstack.pot
+++ b/pot/Cloudstack.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:43\n"
+"PO-Revision-Date: 2011-11-07T22:03:43\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/Deltacloud.pot b/pot/Deltacloud.pot
index 1e5e3e6..d7a9cd7 100644
--- a/pot/Deltacloud.pot
+++ b/pot/Deltacloud.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:43\n"
+"PO-Revision-Date: 2011-11-07T22:03:43\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/HekaFS.pot b/pot/HekaFS.pot
index 3ab5612..0722ab0 100644
--- a/pot/HekaFS.pot
+++ b/pot/HekaFS.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:43\n"
+"PO-Revision-Date: 2011-11-07T22:03:43\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/Images.pot b/pot/Images.pot
index 4a684d3..20a0ff0 100644
--- a/pot/Images.pot
+++ b/pot/Images.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:43\n"
+"PO-Revision-Date: 2011-11-07T22:03:43\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/Introduction.pot b/pot/Introduction.pot
index ce5d033..40eb3b4 100644
--- a/pot/Introduction.pot
+++ b/pot/Introduction.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:43\n"
+"PO-Revision-Date: 2011-11-07T22:03:43\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/Matahari.pot b/pot/Matahari.pot
index 4db787e..cc919ef 100644
--- a/pot/Matahari.pot
+++ b/pot/Matahari.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:43\n"
+"PO-Revision-Date: 2011-11-07T22:03:43\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/Openshift.pot b/pot/Openshift.pot
index e137578..3b737af 100644
--- a/pot/Openshift.pot
+++ b/pot/Openshift.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:44\n"
+"PO-Revision-Date: 2011-11-07T22:03:44\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/Openstack.pot b/pot/Openstack.pot
index 9d865c7..a1c87a6 100644
--- a/pot/Openstack.pot
+++ b/pot/Openstack.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:44\n"
+"PO-Revision-Date: 2011-11-07T22:03:44\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/Preface.pot b/pot/Preface.pot
index 9e40cc9..b350b89 100644
--- a/pot/Preface.pot
+++ b/pot/Preface.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:44\n"
+"PO-Revision-Date: 2011-11-07T22:03:44\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
diff --git a/pot/Revision_History.pot b/pot/Revision_History.pot
index 714025c..432d28d 100644
--- a/pot/Revision_History.pot
+++ b/pot/Revision_History.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:44\n"
+"PO-Revision-Date: 2011-11-07T22:03:44\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"
@@ -29,6 +29,11 @@ msgstr ""
 
 #. Tag: member
 #, no-c-format
+msgid "Updated EC2 chapter."
+msgstr ""
+
+#. Tag: member
+#, no-c-format
 msgid "Updated CloudStack section."
 msgstr ""
 
diff --git a/pot/Sheepdog.pot b/pot/Sheepdog.pot
index f18abcf..30c1f00 100644
--- a/pot/Sheepdog.pot
+++ b/pot/Sheepdog.pot
@@ -4,8 +4,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: 0\n"
-"POT-Creation-Date: 2011-10-04T13:24:34\n"
-"PO-Revision-Date: 2011-10-04T13:24:34\n"
+"POT-Creation-Date: 2011-11-07T22:03:44\n"
+"PO-Revision-Date: 2011-11-07T22:03:44\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: None\n"
 "MIME-Version: 1.0\n"


More information about the docs-commits mailing list