openstack-manuals/doc/user-guide/section_dashboard_launch_instances.xml
Karin Levenstein fca88670a4 Edits to the End User Guide dashboard chapter with corrections from Anne G
Change-Id: Ia9961bbdab446e15930d0b31176c37fe1d532b8f
2014-04-14 10:16:06 -05:00

129 lines
5.3 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">
<title>Launch and manage instances</title>
<para>Instances are virtual machines that run inside the
cloud.</para>
<para>You can <link
linkend="dashboard_launch_instances_from_image">launch an
instance</link> from the following sources:</para>
<itemizedlist><listitem><para>Images uploaded to the OpenStack Image Service, as described
in <xref linkend="dashboard_manage_images"/>.</para></listitem>
<listitem><para>Image that you have copied to a persistent volume. The instance
launches from the volume, which is provided by the
<systemitem class="service"
>cinder-volume</systemitem> API through iSCSI.</para></listitem></itemizedlist>
<?hard-pagebreak?>
<xi:include
href="section_dashboard_launch_instances_from_image.xml"/>
<?hard-pagebreak?>
<section xml:id="ssh-into-instance">
<title>Connect to your instance by using SSH</title>
<para>To use SSH to connect to your instance, you use the
downloaded keypair file.</para>
<note>
<para>The user name is <literal>ubuntu</literal> for the
Ubuntu cloud images on TryStack.</para>
</note>
<procedure>
<step>
<para>Copy the IP address for your instance.</para>
</step>
<step>
<para>Use the <command>ssh</command> command to make a
secure connection to the instance. For
example:</para>
<screen><prompt>$</prompt> <userinput>ssh -i MyKey.pem ubuntu@10.0.0.2</userinput></screen>
</step>
<step>
<para>At the prompt, type
<literal>yes</literal>.</para>
</step>
</procedure>
</section>
<section xml:id="track_usage">
<title>Track usage for instances</title>
<para>You can track usage for instances for each project. You
can track costs per month by showing metrics like number
of vCPUs, disks, RAM, and uptime for all your
instances.</para>
<procedure>
<step>
<para>Log in to the dashboard, choose a project, and
click <guilabel>Overview</guilabel>.</para>
</step>
<step>
<para>To query the instance usage for a month, select
a month and click
<guibutton>Submit</guibutton>.</para>
</step>
<step>
<para>To download a summary, click <guibutton>Download
CSV Summary</guibutton>.</para>
</step>
</procedure>
</section>
<section xml:id="instance_snapshots">
<title>Create an instance snapshot</title>
<procedure>
<step>
<para>Log in to the dashboard, choose a project, and
click <guilabel>Instances</guilabel>.</para>
</step>
<step>
<para>Select the instance from which to create a
snapshot.</para></step>
<step>
<para>From the <guilabel>Actions</guilabel> list,
select <guilabel>Create
Snapshot</guilabel>.</para>
</step>
<step>
<para>In the Create Snapshot dialog box, enter a name
for the snapshot, and then click <guibutton>Create
Snapshot</guibutton>.</para>
<para>The <guilabel>Images &amp; Snapshots</guilabel>
category shows the instance snapshot.</para>
</step>
</procedure>
<para>To launch an instance from the snapshot, select
the snapshot and click
<guibutton>Launch</guibutton>. Proceed with
<xref
linkend="dashboard_launch_instances_from_image"
/>.</para>
</section>
<section xml:id="control_instance_states">
<title>Manage an instance</title>
<procedure>
<step>
<para>Log in to the dashboard, choose a project, and
click <guilabel>Instances</guilabel>.</para>
</step>
<step>
<para>Select an instance.</para>
</step>
<step>
<para>In the <guilabel>More</guilabel> list in the
<guilabel>Actions</guilabel> column, select
the state.</para>
<para>You can resize or rebuild an instance. You can
also choose to view the instance console log.
Depending on the current state of the instance,
you can pause, resume, suspend, soft or hard
reboot, or terminate it.</para>
</step>
</procedure>
</section>
</section>