amttool(1)

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 <kraxel@redhat.com>