README.md

Hardware setup container

This repository contains a Dockerfile and associated tools to build a container image for configuring/monitoring server BMC and BIOS.

Specifically, the image bundles racadm from OMSA for Dell servers.

Usage

Build

$ cd setup-hw
$ make build-image

Run as a system service

The container need to be run as a system service before using racadm or setup-hw.

$ sudo mkdir -p /var/lib/setup-hw

$ docker run -d --name=setup-hw \
  --net=host --privileged \
  -v /dev:/dev \
  -v /lib/modules:/lib/modules:ro \
  -v /etc/neco:/etc/neco:ro \
  -v /var/lib/setup-hw:/var/lib/setup-hw \
  setup-hw:latest

Docker images

Docker images are available on ghcr.io

Access monitor-hw

monitor-hw is the default command of the container. When you run the container, it starts exporting hardware metrics for Prometheus. You can see the metrics from http://localhost:9105/metrics by default.

You must prepare configuration files before running monitor-hw.

Run racadm

$ docker exec setup-hw racadm ...

Run setup-hw

setup-hw is a tool to configure BMC and BIOS of the running server. See the document for details.