132 lines
5.4 KiB
XML
132 lines
5.4 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="cli_set_block_storage_quotas">
|
|
<title>Manage Block Storage service quotas</title>
|
|
<para>As an administrative user, you can update the OpenStack Block
|
|
Storage service quotas for a project. You can also update the quota
|
|
defaults for a new project.</para>
|
|
<para>
|
|
<table rules="all">
|
|
<caption>Block Storage quotas</caption>
|
|
<col width="20%"/>
|
|
<col width="80%"/>
|
|
<thead>
|
|
<tr>
|
|
<th>Property name</th>
|
|
<th>Defines the number of</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td>
|
|
<para>gigabytes</para>
|
|
</td>
|
|
<td>
|
|
<para>Volume gigabytes allowed for each
|
|
tenant.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para>snapshots</para>
|
|
</td>
|
|
<td>
|
|
<para>Volume snapshots allowed for each
|
|
tenant.</para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<para>volumes</para>
|
|
</td>
|
|
<td>
|
|
<para>Volumes allowed for each tenant.</para>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</para>
|
|
<section xml:id="cli_set_block_storage_quotas_procedure">
|
|
<title>View and update Block Storage service quotas</title>
|
|
<para>As an administrative user, you can view and update Block
|
|
Storage service quotas.</para>
|
|
<procedure>
|
|
<step>
|
|
<para>List the default quotas for all projects, as
|
|
follows:</para>
|
|
<screen><prompt>$</prompt> <userinput>cinder quota-defaults <replaceable>TENANT_ID</replaceable></userinput></screen>
|
|
<screen><computeroutput>+-----------+-------+
|
|
| Property | Value |
|
|
+-----------+-------+
|
|
| gigabytes | 1000 |
|
|
| snapshots | 10 |
|
|
| volumes | 10 |
|
|
+-----------+-------+</computeroutput></screen>
|
|
</step>
|
|
<step>
|
|
<para>To update a default value for a new project,
|
|
update the property in the
|
|
<filename>/etc/cinder/cinder.conf</filename>
|
|
file.</para>
|
|
</step>
|
|
|
|
|
|
<step>
|
|
<para>View Block Storage service quotas for a project, as
|
|
follows:</para>
|
|
<screen><prompt>$</prompt> <userinput>cinder quota-show <replaceable>TENANT_NAME</replaceable></userinput></screen>
|
|
<para>For example:</para>
|
|
<screen><prompt>$</prompt> <userinput>cinder quota-show tenant01</userinput></screen>
|
|
<screen><computeroutput>+-----------+-------+
|
|
| Property | Value |
|
|
+-----------+-------+
|
|
| gigabytes | 1000 |
|
|
| snapshots | 10 |
|
|
| volumes | 10 |
|
|
+-----------+-------+</computeroutput></screen>
|
|
</step>
|
|
<step>
|
|
<para>To update Block Storage service quotas, place
|
|
the tenant ID in a usable variable, as
|
|
follows:</para>
|
|
<screen><prompt>$</prompt> <userinput>tenant=$(keystone tenant-list | awk '/<replaceable>tenantName</replaceable>/ {print $2}')</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Update a particular quota value, as
|
|
follows:</para>
|
|
<screen><prompt>$</prompt> <userinput>cinder quota-update --<replaceable>quotaName</replaceable> <replaceable>NewValue</replaceable> <replaceable>tenantID</replaceable></userinput></screen>
|
|
<para>For example:</para>
|
|
<screen><prompt>$</prompt> <userinput>cinder quota-update --volumes 15 $tenant</userinput></screen>
|
|
<screen><prompt>$</prompt> <userinput>cinder quota-show tenant01</userinput></screen>
|
|
<screen><computeroutput>+-----------+-------+
|
|
| Property | Value |
|
|
+-----------+-------+
|
|
| gigabytes | 1000 |
|
|
| snapshots | 10 |
|
|
| volumes | 15 |
|
|
+-----------+-------+</computeroutput></screen>
|
|
</step>
|
|
<step>
|
|
<para>To clear per-tenant quota limits, use the
|
|
<command>quota-delete</command> command:</para>
|
|
<screen><prompt>$</prompt> <userinput>cinder quota-delete <replaceable>tenantID</replaceable></userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>To show the current usage of a per-tenant quota use the
|
|
<command>quota-usage</command> command:</para>
|
|
<screen><prompt>$</prompt> <userinput>cinder quota-usage <replaceable>tenantID</replaceable></userinput>
|
|
<computeroutput>+-----------+--------+----------+-------+
|
|
| Type | In_use | Reserved | Limit |
|
|
+-----------+--------+----------+-------+
|
|
| gigabytes | 0 | 0 | 1000 |
|
|
| snapshots | 0 | 0 | 10 |
|
|
| volumes | 0 | 0 | 15 |
|
|
+-----------+--------+----------+-------+</computeroutput></screen>
|
|
</step>
|
|
</procedure>
|
|
</section>
|
|
</section>
|