1. Introduction
The IPU-M2000 baseboard management controller (BMC) is an ASPEED AST2520, running software based on the OpenBMC project.
The responsibilities of the BMC software stack are to control, monitor and manage system hardware, including power, sensors, inventories and event logging. You can control this management and monitoring using a variety of user interfaces such as a command line interface (CLI), graphical user interface (GUI), REST, IPMI and Redfish.
This document describes these functions and the different interfaces provided by the BMC software on an IPU-M2000.
Note
Note that setting a power cap is an advance preview feature in the current versions of the IPU-M2000 device. It will be fully qualified in early 2021.
To access the BMC, you will need the following information from the system administrator:
BMC host name or IP address
OpenBMC user ID and password
Initially, there will a single default user account on the BMC. When you log in as that user you can create further accounts, if you wish (see Section 8, User management).
1.1. BMC command line interface
To use the command-line interface, you must be logged in to the BMC via SSH or the serial console.
The command line interface uses either standard Linux commands or the ipum_utils
command.
1.2. Graphical user interface
A graphical user interface (GUI) to the BMC is available. This can be accessed using a web browser.
1.3. REST API
You can send REST API commands using curl
or the openbmctool.py
command line tool on
the host server.
OpenBMC recommends token-based authentication when using the REST interface and provides some command examples, including power related operations. See the “cheatsheet”. A successful REST command results in a “200 OK” message as shown below:
{
"data": null,
"message": "200 OK",
"status": "ok"
}
1.4. IPMI
You can use the the ipmitool
to control the BMC over IPMI. This can be downloaded from
https://github.com/ipmitool/ipmitool.
1.5. Redfish
The Redfish standard is a suite of specifications that deliver an industry standard protocol providing a RESTful interface for the management of servers, storage and networking.
The IPU-M2000 BMC supports a Redfish basic profile. You can perform operations through the
Redfish interface by sending curl
queries to the URI. You can also use a browser to
access the Redfish GUI.
1.6. Abbreviations and acronyms
The following abbreviations are used throughout this document.
Abbreviation |
Description |
---|---|
BIST |
Built-in self test |
BMC |
Baseboard management controller |
CLI |
Command line interface |
GUI |
Graphical user interface |
FRU |
Field replaceable unit |
IPMI |
Intelligent platform management interface |
IPU |
Intelligence Processing Unit |
REST |
Representational state transfer |
SDR |
Sensor data record |
SEL |
System event log |
SNMP |
Simple network management protocol |
SOL |
Serial over LAN |