From 9b4cfd303b8e57990838257c56a7bd63e3dc5ac1 Mon Sep 17 00:00:00 2001 From: annegentle Date: Tue, 21 Jan 2014 16:55:26 -0600 Subject: [PATCH] Adds Image quota info for storage and number of members for sharing Change-Id: I7ffce283d3c9fd0f349dc12e144f47d5f5cf1d50 Closes-bug: 1257627 --- doc/openstack-ops/ch_ops_projects_users.xml | 489 +++++++++----------- 1 file changed, 222 insertions(+), 267 deletions(-) diff --git a/doc/openstack-ops/ch_ops_projects_users.xml b/doc/openstack-ops/ch_ops_projects_users.xml index 9d858c8d..3453ada9 100644 --- a/doc/openstack-ops/ch_ops_projects_users.xml +++ b/doc/openstack-ops/ch_ops_projects_users.xml @@ -90,23 +90,22 @@ -
- Quotas - 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 per tenant can be - controlled to ensure that a single tenant cannot consume all of - the disk space. Quotas are currently enforced at the tenant (or - project) level, rather than by user. - - Using the command-line interface, you can manage quotas for the OpenStack Compute Service and the Block Storage Service. - - Typically, default values are changed because a tenant requires - more than the OpenStack default of 10 volumes per tenant, or more - than the OpenStack default of 1TB of disk space on a Compute node. - - To view all tenants, run: - $ keystone tenant-list +
+ Quotas + 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 per tenant can be controlled to + ensure that a single tenant cannot consume all of the disk space. Quotas + are currently enforced at the tenant (or project) level, rather than by + user. + Using the command-line interface, you can manage quotas for the + OpenStack Compute Service and the Block Storage Service. + Typically, default values are changed because a tenant requires more + than the OpenStack default of 10 volumes per tenant, or more than the + OpenStack default of 1TB of disk space on a Compute node. + + To view all tenants, run: + $ keystone tenant-list +----------------------------------+----------+---------+ | id | name | enabled | +----------------------------------+----------+---------+ @@ -115,43 +114,55 @@ | 7bc1dbfd7d284ec4a856ea1eb82dca80 | tenant02 | True | | 9c554aaef7804ba49e1b21cbd97d218a | services | True | +----------------------------------+----------+---------+ - -
- Set Compute Service Quotas - As an administrative user, you can update the Compute Service quotas for an existing tenant, as well as update the quota - defaults for a new tenant. - + + +
+ Set Image Quotas + OpenStack Havana introduced a basic quota feature for the Image + service so you can now restrict a project's image storage by total + number of bytes. Currently, this quota is applied cloud-wide, so if you + were to set an Image quota limit of 5 GB, then all projects in your + cloud will only be able to store 5 GB of images and snapshots. + To enable this feature, edit the + /etc/glance/glance-api.conf file, and under the + [DEFAULT] section, add: + user_storage_quota = <bytes> + For example, to restrict a project's image storage to 5 GB: + user_storage_quota = 5368709120 + + In the Icehouse release, there is a configuration option in + glance-api.conf that limits the number of + members allowed per image, called image_member_quota, set + to 128 by default. That setting is a different quota than the storage + quota. + +
+
+ Set Compute Service Quotas + As an administrative user, you can update the Compute Service quotas + for an existing tenant, as well as update the quota defaults for a new + tenant. - - - - - + + + + + - - - + + + - + - + - + - + - + - + - -
Compute Quota Descriptions Compute Quota Descriptions
- Quota - - Description - - Property Name - QuotaDescriptionProperty Name
- - Fixed Ips - + Fixed Ips - - Number of fixed IP addresses allowed per tenant. This number - must be equal to or greater than the number of allowed - instances. - + Number of fixed IP addresses allowed per tenant. This + number must be equal to or greater than the number of allowed + instances. @@ -161,14 +172,10 @@
- - Floating Ips - + Floating Ips - - Number of floating IP addresses allowed per tenant. - + Number of floating IP addresses allowed per tenant. @@ -178,14 +185,10 @@
- - Injected File Content Bytes - + Injected File Content Bytes - - Number of content bytes allowed per injected file. - + Number of content bytes allowed per injected file. @@ -193,16 +196,12 @@
- - Injected File Path Bytes - + Injected File Path Bytes - - Number of bytes allowed per injected file path. - + Number of bytes allowed per injected file path. @@ -210,16 +209,12 @@
- - Injected Files - + Injected Files - - Number of injected files allowed per tenant. - + Number of injected files allowed per tenant. @@ -229,14 +224,10 @@
- - Instances - + Instances - - Number of instances allowed per tenant. - + Number of instances allowed per tenant. @@ -246,14 +237,10 @@
- - Key Pairs - + Key Pairs - - Number of key pairs allowed per user. - + Number of key pairs allowed per user. @@ -261,16 +248,12 @@
- - Metadata Items - + Metadata Items - - Number of metadata items allowed per instance. - + Number of metadata items allowed per instance. @@ -278,16 +261,12 @@
- - Ram - + Ram - - Megabytes of instance ram allowed per tenant. - + Megabytes of instance ram allowed per tenant. @@ -295,16 +274,12 @@
- - Security Group Rules - + Security Group Rules - - Number of rules per security group. - + Number of rules per security group. @@ -314,14 +289,10 @@
- - Security Groups - + Security Groups - - Number of security groups per tenant. - + Number of security groups per tenant. @@ -331,14 +302,10 @@
- - VCPUs - + VCPUs - - Number of instance cores allowed per tenant. - + Number of instance cores allowed per tenant. @@ -346,20 +313,20 @@
+ +
- View and update Compute quotas for a tenant (project) - As an administrative user, you can use the nova quota-* - commands, which are provided by the python-novaclient - package, to view and update tenant quotas. - - To view and update default quota values - + View and update Compute quotas for a tenant (project) + As an administrative user, you can use the nova + quota-* commands, which are provided by the + python-novaclient package, to view and update + tenant quotas. + + To view and update default quota values + List all default quotas for all tenants, as follows: $ nova quota-defaults - For example: - + For example: $ nova quota-defaults +-----------------------------+-------+ | Property | Value | @@ -377,27 +344,26 @@ | injected_file_path_bytes | 255 | | security_groups | 10 | +-----------------------------+-------+ - - - Update a default value for a new tenant, as follows: - - $ nova quota-class-update default key value - For example: - - $ nova quota-class-update default instances 15 - - - - To view quota values for a tenant (project) - Place the tenant ID in a useable variable, as follows: -$ tenant=$(keystone tenant-list | awk '/tenantName/ {print $2}') - - - List the currently set quota values for a - tenant, as follows: -$ nova quota-show --tenant $tenant -For example: -$ nova quota-show --tenant $tenant + + + Update a default value for a new tenant, as follows: + $ nova quota-class-update default key value + For example: + $ nova quota-class-update default instances 15 + + + + To view quota values for a tenant (project) + + Place the tenant ID in a useable variable, as follows: + $ tenant=$(keystone tenant-list | awk '/tenantName/ {print $2}') + + + List the currently set quota values for a tenant, as + follows: + $ nova quota-show --tenant $tenant + For example: + $ nova quota-show --tenant $tenant +-----------------------------+-------+ | Property | Value | +-----------------------------+-------+ @@ -414,18 +380,19 @@ | injected_file_path_bytes | 255 | | security_groups | 10 | +-----------------------------+-------+ - - - - To update quota values for a tenant (project) - Obtain the tenant ID, as follows: + + + + To update quota values for a tenant (project) + + Obtain the tenant ID, as follows: $ tenant=$(keystone tenant-list | awk '/tenantName/ {print $2}') - - - Update a particular quota value, as follows: - # nova quota-update --quotaName quotaValue tenantID - For example: - # nova quota-update --floating-ips 20 $tenant + + + Update a particular quota value, as follows: + # nova quota-update --quotaName quotaValue tenantID + For example: + # nova quota-update --floating-ips 20 $tenant # nova quota-show --tenant $tenant +-----------------------------+-------+ | Property | Value | @@ -444,87 +411,74 @@ | security_groups | 10 | +-----------------------------+-------+ - To view a list of options for the - quota-update command, run: - -$ nova help quota-update - - + To view a list of options for the + quota-update command, run: + $ nova help quota-update + + +
-
-
- Set Block Storage quotas - As an administrative user, you can update - the Block Storage Service quotas for a tenant, - as well as update the quota defaults for a new tenant. - - - - - - - - - - - - - - - - - - - - - - - - - - -
Block Storage Quota Descriptions
- Property Name - - Description -
- - gigabytes - - - - Number of volume gigabytes allowed per tenant. - -
- - snapshots - - - - Number of Block Storage snapshots allowed per tenant. - -
- - volumes - - - - Number of Block Storage volumes allowed per tenant. - -
- -
- View and update Block Storage quotas for a tenant (project) - As an administrative user, you can use the cinder quota-* - commands, which are provided by the python-cinderclient - package, to view and update tenant quotas. - - To view and update default Block Storage quota values - +
+
+ Set Block Storage quotas + As an administrative user, you can update the Block Storage Service + quotas for a tenant, as well as update the quota defaults for a new + tenant. + + + + + + + + + + + + + + + + + + + + + + + + + +
Block Storage Quota Descriptions
Property NameDescription
+ gigabytes + + Number of volume gigabytes allowed per tenant. +
+ snapshots + + Number of Block Storage snapshots allowed per tenant. + +
+ volumes + + Number of Block Storage volumes allowed per tenant. + +
+ +
+ View and update Block Storage quotas for a tenant + (project) + As an administrative user, you can use the cinder + quota-* commands, which are provided by the + python-cinderclient package, to view and update + tenant quotas. + + To view and update default Block Storage quota values + List all default quotas for all tenants, as follows: $ cinder quota-defaults - For example: - $ cinder quota-defaults + For example: + $ cinder quota-defaults +-----------+-------+ | Property | Value | +-----------+-------+ @@ -532,20 +486,20 @@ | snapshots | 10 | | volumes | 10 | +-----------+-------+ - - - To update a default value for a new tenant, update the property - in the /etc/cinder/cinder.conf file. - - - - - To view Block Storage quotas for a tenant - - View quotas for the tenant, as follows: - # cinder quota-show tenantName - For example: - # cinder quota-show tenant01 + + + To update a default value for a new tenant, update the + property in the /etc/cinder/cinder.conf file. + + + + + To view Block Storage quotas for a tenant + + View quotas for the tenant, as follows: + # cinder quota-show tenantName + For example: + # cinder quota-show tenant01 +-----------+-------+ | Property | Value | +-----------+-------+ @@ -553,18 +507,19 @@ | snapshots | 10 | | volumes | 10 | +-----------+-------+ - - - - To update Compute service quotas - Place the tenant ID in a useable variable, as follows: + + + + To update Compute service quotas + + Place the tenant ID in a useable variable, as follows: $ tenant=$(keystone tenant-list | awk '/tenantName/ {print $2}') - - - Update a particular quota value, as follows: - # cinder quota-update --quotaName NewValue tenantID - For example: - # cinder quota-update --volumes 15 $tenant + + + Update a particular quota value, as follows: + # cinder quota-update --quotaName NewValue tenantID + For example: + # cinder quota-update --volumes 15 $tenant # cinder quota-show tenant01 +-----------+-------+ | Property | Value | @@ -573,11 +528,11 @@ | snapshots | 10 | | volumes | 15 | +-----------+-------+ - - + + +
+
-
-
User Management The command line tools for managing users are