From fe1e2b08c25ebdf0f82689d8651c34f2aafe9212 Mon Sep 17 00:00:00 2001 From: Lin Tan Date: Wed, 1 Apr 2015 11:47:16 +0800 Subject: Improve AMT driver doc It is recommended that users should deploy AMT nodes with local boot. Co-Authored-By: Chris Krelle Close-Bug: #1436824 Change-Id: I536c587008bb68950ec7acfcf16c8ae28f9560bc --- doc/source/drivers/amt.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) 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 -- cgit v1.2.1