Chapter 7. Bare Metal (ironic) Parameters

AdditionalArchitectures

List of additional architectures to enable.

ApacheCertificateKeySize

Override the private key size used when creating the certificate for this service.

ApacheTimeout

The timeout in seconds for Apache, which defines duration Apache waits for I/O operations. The default value is 90.

CertificateKeySize

Specifies the private key size used when creating the certificate. The default value is 2048.

EnableSQLAlchemyCollectd

Set to true to enable the SQLAlchemy-collectd server plugin. The default value is false.

IPAImageURLs

IPA image URLs, the format should be ["http://path/to/kernel", "http://path/to/ramdisk"].

IronicAutomatedClean

Enables or disables automated cleaning. Disabling automated cleaning might result in security problems and deployment failures on rebuilds. Do not set to False unless you understand the consequences of disabling this feature. The default value is true.

IronicCleaningDiskErase

Type of disk cleaning before and between deployments. full for full cleaning. metadata to clean only disk metadata (partition table). The default value is full.

IronicCleaningNetwork

Name or UUID of the overcloud network used for cleaning bare metal nodes. Set to provisioning during the initial deployment (when no networks are created yet) and change to an actual UUID in a post-deployment stack update. The default value is provisioning.

IronicConductorGroup

The name of an OpenStack Bare Metal (ironic) Conductor Group.

IronicConfigureSwiftTempUrlKey

Whether to configure Swift temporary URLs for use with the "direct" and "ansible" deploy interfaces. The default value is true.

IronicCorsAllowedOrigin

Indicate whether this resource may be shared with the domain received in the request "origin" header.

IronicDefaultBootInterface

Boot interface implementation to use by default. Leave empty to set none. This may not work if a hardware type does not support the set boot interface. This overrides create-time defaults. The ordered union of the enabled boot interfaces and hardware type determines, under normal circumstances, what the default will be.

IronicDefaultBootMode

Default boot mode to use when no boot mode is explicitly requested in node’s driver_info, capabilities or in the "instance_info" configuration. One of bios or uefi. The default value is uefi.

IronicDefaultBootOption

How to boot the bare metal instances. Set to local to use local bootloader (requires grub2 for partition images). Set to netboot to make the instances boot from controllers using PXE/iPXE. The default value is local.

IronicDefaultDeployInterface

Deploy interface implementation to use by default. Leave empty to use the hardware type default.

IronicDefaultInspectInterface

Inspect interface implementation to use by default. Leave empty to use the hardware type default.

IronicDefaultNetworkInterface

Network interface implementation to use by default. Set to flat to use one flat provider network. Set to neutron to make OpenStack Bare Metal (ironic) interact with the OpenStack Networking (neutron) ML2 driver to enable other network types and certain advanced networking features. Requires IronicProvisioningNetwork to be correctly set. The default value is flat.

IronicDefaultRescueInterface

Default rescue implementation to use. The "agent" rescue requires a compatible ramdisk to be used. The default value is agent.

IronicDefaultResourceClass

Default resource class to use for new nodes.

IronicDeployLogsStorageBackend

Backend to use to store ramdisk logs, either "local" or "swift". The default value is local.

IronicDhcpv6StatefulAddressCount

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. The default value is 4.

IronicEnabledBiosInterfaces

Enabled BIOS interface implementations. Each hardware type must have at least one valid implementation enabled. The default value is ['no-bios'].

IronicEnabledBootInterfaces

Enabled boot interface implementations. Each hardware type must have at least one valid implementation enabled. The default value is ['ipxe', 'pxe'].

IronicEnabledConsoleInterfaces

Enabled console interface implementations. Each hardware type must have at least one valid implementation enabled. The default value is ['ipmitool-socat', 'no-console'].

IronicEnabledDeployInterfaces

Enabled deploy interface implementations. Each hardware type must have at least one valid implementation enabled. The default value is ['direct'].

IronicEnabledHardwareTypes

Enabled OpenStack Bare Metal (ironic) hardware types. The default value is ['ipmi', 'redfish'].

IronicEnabledInspectInterfaces

Enabled inspect interface implementations. Each hardware type must have at least one valid implementation enabled. The default value is ['no-inspect'].

IronicEnabledManagementInterfaces

Enabled management interface implementations. Each hardware type must have at least one valid implementation enabled. The default value is ['ipmitool', 'noop', 'redfish'].

IronicEnabledNetworkInterfaces

Enabled network interface implementations. Each hardware type must have at least one valid implementation enabled. The default value is ['flat', 'neutron'].

IronicEnabledPowerInterfaces

Enabled power interface implementations. Each hardware type must have at least one valid implementation enabled. The default value is ['ipmitool', 'redfish'].

IronicEnabledRaidInterfaces

Enabled RAID interface implementations. Each hardware type must have at least one valid implementation enabled. The default value is ['no-raid', 'agent'].

IronicEnabledRescueInterfaces

Enabled rescue interface implementations. Each hardware type must have at least one valid implementation enabled. The default value is ['no-rescue', 'agent'].

IronicEnabledStorageInterfaces

Enabled storage interface implementations. Each hardware type must have at least one valid implementation enabled. The default value is ['cinder', 'noop'].

IronicEnabledVendorInterfaces

Enabled vendor interface implementations. Each hardware type must have at least one valid implementation enabled. The default value is ['ipmitool', 'no-vendor'].

IronicEnableNovaPowerNotifications

Enable/Disable the support for power state change callbacks to nova. The default value is true.

IronicEnableStagingDrivers

Whether to enable use of staging drivers. The default value is false.

IronicForcePowerStateDuringSync

Whether to force power state during sync. The default value is true.

IronicImageDownloadSource

Image delivery method for the "direct" deploy interface. Use "swift" for the Object Storage temporary URLs, use "http" for the local HTTP server (the same as for iPXE). The default value is http.

IronicInspectorCollectors

Comma-separated list of IPA inspection collectors. The default value is default,logs.

IronicInspectorDiscoveryDefaultDriver

The default driver to use for newly discovered nodes (requires IronicInspectorEnableNodeDiscovery set to True). This driver is automatically added to enabled_drivers. The default value is ipmi.

IronicInspectorEnableNodeDiscovery

Makes ironic-inspector enroll any unknown node that PXE-boots introspection ramdisk in OpenStack Bare Metal (ironic). The default driver to use for new nodes is specified by the IronicInspectorDiscoveryDefaultDriver parameter. Introspection rules can also be used to specify it. The default value is false.

IronicInspectorExtraProcessingHooks

Comma-separated list of processing hooks to append to the default list. The default value is extra_hardware,lldp_basic,local_link_connection,physnet_cidr_map.

IronicInspectorInterface

Network interface on which inspection dnsmasq will listen. The default value is br-ex.

IronicInspectorIpRange

Temporary IP range that will be given to nodes during the inspection process. This should not overlap with any range that OpenStack Networking (neutron) DHCP allocates, but it has to be routeable back to ironic-inspector. This option has no meaningful defaults, and thus is required.

IronicInspectorIPXEEnabled

Whether to use iPXE for inspection. The default value is true.

IronicInspectorKernelArgs

Kernel args for the OpenStack Bare Metal (ironic) inspector. The default value is ipa-inspection-dhcp-all-interfaces=1 ipa-collect-lldp=1 ipa-debug=1.

IronicInspectorStorageBackend

Storage backend for storing introspection data. The default value is none.

IronicInspectorSubnets

Temporary IP ranges that will be given to nodes during the inspection process. These ranges should not overlap with any range that OpenStack Networking (neutron) DHCP provides, but they need to be routeable back to the ironic-inspector API. This option has no meaningful defaults and is required.

IronicInspectorUseSwift

DEPRECATED: Use IronicInspectorStorageBackend instead. Whether to use Swift for storing introspection data. The default value is true.

IronicIpVersion

The IP version that will be used for PXE booting. The default value is 4.

IronicIPXEEnabled

Whether to use iPXE instead of PXE for deployment. The default value is true.

IronicIPXEPort

Port to use for serving images when iPXE is used. The default value is 8088.

IronicIPXETimeout

IPXE timeout in second. Set to 0 for infinite timeout. The default value is 60.

IronicIPXEUefiSnpOnly

Whether to use SNP (Simple Network Protocol) iPXE EFI, or not. When set to true ipxe-snponly EFI is used. The default value is true.

IronicPassword

The password for the Bare Metal service and database account.

IronicPowerStateChangeTimeout

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. The default value is 60.

IronicProvisioningNetwork

Name or UUID of the overcloud network used for provisioning of bare metal nodes if IronicDefaultNetworkInterface is set to neutron. Set to provisioning during the initial deployment (when no networks are created yet) and change to an actual UUID in a post-deployment stack update. The default value is provisioning.

IronicRescuingNetwork

Name or UUID of the overcloud network used for rescuing of bare metal nodes, if IronicDefaultRescueInterface is not set to "no-rescue". The default value of "provisioning" can be left during the initial deployment (when no networks are created yet) and should be changed to an actual UUID in a post-deployment stack update. The default value is provisioning.

IronicRpcTransport

The remote procedure call transport between conductor and API processes, such as a messaging broker or JSON RPC.

MemcacheUseAdvancedPool

Use the advanced (eventlet safe) memcached client pool. The default value is true.

PortPhysnetCidrMap

Mapping of IP subnet CIDR to physical network. When the physnet_cidr_map processing hook is enabled the physical_network property of baremetal ports is populated based on this mapping. Example: PortPhysnetCidrMap: 10.10.10.0/24: physnet_a 2001:db8::/64: physnet_b.