Editing Hardware Management/SpecsAndDesigns

==Specs and Designs==

This page contains links to the Specs ad Designs for the OCP Hardware Management Project

=== OCP Redfish Profile ===

Profiles can be found at [https://github.com/opencomputeproject/HWMgmt-OCP-Profiles OCP Profile repository]. The [https://drive.google.com/file/d/1R05H0LaqG9DmTDJdMGhKkLckpwIfeONT/view?usp=sharing Redfish Interop Validator] will test conformance against a profile.

{| class="wikitable"
|+ style="text-align: left" | Approved documents
|-
! Document
! Version
! Date
! Description
! License
|-
| [https://www.opencompute.org/documents/usage-guide-for-baseline-hw-mgmt-api-v1-0-1-final-pdf Usage Guide for Baseline Profile]
| v1.0.1
| 2021
| Usage Guide for the Baseline Hardware Management API v1.0.1
| CC
|-
|-
| [https://www.opencompute.org/documents/openrmc-1-0-0-usageguide-final-b-1-pdf Usage Guide for OpenRMC Northbound Profile]
| v1.0.0
| 2021
| Usage Guide for the OpenRMC Northbound API v1.0.0
| CC
|-
| [https://drive.google.com/file/d/16Z8FvsHM1aD3rqGVPpouxH14-SNF3qgj Usage Guide for Server Profile]
| v1.0.0
| 2021
| Usage Guide for the Server Hardware Management API v1.0.0
| CC
|}

{| class="wikitable"
|+ style="text-align: left" | Specs under review
|-
! Document
! Version
! Date
! Description
! License
|-
| none
| -
| -
| -
|-
|}

{| class="wikitable"
|+ style="text-align: left" | Related documents
|-
! Document
! Version
! Date
! Description
! License
|-
| [https://www.dmtf.org/standards/wip DMTF WIP] and [https://www.dmtf.org/standards/redfish DMTF Redfish]
| -
| -
| Collection of DMTF work in progress, and the official DMTF Redfish Forum repository
| -
|-
| [http://files.opencompute.org/oc/public.php?service=files&t=bb5d7c90ec35fa97759e065c5dbf5c38 Redfish OCP Profile (XLS)]
| v0.5
| June 1, 2016
| Mapping Redfish properties to OCP requirements (initial worksheet)
| -
|-
| [http://files.opencompute.org/oc/public.php?service=files&t=e60b2f8bbcf6ebb615d19551f278345a Redfish OCP Profile]
| v1
| Feb 21, 2017
| Presentation to the HW Management group meeting
| -
|-
|-
| [https://drive.google.com/file/d/1R05H0LaqG9DmTDJdMGhKkLckpwIfeONT/view?usp=sharing Redfish Conformance Test Suite]
| -
| 2021
| The Redfish Forum's Guidance for a Conformance Test Suite
| -
|-
| [http://files.opencompute.org/oc/public.php?service=files&t=c745936fcddec29ce2a08c6bf69ff75f OpenBMC]
| -
| Nov 17, 2016
| Presentation to the HW Management group meeting
| -
|}

----

===DRAFT Requirements for Firmware Update===

The draft specification identifies the firmware update requirements that all OCP compliant platforms and devices must adhere to. 
The Firmware Update solution is for the application the user interfaces and the capabilities of the embedded firmware on the servers, switches and storage devices. 
The requirements are broken into four sections: 
# General: general firmware update requirements
# Security: requirements related to the integrity and authenticity of the image
# Control: requirements related to how firmware updates are controlled
# Status: requirements related to how/what status is available

[http://files.opencompute.org/oc/public.php?service=files&t=c3ee8db5c9e64c1ddecc71fe084afaf0 Firmware Update Requirements version 0.2b PDF]
----

===Cloud Server Multi Node System Specification===

A description and requirements of a Cloud Server which is either a server, enclosure or rack that contains other uniquely addressable and managable devices.
The document's purpose is to have a single Ethernet connection to the Cloud Server and document the possible bus architectures, managment protocols and minimum expected functionality of the Nodes contained in the Cloud Server. 

The Clould Server's BMC with a Ethernet connection to the outside world is the called the Spine BMC and IPMI RMCP or RESTfull protocols are allowed. Internally the Spine BMC communicates to the Node using SMBus and GPIO which determines Node presence, Node power control and ALERT signaling.

The Node requirements include a subset of the IPMI 2.0 commands. The Spine BMC may have a Serial Console session to each Node.

[http://files.opencompute.org/oc/public.php?service=files&t=1eb58f54e79a48f0007de6b7379a093f Cloud Server Multi Node System Specification version V0.7.5, Date August 19,2015  PDF]

----
===Presentations===
* [https://146a55aca6f00848c565-a7635525d40ac1c70300198708936b4e.ssl.cf1.rackcdn.com/images/94f8a3478db56eef7e8868159d193633c0116938.pdf OCP Profiles for Hardware Management] - presented by Hemal Shah and John Leung, OCP Global Summit 2019.
* [https://146a55aca6f00848c565-a7635525d40ac1c70300198708936b4e.ssl.cf1.rackcdn.com/images/efcddf341fa55a63177c0180152f6d59ed23449e.pdf PMCI Standards for Hardware Management] - presented by Hemal Shah and Patrick Caporale, OCP Global Summit 2019.
* [https://drive.google.com/file/d/1qnUHIevSUUe3Bszg85EJiCTPar484wOm/edit Common Profile Updates] -Process & Status, August 6, 2020

----

===Links to Open Source Projects===
* [https://en.wikipedia.org/wiki/OpenBMC Link to OpenBMC]

----

===DRAFT Hardware Management Specifications for IPMI (Legacy)===

Proposed specifications for the IPMI implementation on any device using IPMI. This includes PDUs, Servers, Switches and Storage devices.
The specifications allow a Data Center System Manager uniform remote access to the hardware in the rack. All the specifications have questions in red.

{| class="wikitable"
|+ OCP Specifications for IPMI
|-
! Specification
! Version
! Date
| Description
|-
| [http://files.opencompute.org/oc/public.php?service=files&t=3158cab091d0dbd1c4c283a32c7c26f7 OCP ID]
| 0.04
| June 9, 2014
| Identify all OCP specifications implemented by a single IPM Controller
|-
| [http://files.opencompute.org/oc/public.php?service=files&t=7e7ae048c1da42ae73f34231759dcebf ICAP Base]
| 0.02
| June 9, 2014
| The basic functions of an OCP IPM Controller that a Data Center System Manager depends on
|-
| [http://files.opencompute.org/oc/public.php?service=files&t=c56cbe48527af22e1d9a25f6603edcff ICAP OPTI]
| 0.02
| June 9, 2014
| The identification of XFSP+/QSFP bays and protocol independent monitoring of optical links for XSFP+/QSFP modules
|-
| [http://files.opencompute.org/oc/public.php?service=files&t=cf741bcdea44720674b98a6f12937db2 ICAP DRAM]
| 0.03
| June 9, 2014
| The identification and temperature monitoring of DDR3/DDR4 modules
|}

As Data Centers raise room temperatures, potentially on a daily basis, the ICAP OPTI and ICAP DRAM provide feedback on how close the hardware is to the manufacturer define thermal limits.
----