amttool(1)

✨ NAME ✨

okay so first things first, bestie: amttool - remotely control Intel AMT managed machines 💻✨

🌸 SYNOPSIS 🌸

amttool host [ command ] [ arg(s) ]

💖 DESCRIPTION 💖

okay so amttool is a perl script that speaks SOAP to Intel AMT managed machines 🫶 it can look up info about the machine and also send some basic remote control commands. literally so useful 😭

host is the hostname or IP address of the machine you want amttool to control. command is optional, so you don't have to pick one 💅

you must set the AMT_PASSWORD environment variable to your AMT password 🔐 no password, no slay.

for more intel on Intel AMT, check amt-howto(7) 📖

⚠️ heads up, this one matters: starting with AMT 9.0, Intel dropped support for the old SOAP protocol that amttool uses 💀 only WS Management (added in AMT 3.0) works on recent machines. for those, try wsmancli instead (see http://openwsman.sf.net, your distro should have packages ready) 🦋

👑 COMMANDS 👑

• info — gather info about the machine (this is the default, iconic behavior 💜)
• reset [ special ] — reset the machine, with an optional special command (see the SPECIAL COMMANDS section below) 🔄
• powerup [ special ] — turn the machine on ⚡ (also takes an optional special command)
• powerdown — turn the machine off 🌙
• powercycle [ special ] — powercycle the machine 🔁 (also takes an optional special command)
• netinfo — print the network configuration 🌐 (needs AMT 2.5+)
• netconf if link [ ip mask gw [ dns1 [ dns2 ]]] — configure a network interface 🎀 (needs AMT 2.5+) here's the vibe check:
  • if is the interface handle, and link is the link policy
  • ip is the IPv4 address, mask is the netmask, and gw is the default gateway
  • dns1 and dns2 are the DNS servers
  • if you don't give any IP config, the tool tries to set the machine up in shared MAC address mode with DHCP. otherwise, it goes with separate MAC address mode and a static IP address
  • the default for dns1 is the gateway address, and the default for dns2 is 0.0.0.0
  • if you're confused about what to feed in, just copy what netinfo prints 🫶

🦋 SPECIAL COMMANDS 🦋

special commands can be added to reset, powerup and powercycle 🌈 they change how the machine boots by default:

• bios — asks for the BIOS boot messages to be redirected to serial-over-lan 📟
• pxe — network boot via PXE 🌐
• hd — boot from the local disk 💾
• hdsafe — boot from the local disk, in safe mode 🛡️
• cd — boot from CD/DVD 💿
• diag — boot into diagnostics mode 🩺

🍓 ENVIRONMENT 🍓

• AMT_PASSWORD — your AMT password 🔑
• AMT_DEBUG — turns on debug output 🐛

🧚 SEE ALSO 🧚

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

💜 AUTHOR 💜

(c) 2007 Gerd Hoffmann <kraxel@redhat.com> 🙈

that's the whole tea, bestie 🫶 this page is (c) 2007,08 Gerd Hoffmann, filed under amttool(1) ✨ slay forever 🌸