aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/ironic-guide.rst42
1 files changed, 42 insertions, 0 deletions
diff --git a/doc/ironic-guide.rst b/doc/ironic-guide.rst
new file mode 100644
index 000000000..da8795d63
--- /dev/null
+++ b/doc/ironic-guide.rst
@@ -0,0 +1,42 @@
+Ironic in Kolla
+===============
+
+Overview
+--------
+Currently Kolla can deploy the Ironic services:
+
+- ironic-api
+- ironic-conductor
+- ironic-discoverd
+
+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. Most probably at that time discoverd
+will be replaced by ironic-inspector.
+
+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_uuid in the neutron
+section of ironic.conf.
+
+.. _documentation: http://docs.openstack.org/developer/ironic/deploy/install-guide.html