<div dir="ltr"><br><div class="gmail_extra"><div class="gmail_quote">On Fri, Jul 12, 2013 at 11:54 PM, Tom Fifield <span dir="ltr"><<a href="mailto:tom@openstack.org" target="_blank">tom@openstack.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi all,<br>
<br>
I've been having a nice little monologue over at:<br>
<br>
<a href="https://bugs.launchpad.net/openstack-manuals/+bug/1090654" target="_blank">https://bugs.launchpad.net/<u></u>openstack-manuals/+bug/1090654</a><br>
<br>
which is a bug to document the introduction (into grizzly) of a feature called "Instance Resource Quotas", that allow you to set limits on how much cpu/disk/network particular instance types consume.<br>
<br>
As you can read, I had some initial confusion on where this would go. So here are my conclusions, provided so we can use it as an excercise in scoping with the current restructure efforts:<br>
<br>
The feature would _not_ be listed in:<br>
* Install guide: the install guide is for a basic description of installation, and this is not a necessary part<br>
<br>
* Config reference: the configuration reference is for parts of the system that need root access to systems be configured - really, things that need to be tweaked in {nova,neutron,...}.conf. This feature is always enabled, and set in user-space, using nova commands.<br>

<br>
<br>
The feature _may_ be listed in:<br>
* The Operations Guide: it may be a best practice to set instance resource limits when configuing flavors<br>
<br>
* The Secuity Guide: there are security implications of not setting these limits - where in certain situations guests could eg consume all the bandwidth, leading to a DoS attack<br>
<br>
<br>
This feature would predominantely live in:<br>
<br>
* The Admin User manual: since configuring flavours lives there, and this is a part of configuring flavours. A link to hypervisors section in config ref might be included, with a note on support of the feature across various hypervisors.<br>

<br>
* The `Comprehensive` Admin Manual: if/when this exists, it would contain an extensive discussion of the "extra_specs" metadata field, which is used to implement the Instance Resource Quotas<br>
<br>
<br>
Well that's my take - what's yours? If we can converge on this simple bug, we have achieved a minor success in scoping :)<br>
<br>
<br></blockquote><div><br></div><div>+1, I am in complete agreement.</div><div> </div><div><br></div><div>Lorin</div></div><div><br></div>-- <br><div dir="ltr">Lorin Hochstein<br><div>Lead Architect - Cloud Services</div>
<div>Nimbis Services, Inc.</div><div><a href="http://www.nimbisservices.com" target="_blank">www.nimbisservices.com</a></div></div>
</div></div>