openstack-manuals/doc/user-guide/section_dashboard_manage_images.xml
Laurel Michaels 8bc857086e improved readability and markup
Removed whitespace

Added markup per conventions

Change-Id: I5808872930806c7bde90564d5fade0d5486083fb
Partial-Bug: #1217503
2014-01-27 09:15:21 -06:00

168 lines
6.2 KiB
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_manage_images">
<title>Create and manage images</title>
<para>The cloud operator assigns roles to users. Roles determine who
can upload and manage images. The operator might restrict image
upload and management to only cloud administrators or
operators.</para>
<para>If you have admin privileges, you can use the dashboard to
create and manage images in the <guilabel>admin</guilabel>
project.</para>
<note>
<title>Manage images by using clients and APIs</title>
<para>You can also use the <command>glance</command> and
<command>nova</command> command-line clients or the Image
Service and Compute APIs to manage images. See <xref
linkend="cli_manage_images"/>.</para>
</note>
<section xml:id="dashboard_create_images">
<title>Create images</title>
<para>For details about image creation, see the <link
xlink:href="http://docs.openstack.org/image-guide/content/"
><citetitle>Virtual Machine Image
Guide</citetitle></link>.</para>
<procedure>
<step>
<para>Log in to the dashboard.</para>
<para>Choose the <guilabel>admin</guilabel> project from the
<guilabel>CURRENT PROJECT</guilabel> drop-down
list.</para>
</step>
<step>
<para>On the <guilabel>Project</guilabel> tab, click the
<guilabel>Images &amp; Snapshots</guilabel>
category.</para>
</step>
<step>
<para>Click <guibutton>Create Image</guibutton>. The
<guilabel>Create An Image</guilabel> window
appears:</para>
<informalfigure>
<mediaobject>
<imageobject>
<imagedata
fileref="../common/figures/user_image_create.png"
format="PNG" width="4in" contentwidth="4in"/>
</imageobject>
</mediaobject>
</informalfigure>
</step>
<step>
<para>In the <guilabel>Create An Image</guilabel> window,
enter or select the following values:</para>
<informaltable rules="all" width="75%">
<col width="25%"/>
<col width="75%"/>
<tbody>
<tr>
<td><para><guilabel>Name</guilabel></para></td>
<td><para>Enter a name for the image.</para></td>
</tr>
<tr>
<td><para><guilabel>Description</guilabel></para></td>
<td><para>Enter a brief description about the
image.</para></td>
</tr>
<tr>
<td><para><guilabel>Image
Location</guilabel></para></td>
<td><para>Include the URL of the image.</para></td>
</tr>
<tr>
<td><para><guilabel>Image File</guilabel></para></td>
<td><para>Alternatively, browse to find the file on your
machine.</para></td>
</tr>
<tr>
<td><para><guilabel>Format</guilabel></para></td>
<td><para>Select the image format.</para></td>
</tr>
<tr>
<td><para><guilabel>Minimum Disk (GB)</guilabel> and
<guilabel>Maximum Disk (GB)</guilabel></para></td>
<td><para>Leave these fields empty.</para>
</td>
</tr>
<tr>
<td><para><guilabel>Public</guilabel></para></td>
<td><para>Select this option to make the image public to
all users.</para></td>
</tr>
<tr>
<td><para><guilabel>Protected</guilabel></para></td>
<td><para>Select this option to ensure that only users
with permissions can delete it.</para></td>
</tr>
</tbody>
</informaltable>
</step>
<step>
<para>Click <guibutton>Create Image</guibutton>.</para>
<para>The image is queued to be uploaded. It might take some
time before the status changes from queued to active.</para>
</step>
</procedure>
</section>
<section xml:id="dashboard_update_images">
<title>Update images</title>
<procedure>
<step>
<para>Log in to the dashboard.</para>
<para>Choose the <guilabel>admin</guilabel> project from the
<guilabel>CURRENT PROJECT</guilabel> drop-down
list.</para>
</step>
<step>
<para>On the <guilabel>Project</guilabel> tab, click the
<guilabel>Images &amp; Snapshots</guilabel>
category.</para>
</step>
<step>
<para>Select the image that you want to edit. In the
<guilabel>More</guilabel> drop-down list, click
<guilabel>Edit</guilabel>.</para>
</step>
<step>
<para>In the <guilabel>Update Image</guilabel> window, you can
change the name for the image. Select the
<guilabel>Public</guilabel> check box to make the image
public. Clear this check box to make the image
private.</para>
</step>
<step>
<para>Click <guibutton>Update Image</guibutton>.</para>
</step>
</procedure>
</section>
<section xml:id="dashboard_delete_images">
<title>Delete images</title>
<procedure>
<step>
<para>Log in to the dashboard.</para>
<para>Choose the <guilabel>admin</guilabel> project from the
<guilabel>CURRENT PROJECT</guilabel> drop-down
list.</para>
</step>
<step>
<para>On the <guilabel>Project</guilabel> tab, click the
<guilabel>Images &amp; Snapshots</guilabel>
category.</para>
</step>
<step>
<para>Select the images that you want to delete.</para>
</step>
<step>
<para>Click <guibutton>Delete Images</guibutton>.</para>
</step>
<step>
<para>In the <guilabel>Confirm Delete Image</guilabel> window,
click <guibutton>Delete Images</guibutton> to confirm the
deletion. You cannot undo this action.</para>
</step>
</procedure>
</section>
</section>