openstack-manuals/doc/common/tables/neutron-l3_agent.xml
Atsushi SAKAI 71bf779f1c Update Config reference for neutron
Edit section_network-plugins.xml
       section_network-plugins-ml2.xml
  Stay removed mlnx (mellanox)

  Unchanged because of trouble
       networking-ibm (SDN-VE)
       octavia

  Cannot include because of trouble
       networking-infoblox
       networking-zvm

  Consider neutron plugin addition (#1503967)

Change-Id: I41272af4ec46c7e7c1c3ce7d6e03c6a40fb0cb25
Partial-Bug: #1407581
Related-Bug: #1503967
2015-10-13 19:36:54 +09:00

122 lines
6.7 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_neutron_l3_agent">
<caption>Description of L3 agent 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>agent_mode</option> = <replaceable>legacy</replaceable></td>
<td>(StrOpt) The working mode for the agent. Allowed modes are: 'legacy' - this preserves the existing behavior where the L3 agent is deployed on a centralized networking node to provide L3 services like DNAT, and SNAT. Use this mode if you do not want to adopt DVR. 'dvr' - this mode enables DVR functionality and must be used for an L3 agent that runs on a compute host. 'dvr_snat' - this enables centralized SNAT support in conjunction with DVR. This mode must be used for an L3 agent running on a centralized node (or in single-host deployments, e.g. devstack)</td>
</tr>
<tr>
<td><option>allow_automatic_dhcp_failover</option> = <replaceable>True</replaceable></td>
<td>(BoolOpt) Automatically remove networks from offline DHCP agents.</td>
</tr>
<tr>
<td><option>allow_automatic_l3agent_failover</option> = <replaceable>False</replaceable></td>
<td>(BoolOpt) Automatically reschedule routers from offline L3 agents to online L3 agents.</td>
</tr>
<tr>
<td><option>enable_metadata_proxy</option> = <replaceable>True</replaceable></td>
<td>(BoolOpt) Allow running metadata proxy.</td>
</tr>
<tr>
<td><option>enable_snat_by_default</option> = <replaceable>True</replaceable></td>
<td>(BoolOpt) Define the default value of enable_snat if not provided in external_gateway_info.</td>
</tr>
<tr>
<td><option>external_ingress_mark</option> = <replaceable>0x2</replaceable></td>
<td>(StrOpt) Iptables mangle mark used to mark ingress from external network. This mark will be masked with 0xffff so that only the lower 16 bits will be used.</td>
</tr>
<tr>
<td><option>external_network_bridge</option> = <replaceable>br-ex</replaceable></td>
<td>(StrOpt) Name of bridge used for external network traffic.</td>
</tr>
<tr>
<td><option>gateway_external_network_id</option> = <replaceable></replaceable></td>
<td>(StrOpt) UUID of external network for routers implemented by the agents.</td>
</tr>
<tr>
<td><option>ha_confs_path</option> = <replaceable>$state_path/ha_confs</replaceable></td>
<td>(StrOpt) Location to store keepalived/conntrackd config files</td>
</tr>
<tr>
<td><option>ha_vrrp_advert_int</option> = <replaceable>2</replaceable></td>
<td>(IntOpt) The advertisement interval in seconds</td>
</tr>
<tr>
<td><option>ha_vrrp_auth_password</option> = <replaceable>None</replaceable></td>
<td>(StrOpt) VRRP authentication password</td>
</tr>
<tr>
<td><option>ha_vrrp_auth_type</option> = <replaceable>PASS</replaceable></td>
<td>(StrOpt) VRRP authentication type</td>
</tr>
<tr>
<td><option>handle_internal_only_routers</option> = <replaceable>True</replaceable></td>
<td>(BoolOpt) Agent should implement routers with no gateway</td>
</tr>
<tr>
<td><option>ipv6_gateway</option> = <replaceable></replaceable></td>
<td>(StrOpt) With IPv6, the network used for the external gateway does not need to have an associated subnet, since the automatically assigned link-local address (LLA) can be used. However, an IPv6 gateway address is needed for use as the next-hop for the default route. If no IPv6 gateway address is configured here, (and only then) the neutron router will be configured to get its default route from router advertisements (RAs) from the upstream router; in which case the upstream router must also be configured to send these RAs. The ipv6_gateway, when configured, should be the LLA of the interface on the upstream router. If a next-hop using a global unique address (GUA) is desired, it needs to be done via a subnet allocated to the network and not through this parameter.</td>
</tr>
<tr>
<td><option>l3_ha</option> = <replaceable>False</replaceable></td>
<td>(BoolOpt) Enable HA mode for virtual routers.</td>
</tr>
<tr>
<td><option>l3_ha_net_cidr</option> = <replaceable>169.254.192.0/18</replaceable></td>
<td>(StrOpt) Subnet used for the l3 HA admin network.</td>
</tr>
<tr>
<td><option>l3_ha_network_physical_name</option> = <replaceable></replaceable></td>
<td>(StrOpt) The physical network name with which the HA network can be created.</td>
</tr>
<tr>
<td><option>l3_ha_network_type</option> = <replaceable></replaceable></td>
<td>(StrOpt) The network type to use when creating the HA network for an HA router. By default or if empty, the first 'tenant_network_types' is used. This is helpful when the VRRP traffic should use a specific network which is not the default one.</td>
</tr>
<tr>
<td><option>max_l3_agents_per_router</option> = <replaceable>3</replaceable></td>
<td>(IntOpt) Maximum number of agents on which a router will be scheduled.</td>
</tr>
<tr>
<td><option>min_l3_agents_per_router</option> = <replaceable>2</replaceable></td>
<td>(IntOpt) Minimum number of agents on which a router will be scheduled.</td>
</tr>
<tr>
<td><option>router_id</option> = <replaceable></replaceable></td>
<td>(StrOpt) If namespaces is disabled, the l3 agent can only configure a router that has the matching router ID.</td>
</tr>
<tr>
<td><option>send_arp_for_ha</option> = <replaceable>3</replaceable></td>
<td>(IntOpt) Send this many gratuitous ARPs for HA setup, if less than or equal to 0, the feature is disabled</td>
</tr>
<tr>
<th colspan="2">[AGENT]</th>
</tr>
<tr>
<td><option>comment_iptables_rules</option> = <replaceable>True</replaceable></td>
<td>(BoolOpt) Add comments to iptables rules.</td>
</tr>
<tr>
<td><option>use_helper_for_ns_read</option> = <replaceable>True</replaceable></td>
<td>(BoolOpt) Use the root helper to read the namespaces from the operating system.</td>
</tr>
</tbody>
</table>
</para>