Red Hat Training

A Red Hat training course is available for Red Hat OpenStack Platform

9.4. New, updated, and deprecated options in Liberty for OpenStack Networking

Table 9.81. New options

Option = default value (Type) Help string
[DEFAULT] dns_domain = openstacklocal (StrOpt) Domain to use for building the hostnames
[DEFAULT] dnsmasq_base_log_dir = None (StrOpt) Base log dir for dnsmasq logging. The log contains DHCP and DNS log information and is useful for debugging issues with either DHCP or DNS. If this section is null, disable dnsmasq log.
[DEFAULT] enable_new_agents = True (BoolOpt) Agent starts with admin_state_up=False when enable_new_agents=False. In the case, user's resources will not be scheduled automatically to the agent until admin changes admin_state_up to True.
[DEFAULT] enable_snat_by_default = True (BoolOpt) Define the default value of enable_snat if not provided in external_gateway_info.
[DEFAULT] endpoint_url = None (StrOpt) Neutron endpoint URL, if not set will use endpoint from the keystone catalog along with endpoint_type
[DEFAULT] executor_thread_pool_size = 64 (IntOpt) Size of executor thread pool.
[DEFAULT] force_metadata = False (BoolOpt) Force to use DHCP to get Metadata on all networks.
[DEFAULT] ipam_driver = None (StrOpt) IPAM driver to use.
[DEFAULT] password = (StrOpt) Password for Redis server (optional).
[DEFAULT] pd_confs = $state_path/pd (StrOpt) Location to store IPv6 PD files.
[DEFAULT] pd_dhcp_driver = dibbler (StrOpt) Service to handle DHCPv6 Prefix delegation.
[DEFAULT] port = 6379 (IntOpt) Use this port to connect to redis host.
[DEFAULT] prefix_delegation_driver = dibbler (StrOpt) Driver used for ipv6 prefix delegation. This needs to be an entry point defined in the neutron.agent.linux.pd_drivers namespace. See setup.cfg for entry points included with the neutron source.
[DEFAULT] rpc_conn_pool_size = 30 (IntOpt) Size of RPC connection pool.
[DEFAULT] rpc_poll_timeout = 1 (IntOpt) The default number of seconds that poll should wait. Poll raises timeout exception when timeout expired.
[DEFAULT] rpc_zmq_all_req_rep = True (BoolOpt) Use REQ/REP pattern for all methods CALL/CAST/FANOUT.
[DEFAULT] rpc_zmq_concurrency = eventlet (StrOpt) Type of concurrency used. Either "native" or "eventlet"
[DEFAULT] vendor_pen = 8888 (StrOpt) A decimal value as Vendor's Registered Private Enterprise Number as required by RFC3315 DUID-EN.
[DEFAULT] watch_log_file = False (BoolOpt) (Optional) Uses logging handler designed to watch file system. When log file is moved or removed this handler will open a new log file with specified path instantaneously. It makes sense only if log-file option is specified and Linux platform is used. This option is ignored if log_config_append is set.
[DEFAULT] zmq_use_broker = True (BoolOpt) Shows whether zmq-messaging uses broker or not.
[AGENT] agent_type = Open vSwitch agent (StrOpt) Selects the Agent Type reported
[AGENT] drop_flows_on_start = False (BoolOpt) Reset flow table on start. Setting this to True will cause brief traffic interruption.
[AGENT] log_agent_heartbeats = False (BoolOpt) Log agent heartbeats
[AGENT] tunnel_csum = False (BoolOpt) Set or un-set the tunnel header checksum on outgoing IP packet carrying GRE/VXLAN tunnel.
[LINUX_BRIDGE] bridge_mappings = (ListOpt) List of <physical_network>:<physical_bridge>
[OVS] datapath_type = system (StrOpt) OVS datapath to use.
[OVS] of_connect_timeout = 30 (IntOpt) Timeout in seconds to wait for the local switch connecting the controller. Used only for 'native' driver.
[OVS] of_interface = ovs-ofctl (StrOpt) OpenFlow interface to use.
[OVS] of_listen_address = 127.0.0.1 (IPOpt) Address to listen on for OpenFlow connections. Used only for 'native' driver.
[OVS] of_listen_port = 6633 (IntOpt) Port to listen on for OpenFlow connections. Used only for 'native' driver.
[OVS] of_request_timeout = 10 (IntOpt) Timeout in seconds to wait for a single OpenFlow request. Used only for 'native' driver.
[QUOTAS] quota_rbac_entry = 10 (IntOpt) Default number of RBAC entries allowed per tenant. A negative value means unlimited.
[QUOTAS] track_quota_usage = True (BoolOpt) Keep in track in the database of current resourcequota usage. Plugins which do not leverage the neutron database should set this flag to False
[agent] extensions = (ListOpt) Extensions list to use
[cors] allow_credentials = True (BoolOpt) Indicate that the actual request can include user credentials
[cors] allow_headers = Content-Type, Cache-Control, Content-Language, Expires, Last-Modified, Pragma (ListOpt) Indicate which header field names may be used during the actual request.
[cors] allow_methods = GET, POST, PUT, DELETE, OPTIONS (ListOpt) Indicate which methods can be used during the actual request.
[cors] allowed_origin = None (StrOpt) Indicate whether this resource may be shared with the domain received in the requests "origin" header.
[cors] expose_headers = Content-Type, Cache-Control, Content-Language, Expires, Last-Modified, Pragma (ListOpt) Indicate which headers are safe to expose to the API. Defaults to HTTP Simple Headers.
[cors] max_age = 3600 (IntOpt) Maximum cache age of CORS preflight requests.
[cors.subdomain] allow_credentials = True (BoolOpt) Indicate that the actual request can include user credentials
[cors.subdomain] allow_headers = Content-Type, Cache-Control, Content-Language, Expires, Last-Modified, Pragma (ListOpt) Indicate which header field names may be used during the actual request.
[cors.subdomain] allow_methods = GET, POST, PUT, DELETE, OPTIONS (ListOpt) Indicate which methods can be used during the actual request.
[cors.subdomain] allowed_origin = None (StrOpt) Indicate whether this resource may be shared with the domain received in the requests "origin" header.
[cors.subdomain] expose_headers = Content-Type, Cache-Control, Content-Language, Expires, Last-Modified, Pragma (ListOpt) Indicate which headers are safe to expose to the API. Defaults to HTTP Simple Headers.
[cors.subdomain] max_age = 3600 (IntOpt) Maximum cache age of CORS preflight requests.
[keystone_authtoken] region_name = None (StrOpt) The region in which the identity server can be found.
[ml2] external_network_type = None (StrOpt) Default network type for external networks when no provider attributes are specified. By default it is None, which means that if provider attributes are not specified while creating external networks then they will have the same type as tenant networks. Allowed values for external_network_type config option depend on the network type values configured in type_drivers config option.
[ml2_type_geneve] max_header_size = 50 (IntOpt) Geneve encapsulation header size is dynamic, this value is used to calculate the maximum MTU for the driver.this is the sum of the sizes of the outer ETH + IP + UDP + GENEVE header sizes
[ml2_type_geneve] vni_ranges = (ListOpt) Comma-separated list of <vni_min>:<vni_max> tuples enumerating ranges of Geneve VNI IDs that are available for tenant network allocation
[oslo_messaging_amqp] password = (StrOpt) Password for message broker authentication
[oslo_messaging_amqp] sasl_config_dir = (StrOpt) Path to directory that contains the SASL configuration
[oslo_messaging_amqp] sasl_config_name = (StrOpt) Name of configuration file (without .conf suffix)
[oslo_messaging_amqp] sasl_mechanisms = (StrOpt) Space separated list of acceptable SASL mechanisms
[oslo_messaging_amqp] username = (StrOpt) User name for message broker authentication
[oslo_messaging_qpid] send_single_reply = False (BoolOpt) Send a single AMQP reply to call message. The current behavior since oslo-incubator is to send two AMQP replies - first one with the payload, a second one to ensure the other has finished to send the payload. We are going to remove it in the N release, but we must keep backward compatible at the same time. This option provides such compatibility - it defaults to False in Liberty and can be turned on for early adopters with new installations or for testing. This option will be removed in the Mitaka release.
[oslo_messaging_rabbit] kombu_reconnect_timeout = 60 (IntOpt) How long to wait before considering a reconnect attempt to have failed. This value should not be longer than rpc_response_timeout.
[oslo_messaging_rabbit] send_single_reply = False (BoolOpt) Send a single AMQP reply to call message. The current behavior since oslo-incubator is to send two AMQP replies - first one with the payload, a second one to ensure the other has finished to send the payload. We are going to remove it in the N release, but we must keep backward compatible at the same time. This option provides such compatibility - it defaults to False in Liberty and can be turned on for early adopters with new installations or for testing. This option will be removed in the Mitaka release.
[oslo_middleware] secure_proxy_ssl_header = X-Forwarded-Proto (StrOpt) The HTTP Header that will be used to determine what the original request protocol scheme was, even if it was hidden by an SSL termination proxy.
[oslo_policy] policy_default_rule = default (StrOpt) Default rule. Enforced when a requested rule is not found.
[oslo_policy] policy_dirs = ['policy.d'] (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.
[oslo_policy] policy_file = policy.json (StrOpt) The JSON file that defines policies.
[oslo_versionedobjects] fatal_exception_format_errors = False (BoolOpt) Make exception message format errors fatal
[qos] notification_drivers = message_queue (ListOpt) Drivers list to use to send the update notification

Table 9.82. New default values

Option Previous default value New default value
[DEFAULT] api_workers 0 None
[DEFAULT] default_log_levels amqp=WARN, amqplib=WARN, boto=WARN, qpid=WARN, sqlalchemy=WARN, suds=INFO, oslo.messaging=INFO, iso8601=WARN, requests.packages.urllib3.connectionpool=WARN, urllib3.connectionpool=WARN, websocket=WARN, requests.packages.urllib3.util.retry=WARN, urllib3.util.retry=WARN, keystonemiddleware=WARN, routes.middleware=WARN, stevedore=WARN amqp=WARN, amqplib=WARN, boto=WARN, qpid=WARN, sqlalchemy=WARN, suds=INFO, oslo.messaging=INFO, iso8601=WARN, requests.packages.urllib3.connectionpool=WARN, urllib3.connectionpool=WARN, websocket=WARN, requests.packages.urllib3.util.retry=WARN, urllib3.util.retry=WARN, keystonemiddleware=WARN, routes.middleware=WARN, stevedore=WARN, taskflow=WARN
[DEFAULT] dhcp_delete_namespaces False True
[DEFAULT] endpoint_type publicURL adminURL
[DEFAULT] logging_exception_prefix %(asctime)s.%(msecs)03d %(process)d TRACE %(name)s %(instance)s %(asctime)s.%(msecs)03d %(process)d ERROR %(name)s %(instance)s
[DEFAULT] network_scheduler_driver neutron.scheduler.dhcp_agent_scheduler.ChanceScheduler neutron.scheduler.dhcp_agent_scheduler.WeightScheduler
[DEFAULT] router_delete_namespaces False True
[DEFAULT] router_scheduler_driver neutron.scheduler.l3_agent_scheduler.ChanceScheduler neutron.scheduler.l3_agent_scheduler.LeastRoutersScheduler
[DEFAULT] rpc_workers 0 1
[DEFAULT] rpc_zmq_matchmaker local redis
[DEFAULT] use_syslog_rfc_format False True
[DEFAULT] verbose False True
[AGENT] prevent_arp_spoofing False True
[QUOTAS] quota_driver neutron.db.quota_db.DbQuotaDriver neutron.db.quota.driver.DbQuotaDriver
[matchmaker_redis] password None
[ml2] type_drivers local, flat, vlan, gre, vxlan local, flat, vlan, gre, vxlan, geneve
[ml2_sriov] agent_required False True
[oslo_messaging_rabbit] heartbeat_timeout_threshold 0 60

Table 9.83. Deprecated options

Deprecated option New Option
[DEFAULT] use_syslog None
[DEFAULT] rpc_thread_pool_size [DEFAULT] executor_thread_pool_size
[ml2_sriov] agent_required None
[DEFAULT] log_format None