openstack-manuals/doc/user-guide/section_dashboard_launch_instances.xml

<?xml version="1.0" encoding="UTF-8"?>
<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>In the <guilabel>Actions</guilabel> column, click
                <guilabel>Create Snapshot</guilabel>.</para>
            </step>
            <step>
                <para>In the Create Snapshot dialog box, enter a name for the
                snapshot, and click <guibutton>Create Snapshot</guibutton>.</para>
                <para>The <guilabel>Images</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, edit instance or the security
                  groups. 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>