hardware-supermicro/stack.yaml at main · agentic-stacks/hardware-supermicro · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
name: hardware-supermicro
namespace: agentic-stacks
description: >
  Teaches AI agents to manage Supermicro server hardware — BMC configuration,
  BIOS management, RAID setup, firmware updates, and hardware inventory.
  Covers X11/X12/X13 platforms with Redfish BMC support. Includes an optional
  container-based toolkit (ipmitool, SUM, SMCIPMITool, storcli, Ansible Redfish)
  so operators can manage Supermicro servers from any OS.

repository: https://github.com/agentic-stacks/hardware-supermicro

target:
  software: Supermicro BMC / BIOS
  versions:
    - "X11 (Xeon Scalable Gen 1/2)"
    - "X12 (Xeon Scalable Gen 3)"
    - "X13 (Xeon Scalable Gen 4/5)"

skills:
  - name: concepts
    entry: skills/foundation/concepts
    description: Supermicro architecture, X11/X12/X13 platforms, BMC fundamentals, Redfish API

  - name: tools
    entry: skills/foundation/tools
    description: Tool landscape — ipmitool, Redfish API, SUM, SMCIPMITool, storcli, IPMIView

  - name: architecture
    entry: skills/foundation/architecture
    description: Container-based vs bare-metal tooling approach, privileged vs remote modes

  - name: container-setup
    entry: skills/deploy/container-setup
    description: Build and run the Supermicro tools container, verify tool availability

  - name: initial-config
    entry: skills/deploy/initial-config
    description: First-time BMC setup — IP, credentials, NTP, DNS, baseline config export

  - name: bios
    entry: skills/operations/bios
    description: BIOS configuration — view, set, export/import via Redfish and SUM, workload profiles

  - name: bmc
    entry: skills/operations/bmc
    description: BMC management — users, alerts, power control, certificates, SNMP, syslog, KVM

  - name: raid
    entry: skills/operations/raid
    description: RAID management — storcli (MegaRAID), HBA/IT mode, VROC, RAID level selection

  - name: firmware
    entry: skills/operations/firmware
    description: Firmware updates — SUM, Redfish, manual flash, rollback, update order

  - name: inventory
    entry: skills/operations/inventory
    description: Hardware inventory — Redfish, ipmitool, dmidecode, lspci, asset export

  - name: ansible
    entry: skills/operations/ansible
    description: Ansible automation — community.general Redfish modules, playbooks for fleet ops

  - name: diagnose-hardware
    entry: skills/diagnose/hardware
    description: Hardware failure diagnosis — power, LEDs, memory, CPU thermal, fans, PSU

  - name: diagnose-connectivity
    entry: skills/diagnose/connectivity
    description: BMC/network connectivity troubleshooting — unreachable BMC, NIC issues, VLAN

  - name: diagnose-storage
    entry: skills/diagnose/storage
    description: Storage troubleshooting — foreign drives, rebuild, degraded arrays, boot failures

  - name: known-issues
    entry: skills/reference/known-issues
    description: Version-specific bugs and workarounds for Supermicro BMC/BIOS firmware

  - name: compatibility
    entry: skills/reference/compatibility
    description: Compatibility matrices — X11/X12/X13, BMC firmware versions, tool support

  - name: decision-guides
    entry: skills/reference/decision-guides
    description: Decision aids — ipmitool vs Redfish vs SUM, RAID levels, config approaches

project:
  structure:
    - workspace/configs/       # BMC/BIOS config exports
    - workspace/firmware/      # Downloaded firmware bundles
    - workspace/playbooks/     # Ansible playbooks for fleet management
    - workspace/inventory/     # Hardware inventory exports
    - .env                     # BMC credentials (gitignored)
    - container/               # Dockerfile and docker-compose

requires:
  tools:
    - name: docker
      description: Container runtime for Supermicro tools container (optional)
    - name: docker-compose
      description: Service orchestration for tools container (optional)
    - name: git
      description: Version control for configs and playbooks
    - name: curl
      description: Redfish API calls (available on most systems)
    - name: jq
      description: JSON processing for Redfish API responses

depends_on: []