From 168e25a7d181ae4bd35a160712425341ca6d4e05 Mon Sep 17 00:00:00 2001 From: Lin Tan Date: Wed, 4 Feb 2015 18:09:37 +0800 Subject: [PATCH] Add AMT-PXE driver doc Add documentation for amt-pxe drivers. Implements blueprint amt-pxe-driver Change-Id: I6196716b8df4fcd793a454b41e059f50a2fc14db --- doc/source/deploy/drivers.rst | 8 +++++ doc/source/drivers/amt.rst | 61 +++++++++++++++++++++++++++++++++++ 2 files changed, 69 insertions(+) create mode 100644 doc/source/drivers/amt.rst diff --git a/doc/source/deploy/drivers.rst b/doc/source/deploy/drivers.rst index 8ea7f2d74f..3f73f1916f 100644 --- a/doc/source/deploy/drivers.rst +++ b/doc/source/deploy/drivers.rst @@ -14,6 +14,14 @@ DRAC with PXE deploy ``/etc/ironic/ironic.conf`` - Install openwsman-python package +AMT +---- + +.. toctree:: + :maxdepth: 1 + + ../drivers/amt + SNMP ---- diff --git a/doc/source/drivers/amt.rst b/doc/source/drivers/amt.rst new file mode 100644 index 0000000000..9cf69e4b58 --- /dev/null +++ b/doc/source/drivers/amt.rst @@ -0,0 +1,61 @@ +.. _amt: + +=========== +AMT drivers +=========== + +Overview +======== +Introduce new drivers AMT to extend Ironic's range to desktop. +AMT/vPro is widely used in desktop to remotely control the power, +similar like IPMI in server. + +AMT driver use WS-MAN protocol to interactive with AMT client. +This works on AMT 7.0/8.0/9.0. AMT 7.0 is released on 2010, so most +PCs with vPro should be involved. + +Currently there is one AMT driver: + +* ``pxe_amt`` use amt as power management and pxe as deploy management. + +Setting up development environment +================================== +* Set up AMT Client + + * Choose a Desktop with ``vPro`` tag(within Intel's tag, next to CORE i5/7) - + Press Ctrl+P during booting to enter MEBx management + + * Reset password - Default is ``admin``. New password can be ``Cloud12345^`` + + * Go to Intel AMT Configuration: + + * Enable all features under SOL/IDER/KVM section + + * Select User Consent and choose None(No password need) + + * Select Network Setup section and set IP + + * Activate Network Access + + * MEBx Exit + + * Restart and enable PXE boot in bios + +* Install ``openwsman&openwsman-python(>=2.4.10)`` on Ironic Server + + Get the rpm package for fedora 20 from:: + + http://download.opensuse.org/repositories/Openwsman/Fedora_20/ + + Or build by yourself from:: + + https://github.com/Openwsman/openwsman + +* Enable ``pxe_amt`` in ``enabled_drivers`` in ``/etc/ironic/ironic.conf`` + and restart Ironic conductor + +* Enroll a AMT node + +* Add ``amt_password/amt_address/amt_username`` into driver_info + +* Boot an instance