openstack-manuals/doc/user-guide-admin/section_dashboard_admin_manage_images.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
            <guilabel>CURRENT PROJECT</guilabel> drop-down
          list.</para>
      </step>
      <step>
        <para>On the <guilabel>Admin</guilabel> tab, 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 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>Admin</guilabel> tab, 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 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. 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
            <guilabel>CURRENT PROJECT</guilabel> drop-down
          list.</para>
      </step>
      <step>
        <para>On the <guilabel>Admin</guilabel> tab, 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>