openstack/openstack-manuals
Code Issues Proposed changes

Merge "Updates to the 'Launch and manage instances' section"

Browse Source
This commit is contained in:
Jenkins 2014-05-08 04:33:49 +00:00 committed by Gerrit Code Review
commit ee7a3cc7e2
2 changed files with 196 additions and 201 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
doc/user-guide/section_dashboard_launch_instances.xml
View File

@ -76,25 +76,19 @@
<para>Select the instance from which to create a <para>Select the instance from which to create a
snapshot.</para></step> snapshot.</para></step>
<step> <step>
<para>From the <guilabel>Actions</guilabel> list, <para>In the <guilabel>Actions</guilabel> column, click
select <guilabel>Create <guilabel>Create Snapshot</guilabel>.</para>
Snapshot</guilabel>.</para>
</step> </step>
<step> <step>
<para>In the Create Snapshot dialog box, enter a name <para>In the Create Snapshot dialog box, enter a name for the
for the snapshot, and then click <guibutton>Create snapshot, and click <guibutton>Create Snapshot</guibutton>.</para>
Snapshot</guibutton>.</para> <para>The <guilabel>Images</guilabel> category shows the instance
<para>The <guilabel>Images &amp; Snapshots</guilabel> snapshot.</para>
category shows the instance snapshot.</para>
</step> </step>
</procedure> </procedure>
<para>To launch an instance from the snapshot, select the snapshot and
<para>To launch an instance from the snapshot, select click <guibutton>Launch</guibutton>. Proceed with
the snapshot and click <xref linkend="dashboard_launch_instances_from_image"/>.</para>
<guibutton>Launch</guibutton>. Proceed with
<xref
linkend="dashboard_launch_instances_from_image"
/>.</para>
</section> </section>
<section xml:id="control_instance_states"> <section xml:id="control_instance_states">
@ -109,13 +103,11 @@
</step> </step>
<step> <step>
<para>In the <guilabel>More</guilabel> list in the <para>In the <guilabel>More</guilabel> list in the
<guilabel>Actions</guilabel> column, select <guilabel>Actions</guilabel> column, select the state.</para>
the state.</para> <para>You can resize or rebuild an instance. You can also choose
<para>You can resize or rebuild an instance. You can to view the instance console log, edit instance or the security
also choose to view the instance console log. groups. Depending on the current state of the instance, you can
Depending on the current state of the instance, pause, resume, suspend, soft or hard reboot, or terminate it.</para>
you can pause, resume, suspend, soft or hard
reboot, or terminate it.</para>
</step> </step>
</procedure> </procedure>
</section> </section>

253
doc/user-guide/section_dashboard_launch_instances_from_image.xml
View File

@ -32,7 +32,7 @@
<procedure> <procedure>
<step> <step>
<para>Log in to the dashboard, choose a project, and click <para>Log in to the dashboard, choose a project, and click
<guilabel>Images &amp; Snapshot</guilabel>.</para> <guilabel>Images</guilabel>.</para>
<para>The dashboard shows the images that have been uploaded to <para>The dashboard shows the images that have been uploaded to
OpenStack Image Service and are available for this OpenStack Image Service and are available for this
project.</para> project.</para>
@ -42,8 +42,7 @@
Virtual Machine Image Guide</citetitle>.</para> Virtual Machine Image Guide</citetitle>.</para>
</step> </step>
<step> <step>
<para>Select an image and click <para>Select an image and click <guibutton>Launch</guibutton>.</para>
<guibutton>Launch</guibutton>.</para>
</step> </step>
<step> <step>
<para>In the Launch Instance dialog box, specify the following <para>In the Launch Instance dialog box, specify the following
@ -53,173 +52,177 @@
<col width="70%"/> <col width="70%"/>
<thead> <thead>
<tr> <tr>
<th colspan="2" align="center" <th colspan="2" align="center"><guilabel>Details</guilabel> tab</th>
><guilabel>Details</guilabel> tab</th>
</tr> </tr>
</thead> </thead>
<tbody> <tbody>
<tr> <tr>
<td><para><guilabel>Availability <td><para><guilabel>Availability Zone</guilabel></para></td>
Zone</guilabel></para></td>
<td> <td>
<para>By default, this value is set to the <para>By default, this value is set to the availability zone
availability zone given by the cloud provider given by the cloud provider (for example, <literal>us-west</literal>
(for example, <literal>us-west</literal> or or <literal>apac-south</literal>). For some cases, it could be
<literal>apac-south</literal>). For most
cases, it could be
<literal>nova</literal>.</para> <literal>nova</literal>.</para>
</td> </td>
</tr> </tr>
<tr> <tr>
<td><para><guilabel>Instance Name</guilabel></para></td> <td><para><guilabel>Instance Name</guilabel></para></td>
<td><para>Assign a name to the virtual machine.</para> <td><para>Assign a name to the virtual machine.</para>
<note> <note><para>The name you assign here becomes the initial host
<para>The name you assign here becomes the name of the server. After the server is built, if you change
initial host name of the server. After the the server name in the API or change the host name directly,
server is built, if you change the server the names are not updated in the dashboard.</para>
name in the API or change the host name <para>Server names are not guaranteed to be unique when
directly, the names are not updated in the created so you could have two instances with the same host
dashboard.</para> name.</para>
<para>Server names are not guaranteed to be
unique when created so you could have two
instances with the same host name.</para>
</note> </note>
</td> </td>
</tr> </tr>
<tr> <tr>
<td> <td><para><guilabel>Flavor</guilabel></para></td>
<para><guilabel>Flavor</guilabel></para></td> <td><para>Specify the size of the instance to launch.</para>
<td><para>Specify the size of the instance to <note><para>The flavor is selected based on the size of the
launch.</para></td> image selected for launching an instance. For example, while
</tr> creating an image, if you have entered the value in the
<tr> <guilabel>Minimun RAM (MB)</guilabel> field as 2048, then on
<td><para><guilabel>Instance selecting the image, the default flavor is
Count</guilabel></para></td> <guilabel>m1.small</guilabel>.</para>
<td><para>To launch multiple instances, enter a value </note>
greater than 1. The default is 1.</para></td>
</tr>
<tr>
<td>
<para>
<guilabel>Instance Boot Source</guilabel>
</para>
</td> </td>
</tr>
<tr>
<td><para><guilabel>Instance Count</guilabel></para></td>
<td><para>To launch multiple instances, enter a value greater
than 1. The default is 1.</para></td>
</tr>
<tr>
<td><para><guilabel>Instance Boot Source</guilabel></para></td>
<td><para>Your options are:</para> <td><para>Your options are:</para>
<itemizedlist> <variablelist>
<listitem> <varlistentry>
<para> <term><guilabel>Boot from image</guilabel></term>
<guilabel>Boot from <listitem><para>If you choose this option, a new field
image</guilabel>&mdash;If you choose for <guilabel>Image Name</guilabel> displays. You can
this option, a new field for select the image from the list.</para></listitem>
<guilabel>Image Name</guilabel> </varlistentry>
displays. You can select the image from <varlistentry>
the list.</para> <term><guilabel>Boot from snapshot</guilabel></term>
</listitem> <listitem><para>If you choose this option, a new field for
<listitem> <guilabel>Instance Snapshot</guilabel> displays. You
<para> can select the snapshot from the list.</para></listitem>
<guilabel>Boot from </varlistentry>
snapshot</guilabel>&mdash;If you choose <varlistentry>
this option, a new field for <term><guilabel>Boot from volume</guilabel></term>
<guilabel>Instance Snapshot</guilabel> <listitem><para>If you choose this option, a new field for
displays. You can select the snapshot <guilabel>Volume</guilabel> displays. You can select
from the list.</para> the volume from the list.</para></listitem>
</listitem> </varlistentry>
<listitem> <varlistentry>
<para> <term><guilabel>Boot from image (creates a new volume)</guilabel></term>
<guilabel>Boot from <listitem><para>With this option, you can boot from an
volume</guilabel>&mdash;If you choose image and create a volume by entering the
this option, a new field for <guilabel>Device Size</guilabel> and <guilabel>Device Name</guilabel>
<guilabel>Volume</guilabel> displays. for your volume. Click the <guilabel>Delete on Terminate</guilabel>
You can select the volume from the option to delete the volume on terminating the instance.
list.</para> </para></listitem>
</listitem> </varlistentry>
<listitem> <varlistentry>
<para> <term><guilabel>Boot from volume snapshot (creates a new
<guilabel>Boot from image (creates a new volume)</guilabel></term>
volume) </guilabel>&mdash;With this <listitem><para>Using this option, you can boot from a
option, you can boot from an image and volume snapshot and create a new volume by choosing
create a volume by entering the <guilabel>Volume Snapshot</guilabel> from a list and
<guilabel>Device Size</guilabel> and adding a <guilabel>Device Name</guilabel> for your volume.
<guilabel>Device Name</guilabel> for Click the <guilabel>Delete on Terminate</guilabel> option
your volume.</para> to delete the volume on terminating the instance.
</listitem> </para></listitem>
<listitem> </varlistentry>
<para> </variablelist>
<guilabel>Boot from volume snapshot
(creates a new volume)</guilabel>&mdash;
Using this option, you can boot from a
volume snapshot and create a new volume
by choosing <guilabel>Volume
Snapshot</guilabel> from a list and
adding a <guilabel>Device
Name</guilabel> for your volume.</para>
</listitem>
</itemizedlist>
<para>Since you are launching an instance from an <para>Since you are launching an instance from an
image, <guilabel>Boot from image</guilabel> is image, <guilabel>Boot from image</guilabel> is
chosen by default.</para> chosen by default.</para>
</td> </td>
</tr> </tr>
<tr> <tr>
<td> <td><para><guilabel>Image Name</guilabel></para></td>
<para> <td><para>This field changes based on your previous selection.
<guilabel>Image Name</guilabel> Since you have chosen to launch an instance using an image,
</para> the <guilabel>Image Name</guilabel> field displays. Select
</td> the image name from the dropdown list.</para>
<td>
<para>This field changes based on your previous
selection. Since you have chosen to launch an
instance using an image, the <guilabel>Image
Name</guilabel> field displays. Select the
image name from the dropdown list.</para>
</td> </td>
</tr> </tr>
<tr> <tr>
<th colspan="2" align="center"><guilabel>Access &amp; <th colspan="2" align="center"><guilabel>Access &amp; Security
Security</guilabel> tab</th> </guilabel> tab</th>
</tr> </tr>
<tr> <tr>
<td><para><guilabel>Keypair</guilabel></para></td> <td><para><guilabel>Keypair</guilabel></para></td>
<td><para>Specify a key pair.</para> <td><para>Specify a key pair.</para>
<para>If the image uses a static root password or a <para>If the image uses a static root password or a
static key set (neither is recommended), you do static key set (neither is recommended), you do
not need to provide a key pair to launch the not need to provide a key pair to launch the instance.</para></td>
instance.</para></td>
</tr> </tr>
<tr> <tr>
<td><para><guilabel>Security <td><para><guilabel>Security Groups</guilabel></para></td>
Groups</guilabel></para></td>
<td><para>Activate the security groups that you want to <td><para>Activate the security groups that you want to
assign to the instance.</para> assign to the instance.</para>
<para>Security groups are a kind of cloud firewall <para>Security groups are a kind of cloud firewall that
that define which incoming network traffic is define which incoming network traffic is forwarded to
forwarded to instances. For details, see <xref instances. For details, see <xref linkend="security_groups_add_rule"/>.
linkend="security_groups_add_rule"/>.</para> </para>
<para>If you have not created any security groups, <para>If you have not created any security groups, you can
you can assign only the default security group assign only the default security group to the instance.
to the instance.</para></td> </para></td>
</tr> </tr>
<tr> <tr>
<th colspan="2" align="center" <th colspan="2" align="center"><guilabel>Networking</guilabel> tab</th>
><guilabel>Networking</guilabel> tab</th>
</tr> </tr>
<tr> <tr>
<td><para><guilabel>Selected <td><para><guilabel>Selected Networks</guilabel></para></td>
Networks</guilabel></para></td>
<td><para>To add a network to the instance, click the <td><para>To add a network to the instance, click the
<guibutton>+</guibutton> in the <guibutton>+</guibutton> in the <guilabel>Available Networks</guilabel>
<guilabel>Available Networks</guilabel> field.</para>
field.</para></td> </td>
</tr> </tr>
<tr> <tr>
<th colspan="2" align="center" <th colspan="2" align="center"><guilabel>Post-Creation</guilabel> tab</th>
><guilabel>Post-Creation</guilabel> tab</th>
</tr> </tr>
<tr> <tr>
<td><para><guilabel>Customization <td><para><guilabel>Customization Script</guilabel></para></td>
Script</guilabel></para></td> <td><para>Specify a customization script that runs after your
<td><para>Specify a customization script that runs after instance launches.</para></td>
your instance launches.</para></td> </tr>
<tr>
<th colspan="2" align="center"><guilabel>Advanced Options</guilabel> tab</th>
</tr>
<tr>
<td><para><guilabel>Disk Partition</guilabel></para></td>
<td><para>Select the type of disk partition from the dropdown
list.</para>
<variablelist>
<varlistentry>
<term><guilabel>Automatic</guilabel></term>
<listitem>
<para>Entire disk is single partition and
automatically resizes.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Manual</guilabel></term>
<listitem>
<para>Faster build times but requires
manual partitioning.</para></listitem>
</varlistentry>
</variablelist>
<!--Currently this tab is displayed all the time. As a
part of LP#1306302, this will be available only when the
nova_diskconfig setting is enabled. Will remove the
comment and include this note when the bug is backported
to Icehouse.
<note>
<para>This tab is displayed only if you have enabled
the nova_diskconfig extension.</para>
</note>-->
</td>
</tr> </tr>
</tbody> </tbody>
</informaltable> </informaltable>