Red Hat Training

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

3.18. New, updated and deprecated options in Kilo for OpenStack Compute

Table 3.61. New options

Option = default value (Type) Help string
[DEFAULT] ebtables_exec_attempts = 3 (IntOpt) Number of times to retry ebtables commands on failure.
[DEFAULT] ebtables_retry_interval = 1.0 (FloatOpt) Number of seconds to wait between ebtables retries.
[DEFAULT] io_ops_weight_multiplier = -1.0 (FloatOpt) Multiplier used for weighing host io ops. Negative numbers mean a preference to choose light workload compute hosts.
[DEFAULT] keystone_ec2_insecure = False (BoolOpt) Disable SSL certificate verification.
[DEFAULT] log-config-append = None (StrOpt) The name of a logging configuration file. This file is appended to any existing logging configuration files. For details about logging configuration files, see the Python logging module documentation.
[DEFAULT] log-date-format = %Y-%m-%d %H:%M:%S (StrOpt) Format string for %%(asctime)s in log records. Default: %(default)s .
[DEFAULT] log-dir = None (StrOpt) (Optional) The base directory used for relative --log-file paths.
[DEFAULT] log-file = None (StrOpt) (Optional) Name of log file to output to. If no default is set, logging will go to stdout.
[DEFAULT] log-format = None (StrOpt) DEPRECATED. A logging.Formatter log message format string which may use any of the available logging.LogRecord attributes. This option is deprecated. Use logging_context_format_string and logging_default_format_string instead.
[DEFAULT] max_concurrent_builds = 10 (IntOpt) Maximum number of instance builds to run concurrently
[DEFAULT] metadata_cache_expiration = 15 (IntOpt) Time in seconds to cache metadata; 0 to disable metadata caching entirely (not recommended). Increasingthis should improve response times of the metadata API when under heavy load. Higher values may increase memoryusage and result in longer times for host metadata changes to take effect.
[DEFAULT] my_block_storage_ip = $my_ip (StrOpt) Block storage IP address of this host
[DEFAULT] novncproxy_host = 0.0.0.0 (StrOpt) Host on which to listen for incoming requests
[DEFAULT] novncproxy_port = 6080 (IntOpt) Port on which to listen for incoming requests
[DEFAULT] 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.
[DEFAULT] quota_networks = 3 (IntOpt) Number of private networks allowed per project
[DEFAULT] scheduler_instance_sync_interval = 120 (IntOpt) Waiting time interval (seconds) between sending the scheduler a list of current instance UUIDs to verify that its view of instances is in sync with nova. If the CONF option `scheduler_tracks_instance_changes` is False, changing this option will have no effect.
[DEFAULT] scheduler_tracks_instance_changes = True (BoolOpt) Determines if the Scheduler tracks changes to instances to help with its filtering decisions.
[DEFAULT] syslog-log-facility = LOG_USER (StrOpt) Syslog facility to receive log lines.
[DEFAULT] use-syslog = False (BoolOpt) Use syslog for logging. Existing syslog format is DEPRECATED during I, and will change in J to honor RFC5424.
[DEFAULT] use-syslog-rfc-format = False (BoolOpt) (Optional) Enables or disables syslog rfc5424 format for logging. If enabled, prefixes the MSG part of the syslog message with APP-NAME (RFC5424). The format without the APP-NAME is deprecated in I, and will be removed in J.
[api_database] connection = None (StrOpt) The SQLAlchemy connection string to use to connect to the Nova API database.
[api_database] connection_debug = 0 (IntOpt) Verbosity of SQL debugging information: 0=None, 100=Everything.
[api_database] connection_trace = False (BoolOpt) Add Python stack traces to SQL as comment strings.
[api_database] idle_timeout = 3600 (IntOpt) Timeout before idle SQL connections are reaped.
[api_database] max_overflow = None (IntOpt) If set, use this value for max_overflow with SQLAlchemy.
[api_database] max_pool_size = None (IntOpt) Maximum number of SQL connections to keep open in a pool.
[api_database] max_retries = 10 (IntOpt) Maximum number of database connection retries during startup. Set to -1 to specify an infinite retry count.
[api_database] mysql_sql_mode = TRADITIONAL (StrOpt) The SQL mode to be used for MySQL sessions. This option, including the default, overrides any server-set SQL mode. To use whatever SQL mode is set by the server configuration, set this to no value. Example: mysql_sql_mode=
[api_database] pool_timeout = None (IntOpt) If set, use this value for pool_timeout with SQLAlchemy.
[api_database] retry_interval = 10 (IntOpt) Interval between retries of opening a SQL connection.
[api_database] slave_connection = None (StrOpt) The SQLAlchemy connection string to use to connect to the slave database.
[api_database] sqlite_synchronous = True (BoolOpt) If True, SQLite uses synchronous mode.
[barbican] cafile = None (StrOpt) PEM encoded Certificate Authority to use when verifying HTTPs connections.
[barbican] catalog_info = key-manager:barbican:public (StrOpt) Info to match when looking for barbican in the service catalog. Format is: separated values of the form: <service_type>:<service_name>:<endpoint_type>
[barbican] certfile = None (StrOpt) PEM encoded client certificate cert file
[barbican] endpoint_template = None (StrOpt) Override service catalog lookup with template for barbican endpoint e.g. http://localhost:9311/v1/%(project_id)s
[barbican] insecure = False (BoolOpt) Verify HTTPS connections.
[barbican] keyfile = None (StrOpt) PEM encoded client certificate key file
[barbican] os_region_name = None (StrOpt) Region name of this node
[barbican] timeout = None (IntOpt) Timeout value for http requests
[cinder] cafile = None (StrOpt) PEM encoded Certificate Authority to use when verifying HTTPs connections.
[cinder] certfile = None (StrOpt) PEM encoded client certificate cert file
[cinder] insecure = False (BoolOpt) Verify HTTPS connections.
[cinder] keyfile = None (StrOpt) PEM encoded client certificate key file
[cinder] timeout = None (IntOpt) Timeout value for http requests
[database] backend = sqlalchemy (StrOpt) The back end to use for the database.
[database] connection = None (StrOpt) The SQLAlchemy connection string to use to connect to the database.
[database] connection_debug = 0 (IntOpt) Verbosity of SQL debugging information: 0=None, 100=Everything.
[database] connection_trace = False (BoolOpt) Add Python stack traces to SQL as comment strings.
[database] db_inc_retry_interval = True (BoolOpt) If True, increases the interval between retries of a database operation up to db_max_retry_interval.
[database] db_max_retries = 20 (IntOpt) Maximum retries in case of connection error or deadlock error before error is raised. Set to -1 to specify an infinite retry count.
[database] db_max_retry_interval = 10 (IntOpt) If db_inc_retry_interval is set, the maximum seconds between retries of a database operation.
[database] db_retry_interval = 1 (IntOpt) Seconds between retries of a database transaction.
[database] idle_timeout = 3600 (IntOpt) Timeout before idle SQL connections are reaped.
[database] max_overflow = None (IntOpt) If set, use this value for max_overflow with SQLAlchemy.
[database] max_pool_size = None (IntOpt) Maximum number of SQL connections to keep open in a pool.
[database] max_retries = 10 (IntOpt) Maximum number of database connection retries during startup. Set to -1 to specify an infinite retry count.
[database] min_pool_size = 1 (IntOpt) Minimum number of SQL connections to keep open in a pool.
[database] mysql_sql_mode = TRADITIONAL (StrOpt) The SQL mode to be used for MySQL sessions. This option, including the default, overrides any server-set SQL mode. To use whatever SQL mode is set by the server configuration, set this to no value. Example: mysql_sql_mode=
[database] pool_timeout = None (IntOpt) If set, use this value for pool_timeout with SQLAlchemy.
[database] retry_interval = 10 (IntOpt) Interval between retries of opening a SQL connection.
[database] slave_connection = None (StrOpt) The SQLAlchemy connection string to use to connect to the slave database.
[database] sqlite_db = oslo.sqlite (StrOpt) The file name to use with SQLite.
[database] sqlite_synchronous = True (BoolOpt) If True, SQLite uses synchronous mode.
[database] use_db_reconnect = False (BoolOpt) Enable the experimental use of database reconnect on connection lost.
[guestfs] debug = False (BoolOpt) Enable guestfs debug
[libvirt] iscsi_iface = None (StrOpt) The iSCSI transport iface to use to connect to target in case offload support is desired. Supported transports are be2iscsi, bnx2i, cxgb3i, cxgb4i, qla4xxx and ocs. Default format is transport_name.hwaddress and can be generated manually or via iscsiadm -m iface
[libvirt] quobyte_client_cfg = None (StrOpt) Path to a Quobyte Client configuration file.
[libvirt] quobyte_mount_point_base = $state_path/mnt (StrOpt) Directory where the Quobyte volume is mounted on the compute node
[libvirt] smbfs_mount_options = (StrOpt) Mount options passed to the SMBFS client. See mount.cifs man page for details. Note that the libvirt-qemu uid and gid must be specified.
[libvirt] smbfs_mount_point_base = $state_path/mnt (StrOpt) Directory where the SMBFS shares are mounted on the compute node
[neutron] auth_plugin = None (StrOpt) Name of the plugin to load
[neutron] auth_section = None (StrOpt) Config Section from which to load plugin specific options
[neutron] cafile = None (StrOpt) PEM encoded Certificate Authority to use when verifying HTTPs connections.
[neutron] certfile = None (StrOpt) PEM encoded client certificate cert file
[neutron] insecure = False (BoolOpt) Verify HTTPS connections.
[neutron] keyfile = None (StrOpt) PEM encoded client certificate key file
[neutron] timeout = None (IntOpt) Timeout value for http requests
[oslo_concurrency] disable_process_locking = False (BoolOpt) Enables or disables inter-process locks.
[oslo_concurrency] lock_path = None (StrOpt) Directory to use for lock files. For security, the specified directory should only be writable by the user running the processes that need locking. Defaults to environment variable OSLO_LOCK_PATH. If external locks are used, a lock path must be set.
[oslo_messaging_amqp] allow_insecure_clients = False (BoolOpt) Accept clients using either SSL or plain TCP
[oslo_messaging_amqp] broadcast_prefix = broadcast (StrOpt) address prefix used when broadcasting to all servers
[oslo_messaging_amqp] container_name = None (StrOpt) Name for the AMQP container
[oslo_messaging_amqp] group_request_prefix = unicast (StrOpt) address prefix when sending to any server in group
[oslo_messaging_amqp] idle_timeout = 0 (IntOpt) Timeout for inactive connections (in seconds)
[oslo_messaging_amqp] server_request_prefix = exclusive (StrOpt) address prefix used when sending to a specific server
[oslo_messaging_amqp] ssl_ca_file = (StrOpt) CA certificate PEM file for verifing server certificate
[oslo_messaging_amqp] ssl_cert_file = (StrOpt) Identifying certificate PEM file to present to clients
[oslo_messaging_amqp] ssl_key_file = (StrOpt) Private key PEM file used to sign cert_file certificate
[oslo_messaging_amqp] ssl_key_password = None (StrOpt) Password for decrypting ssl_key_file (if encrypted)
[oslo_messaging_amqp] trace = False (BoolOpt) Debug: dump AMQP frames to stdout
[oslo_messaging_qpid] amqp_auto_delete = False (BoolOpt) Auto-delete queues in AMQP.
[oslo_messaging_qpid] amqp_durable_queues = False (BoolOpt) Use durable queues in AMQP.
[oslo_messaging_qpid] qpid_heartbeat = 60 (IntOpt) Seconds between connection keepalive heartbeats.
[oslo_messaging_qpid] qpid_hostname = localhost (StrOpt) Qpid broker hostname.
[oslo_messaging_qpid] qpid_hosts = $qpid_hostname:$qpid_port (ListOpt) Qpid HA cluster host:port pairs.
[oslo_messaging_qpid] qpid_password = (StrOpt) Password for Qpid connection.
[oslo_messaging_qpid] qpid_port = 5672 (IntOpt) Qpid broker port.
[oslo_messaging_qpid] qpid_protocol = tcp (StrOpt) Transport to use, either 'tcp' or 'ssl'.
[oslo_messaging_qpid] qpid_receiver_capacity = 1 (IntOpt) The number of prefetched messages held by receiver.
[oslo_messaging_qpid] qpid_sasl_mechanisms = (StrOpt) Space separated list of SASL mechanisms to use for auth.
[oslo_messaging_qpid] qpid_tcp_nodelay = True (BoolOpt) Whether to disable the Nagle algorithm.
[oslo_messaging_qpid] qpid_topology_version = 1 (IntOpt) The qpid topology version to use. Version 1 is what was originally used by impl_qpid. Version 2 includes some backwards-incompatible changes that allow broker federation to work. Users should update to version 2 when they are able to take everything down, as it requires a clean break.
[oslo_messaging_qpid] qpid_username = (StrOpt) Username for Qpid connection.
[oslo_messaging_qpid] rpc_conn_pool_size = 30 (IntOpt) Size of RPC connection pool.
[oslo_messaging_rabbit] amqp_auto_delete = False (BoolOpt) Auto-delete queues in AMQP.
[oslo_messaging_rabbit] amqp_durable_queues = False (BoolOpt) Use durable queues in AMQP.
[oslo_messaging_rabbit] fake_rabbit = False (BoolOpt) Deprecated, use rpc_backend=kombu+memory or rpc_backend=fake
[oslo_messaging_rabbit] heartbeat_rate = 2 (IntOpt) How often times during the heartbeat_timeout_threshold to check the heartbeat.
[oslo_messaging_rabbit] heartbeat_timeout_threshold = 0 (IntOpt) Number of seconds after which the Rabbit broker is considered down if heartbeat's keep-alive fails (0 disables the heartbeat, >0 enables it. Enabling heartbeats requires kombu>=3.0.7 and amqp>=1.4.0). EXPERIMENTAL
[oslo_messaging_rabbit] kombu_reconnect_delay = 1.0 (FloatOpt) How long to wait before reconnecting in response to an AMQP consumer cancel notification.
[oslo_messaging_rabbit] kombu_ssl_ca_certs = (StrOpt) SSL certification authority file (valid only if SSL enabled).
[oslo_messaging_rabbit] kombu_ssl_certfile = (StrOpt) SSL cert file (valid only if SSL enabled).
[oslo_messaging_rabbit] kombu_ssl_keyfile = (StrOpt) SSL key file (valid only if SSL enabled).
[oslo_messaging_rabbit] kombu_ssl_version = (StrOpt) SSL version to use (valid only if SSL enabled). Valid values are TLSv1 and SSLv23. SSLv2, SSLv3, TLSv1_1, and TLSv1_2 are also available.
[oslo_messaging_rabbit] rabbit_ha_queues = False (BoolOpt) Use HA queues in RabbitMQ (x-ha-policy: all). If you change this option, you must wipe the RabbitMQ database.
[oslo_messaging_rabbit] rabbit_host = localhost (StrOpt) The RabbitMQ broker address where a single node is used.
[oslo_messaging_rabbit] rabbit_hosts = $rabbit_host:$rabbit_port (ListOpt) RabbitMQ HA cluster host:port pairs.
[oslo_messaging_rabbit] rabbit_login_method = AMQPLAIN (StrOpt) The RabbitMQ login method.
[oslo_messaging_rabbit] rabbit_max_retries = 0 (IntOpt) Maximum number of RabbitMQ connection retries. Default is 0 (infinite retry count).
[oslo_messaging_rabbit] rabbit_password = guest (StrOpt) The RabbitMQ password.
[oslo_messaging_rabbit] rabbit_port = 5672 (IntOpt) The RabbitMQ broker port where a single node is used.
[oslo_messaging_rabbit] rabbit_retry_backoff = 2 (IntOpt) How long to backoff for between retries when connecting to RabbitMQ.
[oslo_messaging_rabbit] rabbit_retry_interval = 1 (IntOpt) How frequently to retry connecting with RabbitMQ.
[oslo_messaging_rabbit] rabbit_use_ssl = False (BoolOpt) Connect over SSL for RabbitMQ.
[oslo_messaging_rabbit] rabbit_userid = guest (StrOpt) The RabbitMQ userid.
[oslo_messaging_rabbit] rabbit_virtual_host = / (StrOpt) The RabbitMQ virtual host.
[oslo_messaging_rabbit] rpc_conn_pool_size = 30 (IntOpt) Size of RPC connection pool.
[oslo_middleware] max_request_body_size = 114688 (IntOpt) The maximum body size for each request, in bytes.
[serial_console] serialproxy_host = 0.0.0.0 (StrOpt) Host on which to listen for incoming requests
[serial_console] serialproxy_port = 6083 (IntOpt) Port on which to listen for incoming requests
[vmware] cache_prefix = None (StrOpt) The prefix for Where cached images are stored. This is NOT the full path - only a folder prefix. This should only be used when a datastore cache should be shared between compute nodes. Note: this should only be used when the compute nodes have a shared file system.
[vmware] pbm_default_policy = None (StrOpt) The PBM default policy. If pbm_wsdl_location is set and there is no defined storage policy for the specific request then this policy will be used.
[vmware] pbm_enabled = False (BoolOpt) The PBM status.
[vmware] pbm_wsdl_location = None (StrOpt) PBM service WSDL file location URL. e.g. file:///opt/SDK/spbm/wsdl/pbmService.wsdl Not setting this will disable storage policy based placement of instances.
[workarounds] destroy_after_evacuate = True (BoolOpt) Whether to destroy instances on startup when it is suspected that they have previously been evacuated. This can result in data loss if undesired. See https://launchpad.net/bugs/1419785
[workarounds] disable_libvirt_livesnapshot = True (BoolOpt) When using libvirt 1.2.2 fails live snapshots intermittently under load. This config option provides mechanism to disable livesnapshot while this is resolved. See https://bugs.launchpad.net/nova/+bug/1334398
[workarounds] disable_rootwrap = False (BoolOpt) This option allows a fallback to sudo for performance reasons. For example see https://bugs.launchpad.net/nova/+bug/1415106

Table 3.62. New default values

Option Previous default value New default value
[DEFAULT] client_socket_timeout 0 900
[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, 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
[DEFAULT] ec2_path /services/Cloud /
[DEFAULT] multi_instance_display_name_template %(name)s-%(uuid)s %(name)s-%(count)d
[DEFAULT] rpc_zmq_matchmaker oslo.messaging._drivers.matchmaker.MatchMakerLocalhost local
[cinder] catalog_info volume:cinder:publicURL volumev2:cinderv2:publicURL

Table 3.63. Deprecated options

Deprecated option New Option
[DEFAULT] network_device_mtu None
[DEFAULT] log-format None
[DEFAULT] use-syslog None
[cinder] http_timeout [cinder] timeout
[DEFAULT] use_syslog None
[ironic] client_log_level None
[neutron] admin_username None
[DEFAULT] osapi_max_request_body_size [oslo_middleware] max_request_body_size
[neutron] ca_certificates_file [neutron] cafile
[neutron] auth_strategy None
[neutron] admin_user_id None
[neutron] admin_tenant_id None
[DEFAULT] log_format None
[cinder] api_insecure [cinder] insecure
[neutron] admin_tenant_name None
[neutron] admin_password None
[DEFAULT] share_dhcp_address None
[neutron] api_insecure [neutron] insecure
[cinder] ca_certificates_file [cinder] cafile
[neutron] admin_auth_url None
[neutron] url_timeout [neutron] timeout
[neutron] allow_duplicate_networks None