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>

                                    (c) 2007,08 Gerd Hoffmann                          amttool(1)