openstack-manuals/doc/user-guide-admin/section_dashboard_admin_manage_instances.xml
Diane Fleming 69b79de7b9 Update headings plus edits for consistency and clarity in End and Admin User Guides
Partial-Bug: #1250515

author: diane fleming

Change-Id: I0ae7f3da1ef0bf9af4900097d527e2cd7b94c966
backport: havana
2013-11-16 14:41:21 -06:00

134 lines
5.8 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book [
<!-- 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_manage_instances">
<?dbhtml stop-chunking?>
<title>Manage instances</title>
<para>As an administrative user, you can manage instances for
users in various projects. You can view, terminate, edit,
perform a soft or hard reboot, create a snapshot from, and
migrate instances. You can also view the logs for instances or
launch a VNC console for an instance.</para>
<para>For information about using the dashboard to launch
instances as an end user, see the <link
xlink:href="http://docs.openstack.org/user-guide/content/"
><citetitle>OpenStack End User
Guide</citetitle></link>.</para>
<section xml:id="dashboard_instance_snapshots">
<title>Create instance snapshots</title>
<procedure>
<step>
<para>Log in to the OpenStack dashboard and choose the
<guilabel>admin</guilabel> project from the
<guilabel>CURRENT PROJECT</guilabel> drop-down
list.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the
<guilabel>Instances</guilabel>
category.</para>
</step>
<step>
<para>Select an instance to create a snapshot from it.
From the <guilabel>Actions</guilabel> drop-down
list, select <guilabel>Create
Snapshot</guilabel>.</para>
</step>
<step>
<para>In the <guilabel>Create Snapshot</guilabel>
window, enter a name for the snapshot. Click
<guibutton>Create Snapshot</guibutton>. The
dashboard shows the instance snapshot in the
<guilabel>Images &amp; Snapshots</guilabel>
category.</para>
</step>
<step>
<para>To launch an instance from the snapshot, select
the snapshot and click
<guibutton>Launch</guibutton>. For information
about launching instances, see the <link
xlink:href="http://docs.openstack.org/user-guide/content/"
><citetitle>OpenStack End User
Guide</citetitle></link>.</para>
</step>
</procedure>
</section>
<section xml:id="dashboard_control_instance_states">
<title>Control the state of an instance</title>
<procedure>
<step>
<para>Log in to the OpenStack dashboard and choose the
<guilabel>admin</guilabel> project from the
<guilabel>CURRENT PROJECT</guilabel> drop-down
list.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the
<guilabel>Instances</guilabel>
category.</para>
</step>
<step>
<para>Select the instance for which you want to change
the state.</para>
</step>
<step>
<para>In the <guilabel>More</guilabel> drop-down list
in the <guilabel>Actions</guilabel> column, select
the state.</para>
<para>Depending on the current state of the instance,
you can choose to pause, un-pause, suspend,
resume, soft or hard reboot, or terminate an
instance.</para>
<figure>
<title>OpenStack dashboard&mdash;Actions</title>
<mediaobject>
<imageobject>
<imagedata
fileref="../common/figures/change_instance_state.png"
format="PNG" contentwidth="4in"/>
</imageobject>
</mediaobject>
</figure>
</step>
</procedure>
</section>
<section xml:id="dashboard_track_usage">
<title>Track usage</title>
<para>Use the <guilabel>Overview</guilabel> category to track
usage of instances for each project.</para>
<para>You can track costs per month by showing metrics like
number of VCPUs, disks, RAM, and uptime of all your
instances.</para>
<procedure>
<step>
<para>Log in to the OpenStack dashboard and choose the
<guilabel>admin</guilabel> project from the
<guilabel>CURRENT PROJECT</guilabel> drop-down
list.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the
<guilabel>Instances</guilabel>
category.</para>
</step>
<step>
<para>Select a month and click
<guibutton>Submit</guibutton> to query the
instance usage for that month.</para>
</step>
<step>
<para>Click <guibutton>Download CSV
Summary</guibutton> to download a CSV
summary.</para>
</step>
</procedure>
</section>
</section>