README.md
1amtc [](https://travis-ci.org/schnoddelbotz/amtc) [](https://insight.sensiolabs.com/projects/e1b66082-35ba-44e5-b460-766bfb918574)
2================================
3
4`amtc` - Intel [vPro](http://de.wikipedia.org/wiki/Intel_vPro) [AMT](http://en.wikipedia.org/wiki/Intel_Active_Management_Technology) / [WS-Management](http://en.wikipedia.org/wiki/WS-Management) mass remote power management tool
5
6features
7========
8
9* performs vital AMT operations (info, powerup, powerdown, reset...)
10* threaded, thus fast (queries 180 Core i5 PCs in a quarter of a second (using EOI and no TLS))
11* allows mass-powerups/downs/... using a custom delay
12* lightweight C application, only depends on libcurl, gnutls and pthreads
13* currently builds fine on linux and OSX (and windows via cygwin; unverified since 0.4.0)
14* allows quick and comfortable mass-power control via shell and...
15* comes with a [EmberJS](http://www.emberjs.com/)-based web interface called `amtc-web`,
16 that depends on [Slim](http://www.slimframework.com/) and
17 [Idiorm and Paris](http://j4mie.github.io/idiormandparis/) to provide a JSON backend
18 for these `amtc-web` features:
19 * realtime power state monitoring via AMT© including OS TCP port probing/detection
20 * anachronous OOB power control using a database-driven job queue
21 * power/OS-monitoring logging with [notyet:] graphing
22 * management of master file data like rooms and hosts to control
23 * setup (of atmc-web itself, i.e. providing database connection details etc.)
24* acts as a tool for flexible and robust scheduled remote power management (which is true for amtc itself and amtc-web; amtc-web just adds another layer of comfort regarding shell interaction with your many hosts).
25
26<img src="screenshots/setup.png" width="200px" />
27<img src="screenshots/dashboard.png" width="200px" />
28<img src="screenshots/monitor-states.png" width="200px" />
29<img src="screenshots/monitor-selection.png" width="200px" />
30<img src="screenshots/manage-addhosts.png" width="200px" />
31<img src="screenshots/manage-schedule.png" width="200px" />
32
33usage
34=====
35
36```
37 amtc v0.8.5 - Intel AMT & WS-Man OOB mass management tool
38 https://github.com/schnoddelbotz/amtc
39 usage
40 amtc [-actions] [-options] host [host ...]
41
42 actions
43 -I(nfo) query powerstate via AMT [default]
44 -U(p) powerup given host(s)
45 -D(own) powerdown
46 -C(ycle) powercycle
47 -R(eset) reset
48 -S(hutdown) using AMT graceful shutdown (AMT 9.0+)
49 -L(ist) valid wsman <classname>s for -E(numeration)
50 -E(numerate)<classname> enumerate/list settings
51 -M(odify) <setting>=<value> modify wsman settings
52 where supported settings: webui,sol or ping
53 and supported values : on or off
54 options
55 -5 for AMT 5.0 hosts
56 -d for AMT 9.0+ hosts - use WS-Man/DASH
57 -m(aximum) number of parallel workers to use [40]
58 -p(asswdfile) specify file containing AMT password
59 -j(son) produces JSON output of host states
60 -q(uiet) only report unsuccessful operations
61 -r(DP)-scan probe TCP port 3389 for OS detection
62 -s(SH)-scan probe TCP port 22 for OS detection
63 -e(nforce) rdp/ssh probes, regardless of AMT state
64 -t(imeout) in seconds, for amt and tcp scans [5]
65 -g(nutls) will use TLS and port 16993 [notls/16992]
66 -c(acert) specify TLS CA cert file [/etc/amt-ca.crt]
67 -n(oVerify) will skip cert verification for TLS
68 -v(erbose) detailed progress, debug by using -vvv
69 -w(ait) in seconds / float, after each pc. one thread.
70
71```
72
73status
74======
75ever-pre-1.0. just for fun. against all odds. works for me... check the [changelog](CHANGELOG.md).
76
77You may want to [give amtc-web a try](http://jan.hacker.ch/projects/amtc/demo) --
78just login with setup default credentials (admin/amtc). The demo page runs off a read-only
79sqlite database so you shouldn't be able to make any changes.
80
81`amtc` 0.8.0 introduced the -E option, which serves for retreiving system
82configuration and asset management data. Currently, amtc will not parse
83those replies and just dump the raw SOAP reply. amtc-web currently
84offers no way yet to retreive/display those values. This will improve,
85sooner or later... stay tuned.
86
87Honestly, in some aspects, `amtc` [still] is a hack. The most obvious
88one is: amtc has no clue of SOAP. It dumbly replays control commands
89I once wiresharked (see the cmd_* and wsman_* files in src dir).
90Other tools available most likely do the right thing™ and use
91a real SOAP library like [gSOAP](http://www.cs.fsu.edu/~engelen/soap.html).
92If you're hit by this hack, please file a bug of an amtc-run
93using -vvvv option -- thanks!
94
95building, installation
96======================
97See [INSTALL.md](INSTALL.md).
98
99license
100=======
101This project is published under the [MIT license](LICENSE.txt).
102It heavily relies on bundled 3rd party OSS components that are listed in the
103in-app ['about' page](amtc-web/pages/about.md) of amtc-web;
104their individual license texts have been bundled into
105[LICENSES-3rd-party.txt](amtc-web/LICENSES-3rd-party.txt). That file is also
106distributed with any [release of amtc](https://github.com/schnoddelbotz/amtc/releases).
107
108alternatives
109============
110- [amttool](http://www.kraxel.org/cgit/amtterm/tree/amttool):
111 Without amttool, there would be no amtc. Thanks!
112 amttool is implemented in perl and intended for interactive, verbose single-host operation.
113 amtc is implemented in C, and by using threads optimized for quick, succinct (non-)interactive mass-operation.
114- [amttool_tng](http://sourceforge.net/projects/amttool-tng):
115 The next generation. Even more config stuff.
116- [vTul](https://github.com/Tulpep/vTul):
117 A windows powershell based GUI. Again, completely different story.
118- for DASH-only use, the best choice for windows CLI scenarios is most likely AMD's [dashcli](http://developer.amd.com/tools-and-sdks/cpu-development/client-management-tools-for-dmtf-dash/). Find MS SCCM plugins there, too.
119- bootstrap your own using the [intel AMT SDK](http://software.intel.com/sites/manageability/AMT_Implementation_and_Reference_Guide)
120- [OpenWSMAN](http://openwsman.github.io/): Correct SOAP implementation, rich feature set.
121
){kind=link}
){kind=link}
