openstack-manuals/doc/common/tables/nova-policy.xml
Gauvain Pocentek cdebb041d5 [config-ref] Nova option tables update
Partial-Bug: #1472417
Closes-Bug: #1465841
Partial-Bug: #1461459
Partial-Bug: #1454356
Closes-Bug: #1450002

Change-Id: I1ce5933ce20d2021f4286ca965823483940157fe
2015-07-19 17:01:07 +02:00

75 lines
4.3 KiB
XML

<?xml version='1.0' encoding='UTF-8'?>
<para xmlns="http://docbook.org/ns/docbook" version="5.0">
<!-- Warning: Do not edit this file. It is automatically
generated and your changes will be overwritten.
The tool to do so lives in openstack-doc-tools repository. -->
<table rules="all" xml:id="config_table_nova_policy">
<caption>Description of policy configuration options</caption>
<col width="50%"/>
<col width="50%"/>
<thead>
<tr>
<th>Configuration option = Default value</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<th colspan="2">[DEFAULT]</th>
</tr>
<tr>
<td><option>allow_instance_snapshots</option> = <replaceable>True</replaceable></td>
<td>(BoolOpt) Permit instance snapshot operations.</td>
</tr>
<tr>
<td><option>allow_resize_to_same_host</option> = <replaceable>False</replaceable></td>
<td>(BoolOpt) Allow destination machine to match source for resize. Useful when testing in single-host environments.</td>
</tr>
<tr>
<td><option>max_age</option> = <replaceable>0</replaceable></td>
<td>(IntOpt) Number of seconds between subsequent usage refreshes. This defaults to 0(off) to avoid additional load but it is useful to turn on to help keep quota usage up to date and reduce the impact of out of sync usage issues. Note that quotas are not updated on a periodic task, they will update on a new reservation if max_age has passed since the last reservation</td>
</tr>
<tr>
<td><option>max_local_block_devices</option> = <replaceable>3</replaceable></td>
<td>(IntOpt) Maximum number of devices that will result in a local image being created on the hypervisor node. Setting this to 0 means nova will allow only boot from volume. A negative number means unlimited.</td>
</tr>
<tr>
<td><option>osapi_compute_unique_server_name_scope</option> = <replaceable></replaceable></td>
<td>(StrOpt) When set, compute API will consider duplicate hostnames invalid within the specified scope, regardless of case. Should be empty, "project" or "global".</td>
</tr>
<tr>
<td><option>osapi_max_limit</option> = <replaceable>1000</replaceable></td>
<td>(IntOpt) The maximum number of items returned in a single response from a collection resource</td>
</tr>
<tr>
<td><option>password_length</option> = <replaceable>12</replaceable></td>
<td>(IntOpt) Length of generated instance admin passwords</td>
</tr>
<tr>
<td><option>policy_default_rule</option> = <replaceable>default</replaceable></td>
<td>(StrOpt) Default rule. Enforced when a requested rule is not found.</td>
</tr>
<tr>
<td><option>policy_dirs</option> = <replaceable>['policy.d']</replaceable></td>
<td>(MultiStrOpt) Directories where policy configuration files are stored. They can be relative to any directory in the search path defined by the config_dir option, or absolute paths. The file defined by policy_file must exist for these directories to be searched. Missing or empty directories are ignored.</td>
</tr>
<tr>
<td><option>policy_file</option> = <replaceable>policy.json</replaceable></td>
<td>(StrOpt) The JSON file that defines policies.</td>
</tr>
<tr>
<td><option>reservation_expire</option> = <replaceable>86400</replaceable></td>
<td>(IntOpt) Number of seconds until a reservation expires</td>
</tr>
<tr>
<td><option>resize_fs_using_block_device</option> = <replaceable>False</replaceable></td>
<td>(BoolOpt) Attempt to resize the filesystem by accessing the image over a block device. This is done by the host and may not be necessary if the image contains a recent version of cloud-init. Possible mechanisms require the nbd driver (for qcow and raw), or loop (for raw).</td>
</tr>
<tr>
<td><option>until_refresh</option> = <replaceable>0</replaceable></td>
<td>(IntOpt) Count of reservations until usage is refreshed. This defaults to 0(off) to avoid additional load but it is useful to turn on to help keep quota usage up to date and reduce the impact of out of sync usage issues.</td>
</tr>
</tbody>
</table>
</para>