NAME

amttool - remotely control Intel AMT managed machines.

SYNOPSIS

amttool host [ command ] [ arg(s) ]

DESCRIPTION

amttool is a perl script which speaks SOAP to Intel AMT managed machines. It can query informations about the machine in question and also send some commands for basic remote control.
host is the hostname or IP address of the machine amttool should control. command is an optional command.
You must set fill AMT_PASSWORD environment variable with the AMT password.
For more inforamtions on Intel AMT check amt-howto(7).
Note: Starting with AMT 9.0 Intel has removed support for the old SOAP protocol which is used by amttool. Only WS Management (added in AMT 3.0) is supported by recent machines. You can use wsmancli (see http://openwsman.sf.net, your distro should have packages ready) instead.

COMMANDS

info
gather information (default).
reset [ special ]
reset machine, with optional special command (see section below).
powerup [ special ]
turn on machine.
powerdown
turn off machine.
powercycle [ special ]
powercycle machine.
netinfo
print network configuration (requires AMT 2.5+).
netconf if link [ ip mask gw [ dns1 [ dns2 ]]]
configure network interface (requires AMT 2.5+). if is the interface handle, link the link policy. If in doubt just feed in what the netinfo command prints. ip is the IPv4 address, mask the netmask, gw the default gateway, dns1 and dns2 are the DNS Servers. If no IP configuration is specified the tool tries to configure the machine in shared mac address mode with dhcp, otherwise in separate mac address mode with static IP address. Default for dns1 is the gateway address, for dns2 it is 0.0.0.0.

SPECIAL COMMANDS

Special commands can optionally be specified for reset, powerup and powercycle. They change the default boot behavior of the machine.
bios
Asks for the BIOS boot messages being redirected to serial-over-lan.
pxe
Network boot via PXE.
hd
Boot from local disk.
hdsafe
Boot from local disk (safe mode).
cd
Boot from CD/DVD.
diag
Boot in diagnostics mode.

ENVIRONMENT

AMT_PASSWORD
AMT password.
AMT_DEBUG
Enable debug output.

SEE ALSO

amtterm(1), gamt(1), amt-howto(7)

AUTHOR

(c) 2007 Gerd Hoffmann <[email protected]>

Recommended readings

Pages related to amttool you should read also: