From 8d7d3b16a7689807291686d5743827aa6e9f7b0a Mon Sep 17 00:00:00 2001
From: Imre Farkas <ifarkas@redhat.com>
Date: Wed, 30 Mar 2016 17:35:11 +0200
Subject: [PATCH] Document ready-state configuration

Change-Id: I4fc8448eb675073c3eed1d0cae77193306d37c4d
---
 .../advanced_deployment.rst                   |  1 +
 .../advanced_deployment/ready_state.rst       | 31 +++++++++++++++++++
 2 files changed, 32 insertions(+)
 create mode 100644 doc/source/advanced_deployment/ready_state.rst

diff --git a/doc/source/advanced_deployment/advanced_deployment.rst b/doc/source/advanced_deployment/advanced_deployment.rst
index 71b2546b..27884c55 100644
--- a/doc/source/advanced_deployment/advanced_deployment.rst
+++ b/doc/source/advanced_deployment/advanced_deployment.rst
@@ -8,6 +8,7 @@ In this chapter you will find advanced deployment of various |project| areas.
 
    root_device
    profile_matching
+   ready_state
    introspection_data
    node_config
    extra_config
diff --git a/doc/source/advanced_deployment/ready_state.rst b/doc/source/advanced_deployment/ready_state.rst
new file mode 100644
index 00000000..61c9802b
--- /dev/null
+++ b/doc/source/advanced_deployment/ready_state.rst
@@ -0,0 +1,31 @@
+Ready-state configuration
+=========================
+
+.. note:: Ready-state configuration currently works only with Dell DRAC
+          machines.
+
+Ready-state configuration can be used to prepare bare-metal resources for
+deployment. It includes BIOS configuration based on a predefined profile.
+
+
+Define the target BIOS configuration
+------------------------------------
+
+To define a BIOS setting, list the name of the setting and its target
+value for each profile::
+
+    {
+        "compute" :{
+            "bios_settings": {"ProcVirtualization": "Enabled"}
+        }
+    }
+
+
+Trigger the ready-state configuration
+-------------------------------------
+
+Make sure the nodes have profiles assigned as described in
+:doc:`profile_matching`. Create a JSON file with the target ready-state
+configuration for each profile. Then trigger the configuration::
+
+    openstack baremetal configure ready state ready-state.json