openstack-manuals/doc/user-guide/section_dashboard_launch_instances_from_image.xml
Diane Fleming 64b6c9261e Folder rename, file rename, flattening of directories
Current folder name	New folder name	        Book title
----------------------------------------------------------
basic-install 	        DELETE
cli-guide	        DELETE
common	                common
NEW	                admin-guide-cloud	Cloud Administrators Guide
docbkx-example	        DELETE
openstack-block-storage-admin 	DELETE
openstack-compute-admin 	DELETE
openstack-config 	config-reference	OpenStack Configuration Reference
openstack-ha 	        high-availability-guide	OpenStack High Availabilty Guide
openstack-image	        image-guide	OpenStack Virtual Machine Image Guide
openstack-install 	install-guide	OpenStack Installation Guide
openstack-network-connectivity-admin 	admin-guide-network 	OpenStack Networking Administration Guide
openstack-object-storage-admin 	DELETE
openstack-security 	security-guide	OpenStack Security Guide
openstack-training 	training-guide	OpenStack Training Guide
openstack-user 	        user-guide	OpenStack End User Guide
openstack-user-admin 	user-guide-admin	OpenStack Admin User Guide
glossary	        NEW        	OpenStack Glossary

bug: #1220407

Change-Id: Id5ffc774b966ba7b9a591743a877aa10ab3094c7
author: diane fleming
2013-09-08 15:15:50 -07:00

154 lines
7.0 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section [
<!-- Some useful entities borrowed from HTML -->
<!ENTITY ndash "&#x2013;">
<!ENTITY mdash "&#x2014;">
<!ENTITY hellip "&#x2026;">
]>
<section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="dashboard_launch_instances_from_image">
<title>Launch an instance from an image</title>
<?dbhtml stop-chunking?>
<para>When you launch an instance from an image, OpenStack creates
a local copy of the image on the Compute node where the
instance starts.</para>
<procedure>
<step>
<para>Log in to the OpenStack dashboard, choose a project,
and click the <guilabel>Images &amp;
Snapshot</guilabel> category.</para>
<para>The dashboard shows the images that have been
uploaded to OpenStack Image Service and are available
for this project.</para>
</step>
<step>
<para>Select an image and click
<guibutton>Launch</guibutton>.</para>
</step>
<step>
<para>In the <guilabel>Launch Image</guilabel> window,
specify the following values:</para>
<informaltable rules="all">
<col width="30%"/>
<col width="70%"/>
<thead>
<tr>
<th colspan="2" align="center"
><guilabel>Details</guilabel> tab</th>
</tr>
</thead>
<tbody>
<tr>
<td><para><guilabel>Instance
Source</guilabel></para></td>
<td><para>Image or snapshot.</para></td>
</tr>
<tr>
<td><para><guilabel>Instance
Name</guilabel></para></td>
<td><para>The name to assign to the virtual
machine.</para></td>
</tr>
<tr>
<td>
<para><guilabel>Flavor</guilabel></para></td>
<td><para>The size of the virtual machine to
launch.</para></td>
</tr>
<tr>
<td><para><guilabel>Instance
Count</guilabel></para></td>
<td><para>To launch multiple instances, enter
a value greater than 1. Default is 1.
</para></td>
</tr>
<tr>
<th colspan="2" align="center"
><guilabel>Access &amp;
Security</guilabel> tab</th>
</tr>
<tr>
<td><para><guilabel>Keypair</guilabel></para></td>
<td><para>A keypair.</para>
<para>In case an image uses a static root
password or a static key set (neither
is recommended), you do not need to
provide a keypair to launch the
instance.</para></td>
</tr>
<tr>
<td><para><guilabel>Security
Groups</guilabel></para></td>
<td><para>Activate the security groups that
you want to assign to the
instance.</para>
<para>Security groups are a kind of cloud
firewall that define which incoming
network traffic is forwarded to
instances. For details, see <xref
linkend="security_groups_add_rule"
/>.</para>
<para>If you have not created any security
groups, you can assign only the
default security group to the
instance.</para></td>
</tr>
<tr>
<th colspan="2" align="center"
><guilabel>Volume Options</guilabel>
tab</th>
</tr>
<tr>
<td><para><guilabel>Volume
Options</guilabel></para></td>
<td><para>Not applicable when you launch an
instance from an image.</para><para>To
launch from a volume or volume
snapshot, select the appropriate
option in the <guilabel>Volume
Options</guilabel> drop-down list.
Then, choose the volume or
snapshot.</para>
<para>For information about how to create
a bootable volume, see <xref
linkend="dashboard_launch_instances_from_volume"
/>.</para></td>
</tr>
<tr>
<th colspan="2" align="center"
><guilabel>Post-Creation</guilabel>
tab</th>
</tr>
<tr>
<td><para><guilabel>Customization
Script</guilabel></para></td>
<td><para>A customization script that runs
after your instance
launches.</para></td>
</tr>
</tbody>
</informaltable>
</step>
<step>
<para>Click <guibutton>Launch</guibutton>. The instance
starts on a Compute node in the cloud.</para>
</step>
<step>
<para>The <guilabel>Instances</guilabel> category shows
the instance name, its private and public IP
addresses, size, status, task, and power state.</para>
</step>
<step>
<para>If you did not provide a keypair, security groups,
or rules so far, users can only access the instance
from inside the cloud through VNC. Even pinging the
instance is not possible. To access the instance
through a VNC console, see <xref
linkend="instance_console"/>.</para>
</step>
</procedure>
</section>