amttool(1)

1amttool(1)                  General Commands Manual                 amttool(1)
2
3
4

NAME

6       amttool - remotely control Intel AMT managed machines.
7

SYNOPSIS

9       amttool host [ command ] [ arg(s) ]
10

DESCRIPTION

12       amttool  is  a  perl  script  which  speaks  SOAP  to Intel AMT managed
13       machines.  It can query informations about the machine in question  and
14       also send some commands for basic remote control.
15
16       host  is  the hostname or IP address of the machine amttool should con‐
17       trol.  command is an optional command.
18
19       You must set fill AMT_PASSWORD environment variable with the AMT  pass‐
20       word.
21
22       For more inforamtions on Intel AMT check amt-howto(7).
23
24       Note:  Starting with AMT 9.0 Intel has removed support for the old SOAP
25       protocol which is used by amttool.  Only WS Management  (added  in  AMT
26       3.0)  is  supported  by  recent  machines.   You  can use wsmancli (see
27       http://openwsman.sf.net,  your  distro  should  have  packages   ready)
28       instead.
29

COMMANDS

31       info   gather information (default).
32
33       reset [ special ]
34              reset  machine,  with  optional  special  command  (see  section
35              below).
36
37       powerup [ special ]
38              turn on machine.
39
40       powerdown
41              turn off machine.
42
43       powercycle [ special ]
44              powercycle machine.
45
46       netinfo
47              print network configuration (requires AMT 2.5+).
48
49       netconf if link [ ip mask gw [ dns1 [ dns2 ]]]
50              configure network interface (requires  AMT  2.5+).   if  is  the
51              interface  handle,  link the link policy.  If in doubt just feed
52              in what the netinfo command prints.  ip  is  the  IPv4  address,
53              mask  the netmask, gw the default gateway, dns1 and dns2 are the
54              DNS Servers.  If no IP configuration is specified the tool tries
55              to  configure  the machine in shared mac address mode with dhcp,
56              otherwise in separate mac address mode with static  IP  address.
57              Default for dns1 is the gateway address, for dns2 it is 0.0.0.0.
58

SPECIAL COMMANDS

60       Special  commands  can  optionally  be specified for reset, powerup and
61       powercycle.  They change the default boot behavior of the machine.
62
63       bios   Asks for the BIOS boot messages being redirected to serial-over-
64              lan.
65
66       pxe    Network boot via PXE.
67
68       hd     Boot from local disk.
69
70       hdsafe Boot from local disk (safe mode).
71
72       cd     Boot from CD/DVD.
73
74       diag   Boot in diagnostics mode.
75

ENVIRONMENT

77       AMT_PASSWORD
78              AMT password.
79
80       AMT_DEBUG
81              Enable debug output.
82

AUTHOR

87       (c) 2007 Gerd Hoffmann <kraxel@redhat.com>
88
89
90
91                           (c) 2007,08 Gerd Hoffmann                amttool(1)