kolla-ansible/doc/source/reference/ironic-guide.rst
chenxing c2d54b9737 Upgrade the rst convention of the Reference Guide [2]
We upgrade the rst convention by following Documentation Contributor
Guide[1].

[1] https://docs.openstack.org/doc-contrib-guide

Change-Id: I825deadefcf996732a03e61c8fd19cfd6a498e77
Partially-Implements: blueprint optimize-the-documentation-format
2018-03-17 09:44:25 +00:00

2.2 KiB

Ironic in Kolla

Overview

Currently Kolla can deploy the Ironic services:

  • ironic-api
  • ironic-conductor
  • ironic-dnsmasq
  • ironic-inspector

As well as a required PXE service, deployed as ironic-pxe.

Current status

The Ironic implementation is "tech preview", so currently instances can only be deployed on baremetal. Further work will be done to allow scheduling for both virtualized and baremetal deployments.

Pre-deployment Configuration

Enable Ironic role in /etc/kolla/globals.yml:

enable_ironic: "yes"

Beside that an additional network type vlan,flat has to be added to a list of tenant network types:

neutron_tenant_network_types: "vxlan,vlan,flat"

Configuring Web Console

Configuration based off upstream Node web console.

Serial speed must be the same as the serial configuration in the BIOS settings. Default value: 115200bps, 8bit, non-parity.If you have different serial speed.

Set ironic_console_serial_speed in /etc/kolla/globals.yml:

ironic_console_serial_speed: 9600n8

Post-deployment configuration

Configuration based off upstream Ironic installation Documentation.

Again, remember that enabling Ironic reconfigures nova compute (driver and scheduler) as well as changes neutron network settings. Further neutron setup is required as outlined below.

Create the flat network to launch the instances:

neutron net-create --tenant-id $TENANT_ID sharednet1 --shared \
--provider:network_type flat --provider:physical_network physnet1

neutron subnet-create sharednet1 $NETWORK_CIDR --name $SUBNET_NAME \
--ip-version=4 --gateway=$GATEWAY_IP --allocation-pool \
start=$START_IP,end=$END_IP --enable-dhcp

And then the above ID is used to set cleaning_network in the neutron section of ironic.conf.