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.conffile 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_onceIf 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 see | COM2 | COM1 | Screen |
|---|---|---|---|
| Boot menu, UEFI start | yes | yes | yes |
| Boot menu, legacy BIOS start | yes | no | yes |
| Start-up messages | yes | no | yes |
| Agent screens | yes | yes | yes |
- Ports: COM1 is
ttyS0(I/O0x3f8), COM2 isttyS1(I/O0x2f8). 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 card | Status |
|---|---|
| HPE iLO 4, legacy BIOS start | Works: 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 generations | Expected to work the same way |
| Dell iDRAC | Expected to work the same way |
| Lenovo XClarity / IMM | Expected to work the same way |
| Any card, UEFI start | Expected 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).
Prepare the boot medium
Write the agent ISO to a USB stick with a tool that copies it exactly and check the stick, or prepare a reports key to start from a CD or a virtual DVD.
Start the agent over the network (PXE)
Starting over the network (PXE) is not supported in this release. What it would need today, a USB stick written from your ISO, and what the next release brings.