openstack-manuals/doc/user-guide-admin/section_dashboard_admin_manage_images.xml
Christian Berendt bbec5aa4d2 Unified the syntax of the XML root element (user-guide-admin)
The XML root element of Docbook XML files should match the following
format:

<ELEMENT 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="THE_XML_ID_OF_THE_ELEMENT">

Change-Id: If8d27898af12af2edc2d2d13557ec2365a241656
2014-07-09 21:25:59 +02:00

161 lines
6.3 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">
<?dbhtml stop-chunking?>
<title>Create and manage images</title>
<para>As an administrative user, you can create and manage images
for the projects to which you belong. You can also create and
manage images for users in all projects to which you have
access.</para>
<para>To create and manage images in specified projects as an end
user, see the <link
xlink:href="http://docs.openstack.org/user-guide/content/"
><citetitle>OpenStack End User
Guide</citetitle></link>.</para>
<para>To create and manage images as an administrator for other
users, use the following procedures.</para>
<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
drop-down list at the top of the page.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, open the
<guilabel>System Panel</guilabel> and click the
<guilabel>Images</guilabel> category. The images that you
can administer for cloud users appear on this page.</para>
</step>
<step>
<para>Click <guibutton>Create Image</guibutton>.</para>
</step>
<step>
<para>In the <guilabel>Create An Image</guilabel> window,
enter or select the following values:</para>
<informaltable rules="all" width="50%">
<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 Source</guilabel></para></td>
<td><para>Choose the image source from the dropdown list. Your
choices are <guilabel>Image Location</guilabel> and
<guilabel>Image File</guilabel>.</para></td>
</tr>
<tr>
<td><para><guilabel>Image File</guilabel> or <guilabel>Image
Location</guilabel></para></td>
<td>
<para>Based on your selection, there is an <guilabel>Image File
</guilabel> or <guilabel>Image Location</guilabel> field. You
can include the location URL or browse for the image file on
your file system and add it.</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>Minimum RAM (MB)</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
several minutes before the status changes from
<literal>Queued</literal> to
<literal>Active</literal>.</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
drop-down list at the top of the page.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, open the
<guilabel>System Panel</guilabel> and click the
<guilabel>Images</guilabel> category.</para>
</step>
<step>
<para>Select the image that you want to edit. Click
<guilabel>Edit</guilabel>.</para>
</step>
<step>
<para>In the <guilabel>Update Image</guilabel> window, you can
change the image name.</para>
<para>Select the <guilabel>Public</guilabel> check box to make
the image public. Clear this check box to make the image
private. You cannot change the kernel ID, RAM disk ID, or
architecture attributes for an image.</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
drop-down list at the top of the page.</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, open the
<guilabel>System Panel</guilabel> and click the
<guilabel>Images</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.</para>
<para>You cannot undo this action.</para>
</step>
</procedure>
</section>
</section>