openstack/cinder
Code Issues Proposed changes

Doc: Improve default quota value for projects

Browse Source 
I01114211010817fbc40e959c3db9045958c78d06 intorduce the guide for
update of the default cinder quota value for a new project.
However, the actual behavior of the update affects to the existing
projects if those projects' quota value use the default value.

To elaborate the current behavior, this fix provides an exmample and
update the description.

Change-Id: I350a15a363393f65a716b32b240668f32ef2b5a0
Signed-off-by: Keigo Noha <knoha@redhat.com>
This commit is contained in:
Keigo Noha
2025-01-07 10:06:20 +09:00
parent c8ceeeb150
commit 76c40b560d
1 changed files with 16 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/source/cli/cli-cinder-quotas.rst
+16 -5
View File
@@ -14,6 +14,9 @@ defaults for a new project.
gigabytes Volume gigabytes allowed for each project.
snapshots Volume snapshots allowed for each project.
volumes Volumes allowed for each project.
backups Volume backups allowed for each project.
backup_gigabytes Total amount of backups allowed for each per project
groups Volume groups allowed for each project
=================== =============================================
View Block Storage quotas
@@ -148,10 +151,18 @@ service quotas.
the initial database sync in the initial deployment. If you want to
change a default value for a new project, see the following.
To update a default value for a new project, set
``use_default_quota_class = True`` (which is the default setting) in the
:guilabel:`DEFAULT` section of the ``/etc/cinder/cinder.conf`` file, and
run the command as the following.
To update a default value for projects, including existing projects and
a new project, set ``use_default_quota_class = True`` (which is the
default setting) in the :guilabel:`DEFAULT` section of the
``/etc/cinder/cinder.conf`` file, and run the command as the following.
.. note::
Updating a default value affects to existing projects' quota default.
For example, when you update volumes to 200 to default class,
volumes quota in all existing projects is updated to 200 unless the value
was modified from the past default value.
And a new project after the default quota update will use the new default
value, volumes=200.
.. code-block:: console
@@ -160,7 +171,7 @@ service quotas.
Replace ``QUOTA_NAME`` with the quota that is to be updated,
``QUOTA_VALUE`` with the required new value.
#. To update Block Storage service quotas for an existing project
#. To update Block Storage service quotas to project specific values for an existing project
.. code-block:: console