Exaion
Using the Agent

Start a server through its management card

Start a server from the agent ISO through its management card (iLO, iDRAC, XClarity), keep the proof on a reports key and follow the session from the serial console.

A management card is the small computer built into a server that lets you control it over the network: HPE calls it iLO, Dell iDRAC, Lenovo XClarity (formerly IMM). With it, you can start the server from the agent ISO without going to the server room, except once to plug in a USB key.

What you need

  • The agent ISO of your organization (Download the agent), placed on a web server the management card can reach.
  • A reports key, plugged into a USB port of the server itself. The ISO mounted by the card behaves like a CD: it has no room for the proof, so the agent keeps it on the reports key.
  • Access to the management card's web page or command line, and to its serial console or its remote console (the window that shows the server's screen).
  • For a non-interactive session, the operator's name or email in the exawipe.conf file of the reports key: nobody types it during the session. See Prepare a session in advance.

Start the server

Plug in the reports key

Plug the reports key into a USB port of the server. Leave it there until the session has ended.

Mount the ISO as a virtual DVD

In the management card, open the virtual media, choose the virtual CD/DVD and give the address (URL) of the agent ISO. Do not use the virtual USB key or virtual floppy: see What does not work.

Boot once from the virtual DVD

Set the virtual DVD as the boot device for the next start only.

On HPE iLO 4, this covers a single start: at the next restart the card drops the ISO, even if it still shows it as connected. Mount the ISO again before each session.

Open a console

Open the card's serial console or its remote console now, before restarting, so as not to miss the boot menu.

Restart the server

Restart the server. The agent's boot menu appears and starts Exaion Wipe - interactive mode, the interactive mode, by itself after 10 seconds. To choose the non-interactive mode, see The boot menu.

Run the session

The agent starts by itself after the menu: start-up messages scroll, then its first screen appears. From a virtual DVD, this takes a few minutes, and the screen may show the agent's left column alone for a while before the first step: this is normal. Follow the agent's screens from the console: see An interactive session, step by step. At the end, the agent stores the proof on the reports key (Proof stored on the key), then shows what the portal answered.

On HPE iLO 4, from the card's command line, these commands mount the ISO and boot from it once. Run them again before each session. Then open the serial console with vsp, and restart the server:

vm cdrom insert <url>/<agent ISO>
vm cdrom set connect
vm cdrom set boot_once

If no reports key is plugged in, the agent refuses the session with No reports partition: start from a USB key of the ISO, or plug in a reports key. It also refuses it when it finds more than one reports key.

Follow the session from the serial console

The agent draws its screens on the server's screen and on both serial ports at once, so you can use whichever the card gives you. Nothing needs to be set on the server.

Several consoles can be open at the same time, and you can answer on any of them. The others say which one answered last, for example Last answer came from the serial console ttyS1; you may answer here too. An answer typed on a screen that has changed since is refused with The session changed since your last screen. Read the new state and try again.

Most management cards carry their serial console on the server's second serial port (COM2), and that is where the agent shows the most:

What you seeCOM2COM1Screen
Boot menu, UEFI startyesyesyes
Boot menu, legacy BIOS startyesnoyes
Start-up messagesyesnoyes
Agent screensyesyesyes
  • Ports: COM1 is ttyS0 (I/O 0x3f8), COM2 is ttyS1 (I/O 0x2f8). Settings: 115200 baud, 8 data bits, no parity, 1 stop bit.
  • Kernel line: console=tty0 console=ttyS1,115200n8 console=ttyS0,115200n8.
  • Usual serial console port: COM2 on HPE iLO, Dell iDRAC and Lenovo IMM; COM1 on a physical serial port. iLO 4 shows Virtual Serial Port Active: COM2.
  • On a card that uses COM1, a legacy BIOS start shows the boot menu only on the screen, and the start-up messages do not reach the serial console.
  • Ports beyond COM2 (extra PCI serial cards, Intel AMT serial-over-LAN) are not used.

Leave the server's BIOS serial redirection (BIOS serial console) off. When it is on, each key typed on the serial console reaches the boot menu twice and the menu cannot be driven.

Which cards work

Management cardStatus
HPE iLO 4, legacy BIOS startWorks: virtual DVD by URL, boot menu on the remote console and the serial console, physical reports key, interactive and non-interactive sessions
Other HPE iLO generationsExpected to work the same way
Dell iDRACExpected to work the same way
Lenovo XClarity / IMMExpected to work the same way
Any card, UEFI startExpected to work the same way

"The same way" means a virtual DVD mounted by URL, a reports key in the server's USB port and a serial console on COM2 or COM1.

What does not work

  • The card's virtual USB key. On iLO 4 the server does not start from it, and anything written to it is lost without an error: the card tries to send each write back to the web server, which refuses it. Use the virtual DVD and a physical reports key. Only iLO 4 is documented here.
  • Starting over the network (PXE) is not supported in this release: see Start the agent over the network (PXE).

Contents