Package: amt
===============================Python AMT Tools===============================.. image:: https://img.shields.io/travis/sdague/amt.svg:target: https://travis-ci.org/sdague/amt.. image:: https://img.shields.io/pypi/v/amt.svg:target: https://pypi.python.org/pypi/amtTools for interacting with Intel's Active Management TechnologyBackground----------AMT is a light weight hardware control interface put into some Intelbased laptops and desktops as a tool for corporate fleets to managehardware. It provides the basics of power control, as well as remoteconsole via VNC. It functions by having a dedicated service processorsniff traffic off the network card on specific ports before it gets tothe operating system. Some versions of Intel NUC boxes have AMT, whichmake them ideal candidates for building a reasonable cluster in yourbasement.There was once a tool called ``amttool`` which let you interact withthese systems from Linux. This used the SOAP interface to AMT. Thatwas removed in v9 of the firmware, which means it no longer works withmodern AMT in the field.The interface that remains is CIM, a standard from the DMTF thatbuilds XML models for all the things. There exist very few examplesfor how to make this work on the internet, with one exception: theOpenStack Baremetal (Ironic) service. It has native support for AMThardware control.This project is derivative work from Ironic. The heavy lifting ofunderstanding all the CIM magic incantations, and oh the magic theyare, comes from that code. Refactored for a more minimal usage.Hardware that includes AMT--------------------------AMT is branded as vPro in products by Intel. It is found in many Intelbased laptops. There are also specific models of Intel NUC thatinclude vPro.* `Intel NUC KIT Core Processor BLKNUC5I5MYHE <http://amzn.to/1OZshhF>`_This code gets tested with ``5i5MYHE`` NUCs as well as an older NUCthat I have laying around.Configuring AMT---------------AMT must be enabled in the BIOS before it can be used externally. Thisis done by pressing ``Ctrl-P`` during initial boot. Initial user /pass is ``admin`` / ``admin``. You will be required to create a newadmin password that has at least 1: number, capital letter, and nonalphanumeric symbol.One you do that, reboot and you are on your way.amtctrl-------The ``amt`` library installs a binary ``amtctrl`` for working with AMTenabled machines.machine enrollment~~~~~~~~~~~~~~~~~~To simplify the control commands ``amtcrtl`` has a machineregistry. New machines are added via:amtctrl add <name> <address> <amtpassword>You can see a list of all machines with:amtctrl listAnd remove an existing machine with:amtctrl rm <name>controlling machines~~~~~~~~~~~~~~~~~~~~Once machines are controlled you have a number of options exposed:amtctrl <name> <command>Command is one of:* on - power on the machine* off - power off the machine* reboot - power cycle the machine* pxeboot - set the machine to pxeboot the next time it reboots, andreboot the machine. This is extremely useful if you have installautomation on pxeboot.* status - return power status as an ugly CIM blob (TODO: make this better)Futures-------* More extensive in tree testing (there currently is very little ofthis)* Retry http requests when they fail. AMT processors randomly dropsome connections, built in limited retry should be done.* Fault handling. The current code is *very* optimistic. Hence, the0.x nature.* Remove console control. There are AMT commands to expose a VNCremote console on the box. Want to support those.=========History=========0.8.0 (2017-06-27)------------------* add support for hybernate power state (thanks Chen Rotem Levy)* ensure hostdb is not world readable when created (thanks bodo-riediger)0.7.0 (2017-03-24)------------------* add support for -p flag to prompt for password and bypass hostdb* nice errors to the user when auth fails0.6.0 (2016-10-27)------------------* add support for stand-by power state (thanks Chen Rotem Levy)0.5.0 (2016-10-20)------------------* python 2 fixes for python 3 issues (thanks Chen Rotem Levy)0.4.0 (2016-10-10)------------------* python 3 fixes and testing (thanks Rixillo)0.3.0 (2015-10-08)------------------* python 3 print fix (thanks Mike Nawrocki)* add set_next_boot and change_boot_order_request (thanks John L. Villalovos)0.1.0 (2015-08-09)---------------------* First release on PyPI.