# intel-bmc/node-manager architecture

> Architecture diagram of the GitHub repository intel-bmc/node-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/intel-bmc/node-manager
- Repository: https://github.com/intel-bmc/node-manager

## Overview

##### Project type and purpose
- Project Type: C++ standalone service / proxy component
- Purpose: Implements a “Node Manager Proxy” daemon that runs under systemd, forwarding or mediating requests between external clients and Intel’s Node Manager interface.

##### File structure
- Top‐level code:
- NodeManagerProxy.cpp / NodeManagerProxy.hpp (core proxy implementation)
- Build configuration:
- CMakeLists.txt (build rules)
- cmake-format.json, .clang-format (style)
- Packaging / deployment:
- node-manager-proxy.service (systemd unit file)
- Metadata:
- LICENSE, README.md

##### Key README insight
- The project is deprecated by Intel. No architectural details beyond its name and maintenance status.

##### Main components
a. Build subsystem (CMake)
- CMakeLists.txt drives compilation of NodeManagerProxy.cpp/​.hpp into a binary
b. Runtime service (systemd)
- node-manager-proxy.service registered with systemd
c. NodeManagerProxy binary
- Single executable hosting:
- Request listener (e.g., IPC or REST—not specified)
- Request handler / translator logic
- Client‐to‐NodeManager interface
d. External system: Intel Node Manager interface
- Could be a kernel driver, D-Bus API, or hardware management controller

##### Relationships and interactions
- Developers or packaging system invoke CMake → compiles source → produces NodeManagerProxy binary.
- systemd starts NodeManagerProxy via node-manager-proxy.service at boot or on demand.
- Clients (CLI tools or other services) send management requests to the Proxy.
- Proxy translates and forwards these requests to the Node Manager interface.
- Node Manager processes the request (e.g., power, thermal) and returns a response to the proxy, which then replies to the client.

##### Architectural patterns / design principles
- Single‐process, single‐responsibility daemon (UNIX philosophy)
- Separation of concerns: build vs. runtime vs. systemd integration
- Clean interface boundary between client side and hardware‐management side

##### Elements
- CMake build system
- NodeManagerProxy binary
- systemd (service manager)
- External Node Manager interface
- Clients (optional)
- “build” flow: CMake → binary
- “start/stop” control: systemd ↔ binary
- “request/response” data flows: client → proxy → node manager → proxy → client

##### Putting it all together
[CMake build system]
↓ (build)
[NodeManagerProxy binary] ←→ [systemd]
↕ (IPC)
[External Node Manager]
- [Client] on the far left interacting with the proxy’s listener interface.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Build and Source
    subgraph "Build Subsystem"
        CMake["CMake Build"]:::build
        Style1[".clang-format"]:::build
        Style2["cmake-format.json"]:::build
    end
    subgraph "Source Code"
        ProxyCpp["NodeManagerProxy.cpp"]:::code
        ProxyHpp["NodeManagerProxy.hpp"]:::code
    end

    %% Main Flow
    CMake -->|"build"| Binary["NodeManagerProxy Binary"]:::runtime
    Style1 --> CMake
    Style2 --> CMake
    ProxyCpp --> CMake
    ProxyHpp --> CMake

    Binary -->|"start/stop"| Systemd["systemd"]:::runtime
    Binary -->|"translate/forward"| NodeMgr["Intel Node Manager Interface"]:::external
    NodeMgr -->|"response"| Binary
    Client["Clients"]:::client -->|"requests"| Binary
    Binary -->|"respond"| Client

    %% Metadata
    subgraph "Metadata & Docs"
        License["LICENSE"]:::meta
        Readme["README.md"]:::meta
    end

    %% Click Events
    click CMake "https://github.com/intel-bmc/node-manager/blob/master/CMakeLists.txt"
    click Style1 "https://github.com/intel-bmc/node-manager/blob/master/.clang-format"
    click Style2 "https://github.com/intel-bmc/node-manager/blob/master/cmake-format.json"
    click ProxyCpp "https://github.com/intel-bmc/node-manager/blob/master/NodeManagerProxy.cpp"
    click ProxyHpp "https://github.com/intel-bmc/node-manager/blob/master/NodeManagerProxy.hpp"
    click Systemd "https://github.com/intel-bmc/node-manager/blob/master/node-manager-proxy.service"
    click License "https://github.com/intel-bmc/node-manager/tree/master/LICENSE"
    click Readme "https://github.com/intel-bmc/node-manager/blob/master/README.md"

    %% Styles
    classDef build fill:#dddddd,stroke:#888888,stroke-width:1px;
    classDef code fill:#e0e0e0,stroke:#888888,stroke-width:1px;
    classDef runtime fill:#add8e6,stroke:#333f50,stroke-width:1px;
    classDef external fill:#90ee90,stroke:#336633,stroke-width:1px;
    classDef client fill:#fdfd96,stroke:#a68f59,stroke-width:1px;
    classDef meta fill:#ffb6c1,stroke:#cc6699,stroke-width:1px;
```
