diff options
Diffstat (limited to 'doc/source/reference/ironic-guide.rst')
| -rw-r--r-- | doc/source/reference/ironic-guide.rst | 75 |
1 files changed, 75 insertions, 0 deletions
diff --git a/doc/source/reference/ironic-guide.rst b/doc/source/reference/ironic-guide.rst new file mode 100644 index 000000000..0d324b2ef --- /dev/null +++ b/doc/source/reference/ironic-guide.rst @@ -0,0 +1,75 @@ +.. _ironic-guide: + +=============== +Ironic in Kolla +=============== + +Overview +======== +Currently Kolla can deploy the Ironic services: + +- ironic-api +- ironic-conductor +- 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``: + +.. code-block:: console + + enable_ironic: "yes" + +Beside that an additional network type 'vlan,flat' has to be added to a list of +tenant network types: + +.. code-block:: console + + neutron_tenant_network_types: "vxlan,vlan,flat" + +Configuring Web Console +======================= +Configuration based off upstream web_console_documentation_. + +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 + +.. _web_console_documentation: https://docs.openstack.org/ironic/latest/admin/console.html#node-web-console + +Post-deployment configuration +============================= +Configuration based off upstream 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. + +.. _documentation: https://docs.openstack.org/ironic/latest/install/index.html |