6be4f5775f
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: Ic59684221ba99632c71e3f9b5f97ec74f56793a4
230 lines
8.1 KiB
XML
230 lines
8.1 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>Upload and manage images</title>
|
|
<para>A virtual machine image, referred to in this document simply
|
|
as an image, is a single file that contains a virtual disk that
|
|
has a bootable operating system installed on it. Images are used
|
|
to create virtual machine instances within the cloud. For
|
|
information about creating image files, see the <link
|
|
xlink:href="http://docs.openstack.org/image-guide/content/"
|
|
><citetitle>OpenStack Virtual Machine Image
|
|
Guide</citetitle></link>.</para>
|
|
<para>Depending on your role, you may have permission to upload and
|
|
manage virtual machine images. Operators might restrict the upload
|
|
and management of images to cloud administrators or operators
|
|
only. If you have the appropriate privileges, you can use the
|
|
dashboard to upload and manage images in the
|
|
<guilabel>admin</guilabel> project.</para>
|
|
<note>
|
|
<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>Upload an image</title>
|
|
<para>Follow this procedure to upload an image to a
|
|
project.</para>
|
|
<procedure>
|
|
<step>
|
|
<para>Log in to the dashboard.</para>
|
|
</step>
|
|
<step>
|
|
<para>From the <guilabel>CURRENT PROJECT</guilabel> on the
|
|
<guilabel>Project</guilabel> tab, select the appropriate
|
|
project.</para>
|
|
</step>
|
|
<step>
|
|
<para>On the <guilabel>Project</guilabel> tab, click
|
|
<guilabel>Images</guilabel>.</para>
|
|
</step>
|
|
<step>
|
|
<para>Click <guibutton>Create Image</guibutton>.</para>
|
|
<para>The Create An Image dialog box appears.</para>
|
|
</step>
|
|
<step>
|
|
<para>Enter 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>Optionally, enter a brief description of the
|
|
image.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para><guilabel>Image Source</guilabel></para>
|
|
</td>
|
|
<td>
|
|
<para>Choose the image source from the 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 for <guilabel>Image
|
|
Source</guilabel>, you either enter the location
|
|
URL of the image in the <guilabel>Image
|
|
Location</guilabel> field. or browse to the image
|
|
file on your system and add it.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para><guilabel>Format</guilabel></para>
|
|
</td>
|
|
<td>
|
|
<para>Select the correct format (for example, QCOW2)
|
|
for the image.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para>
|
|
<guilabel>Architecture</guilabel>
|
|
</para>
|
|
</td>
|
|
<td>
|
|
<para>Specify the architecture. For example, <literal>i386</literal>
|
|
for a 32-bit architecture or <literal>x86-64</literal> for a 64-bit
|
|
architecture.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para><guilabel>Minimum Disk (GB)</guilabel> and
|
|
<guilabel>Minimum RAM (MB)</guilabel></para>
|
|
</td>
|
|
<td>
|
|
<para>Leave these optional fields empty.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para><guilabel>Public</guilabel></para>
|
|
</td>
|
|
<td>
|
|
<para>Select this check box to make the image public
|
|
to all users with access to the current
|
|
project.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para><guilabel>Protected</guilabel></para>
|
|
</td>
|
|
<td>
|
|
<para>Select this check box to ensure that only users
|
|
with permissions can delete the image.</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 an image</title>
|
|
<para>Follow this procedure to update an existing image.</para>
|
|
<procedure>
|
|
<step>
|
|
<para>Log in to the dashboard.</para>
|
|
</step>
|
|
<step>
|
|
<para>From the <guilabel>CURRENT PROJECT</guilabel> on the
|
|
<guilabel>Project</guilabel> tab, select the appropriate
|
|
project.</para>
|
|
</step>
|
|
<step>
|
|
<para>On the <guilabel>Project</guilabel> tab, click
|
|
<guilabel>Images</guilabel>.</para>
|
|
</step>
|
|
<step>
|
|
<para>Select the image that you want to edit.</para>
|
|
</step>
|
|
<step>
|
|
<para>In the <guilabel>Actions</guilabel> column, click
|
|
<guilabel>More</guilabel> and then select
|
|
<guilabel>Edit</guilabel> from the list.</para>
|
|
</step>
|
|
<step>
|
|
<para>In the Update Image dialog box, you can perform the
|
|
following actions: <itemizedlist>
|
|
<listitem>
|
|
<para>Change the name of the image.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Select the <guilabel>Public</guilabel> check box
|
|
to make the image public.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Clear the <guilabel>Public</guilabel> check box to
|
|
make the image private.</para>
|
|
</listitem>
|
|
</itemizedlist></para>
|
|
</step>
|
|
<step>
|
|
<para>Click <guibutton>Update Image</guibutton>.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|
|
<section xml:id="dashboard_delete_images">
|
|
<title>Delete an image</title>
|
|
<para>Deletion of images is permanent and <emphasis role="bold"
|
|
>cannot</emphasis> be reversed. Only users with the
|
|
appropriate permissions can delete images.</para>
|
|
<procedure>
|
|
<step>
|
|
<para>Log in to the dashboard.</para>
|
|
</step>
|
|
<step>
|
|
<para>From the <guilabel>CURRENT PROJECT</guilabel> on the
|
|
<guilabel>Project</guilabel> tab, select the appropriate project.</para>
|
|
</step>
|
|
<step>
|
|
<para>On the <guilabel>Project</guilabel> tab, click
|
|
<guilabel>Images</guilabel>.</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> dialog box, click
|
|
<guibutton>Delete Images</guibutton> to confirm the deletion.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|
|
</section>
|