openstack-manuals/doc/user-guide-admin/section_dashboard_admin_set_quotas.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section [
<!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_set_quotas">
  <?dbhtml stop-chunking?>
  <title>View and manage quotas</title>
  <para>To prevent system capacities from being exhausted without notification,
    you can set up quotas. Quotas are operational limits. For example, the
    number of gigabytes allowed for each tenant can be controlled so that
    cloud resources are optimized. Quotas can be enforced at both the tenant
    (or project) and the tenant-user level.</para>
  <para>Typically, you change quotas when a project needs more than ten
    volumes or 1&nbsp;TB on a compute node.</para>
  <para>Using the Dashboard, you can view default Compute and Block Storage
    quotas for new tenants, as well as update quotas for existing tenants.</para>
  <note>
    <para>Using the command-line interface, you can manage quotas for the
      OpenStack Compute service, the OpenStack Block Storage service, and
      the OpenStack Networking service (see <xref linkend="cli_set_quotas"/>).
      Additionally, you can update Compute service quotas for
      tenant users.</para>
  </note>
  <para>The following table describes the Compute and Block Storage
    service quotas:</para>
  <table rules="all" width="50%" xml:id="compute_quotas">
    <caption>Quota Descriptions</caption>
    <col width="30%"/>
    <col width="50%"/>
    <col width="20%"/>
    <thead>
      <tr>
        <th>Quota Name</th>
        <th>Defines the number of</th>
        <th>Service</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td>
          <para>Gigabytes</para>
        </td>
        <td>
          <para>Volume gigabytes allowed for each project.</para>
        </td>
        <td>Block Storage</td>
      </tr>
      <tr>
        <td>
          <para>Instances</para>
        </td>
        <td>
          <para>Instances allowed for each project.</para>
        </td>
        <td>Compute</td>
      </tr>
      <tr>
        <td>
          <para>Injected Files</para>
        </td>
        <td>
          <para>Injected files allowed for each project.</para>
        </td>
        <td>Compute</td>
      </tr>
      <tr>
        <td>
          <para>Injected File Content Bytes</para>
        </td>
        <td>
          <para>Content bytes allowed for each injected file.</para>
        </td>
        <td>Compute</td>
      </tr>
      <tr>
        <td>
          <para>Keypairs</para>
        </td>
        <td>
          <para>Number of keypairs.</para>
        </td>
        <td>Compute</td>
      </tr>
      <tr>
        <td>
          <para>Metadata Items</para>
        </td>
        <td>
          <para>Metadata items allowed for each instance.</para>
        </td>
        <td>Compute</td>
      </tr>
      <tr>
        <td>
          <para>RAM (MB)</para>
        </td>
        <td>
          <para>RAM megabytes allowed for each instance.</para>
        </td>
        <td>Compute</td>
      </tr>
      <tr>
        <td>
          <para>Security Groups</para>
        </td>
        <td>
          <para>Security groups allowed for each project.</para>
        </td>
        <td>Compute</td>
      </tr>
      <tr>
        <td>
          <para>Security Group Rules</para>
        </td>
        <td>
          <para>Rules allowed for each security group.</para>
        </td>
        <td>Compute</td>
      </tr>
      <tr>
        <td>
          <para>Snapshots</para>
        </td>
        <td>
          <para>Volume snapshots allowed for each project.</para>
        </td>
        <td>Block Storage</td>
      </tr>
      <tr>
        <td>
          <para>VCPUs</para>
        </td>
        <td>
          <para>Instance cores allowed for each project.</para>
        </td>
        <td>Compute</td>
      </tr>
      <tr>
        <td>
          <para>Volumes</para>
        </td>
        <td>
          <para>Volumes allowed for each project.</para>
        </td>
        <td>Block Storage</td>
      </tr>
    </tbody>
    </table>
    <section xml:id="dashboard_view_quotas_procedure">
      <title>View default project quotas</title>
      <procedure>
        <step>
          <para>Log in to the OpenStack dashboard.</para>
        </step>
        <step>
          <para>On the <guilabel>Admin</guilabel> tab, click the
            <guilabel>Defaults</guilabel> category.</para>
          </step>
          <step>
            <para>The default quota values are displayed.</para>
          </step>
        </procedure>
        <note>
          <para>You can sort the table by clicking on either the <guilabel>Quota Name</guilabel> or <guilabel>Limit</guilabel> column headers.</para>
        </note>
      </section>
      <section xml:id="dashboard_update_project_quotas">
        <title>Update project quotas</title>
        <procedure>
          <step>
            <para>Log in to the OpenStack dashboard.</para>
          </step>
          <step>
            <para>On the <guilabel>Admin</guilabel> tab, click the
              <guilabel>Defaults</guilabel> category.</para>
            </step>
            <step>
              <para>Click the <guibutton>Update Defaults</guibutton> button.</para>
            </step>
            <step>
              <para>In the <guilabel>Update Default Quotas</guilabel> window, you can edit the default quota values.</para>
            </step>
            <step>
              <para>Click the <guibutton>Update Defaults</guibutton> button.</para>
            </step>
          </procedure>
          <note>
            <para>The dashboard does not show all possible project quotas.
              To view and update the quotas for a service, use its
              command-line client. See <xref linkend="cli_set_quotas"/>.</para>
    </note>
  </section>
</section>