Revision e67e1d92

b/docs/admin-guide.rst
1141 1141
* `cyclades.floating_ip`: Number of floating IP addresses
1142 1142
* `cyclades.network.private`: Number of private virtual networks
1143 1143

  
1144
Enforcing quotas
1145
~~~~~~~~~~~~~~~~
1146

  
1147
User quota can get overlimit, for example when a user is removed from a
1148
project granting Cyclades resources. However, no action is automatically
1149
taken to restrict users to their new limits. There is a special tool for
1150
quota enforcement:
1151

  
1152
.. code-block:: console
1153

  
1154
  # snf-manage enforce-resources-cyclades
1155

  
1156
This command will check and report which users are overlimit on their
1157
Cyclades quota; it will also suggest actions to be taken in order to enforce
1158
quota limits, dependent on the overlimit resource:
1159

  
1160
* `cyclades.vm`: Delete VMs
1161
* `cyclades.total_cpu`: Delete VMs
1162
* `cyclades.cpu`: Shutdown VMs
1163
* `cyclades.total_ram`: Delete VMs
1164
* `cyclades.ram`: Shutdown VMs
1165
* `cyclades.disk`: Delete VMs
1166
* `cyclades.floating_ip`: Detach and remove IPs
1167

  
1168
VMs to be deleted/shutdown are chosen first by state in the following order:
1169
ERROR, BUILD, STOPPED, STARTED or RESIZE and then by decreasing ID. When
1170
needing to remove IPs, we first choose IPs that are free, then those
1171
attached to VMs, using the same VM ordering.
1172

  
1173
By default, the command checks only the following resources: `cyclades.cpu`,
1174
`cyclades.ram`, and `cyclades.floating_ip`; that is, the less dangerous
1175
ones, those that do not result in *deleting* any VM. One can change the
1176
default behavior by specifying the desired resources with option
1177
``--resources``. It is also possible to specify users to be checked or
1178
excluded.
1179

  
1180
Actual enforcement is done with option ``--fix``. In order to control the
1181
load that quota enforcement may cause on Cyclades, one can limit the number
1182
of operations per backend. For example,
1183

  
1184
.. code-block:: console
1185

  
1186
  # snf-manage enforce-resources-cyclades --fix --max-operations 10
1187

  
1188
will apply only the first 10 listed actions per backend. One can repeat the
1189
operation, until nothing is left to be done.
1190

  
1144 1191
Cyclades advanced operations
1145 1192
----------------------------
1146 1193

  

Also available in: Unified diff