Configuration Options

The following is an overview of all available configuration options in Ironic. For a sample configuration file, refer to Sample Configuration File.

DEFAULT

rpc_conn_pool_size

Type:

integer

Default:

30

Minimum Value:

1

Size of RPC connection pool.

Deprecated Variations

Group	Name
DEFAULT	rpc_conn_pool_size

conn_pool_min_size

Type:

integer

Default:

2

The pool size limit for connections expiration policy

conn_pool_ttl

Type:

integer

Default:

1200

The time-to-live in sec of idle connections in the pool

executor_thread_pool_size

Type:

integer

Default:

64

Size of executor thread pool when executor is threading or eventlet.

Deprecated Variations

Group	Name
DEFAULT	rpc_thread_pool_size

rpc_response_timeout

Type:

integer

Default:

60

Seconds to wait for a response from a call.

transport_url

Type:

string

Default:

rabbit://

The network address and optional user credentials for connecting to the messaging backend, in URL format. The expected format is:

driver://[user:pass@]host:port[,[userN:passN@]hostN:portN]/virtual_host?query

Example: rabbit://rabbitmq:password@127.0.0.1:5672//

For full details on the fields in the URL see the documentation of oslo_messaging.TransportURL at https://docs.openstack.org/oslo.messaging/latest/reference/transport.html

control_exchange

Type:

string

Default:

openstack

The default exchange under which topics are scoped. May be overridden by an exchange name specified in the transport_url option.

rpc_ping_enabled

Type:

boolean

Default:

False

Add an endpoint to answer to ping calls. Endpoint is named oslo_rpc_server_ping

debug

Type:

boolean

Default:

False

Mutable:

This option can be changed without restarting.

If set to true, the logging level will be set to DEBUG instead of the default INFO level.

log_config_append

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

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. Note that when logging configuration files are used then all logging configuration is set in the configuration file and other logging configuration options are ignored (for example, log-date-format).

Deprecated Variations

Group	Name
DEFAULT	log-config
DEFAULT	log_config

log_date_format

Type:

string

Default:

%Y-%m-%d %H:%M:%S

Defines the format string for %(asctime)s in log records. Default: the value above . This option is ignored if log_config_append is set.

log_file

Type:

string

Default:

<None>

(Optional) Name of log file to send logging output to. If no default is set, logging will go to stderr as defined by use_stderr. This option is ignored if log_config_append is set.

Deprecated Variations

Group	Name
DEFAULT	logfile

log_dir

Type:

string

Default:

<None>

(Optional) The base directory used for relative log_file paths. This option is ignored if log_config_append is set.

Deprecated Variations

Group	Name
DEFAULT	logdir

watch_log_file

Type:

boolean

Default:

False

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.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

This function is known to have bene broken for long time, and depends on the unmaintained library

use_syslog

Type:

boolean

Default:

False

Use syslog for logging. Existing syslog format is DEPRECATED and will be changed later to honor RFC5424. This option is ignored if log_config_append is set.

use_journal

Type:

boolean

Default:

False

Enable journald for logging. If running in a systemd environment you may wish to enable journal support. Doing so will use the journal native protocol which includes structured metadata in addition to log messages.This option is ignored if log_config_append is set.

syslog_log_facility

Type:

string

Default:

LOG_USER

Syslog facility to receive log lines. This option is ignored if log_config_append is set.

use_json

Type:

boolean

Default:

False

Use JSON formatting for logging. This option is ignored if log_config_append is set.

use_stderr

Type:

boolean

Default:

False

Log output to standard error. This option is ignored if log_config_append is set.

use_eventlog

Type:

boolean

Default:

False

Log output to Windows Event Log.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

Windows support is no longer maintained.

log_color

Type:

boolean

Default:

False

(Optional) Set the ‘color’ key according to log levels. This option takes effect only when logging to stderr or stdout is used. This option is ignored if log_config_append is set.

log_rotate_interval

Type:

integer

Default:

1

The amount of time before the log files are rotated. This option is ignored unless log_rotation_type is set to “interval”.

log_rotate_interval_type

Type:

string

Default:

days

Valid Values:

Seconds, Minutes, Hours, Days, Weekday, Midnight

Rotation interval type. The time of the last file change (or the time when the service was started) is used when scheduling the next rotation.

max_logfile_count

Type:

integer

Default:

30

Maximum number of rotated log files.

max_logfile_size_mb

Type:

integer

Default:

200

Log file maximum size in MB. This option is ignored if “log_rotation_type” is not set to “size”.

log_rotation_type

Type:

string

Default:

none

Valid Values:

interval, size, none

Log rotation type.

Possible values

interval

Rotate logs at predefined time intervals.

size

Rotate logs once they reach a predefined size.

none

Do not rotate log files.

logging_context_format_string

Type:

string

Default:

%(asctime)s.%(msecs)03d %(process)d %(levelname)s %(name)s [%(global_request_id)s %(request_id)s %(user_identity)s] %(instance)s%(message)s

Format string to use for log messages with context. Used by oslo_log.formatters.ContextFormatter

logging_default_format_string

Type:

string

Default:

%(asctime)s.%(msecs)03d %(process)d %(levelname)s %(name)s [-] %(instance)s%(message)s

Format string to use for log messages when context is undefined. Used by oslo_log.formatters.ContextFormatter

logging_debug_format_suffix

Type:

string

Default:

%(funcName)s %(pathname)s:%(lineno)d

Additional data to append to log message when logging level for the message is DEBUG. Used by oslo_log.formatters.ContextFormatter

logging_exception_prefix

Type:

string

Default:

%(asctime)s.%(msecs)03d %(process)d ERROR %(name)s %(instance)s

Prefix each line of exception output with this format. Used by oslo_log.formatters.ContextFormatter

logging_user_identity_format

Type:

string

Default:

%(user)s %(project)s %(domain)s %(system_scope)s %(user_domain)s %(project_domain)s

Defines the format string for %(user_identity)s that is used in logging_context_format_string. Used by oslo_log.formatters.ContextFormatter

default_log_levels

Type:

list

Default:

['amqp=WARNING', 'amqplib=WARNING', 'qpid.messaging=INFO', 'oslo.messaging=INFO', 'oslo_messaging=INFO', 'stevedore=INFO', 'eventlet.wsgi.server=INFO', 'iso8601=WARNING', 'requests=WARNING', 'urllib3.connectionpool=WARNING', 'keystonemiddleware.auth_token=INFO', 'keystoneauth.session=INFO', 'openstack=WARNING', 'oslo_policy=WARNING', 'oslo_concurrency.lockutils=WARNING']

List of package logging levels in logger=LEVEL pairs. This option is ignored if log_config_append is set.

publish_errors

Type:

boolean

Default:

False

Enables or disables publication of error events.

instance_format

Type:

string

Default:

"[instance: %(uuid)s] "

The format for an instance that is passed with the log message.

instance_uuid_format

Type:

string

Default:

"[instance: %(uuid)s] "

The format for an instance UUID that is passed with the log message.

rate_limit_interval

Type:

integer

Default:

0

Interval, number of seconds, of log rate limiting.

rate_limit_burst

Type:

integer

Default:

0

Maximum number of logged messages per rate_limit_interval.

rate_limit_except_level

Type:

string

Default:

CRITICAL

Valid Values:

CRITICAL, ERROR, INFO, WARNING, DEBUG, ‘’

Log level name used by rate limiting. Logs with level greater or equal to rate_limit_except_level are not filtered. An empty string means that all levels are filtered.

fatal_deprecations

Type:

boolean

Default:

False

Enables or disables fatal status of deprecations.

auth_strategy

Type:

string

Default:

keystone

Valid Values:

noauth, keystone, http_basic

Authentication strategy used by ironic-api. “noauth” should not be used in a production environment because all authentication will be disabled creating insecure operating conditions.

Possible values

noauth

no authentication

keystone

use the Identity service for authentication

http_basic

HTTP basic authentication

http_basic_auth_user_file

Type:

string

Default:

/etc/ironic/htpasswd

Path to Apache format user authentication file used when auth_strategy=http_basic

debug_tracebacks_in_api

Type:

boolean

Default:

False

Return server tracebacks in the API response for any error responses. WARNING: this is insecure and should not be used in a production environment.

pecan_debug

Type:

boolean

Default:

False

Enable pecan debug mode. WARNING: this is insecure and should not be used in a production environment.

default_resource_class

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

Resource class to use for new nodes when no resource class is provided in the creation request.

default_conductor_group

Type:

string

Default:

''

Mutable:

This option can be changed without restarting.

The conductor_group to use for new nodes when no conductor_group was defined in the creation request.

enabled_hardware_types

Type:

list

Default:

['ipmi', 'redfish']

Specify the list of hardware types to load during service initialization. Missing hardware types, or hardware types which fail to initialize, will prevent the conductor service from starting. This option defaults to a recommended set of production-oriented hardware types. A complete list of hardware types present on your system may be found by enumerating the “ironic.hardware.types” entrypoint.

enabled_bios_interfaces

Type:

list

Default:

['no-bios', 'redfish']

Specify the list of bios interfaces to load during service initialization. Missing bios interfaces, or bios interfaces which fail to initialize, will prevent the ironic-conductor service from starting. At least one bios interface that is supported by each enabled hardware type must be enabled here, or the ironic-conductor service will not start. Must not be an empty list. The default value is a recommended set of production-oriented bios interfaces. A complete list of bios interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.bios” entrypoint. When setting this value, please make sure that every enabled hardware type will have the same set of enabled bios interfaces on every ironic-conductor service.

default_bios_interface

Type:

string

Default:

<None>

Default bios interface to be used for nodes that do not have bios_interface field set. A complete list of bios interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.bios” entrypoint.

enabled_boot_interfaces

Type:

list

Default:

['ipxe', 'pxe', 'redfish-virtual-media']

Specify the list of boot interfaces to load during service initialization. Missing boot interfaces, or boot interfaces which fail to initialize, will prevent the ironic-conductor service from starting. At least one boot interface that is supported by each enabled hardware type must be enabled here, or the ironic-conductor service will not start. Must not be an empty list. The default value is a recommended set of production-oriented boot interfaces. A complete list of boot interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.boot” entrypoint. When setting this value, please make sure that every enabled hardware type will have the same set of enabled boot interfaces on every ironic-conductor service.

default_boot_interface

Type:

string

Default:

<None>

Default boot interface to be used for nodes that do not have boot_interface field set. A complete list of boot interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.boot” entrypoint.

enabled_console_interfaces

Type:

list

Default:

['no-console']

Specify the list of console interfaces to load during service initialization. Missing console interfaces, or console interfaces which fail to initialize, will prevent the ironic-conductor service from starting. At least one console interface that is supported by each enabled hardware type must be enabled here, or the ironic-conductor service will not start. Must not be an empty list. The default value is a recommended set of production-oriented console interfaces. A complete list of console interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.console” entrypoint. When setting this value, please make sure that every enabled hardware type will have the same set of enabled console interfaces on every ironic-conductor service.

default_console_interface

Type:

string

Default:

<None>

Default console interface to be used for nodes that do not have console_interface field set. A complete list of console interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.console” entrypoint.

enabled_deploy_interfaces

Type:

list

Default:

['direct', 'ramdisk']

Specify the list of deploy interfaces to load during service initialization. Missing deploy interfaces, or deploy interfaces which fail to initialize, will prevent the ironic-conductor service from starting. At least one deploy interface that is supported by each enabled hardware type must be enabled here, or the ironic-conductor service will not start. Must not be an empty list. The default value is a recommended set of production-oriented deploy interfaces. A complete list of deploy interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.deploy” entrypoint. When setting this value, please make sure that every enabled hardware type will have the same set of enabled deploy interfaces on every ironic-conductor service.

default_deploy_interface

Type:

string

Default:

<None>

Default deploy interface to be used for nodes that do not have deploy_interface field set. A complete list of deploy interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.deploy” entrypoint.

enabled_firmware_interfaces

Type:

list

Default:

['no-firmware']

Specify the list of firmware interfaces to load during service initialization. Missing firmware interfaces, or firmware interfaces which fail to initialize, will prevent the ironic-conductor service from starting. At least one firmware interface that is supported by each enabled hardware type must be enabled here, or the ironic-conductor service will not start. Must not be an empty list. The default value is a recommended set of production-oriented firmware interfaces. A complete list of firmware interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.firmware” entrypoint. When setting this value, please make sure that every enabled hardware type will have the same set of enabled firmware interfaces on every ironic-conductor service.

default_firmware_interface

Type:

string

Default:

<None>

Default firmware interface to be used for nodes that do not have firmware_interface field set. A complete list of firmware interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.firmware” entrypoint.

enabled_inspect_interfaces

Type:

list

Default:

['no-inspect', 'redfish']

Specify the list of inspect interfaces to load during service initialization. Missing inspect interfaces, or inspect interfaces which fail to initialize, will prevent the ironic-conductor service from starting. At least one inspect interface that is supported by each enabled hardware type must be enabled here, or the ironic-conductor service will not start. Must not be an empty list. The default value is a recommended set of production-oriented inspect interfaces. A complete list of inspect interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.inspect” entrypoint. When setting this value, please make sure that every enabled hardware type will have the same set of enabled inspect interfaces on every ironic-conductor service.

default_inspect_interface

Type:

string

Default:

<None>

Default inspect interface to be used for nodes that do not have inspect_interface field set. A complete list of inspect interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.inspect” entrypoint.

enabled_management_interfaces

Type:

list

Default:

<None>

Specify the list of management interfaces to load during service initialization. Missing management interfaces, or management interfaces which fail to initialize, will prevent the ironic-conductor service from starting. At least one management interface that is supported by each enabled hardware type must be enabled here, or the ironic-conductor service will not start. Must not be an empty list. The default value is a recommended set of production-oriented management interfaces. A complete list of management interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.management” entrypoint. When setting this value, please make sure that every enabled hardware type will have the same set of enabled management interfaces on every ironic-conductor service.

default_management_interface

Type:

string

Default:

<None>

Default management interface to be used for nodes that do not have management_interface field set. A complete list of management interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.management” entrypoint.

enabled_network_interfaces

Type:

list

Default:

['flat', 'noop']

Specify the list of network interfaces to load during service initialization. Missing network interfaces, or network interfaces which fail to initialize, will prevent the ironic-conductor service from starting. At least one network interface that is supported by each enabled hardware type must be enabled here, or the ironic-conductor service will not start. Must not be an empty list. The default value is a recommended set of production-oriented network interfaces. A complete list of network interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.network” entrypoint. When setting this value, please make sure that every enabled hardware type will have the same set of enabled network interfaces on every ironic-conductor service.

default_network_interface

Type:

string

Default:

<None>

Default network interface to be used for nodes that do not have network_interface field set. A complete list of network interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.network” entrypoint.

enabled_power_interfaces

Type:

list

Default:

<None>

Specify the list of power interfaces to load during service initialization. Missing power interfaces, or power interfaces which fail to initialize, will prevent the ironic-conductor service from starting. At least one power interface that is supported by each enabled hardware type must be enabled here, or the ironic-conductor service will not start. Must not be an empty list. The default value is a recommended set of production-oriented power interfaces. A complete list of power interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.power” entrypoint. When setting this value, please make sure that every enabled hardware type will have the same set of enabled power interfaces on every ironic-conductor service.

default_power_interface

Type:

string

Default:

<None>

Default power interface to be used for nodes that do not have power_interface field set. A complete list of power interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.power” entrypoint.

enabled_raid_interfaces

Type:

list

Default:

['agent', 'no-raid', 'redfish']

Specify the list of raid interfaces to load during service initialization. Missing raid interfaces, or raid interfaces which fail to initialize, will prevent the ironic-conductor service from starting. At least one raid interface that is supported by each enabled hardware type must be enabled here, or the ironic-conductor service will not start. Must not be an empty list. The default value is a recommended set of production-oriented raid interfaces. A complete list of raid interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.raid” entrypoint. When setting this value, please make sure that every enabled hardware type will have the same set of enabled raid interfaces on every ironic-conductor service.

default_raid_interface

Type:

string

Default:

<None>

Default raid interface to be used for nodes that do not have raid_interface field set. A complete list of raid interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.raid” entrypoint.

enabled_rescue_interfaces

Type:

list

Default:

['no-rescue']

Specify the list of rescue interfaces to load during service initialization. Missing rescue interfaces, or rescue interfaces which fail to initialize, will prevent the ironic-conductor service from starting. At least one rescue interface that is supported by each enabled hardware type must be enabled here, or the ironic-conductor service will not start. Must not be an empty list. The default value is a recommended set of production-oriented rescue interfaces. A complete list of rescue interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.rescue” entrypoint. When setting this value, please make sure that every enabled hardware type will have the same set of enabled rescue interfaces on every ironic-conductor service.

default_rescue_interface

Type:

string

Default:

<None>

Default rescue interface to be used for nodes that do not have rescue_interface field set. A complete list of rescue interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.rescue” entrypoint.

enabled_storage_interfaces

Type:

list

Default:

['cinder', 'noop']

Specify the list of storage interfaces to load during service initialization. Missing storage interfaces, or storage interfaces which fail to initialize, will prevent the ironic-conductor service from starting. At least one storage interface that is supported by each enabled hardware type must be enabled here, or the ironic-conductor service will not start. Must not be an empty list. The default value is a recommended set of production-oriented storage interfaces. A complete list of storage interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.storage” entrypoint. When setting this value, please make sure that every enabled hardware type will have the same set of enabled storage interfaces on every ironic-conductor service.

default_storage_interface

Type:

string

Default:

noop

Default storage interface to be used for nodes that do not have storage_interface field set. A complete list of storage interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.storage” entrypoint.

enabled_vendor_interfaces

Type:

list

Default:

['ipmitool', 'redfish', 'no-vendor']

Specify the list of vendor interfaces to load during service initialization. Missing vendor interfaces, or vendor interfaces which fail to initialize, will prevent the ironic-conductor service from starting. At least one vendor interface that is supported by each enabled hardware type must be enabled here, or the ironic-conductor service will not start. Must not be an empty list. The default value is a recommended set of production-oriented vendor interfaces. A complete list of vendor interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.vendor” entrypoint. When setting this value, please make sure that every enabled hardware type will have the same set of enabled vendor interfaces on every ironic-conductor service.

default_vendor_interface

Type:

string

Default:

<None>

Default vendor interface to be used for nodes that do not have vendor_interface field set. A complete list of vendor interfaces present on your system may be found by enumerating the “ironic.hardware.interfaces.vendor” entrypoint.

log_in_db_max_size

Type:

integer

Default:

4096

Max number of characters of any node last_error/maintenance_reason pushed to database.

hash_partition_exponent

Type:

integer

Default:

5

Exponent to determine number of hash partitions to use when distributing load across conductors. Larger values will result in more even distribution of load and less load when rebalancing the ring, but more memory usage. Number of partitions per conductor is (2^hash_partition_exponent). This determines the granularity of rebalancing: given 10 hosts, and an exponent of the 2, there are 40 partitions in the ring.A few thousand partitions should make rebalancing smooth in most cases. The default is suitable for up to a few hundred conductors. Configuring for too many partitions has a negative impact on CPU usage.

hash_ring_reset_interval

Type:

integer

Default:

15

Time (in seconds) after which the hash ring is considered outdated and is refreshed on the next access.

hash_ring_algorithm

Type:

string

Default:

md5

Valid Values:

sha224, blake2b, sha512, sha1, shake_128, md5, sha3_384, blake2s, shake_256, sha3_256, sha3_224, sha3_512, sha384, sha256

Advanced Option:

Intended for advanced users and not used by the majority of users, and might have a significant effect on stability and/or performance.

Hash function to use when building the hash ring. If running on a FIPS system, do not use md5. WARNING: all ironic services in a cluster MUST use the same algorithm at all times. Changing the algorithm requires an offline update.

force_raw_images

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

If True, convert backing images to “raw” disk image format.

raw_image_growth_factor

Type:

floating point

Default:

2.0

Minimum Value:

1.0

The scale factor used for estimating the size of a raw image converted from compact image formats such as QCOW2. Default is 2.0, must be greater than 1.0.

isolinux_bin

Type:

string

Default:

/usr/lib/syslinux/isolinux.bin

Path to isolinux binary file.

isolinux_config_template

Type:

string

Default:

$pybasedir/common/isolinux_config.template

Template file for isolinux configuration file.

grub_config_path

Type:

string

Default:

EFI/BOOT/grub.cfg

GRUB2 configuration file location on the UEFI ISO images produced by ironic. The default value is usually incorrect and should not be relied on. If you use a GRUB2 image from a certain distribution, use a distribution-specific path here, e.g. EFI/ubuntu/grub.cfg

grub_config_template

Type:

string

Default:

$pybasedir/common/grub_conf.template

Template file for grub configuration file.

ldlinux_c32

Type:

string

Default:

<None>

Path to ldlinux.c32 file. This file is required for syslinux 5.0 or later. If not specified, the file is looked for in “/usr/lib/syslinux/modules/bios/ldlinux.c32” and “/usr/share/syslinux/ldlinux.c32”.

esp_image

Type:

string

Default:

<None>

Path to EFI System Partition image file. This file is recommended for creating UEFI bootable ISO images efficiently. ESP image should contain a FAT12/16/32-formatted file system holding EFI boot loaders (e.g. GRUB2) for each hardware architecture ironic needs to boot. This option is only used when neither ESP nor ISO deploy image is configured to the node being deployed in which case ironic will attempt to fetch ESP image from the configured location or extract ESP image from UEFI-bootable deploy ISO image.

parallel_image_downloads

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Run image downloads and raw format conversions in parallel.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

Use image_download_concurrency

image_download_concurrency

Type:

integer

Default:

20

Minimum Value:

1

How many image downloads and raw format conversions to run in parallel. Only affects image caches.

my_ip

Type:

string

Default:

127.0.0.1

This option has a sample default set, which means that its actual default value may vary from the one documented above.

IPv4 address of this host. If unset, will determine the IP programmatically. If unable to do so, will use “127.0.0.1”. NOTE: This field does accept an IPv6 address as an override for templates and URLs, however it is recommended that [DEFAULT]my_ipv6 is used along with DNS names for service URLs for dual-stack environments.

my_ipv6

Type:

string

Default:

2001:db8::1

This option has a sample default set, which means that its actual default value may vary from the one documented above.

IP address of this host using IPv6. This value must be supplied via the configuration and cannot be adequately programmatically determined like the [DEFAULT]my_ip parameter for IPv4.

notification_level

Type:

string

Default:

<None>

Valid Values:

debug, info, warning, error, critical

Specifies the minimum level for which to send notifications. If not set, no notifications will be sent. The default is for this option to be unset.

Possible values

debug

“debug” level

info

“info” level

warning

“warning” level

error

“error” level

critical

“critical” level

versioned_notifications_topics

Type:

list

Default:

['ironic_versioned_notifications']

Specifies the topics for the versioned notifications issued by Ironic.

The default value is fine for most deployments and rarely needs to be changed. However, if you have a third-party service that consumes versioned notifications, it might be worth getting a topic for that service. Ironic will send a message containing a versioned notification payload to each topic queue in this list.

The list of versioned notifications is visible in https://docs.openstack.org/ironic/latest/admin/notifications.html

pybasedir

Type:

string

Default:

/usr/lib/python/site-packages/ironic/ironic

This option has a sample default set, which means that its actual default value may vary from the one documented above.

Directory where the ironic python module is installed.

bindir

Type:

string

Default:

$pybasedir/bin

Directory where ironic binaries are installed.

state_path

Type:

string

Default:

$pybasedir

Top-level directory for maintaining ironic’s state.

default_portgroup_mode

Type:

string

Default:

active-backup

Mutable:

This option can be changed without restarting.

Default mode for portgroups. Allowed values can be found in the linux kernel documentation on bonding: https://www.kernel.org/doc/Documentation/networking/bonding.txt.

host

Type:

string

Default:

localhost

This option has a sample default set, which means that its actual default value may vary from the one documented above.

Name of this node. This can be an opaque identifier. It is not necessarily a hostname, FQDN, or IP address. However, the node name must be valid within an AMQP key.

pin_release_version

Type:

string

Default:

<None>

Valid Values:

zed, yoga, antelope, 9.2, 26.1, 26.0, 25.0, 24.1, 24.0, 23.1, 23.0, 22.1, 22.0, 21.4, 21.3, 21.2, 21.1, 21.0, 2024.2, 2024.1, 2023.2, 2023.1, 20.2, 20.1, 20.0, 19.0, 18.2, 18.1, 18.0, 17.0, 16.2, 16.1, 16.0, 15.1, 15.0, 14.0, 13.0, 12.2, 12.1, 12.0, 11.1, 11.0, 10.1, 10.0

Mutable:

This option can be changed without restarting.

Used for rolling upgrades. Setting this option downgrades (or pins) the Bare Metal API, the internal ironic RPC communication, and the database objects to their respective versions, so they are compatible with older services. When doing a rolling upgrade from version N to version N+1, set (to pin) this to N. To unpin (default), leave it unset and the latest versions will be used.

Possible values

zed

“zed” release

yoga

“yoga” release

antelope

“antelope” release

9.2

“9.2” release

26.1

“26.1” release

26.0

“26.0” release

25.0

“25.0” release

24.1

“24.1” release

24.0

“24.0” release

23.1

“23.1” release

23.0

“23.0” release

22.1

“22.1” release

22.0

“22.0” release

21.4

“21.4” release

21.3

“21.3” release

21.2

“21.2” release

21.1

“21.1” release

21.0

“21.0” release

2024.2

“2024.2” release

2024.1

“2024.1” release

2023.2

“2023.2” release

2023.1

“2023.1” release

20.2

“20.2” release

20.1

“20.1” release

20.0

“20.0” release

19.0

“19.0” release

18.2

“18.2” release

18.1

“18.1” release

18.0

“18.0” release

17.0

“17.0” release

16.2

“16.2” release

16.1

“16.1” release

16.0

“16.0” release

15.1

“15.1” release

15.0

“15.0” release

14.0

“14.0” release

13.0

“13.0” release

12.2

“12.2” release

12.1

“12.1” release

12.0

“12.0” release

11.1

“11.1” release

11.0

“11.0” release

10.1

“10.1” release

10.0

“10.0” release

rpc_transport

Type:

string

Default:

oslo

Valid Values:

oslo, json-rpc, none

Which RPC transport implementation to use between conductor and API services

Possible values

oslo

use oslo.messaging transport

json-rpc

use JSON RPC transport

none

No RPC, only use local conductor

minimum_memory_warning_only

Type:

boolean

Default:

False

Mutable:

This option can be changed without restarting.

Setting to govern if Ironic should only warn instead of attempting to hold back the request in order to prevent the exhaustion of system memory.

minimum_required_memory

Type:

integer

Default:

1024

Mutable:

This option can be changed without restarting.

Minimum memory in MiB for the system to have available prior to starting a memory intensive process on the conductor.

minimum_memory_wait_time

Type:

integer

Default:

15

Mutable:

This option can be changed without restarting.

Seconds to wait between retries for free memory before launching the process. This, combined with memory_wait_retries allows the conductor to determine how long we should attempt to directly retry.

minimum_memory_wait_retries

Type:

integer

Default:

6

Mutable:

This option can be changed without restarting.

Number of retries to hold onto the worker before failing or returning the thread to the pool if the conductor can automatically retry.

drain_shutdown_timeout

Type:

integer

Default:

1800

Mutable:

This option can be changed without restarting.

Timeout (seconds) after which a server will exit from a drain shutdown. Drain shutdowns are triggered by sending the signal SIGUSR2. Zero value means shutdown will never be triggered by a timeout.

tempdir

Type:

string

Default:

/tmp

This option has a sample default set, which means that its actual default value may vary from the one documented above.

Temporary working directory, default is Python temp dir.

webserver_verify_ca

Type:

string

Default:

True

Mutable:

This option can be changed without restarting.

CA certificates to be used for certificate verification. This can be either a Boolean value or a path to a CA_BUNDLE file.If set to True, the certificates present in the standard path are used to verify the host certificates.If set to False, the conductor will ignore verifying the SSL certificate presented by the host.If it”s a path, conductor uses the specified certificate for SSL verification. If the path does not exist, the behavior is same as when this value is set to True i.e the certificates present in the standard path are used for SSL verification.Defaults to True.

webserver_connection_timeout

Type:

integer

Default:

60

Connection timeout when accessing/interacting with remote web servers with images or other artifacts being accessed. An excessive value here is not advisable as excessive requests to an unreachable endpoint can result in Ironic service resources being consumed waiting for the connection to timeout.

rbac_service_role_elevated_access

Type:

boolean

Default:

False

Enable elevated access for users with service role belonging to the ‘rbac_service_project_name’ project when using default policy. The default setting of disabled causes all service role requests to be scoped to the project the service account belongs to.

rbac_service_project_name

Type:

string

Default:

service

The project name utilized for Role Based Access Control checks for the reserved service project. This project is utilized for services to have accounts for cross-service communication. Often these accounts require higher levels of access, and effectively this permits accounts from the service to not be restricted to project scoping of responses. i.e. The service project user with a service role will be able to see nodes across all projects, similar to System scoped access. If not set to a value, and all service role access will be filtered matching an owner or lessee, if applicable. If an operator wishes to make behavior visible for all service role users across all projects, then a custom policy must be used to override the default “service_role” rule. It should be noted that the value of “service” is a default convention for OpenStack deployments, but the requisite access and details around end configuration are largely up to an operator if they are doing an OpenStack deployment manually.

run_external_periodic_tasks

Type:

boolean

Default:

True

Some periodic tasks can be run in a separate process. Should we run them here?

backdoor_port

Type:

string

Default:

<None>

Enable eventlet backdoor. Acceptable values are 0, <port>, and <start>:<end>, where 0 results in listening on a random tcp port number; <port> results in listening on the specified port number (and not enabling backdoor if that port is in use); and <start>:<end> results in listening on the smallest unused port number within the specified range of port numbers. The chosen port is displayed in the service’s log file.

backdoor_socket

Type:

string

Default:

<None>

Enable eventlet backdoor, using the provided path as a unix socket that can receive connections. This option is mutually exclusive with ‘backdoor_port’ in that only one should be provided. If both are provided then the existence of this option overrides the usage of that option. Inside the path {pid} will be replaced with the PID of the current process.

log_options

Type:

boolean

Default:

True

Enables or disables logging values of all registered options when starting a service (at DEBUG level).

graceful_shutdown_timeout

Type:

integer

Default:

60

Specify a timeout after which a gracefully shutdown server will exit. Zero value means endless wait.

agent

manage_agent_boot

Type:

boolean

Default:

True

Whether Ironic will manage booting of the agent ramdisk. If set to False, you will need to configure your mechanism to allow booting the agent ramdisk. Deprecated for removal in 2025.2 release.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

memory_consumed_by_agent

Type:

integer

Default:

0

Mutable:

This option can be changed without restarting.

The memory size in MiB consumed by agent when it is booted on a bare metal node. This is used for checking if the image can be downloaded and deployed on the bare metal node after booting agent ramdisk. This may be set according to the memory consumed by the agent ramdisk image.

stream_raw_images

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Whether the agent ramdisk should stream raw images directly onto the disk or not. By streaming raw images directly onto the disk the agent ramdisk will not spend time copying the image to a tmpfs partition (therefore consuming less memory) prior to writing it to the disk. Unless the disk where the image will be copied to is really slow, this option should be set to True. Defaults to True.

post_deploy_get_power_state_retries

Type:

integer

Default:

6

Number of times to retry getting power state to check if bare metal node has been powered off after a soft power off.

post_deploy_get_power_state_retry_interval

Type:

integer

Default:

5

Amount of time (in seconds) to wait between polling power state after trigger soft poweroff.

agent_api_version

Type:

string

Default:

v1

API version to use for communicating with the ramdisk agent.

deploy_logs_collect

Type:

string

Default:

on_failure

Valid Values:

always, on_failure, never

Mutable:

This option can be changed without restarting.

Whether Ironic should collect the deployment logs on deployment failure (on_failure), always or never.

Possible values

always

always collect the logs

on_failure

only collect logs if there is a failure

never

never collect logs

deploy_logs_storage_backend

Type:

string

Default:

local

Valid Values:

local, swift

Mutable:

This option can be changed without restarting.

The name of the storage backend where the logs will be stored.

Possible values

local

store the logs locally

swift

store the logs in Object Storage service

deploy_logs_local_path

Type:

string

Default:

/var/log/ironic/deploy

Mutable:

This option can be changed without restarting.

The path to the directory where the logs should be stored, used when the deploy_logs_storage_backend is configured to “local”.

deploy_logs_swift_container

Type:

string

Default:

ironic_deploy_logs_container

Mutable:

This option can be changed without restarting.

The name of the Swift container to store the logs, used when the deploy_logs_storage_backend is configured to “swift”.

deploy_logs_swift_days_to_expire

Type:

integer

Default:

30

Mutable:

This option can be changed without restarting.

Number of days before a log object is marked as expired in Swift. If None, the logs will be kept forever or until manually deleted. Used when the deploy_logs_storage_backend is configured to “swift”.

image_download_source

Type:

string

Default:

http

Valid Values:

swift, http, local

Mutable:

This option can be changed without restarting.

Specifies whether direct deploy interface should try to use the image source directly or if ironic should cache the image on the conductor and serve it from ironic’s own http server.

Possible values

swift

IPA ramdisk retrieves instance image from the Object Storage service.

http

IPA ramdisk retrieves instance image from HTTP service served at conductor nodes.

local

Same as “http”, but HTTP images are also cached locally, converted and served from the conductor

command_timeout

Type:

integer

Default:

60

Mutable:

This option can be changed without restarting.

Timeout (in seconds) for IPA commands. A large timeout value may result in the conductor free worker pool becoming exhausted should a multi-node network connectivity issue arise during inband operations. These commands also cause the individual node lock to be held while in progress, which prevents new requests from being acted upon for the impacted nodes until the issue has been resolved.

max_command_attempts

Type:

integer

Default:

3

This is the maximum number of attempts that will be done for IPA commands that fails due to network problems.

command_wait_attempts

Type:

integer

Default:

100

Number of attempts to check for asynchronous commands completion before timing out.

command_wait_interval

Type:

integer

Default:

6

Number of seconds to wait for between checks for asynchronous commands completion.

neutron_agent_poll_interval

Type:

integer

Default:

2

Mutable:

This option can be changed without restarting.

The number of seconds Neutron agent will wait between polling for device changes. This value should be the same as CONF.AGENT.polling_interval in Neutron configuration.

neutron_agent_max_attempts

Type:

integer

Default:

100

Max number of attempts to validate a Neutron agent status before raising network error for a dead agent.

neutron_agent_status_retry_interval

Type:

integer

Default:

10

Wait time in seconds between attempts for validating Neutron agent status.

require_tls

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

If set to False, callback URLs without https:// will be permitted by the conductor, which may be needed for backwards compatibility outside of the supported version window.

certificates_path

Type:

string

Default:

/var/lib/ironic/certificates

Path to store auto-generated TLS certificates used to validate connections to the ramdisk.

verify_ca

Type:

string

Default:

True

Path to the TLS CA to validate connection to the ramdisk. Set to True to use the system default CA storage. Set to False to disable validation. Ignored when automatic TLS setup is used.

api_ca_file

Type:

string

Default:

<None>

Path to the TLS CA that is used to start the bare metal API. In some boot methods this file can be passed to the ramdisk.

allow_md5_checksum

Type:

boolean

Default:

True

When enabled, the agent will be notified it is permitted to consider MD5 checksums. This option is expected to change to a default of False in a 2024 release of Ironic.

anaconda

default_ks_template

Type:

string

Default:

$pybasedir/drivers/modules/ks.cfg.template

Mutable:

This option can be changed without restarting.

kickstart template to use when no kickstart template is specified in the instance_info or the glance OS image.

insecure_heartbeat

Type:

boolean

Default:

False

Mutable:

This option can be changed without restarting.

Option to allow the kickstart configuration to be informed if SSL/TLS certificate verification should be enforced, or not. This option exists largely to facilitate easy testing and use of the anaconda deployment interface. When this option is set, heartbeat operations, depending on the contents of the utilized kickstart template, may not enforce TLS certificate verification.

ansible

ansible_extra_args

Type:

string

Default:

<None>

Extra arguments to pass on every invocation of Ansible.

verbosity

Type:

integer

Default:

<None>

Minimum Value:

0

Maximum Value:

4

Set ansible verbosity level requested when invoking “ansible-playbook” command. 4 includes detailed SSH session logging. Default is 4 when global debug is enabled and 0 otherwise.

ansible_playbook_script

Type:

string

Default:

ansible-playbook

Path to “ansible-playbook” script. Default will search the $PATH configured for user running ironic-conductor process. Provide the full path when ansible-playbook is not in $PATH or installed in not default location.

playbooks_path

Type:

string

Default:

$pybasedir/drivers/modules/ansible/playbooks

Path to directory with playbooks, roles and local inventory.

config_file_path

Type:

string

Default:

$pybasedir/drivers/modules/ansible/playbooks/ansible.cfg

Path to ansible configuration file. If set to empty, system default will be used.

post_deploy_get_power_state_retries

Type:

integer

Default:

6

Minimum Value:

0

Number of times to retry getting power state to check if bare metal node has been powered off after a soft power off. Value of 0 means do not retry on failure.

post_deploy_get_power_state_retry_interval

Type:

integer

Default:

5

Minimum Value:

0

Amount of time (in seconds) to wait between polling power state after trigger soft poweroff.

extra_memory

Type:

integer

Default:

10

Extra amount of memory in MiB expected to be consumed by Ansible-related processes on the node. Affects decision whether image will fit into RAM.

image_store_insecure

Type:

boolean

Default:

False

Skip verifying SSL connections to the image store when downloading the image. Setting it to “True” is only recommended for testing environments that use self-signed certificates.

image_store_cafile

Type:

string

Default:

<None>

Specific CA bundle to use for validating SSL connections to the image store. If not specified, CA available in the ramdisk will be used. Is not used by default playbooks included with the driver. Suitable for environments that use self-signed certificates.

image_store_certfile

Type:

string

Default:

<None>

Client cert to use for SSL connections to image store. Is not used by default playbooks included with the driver.

image_store_keyfile

Type:

string

Default:

<None>

Client key to use for SSL connections to image store. Is not used by default playbooks included with the driver.

default_username

Type:

string

Default:

ansible

Name of the user to use for Ansible when connecting to the ramdisk over SSH. It may be overridden by per-node ‘ansible_username’ option in node’s ‘driver_info’ field.

default_key_file

Type:

string

Default:

<None>

Absolute path to the private SSH key file to use by Ansible by default when connecting to the ramdisk over SSH. Default is to use default SSH keys configured for the user running the ironic-conductor service. Private keys with password must be pre-loaded into ‘ssh-agent’. It may be overridden by per-node ‘ansible_key_file’ option in node’s ‘driver_info’ field.

default_deploy_playbook

Type:

string

Default:

deploy.yaml

Path (relative to $playbooks_path or absolute) to the default playbook used for deployment. It may be overridden by per-node ‘ansible_deploy_playbook’ option in node’s ‘driver_info’ field.

default_shutdown_playbook

Type:

string

Default:

shutdown.yaml

Path (relative to $playbooks_path or absolute) to the default playbook used for graceful in-band shutdown of the node. It may be overridden by per-node ‘ansible_shutdown_playbook’ option in node’s ‘driver_info’ field.

default_clean_playbook

Type:

string

Default:

clean.yaml

Path (relative to $playbooks_path or absolute) to the default playbook used for node cleaning. It may be overridden by per-node ‘ansible_clean_playbook’ option in node’s ‘driver_info’ field.

default_clean_steps_config

Type:

string

Default:

clean_steps.yaml

Path (relative to $playbooks_path or absolute) to the default auxiliary cleaning steps file used during the node cleaning. It may be overridden by per-node ‘ansible_clean_steps_config’ option in node’s ‘driver_info’ field.

default_python_interpreter

Type:

string

Default:

<None>

Absolute path to the python interpreter on the managed machines. It may be overridden by per-node ‘ansible_python_interpreter’ option in node’s ‘driver_info’ field. By default, ansible uses /usr/bin/python

api

host_ip

Type:

host address

Default:

0.0.0.0

The IP address or hostname on which ironic-api listens.

port

Type:

port number

Default:

6385

Minimum Value:

0

Maximum Value:

65535

The TCP port on which ironic-api listens.

unix_socket

Type:

string

Default:

<None>

Unix socket to listen on. Disables host_ip and port.

unix_socket_mode

Type:

unknown type

Default:

<None>

File mode (an octal number) of the unix socket to listen on. Ignored if unix_socket is not set.

max_limit

Type:

integer

Default:

1000

Mutable:

This option can be changed without restarting.

The maximum number of items returned in a single response from a collection resource.

public_endpoint

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

Public URL to use when building the links to the API resources (for example, “https://ironic.rocks:6384”). If None the links will be built using the request’s host URL. If the API is operating behind a proxy, you will want to change this to represent the proxy’s URL. Defaults to None. Ignored when proxy headers parsing is enabled via [oslo_middleware]enable_proxy_headers_parsing option.

api_workers

Type:

integer

Default:

<None>

Number of workers for OpenStack Ironic API service. The default is equal to the number of CPUs available, but not more than 4. One worker is used if the CPU number cannot be detected.

enable_ssl_api

Type:

boolean

Default:

False

Enable the integrated stand-alone API to service requests via HTTPS instead of HTTP. If there is a front-end service performing HTTPS offloading from the service, this option should be False; note, you will want to enable proxy headers parsing with [oslo_middleware]enable_proxy_headers_parsing option or configure [api]public_endpoint option to set URLs in responses to the SSL terminated one.

restrict_lookup

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Whether to restrict the lookup API to only nodes in certain states. Setting this to False can be insecure and is not advisable.

ramdisk_heartbeat_timeout

Type:

integer

Default:

300

Mutable:

This option can be changed without restarting.

Maximum interval (in seconds) for agent heartbeats.

network_data_schema

Type:

string

Default:

$pybasedir/api/controllers/v1/network-data-schema.json

Schema for network data used by this deployment.

project_admin_can_manage_own_nodes

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

If a project scoped administrative user is permitted to create/delete baremetal nodes in their project.

disallowed_enrollment_boot_modes

Type:

list

Default:

[]

Mutable:

This option can be changed without restarting.

Specifies a list of boot modes that are not allowed during enrollment. Eg: [‘bios’]

audit

enabled

Type:

boolean

Default:

False

Enable auditing of API requests (for ironic-api service).

audit_map_file

Type:

string

Default:

/etc/ironic/api_audit_map.conf

Path to audit map file for ironic-api service. Used only when API audit is enabled.

ignore_req_list

Type:

string

Default:

''

Comma separated list of Ironic REST API HTTP methods to be ignored during audit logging. For example: auditing will not be done on any GET or POST requests if this is set to “GET,POST”. It is used only when API audit is enabled.

audit_middleware_notifications

use_oslo_messaging

Type:

boolean

Default:

True

Indicate whether to use oslo_messaging as the notifier. If set to False, the local logger will be used as the notifier. If set to True, the oslo_messaging package must also be present. Otherwise, the local will be used instead.

driver

Type:

string

Default:

<None>

The Driver to handle sending notifications. Possible values are messaging, messagingv2, routing, log, test, noop. If not specified, then value from oslo_messaging_notifications conf section is used.

topics

Type:

list

Default:

<None>

List of AMQP topics used for OpenStack notifications. If not specified, then value from oslo_messaging_notifications conf section is used.

transport_url

Type:

string

Default:

<None>

A URL representing messaging driver to use for notification. If not specified, we fall back to the same configuration used for RPC.

cinder

action_retries

Type:

integer

Default:

3

Number of retries in the case of a failed action (currently only used when detaching volumes).

action_retry_interval

Type:

integer

Default:

5

Retry interval in seconds in the case of a failed action (only specific actions are retried).

auth_url

Type:

unknown type

Default:

<None>

Authentication URL

auth_type

Type:

unknown type

Default:

<None>

Authentication type to load

Deprecated Variations

Group	Name
cinder	auth_plugin

cafile

Type:

string

Default:

<None>

PEM encoded Certificate Authority to use when verifying HTTPs connections.

certfile

Type:

string

Default:

<None>

PEM encoded client certificate cert file

collect_timing

Type:

boolean

Default:

False

Collect per-API call timing information.

connect_retries

Type:

integer

Default:

<None>

The maximum number of retries that should be attempted for connection errors.

connect_retry_delay

Type:

floating point

Default:

<None>

Delay (in seconds) between two retries for connection errors. If not set, exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is used.

default_domain_id

Type:

unknown type

Default:

<None>

Optional domain ID to use with v3 and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

default_domain_name

Type:

unknown type

Default:

<None>

Optional domain name to use with v3 API and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

domain_id

Type:

unknown type

Default:

<None>

Domain ID to scope to

domain_name

Type:

unknown type

Default:

<None>

Domain name to scope to

endpoint_override

Type:

string

Default:

<None>

Always use this endpoint URL for requests for this client. NOTE: The unversioned endpoint should be specified here; to request a particular API version, use the version, min-version, and/or max-version options.

insecure

Type:

boolean

Default:

False

Verify HTTPS connections.

keyfile

Type:

string

Default:

<None>

PEM encoded client certificate key file

max_version

Type:

string

Default:

<None>

The maximum major version of a given API, intended to be used as the upper bound of a range with min_version. Mutually exclusive with version.

min_version

Type:

string

Default:

<None>

The minimum major version of a given API, intended to be used as the lower bound of a range with max_version. Mutually exclusive with version. If min_version is given with no max_version it is as if max version is “latest”.

password

Type:

unknown type

Default:

<None>

User’s password

project_domain_id

Type:

unknown type

Default:

<None>

Domain ID containing project

project_domain_name

Type:

unknown type

Default:

<None>

Domain name containing project

project_id

Type:

unknown type

Default:

<None>

Project ID to scope to

Deprecated Variations

Group	Name
cinder	tenant-id
cinder	tenant_id

project_name

Type:

unknown type

Default:

<None>

Project name to scope to

Deprecated Variations

Group	Name
cinder	tenant-name
cinder	tenant_name

region_name

Type:

string

Default:

<None>

The default region_name for endpoint URL discovery.

retriable_status_codes

Type:

list

Default:

<None>

List of retriable HTTP status codes that should be retried. If not set default to [503]

retries

Type:

integer

Default:

3

DEPRECATED: Client retries in the case of a failed request.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

Replaced by status_code_retries and status_code_retry_delay.

service_name

Type:

string

Default:

<None>

The default service_name for endpoint URL discovery.

service_type

Type:

string

Default:

volumev3

The default service_type for endpoint URL discovery.

split_loggers

Type:

boolean

Default:

False

Log requests to multiple loggers.

status_code_retries

Type:

integer

Default:

<None>

The maximum number of retries that should be attempted for retriable HTTP status codes.

status_code_retry_delay

Type:

floating point

Default:

<None>

Delay (in seconds) between two retries for retriable status codes. If not set, exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is used.

system_scope

Type:

unknown type

Default:

<None>

Scope for system operations

tenant_id

Type:

unknown type

Default:

<None>

Tenant ID

tenant_name

Type:

unknown type

Default:

<None>

Tenant Name

timeout

Type:

integer

Default:

<None>

Timeout value for http requests

trust_id

Type:

unknown type

Default:

<None>

ID of the trust to use as a trustee use

user_domain_id

Type:

unknown type

Default:

<None>

User’s domain id

user_domain_name

Type:

unknown type

Default:

<None>

User’s domain name

user_id

Type:

unknown type

Default:

<None>

User id

username

Type:

unknown type

Default:

<None>

Username

Deprecated Variations

Group	Name
cinder	user-name
cinder	user_name

valid_interfaces

Type:

list

Default:

['internal', 'public']

List of interfaces, in order of preference, for endpoint URL.

version

Type:

string

Default:

<None>

Minimum Major API version within a given Major API version for endpoint URL discovery. Mutually exclusive with min_version and max_version

conductor

workers_pool_size

Type:

integer

Default:

300

Minimum Value:

3

The size of the workers greenthread pool. Note that 2 threads will be reserved by the conductor itself for handling heart beats and periodic tasks. On top of that, sync_power_state_workers will take up to 7 green threads with the default value of 8.

reserved_workers_pool_percentage

Type:

integer

Default:

5

Minimum Value:

0

Maximum Value:

50

The percentage of the whole workers pool that will be kept for API requests and other important tasks. This part of the pool will not be used for periodic tasks or agent heartbeats. Set to 0 to disable.

heartbeat_interval

Type:

integer

Default:

10

Seconds between conductor heart beats.

heartbeat_timeout

Type:

integer

Default:

60

Maximum Value:

315576000

Mutable:

This option can be changed without restarting.

Maximum time (in seconds) since the last check-in of a conductor. A conductor is considered inactive when this time has been exceeded.

sync_power_state_interval

Type:

integer

Default:

60

Interval between syncing the node power state to the database, in seconds. Set to 0 to disable syncing.

check_provision_state_interval

Type:

integer

Default:

60

Minimum Value:

0

Interval between checks of provision timeouts, in seconds. Set to 0 to disable checks.

check_rescue_state_interval

Type:

integer

Default:

60

Minimum Value:

1

Interval (seconds) between checks of rescue timeouts.

check_allocations_interval

Type:

integer

Default:

60

Minimum Value:

0

Interval between checks of orphaned allocations, in seconds. Set to 0 to disable checks.

cache_clean_up_interval

Type:

integer

Default:

3600

Minimum Value:

0

Interval between cleaning up image caches, in seconds. Set to 0 to disable periodic clean-up.

deploy_callback_timeout

Type:

integer

Default:

1800

Minimum Value:

0

Timeout (seconds) to wait for a callback from a deploy ramdisk. Set to 0 to disable timeout.

force_power_state_during_sync

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

During sync_power_state, should the hardware power state be set to the state recorded in the database (True) or should the database be updated based on the hardware state (False).

power_state_sync_max_retries

Type:

integer

Default:

3

During sync_power_state failures, limit the number of times Ironic should try syncing the hardware node power state with the node power state in DB

sync_power_state_workers

Type:

integer

Default:

8

Minimum Value:

1

The maximum number of worker threads that can be started simultaneously to sync nodes power states from the periodic task.

periodic_max_workers

Type:

integer

Default:

8

Maximum number of worker threads that can be started simultaneously by a periodic task. Should be less than RPC thread pool size.

node_locked_retry_attempts

Type:

integer

Default:

3

Number of attempts to grab a node lock.

node_locked_retry_interval

Type:

integer

Default:

1

Seconds to sleep between node lock attempts.

sync_local_state_interval

Type:

integer

Default:

180

When conductors join or leave the cluster, existing conductors may need to update any persistent local state as nodes are moved around the cluster. This option controls how often, in seconds, each conductor will check for nodes that it should “take over”. Set it to 0 (or a negative value) to disable the check entirely.

configdrive_swift_container

Type:

string

Default:

ironic_configdrive_container

Name of the Swift container to store config drive data. Used when configdrive_use_object_store is True.

configdrive_swift_temp_url_duration

Type:

integer

Default:

<None>

Minimum Value:

60

The timeout (in seconds) after which a configdrive temporary URL becomes invalid. Defaults to deploy_callback_timeout if it is set, otherwise to 1800 seconds. Used when configdrive_use_object_store is True.

inspect_wait_timeout

Type:

integer

Default:

1800

Minimum Value:

0

Timeout (seconds) for waiting for node inspection. 0 - unlimited.

automated_clean

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Enables or disables automated cleaning. Automated cleaning is a configurable set of steps, such as erasing disk drives, that are performed on the node to ensure it is in a baseline state and ready to be deployed to. This is done after instance deletion as well as during the transition from a “manageable” to “available” state. When enabled, the particular steps performed to clean a node depend on which driver that node is managed by; see the individual driver’s documentation for details. NOTE: The introduction of the cleaning operation causes instance deletion to take significantly longer. In an environment where all tenants are trusted (eg, because there is only one tenant), this option could be safely disabled.

allow_provisioning_in_maintenance

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Whether to allow nodes to enter or undergo deploy or cleaning when in maintenance mode. If this option is set to False, and a node enters maintenance during deploy or cleaning, the process will be aborted after the next heartbeat. Automated cleaning or making a node available will also fail. If True (the default), the process will begin and will pause after the node starts heartbeating. Moving it from maintenance will make the process continue.

clean_callback_timeout

Type:

integer

Default:

1800

Minimum Value:

0

Timeout (seconds) to wait for a callback from the ramdisk doing the cleaning. If the timeout is reached the node will be put in the “clean failed” provision state. Set to 0 to disable timeout.

service_callback_timeout

Type:

integer

Default:

1800

Minimum Value:

0

Timeout (seconds) to wait for a callback from the ramdisk doing the servicing. If the timeout is reached the node will be put in the “service failed” provision state. Set to 0 to disable timeout.

rescue_callback_timeout

Type:

integer

Default:

1800

Minimum Value:

0

Timeout (seconds) to wait for a callback from the rescue ramdisk. If the timeout is reached the node will be put in the “rescue failed” provision state. Set to 0 to disable timeout.

soft_power_off_timeout

Type:

integer

Default:

600

Minimum Value:

1

Mutable:

This option can be changed without restarting.

Timeout (in seconds) of soft reboot and soft power off operation. This value always has to be positive.

power_state_change_timeout

Type:

integer

Default:

60

Minimum Value:

2

Mutable:

This option can be changed without restarting.

Number of seconds to wait for power operations to complete, i.e., so that a baremetal node is in the desired power state. If timed out, the power operation is considered a failure.

power_failure_recovery_interval

Type:

integer

Default:

300

Minimum Value:

0

Interval (in seconds) between checking the power state for nodes previously put into maintenance mode due to power synchronization failure. A node is automatically moved out of maintenance mode once its power state is retrieved successfully. Set to 0 to disable this check.

conductor_group

Type:

string

Default:

''

Name of the conductor group to join. Can be up to 255 characters and is case insensitive. This conductor will only manage nodes with a matching “conductor_group” field set on the node.

allow_deleting_available_nodes

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Allow deleting nodes which are in state ‘available’. Defaults to True.

enable_mdns

Type:

boolean

Default:

False

Whether to enable publishing the baremetal API endpoint via multicast DNS.

deploy_kernel

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

Glance ID, http:// or file:// URL of the kernel of the default deploy image.

deploy_ramdisk

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

Glance ID, http:// or file:// URL of the initramfs of the default deploy image.

deploy_kernel_by_arch

Type:

dict

Default:

{}

Mutable:

This option can be changed without restarting.

A dictionary of key-value pairs of each architecture with the Glance ID, http:// or file:// URL of the kernel of the default deploy image.

deploy_ramdisk_by_arch

Type:

dict

Default:

{}

Mutable:

This option can be changed without restarting.

A dictionary of key-value pairs of each architecture with the Glance ID, http:// or file:// URL of the initramfs of the default deploy image.

rescue_kernel

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

Glance ID, http:// or file:// URL of the kernel of the default rescue image.

rescue_ramdisk

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

Glance ID, http:// or file:// URL of the initramfs of the default rescue image.

rescue_kernel_by_arch

Type:

dict

Default:

{}

Mutable:

This option can be changed without restarting.

A dictionary of key-value pairs of each architecture with the Glance ID, http:// or file:// URL of the kernel of the default rescue image.

rescue_ramdisk_by_arch

Type:

dict

Default:

{}

Mutable:

This option can be changed without restarting.

A dictionary of key-value pairs of each architecture with the Glance ID, http:// or file:// URL of the initramfs of the default rescue image.

rescue_password_hash_algorithm

Type:

string

Default:

sha256

Valid Values:

sha256, sha512

Mutable:

This option can be changed without restarting.

Password hash algorithm to be used for the rescue password.

require_rescue_password_hashed

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Option to cause the conductor to not fallback to an un-hashed version of the rescue password, permitting rescue with older ironic-python-agent ramdisks.

bootloader

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

Glance ID, http:// or file:// URL of the EFI system partition image containing EFI boot loader. This image will be used by ironic when building UEFI-bootable ISO out of kernel and ramdisk. Required for UEFI boot from partition images.

clean_step_priority_override

Type:

unknown type

Default:

{}

Priority to run automated clean steps for both in-band and out of band clean steps, provided in interface.step_name:priority format, e.g. deploy.erase_devices_metadata:123. The option can be specified multiple times to define priorities for multiple steps. If set to 0, this specific step will not run during cleaning. If unset for an inband clean step, will use the priority set in the ramdisk.

node_history

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Boolean value, default True, if node event history is to be recorded. Errors and other noteworthy events in relation to a node are journaled to a database table which incurs some additional load. A periodic task does periodically remove entries from the database. Please note, if this is disabled, the conductor will continue to purge entries as long as [conductor]node_history_cleanup_batch_count is not 0.

node_history_max_entries

Type:

integer

Default:

300

Minimum Value:

0

Mutable:

This option can be changed without restarting.

Maximum number of history entries which will be stored in the database per node. Default is 300. This setting excludes the minimum number of days retained using the [conductor]node_history_minimum_days setting.

node_history_cleanup_interval

Type:

integer

Default:

86400

Minimum Value:

0

Interval in seconds at which node history entries can be cleaned up in the database. Setting to 0 disables the periodic task. Defaults to once a day, or 86400 seconds.

node_history_cleanup_batch_count

Type:

integer

Default:

1000

Minimum Value:

0

The target number of node history records to purge from the database when performing clean-up. Deletes are performed by node, and a node with excess records for a node will still be deleted. Defaults to 1000. Operators who find node history building up may wish to lower this threshold and decrease the time between cleanup operations using the node_history_cleanup_interval setting.

node_history_minimum_days

Type:

integer

Default:

0

Minimum Value:

0

Mutable:

This option can be changed without restarting.

The minimum number of days to explicitly keep on hand in the database history entries for nodes. This is exclusive from the [conductor]node_history_max_entries setting as users of this setting are anticipated to need to retain history by policy.

verify_step_priority_override

Type:

unknown type

Default:

{}

Mutable:

This option can be changed without restarting.

Priority to run automated verify steps provided in interface.step_name:priority format,e.g. management.clear_job_queue:123. The option can be specified multiple times to define priorities for multiple steps. If set to 0, this specific step will not run during verification.

automatic_lessee

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Deprecated. If Ironic should set the node.lessee field at deployment. Use [‘conductor’]/automatic_lessee_source instead.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

automatic_lessee_source

Type:

string

Default:

instance

Valid Values:

instance, request, none

Mutable:

This option can be changed without restarting.

Source for Project ID the Ironic should record at deployment time in node.lessee field. If set to none, Ironic will not set a lessee field. If set to instance (default), uses Project ID indicated in instance metadata set by Nova or another external deployment service. If set to keystone, Ironic uses Project ID indicated by Keystone context.

Possible values

instance

Populates node.lessee field using metadata from node.instance_info[‘project_id’] at deployment time. Useful for Nova-fronted deployments.

request

Populates node.lessee field using metadata from request context. Only useful for direct deployment requests to Ironic; not those proxied via an external service like Nova.

none

Ironic will not populate the node.lessee field.

max_concurrent_deploy

Type:

integer

Default:

250

Minimum Value:

1

Mutable:

This option can be changed without restarting.

The maximum number of concurrent nodes in deployment which are permitted in this Ironic system. If this limit is reached, new requests will be rejected until the number of deployments in progress is lower than this maximum. As this is a security mechanism requests are not queued, and this setting is a global setting applying to all requests this conductor receives, regardless of access rights. The concurrent deployment limit cannot be disabled.

max_concurrent_clean

Type:

integer

Default:

50

Minimum Value:

1

Mutable:

This option can be changed without restarting.

The maximum number of concurrent nodes in cleaning which are permitted in this Ironic system. If this limit is reached, new requests will be rejected until the number of nodes in cleaning is lower than this maximum. As this is a security mechanism requests are not queued, and this setting is a global setting applying to all requests this conductor receives, regardless of access rights. The concurrent clean limit cannot be disabled.

poweroff_in_cleanfail

Type:

boolean

Default:

False

If True power off nodes in the clean failed state. Default False. Option may be unsafe when using Cleaning to perform hardware-transformative actions such as firmware upgrade.

poweroff_in_servicefail

Type:

boolean

Default:

False

If True power off nodes in the service failed state. Default False. Option may be unsafe when using service to perform hardware-transformative actions such as firmware upgrade.

permit_child_node_step_async_result

Type:

boolean

Default:

False

Mutable:

This option can be changed without restarting.

This option allows child node steps to not error if the resulting step execution returned a “wait” state. Under normal conditions, child nodes are not expected to request a wait state. This option exists for operators to use if needed to perform specific tasks where this is known acceptable. Use at yourown risk!

max_conductor_wait_step_seconds

Type:

integer

Default:

30

Minimum Value:

0

Maximum Value:

1800

Mutable:

This option can be changed without restarting.

The maximum number of seconds which a step can be requested to explicitly sleep or wait. This value should be changed sparingly as it holds a conductor thread and if used across many nodes at once can exhaust a conductor’s resources. Thiscapability has a hard coded maximum wait of 1800 seconds, or 30 minutes. If you need to wait longer than the maximum value, we recommend exploring hold steps.

disallowed_deployment_boot_modes

Type:

list

Default:

[]

Mutable:

This option can be changed without restarting.

Specifies a list of boot modes that are not allowed during deployment. Eg: [‘bios’]

disable_deep_image_inspection

Type:

boolean

Default:

False

Security Option to permit an operator to disable file content inspections. Under normal conditions, the conductor will inspect requested image contents which are transferred through the conductor. Disabling this option is not advisable and opens the risk of unsafe images being processed which may allow an attacker to leverage unsafe features in various disk image formats to perform a variety of unsafe and potentially compromising actions. This option is not mutable, and requires a service restart to change.

conductor_always_validates_images

Type:

boolean

Default:

False

Security Option to enable the conductor to always inspect the image content of any requested deploy, even if the deployment would have normally bypassed the conductor’s cache. When this is set to False, the Ironic-Python-Agent is responsible for any necessary image checks. Setting this to True will result in a higher utilization of resources (disk space, network traffic) as the conductor will evaluate all images. This option is not mutable, and requires a service restart to change. This option requires [conductor]disable_deep_image_inspection to be set to False.

permitted_image_formats

Type:

list

Default:

['raw', 'qcow2', 'iso']

Mutable:

This option can be changed without restarting.

The supported list of image formats which are permitted for deployment with Ironic. If an image format outside of this list is detected, the image validation logic will fail the deployment process.

disable_file_checksum

Type:

boolean

Default:

False

Deprecated Security option: In the default case, image files have their checksums verified before undergoing additional conductor side actions such as image conversion. Enabling this option opens the risk of files being replaced at the source without the user’s knowledge.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

disable_support_for_checksum_files

Type:

boolean

Default:

False

Security option: By default Ironic will attempt to retrieve a remote checksum file via HTTP(S) URL in order to validate an image download. This is functionality aligning with ironic-python-agent support for standalone users. Disabling this functionality by setting this option to True will create a more secure environment, however it may break users in an unexpected fashion.

console

terminal

Type:

string

Default:

shellinaboxd

Path to serial console terminal program. Used only by Shell In A Box console.

terminal_cert_dir

Type:

string

Default:

<None>

Directory containing the terminal SSL cert (PEM) for serial console access. Used only by Shell In A Box console.

terminal_pid_dir

Type:

string

Default:

<None>

Directory for holding terminal pid files. If not specified, the temporary directory will be used.

terminal_timeout

Type:

integer

Default:

600

Minimum Value:

0

Timeout (in seconds) for the terminal session to be closed on inactivity. Set to 0 to disable timeout. Used only by Socat console.

subprocess_checking_interval

Type:

integer

Default:

1

Time interval (in seconds) for checking the status of console subprocess.

subprocess_timeout

Type:

integer

Default:

10

Time (in seconds) to wait for the console subprocess to start.

kill_timeout

Type:

integer

Default:

1

Time (in seconds) to wait for the console subprocess to exit before sending SIGKILL signal.

socat_address

Type:

ip address

Default:

$my_ip

IP address of Socat service running on the host of ironic conductor. Used only by Socat console.

port_range

Type:

string

Default:

10000:20000

This option has a sample default set, which means that its actual default value may vary from the one documented above.

A range of ports available to be used for the console proxy service running on the host of ironic conductor, in the form of <start>:<stop>. This option is used by both Shellinabox and Socat console

cors

allowed_origin

Type:

list

Default:

<None>

Indicate whether this resource may be shared with the domain received in the requests “origin” header. Format: “<protocol>://<host>[:<port>]”, no trailing slash. Example: https://horizon.example.com

allow_credentials

Type:

boolean

Default:

True

Indicate that the actual request can include user credentials

expose_headers

Type:

list

Default:

[]

Indicate which headers are safe to expose to the API. Defaults to HTTP Simple Headers.

max_age

Type:

integer

Default:

3600

Maximum cache age of CORS preflight requests.

allow_methods

Type:

list

Default:

['OPTIONS', 'GET', 'HEAD', 'POST', 'PUT', 'DELETE', 'TRACE', 'PATCH']

Indicate which methods can be used during the actual request.

allow_headers

Type:

list

Default:

[]

Indicate which header field names may be used during the actual request.

database

mysql_engine

Type:

string

Default:

InnoDB

MySQL engine to use.

sqlite_retries

Type:

boolean

Default:

True

If SQLite database operation retry logic is enabled or not. Enabled by default.

sqlite_max_wait_for_retry

Type:

integer

Default:

10

Maximum number of seconds to retry SQLite database locks, after which the original exception will be returned to the caller. This does not presently apply to internal node lock release actions and DB actions centered around the completion of tasks.

sqlite_synchronous

Type:

boolean

Default:

True

If True, SQLite uses synchronous mode.

backend

Type:

string

Default:

sqlalchemy

The back end to use for the database.

connection

Type:

string

Default:

<None>

The SQLAlchemy connection string to use to connect to the database.

slave_connection

Type:

string

Default:

<None>

The SQLAlchemy connection string to use to connect to the slave database.

mysql_sql_mode

Type:

string

Default:

TRADITIONAL

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=

mysql_wsrep_sync_wait

Type:

integer

Default:

<None>

For Galera only, configure wsrep_sync_wait causality checks on new connections. Default is None, meaning don’t configure any setting.

connection_recycle_time

Type:

integer

Default:

3600

Connections which have been present in the connection pool longer than this number of seconds will be replaced with a new one the next time they are checked out from the pool.

max_pool_size

Type:

integer

Default:

5

Maximum number of SQL connections to keep open in a pool. Setting a value of 0 indicates no limit.

max_retries

Type:

integer

Default:

10

Maximum number of database connection retries during startup. Set to -1 to specify an infinite retry count.

retry_interval

Type:

integer

Default:

10

Interval between retries of opening a SQL connection.

max_overflow

Type:

integer

Default:

50

If set, use this value for max_overflow with SQLAlchemy.

connection_debug

Type:

integer

Default:

0

Minimum Value:

0

Maximum Value:

100

Verbosity of SQL debugging information: 0=None, 100=Everything.

connection_trace

Type:

boolean

Default:

False

Add Python stack traces to SQL as comment strings.

pool_timeout

Type:

integer

Default:

<None>

If set, use this value for pool_timeout with SQLAlchemy.

use_db_reconnect

Type:

boolean

Default:

False

Enable the experimental use of database reconnect on connection lost.

db_retry_interval

Type:

integer

Default:

1

Seconds between retries of a database transaction.

db_inc_retry_interval

Type:

boolean

Default:

True

If True, increases the interval between retries of a database operation up to db_max_retry_interval.

db_max_retry_interval

Type:

integer

Default:

10

If db_inc_retry_interval is set, the maximum seconds between retries of a database operation.

db_max_retries

Type:

integer

Default:

20

Maximum retries in case of connection error or deadlock error before error is raised. Set to -1 to specify an infinite retry count.

connection_parameters

Type:

string

Default:

''

Optional URL parameters to append onto the connection URL at connect time; specify as param1=value1&param2=value2&…

deploy

http_url

Type:

URI

Default:

<None>

ironic-conductor node’s HTTP server URL. Example: http://192.1.2.3:8080

http_root

Type:

string

Default:

/httpboot

ironic-conductor node’s HTTP root path.

image_server_auth_strategy

Type:

string

Default:

noauth

Valid Values:

noauth, http_basic

Mutable:

This option can be changed without restarting.

Used to select authentication strategy against the image hosting HTTP(S) server. When set to http_basic it enables HTTP(S) Basic Authentication. Exception is thrown in case of missing credentials. When this option has a valid value such as http_basic, the same single set of credentials will be used against all user-image sources! Currently only the http_basic option has any functionality.

Possible values

noauth

No authentication

http_basic

HTTP Basic authentication

image_server_user

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

Can be used by any authentication strategy that requires username credential. Currently utilized by the http_basic authentication strategy.

image_server_password

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

Can be used by any authentication strategy that requires password credential. Currently utilized by the http_basic authentication strategy.

external_http_url

Type:

URI

Default:

<None>

URL of the ironic-conductor node’s HTTP server for boot methods such as virtual media, where images could be served outside of the provisioning network. Does not apply when Swift is used. Defaults to http_url.

external_callback_url

Type:

URI

Default:

<None>

Agent callback URL of the bare metal API for boot methods such as virtual media, where images could be served outside of the provisioning network. Defaults to the configuration from [service_catalog].

enable_ata_secure_erase

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Whether to support the use of ATA Secure Erase during the cleaning process. Defaults to True.

enable_nvme_secure_erase

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Whether to support the use of NVMe Secure Erase during the cleaning process. Currently nvme-cli format command is supported with user-data and crypto modes, depending on device capabilities.Defaults to True.

erase_devices_priority

Type:

integer

Default:

<None>

Mutable:

This option can be changed without restarting.

Priority to run in-band erase devices via the Ironic Python Agent ramdisk. If unset, will use the priority set in the ramdisk (defaults to 10 for the GenericHardwareManager). If set to 0, will not run during cleaning.

erase_devices_metadata_priority

Type:

integer

Default:

<None>

Mutable:

This option can be changed without restarting.

Priority to run in-band clean step that erases metadata from devices, via the Ironic Python Agent ramdisk. If unset, will use the priority set in the ramdisk (defaults to 99 for the GenericHardwareManager). If set to 0, will not run during cleaning.

delete_configuration_priority

Type:

integer

Default:

<None>

Mutable:

This option can be changed without restarting.

Priority to run in-band clean step that erases RAID configuration from devices, via the Ironic Python Agent ramdisk. If unset, will use the priority set in the ramdisk (defaults to 0 for the GenericHardwareManager). If set to 0, will not run during cleaning.

create_configuration_priority

Type:

integer

Default:

<None>

Mutable:

This option can be changed without restarting.

Priority to run in-band clean step that creates RAID configuration from devices, via the Ironic Python Agent ramdisk. If unset, will use the priority set in the ramdisk (defaults to 0 for the GenericHardwareManager). If set to 0, will not run during cleaning.

shred_random_overwrite_iterations

Type:

integer

Default:

1

Minimum Value:

0

Mutable:

This option can be changed without restarting.

During shred, overwrite all block devices N times with random data. This is only used if a device could not be ATA Secure Erased. Defaults to 1.

shred_final_overwrite_with_zeros

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Whether to write zeros to a node’s block devices after writing random data. This will write zeros to the device even when deploy.shred_random_overwrite_iterations is 0. This option is only used if a device could not be ATA Secure Erased. Defaults to True.

continue_if_disk_secure_erase_fails

Type:

boolean

Default:

False

Mutable:

This option can be changed without restarting.

Defines what to do if a secure erase operation (NVMe or ATA) fails during cleaning in the Ironic Python Agent. If False, the cleaning operation will fail and the node will be put in clean failed state. If True, shred will be invoked and cleaning will continue.

disk_erasure_concurrency

Type:

integer

Default:

4

Minimum Value:

1

Mutable:

This option can be changed without restarting.

Defines the target pool size used by Ironic Python Agent ramdisk to erase disk devices. The number of threads created to erase disks will not exceed this value or the number of disks to be erased.

power_off_after_deploy_failure

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Whether to power off a node after deploy failure. Defaults to True.

default_boot_mode

Type:

string

Default:

uefi

Valid Values:

uefi, bios

Mutable:

This option can be changed without restarting.

Default boot mode to use when no boot mode is requested in node’s driver_info, capabilities or in the instance_info configuration. Currently the default boot mode is “uefi”, but it was “bios” previously in Ironic. It is recommended to set an explicit value for this option, and if the setting or default differs from nodes, to ensure that nodes are configured specifically for their desired boot mode.

Possible values

uefi

UEFI boot mode

bios

Legacy BIOS boot mode

configdrive_use_object_store

Type:

boolean

Default:

False

Mutable:

This option can be changed without restarting.

Whether to upload the config drive to object store. Set this option to True to store config drive in a swift endpoint.

Deprecated Variations

Group	Name
conductor	configdrive_use_swift

http_image_subdir

Type:

string

Default:

agent_images

The name of subdirectory under ironic-conductor node’s HTTP root path which is used to place instance images for the direct deploy interface, when local HTTP service is incorporated to provide instance image instead of swift tempurls.

fast_track

Type:

boolean

Default:

False

Mutable:

This option can be changed without restarting.

Whether to allow deployment agents to perform lookup, heartbeat operations during initial states of a machine lifecycle and by-pass the normal setup procedures for a ramdisk. This feature also enables power operations which are part of deployment processes to be bypassed if the ramdisk has performed a heartbeat operation using the fast_track_timeout setting.

fast_track_timeout

Type:

integer

Default:

300

Minimum Value:

0

Maximum Value:

300

Mutable:

This option can be changed without restarting.

Seconds for which the last heartbeat event is to be considered valid for the purpose of a fast track sequence. This setting should generally be less than the number of seconds for “Power-On Self Test” and typical ramdisk start-up. This value should not exceed the [api]ramdisk_heartbeat_timeout setting.

erase_skip_read_only

Type:

boolean

Default:

False

Mutable:

This option can be changed without restarting.

If the ironic-python-agent should skip read-only devices when running the “erase_devices” clean step where block devices are zeroed out. This requires ironic-python-agent 6.0.0 or greater. By default a read-only device will cause non-metadata based cleaning operations to fail due to the possible operational security risk of data being retained between deployments of the bare metal node.

ramdisk_image_download_source

Type:

string

Default:

local

Valid Values:

http, local, swift

Mutable:

This option can be changed without restarting.

Specifies whether a boot iso image should be served from its own original location using the image source url directly, or if ironic should cache the image on the conductor and serve it from ironic’s own http server.

Possible values

http

In case the ramdisk is already a bootable iso, using this option it will be directly provided by an external HTTP service using its full url.

local

This is the default behavior. The image is downloaded, prepared and cached locally, to be served from the conductor.

swift

Same as “http”, but if the image is a Glance UUID, it is exposed via a Swift temporary URL.

iso_master_path

Type:

string

Default:

/var/lib/ironic/master_iso_images

On the ironic-conductor node, directory where master ISO images are stored on disk. Setting to the empty string disables image caching.

iso_cache_size

Type:

integer

Default:

20480

Maximum size (in MiB) of cache for master ISO images, including those in use.

iso_cache_ttl

Type:

integer

Default:

10080

Maximum TTL (in minutes) for old master ISO images in cache.

dhcp

dhcp_provider

Type:

string

Default:

neutron

DHCP provider to use. “neutron” uses Neutron, “dnsmasq” uses the Dnsmasq provider, and “none” uses a no-op provider.

disk_utils

image_convert_memory_limit

Type:

integer

Default:

2048

Memory limit for “qemu-img convert” in MiB. Implemented via the address space resource limit.

image_convert_attempts

Type:

integer

Default:

3

Number of attempts to convert an image.

drac

query_raid_config_job_status_interval

Type:

integer

Default:

120

Minimum Value:

1

Interval (in seconds) between periodic RAID job status checks to determine whether the asynchronous RAID configuration was successfully finished or not.

boot_device_job_status_timeout

Type:

integer

Default:

30

Minimum Value:

1

Maximum amount of time (in seconds) to wait for the boot device configuration job to transition to the correct state to allow a reboot or power on to complete.

config_job_max_retries

Type:

integer

Default:

240

Minimum Value:

1

Maximum number of retries for the configuration job to complete successfully.

query_import_config_job_status_interval

Type:

integer

Default:

60

Minimum Value:

0

Number of seconds to wait between checking for completed import configuration task

bios_factory_reset_timeout

Type:

integer

Default:

600

Minimum Value:

1

Maximum time (in seconds) to wait for factory reset of BIOS settings to complete.

raid_job_timeout

Type:

integer

Default:

300

Minimum Value:

1

Maximum time (in seconds) to wait for RAID job to complete

glance

allowed_direct_url_schemes

Type:

list

Default:

[]

A list of URL schemes that can be downloaded directly via the direct_url. Currently supported schemes: [file].

auth_url

Type:

unknown type

Default:

<None>

Authentication URL

auth_type

Type:

unknown type

Default:

<None>

Authentication type to load

Deprecated Variations

Group	Name
glance	auth_plugin

cafile

Type:

string

Default:

<None>

PEM encoded Certificate Authority to use when verifying HTTPs connections.

certfile

Type:

string

Default:

<None>

PEM encoded client certificate cert file

collect_timing

Type:

boolean

Default:

False

Collect per-API call timing information.

connect_retries

Type:

integer

Default:

<None>

The maximum number of retries that should be attempted for connection errors.

connect_retry_delay

Type:

floating point

Default:

<None>

Delay (in seconds) between two retries for connection errors. If not set, exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is used.

default_domain_id

Type:

unknown type

Default:

<None>

Optional domain ID to use with v3 and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

default_domain_name

Type:

unknown type

Default:

<None>

Optional domain name to use with v3 API and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

domain_id

Type:

unknown type

Default:

<None>

Domain ID to scope to

domain_name

Type:

unknown type

Default:

<None>

Domain name to scope to

endpoint_override

Type:

string

Default:

<None>

Always use this endpoint URL for requests for this client. NOTE: The unversioned endpoint should be specified here; to request a particular API version, use the version, min-version, and/or max-version options.

insecure

Type:

boolean

Default:

False

Verify HTTPS connections.

keyfile

Type:

string

Default:

<None>

PEM encoded client certificate key file

max_version

Type:

string

Default:

<None>

The maximum major version of a given API, intended to be used as the upper bound of a range with min_version. Mutually exclusive with version.

min_version

Type:

string

Default:

<None>

The minimum major version of a given API, intended to be used as the lower bound of a range with max_version. Mutually exclusive with version. If min_version is given with no max_version it is as if max version is “latest”.

num_retries

Type:

integer

Default:

0

Mutable:

This option can be changed without restarting.

Number of retries when downloading an image from glance.

password

Type:

unknown type

Default:

<None>

User’s password

project_domain_id

Type:

unknown type

Default:

<None>

Domain ID containing project

project_domain_name

Type:

unknown type

Default:

<None>

Domain name containing project

project_id

Type:

unknown type

Default:

<None>

Project ID to scope to

Deprecated Variations

Group	Name
glance	tenant-id
glance	tenant_id

project_name

Type:

unknown type

Default:

<None>

Project name to scope to

Deprecated Variations

Group	Name
glance	tenant-name
glance	tenant_name

region_name

Type:

string

Default:

<None>

The default region_name for endpoint URL discovery.

retriable_status_codes

Type:

list

Default:

<None>

List of retriable HTTP status codes that should be retried. If not set default to [503]

service_name

Type:

string

Default:

<None>

The default service_name for endpoint URL discovery.

service_type

Type:

string

Default:

image

The default service_type for endpoint URL discovery.

split_loggers

Type:

boolean

Default:

False

Log requests to multiple loggers.

status_code_retries

Type:

integer

Default:

<None>

The maximum number of retries that should be attempted for retriable HTTP status codes.

status_code_retry_delay

Type:

floating point

Default:

<None>

Delay (in seconds) between two retries for retriable status codes. If not set, exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is used.

swift_account

Type:

string

Default:

<None>

The account that Glance uses to communicate with Swift. The format is “AUTH_uuid”. “uuid” is the UUID for the account configured in the glance-api.conf. For example: “AUTH_a422b2-91f3-2f46-74b7-d7c9e8958f5d30”. If not set, the default value is calculated based on the ID of the project used to access Swift (as set in the [swift] section). Swift temporary URL format: “endpoint_url/api_version/account/container/object_id”

swift_account_prefix

Type:

string

Default:

AUTH

The prefix added to the project uuid to determine the swift account.

swift_api_version

Type:

string

Default:

v1

The Swift API version to create a temporary URL for. Defaults to “v1”. Swift temporary URL format: “endpoint_url/api_version/account/container/object_id”

swift_container

Type:

string

Default:

glance

The Swift container Glance is configured to store its images in. Defaults to “glance”, which is the default in glance-api.conf. Swift temporary URL format: “endpoint_url/api_version/account/container/object_id”

swift_endpoint_url

Type:

URI

Default:

<None>

The “endpoint” (scheme, hostname, optional port) for the Swift URL of the form “endpoint_url/api_version/account/container/object_id”. Do not include trailing “/”. For example, use “https://swift.example.com”. If using RADOS Gateway, endpoint may also contain /swift path; if it does not, it will be appended. Used for temporary URLs, will be fetched from the service catalog, if not provided.

swift_store_multiple_containers_seed

Type:

integer

Default:

0

This should match a config by the same name in the Glance configuration file. When set to 0, a single-tenant store will only use one container to store all images. When set to an integer value between 1 and 32, a single-tenant store will use multiple containers to store images, and this value will determine how many containers are created.

swift_temp_url_cache_enabled

Type:

boolean

Default:

False

Whether to cache generated Swift temporary URLs. Setting it to true is only useful when an image caching proxy is used. Defaults to False.

swift_temp_url_duration

Type:

integer

Default:

1200

The length of time in seconds that the temporary URL will be valid for. Defaults to 20 minutes. If some deploys get a 401 response code when trying to download from the temporary URL, try raising this duration. This value must be greater than or equal to the value for swift_temp_url_expected_download_start_delay

swift_temp_url_expected_download_start_delay

Type:

integer

Default:

0

Minimum Value:

0

This is the delay (in seconds) from the time of the deploy request (when the Swift temporary URL is generated) to when the IPA ramdisk starts up and URL is used for the image download. This value is used to check if the Swift temporary URL duration is large enough to let the image download begin. Also if temporary URL caching is enabled this will determine if a cached entry will still be valid when the download starts. swift_temp_url_duration value must be greater than or equal to this option’s value. Defaults to 0.

swift_temp_url_key

Type:

string

Default:

<None>

The secret token given to Swift to allow temporary URL downloads. Required for temporary URLs. For the Swift backend, the key on the service project (as set in the [swift] section) is used by default.

system_scope

Type:

unknown type

Default:

<None>

Scope for system operations

tenant_id

Type:

unknown type

Default:

<None>

Tenant ID

tenant_name

Type:

unknown type

Default:

<None>

Tenant Name

timeout

Type:

integer

Default:

<None>

Timeout value for http requests

trust_id

Type:

unknown type

Default:

<None>

ID of the trust to use as a trustee use

user_domain_id

Type:

unknown type

Default:

<None>

User’s domain id

user_domain_name

Type:

unknown type

Default:

<None>

User’s domain name

user_id

Type:

unknown type

Default:

<None>

User id

username

Type:

unknown type

Default:

<None>

Username

Deprecated Variations

Group	Name
glance	user-name
glance	user_name

valid_interfaces

Type:

list

Default:

['internal', 'public']

List of interfaces, in order of preference, for endpoint URL.

version

Type:

string

Default:

<None>

Minimum Major API version within a given Major API version for endpoint URL discovery. Mutually exclusive with min_version and max_version

healthcheck

path

Type:

string

Default:

/healthcheck

The path to respond to healtcheck requests on.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

detailed

Type:

boolean

Default:

False

Show more detailed information as part of the response. Security note: Enabling this option may expose sensitive details about the service being monitored. Be sure to verify that it will not violate your security policies.

backends

Type:

list

Default:

[]

Additional backends that can perform health checks and report that information back as part of a request.

allowed_source_ranges

Type:

list

Default:

[]

A list of network addresses to limit source ip allowed to access healthcheck information. Any request from ip outside of these network addresses are ignored.

ignore_proxied_requests

Type:

boolean

Default:

False

Ignore requests with proxy headers.

disable_by_file_path

Type:

string

Default:

<None>

Check the presence of a file to determine if an application is running on a port. Used by DisableByFileHealthcheck plugin.

disable_by_file_paths

Type:

list

Default:

[]

Check the presence of a file based on a port to determine if an application is running on a port. Expects a “port:path” list of strings. Used by DisableByFilesPortsHealthcheck plugin.

enable_by_file_paths

Type:

list

Default:

[]

Check the presence of files. Used by EnableByFilesHealthcheck plugin.

enabled

Type:

boolean

Default:

False

Enable the health check endpoint at /healthcheck. Note that this is unauthenticated. More information is available at https://docs.openstack.org/oslo.middleware/latest/reference/healthcheck_plugins.html.

ilo

client_timeout

Type:

integer

Default:

60

Timeout (in seconds) for iLO operations

client_port

Type:

port number

Default:

443

Minimum Value:

0

Maximum Value:

65535

Port to be used for iLO operations

swift_ilo_container

Type:

string

Default:

ironic_ilo_container

The Swift iLO container to store data.

swift_object_expiry_timeout

Type:

integer

Default:

900

Amount of time in seconds for Swift objects to auto-expire.

use_web_server_for_images

Type:

boolean

Default:

False

Set this to True to use http web server to host floppy images and generated boot ISO. This requires http_root and http_url to be configured in the [deploy] section of the config file. If this is set to False, then Ironic will use Swift to host the floppy images and generated boot_iso.

clean_priority_reset_ilo

Type:

integer

Default:

0

Priority for reset_ilo clean step.

clean_priority_reset_bios_to_default

Type:

integer

Default:

10

Priority for reset_bios_to_default clean step.

clean_priority_reset_secure_boot_keys_to_default

Type:

integer

Default:

20

Priority for reset_secure_boot_keys clean step. This step will reset the secure boot keys to manufacturing defaults.

clean_priority_clear_secure_boot_keys

Type:

integer

Default:

0

Priority for clear_secure_boot_keys clean step. This step is not enabled by default. It can be enabled to clear all secure boot keys enrolled with iLO.

clean_priority_reset_ilo_credential

Type:

integer

Default:

30

Priority for reset_ilo_credential clean step. This step requires “ilo_change_password” parameter to be updated in nodes’s driver_info with the new password.

power_wait

Type:

integer

Default:

2

Amount of time in seconds to wait in between power operations

oob_erase_devices_job_status_interval

Type:

integer

Default:

300

Minimum Value:

10

Interval (in seconds) between periodic erase-devices status checks to determine whether the asynchronous out-of-band erase-devices was successfully finished or not. On an average, a 300GB HDD with default pattern “overwrite” would take approximately 9 hours and 300GB SSD with default pattern “block” would take approx. 30 seconds to complete sanitize disk erase.

ca_file

Type:

string

Default:

<None>

CA certificate file to validate iLO.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

Its being replaced by new configuration parameter “verify_ca”.

verify_ca

Type:

string

Default:

True

CA certificate to validate iLO. This can be either a Boolean value, a path to a CA_BUNDLE file or directory with certificates of trusted CAs. If set to True the driver will verify the host certificates; if False the driver will ignore verifying the SSL certificate. If it’s a path the driver will use the specified certificate or one of the certificates in the directory. Defaults to True.

default_boot_mode

Type:

string

Default:

auto

Valid Values:

auto, bios, uefi

Default boot mode to be used in provisioning when “boot_mode” capability is not provided in the “properties/capabilities” of the node. The default is “auto” for backward compatibility. When “auto” is specified, default boot mode will be selected based on boot mode settings on the system.

Possible values

auto

based on boot mode settings on the system

bios

BIOS boot mode

uefi

UEFI boot mode

file_permission

Type:

integer

Default:

420

File permission for swift-less image hosting with the octal permission representation of file access permissions. This setting defaults to 644, or as the octal number 0o644 in Python. This setting must be set to the octal number representation, meaning starting with 0o.

kernel_append_params

Type:

string

Default:

nofb vga=normal

Mutable:

This option can be changed without restarting.

Additional kernel parameters to pass down to the instance kernel. These parameters can be consumed by the kernel or by the applications by reading /proc/cmdline. Mind severe cmdline size limit! Can be overridden by instance_info/kernel_append_params property.

cert_path

Type:

string

Default:

/var/lib/ironic/ilo/

On the ironic-conductor node, directory where ilo driver stores the CSR and the cert.

inspector

add_ports

Type:

string

Default:

pxe

Valid Values:

all, active, pxe, disabled

Which MAC addresses to add as ports during inspection.

Possible values

all

all MAC addresses

active

MAC addresses of NICs with IP addresses

pxe

only the MAC address of the PXE NIC

disabled

do not create any ports

auth_url

Type:

unknown type

Default:

<None>

Authentication URL

auth_type

Type:

unknown type

Default:

<None>

Authentication type to load

Deprecated Variations

Group	Name
inspector	auth_plugin

cafile

Type:

string

Default:

<None>

PEM encoded Certificate Authority to use when verifying HTTPs connections.

callback_endpoint_override

Type:

string

Default:

<None>

endpoint to use as a callback for posting back introspection data when boot is managed by ironic. Standard keystoneauth options are used by default.

certfile

Type:

string

Default:

<None>

PEM encoded client certificate cert file

collect_timing

Type:

boolean

Default:

False

Collect per-API call timing information.

connect_retries

Type:

integer

Default:

<None>

The maximum number of retries that should be attempted for connection errors.

connect_retry_delay

Type:

floating point

Default:

<None>

Delay (in seconds) between two retries for connection errors. If not set, exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is used.

cpu_capabilities

Type:

dict

Default:

{'vmx': 'cpu_vt', 'svm': 'cpu_vt', 'aes': 'cpu_aes', 'pse': 'cpu_hugepages', 'pdpe1gb': 'cpu_hugepages_1g', 'smx': 'cpu_txt'}

Mapping between a CPU flag and a node capability to set if this CPU flag is present. This configuration option is used by the “cpu-capabilities” inspection hook.

default_domain_id

Type:

unknown type

Default:

<None>

Optional domain ID to use with v3 and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

default_domain_name

Type:

unknown type

Default:

<None>

Optional domain name to use with v3 API and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

default_hooks

Type:

string

Default:

ramdisk-error,validate-interfaces,ports,architecture

A comma-separated lists of inspection hooks that are run by default. In most cases, the operators will not modify this. The default (somewhat conservative) hooks will raise an exception in case the ramdisk reports an error, validate interfaces in the inventory, create ports and set the node’s cpu architecture property.

disk_partitioning_spacing

Type:

boolean

Default:

True

Whether to leave 1 GiB of disk size untouched for partitioning. Only has effect when used with the IPA as a ramdisk, for older ramdisk local_gb is calculated on the ramdisk side. This configuration option is used by the “root-device” inspection hook.

domain_id

Type:

unknown type

Default:

<None>

Domain ID to scope to

domain_name

Type:

unknown type

Default:

<None>

Domain name to scope to

endpoint_override

Type:

string

Default:

<None>

Always use this endpoint URL for requests for this client. NOTE: The unversioned endpoint should be specified here; to request a particular API version, use the version, min-version, and/or max-version options.

extra_hardware_strict

Type:

boolean

Default:

False

If True, refuse to parse extra data (in plugin_data) if at least one record is too short. Additionally, remove the incoming “data” even if parsing failed. This configuration option is used by the “extra-hardware” inspection hook.

extra_kernel_params

Type:

string

Default:

''

extra kernel parameters to pass to the inspection ramdisk when boot is managed by ironic (not ironic-inspector). Pairs key=value separated by spaces.

hooks

Type:

string

Default:

$default_hooks

Comma-separated list of enabled hooks for processing pipeline. The default for this is $default_hooks. Hooks can be added before or after the defaults like this: “prehook,$default_hooks,posthook”.

insecure

Type:

boolean

Default:

False

Verify HTTPS connections.

keep_ports

Type:

string

Default:

all

Valid Values:

all, present, added

Which ports (already present on a node) to keep after inspection.

Possible values

all

keep all ports, even ones with MAC addresses that are not present in the inventory

present

keep only ports with MAC addresses present in the inventory

added

keep only ports determined by the add_ports option

keyfile

Type:

string

Default:

<None>

PEM encoded client certificate key file

known_accelerators

Type:

string

Default:

$pybasedir/drivers/modules/inspector/hooks/known_accelerators.yaml

Path to the file which contains the known accelerator devices, to be used by the “accelerators” inspection hook.

max_version

Type:

string

Default:

<None>

The maximum major version of a given API, intended to be used as the upper bound of a range with min_version. Mutually exclusive with version.

min_version

Type:

string

Default:

<None>

The minimum major version of a given API, intended to be used as the lower bound of a range with max_version. Mutually exclusive with version. If min_version is given with no max_version it is as if max version is “latest”.

password

Type:

unknown type

Default:

<None>

User’s password

pci_device_alias

Type:

multi-valued

Default:

''

An alias for a PCI device identified by ‘vendor_id’ and ‘product_id’ fields. Format: {“vendor_id”: “1234”, “product_id”: “5678”, “name”: “pci_dev1”}. Use double quotes for the keys and values.

physical_network_cidr_map

Type:

list

Default:

10.10.10.0/24:physnet_a,2001:db8::/64:physnet_b

This option has a sample default set, which means that its actual default value may vary from the one documented above.

Mapping of IP subnet CIDR to physical network. When the phyical-network inspection hook is enabled, the “physical_network” property of corresponding baremetal ports is populated based on this mapping.

power_off

Type:

boolean

Default:

True

whether to power off a node after inspection finishes. Ignored for nodes that have fast track mode enabled.

project_domain_id

Type:

unknown type

Default:

<None>

Domain ID containing project

project_domain_name

Type:

unknown type

Default:

<None>

Domain name containing project

project_id

Type:

unknown type

Default:

<None>

Project ID to scope to

Deprecated Variations

Group	Name
inspector	tenant-id
inspector	tenant_id

project_name

Type:

unknown type

Default:

<None>

Project name to scope to

Deprecated Variations

Group	Name
inspector	tenant-name
inspector	tenant_name

region_name

Type:

string

Default:

<None>

The default region_name for endpoint URL discovery.

require_managed_boot

Type:

boolean

Default:

<None>

require that the in-band inspection boot is fully managed by the node’s boot interface. Set this to False if your installation has a separate (i)PXE boot environment for node discovery or unmanaged inspection. You may need to set it to False to inspect nodes that are not supported by boot interfaces (e.g. because they don’t have ports). The default value depends on which inspect interface is used: inspector uses False, agent - True.

retriable_status_codes

Type:

list

Default:

<None>

List of retriable HTTP status codes that should be retried. If not set default to [503]

service_name

Type:

string

Default:

<None>

The default service_name for endpoint URL discovery.

service_type

Type:

string

Default:

baremetal-introspection

The default service_type for endpoint URL discovery.

split_loggers

Type:

boolean

Default:

False

Log requests to multiple loggers.

status_code_retries

Type:

integer

Default:

<None>

The maximum number of retries that should be attempted for retriable HTTP status codes.

status_code_retry_delay

Type:

floating point

Default:

<None>

Delay (in seconds) between two retries for retriable status codes. If not set, exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is used.

status_check_period

Type:

integer

Default:

60

period (in seconds) to check status of nodes on inspection

system_scope

Type:

unknown type

Default:

<None>

Scope for system operations

tenant_id

Type:

unknown type

Default:

<None>

Tenant ID

tenant_name

Type:

unknown type

Default:

<None>

Tenant Name

timeout

Type:

integer

Default:

<None>

Timeout value for http requests

trust_id

Type:

unknown type

Default:

<None>

ID of the trust to use as a trustee use

update_pxe_enabled

Type:

boolean

Default:

True

Whether to update the ports’ pxe_enabled field according to the inspection data.

user_domain_id

Type:

unknown type

Default:

<None>

User’s domain id

user_domain_name

Type:

unknown type

Default:

<None>

User’s domain name

user_id

Type:

unknown type

Default:

<None>

User id

username

Type:

unknown type

Default:

<None>

Username

Deprecated Variations

Group	Name
inspector	user-name
inspector	user_name

valid_interfaces

Type:

list

Default:

['internal', 'public']

List of interfaces, in order of preference, for endpoint URL.

version

Type:

string

Default:

<None>

Minimum Major API version within a given Major API version for endpoint URL discovery. Mutually exclusive with min_version and max_version

inventory

data_backend

Type:

string

Default:

database

Valid Values:

none, database, swift

The storage backend for storing inspection data.

Possible values

none

do not store inspection data

database

store in the service database

swift

store in the Object Storage (swift)

swift_data_container

Type:

string

Default:

introspection_data_container

The Swift container prefix to store the inspection data (separately inventory and plugin data).

ipmi

command_retry_timeout

Type:

integer

Default:

60

Mutable:

This option can be changed without restarting.

Maximum time in seconds to retry retryable IPMI operations. (An operation is retryable, for example, if the requested operation fails because the BMC is busy.) Setting this too high can cause the sync power state periodic task to hang when there are slow or unresponsive BMCs.

min_command_interval

Type:

integer

Default:

5

Mutable:

This option can be changed without restarting.

Minimum time, in seconds, between IPMI operations sent to a server. There is a risk with some hardware that setting this too low may cause the BMC to crash. Recommended setting is 5 seconds.

use_ipmitool_retries

Type:

boolean

Default:

False

When set to True and the parameters are supported by ipmitool, the number of retries and the retry interval are passed to ipmitool as parameters, and ipmitool will do the retries. When set to False, ironic will retry the ipmitool commands. Recommended setting is False

kill_on_timeout

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Kill ipmitool process invoked by ironic to read node power state if ipmitool process does not exit after command_retry_timeout timeout expires. Recommended setting is True. Setting to False may present an operational issue and will result in unexpected and undesirable behavior.

disable_boot_timeout

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

Default timeout behavior whether ironic sends a raw IPMI command to disable the 60 second timeout for booting. Setting this option to False will NOT send that command, the default value is True. It may be overridden by per-node ‘ipmi_disable_boot_timeout’ option in node’s ‘driver_info’ field.

additional_retryable_ipmi_errors

Type:

multi-valued

Default:

''

Mutable:

This option can be changed without restarting.

Additional errors ipmitool may encounter, specific to the environment it is run in.

debug

Type:

boolean

Default:

False

Mutable:

This option can be changed without restarting.

Enables all ipmi commands to be executed with an additional debugging output. This is a separate option as ipmitool can log a substantial amount of misleading text when in this mode.

store_cred_in_env

Type:

boolean

Default:

False

Boolean flag to determine IPMI password persistence method. Defaults to False (file-based persistence).

cipher_suite_versions

Type:

list

Default:

[]

List of possible cipher suites versions that can be supported by the hardware in case the field cipher_suite is not set for the node.

irmc

remote_image_share_root

Type:

string

Default:

/remote_image_share_root

Ironic conductor node’s “NFS” or “CIFS” root path

remote_image_server

Type:

string

Default:

<None>

IP of remote image server

remote_image_share_type

Type:

string

Default:

CIFS

Valid Values:

CIFS, NFS

Share type of virtual media

Possible values

CIFS

CIFS (Common Internet File System) protocol

NFS

NFS (Network File System) protocol

remote_image_share_name

Type:

string

Default:

share

share name of remote_image_server

remote_image_user_name

Type:

string

Default:

<None>

User name of remote_image_server

remote_image_user_password

Type:

string

Default:

<None>

Password of remote_image_user_name

remote_image_user_domain

Type:

string

Default:

''

Domain name of remote_image_user_name

port

Type:

port number

Default:

443

Minimum Value:

0

Maximum Value:

65535

Valid Values:

443, 80

Port to be used for iRMC operations

Possible values

443

port 443

80

port 80

auth_method

Type:

string

Default:

basic

Valid Values:

basic, digest

Authentication method to be used for iRMC operations

Possible values

basic

Basic authentication

digest

Digest authentication

client_timeout

Type:

integer

Default:

60

Timeout (in seconds) for iRMC operations

sensor_method

Type:

string

Default:

ipmitool

Valid Values:

ipmitool, scci

Sensor data retrieval method.

Possible values

ipmitool

IPMItool

scci

Fujitsu SCCI (ServerView Common Command Interface)

snmp_version

Type:

string

Default:

v2c

Valid Values:

v1, v2c, v3

SNMP protocol version

Possible values

v1

SNMPv1

v2c

SNMPv2c

v3

SNMPv3

snmp_port

Type:

port number

Default:

161

Minimum Value:

0

Maximum Value:

65535

SNMP port

snmp_community

Type:

string

Default:

public

SNMP community. Required for versions “v1” and “v2c”

snmp_security

Type:

string

Default:

<None>

SNMP security name. Required for version ‘v3’.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

Use irmc_snmp_user

snmp_polling_interval

Type:

integer

Default:

10

SNMP polling interval in seconds

snmp_auth_proto

Type:

string

Default:

sha

Valid Values:

sha, sha256, sha384, sha512

SNMPv3 message authentication protocol ID. Required for version ‘v3’. The valid options are ‘sha’, ‘sha256’, ‘sha384’ and ‘sha512’, while ‘sha’ is the only supported protocol in iRMC S4 and S5, and from iRMC S6, ‘sha256’, ‘sha384’ and ‘sha512’ are supported, but ‘sha’ is not supported any more.

Possible values

sha

Secure Hash Algorithm 1, supported in iRMC S4 and S5.

sha256

Secure Hash Algorithm 2 with 256 bits digest, only supported in iRMC S6.

sha384

Secure Hash Algorithm 2 with 384 bits digest, only supported in iRMC S6.

sha512

Secure Hash Algorithm 2 with 512 bits digest, only supported in iRMC S6.

snmp_priv_proto

Type:

string

Default:

aes

Valid Values:

aes

SNMPv3 message privacy (encryption) protocol ID. Required for version ‘v3’. ‘aes’ is supported.

Possible values

aes

Advanced Encryption Standard

clean_priority_restore_irmc_bios_config

Type:

integer

Default:

0

Priority for restore_irmc_bios_config clean step.

gpu_ids

Type:

list

Default:

[]

List of vendor IDs and device IDs for GPU device to inspect. List items are in format vendorID/deviceID and separated by commas. GPU inspection will use this value to count the number of GPU device in a node. If this option is not defined, then leave out pci_gpu_devices in capabilities property. Sample gpu_ids value: 0x1000/0x0079,0x2100/0x0080

fpga_ids

Type:

list

Default:

[]

List of vendor IDs and device IDs for CPU FPGA to inspect. List items are in format vendorID/deviceID and separated by commas. CPU inspection will use this value to find existence of CPU FPGA in a node. If this option is not defined, then leave out CUSTOM_CPU_FPGA in node traits. Sample fpga_ids value: 0x1000/0x0079,0x2100/0x0080

query_raid_config_fgi_status_interval

Type:

integer

Default:

300

Minimum Value:

1

Interval (in seconds) between periodic RAID status checks to determine whether the asynchronous RAID configuration was successfully finished or not. Foreground Initialization (FGI) will start 5 minutes after creating virtual drives.

kernel_append_params

Type:

string

Default:

nofb vga=normal

Mutable:

This option can be changed without restarting.

Additional kernel parameters to pass down to the instance kernel. These parameters can be consumed by the kernel or by the applications by reading /proc/cmdline. Mind severe cmdline size limit! Can be overridden by instance_info/kernel_append_params property.

ironic_lib

fatal_exception_format_errors

Type:

boolean

Default:

False

Used if there is a formatting error when generating an exception message (a programming error). If True, raise an exception; if False, use the unformatted message.

Deprecated Variations

Group	Name
DEFAULT	fatal_exception_format_errors

json_rpc

auth_strategy

Type:

string

Default:

<None>

Valid Values:

noauth, keystone, http_basic

Authentication strategy used by JSON RPC. Defaults to the global auth_strategy setting.

Possible values

noauth

no authentication

keystone

use the Identity service for authentication

http_basic

HTTP basic authentication

http_basic_auth_user_file

Type:

string

Default:

/etc/ironic/htpasswd-json-rpc

Path to Apache format user authentication file used when auth_strategy=http_basic

host_ip

Type:

host address

Default:

::

The IP address or hostname on which JSON RPC will listen.

port

Type:

port number

Default:

8089

Minimum Value:

0

Maximum Value:

65535

The port to use for JSON RPC

use_ssl

Type:

boolean

Default:

False

Whether to use TLS for JSON RPC

http_basic_username

Type:

string

Default:

<None>

Name of the user to use for HTTP Basic authentication client requests.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

Use username instead

http_basic_password

Type:

string

Default:

<None>

Password to use for HTTP Basic authentication client requests.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

Use password instead

allowed_roles

Type:

list

Default:

['admin']

List of roles allowed to use JSON RPC

unix_socket

Type:

string

Default:

<None>

Unix socket to listen on. Disables host_ip and port.

unix_socket_mode

Type:

unknown type

Default:

<None>

File mode (an octal number) of the unix socket to listen on. Ignored if unix_socket is not set.

auth_url

Type:

unknown type

Default:

<None>

Authentication URL

auth_type

Type:

unknown type

Default:

<None>

Authentication type to load

Deprecated Variations

Group	Name
json_rpc	auth_plugin

cafile

Type:

string

Default:

<None>

PEM encoded Certificate Authority to use when verifying HTTPs connections.

certfile

Type:

string

Default:

<None>

PEM encoded client certificate cert file

collect_timing

Type:

boolean

Default:

False

Collect per-API call timing information.

default_domain_id

Type:

unknown type

Default:

<None>

Optional domain ID to use with v3 and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

default_domain_name

Type:

unknown type

Default:

<None>

Optional domain name to use with v3 API and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

domain_id

Type:

unknown type

Default:

<None>

Domain ID to scope to

domain_name

Type:

unknown type

Default:

<None>

Domain name to scope to

insecure

Type:

boolean

Default:

False

Verify HTTPS connections.

keyfile

Type:

string

Default:

<None>

PEM encoded client certificate key file

password

Type:

unknown type

Default:

<None>

User’s password

project_domain_id

Type:

unknown type

Default:

<None>

Domain ID containing project

project_domain_name

Type:

unknown type

Default:

<None>

Domain name containing project

project_id

Type:

unknown type

Default:

<None>

Project ID to scope to

Deprecated Variations

Group	Name
json_rpc	tenant-id
json_rpc	tenant_id

project_name

Type:

unknown type

Default:

<None>

Project name to scope to

Deprecated Variations

Group	Name
json_rpc	tenant-name
json_rpc	tenant_name

split_loggers

Type:

boolean

Default:

False

Log requests to multiple loggers.

system_scope

Type:

unknown type

Default:

<None>

Scope for system operations

tenant_id

Type:

unknown type

Default:

<None>

Tenant ID

tenant_name

Type:

unknown type

Default:

<None>

Tenant Name

timeout

Type:

integer

Default:

<None>

Timeout value for http requests

trust_id

Type:

unknown type

Default:

<None>

ID of the trust to use as a trustee use

user_domain_id

Type:

unknown type

Default:

<None>

User’s domain id

user_domain_name

Type:

unknown type

Default:

<None>

User’s domain name

user_id

Type:

unknown type

Default:

<None>

User id

username

Type:

unknown type

Default:

<None>

Username

Deprecated Variations

Group	Name
json_rpc	user-name
json_rpc	user_name

keystone_authtoken

www_authenticate_uri

Type:

string

Default:

<None>

Complete “public” Identity API endpoint. This endpoint should not be an “admin” endpoint, as it should be accessible by all end users. Unauthenticated clients are redirected to this endpoint to authenticate. Although this endpoint should ideally be unversioned, client support in the wild varies. If you’re using a versioned v2 endpoint here, then this should not be the same endpoint the service user utilizes for validating tokens, because normal end users may not be able to reach that endpoint.

Deprecated Variations

Group	Name
keystone_authtoken	auth_uri

auth_uri

Type:

string

Default:

<None>

Complete “public” Identity API endpoint. This endpoint should not be an “admin” endpoint, as it should be accessible by all end users. Unauthenticated clients are redirected to this endpoint to authenticate. Although this endpoint should ideally be unversioned, client support in the wild varies. If you’re using a versioned v2 endpoint here, then this should not be the same endpoint the service user utilizes for validating tokens, because normal end users may not be able to reach that endpoint. This option is deprecated in favor of www_authenticate_uri and will be removed in the S release.

Warning

This option is deprecated for removal since Queens. Its value may be silently ignored in the future.

Reason:

The auth_uri option is deprecated in favor of www_authenticate_uri and will be removed in the S release.

auth_version

Type:

string

Default:

<None>

API version of the Identity API endpoint.

interface

Type:

string

Default:

internal

Interface to use for the Identity API endpoint. Valid values are “public”, “internal” (default) or “admin”.

delay_auth_decision

Type:

boolean

Default:

False

Do not handle authorization requests within the middleware, but delegate the authorization decision to downstream WSGI components.

http_connect_timeout

Type:

integer

Default:

<None>

Request timeout value for communicating with Identity API server.

http_request_max_retries

Type:

integer

Default:

3

How many times are we trying to reconnect when communicating with Identity API Server.

cache

Type:

string

Default:

<None>

Request environment key where the Swift cache object is stored. When auth_token middleware is deployed with a Swift cache, use this option to have the middleware share a caching backend with swift. Otherwise, use the memcached_servers option instead.

certfile

Type:

string

Default:

<None>

Required if identity server requires client certificate

keyfile

Type:

string

Default:

<None>

Required if identity server requires client certificate

cafile

Type:

string

Default:

<None>

A PEM encoded Certificate Authority to use when verifying HTTPs connections. Defaults to system CAs.

insecure

Type:

boolean

Default:

False

Verify HTTPS connections.

region_name

Type:

string

Default:

<None>

The region in which the identity server can be found.

memcached_servers

Type:

list

Default:

<None>

Optionally specify a list of memcached server(s) to use for caching. If left undefined, tokens will instead be cached in-process.

Deprecated Variations

Group	Name
keystone_authtoken	memcache_servers

token_cache_time

Type:

integer

Default:

300

In order to prevent excessive effort spent validating tokens, the middleware caches previously-seen tokens for a configurable duration (in seconds). Set to -1 to disable caching completely.

memcache_security_strategy

Type:

string

Default:

None

Valid Values:

None, MAC, ENCRYPT

(Optional) If defined, indicate whether token data should be authenticated or authenticated and encrypted. If MAC, token data is authenticated (with HMAC) in the cache. If ENCRYPT, token data is encrypted and authenticated in the cache. If the value is not one of these options or empty, auth_token will raise an exception on initialization.

memcache_secret_key

Type:

string

Default:

<None>

(Optional, mandatory if memcache_security_strategy is defined) This string is used for key derivation.

memcache_pool_dead_retry

Type:

integer

Default:

300

(Optional) Number of seconds memcached server is considered dead before it is tried again.

memcache_pool_maxsize

Type:

integer

Default:

10

(Optional) Maximum total number of open connections to every memcached server.

memcache_pool_socket_timeout

Type:

integer

Default:

3

(Optional) Socket timeout in seconds for communicating with a memcached server.

memcache_pool_unused_timeout

Type:

integer

Default:

60

(Optional) Number of seconds a connection to memcached is held unused in the pool before it is closed.

memcache_pool_conn_get_timeout

Type:

integer

Default:

10

(Optional) Number of seconds that an operation will wait to get a memcached client connection from the pool.

memcache_use_advanced_pool

Type:

boolean

Default:

True

(Optional) Use the advanced (eventlet safe) memcached client pool.

include_service_catalog

Type:

boolean

Default:

True

(Optional) Indicate whether to set the X-Service-Catalog header. If False, middleware will not ask for service catalog on token validation and will not set the X-Service-Catalog header.

enforce_token_bind

Type:

string

Default:

permissive

Used to control the use and type of token binding. Can be set to: “disabled” to not check token binding. “permissive” (default) to validate binding information if the bind type is of a form known to the server and ignore it if not. “strict” like “permissive” but if the bind type is unknown the token will be rejected. “required” any form of token binding is needed to be allowed. Finally the name of a binding method that must be present in tokens.

service_token_roles

Type:

list

Default:

['service']

A choice of roles that must be present in a service token. Service tokens are allowed to request that an expired token can be used and so this check should tightly control that only actual services should be sending this token. Roles here are applied as an ANY check so any role in this list must be present. For backwards compatibility reasons this currently only affects the allow_expired check.

service_token_roles_required

Type:

boolean

Default:

False

For backwards compatibility reasons we must let valid service tokens pass that don’t pass the service_token_roles check as valid. Setting this true will become the default in a future release and should be enabled if possible.

service_type

Type:

string

Default:

<None>

The name or type of the service as it appears in the service catalog. This is used to validate tokens that have restricted access rules.

auth_type

Type:

unknown type

Default:

<None>

Authentication type to load

Deprecated Variations

Group	Name
keystone_authtoken	auth_plugin

auth_section

Type:

unknown type

Default:

<None>

Config Section from which to load plugin specific options

mdns

registration_attempts

Type:

integer

Default:

5

Minimum Value:

1

Number of attempts to register a service. Currently has to be larger than 1 because of race conditions in the zeroconf library.

lookup_attempts

Type:

integer

Default:

3

Minimum Value:

1

Number of attempts to lookup a service.

params

Type:

unknown type

Default:

{}

Additional parameters to pass for the registered service.

interfaces

Type:

list

Default:

<None>

List of IP addresses of interfaces to use for mDNS. Defaults to all interfaces on the system.

metrics

backend

Type:

string

Default:

noop

Valid Values:

noop, statsd, collector

Backend to use for the metrics system.

Possible values

noop

Do nothing in relation to metrics.

statsd

Transmits metrics data to a statsd backend.

collector

Collects metrics data and saves it in memory for use by the running application.

prepend_host

Type:

boolean

Default:

False

Prepend the hostname to all metric names. The format of metric names is [global_prefix.][host_name.]prefix.metric_name.

prepend_host_reverse

Type:

boolean

Default:

True

Split the prepended host value by “.” and reverse it (to better match the reverse hierarchical form of domain names).

global_prefix

Type:

string

Default:

<None>

Prefix all metric names with this value. By default, there is no global prefix. The format of metric names is [global_prefix.][host_name.]prefix.metric_name.

agent_backend

Type:

string

Default:

noop

Backend for the agent ramdisk to use for metrics. Default possible backends are “noop” and “statsd”.

agent_prepend_host

Type:

boolean

Default:

False

Prepend the hostname to all metric names sent by the agent ramdisk. The format of metric names is [global_prefix.][uuid.][host_name.]prefix.metric_name.

agent_prepend_uuid

Type:

boolean

Default:

False

Prepend the node’s Ironic uuid to all metric names sent by the agent ramdisk. The format of metric names is [global_prefix.][uuid.][host_name.]prefix.metric_name.

agent_prepend_host_reverse

Type:

boolean

Default:

True

Split the prepended host value by “.” and reverse it for metrics sent by the agent ramdisk (to better match the reverse hierarchical form of domain names).

agent_global_prefix

Type:

string

Default:

<None>

Prefix all metric names sent by the agent ramdisk with this value. The format of metric names is [global_prefix.][uuid.][host_name.]prefix.metric_name.

metrics_statsd

statsd_host

Type:

string

Default:

localhost

Host for use with the statsd backend.

statsd_port

Type:

port number

Default:

8125

Minimum Value:

0

Maximum Value:

65535

Port to use with the statsd backend.

agent_statsd_host

Type:

string

Default:

localhost

Host for the agent ramdisk to use with the statsd backend. This must be accessible from networks the agent is booted on.

agent_statsd_port

Type:

port number

Default:

8125

Minimum Value:

0

Maximum Value:

65535

Port for the agent ramdisk to use with the statsd backend.

molds

storage

Type:

string

Default:

swift

Configuration mold storage location. Supports “swift” and “http”. By default “swift”.

user

Type:

string

Default:

<None>

User for “http” Basic auth. By default set empty.

password

Type:

string

Default:

<None>

Password for “http” Basic auth. By default set empty.

retry_attempts

Type:

integer

Default:

3

Retry attempts for saving or getting configuration molds.

retry_interval

Type:

integer

Default:

3

Retry interval for saving or getting configuration molds.

neutron

add_all_ports

Type:

boolean

Default:

False

Mutable:

This option can be changed without restarting.

Option to enable transmission of all ports to neutron when creating ports for provisioning, cleaning, or rescue. This is done without IP addresses assigned to the port, and may be useful in some bonded network configurations.

auth_url

Type:

unknown type

Default:

<None>

Authentication URL

auth_type

Type:

unknown type

Default:

<None>

Authentication type to load

Deprecated Variations

Group	Name
neutron	auth_plugin

cafile

Type:

string

Default:

<None>

PEM encoded Certificate Authority to use when verifying HTTPs connections.

certfile

Type:

string

Default:

<None>

PEM encoded client certificate cert file

cleaning_network

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

Neutron network UUID or name for the ramdisk to be booted into for cleaning nodes. Required for “neutron” network interface. It is also required if cleaning nodes when using “flat” network interface or “neutron” DHCP provider. If a name is provided, it must be unique among all networks or cleaning will fail.

Deprecated Variations

Group	Name
neutron	cleaning_network_uuid

cleaning_network_security_groups

Type:

list

Default:

[]

Mutable:

This option can be changed without restarting.

List of Neutron Security Group UUIDs to be applied during cleaning of the nodes. Optional for the “neutron” network interface and not used for the “flat” or “noop” network interfaces. If not specified, default security group is used.

collect_timing

Type:

boolean

Default:

False

Collect per-API call timing information.

connect_retries

Type:

integer

Default:

<None>

The maximum number of retries that should be attempted for connection errors.

connect_retry_delay

Type:

floating point

Default:

<None>

Delay (in seconds) between two retries for connection errors. If not set, exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is used.

default_domain_id

Type:

unknown type

Default:

<None>

Optional domain ID to use with v3 and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

default_domain_name

Type:

unknown type

Default:

<None>

Optional domain name to use with v3 API and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

dhcpv6_stateful_address_count

Type:

integer

Default:

4

Mutable:

This option can be changed without restarting.

Number of IPv6 addresses to allocate for ports created for provisioning, cleaning, rescue or inspection on DHCPv6-stateful networks. Different stages of the chain-loading process will request addresses with different CLID/IAID. Due to non-identical identifiers multiple addresses must be reserved for the host to ensure each step of the boot process can successfully lease addresses.

domain_id

Type:

unknown type

Default:

<None>

Domain ID to scope to

domain_name

Type:

unknown type

Default:

<None>

Domain name to scope to

endpoint_override

Type:

string

Default:

<None>

Always use this endpoint URL for requests for this client. NOTE: The unversioned endpoint should be specified here; to request a particular API version, use the version, min-version, and/or max-version options.

insecure

Type:

boolean

Default:

False

Verify HTTPS connections.

inspection_network

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

Neutron network UUID or name for the ramdisk to be booted into for in-band inspection of nodes. If a name is provided, it must be unique among all networks or inspection will fail.

inspection_network_security_groups

Type:

list

Default:

[]

Mutable:

This option can be changed without restarting.

List of Neutron Security Group UUIDs to be applied during the node inspection process. Optional for the “neutron” network interface and not used for the “flat” or “noop” network interfaces. If not specified, the default security group is used.

keyfile

Type:

string

Default:

<None>

PEM encoded client certificate key file

max_version

Type:

string

Default:

<None>

The maximum major version of a given API, intended to be used as the upper bound of a range with min_version. Mutually exclusive with version.

min_version

Type:

string

Default:

<None>

The minimum major version of a given API, intended to be used as the lower bound of a range with max_version. Mutually exclusive with version. If min_version is given with no max_version it is as if max version is “latest”.

password

Type:

unknown type

Default:

<None>

User’s password

port_setup_delay

Type:

integer

Default:

0

Minimum Value:

0

Mutable:

This option can be changed without restarting.

Delay value to wait for Neutron agents to setup sufficient DHCP configuration for port.

project_domain_id

Type:

unknown type

Default:

<None>

Domain ID containing project

project_domain_name

Type:

unknown type

Default:

<None>

Domain name containing project

project_id

Type:

unknown type

Default:

<None>

Project ID to scope to

Deprecated Variations

Group	Name
neutron	tenant-id
neutron	tenant_id

project_name

Type:

unknown type

Default:

<None>

Project name to scope to

Deprecated Variations

Group	Name
neutron	tenant-name
neutron	tenant_name

provisioning_network

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

Neutron network UUID or name for the ramdisk to be booted into for provisioning nodes. Required for “neutron” network interface. If a name is provided, it must be unique among all networks or deploy will fail.

Deprecated Variations

Group	Name
neutron	provisioning_network_uuid

provisioning_network_security_groups

Type:

list

Default:

[]

Mutable:

This option can be changed without restarting.

List of Neutron Security Group UUIDs to be applied during provisioning of the nodes. Optional for the “neutron” network interface and not used for the “flat” or “noop” network interfaces. If not specified, default security group is used.

region_name

Type:

string

Default:

<None>

The default region_name for endpoint URL discovery.

request_timeout

Type:

integer

Default:

45

Mutable:

This option can be changed without restarting.

Timeout for request processing when interacting with Neutron. This value should be increased if neutron port action timeouts are observed as neutron performs pre-commit validation prior returning to the API client which can take longer than normal client/server interactions.

rescuing_network

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

Neutron network UUID or name for booting the ramdisk for rescue mode. This is not the network that the rescue ramdisk will use post-boot – the tenant network is used for that. Required for “neutron” network interface, if rescue mode will be used. It is not used for the “flat” or “noop” network interfaces. If a name is provided, it must be unique among all networks or rescue will fail.

rescuing_network_security_groups

Type:

list

Default:

[]

Mutable:

This option can be changed without restarting.

List of Neutron Security Group UUIDs to be applied during the node rescue process. Optional for the “neutron” network interface and not used for the “flat” or “noop” network interfaces. If not specified, the default security group is used.

retriable_status_codes

Type:

list

Default:

<None>

List of retriable HTTP status codes that should be retried. If not set default to [503]

retries

Type:

integer

Default:

3

Mutable:

This option can be changed without restarting.

DEPRECATED: Client retries in the case of a failed request.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

Replaced by status_code_retries and status_code_retry_delay.

service_name

Type:

string

Default:

<None>

The default service_name for endpoint URL discovery.

service_type

Type:

string

Default:

network

The default service_type for endpoint URL discovery.

servicing_network

Type:

string

Default:

<None>

Mutable:

This option can be changed without restarting.

Neutron network UUID or name for booting the ramdisk for service mode. Required for “neutron” network interface, if service mode will be used. It is not used for the “flat” or “noop” network interfaces. If a name is provided, it must be unique among all networks or service will fail.

servicing_network_security_groups

Type:

list

Default:

[]

Mutable:

This option can be changed without restarting.

List of Neutron Security Group UUIDs to be applied during the node service process. Optional for the “neutron” network interface and not used for the “flat” or “noop” network interfaces. If not specified, the default security group is used.

split_loggers

Type:

boolean

Default:

False

Log requests to multiple loggers.

status_code_retries

Type:

integer

Default:

<None>

The maximum number of retries that should be attempted for retriable HTTP status codes.

status_code_retry_delay

Type:

floating point

Default:

<None>

Delay (in seconds) between two retries for retriable status codes. If not set, exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is used.

system_scope

Type:

unknown type

Default:

<None>

Scope for system operations

tenant_id

Type:

unknown type

Default:

<None>

Tenant ID

tenant_name

Type:

unknown type

Default:

<None>

Tenant Name

timeout

Type:

integer

Default:

<None>

Timeout value for http requests

trust_id

Type:

unknown type

Default:

<None>

ID of the trust to use as a trustee use

user_domain_id

Type:

unknown type

Default:

<None>

User’s domain id

user_domain_name

Type:

unknown type

Default:

<None>

User’s domain name

user_id

Type:

unknown type

Default:

<None>

User id

username

Type:

unknown type

Default:

<None>

Username

Deprecated Variations

Group	Name
neutron	user-name
neutron	user_name

valid_interfaces

Type:

list

Default:

['internal', 'public']

List of interfaces, in order of preference, for endpoint URL.

version

Type:

string

Default:

<None>

Minimum Major API version within a given Major API version for endpoint URL discovery. Mutually exclusive with min_version and max_version

nova

auth_url

Type:

unknown type

Default:

<None>

Authentication URL

auth_type

Type:

unknown type

Default:

<None>

Authentication type to load

Deprecated Variations

Group	Name
nova	auth_plugin

cafile

Type:

string

Default:

<None>

PEM encoded Certificate Authority to use when verifying HTTPs connections.

certfile

Type:

string

Default:

<None>

PEM encoded client certificate cert file

collect_timing

Type:

boolean

Default:

False

Collect per-API call timing information.

connect_retries

Type:

integer

Default:

<None>

The maximum number of retries that should be attempted for connection errors.

connect_retry_delay

Type:

floating point

Default:

<None>

Delay (in seconds) between two retries for connection errors. If not set, exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is used.

default_domain_id

Type:

unknown type

Default:

<None>

Optional domain ID to use with v3 and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

default_domain_name

Type:

unknown type

Default:

<None>

Optional domain name to use with v3 API and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

domain_id

Type:

unknown type

Default:

<None>

Domain ID to scope to

domain_name

Type:

unknown type

Default:

<None>

Domain name to scope to

endpoint_override

Type:

string

Default:

<None>

Always use this endpoint URL for requests for this client. NOTE: The unversioned endpoint should be specified here; to request a particular API version, use the version, min-version, and/or max-version options.

insecure

Type:

boolean

Default:

False

Verify HTTPS connections.

keyfile

Type:

string

Default:

<None>

PEM encoded client certificate key file

max_version

Type:

string

Default:

<None>

The maximum major version of a given API, intended to be used as the upper bound of a range with min_version. Mutually exclusive with version.

min_version

Type:

string

Default:

<None>

The minimum major version of a given API, intended to be used as the lower bound of a range with max_version. Mutually exclusive with version. If min_version is given with no max_version it is as if max version is “latest”.

password

Type:

unknown type

Default:

<None>

User’s password

project_domain_id

Type:

unknown type

Default:

<None>

Domain ID containing project

project_domain_name

Type:

unknown type

Default:

<None>

Domain name containing project

project_id

Type:

unknown type

Default:

<None>

Project ID to scope to

Deprecated Variations

Group	Name
nova	tenant-id
nova	tenant_id

project_name

Type:

unknown type

Default:

<None>

Project name to scope to

Deprecated Variations

Group	Name
nova	tenant-name
nova	tenant_name

region_name

Type:

string

Default:

<None>

The default region_name for endpoint URL discovery.

retriable_status_codes

Type:

list

Default:

<None>

List of retriable HTTP status codes that should be retried. If not set default to [503]

send_power_notifications

Type:

boolean

Default:

True

Mutable:

This option can be changed without restarting.

When set to True, it will enable the support for power state change callbacks to nova. This option should be set to False in deployments that do not have the openstack compute service.

service_name

Type:

string

Default:

<None>

The default service_name for endpoint URL discovery.

service_type

Type:

string

Default:

compute

The default service_type for endpoint URL discovery.

split_loggers

Type:

boolean

Default:

False

Log requests to multiple loggers.

status_code_retries

Type:

integer

Default:

<None>

The maximum number of retries that should be attempted for retriable HTTP status codes.

status_code_retry_delay

Type:

floating point

Default:

<None>

Delay (in seconds) between two retries for retriable status codes. If not set, exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is used.

system_scope

Type:

unknown type

Default:

<None>

Scope for system operations

tenant_id

Type:

unknown type

Default:

<None>

Tenant ID

tenant_name

Type:

unknown type

Default:

<None>

Tenant Name

timeout

Type:

integer

Default:

<None>

Timeout value for http requests

trust_id

Type:

unknown type

Default:

<None>

ID of the trust to use as a trustee use

user_domain_id

Type:

unknown type

Default:

<None>

User’s domain id

user_domain_name

Type:

unknown type

Default:

<None>

User’s domain name

user_id

Type:

unknown type

Default:

<None>

User id

username

Type:

unknown type

Default:

<None>

Username

Deprecated Variations

Group	Name
nova	user-name
nova	user_name

valid_interfaces

Type:

list

Default:

['internal', 'public']

List of interfaces, in order of preference, for endpoint URL.

version

Type:

string

Default:

<None>

Minimum Major API version within a given Major API version for endpoint URL discovery. Mutually exclusive with min_version and max_version

oslo_concurrency

disable_process_locking

Type:

boolean

Default:

False

Enables or disables inter-process locks.

lock_path

Type:

string

Default:

<None>

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_kafka

kafka_max_fetch_bytes

Type:

integer

Default:

1048576

Max fetch bytes of Kafka consumer

kafka_consumer_timeout

Type:

floating point

Default:

1.0

Default timeout(s) for Kafka consumers

pool_size

Type:

integer

Default:

10

Pool Size for Kafka Consumers

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

Driver no longer uses connection pool.

conn_pool_min_size

Type:

integer

Default:

2

The pool size limit for connections expiration policy

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

Driver no longer uses connection pool.

conn_pool_ttl

Type:

integer

Default:

1200

The time-to-live in sec of idle connections in the pool

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

Driver no longer uses connection pool.

consumer_group

Type:

string

Default:

oslo_messaging_consumer

Group id for Kafka consumer. Consumers in one group will coordinate message consumption

producer_batch_timeout

Type:

floating point

Default:

0.0

Upper bound on the delay for KafkaProducer batching in seconds

producer_batch_size

Type:

integer

Default:

16384

Size of batch for the producer async send

compression_codec

Type:

string

Default:

none

Valid Values:

none, gzip, snappy, lz4, zstd

The compression codec for all data generated by the producer. If not set, compression will not be used. Note that the allowed values of this depend on the kafka version

enable_auto_commit

Type:

boolean

Default:

False

Enable asynchronous consumer commits

max_poll_records

Type:

integer

Default:

500

The maximum number of records returned in a poll call

security_protocol

Type:

string

Default:

PLAINTEXT

Valid Values:

PLAINTEXT, SASL_PLAINTEXT, SSL, SASL_SSL

Protocol used to communicate with brokers

sasl_mechanism

Type:

string

Default:

PLAIN

Mechanism when security protocol is SASL

ssl_cafile

Type:

string

Default:

''

CA certificate PEM file used to verify the server certificate

ssl_client_cert_file

Type:

string

Default:

''

Client certificate PEM file used for authentication.

ssl_client_key_file

Type:

string

Default:

''

Client key PEM file used for authentication.

ssl_client_key_password

Type:

string

Default:

''

Client key password file used for authentication.

oslo_messaging_notifications

driver

Type:

multi-valued

Default:

''

The Drivers(s) to handle sending notifications. Possible values are messaging, messagingv2, routing, log, test, noop

Deprecated Variations

Group	Name
DEFAULT	notification_driver

transport_url

Type:

string

Default:

<None>

A URL representing the messaging driver to use for notifications. If not set, we fall back to the same configuration used for RPC.

Deprecated Variations

Group	Name
DEFAULT	notification_transport_url

topics

Type:

list

Default:

['notifications']

AMQP topic used for OpenStack notifications.

Deprecated Variations

Group	Name
rpc_notifier2	topics
DEFAULT	notification_topics

retry

Type:

integer

Default:

-1

The maximum number of attempts to re-send a notification message which failed to be delivered due to a recoverable error. 0 - No retry, -1 - indefinite

oslo_messaging_rabbit

amqp_durable_queues

Type:

boolean

Default:

False

Use durable queues in AMQP. If rabbit_quorum_queue is enabled, queues will be durable and this value will be ignored.

amqp_auto_delete

Type:

boolean

Default:

False

Auto-delete queues in AMQP.

Deprecated Variations

Group	Name
DEFAULT	amqp_auto_delete

ssl

Type:

boolean

Default:

False

Connect over SSL.

Deprecated Variations

Group	Name
oslo_messaging_rabbit	rabbit_use_ssl

ssl_version

Type:

string

Default:

''

SSL version to use (valid only if SSL enabled). Valid values are TLSv1 and SSLv23. SSLv2, SSLv3, TLSv1_1, and TLSv1_2 may be available on some distributions.

Deprecated Variations

Group	Name
oslo_messaging_rabbit	kombu_ssl_version

ssl_key_file

Type:

string

Default:

''

SSL key file (valid only if SSL enabled).

Deprecated Variations

Group	Name
oslo_messaging_rabbit	kombu_ssl_keyfile

ssl_cert_file

Type:

string

Default:

''

SSL cert file (valid only if SSL enabled).

Deprecated Variations

Group	Name
oslo_messaging_rabbit	kombu_ssl_certfile

ssl_ca_file

Type:

string

Default:

''

SSL certification authority file (valid only if SSL enabled).

Deprecated Variations

Group	Name
oslo_messaging_rabbit	kombu_ssl_ca_certs

ssl_enforce_fips_mode

Type:

boolean

Default:

False

Global toggle for enforcing the OpenSSL FIPS mode. This feature requires Python support. This is available in Python 3.9 in all environments and may have been backported to older Python versions on select environments. If the Python executable used does not support OpenSSL FIPS mode, an exception will be raised.

heartbeat_in_pthread

Type:

boolean

Default:

False

(DEPRECATED) It is recommend not to use this option anymore. Run the health check heartbeat thread through a native python thread by default. If this option is equal to False then the health check heartbeat will inherit the execution model from the parent process. For example if the parent process has monkey patched the stdlib by using eventlet/greenlet then the heartbeat will be run through a green thread. This option should be set to True only for the wsgi services.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

The option is related to Eventlet which will be removed. In addition this has never worked as expected with services using eventlet for core service framework.

kombu_reconnect_delay

Type:

floating point

Default:

1.0

Minimum Value:

0.0

Maximum Value:

4.5

How long to wait (in seconds) before reconnecting in response to an AMQP consumer cancel notification.

Deprecated Variations

Group	Name
DEFAULT	kombu_reconnect_delay

kombu_compression

Type:

string

Default:

<None>

EXPERIMENTAL: Possible values are: gzip, bz2. If not set compression will not be used. This option may not be available in future versions.

kombu_missing_consumer_retry_timeout

Type:

integer

Default:

60

How long to wait a missing client before abandoning to send it its replies. This value should not be longer than rpc_response_timeout.

Deprecated Variations

Group	Name
oslo_messaging_rabbit	kombu_reconnect_timeout

kombu_failover_strategy

Type:

string

Default:

round-robin

Valid Values:

round-robin, shuffle

Determines how the next RabbitMQ node is chosen in case the one we are currently connected to becomes unavailable. Takes effect only if more than one RabbitMQ node is provided in config.

rabbit_login_method

Type:

string

Default:

AMQPLAIN

Valid Values:

PLAIN, AMQPLAIN, EXTERNAL, RABBIT-CR-DEMO

The RabbitMQ login method.

Deprecated Variations

Group	Name
DEFAULT	rabbit_login_method

rabbit_retry_interval

Type:

integer

Default:

1

How frequently to retry connecting with RabbitMQ.

rabbit_retry_backoff

Type:

integer

Default:

2

How long to backoff for between retries when connecting to RabbitMQ.

Deprecated Variations

Group	Name
DEFAULT	rabbit_retry_backoff

rabbit_interval_max

Type:

integer

Default:

30

Maximum interval of RabbitMQ connection retries. Default is 30 seconds.

rabbit_ha_queues

Type:

boolean

Default:

False

Try to use HA queues in RabbitMQ (x-ha-policy: all). If you change this option, you must wipe the RabbitMQ database. In RabbitMQ 3.0, queue mirroring is no longer controlled by the x-ha-policy argument when declaring a queue. If you just want to make sure that all queues (except those with auto-generated names) are mirrored across all nodes, run: “rabbitmqctl set_policy HA ‘^(?!amq.).*’ ‘{“ha-mode”: “all”}’ “

Deprecated Variations

Group	Name
DEFAULT	rabbit_ha_queues

rabbit_quorum_queue

Type:

boolean

Default:

False

Use quorum queues in RabbitMQ (x-queue-type: quorum). The quorum queue is a modern queue type for RabbitMQ implementing a durable, replicated FIFO queue based on the Raft consensus algorithm. It is available as of RabbitMQ 3.8.0. If set this option will conflict with the HA queues (rabbit_ha_queues) aka mirrored queues, in other words the HA queues should be disabled. Quorum queues are also durable by default so the amqp_durable_queues option is ignored when this option is enabled.

rabbit_transient_quorum_queue

Type:

boolean

Default:

False

Use quorum queues for transients queues in RabbitMQ. Enabling this option will then make sure those queues are also using quorum kind of rabbit queues, which are HA by default.

rabbit_quorum_delivery_limit

Type:

integer

Default:

0

Each time a message is redelivered to a consumer, a counter is incremented. Once the redelivery count exceeds the delivery limit the message gets dropped or dead-lettered (if a DLX exchange has been configured) Used only when rabbit_quorum_queue is enabled, Default 0 which means dont set a limit.

rabbit_quorum_max_memory_length

Type:

integer

Default:

0

By default all messages are maintained in memory if a quorum queue grows in length it can put memory pressure on a cluster. This option can limit the number of messages in the quorum queue. Used only when rabbit_quorum_queue is enabled, Default 0 which means dont set a limit.

Deprecated Variations

Group	Name
oslo_messaging_rabbit	rabbit_quroum_max_memory_length

rabbit_quorum_max_memory_bytes

Type:

integer

Default:

0

By default all messages are maintained in memory if a quorum queue grows in length it can put memory pressure on a cluster. This option can limit the number of memory bytes used by the quorum queue. Used only when rabbit_quorum_queue is enabled, Default 0 which means dont set a limit.

Deprecated Variations

Group	Name
oslo_messaging_rabbit	rabbit_quroum_max_memory_bytes

rabbit_transient_queues_ttl

Type:

integer

Default:

1800

Minimum Value:

0

Positive integer representing duration in seconds for queue TTL (x-expires). Queues which are unused for the duration of the TTL are automatically deleted. The parameter affects only reply and fanout queues. Setting 0 as value will disable the x-expires. If doing so, make sure you have a rabbitmq policy to delete the queues or you deployment will create an infinite number of queue over time.In case rabbit_stream_fanout is set to True, this option will control data retention policy (x-max-age) for messages in the fanout queue rather then the queue duration itself. So the oldest data in the stream queue will be discarded from it once reaching TTL Setting to 0 will disable x-max-age for stream which make stream grow indefinitely filling up the diskspace

rabbit_qos_prefetch_count

Type:

integer

Default:

0

Specifies the number of messages to prefetch. Setting to zero allows unlimited messages.

heartbeat_timeout_threshold

Type:

integer

Default:

60

Number of seconds after which the Rabbit broker is considered down if heartbeat’s keep-alive fails (0 disables heartbeat).

heartbeat_rate

Type:

integer

Default:

3

How often times during the heartbeat_timeout_threshold we check the heartbeat.

direct_mandatory_flag

Type:

boolean

Default:

True

(DEPRECATED) Enable/Disable the RabbitMQ mandatory flag for direct send. The direct send is used as reply, so the MessageUndeliverable exception is raised in case the client queue does not exist.MessageUndeliverable exception will be used to loop for a timeout to lets a chance to sender to recover.This flag is deprecated and it will not be possible to deactivate this functionality anymore

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

Mandatory flag no longer deactivable.

enable_cancel_on_failover

Type:

boolean

Default:

False

Enable x-cancel-on-ha-failover flag so that rabbitmq server will cancel and notify consumerswhen queue is down

use_queue_manager

Type:

boolean

Default:

False

Should we use consistant queue names or random ones

hostname

Type:

string

Default:

node1.example.com

This option has a sample default set, which means that its actual default value may vary from the one documented above.

Hostname used by queue manager. Defaults to the value returned by socket.gethostname().

processname

Type:

string

Default:

nova-api

This option has a sample default set, which means that its actual default value may vary from the one documented above.

Process name used by queue manager

rabbit_stream_fanout

Type:

boolean

Default:

False

Use stream queues in RabbitMQ (x-queue-type: stream). Streams are a new persistent and replicated data structure (“queue type”) in RabbitMQ which models an append-only log with non-destructive consumer semantics. It is available as of RabbitMQ 3.9.0. If set this option will replace all fanout queues with only one stream queue.

oslo_middleware

enable_proxy_headers_parsing

Type:

boolean

Default:

False

Whether the application is behind a proxy or not. This determines if the middleware should parse the headers or not.

oslo_policy

enforce_scope

Type:

boolean

Default:

True

This option controls whether or not to enforce scope when evaluating policies. If True, the scope of the token used in the request is compared to the scope_types of the policy being enforced. If the scopes do not match, an InvalidScope exception will be raised. If False, a message will be logged informing operators that policies are being invoked with mismatching scope.

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

Reason:

This configuration was added temporarily to facilitate a smooth transition to the new RBAC. OpenStack will always enforce scope checks. This configuration option is deprecated and will be removed in the 2025.2 cycle.

enforce_new_defaults

Type:

boolean

Default:

True

This option controls whether or not to use old deprecated defaults when evaluating policies. If True, the old deprecated defaults are not going to be evaluated. This means if any existing token is allowed for old defaults but is disallowed for new defaults, it will be disallowed. It is encouraged to enable this flag along with the enforce_scope flag so that you can get the benefits of new defaults and scope_type together. If False, the deprecated policy check string is logically OR’d with the new policy check string, allowing for a graceful upgrade experience between releases with new policies, which is the default behavior.

policy_file

Type:

string

Default:

policy.yaml

The relative or absolute path of a file that maps roles to permissions for a given service. Relative paths must be specified in relation to the configuration file setting this option.

policy_default_rule

Type:

string

Default:

default

Default rule. Enforced when a requested rule is not found.

policy_dirs

Type:

multi-valued

Default:

policy.d

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.

remote_content_type

Type:

string

Default:

application/x-www-form-urlencoded

Valid Values:

application/x-www-form-urlencoded, application/json

Content Type to send and receive data for REST based policy check

remote_ssl_verify_server_crt

Type:

boolean

Default:

False

server identity verification for REST based policy check

remote_ssl_ca_crt_file

Type:

string

Default:

<None>

Absolute path to ca cert file for REST based policy check

remote_ssl_client_crt_file

Type:

string

Default:

<None>

Absolute path to client cert for REST based policy check

remote_ssl_client_key_file

Type:

string

Default:

<None>

Absolute path client key file REST based policy check

remote_timeout

Type:

floating point

Default:

60

Minimum Value:

0

Timeout in seconds for REST based policy check

oslo_versionedobjects

fatal_exception_format_errors

Type:

boolean

Default:

False

Make exception message format errors fatal

profiler

enabled

Type:

boolean

Default:

False

Enable the profiling for all services on this node.

Default value is False (fully disable the profiling feature).

Possible values:

• True: Enables the feature

• False: Disables the feature. The profiling cannot be started via this project operations. If the profiling is triggered by another project, this project part will be empty.

Deprecated Variations

Group	Name
profiler	profiler_enabled

trace_sqlalchemy

Type:

boolean

Default:

False

Enable SQL requests profiling in services.

Default value is False (SQL requests won’t be traced).

Possible values:

• True: Enables SQL requests profiling. Each SQL query will be part of the trace and can the be analyzed by how much time was spent for that.

• False: Disables SQL requests profiling. The spent time is only shown on a higher level of operations. Single SQL queries cannot be analyzed this way.

trace_requests

Type:

boolean

Default:

False

Enable python requests package profiling.

Supported drivers: jaeger+otlp

Default value is False.

Possible values:

• True: Enables requests profiling.

• False: Disables requests profiling.

hmac_keys

Type:

string

Default:

SECRET_KEY

Secret key(s) to use for encrypting context data for performance profiling.

This string value should have the following format: <key1>[,<key2>,…<keyn>], where each key is some random string. A user who triggers the profiling via the REST API has to set one of these keys in the headers of the REST API call to include profiling results of this node for this particular project.

Both “enabled” flag and “hmac_keys” config options should be set to enable profiling. Also, to generate correct profiling information across all services at least one key needs to be consistent between OpenStack projects. This ensures it can be used from client side to generate the trace, containing information from all possible resources.

connection_string

Type:

string

Default:

messaging://

Connection string for a notifier backend.

Default value is messaging:// which sets the notifier to oslo_messaging.

Examples of possible values:

• messaging:// - use oslo_messaging driver for sending spans.

• redis://127.0.0.1:6379 - use redis driver for sending spans.

• mongodb://127.0.0.1:27017 - use mongodb driver for sending spans.

• elasticsearch://127.0.0.1:9200 - use elasticsearch driver for sending spans.

• jaeger://127.0.0.1:6831 - use jaeger tracing as driver for sending spans.

es_doc_type

Type:

string

Default:

notification

Document type for notification indexing in elasticsearch.

es_scroll_time

Type:

string

Default:

2m

This parameter is a time value parameter (for example: es_scroll_time=2m), indicating for how long the nodes that participate in the search will maintain relevant resources in order to continue and support it.

es_scroll_size

Type:

integer

Default:

10000

Elasticsearch splits large requests in batches. This parameter defines maximum size of each batch (for example: es_scroll_size=10000).

socket_timeout

Type:

floating point

Default:

0.1

Redissentinel provides a timeout option on the connections. This parameter defines that timeout (for example: socket_timeout=0.1).

sentinel_service_name

Type:

string

Default:

mymaster

Redissentinel uses a service name to identify a master redis service. This parameter defines the name (for example: sentinal_service_name=mymaster).

filter_error_trace

Type:

boolean

Default:

False

Enable filter traces that contain error/exception to a separated place.

Default value is set to False.

Possible values:

• True: Enable filter traces that contain error/exception.

• False: Disable the filter.

profiler_jaeger

service_name_prefix

Type:

string

Default:

<None>

Set service name prefix to Jaeger service name.

process_tags

Type:

dict

Default:

{}

Set process tracer tags.

profiler_otlp

service_name_prefix

Type:

string

Default:

<None>

Set service name prefix to OTLP exporters.

pxe

kernel_append_params

Type:

string

Default:

nofb vga=normal

Mutable:

This option can be changed without restarting.

Additional append parameters for baremetal PXE boot.

Deprecated Variations

Group	Name
pxe	pxe_append_params

default_ephemeral_format

Type:

string

Default:

ext4

Mutable:

This option can be changed without restarting.

Default file system format for ephemeral partition, if one is created.

images_path

Type:

string

Default:

/var/lib/ironic/images/

On the ironic-conductor node, directory where images are stored on disk.

instance_master_path

Type:

string

Default:

/var/lib/ironic/master_images

On the ironic-conductor node, directory where master instance images are stored on disk. Setting to the empty string disables image caching.

image_cache_size

Type:

integer

Default:

20480

Maximum size (in MiB) of cache for master images, including those in use.

image_cache_ttl

Type:

integer

Default:

10080

Maximum TTL (in minutes) for old master images in cache.

pxe_config_template

Type:

string

Default:

$pybasedir/drivers/modules/pxe_config.template

Mutable:

This option can be changed without restarting.

On ironic-conductor node, template file for PXE loader configuration.

ipxe_config_template

Type:

string

Default:

$pybasedir/drivers/modules/ipxe_config.template

Mutable:

This option can be changed without restarting.

On ironic-conductor node, template file for iPXE operations.

uefi_pxe_config_template

Type:

string

Default:

$pybasedir/drivers/modules/pxe_grub_config.template

Mutable:

This option can be changed without restarting.

On ironic-conductor node, template file for PXE configuration for UEFI boot loader. Generally this is used for GRUB specific templates.

pxe_config_template_by_arch

Type:

dict

Default:

{}

Mutable:

This option can be changed without restarting.

On ironic-conductor node, template file for PXE configuration per node architecture. For example: aarch64:/opt/share/grubaa64_pxe_config.template

tftp_server

Type:

string

Default:

$my_ip

IP address of ironic-conductor node’s TFTP server.

tftp_root

Type:

string

Default:

/tftpboot

ironic-conductor node’s TFTP root path. The ironic-conductor must have read/write access to this path.

tftp_master_path

Type:

string

Default:

/tftpboot/master_images

On ironic-conductor node, directory where master TFTP images are stored on disk. Setting to the empty string disables image caching.

dir_permission

Type:

integer

Default:

<None>

The permission that will be applied to the TFTP folders upon creation. This should be set to the permission such that the tftpserver has access to read the contents of the configured TFTP folder. This setting is only required when the operating system’s umask is restrictive such that ironic-conductor is creating files that cannot be read by the TFTP server. Setting to <None> will result in the operating system’s umask to be utilized for the creation of new tftp folders. The system default umask is masked out on the specified value. It is required that an octal representation is specified. For example: 0o755

file_permission

Type:

integer

Default:

420

The permission which is used on files created as part of configuration and setup of file assets for PXE based operations. Defaults to a value of 0o644. This value must be specified as an octal representation. For example: 0o644

pxe_bootfile_name

Type:

string

Default:

pxelinux.0

Bootfile DHCP parameter.

pxe_config_subdir

Type:

string

Default:

pxelinux.cfg

Directory in which to create symbolic links which represent the MAC or IP address of the ports on a node and allow boot loaders to load the PXE file for the node. This directory name is relative to the PXE or iPXE folders.

uefi_pxe_bootfile_name

Type:

string

Default:

bootx64.efi

Bootfile DHCP parameter for UEFI boot mode.

ipxe_bootfile_name

Type:

string

Default:

undionly.kpxe

Bootfile DHCP parameter.

uefi_ipxe_bootfile_name

Type:

string

Default:

snponly.efi

Bootfile DHCP parameter for UEFI boot mode. If you experience problems with booting using it, try ipxe.efi.

pxe_bootfile_name_by_arch

Type:

dict

Default:

{}

Bootfile DHCP parameter per node architecture. For example: aarch64:grubaa64.efi

ipxe_bootfile_name_by_arch

Type:

dict

Default:

{}

Bootfile DHCP parameter per node architecture. For example: aarch64:ipxe_aa64.efi

ipxe_boot_script

Type:

string

Default:

$pybasedir/drivers/modules/boot.ipxe

On ironic-conductor node, the path to the main iPXE script file.

ipxe_fallback_script

Type:

string

Default:

<None>

File name (e.g. inspector.ipxe) of an iPXE script to fall back to when booting to a MAC-specific script fails. When not set, booting will fail in this case.

ipxe_timeout

Type:

integer

Default:

0

Timeout value (in seconds) for downloading an image via iPXE. Defaults to 0 (no timeout)

boot_retry_timeout

Type:

integer

Default:

<None>

Minimum Value:

60

Timeout (in seconds) after which PXE boot should be retried. Must be less than [conductor]deploy_callback_timeout. Disabled by default.

boot_retry_check_interval

Type:

integer

Default:

90

Minimum Value:

1

Interval (in seconds) between periodic checks on PXE boot retry. Has no effect if boot_retry_timeout is not set.

ip_version

Type:

string

Default:

4

Valid Values:

4, 6

Mutable:

This option can be changed without restarting.

The IP version that will be used for PXE booting. Defaults to 4. This option has been a no-op for in-treedrivers since the Ussuri development cycle.

Possible values

4

IPv4

6

IPv6

Warning

This option is deprecated for removal. Its value may be silently ignored in the future.

ipxe_use_swift

Type:

boolean

Default:

False

Mutable:

This option can be changed without restarting.

Download deploy and rescue images directly from swift using temporary URLs. If set to false (default), images are downloaded to the ironic-conductor node and served over its local HTTP server. Applicable only when ‘ipxe’ compatible boot interface is used.

enable_netboot_fallback

Type:

boolean

Default:

False

Mutable:

This option can be changed without restarting.

If True, generate a PXE environment even for nodes that use local boot. This is useful when the driver cannot switch nodes to local boot, e.g. with SNMP or with Redfish on machines that cannot do persistent boot. Mostly useful for standalone ironic since Neutron will prevent incorrect PXE boot.

loader_file_paths

Type:

unknown type

Default:

{}

Dictionary describing the bootloaders to load into conductor PXE/iPXE boot folders values from the host operating system. Formatted as key of destination file name, and value of a full path to a file to be copied. File assets will have [pxe]file_permission applied, if set. If used, the file names should match established bootloader configuration settings for bootloaders. Use example: ipxe.efi:/usr/share/ipxe/ipxe-snponly-x86_64.efi,undionly.kpxe:/usr/share/ipxe/undionly.kpxe

initial_grub_template

Type:

string

Default:

$pybasedir/drivers/modules/initial_grub_cfg.template

On ironic-conductor node, the path to the initial grubconfiguration template for grub network boot.

redfish

connection_attempts

Type:

integer

Default:

5

Minimum Value:

1

Maximum number of attempts to try to connect to Redfish

connection_retry_interval

Type:

integer

Default:

4

Minimum Value:

1

Number of seconds to wait between attempts to connect to Redfish

connection_cache_size

Type:

integer

Default:

1000

Minimum Value:

0

Maximum Redfish client connection cache size. Redfish driver would strive to reuse authenticated BMC connections (obtained through Redfish Session Service). This option caps the maximum number of connections to maintain. The value of 0 disables client connection caching completely.

auth_type

Type:

string

Default:

auto

Valid Values:

basic, session, auto

Redfish HTTP client authentication method.

Possible values

basic

Use HTTP basic authentication

session

Use HTTP session authentication

auto

Try HTTP session authentication first, fall back to basic HTTP authentication

use_swift

Type:

boolean

Default:

False

Mutable:

This option can be changed without restarting.

Upload generated ISO images for virtual media boot to Swift, then pass temporary URL to BMC for booting the node. If set to false, images are placed on the ironic-conductor node and served over its local HTTP server.

swift_container

Type:

string

Default:

ironic_redfish_container

Mutable:

This option can be changed without restarting.

The Swift container to store Redfish driver data. Applies only when use_swift is enabled.

swift_object_expiry_timeout

Type:

integer

Default:

900

Mutable:

This option can be changed without restarting.

Amount of time in seconds for Swift objects to auto-expire. Applies only when use_swift is enabled.

kernel_append_params

Type:

string

Default:

nofb vga=normal

Mutable:

This option can be changed without restarting.

Additional kernel parameters to pass down to the instance kernel. These parameters can be consumed by the kernel or by the applications by reading /proc/cmdline. Mind severe cmdline size limit! Can be overridden by instance_info/kernel_append_params property.

file_permission

Type:

integer

Default:

420

File permission for swift-less image hosting with the octal permission representation of file access permissions. This setting defaults to 644, or as the octal number 0o644 in Python. This setting must be set to the octal number representation, meaning starting with 0o.

firmware_update_status_interval

Type:

integer

Default:

60

Minimum Value:

0

Number of seconds to wait between checking for completed firmware update tasks

firmware_update_fail_interval

Type:

integer

Default:

60

Minimum Value:

0

Number of seconds to wait between checking for failed firmware update tasks

firmware_source

Type:

string

Default:

http

Valid Values:

http, local, swift

Mutable:

This option can be changed without restarting.

Specifies how firmware image should be served. Whether from its original location using the firmware source URL directly, or should serve it from ironic’s Swift or HTTP server.

Possible values

http

If firmware source URL is also HTTP, then serve from original location, otherwise copy to ironic’s HTTP server. Default.

local

Download from original location and server from ironic’s HTTP server.

swift

If firmware source URL is also Swift, serve from original location, otherwise copy to ironic’s Swift server.

raid_config_status_interval

Type:

integer

Default:

60

Minimum Value:

0

Number of seconds to wait between checking for completed raid config tasks

raid_config_fail_interval

Type:

integer

Default:

60

Minimum Value:

0

Number of seconds to wait between checking for failed raid config tasks

boot_mode_config_timeout

Type:

integer

Default:

900

Minimum Value:

0

Number of seconds to wait for boot mode or secure boot status change to take effect after a reboot. Set to 0 to disable waiting.

sensor_data

send_sensor_data

Type:

boolean

Default:

False

Enable sending sensor data message via the notification bus.

Deprecated Variations

Group	Name
conductor	send_sensor_data

interval

Type:

integer

Default:

600

Minimum Value:

1

Seconds between conductor sending sensor data message via the notification bus. This was originally for consumption via ceilometer, but the data may also be consumed via a plugin like ironic-prometheus-exporter or any other message bus data collector.

Deprecated Variations

Group	Name
conductor	send_sensor_data_interval

workers

Type:

integer

Default:

4

Minimum Value:

1

The maximum number of workers that can be started simultaneously for send data from sensors periodic task.

Deprecated Variations

Group	Name
conductor	send_sensor_data_workers

wait_timeout

Type:

integer

Default:

300

The time in seconds to wait for send sensors data periodic task to be finished before allowing periodic call to happen again. Should be less than send_sensor_data_interval value.

Deprecated Variations

Group	Name
conductor	send_sensor_data_wait_timeout

data_types

Type:

list

Default:

['ALL']

List of comma separated meter types which need to be sent to Ceilometer. The default value, “ALL”, is a special value meaning send all the sensor data. This setting only applies to baremetal sensor data being processed through the conductor.

Deprecated Variations

Group	Name
conductor	send_sensor_data_types

enable_for_undeployed_nodes

Type:

boolean

Default:

False

The default for sensor data collection is to only collect data for machines that are deployed, however operators may desire to know if there are failures in hardware that is not presently in use. When set to true, the conductor will collect sensor information from all nodes when sensor data collection is enabled via the send_sensor_data setting.

Deprecated Variations

Group	Name
conductor	send_sensor_data_for_undeployed_nodes

enable_for_conductor

Type:

boolean

Default:

True

If to include sensor metric data for the Conductor process itself in the message payload for sensor data which allows operators to gather instance counts of actions and states to better manage the deployment.

enable_for_nodes

Type:

boolean

Default:

True

If to transmit any sensor data for any nodes under this conductor’s management. This option supersedes the send_sensor_data_for_undeployed_nodes setting.

service_catalog

auth_url

Type:

unknown type

Default:

<None>

Authentication URL

auth_type

Type:

unknown type

Default:

<None>

Authentication type to load

Deprecated Variations

Group	Name
service_catalog	auth_plugin

cafile

Type:

string

Default:

<None>

PEM encoded Certificate Authority to use when verifying HTTPs connections.

certfile

Type:

string

Default:

<None>

PEM encoded client certificate cert file

collect_timing

Type:

boolean

Default:

False

Collect per-API call timing information.

connect_retries

Type:

integer

Default:

<None>

The maximum number of retries that should be attempted for connection errors.

connect_retry_delay

Type:

floating point

Default:

<None>

Delay (in seconds) between two retries for connection errors. If not set, exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is used.

default_domain_id

Type:

unknown type

Default:

<None>

Optional domain ID to use with v3 and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

default_domain_name

Type:

unknown type

Default:

<None>

Optional domain name to use with v3 API and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

domain_id

Type:

unknown type

Default:

<None>

Domain ID to scope to

domain_name

Type:

unknown type

Default:

<None>

Domain name to scope to

endpoint_override

Type:

string

Default:

<None>

Always use this endpoint URL for requests for this client. NOTE: The unversioned endpoint should be specified here; to request a particular API version, use the version, min-version, and/or max-version options.

insecure

Type:

boolean

Default:

False

Verify HTTPS connections.

keyfile

Type:

string

Default:

<None>

PEM encoded client certificate key file

max_version

Type:

string

Default:

<None>

The maximum major version of a given API, intended to be used as the upper bound of a range with min_version. Mutually exclusive with version.

min_version

Type:

string

Default:

<None>

The minimum major version of a given API, intended to be used as the lower bound of a range with max_version. Mutually exclusive with version. If min_version is given with no max_version it is as if max version is “latest”.

password

Type:

unknown type

Default:

<None>

User’s password

project_domain_id

Type:

unknown type

Default:

<None>

Domain ID containing project

project_domain_name

Type:

unknown type

Default:

<None>

Domain name containing project

project_id

Type:

unknown type

Default:

<None>

Project ID to scope to

Deprecated Variations

Group	Name
service_catalog	tenant-id
service_catalog	tenant_id

project_name

Type:

unknown type

Default:

<None>

Project name to scope to

Deprecated Variations

Group	Name
service_catalog	tenant-name
service_catalog	tenant_name

region_name

Type:

string

Default:

<None>

The default region_name for endpoint URL discovery.

retriable_status_codes

Type:

list

Default:

<None>

List of retriable HTTP status codes that should be retried. If not set default to [503]

service_name

Type:

string

Default:

<None>

The default service_name for endpoint URL discovery.

service_type

Type:

string

Default:

baremetal

The default service_type for endpoint URL discovery.

split_loggers

Type:

boolean

Default:

False

Log requests to multiple loggers.

status_code_retries

Type:

integer

Default:

<None>

The maximum number of retries that should be attempted for retriable HTTP status codes.

status_code_retry_delay

Type:

floating point

Default:

<None>

Delay (in seconds) between two retries for retriable status codes. If not set, exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is used.

system_scope

Type:

unknown type

Default:

<None>

Scope for system operations

tenant_id

Type:

unknown type

Default:

<None>

Tenant ID

tenant_name

Type:

unknown type

Default:

<None>

Tenant Name

timeout

Type:

integer

Default:

<None>

Timeout value for http requests

trust_id

Type:

unknown type

Default:

<None>

ID of the trust to use as a trustee use

user_domain_id

Type:

unknown type

Default:

<None>

User’s domain id

user_domain_name

Type:

unknown type

Default:

<None>

User’s domain name

user_id

Type:

unknown type

Default:

<None>

User id

username

Type:

unknown type

Default:

<None>

Username

Deprecated Variations

Group	Name
service_catalog	user-name
service_catalog	user_name

valid_interfaces

Type:

list

Default:

['internal', 'public']

List of interfaces, in order of preference, for endpoint URL.

version

Type:

string

Default:

<None>

Minimum Major API version within a given Major API version for endpoint URL discovery. Mutually exclusive with min_version and max_version

snmp

power_timeout

Type:

integer

Default:

10

Seconds to wait for power action to be completed

reboot_delay

Type:

integer

Default:

0

Minimum Value:

0

Time (in seconds) to sleep between when rebooting (powering off and on again)

power_action_delay

Type:

integer

Default:

0

Minimum Value:

0

Time (in seconds) to sleep before power on and after powering off. Which may be needed with some PDUs as they may not honor toggling a specific power port in rapid succession without a delay. This option may be useful if the attached physical machine has a substantial power supply to hold it over in the event of a brownout.

udp_transport_timeout

Type:

floating point

Default:

1.0

Minimum Value:

0.0

Response timeout in seconds used for UDP transport. Timeout should be a multiple of 0.5 seconds and is applicable to each retry.

udp_transport_retries

Type:

integer

Default:

5

Minimum Value:

0

Maximum number of UDP request retries, 0 means no retries.

ssl

ca_file

Type:

string

Default:

<None>

CA certificate file to use to verify connecting clients.

Deprecated Variations

Group	Name
DEFAULT	ssl_ca_file

cert_file

Type:

string

Default:

<None>

Certificate file to use when starting the server securely.

Deprecated Variations

Group	Name
DEFAULT	ssl_cert_file

key_file

Type:

string

Default:

<None>

Private key file to use when starting the server securely.

Deprecated Variations

Group	Name
DEFAULT	ssl_key_file

version

Type:

string

Default:

<None>

SSL version to use (valid only if SSL enabled). Valid values are TLSv1 and SSLv23. SSLv2, SSLv3, TLSv1_1, and TLSv1_2 may be available on some distributions.

ciphers

Type:

string

Default:

<None>

Sets the list of available ciphers. value should be a string in the OpenSSL cipher list format.

swift

auth_url

Type:

unknown type

Default:

<None>

Authentication URL

auth_type

Type:

unknown type

Default:

<None>

Authentication type to load

Deprecated Variations

Group	Name
swift	auth_plugin

cafile

Type:

string

Default:

<None>

PEM encoded Certificate Authority to use when verifying HTTPs connections.

certfile

Type:

string

Default:

<None>

PEM encoded client certificate cert file

collect_timing

Type:

boolean

Default:

False

Collect per-API call timing information.

connect_retries

Type:

integer

Default:

<None>

The maximum number of retries that should be attempted for connection errors.

connect_retry_delay

Type:

floating point

Default:

<None>

Delay (in seconds) between two retries for connection errors. If not set, exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is used.

default_domain_id

Type:

unknown type

Default:

<None>

Optional domain ID to use with v3 and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

default_domain_name

Type:

unknown type

Default:

<None>

Optional domain name to use with v3 API and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication.

domain_id

Type:

unknown type

Default:

<None>

Domain ID to scope to

domain_name

Type:

unknown type

Default:

<None>

Domain name to scope to

endpoint_override

Type:

string

Default:

<None>

Always use this endpoint URL for requests for this client. NOTE: The unversioned endpoint should be specified here; to request a particular API version, use the version, min-version, and/or max-version options.

insecure

Type:

boolean

Default:

False

Verify HTTPS connections.

keyfile

Type:

string

Default:

<None>

PEM encoded client certificate key file

max_version

Type:

string

Default:

<None>

The maximum major version of a given API, intended to be used as the upper bound of a range with min_version. Mutually exclusive with version.

min_version

Type:

string

Default:

<None>

The minimum major version of a given API, intended to be used as the lower bound of a range with max_version. Mutually exclusive with version. If min_version is given with no max_version it is as if max version is “latest”.

password

Type:

unknown type

Default:

<None>

User’s password

project_domain_id

Type:

unknown type

Default:

<None>

Domain ID containing project

project_domain_name

Type:

unknown type

Default:

<None>

Domain name containing project

project_id

Type:

unknown type

Default:

<None>

Project ID to scope to

Deprecated Variations

Group	Name
swift	tenant-id
swift	tenant_id

project_name

Type:

unknown type

Default:

<None>

Project name to scope to

Deprecated Variations

Group	Name
swift	tenant-name
swift	tenant_name

region_name

Type:

string

Default:

<None>

The default region_name for endpoint URL discovery.

retriable_status_codes

Type:

list

Default:

<None>

List of retriable HTTP status codes that should be retried. If not set default to [503]

service_name

Type:

string

Default:

<None>

The default service_name for endpoint URL discovery.

service_type

Type:

string

Default:

object-store

The default service_type for endpoint URL discovery.

split_loggers

Type:

boolean

Default:

False

Log requests to multiple loggers.

status_code_retries

Type:

integer

Default:

<None>

The maximum number of retries that should be attempted for retriable HTTP status codes.

status_code_retry_delay

Type:

floating point

Default:

<None>

Delay (in seconds) between two retries for retriable status codes. If not set, exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is used.

system_scope

Type:

unknown type

Default:

<None>

Scope for system operations

tenant_id

Type:

unknown type

Default:

<None>

Tenant ID

tenant_name

Type:

unknown type

Default:

<None>

Tenant Name

timeout

Type:

integer

Default:

<None>

Timeout value for http requests

trust_id

Type:

unknown type

Default:

<None>

ID of the trust to use as a trustee use

user_domain_id

Type:

unknown type

Default:

<None>

User’s domain id

user_domain_name

Type:

unknown type

Default:

<None>

User’s domain name

user_id

Type:

unknown type

Default:

<None>

User id

username

Type:

unknown type

Default:

<None>

Username

Deprecated Variations

Group	Name
swift	user-name
swift	user_name

valid_interfaces

Type:

list

Default:

['internal', 'public']

List of interfaces, in order of preference, for endpoint URL.

version

Type:

string

Default:

<None>

Minimum Major API version within a given Major API version for endpoint URL discovery. Mutually exclusive with min_version and max_version