_______ ___ _______ _______ __ __ _______ ______ | || | | _ || || | | || || _ | | ___|| | | |_| || _____|| |_| || ___|| | || | |___ | | | || |_____ | || |___ | |_||_ | ___|| |___ | ||_____ || || ___|| __ | | | | || _ | _____| || _ || |___ | | | | |___| |_______||__| |__||_______||__| |__||_______||___| |_|
Flasher is a vendor agnostic tool to automate firmware installs across a server fleet.
Flasher is currently limited to installing firmware Out of band - through the host BMC,
and expects the host BMC to be reachable to install firmware.
If the given server is powered off, it will be powered on, the firmware will be install and powered off after.
When a firmware requires the server to be power cycled, flasher will perform the power cycle action and poll until the firmware install is completed.
make build-linux
Flasher can be run in the worker mode or to one-shot install a given firmware file.
Note: it expects to be able to reach the BMC interface for the given server.
In the worker mode flasher worker, flasher depends on NATS to
accept work, a secret store for BMC secrets, a firmware file store for firmware files to install.
Check out the sandbox for steps to have it running along with its dependencies.
The sandbox README.md includes instructions to register a server, create firmware sets and install them on a server.
The diagram below depicts the services flasher depends on:
graph TB
a((Flasher))-- 1. Query Asset BMC creds, attributes -->ss[(FleetDBAPI)]
a((Flasher))-- 2. Query current inventory -->sb(ServerA BMC)
a((Flasher))-- 3. Fetch firmware files -->sa(Firmware file store)
a((Flasher))-- 4. install firmware -->sb(ServerA BMC)
The flasher install command will install the given firmware file on a server,
and poll until the install is complete.
flasher install --addr 192.168.1.1 \
--user ADMIN \
--pass hunder2 \
--version 3.6 \
--component bios \
--vendor supermicro \
--model x11dph-t \
--force \
--file /tmp/BIOS_X11DPH-0981_20220208_3.6_STD.bin \
--dry-run \see cheatsheet.md
For out of band updates, Flasher leverages bmclib and so supports firmware installs on devices that are supported by the library.
As of this writing, it supports Dell PowerEdge, Supermicro X11, X12, Asrockrack updates through their BMC.
Documentation on development and flasher implementation can be found in docs