summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLin Tan <lin.tan@intel.com>2015-04-01 11:47:16 +0800
committerLin Tan <lin.tan@intel.com>2015-04-13 11:18:48 +0800
commitfe1e2b08c25ebdf0f82689d8651c34f2aafe9212 (patch)
tree727e582e2e1ebffa163c79c39457b5a28680e95c
parent49a5692c9dc328209a5dc9f3db3777ec8f4f3079 (diff)
downloadironic-fe1e2b08c25ebdf0f82689d8651c34f2aafe9212.tar.gz
Improve AMT driver doc
It is recommended that users should deploy AMT nodes with local boot. Co-Authored-By: Chris Krelle <nobodycam@gmail.com> Close-Bug: #1436824 Change-Id: I536c587008bb68950ec7acfcf16c8ae28f9560bc
-rw-r--r--doc/source/drivers/amt.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/source/drivers/amt.rst b/doc/source/drivers/amt.rst
index 33e9701ac..ef6701a83 100644
--- a/doc/source/drivers/amt.rst
+++ b/doc/source/drivers/amt.rst
@@ -76,3 +76,14 @@ A detailed reference is available here, and a short guide follows below:
``amt_address``, and ``amt_username``
* Boot an instance
+
+.. note::
+ It is recommended that nodes using the pxe_amt driver be deployed with the
+ `local boot`_ option. This is because the AMT firmware currently has no
+ support for setting a persistent boot device. Nodes deployed without the
+ `local boot`_ option could fail to boot if they are restarted outside of
+ Ironic's control (I.E. rebooted by a local user) because the node will
+ not attempt to PXE / network boot the kernel, using `local boot`_ solves this
+ known issue.
+
+.. _`local boot`: http://docs.openstack.org/developer/ironic/deploy/install-guide.html#local-boot-with-partition-images