Getting Started

Connection Options

Every command requires credentials. Supply them as CLI flags or environment variables.

Environment Variables (recommended)

export BMC_HOST=10.10.10.10
export BMC_USERNAME=admin
export BMC_PASSWORD=password

bmctools redfish boot get-order

Inline Flags

bmctools -i 10.10.10.10 -u admin -p password redfish boot get-order

Option	Env Variable	Description
-i, --ip, --host	BMC_HOST	BMC IP address or hostname
-u, --username	BMC_USERNAME	BMC username
-p, --password	BMC_PASSWORD	BMC password
-m, --manufacturer	BMC_MANUFACTURER	Force vendor: asus dell supermicro gigabyte cisco
-k, --insecure	BMC_INSECURE	Disable SSL verification (default: on)
-o, --output		Output format: json json-pretty table text
-v, --verbose		Verbose output
-d, --debug		Show full stack traces
--no-color	NO_COLOR	Disable coloured output

---

Boot Management

# View current boot order
bmctools redfish boot get-order

# List all available boot options
bmctools redfish boot list-options -o table

# Find the PXE boot option for a specific NIC
bmctools redfish boot find-by-mac -m 04:32:01:D8:C0:B0 --type PXE

# Set a new boot order (must include ALL options)
bmctools redfish boot set-order -o "Boot0003,Boot0001,Boot0000,Boot0002"

# One-time PXE boot
bmctools redfish boot set-override -t Pxe --mode Once

Caution

set-order replaces the entire boot order list. All existing options must be included or they will be removed.

---

System Management

bmctools redfish system info                           # show system info
bmctools redfish system reset                          # graceful restart
bmctools redfish system reset --type ForceRestart
bmctools redfish system reset --type ForceOff
bmctools redfish system reset-types                    # list supported reset types

---

Firmware

bmctools redfish firmware inventory -o table
bmctools redfish firmware update-bios -f /path/to/bios.bin
bmctools redfish firmware update-bmc  -f /path/to/bmc.bin

---

IPMI

bmctools ipmi power status
bmctools ipmi power on
bmctools ipmi power off
bmctools ipmi power reset
bmctools ipmi sel list
bmctools ipmi sel list --age 24h

---

Dell-Specific

bmctools redfish dell get-nics
bmctools redfish dell pxe-boot -m 04:32:01:D8:C0:B0

---

Python Library

Redfish

from bmctools.redfish.redfish import Redfish

rf = Redfish('10.10.10.10', 'admin', 'password', verify_ssl=False)

print(rf.manufacturer)   # auto-detected: "dell", "asus", "supermicro", etc.

boot_order   = rf.get_boot_order()
boot_options = rf.get_boot_options()
option       = rf.get_boot_option_by_mac('04:32:01:D8:C0:B0', type='PXE')

rf.set_boot_order(["Boot0003", "Boot0001", "Boot0000"])
rf.reset_system()                   # graceful
rf.reset_system(reset_type='ForceOff')

IPMI

from bmctools.ipmi.ipmitool import IpmiTool

bmc = IpmiTool('10.10.10.10', 'admin', 'password')
print(bmc.power_status())
bmc.power_reset()

for entry in bmc.sel_list():
    print(entry)

RACADM (Dell)

from bmctools.racadm.racadm import Racadm

r = Racadm('10.10.10.10', 'admin', 'password')
result = r.racadm_command('get BIOS.SysProfileSettings')
print(result)

---

Raw Redfish Exploration

bmctools redfish raw /redfish/v1 -o json-pretty
bmctools redfish raw /redfish/v1/Systems
bmctools redfish raw /redfish/v1/Managers/1
bmctools redfish raw /redfish/v1/Chassis