openstack-manuals/doc/user-guide-admin/section_dashboard_admin_manage_instances.xml
Karin Levenstein 3311c7127f Admin guide updates
More changes to match the Admin Guide with the Icehouse GUI.
Also cleaning up some wording and other editing stuff.
Relatively small changes to smallish files, for the most part.

...and some niceness fixes that I thought I'd gotten earlier.

Added Diane's fixes

Change-Id: I867cb38629803be1993a318e933416e2bca3e87c
2014-06-17 14:09:39 -05:00

130 lines
5.6 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book [
<!ENTITY % openstack SYSTEM "../common/entities/openstack.ent">
%openstack;
]>
<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 dashboard and choose the
<guilabel>admin</guilabel> project from the
drop-down list at the top of the page.</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 dashboard and choose the
<guilabel>admin</guilabel> project from the
drop-down list at the top of the page.</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 (items in red are disabled).</para>
<figure>
<title>Dashboard&mdash;Instance 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 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>