openstack/ironic
Code Issues Proposed changes
bd2b0c2e0f
ironic/doc/source/drivers/amt.rst
Lucas Alvares Gomes fc72b4d904 Enable doc8 style checker for *.rst files 
This patch is enabling the doc8 style checker for the *.rst files in
Ironic.

Since this patch is just the first stab at enabling this new check two
errors are currently being ignored by doc8 because of the number of
occurrences in our docs:

* D000 - Duplicated target names. We do have many links with generic
         names scattered around the docs (e.g "see", "link")

* D001 - Line's too long

These errors will be fixed in a following patch.

Change-Id: I32fb5a3104b9773c55a80a84dd81e49c567c76ac
2016-02-02 12:38:20 +00:00

2.9 KiB
Raw Blame History

AMT drivers

Overview

AMT (Active Management Technology) drivers extend Ironic's range to the desktop. AMT/vPro is widely used in desktops to remotely control their power, similar to IPMI in servers.

AMT drivers use WS-MAN protocol to interact with AMT clients. They work on AMT 7.0/8.0/9.0. AMT 7.0 was released in 2010, so AMT drivers should work on most PCs with vPro.

There are two AMT drivers:

  • pxe_amt uses AMT for power management and deploys the user image over iSCSI from the conductor
  • agent_amt uses AMT for power management and deploys the user image directly to the node via HTTP.

Set up your environment

A detailed reference is available here, and a short guide follows below:

https://software.intel.com/en-us/articles/intel-active-management-technology-start-here-guide-intel-amt-9#4.2

  • Set up AMT Client

    • Choose a system which supports Intel AMT / vPro. Desktop and laptop systems that support this can often be identified by looking at the "Intel" tag for the word vPro.
    • During boot, press Ctrl+P to enter Intel MEBx management.
    • Reset password -- default is admin. The new password must contain at least one upper case letter, one lower case letter, one digit and one special character, and be at least eight characters.
    • Go to Intel AMT Configuration:
      • Enable all features under SOL/IDER/KVM section
      • Select User Consent and choose None (No password is needed)
      • Select Network Setup section and set IP
      • Activate Network Access
    • MEBx Exit
    • Restart and enable PXE boot in bios

  • Install openwsman on servers where ironic-conductor is running:

  • Enable the pxe_amt or agent_amt driver by adding it to the configuration option enabled_drivers (typically located at /etc/ironic/ironic.conf) and restart the ironic-conductor process:

    service ironic-conductor restart

  • Enroll an AMT node

  • Specify these driver_info properties for the node: amt_password,

    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.