This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description
===============================
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/amt


Tools for interacting with Intel's Active Management Technology

Background
----------

AMT is a light weight hardware control interface put into some Intel
based laptops and desktops as a tool for corporate fleets to manage
hardware. It provides the basics of power control, as well as remote
console via VNC. It functions by having a dedicated service processor
sniff traffic off the network card on specific ports before it gets to
the operating system. Some versions of Intel NUC boxes have AMT, which
make them ideal candidates for building a reasonable cluster in your
basement.

There was once a tool called ``amttool`` which let you interact with
these systems from Linux. This used the SOAP interface to AMT. That
was removed in v9 of the firmware, which means it no longer works with
modern AMT in the field.

The interface that remains is CIM, a standard from the DMTF that
builds XML models for all the things. There exist very few examples
for how to make this work on the internet, with one exception: the
OpenStack Baremetal (Ironic) service. It has native support for AMT
hardware control.

This project is derivative work from Ironic. The heavy lifting of
understanding all the CIM magic incantations, and oh the magic they
are, 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 Intel
based laptops. There are also specific models of Intel NUC that
include vPro.

* `Intel NUC KIT Core Processor BLKNUC5I5MYHE <http: amzn.to="" 1ozshhf="">`_

This code gets tested with ``5i5MYHE`` NUCs as well as an older NUC
that I have laying around.


Configuring AMT
---------------

AMT must be enabled in the BIOS before it can be used externally. This
is done by pressing ``Ctrl-P`` during initial boot. Initial user /
pass is ``admin`` / ``admin``. You will be required to create a new
admin password that has at least 1: number, capital letter, and non
alphanumeric symbol.

One you do that, reboot and you are on your way.

amtctrl
-------

The ``amt`` library installs a binary ``amtctrl`` for working with AMT
enabled machines.

machine enrollment
~~~~~~~~~~~~~~~~~~

To simplify the control commands ``amtcrtl`` has a machine
registry. New machines are added via:

amtctrl add <name> <address> <amtpassword>

You can see a list of all machines with:

amtctrl list

And 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, and
reboot the machine. This is extremely useful if you have install
automation 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 of
this)

* Retry http requests when they fail. AMT processors randomly drop
some connections, built in limited retry should be done.

* Fault handling. The current code is *very* optimistic. Hence, the
0.x nature.

* Remove console control. There are AMT commands to expose a VNC
remote console on the box. Want to support those.




History
-------

0.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.
Release History

Release History

0.6.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.5.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.4.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.3.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.2.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
amt-0.6.0.tar.gz (23.7 kB) Copy SHA256 Checksum SHA256 Source Oct 27, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting